简介：本资源是ADI官方AD7193高精度Σ-Δ模数转换器的嵌入式驱动例程包，面向嵌入式软硬件工程师、精密测量系统开发者及工业自动化方向学习者，解决AD7193芯片快速上手、寄存器配置、SPI通信实现与数据采集集成等核心开发难题。压缩包共4个文件（2个C源文件 + 2个头文件），总大小仅11KB，结构精炼：C文件分别实现AD7193底层驱动逻辑（含初始化、寄存器读写、采样控制）与跨平台通信适配（SPI时序管理、片选与数据收发）；H文件则统一定义寄存器地址、配置枚举及函数接口，便于移植与模块化调用。已有614人学习下载，适用于STM32、GD32等主流MCU平台，读者可直接复用初始化流程、滤波器参数设置范式及抗干扰采样策略，并基于通信抽象层快速对接不同硬件接口，显著缩短高精度ADC系统开发周期。
1. 项目缘起：从AD7193官网到通用驱动框架的探索
最近在做一个高精度称重项目，选型时ADI的AD7193这颗24位Σ-Δ ADC芯片进入了我的视野。它的低噪声、高精度特性非常适合我们的应用场景。和很多工程师一样，我的第一反应是去ADI官网找官方例程和驱动。官网的例程确实提供了基础功能，但用起来总觉得有点“别扭”——它通常绑定在特定的评估板（比如EVAL-AD7193SDZ）和特定的MCU平台上，代码结构也偏向于演示，要移植到自己的STM32或者GD32项目里，得改不少地方。更头疼的是，不同项目对ADC的配置需求千差万别：有的需要单次转换，有的要连续采样；有的用内部时钟，有的必须外接晶振；滤波器的设置、数据校准方式更是因应用而异。每次都要从官方例程里“抠”代码，再封装一遍，既重复劳动，又容易引入错误。
于是我就想，能不能做一个更“通用”的AD7193驱动框架？这个“通用”不是指一个函数走天下，而是指结构清晰、配置灵活、易于移植和扩展。它应该把芯片的硬件操作（SPI读写、延时）和业务逻辑（采样模式、数据处理）解耦开。这样，换一个MCU平台，我只需要实现底层的SPI和GPIO操作；换一个应用场景，我只需要在应用层调整配置参数和数据处理回调函数。这就是我动手折腾这个ad7193_generic项目的初衷。我希望它不仅仅是一份代码，更是一个清晰的、可复用的设计思路，能帮到同样被各种“例程”困扰的同行们。
2. AD7193核心特性与驱动设计的关键挑战
在动手写代码之前，必须吃透AD7193这颗芯片。它是一款低噪声、低漂移的24位Σ-Δ ADC，内置PGA（可编程增益放大器），增益从1到128可选，非常适合直接连接桥式传感器（比如称重传感器）。它支持4个差分或7个伪差分输入通道，输出数据速率可以从4.7 Hz到4.8 kHz可编程。这些特性决定了我们的驱动设计必须足够灵活。
2.1 寄存器配置的复杂性
AD7193的配置主要通过一系列寄存器完成，包括通信寄存器、状态寄存器、模式寄存器、配置寄存器、数据寄存器以及偏移和满量程校准寄存器。驱动设计的第一个挑战就在于如何优雅地管理这些寄存器。官方例程通常是一堆宏定义加上直接读写寄存器的函数，可读性和可维护性都不太好。我的思路是，为每个寄存器定义一个清晰的结构体，并使用位域（bit-field）或掩码（mask）的方式来操作其中的每一个配置位。这样做虽然代码量稍大，但意图非常明确，调试时也一目了然。
例如，配置寄存器（Configuration Register）需要设置通道选择、增益、烧毁电流使能、参考电压检测等。如果直接用十六进制数0x10C0来写，过一个月自己都忘了这个值对应什么配置。更好的做法是：
typedef struct { uint8_t ch : 3; // 通道选择 uint8_t gain : 3; // 增益选择 uint8_t burnout : 1; // 烧毁电流使能 uint8_t refdet : 1; // 参考电压检测 uint8_t buf : 1; // 缓冲器使能 uint8_t unipolar : 1;// 单极性模式 uint8_t refsel : 1; // 参考电压选择 } ad7193_config_reg_t; // 使用时 ad7193_config_reg_t config = { .ch = AD7193_CH_AIN1P_AIN1M, // 通道1 .gain = AD7193_GAIN_128, // 增益128 .burnout = 0, .refdet = 0, .buf = 1, // 使能缓冲器以支持高阻抗源 .unipolar = 0, // 双极性模式 .refsel = 0, // 使用内部参考 };然后，驱动提供一个函数ad7193_write_config_reg(&config)，内部负责将这个结构体转换成实际的字节流通过SPI发送出去。这种方式比直接操作原始数值要安全、清晰得多。
2.2 数据就绪信号的处理策略
AD7193提供了/DRDY引脚来指示新数据就绪。如何处理这个信号，是驱动性能的关键。常见有四种方式：
- 查询方式（Polling）：MCU不断读取
/DRDY引脚状态。这是最简单但最浪费CPU资源的方式，只适用于低输出数据速率或单次转换的场景。 - 外部中断方式：将
/DRDY引脚连接到MCU的外部中断引脚，下降沿触发。在中断服务程序（ISR）中读取数据。这种方式响应及时，CPU利用率高，但需要小心处理ISR中的耗时操作，避免阻塞。 - SPI轮询数据寄存器：不理会
/DRDY引脚，而是持续读取通信寄存器。如果读取时数据未就绪，AD7193会返回“忙”状态。这种方式将判断逻辑放在了SPI通信中，节省了一个GPIO引脚，但通信效率较低。 - DMA+中断：在高速连续采样时，可以配置SPI的DMA传输，并用
/DRDY触发DMA请求，将数据直接搬运到内存缓冲区。这是最高效的方式，但对MCU和驱动代码复杂度要求最高。
在ad7193_generic驱动中，我选择将/DRDY的处理策略抽象成一个可配置的模块。底层提供一个ad7193_drdy_pin_read()的函数指针，在初始化时由用户绑定到具体的GPIO读取实现。同时，提供ad7193_wait_for_ready()（阻塞查询）和ad7193_is_data_ready()（非阻塞查询）两种上层接口。用户可以根据自己的应用场景和硬件连接，选择最合适的方式。对于绝大多数中低速应用，外部中断方式是一个平衡了效率和复杂度的好选择。
2.3 校准流程的封装
高精度ADC都离不开校准。AD7193支持内部零电平校准、内部满量程校准，以及系统校准（需要外部施加已知电压）。官方例程里的校准代码往往是线性的、硬编码的。在实际产品中，校准可能发生在生产线上（使用自动化校准治具），也可能由用户在特定场景下触发（如电子秤的“去皮”功能）。
因此，我把校准设计成了一个状态机。驱动提供ad7193_calibrate_start(cal_type_t type, uint8_t channel)函数来启动一次校准，然后用户需要在主循环中周期性地调用ad7193_calibrate_poll()来推进校准状态。校准状态（空闲、进行中、完成、错误）和结果（校准系数）通过回调函数或状态查询接口返回给应用层。这样，校准过程就不会阻塞主程序，并且可以轻松地集成到更复杂的用户交互流程中。例如，在电子秤应用中，启动内部零电平校准可能对应着用户按下“归零”键，而驱动只是安静地在后台完成校准并更新偏移寄存器，应用层再更新显示。
3. 构建通用驱动框架：分层与抽象
理解了芯片特性和挑战后，就可以着手设计驱动框架了。我的核心思想是分层和抽象，目标是让驱动代码与硬件平台、甚至与具体的应用业务逻辑解耦。
3.1 硬件抽象层（HAL）的设计
这是整个驱动可移植性的基石。我将所有与MCU硬件直接相关的操作都抽象成一组函数指针，放在一个名为ad7193_hal_t的结构体中。
typedef struct { // SPI传输函数 (片选、读写、时钟极性相位需在实现中保证符合AD7193要求) int (*spi_xfer)(uint8_t *tx_data, uint8_t *rx_data, uint16_t len); // 毫秒级延时函数 void (*delay_ms)(uint32_t ms); // 微秒级延时函数 (用于SPI时序间的精细控制) void (*delay_us)(uint32_t us); // /DRDY引脚状态读取函数 (可选，如果使用查询或中断方式) int (*drdy_pin_read)(void); // 日志输出函数 (可选，用于调试) void (*log_print)(const char *fmt, ...); } ad7193_hal_t;用户在使用驱动前，必须实现这些函数并初始化这个结构体。例如，在STM32上，spi_xfer内部会调用HAL库的HAL_SPI_TransmitReceive；在GD32上，可能调用标准外设库的函数；如果使用RT-Thread或FreeRTOS，可能还会在里面加上信号量或互斥锁以保证线程安全。delay_ms和delay_us也类似，可以用MCU的空循环实现，也可以用操作系统的延时函数。drdy_pin_read则简单返回GPIO引脚的电平。
这种设计的最大好处是，驱动核心代码完全不知道它运行在什么平台上。今天我用STM32F103，明天项目换成了AT32F403A，我只需要重新实现ad7193_hal_t里的这几个函数，上层的配置、读取、校准等所有逻辑代码都无需改动，真正做到了“一次编写，到处运行”。
3.2 设备上下文结构体
有了HAL，还需要一个核心的数据结构来保存AD7193的当前状态，我称之为设备上下文（ad7193_dev_t）。它包含了HAL实例、当前的配置、校准系数、内部状态标志等。
typedef struct { ad7193_hal_t hal; // 硬件抽象层 ad7193_config_t config; // 当前配置（模式、滤波器、通道等） ad7193_calib_coeff_t coeff; // 校准系数 uint8_t id; // 读回的芯片ID，用于验证通信 volatile uint8_t drdy_flag; // /DRDY中断标志位 // ... 其他内部状态 } ad7193_dev_t;所有驱动API的第一个参数都是指向这个设备上下文的指针。这意味着同一个工程里可以轻松驱动多片AD7193（比如一个多通道数据采集系统），每片ADC都有自己的独立配置和状态，互不干扰。
3.3 配置管理模块
AD7193的配置参数很多，如果每次都要从头设置一遍会很麻烦。我设计了两种配置方式：
- 完整配置：提供一个
ad7193_init_full()函数，接受一个包含所有参数（模式、数据速率、通道、增益、缓冲、极性等）的配置结构体，一次性写入所有相关寄存器。适用于初始化和模式切换。 - 增量更新：提供
ad7193_set_data_rate()、ad7193_set_channel_gain()等细粒度函数，只修改某一个配置项。这在动态调整采样率或切换通道时非常高效，避免了不必要的寄存器写入。
配置模块内部会进行参数校验。例如，当设置数据速率时，会检查该速率是否在当前所选滤波器类型（sinc3或sinc4）的支持范围内。如果用户试图设置一个无效的增益值（如200），驱动会通过日志函数输出警告，并自动钳位到最接近的有效值（128）。这些细节能帮助开发者快速定位配置错误。
4. 从例程到实战：数据读取与处理流程详解
驱动框架搭好了，接下来就是最核心的部分：如何稳定、高效地读取数据。这里结合一个具体的称重传感器应用场景，把流程走一遍。
4.1 初始化与配置序列
假设我们连接了一个350欧姆的桥式称重传感器，激励电压（Vref）为5V，满量程输出为±2mV/V。我们需要高精度测量，因此选择：
- 通道与增益：AIN1+和AIN1-作为差分输入。传感器满量程电压 = 5V * 2mV/V = 10mV。AD7193在增益128时，输入满量程范围约为±Vref/128 = ±39mV。10mV的信号在这个范围内有较好的分辨率，因此设置增益为128。
- 缓冲器：使能（
buf=1），因为桥式传感器的输出阻抗较高，缓冲器可以降低对信号源的负载效应。 - 滤波器：选择sinc4滤波器，设置输出数据速率为10Hz（对应的字长和建立时间需查阅数据手册）。这个速率对于静态或慢速变化的称重应用足够了，并且能提供很好的50Hz工频抑制。
- 模式：选择连续转换模式。
在代码中，初始化流程如下：
// 1. 实现硬件抽象层函数 static int my_spi_xfer(uint8_t *tx, uint8_t *rx, uint16_t len) { // 这里实现具体的SPI传输，注意控制CS引脚 HAL_GPIO_WritePin(SPI_CS_GPIO_Port, SPI_CS_Pin, GPIO_PIN_RESET); HAL_SPI_TransmitReceive(&hspi1, tx, rx, len, 1000); HAL_GPIO_WritePin(SPI_CS_GPIO_Port, SPI_CS_Pin, GPIO_PIN_SET); return 0; } static void my_delay_ms(uint32_t ms) { HAL_Delay(ms); } static int my_drdy_read(void) { return HAL_GPIO_ReadPin(DRDY_GPIO_Port, DRDY_Pin); } // 2. 组装HAL ad7193_hal_t my_hal = { .spi_xfer = my_spi_xfer, .delay_ms = my_delay_ms, .delay_us = NULL, // 本例中未用到精细延时 .drdy_pin_read = my_drdy_read, .log_print = printf, // 重定向到串口 }; // 3. 定义设备并初始化 ad7193_dev_t my_adc; ad7193_config_t cfg = { .mode = AD7193_MODE_CONT, .data_rate = AD7193_RATE_10HZ, .filter = AD7193_FILTER_SINC4, .channel = AD7193_CH_AIN1P_AIN1M, .gain = AD7193_GAIN_128, .buf_en = 1, .unipolar = 0, // ... 其他配置 }; if (ad7193_init(&my_adc, &my_hal, &cfg) != AD7193_OK) { printf("AD7193初始化失败！\n"); while(1); } printf("AD7193初始化成功，ID: 0x%02X\n", my_adc.id); // 4. 执行内部零电平校准（可选，建议上电后执行） ad7193_calibrate_start(&my_adc, CAL_INTERNAL_ZERO, 0); while(ad7193_calibrate_poll(&my_adc) == CAL_STATE_BUSY) { my_delay_ms(10); } printf("内部零电平校准完成。\n");4.2 连续采样模式下的数据读取
在连续转换模式下，/DRDY引脚会以设定的数据速率（10Hz）周期性地变低。我们采用外部中断方式。
// 在GPIO中断回调函数中（以STM32 HAL为例） void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin) { if (GPIO_Pin == DRDY_Pin) { my_adc.drdy_flag = 1; // 设置标志位 } } // 在主循环中 int32_t raw_data; float voltage, weight; while (1) { if (my_adc.drdy_flag) { my_adc.drdy_flag = 0; // 读取原始24位数据（驱动内部会处理32位数据寄存器的读取） if (ad7193_read_data(&my_adc, &raw_data) == AD7193_OK) { // 将原始码值转换为电压 // 公式: Voltage = (RawCode / 2^23) * (Vref / Gain) // 对于双极性模式，RawCode是24位有符号补码，范围 -2^23 到 2^23-1 voltage = ((float)raw_data / 8388608.0f) * (5.0f / 128.0f); // 5V参考，增益128 // 将电压转换为重量（需要传感器标定系数） // 假设标定系数k = 100.0 kg/V weight = voltage * 100.0f; printf("Raw: %ld, Voltage: %.6f V, Weight: %.3f kg\n", raw_data, voltage, weight); } } // 其他任务... my_delay_ms(1); }这里有一个关键点：ad7193_read_data函数内部不仅仅是从数据寄存器读取3个字节。它首先会读取状态寄存器（可选，用于确认通道和错误状态），然后读取数据寄存器，并将3个字节组合成一个有符号的32位整数（最高位是符号位，低24位是有效数据）。驱动已经处理了字节序和符号扩展，用户拿到的是可以直接用于计算的int32_t类型数据。
4.3 数据处理与滤波
AD7193内部的数字滤波器已经做了很好的噪声抑制，但对于称重这种应用，我们可能还需要在软件层面进行额外的处理来得到更稳定的读数。
- 滑动平均滤波：这是最简单有效的方法。维护一个固定长度的数组，每次读取新数据就放入数组并计算平均值。
#define FILTER_SIZE 10 int32_t filter_buf[FILTER_SIZE] = {0}; uint8_t filter_idx = 0; int32_t filtered_raw = 0; // 在读取数据后 filter_buf[filter_idx] = raw_data; filter_idx = (filter_idx + 1) % FILTER_SIZE; int64_t sum = 0; for (int i = 0; i < FILTER_SIZE; i++) sum += filter_buf[i]; filtered_raw = (int32_t)(sum / FILTER_SIZE); - 异常值剔除：在计算平均值前，可以先去掉明显不合理的数据（例如，与历史平均值偏差超过某个阈值）。这能防止偶然的强干扰（如震动）影响显示。
- 数字去皮（Tare）：这是称重应用的必备功能。本质上就是记录当前读数作为零点偏移，后续所有读数都减去这个偏移。可以在驱动层提供一个
ad7193_tare()函数，它内部其实就是执行一次零电平校准，或者简单地在应用层记录一个偏移量。
4.4 单次转换与省电策略
并不是所有应用都需要连续采样。对于电池供电的便携设备，功耗至关重要。AD7193在单次转换模式下，完成一次转换后会自动进入待机模式，功耗极低。
// 切换到单次转换模式 ad7193_set_mode(&my_adc, AD7193_MODE_SINGLE); // 需要采样时 ad7193_start_single_conversion(&my_adc); // 写入模式寄存器，启动转换 // 等待转换完成（查询/DRDY或延时足够时间） while(ad7193_is_data_ready(&my_adc) == 0); ad7193_read_data(&my_adc, &raw_data); // 读取完成后，芯片自动回到待机模式在这种用法下，MCU大部分时间也可以进入睡眠模式，由定时器或外部事件唤醒后触发一次ADC采样，从而极大降低系统平均功耗。
5. 调试、排坑与性能优化经验谈
写驱动和用驱动是两回事。在实际硬件上调试AD7193，我踩过不少坑，也总结了一些经验。
5.1 通信失败的首个检查点：电源与时钟
如果SPI通信完全读不回正确的ID（AD7193的ID寄存器固定为0x0X），别急着怀疑代码。首先用示波器看三样东西：
- 电源纹波：AVDD和DVDD是否干净？模拟部分最好用LDO单独供电，并靠近芯片管脚放置足够大的去耦电容（如10uF钽电容+0.1uF陶瓷电容）。数字噪声串入模拟电源会显著增加噪声。
- 时钟信号：如果使用外部晶振，波形是否干净？振幅是否足够？如果使用内部时钟，MCLK引脚是否按要求接了电容到地？时钟不稳定是导致数据乱码或转换错误的常见原因。
- 参考电压：REFIN(+)和REFIN(-)之间的电压是否稳定、准确？这是ADC测量的基准，它的质量直接决定精度。对于称重传感器，激励电压往往就是参考电压，所以必须使用高稳定度的基准源或激励电路。
5.2 SPI时序与相位问题
AD7193的SPI模式固定为CPOL=1, CPHA=1（即时钟空闲时为高电平，在第二个边沿采样数据）。很多MCU的SPI外设默认是CPOL=0, CPHA=0。务必在MCU的SPI初始化代码中确认这一点。用逻辑分析仪抓取SPI的MOSI、MISO、SCLK和CS信号，对照数据手册的时序图逐一检查：CS下降沿后是否给了足够的t6时间（NCS to SCLK fall）？数据在SCLK的哪个边沿稳定？读数据时，MCU是否在正确的边沿采样MISO？
一个常见的错误是，读写寄存器时，AD7193没有反应。这可能是因为你发送的指令字节格式不对。AD7193的通信寄存器要求第一个字节的最高位（MSB）为0，表示写操作；为1，表示读操作。后面紧跟寄存器地址。很多工程师习惯先发地址，再发读写标志，顺序反了就会失败。
5.3 数据噪声大的排查思路
即使通信正常，读出来的数据也可能跳动很大。除了检查电源和参考电压，还要关注：
- 传感器连接：差分输入线是否使用了双绞线或屏蔽线？屏蔽层是否单点接地？长导线容易引入干扰。
- PGA增益与输入范围：增益是否设置得过高？如果输入信号非常小（比如几十微伏），而环境噪声有几百微伏，那么高增益会把噪声一起放大。此时需要考虑更好的屏蔽、滤波，或者使用更低的增益并接受一定的分辨率损失。
- 数字滤波器设置：输出数据速率（ODR）设得太高，会导致噪声抑制能力下降。降低ODR可以显著提高噪声性能，但会牺牲带宽。需要根据信号频率权衡。对于直流或慢变信号，将ODR设为10Hz或更低，噪声性能会非常好。
- 接地：模拟地（AGND）和数字地（DGND）如何处理？理想情况下应该在芯片下方单点连接。PCB布局时，要确保模拟部分和数字部分的电流回路不重叠。
5.4 驱动性能优化技巧
- 减少SPI通信开销：在连续读取数据时，可以尝试使用SPI的连续传输模式（如果MCU支持），一次性读取状态寄存器和数据寄存器（共4个字节），而不是分两次操作。这能缩短
/DRDY低电平到数据被读走的时间，在高速采样时尤为重要。 - 使用DMA：对于需要高速连续采样并将数据存入大缓冲区的应用（如振动分析），务必启用SPI DMA。将
/DRDY连接到MCU的EXTI，在中断中启动一次SPI DMA传输（读取数据寄存器）。这样CPU几乎不参与数据传输过程，效率最高。注意DMA缓冲区的对齐和溢出处理。 - 动态配置：如果你的应用需要在不同通道、不同增益间快速切换，不要每次都调用完整的
ad7193_init_full。因为写入配置寄存器后，滤波器需要重新建立稳定状态（settling time），这需要时间。更好的做法是，预先为每种常用配置计算好配置寄存器的值，切换时只写入变化的寄存器，并预留足够的建立时间。AD7193的模式寄存器（Mode Register）有一个“单周期转换”位，在通道切换后使用此模式，可以跳过多个转换周期直到数据稳定，但这需要仔细阅读数据手册的相关章节。
5.5 关于“官方例程”的思考
回过头看，官方例程（无论是ADI的，还是其他芯片厂商的）最大的价值在于它提供了“正确性”的基准。它证明了芯片在特定硬件上是能工作的。但它的局限性也很明显：高度耦合、缺乏抽象、业务逻辑混杂。我们的工作，就是要在理解其正确性的基础上，进行“再创造”，解耦硬件、提炼逻辑、封装功能，使之成为适合自己项目、易于维护和复用的代码。ad7193_generic这个项目，就是这种思路下的一个产物。它不一定适合所有场景，但其中的分层设计、配置管理、状态机处理等思想，在开发其他传感器或外设驱动时，都是相通的。
本文还有配套的精品资源，点击获取
