简介这份资源面向嵌入式开发初学者与需要快速验证AD5933阻抗测量方案的工程师提供STM32F030RB通过I2C总线读写AD5933电导率/阻抗转换器并将结果经UART串口上传至PC的完整工程。包内共318个文件约15.56MB以c与h源码、o与d编译中间文件、crf与xcl等Keil工程索引文件为主另含hex烧录文件、map映射表、bat批处理脚本及少量htm说明文档覆盖I2C外设配置、AD5933寄存器读写、串口收发与中断处理等模块。已有2268人学习下载适合对照数据手册理解时序与寄存器操作也可直接作为物联网、环境监测或生物医学测量类项目的通信框架参考帮助读者快速搭建调试环境并排查I2C与UART通信中的常见问题。1. 用 STM32 的 I2C 读写 AD5933为什么你读回的全是 0xFF如果你正在用 STM32 驱动 AD5933 做阻抗测量大概率经历过这个场景代码编译通过I2C 地址也确认了但读回来的实部虚部寄存器全是 0xFF 或者 0x00反复检查时序也找不到原因。AD5933 这颗芯片的 I2C 接口有几个容易翻车的细节——它不支持标准重复起始条件、寄存器地址指针不会自动递增、内部时钟需要先配置才能响应后续命令。这些问题在数据手册里分散在不同章节新手很容易踩进去。这篇笔记面向已经会用 STM32 HAL 库配置 I2C 的开发者目标是让你从零搭出一套能稳定读写 AD5933 的驱动代码包括寄存器写入、单点读取、扫频数据采集以及排查通信失败的具体方法。我会用 STM32F103 和 AD5933 的典型连接方式来讲参数和代码可以直接移植到其他 STM32 系列。整个方案的核心思路是先用最慢的时钟把通信跑通再逐步提高速率最后封装成可复用的读写函数。2. AD5933 的 I2C 协议到底特殊在哪先搞懂时序再动手2.1 从设备地址与寄存器地址指针机制AD5933 的 7 位 I2C 从机地址是 0x0D换算成 8 位写地址是 0x1A读地址是 0x1B。这个地址是固定的没有地址引脚可以改。很多人在用 HAL 库时直接填 0x0D 作为DevAddress结果 HAL 会自动左移一位变成 0x1A这是对的但如果你用的是标准库或者自己写的 GPIO 模拟 I2C就要注意别重复左移。更关键的是 AD5933 的寄存器地址指针机制。每次你要读某个寄存器必须先写一次地址指针然后再发起读操作。地址指针不会自动递增也就是说你读完实部寄存器地址 0x94后想接着读虚部寄存器地址 0x95必须重新写一次地址指针。这一点和很多 EEPROM 不一样EEPROM 通常支持连续读AD5933 不支持。常见做法是封装两个基础函数一个写寄存器一个读寄存器。写寄存器的流程是起始条件 → 发送写地址 0x1A → 发送寄存器地址 → 发送数据 → 停止条件。读寄存器的流程是起始条件 → 发送写地址 0x1A → 发送寄存器地址 → 重复起始条件 → 发送读地址 0x1B → 读取数据 → 发送 NACK → 停止条件。2.2 用 HAL 库实现单寄存器写入与读取先看写寄存器的代码。这里假设你已经用 CubeMX 配置好了 I2C1时钟速率先设成 100kHz等通信稳定后再考虑提高到 400kHz。#include stm32f1xx_hal.h extern I2C_HandleTypeDef hi2c1; #define AD5933_ADDR_W 0x1A // 7位地址0x0D左移一位 #define AD5933_ADDR_R 0x1B /** * brief 向AD5933指定寄存器写入一个字节 * param reg_addr: 寄存器地址如0x80表示控制寄存器 * param data: 要写入的数据 * retval HAL状态 */ HAL_StatusTypeDef AD5933_WriteReg(uint8_t reg_addr, uint8_t data) { uint8_t buf[2]; buf[0] reg_addr; buf[1] data; // HAL会自动处理起始条件、地址发送、数据发送、停止条件 return HAL_I2C_Master_Transmit(hi2c1, AD5933_ADDR_W, buf, 2, 100); } /** * brief 从AD5933指定寄存器读取一个字节 * param reg_addr: 寄存器地址 * param pdata: 读取数据存放位置 * retval HAL状态 */ HAL_StatusTypeDef AD5933_ReadReg(uint8_t reg_addr, uint8_t *pdata) { HAL_StatusTypeDef ret; // 第一步写地址指针 ret HAL_I2C_Master_Transmit(hi2c1, AD5933_ADDR_W, reg_addr, 1, 100); if (ret ! HAL_OK) { return ret; } // 第二步读数据注意这里HAL会自动发重复起始条件 return HAL_I2C_Master_Receive(hi2c1, AD5933_ADDR_R, pdata, 1, 100); }这段代码里有两个参数需要解释。第一个是超时时间 100ms对于 100kHz 的 I2C 时钟来说传输两个字节最多几百微秒100ms 足够宽松不会因为超时误判。第二个是HAL_I2C_Master_Receive的最后一个参数读一个字节时 HAL 会在接收完成后自动发送 NACK 和停止条件不需要手动干预。如果你用的是硬件 I2CHAL 库会自动处理重复起始条件。但如果你用的是 GPIO 模拟 I2C就必须手动实现在发送完寄存器地址后不发停止条件而是直接发新的起始条件然后发送读地址。这是模拟 I2C 最容易写错的地方。2.3 多字节读取与地址指针不递增的应对AD5933 的实部、虚部、温度数据都是 16 位的分两个 8 位寄存器存放。比如实部寄存器地址是 0x94高字节和 0x95低字节。由于地址指针不自动递增你不能一次读两个字节必须分两次读。/** * brief 读取16位寄存器高字节在前 * param reg_addr: 高字节寄存器地址 * param pdata: 读取的16位数据 * retval HAL状态 */ HAL_StatusTypeDef AD5933_ReadReg16(uint8_t reg_addr, uint16_t *pdata) { uint8_t high, low; HAL_StatusTypeDef ret; ret AD5933_ReadReg(reg_addr, high); if (ret ! HAL_OK) return ret; ret AD5933_ReadReg(reg_addr 1, low); if (ret ! HAL_OK) return ret; *pdata ((uint16_t)high 8) | low; return HAL_OK; }这里有个血泪经验AD5933 的实部和虚部数据是以二进制补码形式存放的最高位是符号位。如果你直接当无符号数处理负值会变成很大的正数。正确的做法是先转成有符号 16 位再参与计算。比如读回 0xFFFE实际值是 -2不是 65534。3. 从复位到扫频AD5933 完整初始化与测量流程3.1 控制寄存器配置与内部时钟使能AD5933 上电后处于待机状态必须通过控制寄存器地址 0x80配置后才能工作。控制寄存器的位定义如下位名称功能D15-D12功能选择0001初始化起始频率0010启动扫频0011增量频率0100重复频率D11-D10电压范围002Vpp, 01200mVpp, 10400mVpp, 111VppD9-D8增益001x, 015xD7-D4保留必须写0D3外部时钟0内部时钟1外部时钟D2复位1复位需手动清零D1保留必须写0D0使能1使能0待机初始化流程是先复位 → 配置起始频率 → 配置频率增量 → 配置增量数 → 配置 settling 时间 → 使能内部时钟 → 进入待机 → 初始化起始频率 → 启动扫频。/** * brief AD5933完整初始化 * param start_freq: 起始频率代码4字节 * param freq_inc: 频率增量代码4字节 * param num_inc: 增量数2字节 * param settling: settling时间周期数 */ void AD5933_Init(uint32_t start_freq, uint32_t freq_inc, uint16_t num_inc, uint16_t settling) { // 1. 复位控制寄存器D2置1 AD5933_WriteReg(0x80, 0x10); HAL_Delay(10); AD5933_WriteReg(0x80, 0x00); // 清除复位位 HAL_Delay(10); // 2. 写起始频率地址0x82-0x85高字节在前 AD5933_WriteReg(0x82, (start_freq 24) 0xFF); AD5933_WriteReg(0x83, (start_freq 16) 0xFF); AD5933_WriteReg(0x84, (start_freq 8) 0xFF); AD5933_WriteReg(0x85, start_freq 0xFF); // 3. 写频率增量地址0x86-0x89 AD5933_WriteReg(0x86, (freq_inc 24) 0xFF); AD5933_WriteReg(0x87, (freq_inc 16) 0xFF); AD5933_WriteReg(0x88, (freq_inc 8) 0xFF); AD5933_WriteReg(0x89, freq_inc 0xFF); // 4. 写增量数地址0x8A-0x8B AD5933_WriteReg(0x8A, (num_inc 8) 0xFF); AD5933_WriteReg(0x8B, num_inc 0xFF); // 5. 写settling时间地址0x8C-0x8D AD5933_WriteReg(0x8C, (settling 8) 0xFF); AD5933_WriteReg(0x8D, settling 0xFF); // 6. 使能内部时钟进入待机D30, D00 AD5933_WriteReg(0x80, 0x00); HAL_Delay(10); // 7. 初始化起始频率功能码0001电压范围2Vpp增益1x AD5933_WriteReg(0x80, 0x10); HAL_Delay(10); }这段代码里最容易出错的是第 6 步和第 7 步之间的顺序。必须先让内部时钟稳定再发初始化起始频率命令。如果顺序反了AD5933 会忽略初始化命令后续读回的实部虚部全是 0。另外复位后必须手动清除 D2 位否则芯片一直处于复位状态。3.2 启动扫频与读取实部虚部数据初始化完成后发送启动扫频命令然后等待状态寄存器地址 0x8F的 D2 位变为 1表示当前频率点测量完成。/** * brief 启动扫频并读取一个频率点的数据 * param real: 实部输出 * param imag: 虚部输出 * retval 0成功-1超时 */ int AD5933_MeasurePoint(int16_t *real, int16_t *imag) { uint8_t status; uint32_t timeout 100000; // 发送启动扫频命令功能码0010电压2Vpp增益1x AD5933_WriteReg(0x80, 0x20); // 等待测量完成 do { AD5933_ReadReg(0x8F, status); if (--timeout 0) return -1; } while ((status 0x04) 0); // 读取实部0x94-0x95 uint16_t raw_real, raw_imag; AD5933_ReadReg16(0x94, raw_real); AD5933_ReadReg16(0x96, raw_imag); // 转换为有符号数 *real (int16_t)raw_real; *imag (int16_t)raw_imag; return 0; }状态寄存器的 D2 位是数据有效标志D1 位是扫频完成标志。如果你要连续测多个频率点每次测完一个点后发送增量频率命令功能码0011然后再次等待 D2 置位。注意每次读取数据后D2 位会自动清零不需要手动清除。3.3 频率代码计算与参数换算AD5933 的频率代码不是直接写频率值而是写一个 32 位整数。计算公式是频率代码 (目标频率 × 2^27) / 外部时钟频率。如果使用内部 16.776MHz 时钟公式简化为频率代码 目标频率 × 8。比如你要测 10kHz频率代码就是 10000 × 8 80000 0x00013880。频率增量的计算方式相同。增量数就是你打算测多少个频率点比如从 10kHz 到 100kHz步进 1kHz增量数就是 90。参数计算公式示例10kHz起点1kHz步进起始频率代码频率 × 880000 (0x00013880)频率增量代码步进 × 88000 (0x00001F40)增量数(终点-起点)/步进90settling时间根据阻抗范围调整先设15再优化settling 时间的设置比较玄学它决定了每个频率点测量前等待多少个时钟周期。如果设得太小读数不稳定设得太大扫频速度慢。一般先从 15 开始试如果数据跳动大就增加到 50 或 100。4. 通信失败排查I2C 读写 AD5933 的 5 个典型坑4.1 读回全是 0xFF 或 0x00现象调用读寄存器函数返回的数据始终是 0xFF 或 0x00换几个寄存器地址都一样。原因I2C 通信根本没有建立。可能是 SDA/SCL 接反了或者上拉电阻没接或者 AD5933 的供电电压不对。AD5933 的 VDD 范围是 2.7V 到 5.5V但 I2C 电平取决于 VDD。如果 STM32 是 3.3V 而 AD5933 是 5V 供电需要电平转换。解决先用示波器看 SCL 和 SDA 波形。正常通信时 SCL 应该有 9 个时钟脉冲地址 7 位 读写位 ACK。如果 SCL 没有波形检查 GPIO 配置和 I2C 外设时钟使能。如果 SDA 一直拉低检查是否有短路或者从设备把总线拉死了。4.2 HAL_I2C_Master_Transmit 返回 HAL_BUSY现象第一次调用写寄存器成功第二次调用返回 HAL_BUSY程序卡死。原因AD5933 在收到停止条件后需要一定时间处理内部状态如果紧接着发下一次起始条件它可能还没准备好。另外如果上一次传输因为某种原因没有正确产生停止条件I2C 总线会处于忙状态。解决在每次读写之间加 1ms 延时。如果已经出现 BUSY调用HAL_I2C_DeInit再HAL_I2C_Init重新初始化 I2C 外设强制释放总线。更彻底的做法是在 SCL 上手动发 9 个时钟脉冲让从设备释放 SDA。4.3 写入控制寄存器后读回值不对现象向控制寄存器 0x80 写入 0x10读回来却是 0x00 或其他值。原因AD5933 的控制寄存器有些位是只读的有些位写入后会立即生效并自动改变。比如复位位 D2 写入 1 后芯片复位完成会自动清零。另外如果你在写控制寄存器之前没有正确配置地址指针数据可能写到了别的寄存器。解决写完后立即读回验证但要注意区分哪些位是会自动变化的。对于复位操作写 0x10 后读回 0x00 是正常的。对于其他配置读回值应该和写入值一致保留位除外。4.4 扫频数据跳变严重现象同一个阻抗连续测量几次实部虚部数值差异很大。原因settling 时间不够或者激励电压幅度太小导致信噪比低或者 PCB 布局不好引入了噪声。AD5933 的激励信号是正弦波如果走线太长或者靠近高频信号容易耦合噪声。解决先把 settling 时间增加到 100 以上看数据是否稳定。如果还跳检查激励电压范围设置200mVpp 适合高阻抗测量2Vpp 适合低阻抗。另外AD5933 的 RFB 电阻和校准电阻要匹配你的测量范围RFB 太大或太小都会导致读数不准。4.5 内部时钟使能后仍然无法测量现象按照流程配置了内部时钟但状态寄存器的 D2 位一直不置位测量超时。原因内部时钟使能后需要等待至少 1ms 才能稳定。如果你在使能后立即发初始化起始频率命令AD5933 可能还没切换到内部时钟。另外控制寄存器的 D3 位必须为 0 才能使用内部时钟如果误写为 1芯片会等待外部时钟而你没有提供就会一直卡住。解决在使能内部时钟后加 10ms 延时。用示波器测量 AD5933 的 MCLK 引脚如果有引出正常应该有 16.776MHz 的方波。如果没有检查控制寄存器 D3 位是否确实为 0。5. 用状态机封装非阻塞驱动与校准流程5.1 非阻塞状态机设计在实际项目中用 HAL_Delay 阻塞等待测量完成会浪费 CPU 时间。更好的做法是用状态机把整个测量流程拆成多个步骤在主循环中轮询推进。typedef enum { AD5933_STATE_IDLE, AD5933_STATE_INIT_FREQ, AD5933_STATE_START_SWEEP, AD5933_STATE_WAIT_DATA, AD5933_STATE_READ_DATA, AD5933_STATE_NEXT_FREQ, AD5933_STATE_DONE } AD5933_State_t; typedef struct { AD5933_State_t state; uint16_t current_point; uint16_t total_points; int16_t real[100]; int16_t imag[100]; } AD5933_Handle_t; /** * brief 非阻塞状态机推进函数在主循环中定期调用 * param h: AD5933句柄 */ void AD5933_Process(AD5933_Handle_t *h) { uint8_t status; switch (h-state) { case AD5933_STATE_IDLE: break; case AD5933_STATE_INIT_FREQ: AD5933_WriteReg(0x80, 0x10); // 初始化起始频率 h-state AD5933_STATE_START_SWEEP; break; case AD5933_STATE_START_SWEEP: AD5933_WriteReg(0x80, 0x20); // 启动扫频 h-state AD5933_STATE_WAIT_DATA; break; case AD5933_STATE_WAIT_DATA: AD5933_ReadReg(0x8F, status); if (status 0x04) { // D2置位数据有效 h-state AD5933_STATE_READ_DATA; } break; case AD5933_STATE_READ_DATA: AD5933_ReadReg16(0x94, (uint16_t *)h-real[h-current_point]); AD5933_ReadReg16(0x96, (uint16_t *)h-imag[h-current_point]); h-current_point; if (h-current_point h-total_points) { h-state AD5933_STATE_DONE; } else { h-state AD5933_STATE_NEXT_FREQ; } break; case AD5933_STATE_NEXT_FREQ: AD5933_WriteReg(0x80, 0x30); // 增量频率 h-state AD5933_STATE_WAIT_DATA; break; case AD5933_STATE_DONE: break; } }这个状态机的关键点是每次只做一件事不阻塞。AD5933_Process可以放在主循环里也可以放在定时器中断里调用频率取决于你的测量速度要求。注意AD5933_ReadReg16的参数转换这里直接把int16_t数组元素的地址传进去读回的数据本身就是补码形式不需要额外转换。5.2 校准流程与阻抗计算AD5933 读回的实部虚部是原始 ADC 码要转换成阻抗值需要先做校准。校准的方法是接一个已知阻值的校准电阻 R_cal测出对应的实部虚部计算出增益系数。/** * brief 计算校准增益系数 * param real: 校准电阻的实部读数 * param imag: 校准电阻的虚部读数 * param r_cal: 校准电阻阻值 * param gain: 输出增益系数 * param phase: 输出相位偏移 */ void AD5933_Calibrate(int16_t real, int16_t imag, float r_cal, float *gain, float *phase) { float magnitude sqrtf((float)real * real (float)imag * imag); *gain 1.0f / (magnitude * r_cal); *phase atan2f((float)imag, (float)real); } /** * brief 根据校准系数计算未知阻抗 * param real: 测量实部 * param imag: 测量虚部 * param gain: 校准增益 * param phase: 校准相位 * param r_out: 输出阻抗模值 * param phase_out: 输出阻抗相位 */ void AD5933_CalculateImpedance(int16_t real, int16_t imag, float gain, float phase, float *r_out, float *phase_out) { float magnitude sqrtf((float)real * real (float)imag * imag); *r_out 1.0f / (magnitude * gain); *phase_out atan2f((float)imag, (float)real) - phase; }校准电阻的选择有个经验法则选你测量范围的中心值。比如你要测 1k 到 100k 的阻抗校准电阻选 10k。校准电阻的精度直接影响测量精度建议用 0.1% 精度的金属膜电阻。另外校准和测量时的激励电压范围、增益设置、settling 时间必须完全一致否则增益系数不适用。5.3 提高测量稳定性的几个技巧第一个技巧是多次测量取平均。AD5933 单次测量噪声比较大连续测 4 次取平均可以把噪声降低一半。但要注意每次测量前要重新初始化起始频率不能直接连续读。第二个技巧是温度补偿。AD5933 内部有温度传感器地址 0x92读回值换算公式是温度 读回值 / 32 - 273.15。如果测量环境温度变化大可以根据温度对增益系数做修正。第三个技巧是 PCB 布局。AD5933 的激励输出和接收输入要远离RFB 电阻要靠近芯片引脚模拟地和数字地要分开走线。这些在数据手册的布局建议章节都有但很多人不看结果数据跳得厉害。我在实际项目里踩过最深的坑是用 3.3V 的 STM32 直接连 5V 供电的 AD5933I2C 通信时好时坏。后来加了电平转换芯片才彻底解决。如果你也遇到类似情况先确认两边电压是否一致不一致就加转换别想着侥幸。希望帮到你。本文还有配套的精品资源点击获取
