ad5791.c File Reference

Implementation of AD5791 Driver. More...

#include <stdlib.h>
#include "ad5791.h"
#include "no_os_alloc.h"

Include dependency graph for ad5791.c:

Functions
int32_t	ad5791_init (struct ad5791_dev **device, struct ad5791_init_param init_param)
	Initializes the communication with the device.
int32_t	ad5791_remove (struct ad5791_dev *dev)
	Free the resources allocated by ad5791_init().
int32_t	ad5791_set_register_value (struct ad5791_dev *dev, uint8_t register_address, uint32_t register_value)
	Writes data into a register.
int32_t	ad5791_get_register_value (struct ad5791_dev *dev, uint8_t register_address, uint32_t *value)
	Reads the value of a register.
int32_t	ad5791_dac_ouput_state (struct ad5791_dev *dev, uint8_t state)
	Sets the DAC output in one of the three states.
int32_t	ad5791_set_dac_value (struct ad5791_dev *dev, uint32_t value)
	Writes to the DAC register.
int32_t	ad5791_soft_instruction (struct ad5791_dev *dev, uint8_t instruction_bit)
	Asserts RESET, CLR or LDAC in a software manner.
int32_t	ad5791_setup (struct ad5791_dev *dev, uint32_t setup_word)
	Configures the output amplifier, DAC coding, SDO state and the linearity error compensation.
int	ad5791_spi_write_mask (struct ad5791_dev *dev, uint8_t register_address, uint32_t mask, uint32_t value)
	SPI write to device using a mask.
int	ad5791_set_lin_comp (struct ad5791_dev *dev, enum ad5791_lin_comp_select v_span)
	Set Linearity error compensation based on the reference voltage span.
int	ad5791_ldac_trigger (struct ad5791_dev *dev)
	Trigger LDAC.
int	ad5791_clear_async (struct ad5791_dev *dev)
	Clear DAC channel output with the clearcode.

Detailed Description

Implementation of AD5791 Driver.

Author

DNechita (Dan.N.nosp@m.echi.nosp@m.ta@an.nosp@m.alog.nosp@m..com)

Copyright 2013(c) Analog Devices, Inc.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
3. Neither the name of Analog Devices, Inc. nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY ANALOG DEVICES, INC. “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ANALOG DEVICES, INC. BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Function Documentation

ad5791_clear_async()

int ad5791_clear_async

(

struct ad5791_dev *

dev

)

Clear DAC channel output with the clearcode.

Parameters

dev	- The device structure.

Returns

0 in case of success, negative error code otherwise.

ad5791_dac_ouput_state()

int32_t ad5791_dac_ouput_state	(	struct ad5791_dev *	dev,
		uint8_t	state )

Sets the DAC output in one of the three states.

Parameters

dev	- The device structure.
state	- The output state. Example: AD5791_OUT_NORMAL - normal operation mode AD5791_OUT_CLAMPED_6K - output is clamped via ~6KOhm to AGND AD5791_OUT_TRISTATE - output is in tristate

Returns

Negative error code or 0 in case of success.

ad5791_get_register_value()

int32_t ad5791_get_register_value	(	struct ad5791_dev *	dev,
		uint8_t	register_address,
		uint32_t *	value )

Reads the value of a register.

Parameters

dev	- The device structure.
register_address	- Address of the register. Example: AD5791_REG_DAC - DAC register AD5791_REG_CTRL - Control register AD5791_REG_CLR_CODE - Clearcode register AD5791_CMD_WR_SOFT_CTRL - Software control register
value	- Pointer to the register data.

Returns

dataRead - The register's value or negative error code.

Here is the caller graph for this function:

ad5791_init()

int32_t ad5791_init	(	struct ad5791_dev **	device,
		struct ad5791_init_param	init_param )

Initializes the communication with the device.

Parameters

device	- The device structure.
init_param	- The structure that contains the device initial parameters.

