简介：面向STM32开发者的ATT7022电能计量芯片驱动代码包，专注解决电压、电流、功率等参数的实时采集与精度校正问题，适合正在做智能电表、电力监控或电源管理项目的嵌入式工程师，尤其对需要快速上手计量驱动的新手非常友好。资源全部内容为2个文件，即1个C源文件与1个头文件，源码结构紧凑，压缩包整体约5KB，清晰体现了单芯片驱动的精简实现方式。该驱动参考官方手册编写，并已在实际项目中验证通过，不仅包含各计量参数的读取流程，还覆盖了电压、电流、功率及相位角的校正方法，以及针对环境变化的温度系数补偿逻辑。每个函数均配有详细注释，方便读者对照数据手册理解寄存器操作与校准思路，可直接移植或在此基础上按项目需求二次开发。目前该资源已有681人学习下载，对于需要快速集成ATT7022的开发者而言，是一份难得的参考代码。
1. 拆开这个ATT7022驱动，我发现它解决的不只是“读个数”
做电能计量类的嵌入式项目，最容易被坑的不是SPI通信，而是“读出来的数和实际误差对不上”。这个基于STM32的ATT7022驱动，除了把电压、电流、功率这些计量参数读全之外，还带了相位角校正和温度系数补偿。前者解决“相位差导致的功率误差”，后者解决“环境温度漂移导致的采样偏移”。
对拿官方手册硬啃的人来说，手册里寄存器表和时序图画得很清楚，但真正落板子时有几个细节没写透：校正系数量化格式、温度补偿的插值方式、以及不同计量模式下参数单位怎么换算。这份驱动把这些写成了带注释的C函数，适合用STM32做电能表、智能插座、电力监测模块的硬件和嵌入式工程师。下面按我实际调试时踩过坑的顺序把驱动拆开过一遍。
2. ATT7022计量底层：STM32 SPI通信协议与寄存器读写实现
ATT7022对外只暴露SPI从机接口，所有计量参数都以寄存器形式组织，驱动做的事本质上是“通过SPI读写寄存器”。这和Linux下的字符设备驱动框架是两码事，不涉及设备树、file_operations那一套，就是把CS拉低、按位把数据送进去、再把CS拉高。裸机驱动的难点反而在时序细节和寄存器格式上，而不是架构。
2.1 四线接口与时序特征
和L293D这类直接给电平的电机驱动不同，ATT7022的每条指令固定4字节：第1字节高1位决定读写方向，低7位是寄存器地址；后3字节是数据内容。写操作时后3字节由MCU发送，读操作时MCU继续发送空字节提供时钟，数据由ATT7022在SCLK的下降沿送出。CS在整个4字节传输期间必须保持低电平，帧结束后拉高，两次操作之间建议至少留一个SCLK周期的间隔。
| 信号 | 相对STM32方向 | 作用 | 典型接法 |
|---|---|---|---|
| CS | 输出 | 帧起始与结束 | GPIO推挽输出，空闲拉高 |
| SCLK | 输出 | SPI时钟 | SPI2_SCK |
| DIN | 输出 | 命令与写入数据 | SPI2_MOSI |
| DOUT | 输入 | 计量数据返回 | SPI2_MISO |
这个CS时序要求决定了不能用STM32的硬件NSS。我见过有人在用HAL库时直接把NSS设为硬件自动翻转，结果CS在第一个字节传输完成后就自己拉高了，后面3字节的时钟虽然还在跑，但ATT7022已经认为当前帧结束，读回来的数据全是0xFF。所以驱动里CS基本都用GPIO模拟，哪怕SPI外设本身用的是SPI2，CS也单独占一个GPIO。
2.2 寄存器读写的C实现
项目里att7022.c把读写封装成了两个函数，所有读取电压、电流、功率的接口都建立在它们之上：
// att7022_write_reg: 写入 ATT7022 寄存器 // reg: 7 位寄存器地址; value: 24 位数据 uint8_t att7022_write_reg(uint16_t reg, uint32_t value) { uint8_t tx[4] = {0}; tx[0] = (uint8_t)(0x80 | (reg & 0x7F)); // bit7=1 表示写 tx[1] = (uint8_t)((value >> 16) & 0xFF); tx[2] = (uint8_t)((value >> 8) & 0xFF); tx[3] = (uint8_t)(value & 0xFF); att7022_cs_low(); att7022_spi_transceive(tx, 0, 4); // 写方向，接收缓冲置空 att7022_cs_high(); return 0; } // att7022_read_reg: 读取 ATT7022 寄存器原始值 // 返回的 24 位原始值通过 value 指针带回 uint8_t att7022_read_reg(uint16_t reg, uint32_t *value) { uint8_t tx[4] = {0}; uint8_t rx[4] = {0}; uint8_t i; uint32_t raw = 0; tx[0] = (uint8_t)(reg & 0x7F); // bit7=0 表示读 att7022_cs_low(); att7022_spi_transceive(tx, rx, 4); att7022_cs_high(); for (i = 0; i < 3; i++) { raw = (raw << 8) | rx[i + 1]; // 跳过命令字节，拼接 3 字节数据 } *value = raw; return 0; }读写两个函数的结构几乎一致，差别只在第1字节的bit7。写操作时后3字节是实际要写入的数据，读操作时后3字节是ATT7022输出的内容，主机发的tx[1]到tx[3]保持0即可。返回值不表示芯片校验通过，只代表SPI传输流程走完，如果要确认写入生效，应该在写完后再读一次寄存器比对。
2.3 SPI参数初始化与att7022e的差异
SPI初始化在att7022.c里也有对应函数，常见的配置是主机模式、8位数据帧、CPOL=0、CPHA=1、软件NSS：
void att7022_spi_init(void) { hspi2.Instance = SPI2; hspi2.Init.Mode = SPI_MODE_MASTER; hspi2.Init.DataSize = SPI_DATASIZE_8BIT; hspi2.Init.CLKPolarity = SPI_POLARITY_LOW; // CPOL=0 hspi2.Init.CLKPhase = SPI_PHASE_2EDGE; // CPHA=1 hspi2.Init.NSS = SPI_NSS_SOFT; hspi2.Init.BaudRatePrescaler = SPI_BAUDRATEPRESCALER_64; hspi2.Init.FirstBit = SPI_FIRSTBIT_MSB; HAL_SPI_Init(&hspi2); }CPOL=0、CPHA=1意味着SCLK空闲为低，数据在第二个时钟沿被采样。如果读回来的数固定是0x00或者0xFF，第一件事就是换时钟极性和相位组合，CPOL=0/CPHA=0与CPOL=1/CPHA=1这两组也常见于这枚芯片。波特率预分频先用64，跑通后再逐步提高，ATT7022的最高SCLK限制通常是几百kHz到1MHz这个量级，具体看手册标注。
这里需要特别留意att7022e这个后缀版本。att7022e和att7022在寄存器地址映射和部分中断标志位上存在差异，驱动里如果用了条件编译区分芯片型号，通常在att7022.h顶部留有宏开关；移植到att7022e时先确认这个宏定义的是哪个型号，否则读出来的寄存器数值错乱，容易误判成SPI时序问题。
3. 电压电流功率读取：ATT7022有效值寄存器解析与标度变换
打开att7022.h可以看到，寄存器地址全部用宏定义命名，UL、IL、PT这类缩写一眼能看出是电压、电流和功率。这种组织方式在工程里非常有用：手册里的寄存器编号是十六进制，代码里直接写魔法数，三个月后再维护就完全看不懂了。
3.1 驱动里的寄存器组织方式
| 寄存器宏 | 含义 | 数据格式 | 读取接口 |
|---|---|---|---|
| ATT7022_REG_UL | A相电压有效值原始值 | 24位无符号 | att7022_read_voltage |
| ATT7022_REG_IL | A相电流有效值原始值 | 24位无符号 | att7022_read_current |
| ATT7022_REG_PT | 总有功功率 | 24位补码 | att7022_read_power_total |
| ATT7022_REG_PHCAL | 相位校正字 | 12位补码寄存器 | 校正流程使用 |
这张表对应的是一路单相表计的场景，三相表计对应的是B相、C相寄存器重复。宏定义后面一般都有英文注释标注了寄存器地址，不同批次手册可能把地址写成7位二进制或16进制，核对的时候注意不要拿十进制直接对。
3.2 有效值到物理量的标度变换
ATT7022输出的是24位原始值，单位不是伏特也不是安培。要把原始值换成物理量，理论上需要知道互感器变比、分压电阻、ADC基准电压，这几个参数每个单独换算都会引入误差。驱动采用的做法是直接用一个标度系数，把整个电压通道所有误差一次性折算进去：
// 电压标度系数示例：标准表显示 220.3V，驱动读到原始值 863 // VOLTAGE_SCALE = 220.3 / 863.0 ≈ 0.25527 #define VOLTAGE_SCALE 0.25527f float att7022_read_voltage(void) { uint32_t raw = 0; att7022_read_reg(ATT7022_REG_UL, &raw); return (float)raw * VOLTAGE_SCALE; }电流通道和电压通道结构完全一致，宏观上也是“原始值乘以标度系数”。不同在于电流互感器在零点和满量程附近有非线性，纯线性标度在小电流段会有偏差。如果项目要求100:1的宽动态范围，驱动里一般会在电流函数里再叠加一个分段修正，大电流段用线性系数，小电流段用另一组系数，中间区域线性过渡。
3.3 功率类寄存器要单独处理符号位
功率寄存器和电压寄存器有一个关键区别：功率是有方向的，存的是补码。驱动里单独做了一个符号扩展逻辑：
// 读总有功功率，返回单位 W float att7022_read_power_total(void) { uint32_t raw = 0; int32_t signed_raw; att7022_read_reg(ATT7022_REG_PT, &raw); // BIT23 是符号位：置1表示当前处于反向功率（如发电状态） if (raw & 0x800000UL) { signed_raw = (int32_t)(raw | 0xFF000000UL); // 补码符号扩展 } else { signed_raw = (int32_t)raw; } return (float)signed_raw * POWER_SCALE; }提示：24位寄存器值塞进int32_t之前必须先判断符号位。直接强转会把负数当成一个很大的正数，功率从-120W变成几千万W。
符号扩展这步看起来小，但它是新手上板最容易翻车的地方之一。不同编译器对无符号整型转有符号整型的行为有明确规范，但手动扩展符号位后，代码在GCC、Keil、IAR下行为完全一致，这也是驱动函数注释里写了“所有函数经过实测”的原因之一。
3.4 单次读数与滑动平均的取舍
单次读工厂寄存器拿到的只是一个瞬时值，直接用来显示会跳得厉害。原因在于ATT7022的数据更新频率有限，两次更新之间寄存器内容不变，瞬时值里的纹波分量没有被平滑掉。我一般会在上层做简单平均：
float att7022_read_voltage_avg(uint8_t times) { float sum = 0.0f; uint8_t i; for (i = 0; i < times; i++) { sum += att7022_read_voltage(); HAL_Delay(20); // 等一拍再读，避免连续读到同一帧数据 } return sum / times; }times取5到10之间比较合适。取20次以上平滑效果好，但响应变慢，电网出现短暂过压时读数要很久才反映出来；取两次又起不到平滑作用。智能插座、电能表这类应用取5次就能兼顾响应速度和显示稳定。
4. 相位角与增益校正：ATT7022从“能读数”到“测得准”
电压电流能读出来，只是第一步。真正决定计量产品能不能过检的，是校正环节。很多例程只给读取函数，不给校正代码，导致用户只能对着手册自己啃。这份驱动的可贵之处在于把校正逻辑也写全了。
4.1 误差到底从哪里来
误差主要来自三个地方。第一是电压通道和电流通道的增益偏差，原因是分压电阻和电流互感器都有离散误差，典型值±1%到±3%；第二是相位偏差，电压互感器和电流互感器在不同负载下的相移不一样，纯阻性负载时看不出来，感性负载下功率因数和有功功率会整体偏移；第三是零点偏移，电流小到一定程度后，ADC的失调电压会让读数出现固定偏置。
前两类误差都通过寄存器校正解决，第三类则要在软件里处理，比如电流小于某阈值直接按0显示。
4.2 相位校正寄存器的写入与生效条件
ATT7022的校正寄存器组里有一组相位校正寄存器，驱动封装了写入函数：
// 写入相位校正值 // phase_offset_raw: 从标定流程计算出的相位补偿原始值 void att7022_phase_calibrate(uint16_t phase_offset_raw) { att7022_write_reg(ATT7022_REG_PHCAL, phase_offset_raw & 0x0FFF); att7022_soft_reset(); // 必须软复位，DSP 才会重新加载校正参数 }写完寄存器不触发软复位，是校正流程里最常见的错误。此时读寄存器返回的是刚写入的值，看上去一切正常，但计量内核还在沿用旧参数，结果就是校正值永远不生效。软复位之后要留出5ms到10ms的稳定时间再开始读数据。
4.3 完整标定流程与判断指标
我用的标定流程分五步：
- 接标准源，电压回路和电流回路固定好，电流输出到额定值的80%左右。
- 纯阻性负载下读取电压、电流、功率，分别和标准表对比，计算增益校正值并写入对应增益寄存器。
- 切换到功率因数0.5L的感性负载，读取当前功率因数和有功功率，计算相位补偿值。
- 写入相位校正寄存器，软复位并等待稳定。
- 回到纯阻性负载复测，确认功率因数恢复到1.000附近。
| 校正项目 | 参考标准 | 合格指标 | 常见错误 |
|---|---|---|---|
| 电压增益 | 标准电压源 | ±0.2%以内 | 读数单位没换算，把原始值当物理量 |
| 电流增益 | 标准电流源 | ±0.2%以内 | 小电流段非线性没处理 |
| 相位校正 | PF=0.5L感性负载 | PF误差±0.005 | 写完寄存器没软复位 |
| 有功功率 | 标准电能表 | ±0.5%以内 | 符号位没有正确扩展 |
参数上的坑主要有两个。一个是校正寄存器是12位宽度，超出上限的校正值写进去会被截断，表现是校正曲线在某个点突然反向，这时候应该去查互感器的相位指标而不是继续调大校正值；另一个是电流通道小信号下的零点，如果零点不做归零处理，1%负载点附近的功率误差会显著放大。
5. 温度系数补偿：ATT7022在宽温环境下的误差修正实现
普通例程到此为止，但这份驱动多了一层温度系数补偿，差的就是这层。
5.1 温度漂移的机理与软件补偿的边界
ATT7022内部的带隙基准和ADC输入级随温度漂移，PCB上采样电阻的温漂也在叠加，整条采样链路在-20℃到70℃范围内的总漂移可以到0.5%以上。对电能表来说，这个量已经超出计量精度要求。外部加低温漂电阻和高精度基准能缓解一部分，但成本敏感型产品更划算的做法是软件补偿：先测出温度-增益曲线，运行时读温度，再把结果修正回来。
软件补偿的边界在于它只能修增益类的线性漂移，修不了非线性突变。如果PCB上的焊点或连接器在低温下接触电阻变化，补偿表是追不上的，这种情况只能从硬件层面解决。
5.2 补偿表与线性插值的实现
驱动里维护了一张温度节点和补偿系数的对应表，典型数据长这样：
| 温度点(℃) | 补偿系数 | 说明 |
|---|---|---|
| -20 | 0.9982 | 低温段增益偏低 |
| 0 | 0.9991 | 过渡区 |
| 25 | 1.0000 | 基准点，系数为1 |
| 50 | 1.0013 | 高温段增益偏高 |
| 70 | 1.0021 | 高温极限 |
补偿系数直接用float存，表格很小，运行时插值计算量也可以忽略。实现是典型的折线查表：
#define TEMP_TABLE_POINTS 5 static const int16_t temp_nodes[TEMP_TABLE_POINTS] = {-20, 0, 25, 50, 70}; static const float gain_nodes[TEMP_TABLE_POINTS] = {0.9982f, 0.9991f, 1.0000f, 1.0013f, 1.0021f}; float att7022_temp_compensate(float measured, int16_t temperature) { uint8_t i; float ratio; if (temperature <= temp_nodes[0]) { ratio = gain_nodes[0]; // 低温边界外直接钳位 } else if (temperature >= temp_nodes[TEMP_TABLE_POINTS - 1]) { ratio = gain_nodes[TEMP_TABLE_POINTS - 1]; // 高温边界外钳位 } else { for (i = 0; i < TEMP_TABLE_POINTS - 1; i++) { if (temperature >= temp_nodes[i] && temperature < temp_nodes[i + 1]) { break; // 找到当前温度所在的折线段 } } ratio = gain_nodes[i] + (float)(temperature - temp_nodes[i]) / (float)(temp_nodes[i + 1] - temp_nodes[i]) * (gain_nodes[i + 1] - gain_nodes[i]); } return measured * ratio; }线性插值而不是直接取最近节点，是为了避免温度在节点附近来回抖动时补偿系数跳变。边界外不做外推，直接把端点系数接到边界值上，因为外推在-40℃或85℃这种未标定区域大概率不准，宁可保持和边界相同的修正力度。
为什么补偿表以25℃为基准点？因为所有校正流程都在室温下完成，25℃时补偿系数必然等于1.0000，这样保证校正和补偿两个环节不会互相干扰。实际项目里如果室温不在25℃，可以把基准点改成标定时的实际温度。
5.3 温度源的选择：内部传感器还是NTC
补偿需要温度输入，有两个来源可选：STM32内置温度传感器或者板载NTC。内置温度传感器就近贴在芯片内部，反映的是MCU晶圆温度，和ATT7022采样链路的温度有一定滞后，但胜在零成本、不改板；NTC放在采样电阻附近，反映的才是真正影响计量精度的温度，代价是多占用一路ADC和一颗电阻。
提示：内置温度传感器读出来的温度以25℃为中心，精度一般在±2℃左右，做补偿表插值足够。追求0.1%以内的补偿效果时，用靠近采样链路的NTC更靠谱。
6. 移植与调校：把ATT7022驱动装进真实项目的三个关键验证
驱动拿到手不等于马上能过检，移植到自己板子上之后，我一般会做三件事来验证。
6.1 已知负载验证读数链路
找一只100W白炽灯或者大功率绕线电阻作为纯阻性负载，额定电压下理论功率因数接近1.000。这段代码把驱动读到的四个量一次打出来：
void att7022_selfcheck(void) { float u, i, p, pf; u = att7022_read_voltage_avg(5); i = att7022_read_current_avg(5); p = att7022_read_power_total(); pf = p / (u * i); // 纯阻性负载下应接近 1.000 printf("U=%.2fV I=%.3fA P=%.1fW PF=%.3f\n", u, i, p, pf); }printf需要先做串口重定向，否则输出到半主机模式就卡死在调试器里。PF判据比电压电流单独对比更有用：如果u*i算出的视在功率和读到的有功功率差很多，优先怀疑功率寄存器符号扩展逻辑，而不是标度系数。板子通过stlink驱动连上调试器后，也可以直接在变量窗口看这四个值，和串口打印互相对照。
6.2 从裸机C驱动到C/C++工程
att7022.c和att7022.h是纯C文件，直接用C++工程编译时需要在include之前包一层extern "C"：
#ifdef __cplusplus extern "C" { #endif #include "att7022.h" #ifdef __cplusplus } #endif工程配置层面，在vscode配置c/c++环境时，记得把STM32的HAL库目录和驱动目录加进c_cpp_properties.json的includePath。漏加会表现为函数跳转失效、结构体成员补全报红，这些和驱动逻辑无关但很干扰调试。
6.3 温度箱复测与批次抽检
有条件的话，把校准过的板子放进温度箱跑一轮：-20℃、25℃、70℃三个点各稳定半小时，记录补偿前后读数漂移。补偿前如果漂了0.6%，补偿后应压到0.1%以内，这是判断补偿表是否需要重标的最直接依据。批量生产时同一批板子第一次做完整标定，后续批次可以只做25℃单点校验，抽测两端温度点确认没有批间偏差。
本文还有配套的精品资源，点击获取
