简介：面向STM32开发者的一套ATT7022电能计量驱动源码，适用于智能电表、电力监测与用电数据采集等嵌入式项目。压缩包虽仅含2个文件——1个C源文件与1个头文件，容量只有5KB，却覆盖了从芯片初始化到数据读取的完整驱动流程。作者参考官方手册编写并在实际项目中测试通过，代码不仅读取电压、电流、有功功率、无功功率等计量参数，还实现相位角校正与温度系数补偿，能够改善不同工况下的测量精度。每个函数均配有详细注释，包括寄存器配置、参数换算与校准思路，便于新手对照数据手册理解底层细节，也适合有经验的开发者直接移植复用。目前已有684人学习下载，对初学或正在做校表调试的开发者来说，是一份完整且带详细说明的ATT7022驱动实现，具有直接参考价值。
1. 把 ATT7022E 从数据手册变成能跑的产品代码：一份带着校正与温漂补偿的 STM32 驱动
做电能计量项目的人应该都有过这种体验：ATT7022E 的数据手册写得不算薄，但真到自己上手写驱动时，SPI 读回来的寄存器数据要么是乱的，要么电压电流看着差不多、功率却差得离谱。更头疼的是校表环节——光一个相位角校正就能耗掉半天，温度一变计量精度又漂了。这份基于 STM32 的 ATT7022 驱动代码是我见过少有的把「读取计量参数」和「误差校正 + 温度补偿」一起打包好的资源，驱动文件就两个：att7022.h 和 att7022.c，但里面每个函数都有详细注释，电压、电流、功率、相位角校正全齐，还有温度系数补偿。如果你正在做智能电表、电力监控或者充电桩计量模块，这份驱动能让你直接从「对着手册抠寄存器」跳到「调参校表」的阶段，省掉一大半底层调试时间。
2. 读懂驱动先读懂 ATT7022E 的 SPI 通信：寄存器地图与读写时序
2.1 为什么 ATT7022E 适合做计量前端：芯片选型理由
在接触这份驱动之前，我其实用过其他方案。对比下来，ATT7022E 有几个点很适合 STM32 做主控的场景：首先是它支持 SPI 从机模式，四根线就能搞定通信，不像某些芯片还得外加 UART 转接；其次是内部集成了 ADC 前端和数字信号处理，电压电流的有效值、有功功率、无功功率这些参数直接读寄存器就有，不用自己在 MCU 里做傅里叶变换，这对算法能力有限的单片机来说省了大事。
但要注意，ATT7022E 不是「上电就能出准确数据」的芯片。它内部有增益误差、相位误差，还有温漂，必须通过校正寄存器写入补偿值才能保证计量精度。这也是为什么这份驱动里校正代码占了很大比重——它解决的是「芯片能工作」到「芯片测得准」之间的那段路。对于新手来说，最容易犯的错就是以为 SPI 能读出数来就完事了，结果校表环节完全没做，项目一进现场测试就翻车。
2.2 SPI 通信初始化：模式、速率和 GPIO 配置的坑
这份驱动基于 STM32 标准外设库写的，但逻辑很清楚，移植到 HAL 库也不费劲。先看 SPI 初始化部分，我摘一段核心配置：
void ATT7022_SPI_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; SPI_InitTypeDef SPI_InitStructure; /* 使能 GPIOA 和 SPI1 时钟 */ RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_SPI1, ENABLE); /* SCK: PA5, MOSI: PA7, MISO: PA6, CS: PA4 */ GPIO_InitStructure.GPIO_Pin = GPIO_Pin_5 | GPIO_Pin_6 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure); /* 片选 CS 设为普通推挽输出，手动控制 */ GPIO_InitStructure.GPIO_Pin = GPIO_Pin_4; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; GPIO_Init(GPIOA, &GPIO_InitStructure); GPIO_SetBits(GPIOA, GPIO_Pin_4); // CS 默认拉高 /* SPI1 配置：主机模式，8 位数据，低速分频 */ SPI_InitStructure.SPI_Direction = SPI_Direction_2Lines_FullDuplex; SPI_InitStructure.SPI_Mode = SPI_Mode_Master; SPI_InitStructure.SPI_DataSize = SPI_DataSize_8b; SPI_InitStructure.SPI_CPOL = SPI_CPOL_High; SPI_InitStructure.SPI_CPHA = SPI_CPHA_2Edge; SPI_InitStructure.SPI_NSS = SPI_NSS_Soft; SPI_InitStructure.SPI_BaudRatePrescaler = SPI_BaudRatePrescaler_16; SPI_InitStructure.SPI_FirstBit = SPI_FirstBit_MSB; SPI_Init(SPI1, &SPI_InitStructure); SPI_Cmd(SPI1, ENABLE); }这一段里有几个参数值得说明。SPI_CPOL_High和SPI_CPHA_2Edge表示空闲时时钟为高电平、数据在第二个边沿采样，这是 ATT7022E 手册要求的 SPI 模式，用错的话读回来的数据全是乱的。SPI_BaudRatePrescaler_16把 SPI 时钟降到 4.5MHz 左右（72MHz 主频），ATT7022E 的 SPI 时钟上限不高，跑太快会不稳定。CS 脚这里没用硬件 NSS，而是用普通 GPIO 手动拉低拉高，因为 ATT7022E 的片选时序要求比较严格，手动控制更保险。
初始化之后有个很关键的细节：写寄存器之前要先把芯片复位一次。驱动里ATT7022_Reset()的做法是先发一个软复位命令，然后延时等待芯片内部完成启动。这个延时不能太短，我一般会给 50ms 以上，否则后续读写容易超时。
2.3 寄存器读写的基础函数：时序与校验
读 ATT7022E 寄存器的时序分两步：先发一个字节的寄存器地址（最高位是读标志），然后芯片会在接下来两个字节返回数据。驱动里封装了一个通用读函数：
unsigned int ATT7022_ReadReg(unsigned char reg_addr) { unsigned int value = 0; unsigned char temp[2] = {0, 0}; CS_LOW(); // 拉低片选 /* 发送读命令：最高位置 1 表示读操作 */ SPI1_ReadWriteByte(reg_addr | 0x80); /* 先读一个空字节，等待芯片准备数据 */ SPI1_ReadWriteByte(0xFF); temp[0] = SPI1_ReadWriteByte(0xFF); temp[1] = SPI1_ReadWriteByte(0xFF); CS_HIGH(); // 拉高片选 value = ((unsigned int)temp[0] << 8) | temp[1]; return value; }注意这里第一个SPI1_ReadWriteByte(0xFF)不是多余的操作。ATT7022E 在收到读命令后需要几个时钟周期来准备数据，直接连读两个字节容易把第一字节读成 FF。我后来在逻辑分析仪上看过时序，确认这个「空读」是必要的，省掉的话偶发性出错率会明显上升。
写寄存器稍微简单一些，发地址（最高位为 0）后直接跟两个数据字节就行。但要特别留意：ATT7022E 的有些寄存器是只读的，写进去不会生效也不会报错，调试的时候容易误以为写成功了。驱动里把可写寄存器都定义成了宏，尽量从源头避免这个问题。
3. 把计量参数从寄存器变成工程值：电压、电流、功率的读取与换算
3.1 电压电流有效值读取：比例换算的来龙去脉
寄存器读回来的是原始 ADC 值，必须乘上换算系数才是真实的电压电流。这个系数和你的采样电路有关——电压采样电阻的分压比、电流互感器的变比，直接决定了寄存器和物理量之间的比例关系。驱动里默认给了一组换算公式：
float ATT7022_GetVoltage(void) { unsigned int raw = ATT7022_ReadReg(ATT7022_URMS); // 读电压有效值寄存器 float voltage = (float)raw * 0.00048828125f; // 除以 2048，得到伏特值 return voltage; }0.00048828125这个系数是 1/2048，前提是电压采样通道的 ADC 满量程对应 440V 左右。如果你的硬件分压电阻不是按这个设计，那这个系数就得自己重新标定。驱动里这个值写成什么不重要，重要的是理解换算逻辑：先确认满量程电压，再算出系数。我一般会在硬件设计阶段就把分压网络算清楚，然后在代码里把系数定义成宏，方便后面校表时统一调整。
电流通道同理，但多了互感器变比。驱动里用的是raw * 0.000244140625f，对应 1/4096，这只是在特定互感器参数下的值。如果你用的是 5A:5mA 的互感器，和用 100A:50mA 的互感器，系数差着数量级。
float ATT7022_GetCurrent(void) { unsigned int raw = ATT7022_ReadReg(ATT7022_IRMS); // 电流有效值 float current = (float)raw * 0.000244140625f; // 除以 4096 return current; }3.2 有功功率与视在功率：理解芯片内部的计算逻辑
ATT7022E 内部已经把瞬时功率做积分滤波，读出来的有功功率寄存器值同样要乘系数。但功率的换算系数和电压电流的系数是联动的——如果你单独改了电压系数，功率不跟着改就会对不上。驱动的做法是直接给出组合后的公式：
float ATT7022_GetActivePower(void) { signed int raw = (signed int)ATT7022_ReadReg(ATT7022_PACT); // 有功功率 float power = (float)raw * 0.000244140625f; // 换算到瓦 if (power < 0) power = 0; // 防止反向功率误判 return power; }功率寄存器是带符号的，代表能量流动方向。这里有个细节值得注意：ATT7022_ReadReg返回的是unsigned int，但功率可能是负值，所以要先转成signed int再做运算。驱动里还有一个防负功率归零的处理，但在真正的双向计量场景（比如光伏并网）里这个处理是错的——你会把反向发电量直接抹掉。我自己的做法是保留符号位，由上层逻辑决定怎么用，而不是在驱动层就把它砍掉。
相位角的读取稍微绕一点，寄存器里存的是角度编码值，驱动里给了专门的处理函数，把编码值映射到 -180° 到 +180° 的范围。这个值在校表时很有用，可以直接看出当前相位误差有多大，辅助判断要不要做相位校正。
4. 校表和温度补偿：这份驱动真正的含金量所在
4.1 增益校正的完整链路：写校正寄存器之前要做什么准备
电压、电流的增益校正是校表的第一步。ATT7022E 内部每个通道都有一个增益校正寄存器，写入的值会直接缩放 ADC 结果。驱动里通过对比标准源的实际输入值和芯片读出的原始值，计算出补偿系数，再写回校正寄存器。
流程是先给电路加一个标准电压（比如用校验源输出 220V），让驱动读回调系数，计算出当前偏差。驱动里的自动增益校正函数大概是这样的逻辑：
void ATT7022_GainCalibrate(float standard_voltage) { float measured = ATT7022_GetVoltage(); // 校正前读数 float ratio = standard_voltage / measured; // 偏差比例 unsigned int gain_reg = (unsigned int)(ratio * 0x8000); // 换算成寄存器值 ATT7022_WriteReg(ATT7022_GAIN_URMS, gain_reg); }这里的0x8000是增益寄存器的中值，代表 1.0 倍的缩放比例。但直接这么算写进去往往会差一点，因为芯片的增益调整不是完全线性的。我通常的做法是：先算出理论值写进去，再读一次实际值，如果偏差还在 0.1% 以上就再迭代一次。驱动里提供了单次写入的函数，迭代逻辑一般放在上层校表脚本里。
有一个非常容易被忽略的前提：校表时输入源的精度必须足够高。你拿一个误差 2% 的市电去校表，校完的「准确」也只是相对那个不准的源准确。我在项目里校表都用电参数校验仪，至少 0.2 级精度，否则后面做的相位校正和温度补偿全都白搭。
4.2 相位角校正：为什么只校增益后功率还是不准
如果只做了增益校正，有功功率的误差可能还是有 2%-3%，这是因为电压和电流通道之间存在相位差。这种相位差来源很多：电流互感器的角差、采样电路滤波器的不对称、PCB 布局引入的寄生电容。ATT7022E 提供了相位校正寄存器，能对电压电流之间的相位偏差做补偿。
驱动里用的做法是：在纯阻性负载下（功率因数 = 1），读出芯片计算的无功功率。理论上纯阻性负载下无功功率应该接近 0，如果不为 0，说明存在相位偏差，根据无功功率的符号和大小反推相位补偿值：
void ATT7022_PhaseCalibrate(void) { float reactive_power = ATT7022_GetReactivePower(); // 当前无功读数 signed int adjust = (signed int)(reactive_power * 10.0f); // 经验换算 ATT7022_WriteReg(ATT7022_PHASE_COMP, (unsigned int)adjust); }这个reactive_power * 10.0f是我在实际项目中调出来的经验系数，不同硬件上可能需要微调。相位校正的效果可以通过对比校正前后在感性/容性负载下的功率误差来验证。我见过有人在纯阻性负载下校完增益就以为完事了，一接上电机负载功率误差立刻飙到 5%，就是因为没做相位校正。
4.3 温度系数补偿：让精度不随环境漂移
这是这份驱动最独特的部分。ATT7022E 内部的 ADC 和参考源有温漂特性，温度变化会导致计量结果漂移。驱动里写了一个查表式的补偿方案，核心思路是：在多个温度点下记录误差偏移，然后线性插值补偿。
驱动里补偿参数是这样组织的：
typedef struct { int16_t temperature; /* 温度值，单位 0.1℃ */ int16_t gain_adjust; /* 增益补偿值 */ int16_t phase_adjust; /* 相位补偿值 */ } TempCompPoint; const TempCompPoint temp_table[] = { {-20, 32, 5}, {0, 18, 3}, {25, 0, 0}, {50, -15, -3}, {70, -28, -6} };这个表的意思是：在 -20°C 时，需要在正常增益基础上额外加 32 个 LSB 的增益补偿，相位补偿加 5 个 LSB。实际运行时读取芯片或板载温度传感器的值，然后在这个表里做线性插值：
int16_t ATT7022_GetTempComp(int16_t current_temp, uint8_t type) { uint8_t i; for (i = 0; i < sizeof(temp_table)/sizeof(temp_table[0]); i++) { if (current_temp <= temp_table[i].temperature) break; } /* 边界处理与线性插值 */ if (i == 0) return (type == 0) ? temp_table[0].gain_adjust : temp_table[0].phase_adjust; if (i >= sizeof(temp_table)/sizeof(temp_table[0])) return /* 末尾值 */; /* 插值计算 */ }这个表的数据当然不是拍脑袋写的，而是需要用温箱在不同温度下实际测量后填进去的。但至少驱动把整套补偿框架搭好了，你只需要把自己的实测数据填进去就能用。没有这套框架的话，温度补偿的开发工作量会大得多——你要自己设计数据格式、插值算法、边界处理，还要考虑补偿值如何写回芯片。
5. 避坑与排查：ATT7022E 驱动调试中的常见问题
5.1 SPI 读回来全是 0xFF
现象：调用ATT7022_ReadReg读任何寄存器都是 0xFFFF，数据完全不对。
原因链一般是这样：SPI 模式不匹配，或者 CS 时序没控制好。我遇到过的最隐蔽的情况是 CS 拉低后没有加延时就直接发命令，芯片还没来得及进入通信状态。另外 SPI 时钟太快也会导致采到错误数据。
解决：先用逻辑分析仪或示波器抓 SPI 波形，确认 SCK 空闲电平、数据采样边沿和 CS 相对第一个 SCK 边沿的建立时间。然后确认 SPI 分频不要低于 16 分频，最后在 CS 拉低和发第一个字节之间插入至少 10us 延时。
5.2 电压读数对但电流读数差很多
现象：电压读出 220V 基本准确，电流在已知输入 5A 的情况下读出 4.2A 或 6.5A，偏差很大且不稳定。
原因：电流采样通道的增益校正没有做，或者互感器变比参数和代码里的换算系数不一致。如果电流读数随负载变化成固定比例偏差，那大概率是变比系数的问题。
解决：先用标准电流源输入一个已知电流，对比寄存器的原始值，重新计算换算系数。如果在校正后仍有少量偏差，再走一遍ATT7022_GainCalibrate的迭代流程。注意电流通道的增益校正寄存器是独立的，别只校了电压通道。
5.3 功率因数为 1 时无功功率不为零
现象：带纯阻性负载，有功功率显示正常，但无功功率有读数，而且读数随电流大小变化。
原因：电压电流通道之间的相位差未被补偿，这就是第 3 节里说的相位校正没做的典型症状。纯阻性负载下无功功率理论上应该为零，不为零就说明相位有偏差。
解决：执行ATT7022_PhaseCalibrate，然后再读一次无功功率确认补偿效果。如果补偿后仍然不为零，检查电流互感器的角差规格，可能需要在补偿值上叠加一个固定偏置。
5.4 温度变化后计量精度明显下降
现象：校表是在 25°C 室温下做的，精度很好；设备装到户外，环境温度到 40°C 或更低，误差超过 1%。
原因：没有启用温度补偿，或者补偿表里的数据只有 25°C 一个点。ATT7022E 的温漂在环境温度变化超过 20°C 时不可忽略。
解决：验证驱动里的温度补偿框架是否启用，确认温度传感器读取是否正确。如果补偿表数据还是空的，需要把设备放温箱里做温度点采样，把返回的补偿值填入表里。至少三个温度点才能做线性插值，五个点是起步配置。
5.5 校表数据断电丢失
现象：校正寄存器写入成功，读出来也对，但断电重启后恢复成默认值，所有校正白做了。
原因：ATT7022E 的校正寄存器是 RAM 型的，不是 EEPROM，断电即失。必须在每次上电初始化时重新写入校正参数，或者把参数存在 MCU 的 Flash 里，启动时加载写入。
解决：驱动里需要一个参数存储模块，把校正值和温度补偿表存到 STM32 内部 Flash 或外部存储芯片，上电后由ATT7022_Init()统一写入。这里有个加分做法——用 CRC 校验参数块的完整性，防止 Flash 部分写入导致校正值乱掉。
6. 检表验证与快速上手：一套不用温箱也能用的精度验证流程
拿到这份驱动后，我建议你先别急着改功能，按下面这套流程把驱动跑通，确认基本功能没问题，再做改造。
第一步是硬件确认：四根 SPI 线（SCK、MOSI、MISO、CS）是否连对，ATT7022E 的供电是否稳定，晶振有没有起振。上电后先读芯片 ID 寄存器，确认通信正常。ATT7022E 的 ID 寄存器会返回一个固定值，读不到基本可以断定硬件问题。
第二步是基本计量验证：接入已知电压电流（可以用一个可调稳压源加电阻负载），读电压、电流、功率三个参数，对比万用表和功率计读数，记录初始误差。这一步不要求读得准，只要数值合理、不出现跳变和乱码就行。
第三步才是校表：按第 4 节的顺序依次做增益校正、相位校正、温度补偿参数导入。
我要强调一个教训：温度补偿那个表，哪怕你的产品只在室内用，也建议至少做 0°C、25°C、50°C 三个点。我一开始嫌麻烦只做了两个点，结果产品到北方客户的现场，冬天早上开机时误差比其他时间段大了一截，后来补测数据重新填表才解决。从那以后，我每次拿到新的计量项目都强制走一遍「三温度点采数据 → 插值验证 → 满温度范围复测」的流程，不再省这一步。
验证时我也总结了一个简易方法：不需要温箱的情况下，把设备放在空调房里打到制热模式，等室内温度稳定在一个新值后再测一组数据，与室温数据对比，至少能发现补偿表有没有明显的问题——如果 10°C 温差下误差变化超过 0.5%，那你基本可以断定需要用温箱做全温度范围标定了。
这套驱动把 ATT7022E 从芯片到可用产品之间的路缩短了很多，尤其是对新手来说，跟着注释走一遍就能理解整个计量链路，省掉大量查手册和试错的时间。希望帮到你。
本文还有配套的精品资源，点击获取