Returns

status - Result of the initialization procedure. Example: 0 - if initialization was successful; -1 - if initialization was unsuccessful.

Here is the caller graph for this function:

ad5791_ldac_trigger()

int ad5791_ldac_trigger

(

struct ad5791_dev *

dev

)

Trigger LDAC.

Parameters

dev	- The device structure.

Returns

0 in case of success, negative error code otherwise.

ad5791_remove()

int32_t ad5791_remove

(

struct ad5791_dev *

dev

)

Free the resources allocated by ad5791_init().

Parameters

dev	- The device structure.

Returns

0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

ad5791_set_dac_value()

int32_t ad5791_set_dac_value	(	struct ad5791_dev *	dev,
		uint32_t	value )

Writes to the DAC register.

Parameters

dev	- The device structure.
value	- The value to be written to DAC.

Returns

Negative error code or 0 in case of success.

Here is the caller graph for this function:

ad5791_set_lin_comp()

int ad5791_set_lin_comp	(	struct ad5791_dev *	dev,
		enum ad5791_lin_comp_select	v_span )

Set Linearity error compensation based on the reference voltage span.

Parameters

dev	- The device structure.
v_span	- voltage span to set the corresponding lin_comp value.

Returns

0 in case of success, negative error code otherwise.

ad5791_set_register_value()

int32_t ad5791_set_register_value	(	struct ad5791_dev *	dev,
		uint8_t	register_address,
		uint32_t	register_value )

Writes data into a register.

Parameters

dev	- The device structure.
register_address	- Address of the register. Example: AD5791_REG_DAC - DAC register AD5791_REG_CTRL - Control register AD5791_REG_CLR_CODE - Clearcode register AD5791_CMD_WR_SOFT_CTRL - Software control register
register_value	- Value of the register.

Returns

Returns 0 in case of success or negative error code.

Here is the caller graph for this function:

ad5791_setup()

int32_t ad5791_setup	(	struct ad5791_dev *	dev,
		uint32_t	setup_word )

Configures the output amplifier, DAC coding, SDO state and the linearity error compensation.

Parameters

dev	- The device structure.
setup_word	- Is a 24-bit value that sets or clears the Control Register bits : RBUF bit(AD5791_CTRL_RBUF(x)), BIN/2sC bit(AD5791_CTRL_BIN2SC(x)), SDODIS bit(AD5791_CTRL_SDODIS(x)) and LINCOMP bits(AD5791_CTRL_LINCOMP(x)). Example: AD5791_CTRL_BIN2SC(1) | AD5791_CTRL_RBUF(1) - sets the DAC register to use offset binary coding and powers down the internal output amplifier.

Returns

Negative error code or 0 in case of success.

ad5791_soft_instruction()

int32_t ad5791_soft_instruction	(	struct ad5791_dev *	dev,
		uint8_t	instruction_bit )

Asserts RESET, CLR or LDAC in a software manner.

Parameters

dev	- The device structure.
instruction_bit	- A Software Control Register bit. Example: AD5791_SOFT_CTRL_LDAC - Load DAC AD5791_SOFT_CTRL_CLR - Clear AD5791_SOFT_CTRL_RESET - Reset

Returns

Negative error code or 0 in case of success.

Here is the caller graph for this function:

ad5791_spi_write_mask()

int ad5791_spi_write_mask	(	struct ad5791_dev *	dev,
		uint8_t	register_address,
		uint32_t	mask,
		uint32_t	value )

SPI write to device using a mask.

Parameters

dev	- The device structure.
register_address	- Address of the register. Example: AD5791_REG_DAC - DAC register AD5791_REG_CTRL - Control register AD5791_REG_CLR_CODE - Clearcode register AD5791_CMD_WR_SOFT_CTRL - Software control register
mask	- The mask.
value	- The register data.

Returns

0 in case of success, negative error code otherwise.

Here is the caller graph for this function: