简介这套基于STM32F103C8T6与HT7036/HT7038的嵌入式程序包专为需要采集电压、电流等电能参数的开发人员设计适合具备一定STM32基础、正在从事智能电表或电力监控项目的工程师参考。程序已全部调试完成采用I2C接口OLED液晶屏配合独立按键实时切换显示内容并给出清晰的引脚分配说明OLED接PA3/PA4按键接PA0/PB9/PB0HT7036通过SPI与MCU通信电路连接和代码对应关系一目了然。压缩包共216个文件约6.55MB以C/C源码为核心包含39个h头文件、11个c源文件、14个cpp文件以及Keil工程配置、链接脚本、编译中间文件与hex固件便于直接打开工程二次开发或烧录验证。目前已有1096人学习下载对正在搭建同类采集系统的开发者有直接参考价值可帮助快速理解HT7036的SPI读写流程、OLED显示驱动与按键扫描逻辑缩短项目开发周期。 在做电能计量这类项目时很多人一开始都会想拿STM32F103C8T6自带的ADC去采样电压电流但做到一半就被精度、相位、零点漂移搞到崩溃。我这个方案干脆把模拟量测量这块外包给HT7036/HT7038专用电能计量芯片C8T6只负责通过UART/SPI读寄存器、解析数据、做显示和上传。这篇内容围绕这套组合的硬件接线、驱动代码写法、数据解析和校表思路展开适合正在做智能电表、能效监测终端、智能插座、电力物联网设备的嵌入式工程师参考。1. 先搞明白HT7036和HT7038到底在替你干什么活1.1 从自己啃ADC到让计量芯片干活做电能计量设备时我踩过最大的坑就是一开始想用STM32F103C8T6内部ADC做全流程。12位ADC加上参考电压、温漂、零漂、相位差要计算有效值、有功功率、功率因数、频率还要过计量精度测试工作量远超预期。HT7036/HT7038这类专用计量芯片把这些全做完了芯片内部有高精度ADC和数字信号处理单元电压、电流有效值、有功功率、无功功率、功率因数、频率、电量都是现成的数字量MCU只负责通过通信接口读回来。这个角色划分最大的好处是精度可控、开发周期短而且芯片厂家已经验证过算法不需要自己啃FFT和校准公式。1.2 7036和7038怎么选接口和场景差异这两个芯片经常被放在一起搜实际上定位略有不同。以我查阅手册和使用经验来看HT7036常用UART接口对引脚占用少适合数据刷新要求不高的采集终端HT7038常见SPI接口数据读取速率更高适合需要快速确认实时波形的场合。特性HT7036HT7038通信接口UART常见SPI常见数据刷新相对较低秒级刷新够用更高适合快速采集引脚占用少适合引脚紧张的板子需要SPI引脚连接略多典型场景智能电表、能效采集终端电力监控、快速响应设备我个人的建议是如果MCU引脚紧张、数据量不大优先HT7036如果希望后续扩展快速数据采集直接上HT7038。PCB打样前一定把手册里的帧格式和寄存器地址拉出来对一遍不要只看标题就画板。2. 硬件电路像搭积木最小系统板、采样前端与通信接口2.1 为什么选F103C8T6这块老黄牛STM32F103C8T6虽然是老芯片但资源做这个项目真的很够用72MHz主频、64KB Flash、20KB RAM还有3个USART和2个SPI。驱动HT7036/7038只占用一个UART或一个SPI加一个CS引脚剩下的外设足够接OLED、RS485、蓝牙、按键。更关键的是这种芯片的资料太多蓝色最小系统板几十块就能买到调试环境成熟。网上很多人搜stm32f103c8t6国产替代国产管脚兼容型号也不少项目量产时成本可以压得更低。如果你第一次接触这块板子下载完程序看到板上PC13的LED闪烁这是正常的代表程序在跑不是硬件坏了。2.2 供电与地精度一半藏在电源里HT7036/7038再厉害供电不干净也白搭。它是模拟测量器件开关电源的纹波会直接串到计量结果里。我的做法是STM32和计量芯片分开供电计量芯片用独立的LDO或者至少在它的电源输入端加磁珠加去耦电容模拟地与数字地单点连接。采样信号走线远离继电器、大电流开关这些干扰源。很多项目焊完板子发现电压值有几百毫伏的跳动最后查下来就是电源纹波问题。2.3 电压采样电阻分压网络的参数计算220V交流进芯片前必须缩到芯片可接受的差分输入范围。以常见的电阻分压方案为例先把220V交流经过大阻值电阻分压再送进计量芯片的电压通道输入引脚。假设芯片差分输入满量程约±100mV按220V有效值算峰值约311V分压比要控制在约1/3000。实际工程里我常用3个1MΩ电阻串联再加一个1kΩ采样电阻中间串一个小电阻和电容做RC低通滤波。大阻值电阻串联不只是为了分压更是为了耐压和爬电距离单颗电阻扛220V非常危险。采样电阻要选低温漂高精度的这直接影响电压测量的长期稳定性。2.4 电流采样锰铜分流器还是电流互感器电流通道需要根据产品形态选。小功率智能插座、断路器通常用锰铜分流器成本低、线性好但它与被测电路不隔离电路设计要格外注意安全。大电流、工业场景建议用电流互感器次级接采样电阻把电流转换成电压再送给计量芯片。互感器有变比比如1000:1软件换算电流时要乘回变比。无论哪种方案差分信号都要从芯片引脚近距离接入采样电阻正下方尽量不铺铜避免热电动势和干扰让计量结果飘。2.5 UART和SPI接线别让通信拉低系统可靠性HT7036走UART时芯片的TX/RX和STM32的RX/TX交叉连接共地必不可少波特率按手册配常见4800或9600。HT7038走SPI时建议用SPI1的PA5/PA6/PA7或SPI2的PB13/PB14/PB15CS用普通GPIO软件控制即可。这里有个高频问题很多人板子连好以后数据读不回来先别怀疑芯片先检查SPI的CPOL/CPHA是否符合手册再把MOSI/MISO顺序确认一遍。F103C8T6如果用了USART2/3要注意重映射配置默认引脚和某个功能冲突是很常见的坑。3. 驱动代码的写作顺序从读写一个寄存器开始3.1 标准库还是HAL库和HT7036关系不大这个组合用标准库还是HAL库都行因为计量芯片驱动本质就是UART/SPI收发库只是初始化外设的方式。我现在的习惯是用CubeMX生成工程网上搜HAL库手工创建项目能看到完整流程然后自己写ht703x.c/ht703x.h驱动文件把通信接口和上层业务解耦。这样不管底层用哪个型号的MCU驱动层移植只改收发函数。HAL库里SPI接收有超时时间计量芯片响应慢时要注意超时返回的问题否则系统会卡在等待里。3.2 先写一个读寄存器的函数拿到芯片第一步不是读电压电流而是先把读寄存器这个动作打通。以SPI接口为例读寄存器的骨架大概长这样uint16_t HT7038_ReadReg(uint8_t reg) { uint8_t tx[2] {0}; uint8_t rx[2] {0}; uint16_t value 0; HAL_GPIO_WritePin(CS_GPIO_Port, CS_Pin, GPIO_PIN_RESET); tx[0] 0x00; // 读命令字具体以手册帧格式为准 HAL_SPI_TransmitReceive(hspi1, tx, rx, 1, 10); tx[0] reg; // 寄存器地址 tx[1] 0x00; // 读取时钟发送空闲字节 HAL_SPI_TransmitReceive(hspi1, tx, rx, 2, 10); HAL_GPIO_WritePin(CS_GPIO_Port, CS_Pin, GPIO_PIN_SET); value (rx[0] 8) | rx[1]; return value; }这里我特意把命令字和帧格式写成以手册为准因为不同版本的芯片可能会调整。真正动手前先把目标芯片的数据手册打开找到读命令的格式照着改。UART接口的芯片则是按帧发地址、命令、寄存器号再收校验回来的数据核心思路一样先打通一帧再去读业务寄存器。3.3 常用寄存器先知道往哪儿读驱动通畅后要读哪些寄存器心里要有数。下面这张表以常见单相计量芯片的寄存器布局为例数据类型寄存器示例说明电压有效值0x01两字节一般无符号电流有效值0x02两字节看是否带符号有功功率0x04两字节可能为补码电量累计值0x0F可能多字节注意溢出具体地址每个型号会有差异一定按手册的寄存器表来。读完寄存器先别急着算物理量把原始hex值通过串口打印出来和手册里的样例值对比确认数据链路正确再做换算。这个习惯能省掉后面大量排查时间。3.4 初始化和轮询上电时序比你想的重要HT7036/7038上电后内部有个晶振起振和初始化的过程MCU复位后立刻去读寄存器很容易读回全零或全FF。正确的初始化流程是先让系统时钟稳定然后延时几十到几百毫秒再执行校表参数写入如果需要最后进入轮询或中断读取。读取频率不要无脑拉高。芯片内部有数字滤波和计算周期读太快拿到的可能是尚未更新的旧值还增加SPI/UART总线压力。典型的采集周期可以设在200ms到1s。对实时性要求高的场合可以用芯片的CF脉冲输出做电量累计MCU只对脉冲计数和消抖这样反而更抗干扰也省去了频繁读电量寄存器的麻烦。4. 读回来的原始值不是真值数据解析与校表思路4.1 从原始值到真实的电压电流功率寄存器读回来的数一般是原始数字量必须乘以LSB系数才能变成带单位的物理量。以电压为例常见写法float voltage (float)raw_voltage * 0.01f; // 系数以手册为准这个0.01可能是手册直接给出的也可能是自己校准反推出来的。如果手册没有给明确的LSB值可以在输入端接入一个已知电压源比如用标准源输出220V读回原始值反推系数。电流通道还要把互感器变比考虑进去次级电流换算到一次电流再乘采样电阻转换成电压量。把原始值-物理量-显示值这条链路的每一步都写清楚后面校表和排错都会轻松很多。4.2 校表为什么测出来的功率和实际对不上如果只是看个大概电压值不校表问题不大一旦涉及功率、电量不校表就没法用。校表的基本思路是先校电压增益输入标准电压调整电压增益寄存器让读取值等于标准值。再校电流增益通入标准电流调整电流增益寄存器。校相位补偿接纯阻性负载功率因数应当接近1。如果偏差明显就调整相位补偿寄存器。校偏移输入端短路或空载时读取非零的残余值写入offset寄存器消除。校表最好用标准源和标准表做参照至少测试10%基本电流、100%基本电流、最大电流几个点功率因数0.5L、0.8C也测一下。注意有些芯片需要在校表模式下写寄存器校准完切回正常计量模式否则写入的系数不生效甚至会污染正常计量数据。这个细节手册里往往写得很隐蔽我在这里提个醒。4.3 电量累计与溢出处理电量寄存器是不断累加的长时间运行必然面临溢出问题。MCU侧不能只做一遍赋值要记录上一次读取值每次读回来先判断是否发生了回绕再算差值累加到一个64位变量里。比如uint32_t now Read_Energy(); if (now last_energy) { // 发生了溢出回绕按4字节最大值补偿 diff (uint32_t)(UINT32_MAX - last_energy) now 1; } else { diff now - last_energy; } total_energy diff; last_energy now;这个累计值还要定期写入外部EEPROM或STM32内部Flash防止断电丢失。做预付费场景时掉电保存这块尤其重要否则电量数据一丢售后问题会非常棘手。5. 真实项目里踩过的五个坑5.1 数据读回来全是0xFF这一条几乎所有人都会遇到。最常见的两个原因SPI模式不符或者MOSI/MISO接反。先拿逻辑分析仪抓一下SPI总线上的波形比对手册里的时序图确认命令有没有发出去、芯片有没有应答。还有一个容易被忽略的点CS在整个帧传输期间必须保持低电平如果代码在每发一个字节后都把CS拉高芯片会认为命令被拆成了多帧返回值自然不对。UART版芯片如果读回全是0xFF多半是TX/RX接反或波特率差太多。5.2 电压有值、电流恒为零电压正常但电流一直为0大概率是电流通道没收到信号。先查电流采样电路是否开路特别是互感器次级是否断路、采样电阻是否漏焊再用示波器在芯片电流输入引脚上量有没有毫伏级交流波形。如果硬件没问题就要查芯片内部是否有电流通道切换配置某些芯片支持多路电流采样默认只打开了一路寄存器配置错了就读不到正确的电流值。还有一种是差分输入正负接反虽然不影响有效值大小但在后续功率计算时会出现负功率。5.3 功率值忽大忽小甚至出现负值功率计算需要同一时刻的电压和电流相位信息硬件接线最容易出问题。单相系统里电流互感器S1/S2接反会导致有功功率变成负值这时候把互感器次级两根线对调一下就能解决。如果功率值随机跳动很大概率是采样信号被干扰重点检查地线回路、供电纹波以及采样电阻附近有没有高频开关器件。某些场合软件可以做多帧平均但治标不治本根源还是硬件。5.4 电量跳变或清零电量寄存器忽然跳一个很大的值或者清零先怀疑读取帧错误。UART模式下帧校验很重要收到校验错误的帧直接丢弃不要用脏数据参与累加。我曾经遇到过因为SPI时钟线上有毛刺导致寄存器读错位电量每次跳几千kWh后来在通信线上加了小电阻和滤波电容才解决。另一个原因是校表参数被意外改写比如调试时写错了寄存器地址。建议把配置参数单独做一份备份上电时做CRC校验异常就从备份恢复。5.5 通信偶发失败波特率误差与复位时序UART偶发乱码、SPI偶发超时往往是F103C8T6时钟源不干净导致的。如果用的是内部RC振荡器UART波特率误差可能超过2%长时间通信必然出问题。解决方案是要么换外部8MHz晶振要么在CubeMX里计算一下实际波特率误差换一个更稳的波特率。另外MCU复位后芯片可能还没准备好驱动里必须有延时加重试机制读取失败就重试重试几次还失败再上报错误状态不能一读失败就卡死整个采集任务。6. 跑通之后还可以往这些方向扩展6.1 从裸板到带屏终端OLED本地显示数据读出来以后最自然的需求是本地显示。F103C8T6驱动一块0.96寸I2C OLED很成熟PB6/PB7接SDA/SCL代码量不大。显示内容可以分成电压、电流、功率、电量、频率几个页面用按键切换。这里有个小经验OLED刷新不要太频繁500ms刷新一次足够否则I2C总线占用太多会影响主循环里读取计量芯片的节奏。把显示任务放到定时器中断或者RTOS任务里结构会干净很多。6.2 数据上云WIFI、蓝牙与微信小程序一套计量终端如果数据只在本地屏幕上价值就有限。F103C8T6的空闲串口完全可以接ESP8266或蓝牙透传模块本文还有配套的精品资源点击获取