简介这份资源面向嵌入式开发工程师与精密数据采集方向的开发者提供AD717X系列多路复用模数转换器的C语言驱动源码覆盖AD7172-2、AD7172-4、AD7173-8、AD7175-2、AD7175-8、AD7176-2及AD7177-2等多款芯片可用于工业测量、称重、温度采集等需要高精度ADC的场合。压缩包共5个文件包含3个h头文件与2个c源文件整体约12KB其中头文件承担寄存器定义与接口声明源文件实现寄存器读写、设备初始化与通信逻辑并配有独立的通信层代码便于移植到不同MCU平台。资源已积累1809人学习下载具备一定参考价值。读者可从中获得完整的寄存器映射表、按地址检索寄存器的实现思路以及多型号兼容的驱动框架适合作为项目底层驱动搭建与调试的起点也可用于对照数据手册理解AD717X的配置流程。1. AD717X 系列驱动源码拆包从寄存器手册到能跑的 C 代码如果你手头正捏着一片 AD7177-2 或 AD7175-2对着 24 位、32 位分辨率的 ADC 数据手册翻来覆去却卡在“怎么把寄存器配置成我想要的样子”这一步那这份 AD717X-X 多路复用模数转换器驱动 C 源码包就是给你准备的。它覆盖 AD7177-2、AD7175-2、AD7172-2、AD7176-2 这几颗常见型号把 SPI 读写、寄存器配置、通道切换、连续采样转换这些底层动作封装成了可移植的 C 文件。适合做精密测量、工业变送器、多通道数据采集的嵌入式工程师尤其是用 STM32 或类似 MCU 裸机跑 ADC 的场景。你不需要从零啃 60 多页寄存器表源码里已经把关键配置项拆成了结构体和宏改几个参数就能出数。2. 先搞懂 AD717X 的寄存器骨架为什么不能直接抄时序图2.1 通信寄存器是总开关不是普通配置寄存器AD717X 系列和很多 ADC 不一样的地方在于它有一个“通信寄存器”的概念。你每次通过 SPI 发数据第一个字节几乎总是写给通信寄存器的用来告诉芯片我接下来要读还是写、操作哪个寄存器、通道选哪个。很多新手拿到时序图就直接照着 CPOL/CPHA 配 SPI结果读出来全是 0 或者 0xFFFFFF问题就出在没先写通信寄存器。源码包里通常会有类似AD717X_ReadRegister和AD717X_WriteRegister的函数它们内部第一步就是拼通信寄存器的值。我一般会先看这两个函数确认它有没有处理“读操作后需要额外一个空字节”的细节。AD717X 的读时序里发完通信寄存器后下一个字节是无效的第三个字节才开始出数据。如果你自己写 SPI 收发忘了这个 dummy byte读回来的就是错位数据。/* 典型的读寄存器实现注意 dummy byte */ uint32_t AD717X_ReadRegister(uint8_t regAddr, uint8_t numBytes) { uint8_t txBuf[5] {0}; uint8_t rxBuf[5] {0}; uint32_t result 0; /* 通信寄存器读操作寄存器地址连续读模式 */ txBuf[0] AD717X_COMM_REG_READ | (regAddr 0x3F); /* 发起传输注意这里多发一个字节 */ AD717X_CS_LOW(); HAL_SPI_TransmitReceive(hspi1, txBuf, rxBuf, numBytes 2, 100); AD717X_CS_HIGH(); /* rxBuf[0] 是通信寄存器回显rxBuf[1] 是 dummy数据从 rxBuf[2] 开始 */ for (uint8_t i 0; i numBytes; i) { result (result 8) | rxBuf[i 2]; } return result; }这段代码里numBytes 2是关键多出来的两个字节一个对应通信寄存器本身一个就是 dummy。参数regAddr是 0x00 到 0x3F 之间的寄存器地址具体定义在头文件里。如果你用的 SPI 外设支持 16 位或 32 位帧也可以拆成两次传输但 dummy byte 不能省。2.2 设置寄存器和通道寄存器要配对写AD717X 的通道寄存器CH0 到 CH3 或更多决定了每个通道用哪对模拟输入、是否使能、增益多少。但光写通道寄存器不够还要写设置寄存器SETUPCON0 到 SETUPCON3里面配的是滤波器和输出数据速率。源码包里一般会提供一个AD717X_SetupChannel之类的函数把通道号和设置号绑在一起。我见过有人只改了通道寄存器的输入选择忘了改设置寄存器里的ODR结果采样率还是默认的 5 SPS慢得以为芯片坏了。常见做法是先定义一个结构体数组把每个通道的setup编号、正负输入、增益都列出来初始化时循环写入。这样以后改硬件通道只动数组就行。typedef struct { uint8_t channelEn; uint8_t setupSel; uint8_t posInput; uint8_t negInput; } AD717X_ChannelConfig; AD717X_ChannelConfig chConfig[4] { {1, 0, AD717X_AIN0, AD717X_AIN1}, /* 通道0 差分 */ {1, 0, AD717X_AIN2, AD717X_AIN3}, /* 通道1 差分 */ {0, 1, AD717X_AIN4, AD717X_AIN4}, /* 通道2 关 */ {0, 1, AD717X_AIN5, AD717X_AIN5}, /* 通道3 关 */ };参数说明channelEn写 1 使能setupSel指向 SETUPCON 的编号posInput和negInput是模拟输入引脚编码具体值查数据手册的输入选择表。写通道寄存器时要把这些字段拼成一个 16 位值再调用写寄存器函数。2.3 模式寄存器和接口模式寄存器决定采样行为模式寄存器ADCMODE控制的是连续转换、单次转换、待机、内部/外部基准这些。接口模式寄存器IFMODE则管数据状态引脚、CRC 校验、连续读模式。源码包里通常会在初始化最后写这两个寄存器。如果你要做多通道轮询一般设成连续转换模式然后靠RDY引脚下降沿或者状态寄存器的RDY位来判断数据就绪。这里有个容易翻车的地方AD717X 的连续读模式DATA_STAT和CONTREAD位如果开了读数据寄存器的时序会变不需要每次发通信寄存器。但很多例程为了通用还是走单次读的流程。我建议先按单次读调通再考虑开连续读省时间。另外IFMODE里的CRC位如果使能了SPI 传输要额外算 CRC源码包里如果有 CRC 表就直接用没有的话建议先关掉等数据稳定了再开。3. 把源码塞进你的工程SPI 适配与初始化顺序3.1 先改 SPI 收发函数别急着编译这份驱动源码通常带一个AD717X_Platform.c或类似的移植层文件里面有几个弱函数或者宏需要你根据自己用的 MCU 填。最常见的是AD717X_SPI_TransmitReceive、AD717X_CS_LOW、AD717X_CS_HIGH、AD717X_Delay_ms。如果你用 STM32 HAL 库就把HAL_SPI_TransmitReceive包进去如果用寄存器版就自己写收发循环。注意 SPI 模式AD717X 支持 SPI 模式 0 和模式 3具体看你的时序图。我一般先用模式 3CPOL1, CPHA1试因为 ADI 的评估板例程多用这个。时钟频率别一上来就拉满AD717X 的 SCLK 最高能到几十 MHz但你的走线如果长先降到 1 MHz 调通再往上加。血泪经验有一次在 20 MHz 下读出来数据偶尔跳变降到 5 MHz 就稳了后来发现是杜邦线太长。/* STM32 HAL 适配示例 */ void AD717X_SPI_TransmitReceive(uint8_t *txData, uint8_t *rxData, uint16_t len) { HAL_SPI_TransmitReceive(hspi2, txData, rxData, len, 1000); } void AD717X_CS_LOW(void) { HAL_GPIO_WritePin(ADC_CS_GPIO_Port, ADC_CS_Pin, GPIO_PIN_RESET); } void AD717X_CS_HIGH(void) { HAL_GPIO_WritePin(ADC_CS_GPIO_Port, ADC_CS_Pin, GPIO_PIN_SET); }参数hspi2换成你实际用的 SPI 句柄ADC_CS_Pin换成你的片选引脚。延时函数如果精度要求不高用HAL_Delay就行但注意在中断里别调。3.2 复位和初始化顺序不能乱AD717X 上电后建议先发一个复位命令或者拉低 RESET 引脚一段时间。源码包里一般有AD717X_Reset函数它往通信寄存器写 0x80 序列。复位之后芯片回到默认状态这时候再按顺序写设置寄存器 → 通道寄存器 → 接口模式寄存器 → 模式寄存器。顺序反了可能导致通道没使能就开始转换读出来全是 0。我一般会在初始化后加一个自检读一下 ID 寄存器确认返回的型号代码和实际芯片一致。AD7177-2 的 ID 值、AD7175-2 的 ID 值在数据手册里都有。如果读出来是 0x00 或 0xFF先查 SPI 接线和片选别怀疑芯片坏了。uint16_t id AD717X_ReadRegister(AD717X_ID_REG, 2); if ((id 0xFFF0) ! AD717X_ID_AD7177_2) { printf(ADC ID mismatch: 0x%04X\n, id); while (1); }这段代码里AD717X_ID_REG是 ID 寄存器地址AD717X_ID_AD7177_2是宏定义。如果你用的是 AD7175-2换成对应的宏。注意 ID 寄存器只有高 12 位有效低 4 位是版本号所以用 0xFFF0屏蔽掉。3.3 多通道轮询的两种做法AD717X 支持多路复用但它的多路复用是“顺序扫描”式的你使能了多个通道它按通道号从小到大依次转换每转换完一个通道RDY拉低你读数据寄存器然后它自动切到下一个通道。源码包里一般会提供一个AD717X_ReadData函数返回 32 位数据同时可能带通道号如果开了DATA_STAT。做法一查询RDY引脚。主循环里检测RDY下降沿然后读数据。做法二用状态寄存器的RDY位通过 SPI 读状态。做法三用中断RDY接 MCU 外部中断。我一般用做法一简单可靠。注意读数据寄存器时如果开了DATA_STAT读回来的 32 位里高 4 位是通道号低 24 位或 32 位是数据。AD7177-2 是 32 位AD7175-2 是 24 位处理时要按型号区分。void AD717X_ProcessData(void) { uint32_t raw AD717X_ReadRegister(AD717X_DATA_REG, 4); uint8_t ch (raw 28) 0x0F; /* 如果开了 DATA_STAT */ int32_t code (int32_t)(raw 0x0FFFFFFF); /* 24位数据 */ /* 转电压Vref / 2^23 * code注意差分有符号 */ float voltage (float)code * AD717X_VREF / 8388608.0f; printf(CH%d: %.6f V\n, ch, voltage); }参数AD717X_VREF是你实际用的基准电压比如 2.5V 或 5V。8388608.0f是 2 的 23 次方对应 24 位 ADC 的单极性满量程。如果是差分输入代码是二进制补码直接转int32_t再乘系数就行。4. 避坑与排查读不到数、跳变、通道错位怎么查4.1 现象读出来全是 0xFFFFFF 或 0x000000原因SPI 通信根本没建立或者通信寄存器写错。先查片选有没有拉低SCLK 有没有波形MOSI 有没有数据。如果用的是硬件 SPI确认引脚复用对不对。另一个常见原因是复位没成功芯片还在默认的待机模式。解决用示波器看 CS 和 SCLK确认每次传输 8 的整数倍个时钟。然后手动发一个复位序列延时 1ms 再读 ID。4.2 现象数据偶尔跳变噪声大原因基准电压不稳、模拟输入没加 RC 滤波、SPI 时钟太快、地线没接好。AD717X 是精密 ADC对电源和基准要求高。解决先确认VREF引脚电压稳定用万用表量一下。模拟输入串一个 100Ω 电阻加 100nF 电容到地。SPI 时钟降到 1 MHz 试试。如果还跳检查 PCB 上模拟地和数字地是不是单点连接。4.3 现象多通道数据错位通道号对不上原因通道寄存器和设置寄存器没配对或者DATA_STAT没开但代码里按开了处理。解决先关掉DATA_STAT读数据寄存器只取低 24 位然后手动记录当前是哪个通道。如果顺序是 0、1、2、3 循环说明多路复用在工作。如果顺序乱检查通道寄存器的CHEN位是不是只使能了需要的通道。另外AD717X 的通道扫描顺序是固定的不能自定义优先级。4.4 现象初始化后第一次读数是错的后面正常原因第一次转换还没完成就去读数据寄存器读回来的是旧值或 0。解决初始化写完模式寄存器后延时足够的时间或者等RDY第一次拉低再读。常见做法是初始化后加 10ms 延时然后丢弃第一次读数。4.5 现象CRC 校验一直失败原因CRC 多项式或初始值不对或者 SPI 传输位数不对。AD717X 的 CRC 是 8 位多项式 0x07初始值 0。解决先关掉IFMODE里的 CRC 使能位等数据能稳定读了再打开 CRC 并对照源码里的 CRC 函数逐位调试。如果源码包里没有 CRC 实现建议直接关掉除非你的应用对数据完整性要求极高。5. 进阶技巧用状态机管多通道用示波器验证时序5.1 把轮询改成状态机别在中断里读 SPI很多例程在RDY中断里直接调 SPI 读数据这在低速下没问题但如果 SPI 时钟高、数据量大中断里做长传输容易丢中断或阻塞其他任务。我一般会用一个简单的状态机RDY中断只置一个标志位主循环里检测标志位再读数据。这样 SPI 传输在主线程序里不会被中断打断。volatile uint8_t adcReadyFlag 0; void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin) { if (GPIO_Pin ADC_RDY_Pin) { adcReadyFlag 1; } } void mainLoop(void) { while (1) { if (adcReadyFlag) { adcReadyFlag 0; AD717X_ProcessData(); } /* 其他任务 */ } }参数ADC_RDY_Pin换成你的实际引脚。注意adcReadyFlag要加volatile防止编译器优化。如果主循环里还有其他耗时操作建议把AD717X_ProcessData放在一个定时任务里比如 1ms 调一次。5.2 用示波器抓 SPI 时序对照数据手册的时序图调 ADC 驱动示波器比打印快得多。我一般会抓四根线CS、SCLK、MOSI、MISO。先看 CS 拉低到 SCLK 第一个上升沿的时间AD717X 要求至少 10ns一般都能满足。再看 SCLK 的占空比接近 50% 最好。然后看 MISO 上的数据在哪个时钟沿变化确认你的 SPI 采样沿对不对。如果 MISO 数据在第一个 SCLK 上升沿就变了说明芯片在下降沿输出你的 SPI 要设成上升沿采样。血泪经验有一次调 AD7175-2数据总是高位错一位后来抓波形发现 SPI 模式设成了模式 0改成模式 3 就对了。数据手册的时序图里SCLK 空闲高电平第一个沿是下降沿对应 CPOL1, CPHA1。5.3 校准和零点漂移处理AD717X 支持内部零点和满量程校准但需要你发校准命令并等待完成。源码包里如果有AD717X_Calibrate函数一般会写模式寄存器触发校准然后轮询状态寄存器。我一般会在初始化后做一次内部零点校准把输入短接到地读几个数取平均作为零点偏移后续采样减去这个偏移。满量程校准需要加精确基准一般产线才做。void AD717X_CalibrateZero(void) { /* 假设通道0输入短接 */ AD717X_WriteRegister(AD717X_ADCMODE_REG, AD717X_MODE_CAL_ZERO); while (!(AD717X_ReadRegister(AD717X_STATUS_REG, 1) AD717X_STATUS_RDY)); /* 校准完成读回零点值 */ int32_t zero AD717X_ReadRegister(AD717X_DATA_REG, 3); printf(Zero offset: %d\n, zero); }参数AD717X_MODE_CAL_ZERO是校准模式宏具体值查头文件。注意校准期间输入要稳定否则校准结果不准。校准完成后模式寄存器会自动回到之前的转换模式不用手动恢复。从那以后我每次拿到新的 ADC 驱动源码都强制先读 ID、再复位、再抓一遍 SPI 波形确认时序对了才往下写应用逻辑。希望帮到你。本文还有配套的精品资源点击获取
