简介hlw8112驱动源码与硬件电路详解资源包面向从事智能能源计量、嵌入式电力仪表开发的工程师及电子爱好者。包内共6个文件包含3个头文件.h和3个C源文件.c压缩后仅7KB代码结构紧凑覆盖hlw8112芯片的SPI通信驱动、寄存器读写、计量数据解析与零点/线性校准关键模块。源码清晰展示了如何配置MOSI、MISO、SCLK、CS四条信号线并封装了初始化、数据读取等接口便于快速移植到主流MCU平台。配套代码中还可辨析电流互感器、电压传感器接入后的数据获取流程以及硬件电路设计中电源稳定、抗干扰布线、EMC处理等实用要点。目前已有2251人学习下载适合需要掌握hlw8112驱动编写方法、理解SPI通信协议并改善计量精度的开发者参考。1. 从 hlw8112 源码包看 SPI 电能计量驱动怎么拆解压hlw8112_hlw8112程序_hlw8112_源码.rar后目录里没有大段文档只有 hlw8112.h、hlw8112.c、HLW8112-SPI.h、HLW8112-SPI.c、spi.c、spi.h 六个文件。这个结构很典型spi.c 管底层时序hlw8112.c 管寄存器读写和计量换算两个头文件对外暴露接口顺带兼容了 HLW8012 的 SPI 接口。与 HLW8012 靠 PF/CF 脉冲输出不同HLW8112 的 SPI 从站模式让 MCU 可以主动读取电压有效值、电流有效值和功率寄存器省掉了外部脉冲计数通道校准也转移到软件侧完成。这套源码适合做智能插座、导轨表、充电桩计量模块的开发者借鉴既能看到稳定的 SPI 驱动写法也能理解计量芯片驱动的基本分层思路。2. HLW8112 SPI 初始化从 spi.c 到寄存器映射2.1 为什么 HLW8112 用的是“命令-应答”型 SPI容易踩的第一个坑是 HLW8112 的 SPI 和 W25QXX 这类存储芯片不一样。它没有标准的读 ID、读数据指令集合而是靠命令字里的地址位和读写标志位来区分操作方向。CS 拉低后主机先发一个命令字节后续几个字节的 MOSI/MISO 方向由这条命令字决定。所以在写 spi.c 时不能只封装一层“SPI 收发字节”还要把片选控制的粒度精确到单条命令周期否则读寄存器时 MISO 上返回的数据会错位。HLW8112 的 SPI 四线接口连接关系如下信号方向说明SCLK主机 → 从机时钟信号空闲电平由 CPOL 决定MOSI主机 → 从机命令字与写入数据MISO从机 → 主机寄存器返回数据CS主机 → 从机低有效片选一次完整命令内保持低电平源码里 CS 通常不是接 SPI 硬件 NSS而是由普通 GPIO 手动拉低。这样才能保证命令字、等待周期和回读数据之间的时序不被硬件自动片选拆散。SCLK 频率也要主动降下来HLW8112 对 SPI 时钟上限有明确要求超出后读回的数据会出现偶发跳变常见做法是把时钟压到 2 MHz 上下既满足高速抄读也留足通信余量。2.2 spi.c 初始化参数与时钟极性选择从 spi.c 的初始化代码能看出整个驱动的 SPI 参数选择逻辑。以 STM32F103 标准外设库为例初始化部分通常长这样/* spi.cHLW8112 SPI 主机初始化以 STM32F103 为例 */ void HLW_SPI_Init(void) { GPIO_InitTypeDef gpio; SPI_InitTypeDef spi; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_SPI1, ENABLE); /* 引脚映射PA5SCLK, PA6MISO, PA7MOSI */ gpio.GPIO_Pin GPIO_Pin_5 | GPIO_Pin_6 | GPIO_Pin_7; gpio.GPIO_Mode GPIO_Mode_AF_PP; gpio.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, gpio); /* PA4 作为 CS手动控制 */ gpio.GPIO_Pin GPIO_Pin_4; gpio.GPIO_Mode GPIO_Mode_Out_PP; GPIO_Init(GPIOA, gpio); GPIO_SetBits(GPIOA, GPIO_Pin_4); spi.SPI_Direction SPI_Direction_2Lines_FullDuplex; spi.SPI_Mode SPI_Mode_Master; spi.SPI_DataSize SPI_DataSize_8b; spi.SPI_CPOL SPI_CPOL_Low; spi.SPI_CPHA SPI_CPHA_1Edge; spi.SPI_NSS SPI_NSS_Soft; spi.SPI_BaudRatePrescaler SPI_BaudRatePrescaler_32; SPI_Init(SPI1, spi); SPI_Cmd(SPI1, ENABLE); }这段代码里最关键的是SPI_CPOL_Low和SPI_CPHA_1Edge组合起来对应 SPI 模式 0。如果 HLW8112 数据手册要求模式 3就把两个宏改成SPI_CPOL_High和SPI_CPHA_2Edge。我一般会先按模式 0 写一版用逻辑分析仪抓 CS 拉低后的 SCLK 和 MISO 波形和 datasheet 上的时序图逐段对比而不是盲改代码。分频系数SPI_BaudRatePrescaler_32的选择和系统时钟有关目标是让 SCLK 实际频率落在芯片允许范围内分频太低时序余量小分频太高又会拖慢批量抄读效率需要平衡。2.3 初始化序列寄存器映射与上电顺序HLW8112 上电后不会立刻以期望的模式工作。源码里 hlw8112.h 会定义一组寄存器地址典型映射如下表具体地址以头文件宏定义为准寄存器名方向含义HLW8112_CTRLR/W工作模式、SPI 使能、计量启动HLW8112_STATUSR断相、过流、能量更新等状态HLW8112_IRQ_ENR/W中断使能HLW8112_VOLTAGER电压有效值原始码HLW8112_CURRENTR电流有效值原始码HLW8112_POWERR有功功率原始码HLW8112_ENERGYR/W能量计数值初始化时先拉低 CS 写控制寄存器开启 SPI 模式并让计量模块工作再读状态寄存器清掉上电标志。这里容易漏的是写控制寄存器后要延时几个毫秒等内部 ADC 稳定紧接着读电压寄存器往往会得到 0 或最大码值看起来像通信失败实际是芯片还没准备好。正确顺序应该是复位 SPI 控制器、配置 GPIO、写控制寄存器、延时、读状态寄存器确认。3. hlw8112.c 读写流程与电压、电流、功率数据换算3.1 读寄存器命令字构造与返回数据拼装hlw8112.c 里的核心函数是寄存器读操作。以读单个 16 位寄存器为例命令字构造和返回值拼装是这样处理的/* hlw8112.c读单个 16 位寄存器 */ uint16_t HLW_ReadReg(uint8_t reg) { uint8_t cmd; uint8_t hi 0, lo 0; cmd (reg 0x7F) | 0x80; /* 最高位置 1 表示读bit6:0 为地址 */ CS_LOW(); HLW_SPI_SendByte(cmd); /* 发送命令字 */ hi HLW_SPI_RecvByte(); /* 读取高字节 */ lo HLW_SPI_RecvByte(); /* 读取低字节 */ CS_HIGH(); return ((uint16_t)hi 8) | lo; }命令字的位域结构对调试很有用位名称说明bit7R/W1 读0 写bit6:0地址7 位寄存器地址后续字节数据读操作返回数据写操作传入数据reg 0x7F取 7 位寄存器地址0x80是读标志。有些版本还要求地址位与读标志满足帧格式校验否则芯片不响应。MISO 上返回的数据顺序是高字节在前先收高位再收低位拼装时注意不要写成(lo 8) | hi。CS_LOW()到第一个 SCLK 沿之间的间隔以及最后一个 SCLK 到CS_HIGH()的保持时间都要按 datasheet 满足否则每次读都会粘滞上一次的数据。3.2 电压、电流、功率有效值的换算HLW8112 寄存器里存的是 ADC 采样后的有效值数字量不是真实电压电流。换算公式一般长这样/* 计量参数宏在 hlw8112.h 中按采样网络标定 */ #define V_COEF 1.234f /* 电压换算系数单位 mV/LSB */ #define I_COEF 0.056f /* 电流换算系数单位 mA/LSB */ #define P_COEF 0.685f /* 功率换算系数单位 mW/LSB */ float voltage HLW_ReadReg(HLW8112_VOLTAGE) * V_COEF / 1000.0f; float current HLW_ReadReg(HLW8112_CURRENT) * I_COEF / 1000.0f; float power HLW_ReadReg(HLW8112_POWER) * P_COEF / 1000.0f;系数来源是采样电阻和分压电阻网络的刻度V_COEF通常是mV/LSBI_COEF是mA/LSBP_COEF是mW/LSB。换算出电压有效值和电流有效值后功率理论上是二者乘积但直接读功率寄存器会包含芯片内部的相位校正结果所以计量结算时优先用功率寄存器而不是自己用电压乘电流。这里还有一个容易忽略的细节读回来的原始值可能是补码形式如果是补码要先判断符号位再转换否则负功率会变成 6 万多的大数。3.3 能量寄存器连续累加与防溢出读法能量寄存器是持续累加的读的时候要防止“读到一半进位”。常见做法是快速连读两次如果两次高位不同就重读/* hlw8112.c读 24 位能量寄存器并防止进位脏读 */ uint32_t HLW_ReadEnergy(void) { uint32_t e1, e2; do { e1 HLW_ReadEnergyOnce(); /* 连续读 3 字节 */ e2 HLW_ReadEnergyOnce(); } while ((e1 16) ! (e2 16)); /* 最高字节不一致则重读 */ return e2; }HLW_ReadEnergyOnce读的是能量计数的高、中、低三个字节几毫秒内芯片可能刚好进位造成最高字节变化。用两次读结果比较最高字节不一致就重来比在中断里加锁更简单。MCU 侧还要做溢出累计把每次读到的 24 位能量值差值累加到 64 位变量里避免长时间运行后计数溢出。4. HLW8112 计量校准零点校准与线性校准的实操流程4.1 零点校准去掉空载偏移所有计量芯片在零输入时原始码都不是绝对的 0HLW8112 也一样。零点校准就是把这种固定偏移记录下来在每包数据里减掉。校准时保证负载为 0电流互感器二次侧开路读取 N 次电流寄存器取平均/* 零点校准空载下采集 16 次电流原始码取平均 */ int32_t zero_offset 0; for (int i 0; i 16; i) { zero_offset (int16_t)HLW_ReadReg(HLW8112_CURRENT); delay_ms(10); } zero_offset / 16;取平均的目的不是凑代码量而是消除 ADC 白噪声和电源纹波带来的短时波动。零点偏移会随温度漂移批量产线只做一次零点校准不够最好在固件里预留温度补偿入口如果没有温度传感器至少要让校准值在断电后保存到外部 EEPROM 或 Flash下次上电自动加载。4.2 线性校准用标准表定标增益系数线性校准解决的是“整体读数放大或缩小”的问题。把被校准板和标准功率源接到同一回路加载额定负载等读数稳定后同时记录标准有功功率P_std和 HLW8112 功率寄存器原始码P_code然后更新增益系数/* 线性校准根据标准表读数反推功率系数 */ extern float P_COEF; P_COEF P_std * 1000.0f / P_code; /* 标准功率 mW ÷ 原始码 */这一步必须在功率因数稳定的纯阻性负载下做感性负载会引入角度误差导致电压电流单独校准都正确、功率却对不上。更新后的系数要回写进hlw8112.h的宏定义或保存到参数区不能只改 RAM 里的临时值。注意标准功率源的最小分辨率要高于被校准表的分辨率否则校准就是拿低精度去矫正高精度越校越差。4.3 校准时的写保护与参数保存部分版本的 HLW8112 支持把校准参数写入芯片内部寄存器但写操作往往需要先解锁。如果直接向寄存器写数不生效去查控制字里是否有写使能位。我的习惯是外部存储一套内部寄存器写一套两套互为备份存储位置优点风险芯片内部寄存器掉电不丢读取快写次数有限误写难恢复外部 EEPROM灵活可改容量大需要 I2C 驱动增加成本校准流程排产时要留一个“写入后回读校验”步骤例如把校准系数写进 EEPROM 后立即读回比较不一致就报错避免出现一批产品装进同一个错误系数。5. 硬件电路与 SPI 波形调试把 HLW8112 的计量误差压下去5.1 供电与采样网络误差的源头HLW8112 供电引脚要放 0.1 µF 陶瓷电容和 10 µF 电解电容电容要靠近芯片电源脚。电压采样用两个大电阻分压到芯片 VP 引脚分压电阻阻值大会降低热噪声但也会提高源阻抗需要在 VP 引脚加一个 1 nF 左右的滤波电容。电流采样用锰铜电阻或电流互感器锰铜电阻走大电流路径时焊盘和铜箔的电阻会被计入采样值所以开尔文连接是必须的不能直接把采样点接到功率回路焊盘上。5.2 SPI 线上串电阻与 CS 时序MCU 到 HLW8112 的 SPI 信号线上各串一个 33 Ω 电阻可以抑制振铃但不要把电阻加在 MISO 上靠近从机侧否则回读波形边沿会变缓。调试时用示波器同时抓 CS 和 SCLK确认 CS 拉低后至少经过半个 SCLK 周期再出第一个时钟沿读完后 CS 拉高前MISO 上最后一个数据位已经稳定。如果发现 MISO 数据在下降沿附近跳变优先检查 SPI 模式配置和走线长度而不是先怀疑芯片。5.3 用焊接后自检脚本来验证校准是否生效批量焊接后用一个固定负载连续读取电压、电流和功率寄存器将读数与标准表比对。如果电压误差正常但电流整体偏低 2%优先查电流采样电阻的焊盘铜箔如果电压电流单独正常、功率偏低查功率因数角和芯片相位校正配置如果读数随机跳变把示波器探头移到 CS 引脚检查片选信号是否被电源毛刺提前拉高就能确定是软件读时序还是硬件布局的问题。本文还有配套的精品资源点击获取