Implementation of AD4110 Driver. More...

#include <stdio.h>
#include <stdlib.h>
#include "ad4110.h"
#include "no_os_util.h"
#include "no_os_alloc.h"
#include "no_os_error.h"
#include "no_os_irq.h"
#include "no_os_print_log.h"
#include <string.h>

Include dependency graph for ad4110.c:

Functions
uint8_t	ad4110_compute_crc8 (uint8_t *data, uint8_t data_size)

uint8_t	ad4110_compute_xor (uint8_t *data, uint8_t data_size)

int32_t	ad4110_spi_int_reg_write_msk (struct ad4110_dev *dev, uint8_t reg_map, uint8_t reg_addr, uint32_t data, uint16_t mask)

int32_t	ad4110_set_adc_mode (struct ad4110_dev *dev, enum ad4110_adc_mode mode)

int32_t	ad4110_set_gain (struct ad4110_dev *dev, enum ad4110_gain gain)

int32_t	ad4110_set_adc_clk (struct ad4110_dev *dev, enum ad4110_adc_clk_sel clk)

int32_t	ad4110_set_afe_clk (struct ad4110_dev *dev, enum ad4110_afe_clk_cfg clk)

int32_t	ad4110_set_reference (struct ad4110_dev *dev, enum ad4110_voltage_reference ref)

int32_t	ad4110_set_op_mode (struct ad4110_dev *dev, enum ad4110_op_mode mode)

int32_t	ad4110_spi_do_soft_reset (struct ad4110_dev *dev)

uint8_t	ad4110_get_data_size (struct ad4110_dev *dev, uint8_t reg_map, uint8_t reg_addr)

int32_t	ad4110_spi_int_reg_write (struct ad4110_dev *dev, uint8_t reg_map, uint8_t reg_addr, uint32_t reg_data)

int32_t	ad4110_spi_int_data_reg_read (struct ad4110_dev dev, uint32_t reg_data)

int32_t	ad4110_spi_int_reg_read (struct ad4110_dev dev, uint8_t reg_map, uint8_t reg_addr, uint32_t reg_data)

int	ad4110_set_channel_status (struct ad4110_dev *dev, uint8_t chan_id, bool status)
	Enable/Disable channel. More...

int	ad4110_set_analog_input_buffer (struct ad4110_dev *dev, enum ad4110_ain_buffer buffer)
	Assign analog input buffer. More...

int	ad4110_set_bipolar (struct ad4110_dev *dev, bool bipolar)
	Set polarity. More...

int	ad4110_set_odr (struct ad4110_dev *dev, enum ad4110_odr odr)
	Set Output Data Rate. More...

int	ad4110_set_order (struct ad4110_dev *dev, enum ad4110_order order)
	Set Order of Filter. More...

int	ad4110_wait_for_rdy_low (struct ad4110_dev *dev, uint32_t timeout)
	Wait for RDY bit to go low indicating conversion completion. More...

int	ad4110_do_single_read (struct ad4110_dev dev, uint32_t buffer)
	ADC data read in single conversion mode. More...

int32_t	ad4110_setup (struct ad4110_dev **device, struct ad4110_init_param init_param)

int32_t	ad4110_continuous_read (struct ad4110_dev dev, uint32_t buffer, uint32_t buffer_size)

int32_t	ad4110_remove (struct ad4110_dev *dev)
	Free the resources allocated by ad4110_setup(). More...

Detailed Description

Implementation of AD4110 Driver.

Author: Stefan Popa (stefa.nosp@m.n.po.nosp@m.pa@an.nosp@m.alog.nosp@m..com) Andrei Porumb (andre.nosp@m.i.po.nosp@m.rumb@.nosp@m.anal.nosp@m.og.co.nosp@m.m) Mihail Chindris (mihai.nosp@m.l.ch.nosp@m.indri.nosp@m.s@an.nosp@m.alog..nosp@m.com)

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

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
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.
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.
The use of this software may or may not infringe the patent rights of one or more patent holders. This license does not release you from the requirement that you obtain separate licenses from these patent holders to use this software.
Use of the software either in source or binary form, must be run on or directly connected to an Analog Devices Inc. component.

THIS SOFTWARE IS PROVIDED BY ANALOG DEVICES "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ANALOG DEVICES BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, INTELLECTUAL PROPERTY RIGHTS, 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

◆ ad4110_compute_crc8()

uint8_t ad4110_compute_crc8	(	uint8_t *	data,
		uint8_t	data_size
	)

Compute CRC8 checksum.

Parameters

data	- The data buffer.
data_size	- The size of the data buffer.

Returns: CRC8 checksum.

Here is the caller graph for this function:

◆ ad4110_compute_xor()

