資料介紹
Table of Contents
AD717X No-OS Software Drivers
Introduction
This document describes the No-OS software used to control the AD717X family parts and the AD4111 device. It also includes an example of how to initialize a AD7176 part.
Overview
The AD717x family of products are fast settling, high resolution, highly accurate, multiplexed Σ-Δ analog-to-digital converters (ADC) for low bandwidth input signals, with resolution options of both 32bit and 24bit available. The products are available in both TSSOP of LFCSP depending on the product selected. AD717x family of devices include:
The inputs to the ADC can be configured as fully differential or pseudo differential inputs depending on the product chosen, this can be done via the integrated crosspoint multiplexer. An integrated precision, 2.5 V, low drift (2ppm/°C), band gap internal reference (with an output reference buffer) adds functionality and reduces the external component count. A maximum channel scan data rate is 50 kSPS (with a settling time of 20 μs), resulting in fully settled data of 17 noise free bits. User-selectable output data rates range from 5 SPS to 250 kSPS can be obtained from AD7175, AD7176 and AD7177 devices. A maximum channel scan data rate is 6.1 kSPS (with a settling time of 161 μs). User-selectable output data rates range from 1.25 SPS to 31.25 kSPS can be obtained from AD7172, AD7173 devices. The AD717x devices offers three key digital filters. The fast settling filter maximizes the channel scan rate. The Sinc3 filter maximizes the resolution for single-channel, low speed applications. For 50 Hz and 60 Hz environments, the AD717x specific filter minimizes the settling times or maximizes the rejection of the line frequency. These enhanced filters enable simultaneous 50 Hz and 60 Hz rejection with a 27 SPS output data rate (with a settling time of 36 ms). System offset and gain errors can be corrected on a per channel basis. This per channel configurability extends to the type of filter and output data rate used for each channel. All switching of the crosspoint multiplexer is controlled by the ADC and can be configured to automatically control an external multiplexer via the GPIO pins. The specified operating temperature range is ?40°C to +105°C.
The AD4111, AD4112, AD4114 and AD4115 are low power, low noise, 24-bit, sigma delta (Σ-Δ) analog-to-digital converters (ADC) that integrate analog front ends (AFE) for fully differential or single-ended rail-to-rail, buffered bipolar, ±10 V voltage inputs, and 0 mA to 20 mA current inputs. They also integrate key analog and digital signal conditioning blocks to configure eight individual setups for each analog input channel in use. The AD4111 and AD4112 feature a maximum channel scan rate of 6.2 kSPS (161 μs) for fully settled data.
The AD4111 also has the unique feature of open wire detection on the voltage inputs (patent pending) for system level diagnostics using a single 5 V or 3.3 V power supply. It is housed in a 40-lead, 6 mm × 6 mm LFCSP package.
Applications
- Temperature and pressure measurement
- Medical and scientific multichannel instrumentation
- Chromatography
Supported Devices
Entire AD717X family and AD411X family.
Evaluation Boards
Driver Description
The driver contains two parts:
- The driver for the AD717X family, which may be used, without modifications, with any microcontroller.
- The Generic Platform Driver, which implements the actual communications with the device.
Generic platform driver description
The Generic Platform Driver is where the specific communication functions for the desired type of processor and communication protocol have to be implemented. This driver implements the communication with the device and hides the actual details of the communication protocol to the specific device or family driver.
The Generic Platform Driver has a standard interface, so the device driver can be used exactly as it is provided. This standard interface includes the I2C and SPI communications, functions for managing GPIOs and a miliseconds delay function.
The milisecond delay functions is:
Function | Description |
---|---|
void mdelay(uint32_t msecs) | Generate miliseconds delay. |
I2C interface
The I2C interface has the following functions:
Function | Description |
---|---|
int32_t i2c_init(struct i2c_desc **desc, const struct i2c_init_param *param) | Initialize the I2C communication peripheral. |
int32_t i2c_remove(struct i2c_desc *desc) | Free the resources allocated by i2c_init(). |
int32_t i2c_write(struct i2c_desc *desc, uint8_t *data, uint8_t bytes_number, uint8_t stop_bit) | Write data to a slave device. |
int32_t i2c_read(struct i2c_desc *desc, uint8_t *data, uint8_t bytes_number, uint8_t stop_bit) | Read data from a slave device. |
The following structs and enums are used for the I2C interface:
typedef enum i2c_type { GENERIC_I2C } i2c_type; ? typedef struct i2c_init_param { enum i2c_type type; uint32_t id; uint32_t max_speed_hz; uint8_t slave_address; } i2c_init_param; ? typedef struct i2c_desc { enum i2c_type type; uint32_t id; uint32_t max_speed_hz; uint8_t slave_address; } i2c_desc;
SPI interface
The SPI interface has the following functions:
Function | Description |
---|---|
int32_t spi_init(struct spi_desc **desc, const struct spi_init_param *param) | Initialize the SPI communication peripheral. |
int32_t spi_remove(struct spi_desc *desc) | Free the resources allocated by spi_init(). |
int32_t spi_write_and_read(struct spi_desc *desc, uint8_t *data, uint8_t bytes_number) | Write and read data to/from SPI. |
The following structs and enums are used for the SPI interface:
typedef enum spi_type { GENERIC_SPI } spi_type; ? typedef enum spi_mode { SPI_MODE_0 = (0 | 0), SPI_MODE_1 = (0 | SPI_CPHA), SPI_MODE_2 = (SPI_CPOL | 0), SPI_MODE_3 = (SPI_CPOL | SPI_CPHA) } spi_mode; ? typedef struct spi_init_param { enum spi_type type; uint32_t id; uint32_t max_speed_hz; enum spi_mode mode; uint8_t chip_select; } spi_init_param; ? typedef struct spi_desc { enum spi_type type; uint32_t id; uint32_t max_speed_hz; enum spi_mode mode; uint8_t chip_select; } spi_desc;
GPIO interface
The GPIO interface has the following functions:
Function | Description |
---|---|
int32_t gpio_get(struct gpio_desc **desc, uint8_t gpio_number) | Obtain the GPIO decriptor. |
int32_t gpio_remove(struct gpio_desc *desc) | Free the resources allocated by gpio_get(). |
int32_t gpio_direction_input(struct gpio_desc *desc) | Enable the input direction of the specified GPIO. |
int32_t gpio_direction_output(struct gpio_desc *desc, uint8_t value) | Enable the output direction of the specified GPIO. |
int32_t gpio_get_direction(struct gpio_desc *desc, uint8_t *direction) | Get the direction of the specified GPIO. |
int32_t gpio_set_value(struct gpio_desc *desc, uint8_t value) | Set the value of the specified GPIO. |
int32_t gpio_get_value(struct gpio_desc *desc, uint8_t *value) | Get the value of the specified GPIO. |
The following structs and enums are used for the GPIO interface:
typedef enum gpio_type { GENERIC_GPIO } gpio_type; ? typedef struct gpio_desc { enum gpio_type type; uint32_t id; uint8_t number; } gpio_desc;
AD717X Family Driver Description
The AD717X driver contains the following:
- AD717X.h - Header file of the driver. Contains the register map definitions, the driver function declarations, custom data types to be used by the driver and driver specific constants.
- AD717X.c - Implementation file of the driver. Contains the implementations of the driver functions.
The driver works with any of the following headers by including them in your main project just as you include the ad717x.h header:
- AD7172_2_regs.h
- AD7172_4_regs.h
- AD7173_8_regs.h
- AD7175_2_regs.h
- AD7175_8_regs.h
- AD7176_2_regs.h
- AD7177_2_regs.h
- AD411x_regs.h
Each header declares an array of all register of the device that the header describes.
The following functions are implemented in this version of AD717X driver:
Function | Description |
---|---|
ad717x_st_reg *AD717X_GetReg(ad717x_device *device, uint8_t reg_address) | Retrieves a pointer to the register that matches the given address. |
int32_t AD717X_ReadRegister(ad717x_device *device, uint8_t addr) | Reads the value of the specified register. |
int32_t AD717X_WriteRegister(ad717x_device *device, uint8_t addr) | Writes the value of the specified register. |
int32_t AD717X_Reset(ad717x_dev *device) | Resets the device. |
int32_t AD717X_WaitForReady(ad717x_dev *device, uint32_t timeout) | Waits until a new conversion result is available. |
int32_t AD717X_ReadData(ad717x_dev *device, int32_t* pData) | Reads the conversion result from the device. |
int32_t AD717X_ComputeDataregSize(ad717x_dev *device) | Computes data register read size to account for bit number and status read. |
uint8_t AD717X_ComputeCRC8(uint8_t* pBuf, uint8_t bufSize) | Computes the CRC checksum for a data buffer. |
uint8_t AD717X_ComputeXOR8(uint8_t * pBuf, uint8_t bufSize) | Computes the XOR checksum for a data buffer. |
int32_t AD717X_UpdateCRCSetting(ad717x_dev *device) | Updates the CRC settings. |
int32_t AD717X_Init(ad717x_dev **device, ad717x_init_param init_param) | Initializes the AD717x. |
int32_t AD717X_remove(ad717x_dev *dev) | Free the resources allocated by AD717X_Init(). |
Downloads
- Generic Platform Driver https://github.com/analogdevicesinc/no-OS/tree/master/drivers/platform/generic
Using the API
The driver can only work together with a structure that holds the state of a device, where state means all information about the device including a copy of all register values written to the device at a certain point. This structure will henceforth be referred as an instance of a driver.
All driver functions take a handler of a driver instance as the first argument. This allows the driver to be used with multiple devices simultaneously, without the need to replicate the .c and .h files.
Before using any API call an instance of the driver must first be created and then initialized using the AD717X_Init() which has the following parameters:
- device: the reference of the new driver instance. A new instance can be obtained by simply declaring a pointer to one then using it to call AD717X_Init():
ad717x_device *my_ad7176_2;
- init_param: the initialization structure. One must be declared and initial values must be added before calling AD717X_Init().
ad717x_init_param ad7176_2_init_param;
ad717x_init_param has the following definition:
typedef struct { /* SPI */ spi_init_param spi_init; /* Device Settings */ ad717x_st_reg *regs; uint8_t num_regs; } ad717x_init_param;
Where:
- spi_init: is the initialization structure for the SPI API described in the Generic Platform Driver
- regs: must point to a register array of the device. It will too be stored into the driver and used by the driver. The ad7176_2_regs array defined and initialized in ad7176_2_regs.h can be passed here as parameter provided that the following directives are added inside the file where the driver is being used:
#include "ad7176_2_regs.h"
#define AD7176_2_INIT
Alternatively, a new register array can be defined by user which must be properly initialized before calling AD717X_Setup() function.
ad717x_st_reg my_ad7176_2_regs[] = { { AD717X_STATUS_REG, 0x00, 1 }, { AD717X_ADCMODE_REG, 0x0000, 2 }, ... }
- num_regs: must provide the number of elements in regs.
A AD717X_Init() call will also reset the part then use all register values stored in the array pointed by the regs parameter to configure the part (the registers that are “Read-only” will not be written during this call).
The following code snipped provides an example of driver usage:
#include "ad7176_2_regs.h" #define AD7176_2_INIT ? /* Create a new driver instance */ ad717x_device *my_ad7176_2; ad717x_init_param ad7176_2_init; ? ad7176_2_init.spi_init.chip_select = 0x01; ad7176_2_init.spi_init.id = 0; ad7176_2_init.spi_init.max_speed_hz = 1000000; ad7176_2_init.spi_init.mode = SPI_MODE_3; ad7176_2_init.spi_init.type = GENERIC_SPI; ad7176_2_init.regs = ad7176_2_regs; ad7176_2_init.num_regs = sizeof(ad7176_2_regs) / sizeof(ad7176_2_regs[0]); ? /* Other variables */ long timeout = 1000; long ret; long sample; . . . /* Initialize the driver instance and let's use the ad7176_2_regs array defined in ad7176_2_regs.h */ ret = AD717X_Init(&my_ad7176_2, ad7176_2_init); if (ret < 0) /* Something went wrong, check the value of ret! */ ? /* Read data from the ADC */ ret = AD717X_WaitForReady(my_ad7176_2, timeout); if (ret < 0) /* Something went wrong, check the value of ret! */ ? ret = AD717X_ReadData(my_ad7176_2, &sample); if (ret < 0) /* Something went wrong, check the value of ret! */
More information
- Example questions:
- An error occurred while fetching this feed: http://ez.analog.com/community/feeds/allcontent/atom?community=2077
- AD5443-微控制器無操作系統驅動程序
- AD5449-微控制器無操作系統驅動程序
- AD7291-微控制器無操作系統驅動程序
- AD5790-微控制器無操作系統驅動程序
- AD5162-微控制器無操作系統驅動程序
- AD7298-微控制器無操作系統驅動程序
- AD5933-瑞薩微控制器平臺的無操作系統驅動程序
- AD5629R-微控制器無操作系統驅動程序
- AD5252-微控制器無操作系統驅動程序
- AD7799-微控制器無操作系統驅動程序
- AD9833-微控制器無操作系統驅動程序
- AD7887-微控制器無操作系統驅動程序
- AD7734-微控制器無操作系統驅動程序
- AD8403-微控制器無操作系統驅動程序
- AD7176-微控制器無操作系統驅動程序
- 深度解析全球操作系統格局 676次閱讀
- 為MAXQ2000微控制器實現JTAG自舉加載程序主控 984次閱讀
- 實時時鐘為微控制器系統增加了精確的計時功能 1121次閱讀
- 了解和使用無操作系統和平臺驅動程序 1066次閱讀
- 基于具有USB功能的STM32微控制器 3682次閱讀
- 嵌入式Linux內核的驅動程序開發是怎樣的 1415次閱讀
- 淺談電腦驅動程序的工作原理 詳解電腦驅動程序意義 2.9w次閱讀
- 基于嵌入式Linux內核的系統設備驅動程序開發設計 1113次閱讀
- 基于Linux2.6.30開發DS18B20的驅動程序的類型和文件操作接口函數詳解 1377次閱讀
- 微控制器的相關知識介紹(含義、編程語言) 5139次閱讀
- 基于STM32的數字PDA系統軟件系統設計 1480次閱讀
- 8255A驅動程序 3193次閱讀
- 8155驅動程序 3057次閱讀
- 基于STM32ZET6控制器的數字PDA系統的設計 1504次閱讀
- Xilinx設備的驅動程序 7967次閱讀
下載排行
本周
- 1電子電路原理第七版PDF電子教材免費下載
- 0.00 MB | 1491次下載 | 免費
- 2單片機典型實例介紹
- 18.19 MB | 95次下載 | 1 積分
- 3S7-200PLC編程實例詳細資料
- 1.17 MB | 27次下載 | 1 積分
- 4筆記本電腦主板的元件識別和講解說明
- 4.28 MB | 18次下載 | 4 積分
- 5開關電源原理及各功能電路詳解
- 0.38 MB | 11次下載 | 免費
- 6100W短波放大電路圖
- 0.05 MB | 4次下載 | 3 積分
- 7基于單片機和 SG3525的程控開關電源設計
- 0.23 MB | 4次下載 | 免費
- 8基于AT89C2051/4051單片機編程器的實驗
- 0.11 MB | 4次下載 | 免費
本月
- 1OrCAD10.5下載OrCAD10.5中文版軟件
- 0.00 MB | 234313次下載 | 免費
- 2PADS 9.0 2009最新版 -下載
- 0.00 MB | 66304次下載 | 免費
- 3protel99下載protel99軟件下載(中文版)
- 0.00 MB | 51209次下載 | 免費
- 4LabView 8.0 專業版下載 (3CD完整版)
- 0.00 MB | 51043次下載 | 免費
- 5555集成電路應用800例(新編版)
- 0.00 MB | 33562次下載 | 免費
- 6接口電路圖大全
- 未知 | 30320次下載 | 免費
- 7Multisim 10下載Multisim 10 中文版
- 0.00 MB | 28588次下載 | 免費
- 8開關電源設計實例指南
- 未知 | 21539次下載 | 免費
總榜
- 1matlab軟件下載入口
- 未知 | 935053次下載 | 免費
- 2protel99se軟件下載(可英文版轉中文版)
- 78.1 MB | 537793次下載 | 免費
- 3MATLAB 7.1 下載 (含軟件介紹)
- 未知 | 420026次下載 | 免費
- 4OrCAD10.5下載OrCAD10.5中文版軟件
- 0.00 MB | 234313次下載 | 免費
- 5Altium DXP2002下載入口
- 未知 | 233046次下載 | 免費
- 6電路仿真軟件multisim 10.0免費下載
- 340992 | 191183次下載 | 免費
- 7十天學會AVR單片機與C語言視頻教程 下載
- 158M | 183277次下載 | 免費
- 8proe5.0野火版下載(中文版免費下載)
- 未知 | 138039次下載 | 免費
評論
查看更多