uint8_t ad4110_compute_xor	(	uint8_t *	data,
		uint8_t	data_size
	)

Compute XOR checksum.

Parameters

data	- The data buffer.
data_size	- The size of the data buffer.

Returns: XOR checksum.

Here is the caller graph for this function:

◆ ad4110_continuous_read()

int32_t ad4110_continuous_read	(	struct ad4110_dev *	dev,
		uint32_t *	buffer,
		uint32_t	buffer_size
	)

ADC continuous read fills buffer with buffer_size number of samples.

Parameters

dev	- The device structure.
buffer	- The buffer.
buffer_size	- The buffer size = number of samples.

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ad4110_do_single_read()

int ad4110_do_single_read	(	struct ad4110_dev *	dev,
		uint32_t *	buffer
	)

ADC data read in single conversion mode.

Parameters

dev	- The device structure.
buffer	- The data buffer.

Returns: 0 in case of success, negative error code otherwise.

◆ ad4110_get_data_size()

uint8_t ad4110_get_data_size	(	struct ad4110_dev *	dev,
		uint8_t	reg_map,
		uint8_t	reg_addr
	)

Get the data size of a specified register.

Parameters

dev	- The device structure.
reg_map	- The register map. Accepted values: A4110_ADC A4110_AFE
reg_addr	- The register address.

Returns: the data size in bytes

Here is the caller graph for this function:

◆ ad4110_remove()

int32_t ad4110_remove ( struct ad4110_dev * dev )

Free the resources allocated by ad4110_setup().

Parameters

dev	- The device structure.

Returns: 0 in case of success, negative error code otherwise.

◆ ad4110_set_adc_clk()

int32_t ad4110_set_adc_clk	(	struct ad4110_dev *	dev,
		enum ad4110_adc_clk_sel	clk
	)

Set ADC clock.

Parameters

dev	- The device structure.
clk	- The clock mode. Accepted values: AD4110_ADC_INT_CLK AD4110_ADC_INT_CLK_CLKIO AD4110_ADC_EXT_CLK

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ad4110_set_adc_mode()

int32_t ad4110_set_adc_mode	(	struct ad4110_dev *	dev,
		enum ad4110_adc_mode	mode
	)

Set the mode of the ADC.

Parameters

dev	- The device structure.
mode	- The ADC mode Accepted values: AD4110_CONTINOUS_CONV_MODE AD4110_SINGLE_CONV_MODE AD4110_STANDBY_MODE AD4110_PW_DOWN_MODE AD4110_SYS_OFFSET_CAL AD4110_SYS_GAIN_CAL

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ad4110_set_afe_clk()

int32_t ad4110_set_afe_clk	(	struct ad4110_dev *	dev,
		enum ad4110_afe_clk_cfg	clk
	)

Set AFE clock.

Parameters

dev	- The device structure.
clk	- The clock mode. Accepted values: AD4110_AFE_INT_CLOCK AD4110_AFE_ADC_CLOCKED

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ad4110_set_analog_input_buffer()

int ad4110_set_analog_input_buffer	(	struct ad4110_dev *	dev,
		enum ad4110_ain_buffer	buffer
	)

Assign analog input buffer.

Parameters

dev	- The device structure.
buffer	- Choice of analog input buffer to be set

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ad4110_set_bipolar()

int ad4110_set_bipolar	(	struct ad4110_dev *	dev,
		bool	bipolar
	)

Set polarity.

Parameters

dev	- The device structure.
bipolar	- True in case of Bipolar/ False in case of Unipolar

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ad4110_set_channel_status()

int ad4110_set_channel_status	(	struct ad4110_dev *	dev,
		uint8_t	chan_id,
		bool	status
	)

Enable/Disable channel.

Parameters

dev	- The device structure.
chan_id	- Channel ID (number)
status	- Channel Status (True for Enable and False for Disable)

Returns: 0 in case of success, negative error code otherwise.

◆ ad4110_set_gain()

int32_t ad4110_set_gain	(	struct ad4110_dev *	dev,
		enum ad4110_gain	gain
	)

Set the gain.

Parameters

dev	- The device structure.
gain	- The gain value. Accepted values: AD4110_GAIN_0_2 AD4110_GAIN_0_25 AD4110_GAIN_0_3 AD4110_GAIN_0_375 AD4110_GAIN_0_5 AD4110_GAIN_0_75 AD4110_GAIN_1 AD4110_GAIN_1_5 AD4110_GAIN_2 AD4110_GAIN_3 AD4110_GAIN_4 AD4110_GAIN_6 AD4110_GAIN_8 AD4110_GAIN_12 AD4110_GAIN_16 AD4110_GAIN_24

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ad4110_set_odr()

int ad4110_set_odr	(	struct ad4110_dev *	dev,
		enum ad4110_odr	odr
	)

Set Output Data Rate.

Parameters

dev	- The device structure.
odr	- Choice of ODR to be set

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ad4110_set_op_mode()

int32_t ad4110_set_op_mode	(	struct ad4110_dev *	dev,
		enum ad4110_op_mode	mode
	)

Set the operation mode.

Parameters

dev	- The device structure.
mode	- The operation mode type. Accepted values: AD4110_VOLTAGE_MODE AD4110_CURRENT_MODE AD4110_CURRENT_MODE_EXT_R_SEL AD4110_THERMOCOUPLE AD4110_FLD_POWER_MODE AD4110_RTD_2W_MODE AD4110_RTD_3W_MODE AD4110_RTD_4W_MODE

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ad4110_set_order()

int ad4110_set_order	(	struct ad4110_dev *	dev,
		enum ad4110_order	order
	)

Set Order of Filter.

Parameters

dev	- The device structure.
order	- Choice of order to be set

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ad4110_set_reference()

int32_t ad4110_set_reference	(	struct ad4110_dev *	dev,
		enum ad4110_voltage_reference	ref
	)

Set the voltage reference.

Parameters

dev	- The device structure.
ref	- The voltage reference. Accepted values: AD4110_EXT_REF AD4110_INT_2_5V_REF AD4110_AVDD5_REF

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ad4110_setup()

int32_t ad4110_setup	(	struct ad4110_dev **	device,
		struct ad4110_init_param	init_param
	)

Initialize the device.

Parameters

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

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ad4110_spi_do_soft_reset()

int32_t ad4110_spi_do_soft_reset ( struct ad4110_dev * dev )

Do a SPI software reset.

Parameters

dev	- The device structure.

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ad4110_spi_int_data_reg_read()

int32_t ad4110_spi_int_data_reg_read	(	struct ad4110_dev *	dev,
		uint32_t *	reg_data
	)

SPI internal DATA register read from device.

Parameters

dev	- The device structure.
reg_data	- The register data.

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ad4110_spi_int_reg_read()

int32_t ad4110_spi_int_reg_read	(	struct ad4110_dev *	dev,
		uint8_t	reg_map,
		uint8_t	reg_addr,
		uint32_t *	reg_data
	)

SPI internal register read from device.

Parameters

dev	- The device structure.
reg_map	- The register map. Accepted values: A4110_ADC A4110_AFE
reg_addr	- The register address.
reg_data	- The register data.

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ad4110_spi_int_reg_write()

int32_t ad4110_spi_int_reg_write	(	struct ad4110_dev *	dev,
		uint8_t	reg_map,
		uint8_t	reg_addr,
		uint32_t	reg_data
	)

SPI internal register write to device.

Parameters

dev	- The device structure.
reg_map	- The register map. Accepted values: A4110_ADC A4110_AFE
reg_addr	- The register address.
reg_data	- The register data.

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ad4110_spi_int_reg_write_msk()

int32_t ad4110_spi_int_reg_write_msk	(	struct ad4110_dev *	dev,
		uint8_t	reg_map,
		uint8_t	reg_addr,
		uint32_t	data,
		uint16_t	mask
	)

SPI internal register write to device using a mask.

Parameters

dev	- The device structure.
reg_map	- The register map. Accepted values: A4110_ADC A4110_AFE
reg_addr	- The register address.
data	- The register data.
mask	- The mask.

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ad4110_wait_for_rdy_low()

int ad4110_wait_for_rdy_low	(	struct ad4110_dev *	dev,
		uint32_t	timeout
	)

Wait for RDY bit to go low indicating conversion completion.

Parameters

dev	- The device structure.
timeout	- ADC conversion timeout

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

Functions

Detailed Description

Function Documentation

◆ ad4110_compute_crc8()

◆ ad4110_compute_xor()

◆ ad4110_continuous_read()

◆ ad4110_do_single_read()

◆ ad4110_get_data_size()

◆ ad4110_remove()

◆ ad4110_set_adc_clk()

◆ ad4110_set_adc_mode()

◆ ad4110_set_afe_clk()

◆ ad4110_set_analog_input_buffer()

◆ ad4110_set_bipolar()

◆ ad4110_set_channel_status()

◆ ad4110_set_gain()

◆ ad4110_set_odr()

◆ ad4110_set_op_mode()

◆ ad4110_set_order()

◆ ad4110_set_reference()

◆ ad4110_setup()

◆ ad4110_spi_do_soft_reset()

◆ ad4110_spi_int_data_reg_read()

◆ ad4110_spi_int_reg_read()

◆ ad4110_spi_int_reg_write()

◆ ad4110_spi_int_reg_write_msk()

◆ ad4110_wait_for_rdy_low()