简介这是一份基于STM32微控制器的INA226电流与功率监控芯片驱动完整工程面向需要做电源管理、电池监测或工业负载检测的嵌入式开发者。包内共151个文件压缩包约2.97MB其中36个h头文件与35个c源文件覆盖STM32标准外设库的定时器、ADC、I2C、USART等外设模块o、d、crf为编译中间产物hex与map文件方便直接烧录和地址映射定位uvprojx工程文件可直接用Keil打开。已有4709人学习下载。对需要快速上手高精度电流电压监测的STM32开发者来说这份工程可帮助理解INA226的I2C通信时序、寄存器配置与功率计算逻辑并结合标准外设库代码掌握传感器驱动的初始化、数据读取和中断处理流程。1. 一块小芯片解决电源监测的大难题INA226与STM32的实战组合有次帮朋友调一个便携设备电池电量显示忽高忽低用万用表量实际电压电流都正常但单片机采回来就是不对。后来换上INA226这颗16位电流/电压/功率监测芯片采样电阻一接什么滤波、补偿全不用自己写了直接读寄存器就是精度还不错的物理量。这份INA226资源包就是围绕这颗芯片整理的STM32 C语言驱动编译环境是Keil MDK拿到手可以直接打开工程跑起来。适合正在做电池监测、电源管理、传感器采集的开发者尤其是想少走弯路的新手。2. 原理与选型INA226的寄存器映射、测量范围和硬件连接2.1 工作原理与关键参数为什么普通ADC方案做不到这个精度INA226内部集成了一路16位Delta-Sigma型ADC通过模拟多路开关交替采样两路信号一路是IN和IN-之间的差分电压也就是分流电阻上的压降另一路是VBUS引脚对GND的总线电压。芯片内部先用可编程增益放大器把差分信号放大再经过ADC量化然后利用校准寄存器里的值把分流电压原始值换算成电流再用电流和总线电压做乘法得到功率。也就是说你不需要在单片机里做浮点运算读哪个寄存器都能拿到带校准结果的物理量。关键参数决定了它为什么比普通单片机自带ADC更适合电源监测。直接看表参数典型值说明供电电压2.7V5.5V用3.3V供电I2C电平可直接匹配STM32共模电压范围0V36VVBUS引脚可直接测电池包电压分流电压分辨率2.5μV/LSB默认PGA增益为100总线电压分辨率1.25mV/LSB测量寄存器内部左对齐低3位为0I2C地址数量16种由A0/A1引脚组合决定转换时间140μs8.244ms可配置平均模式普通STM32内置ADC多为12位参考电压按3.3V算一个LSB对应约0.8mV。采样一个10mΩ分流电阻在1A电流下只有10mV压降换算成电流误差就有80mA。而INA226的分流电压分辨率是2.5μV同样10mΩ电阻对应0.25mA的电流分辨率高了两个数量级。实际因为噪声和温漂做不到极限分辨率但经过平均后做到1mA之内的稳定性是没问题的。这就是我放弃普通ADC方案的最直接原因不是STM32不够快而是它的ADC分辨率对低阻采样来说太粗糙。2.2 硬件连接I2C地址选择、分流电阻布局与开尔文接法INA226的引脚不算多典型的是VS、GND、VBUS、IN、IN-、A0、A1、ALERT。VBUS接被测电源正极IN和IN-串联在电流回路中分流电阻两端分别接IN和IN-。A0和A1用于配置I2C地址它们可以接GND、VS、SDA、SCL四种电平组合出16个地址。通常最简单的做法是把A0和A1都接GND7位地址就是0x40。注意这里说的是7位地址在STM32的HAL库中调用I2C传输时需要左移一位变成8位地址0x80否则设备会无应答。分流电阻的选型是整个硬件设计的核心。默认PGA增益100时分流电压的线性范围大约是±81.92mV所以电阻值要满足一个约束Rshunt 81.92mV / Imax但阻值也不能太小否则在低电流时压降太小分辨率被噪声淹没。比如最大工作电流5A选15mΩ最大压降75mV余量很小如果电流经常在几百mA建议选50mΩ或100mΩ让低电流段也有足够的分辨率。还要注意电阻功耗按P I²R计算5A流过100mΩ电阻就有2.5W功耗根本扛不住。所以大电流场景一般用10mΩ甚至更低小电流精密测量才用100mΩ以上。PCB布局上最容易被忽略的是开尔文接法。IN和IN-的采样走线要从分流电阻的焊盘根部单独引出千万不要直接和主电流走线共用一段铜皮。主电流走线本身有电阻比如3cm长、1mm宽的铜走线在1oz铜厚下大约有50mΩ如果这段电阻被串入采样回路读数会明显偏大。我早期的板子就吃过这个亏采样电阻标称10mΩ结果电流总是偏大20%后来发现是采样点接在了主走线上把走线电阻也算进去了。VS引脚旁边必须放0.1uF陶瓷电容靠近引脚放置在车载或电机这种噪声大的场景再加一个10uF的钽电容会更稳。2.3 寄存器映射与初始化配置从00h到05hINA226一共有六个常用寄存器地址从0x00到0x05另外还有告警相关的0x06和0x07。先把最常用的这几个搞清楚寄存器地址名称宽度描述0x00Configuration16位平均次数、转换时间、工作模式0x01Shunt Voltage16位分流电压原始值有符号补码0x02Bus Voltage16位总线电压原始值低3位为00x03Power16位功率计算结果0x04Current16位电流结果有符号0x05Calibration16位校准寄存器决定电流LSB0x00配置寄存器的位分配要记清楚高4位是平均次数AVG接下来BIT11到BIT6分别是总线电压转换时间VBUSCT和分流电压转换时间VSHCT最低6位是工作模式MODE。默认值0x6127表示16次平均、总线电压转换时间1.1ms、分流电压转换时间1.1ms、连续测量分流电压和总线电压。很多例程直接把这个值写入0x00实际使用中可以根据噪声情况改成0x41274次平均或0x4E2764次平均。校准寄存器0x05的计算公式是CAL 0.00512 / (Current_LSB × Rshunt)Current_LSB是你期望的电流分辨率单位是A/bit。最后写入的校准值必须在0到32767之间如果算出来超出范围说明Current_LSB选得太小。这部分在后面代码初始化时会具体展开。配置寄存器可以随时重写但写入后芯片会重新开始测量所以运行时改配置要多留一点响应时间。3. STM32驱动实现从寄存器读写到电流电压功率计算3.1 I2C底层驱动用HAL库封装可靠的读写函数在Keil MDK工程里我习惯先用STM32CubeMX初始化硬件I2C生成一个I2C句柄比如hi2c1然后在应用层封装INA226的读写函数。INA226的寄存器地址是8位数据是16位高位在前。使用HAL库的HAL_I2C_Mem_Read和HAL_I2C_Mem_Write有两个容易出错的地方一个是设备地址必须左移一位另一个是寄存器地址宽度要指定为8位。下面这个封装可以直接用#include main.h // 包含hi2c1句柄 #define INA226_ADDR 0x40 // A0/A1接GND时的7位地址 // 向INA226的寄存器写入16位数据返回HAL状态 uint8_t INA226_WriteReg(uint8_t reg, uint16_t value) { uint8_t data[2]; data[0] (uint8_t)(value 8); // 寄存器数据高位在前 data[1] (uint8_t)(value 0xFF); return HAL_I2C_Mem_Write(hi2c1, INA226_ADDR 1, reg, I2C_MEMADD_SIZE_8BIT, data, 2, 100); } // 从INA226的寄存器读取16位数据 uint16_t INA226_ReadReg(uint8_t reg) { uint8_t data[2]; if (HAL_I2C_Mem_Read(hi2c1, INA226_ADDR 1, reg, I2C_MEMADD_SIZE_8BIT, data, 2, 100) ! HAL_OK) { return 0xFFFF; // 读取失败时返回一个明显异常值方便调试 } return ((uint16_t)data[0] 8) | data[1]; }这里INA226_ADDR 1是关键HAL库的地址参数是8位格式必须把7位地址左移一位。如果直接填0x40HAL会当成0x40而实际上总线上的地址是0x80芯片就会无应答。另一个参数I2C_MEMADD_SIZE_8BIT告诉HAL发送寄存器地址时只发一个字节INA226的寄存器地址正好在0x00到0x07范围。超时时间我习惯设100ms如果总线异常不会卡死太久。读取失败返回0xFFFF后续计算时要对这个值做判断。3.2 初始化配置校准值和模式怎么定初始化时除了写配置寄存器还要计算并写入校准寄存器。校准值直接决定电流寄存器每一位代表多少安培也影响后续功率计算。假设分流电阻是10mΩ电流分辨率设为1mA/bit那么校准值就是CAL 0.00512 / (0.001 × 0.01) 512但如果分流电阻的实际值和标称值有偏差你会在校准环节重新算。初始化代码如下#define SHUNT_RESISTOR 0.01f // 分流电阻 10mΩ #define CURRENT_LSB 0.001f // 电流分辨率 1mA/bit uint16_t calib_value; void INA226_Init(void) { // 配置0x6127 16次平均总线/分流转换时间1.1ms连续分流总线测量 INA226_WriteReg(0x00, 0x6127); // 根据电流LSB和分流电阻计算校准值四舍五入到整数 calib_value (uint16_t)(0.00512f / (CURRENT_LSB * SHUNT_RESISTOR) 0.5f); INA226_WriteReg(0x05, calib_value); }注意CURRENT_LSB的单位必须是安培分流电阻单位是欧姆算出来的校准值没有单位。如果算出来大于32767说明你期望的电流分辨率太高当前采样电阻不支持小于1则说明分辨率选低了读出来的电流会一步跳很多。初次调试时配置寄存器先用0x6127平均次数16次既能压制一部分噪声又不会让响应太慢。等到后面需要快速保护时再降低平均次数。3.3 数据读取与计算原始值转物理量读取电流和电压时最直接的办法是读电流寄存器0x04和总线电压寄存器0x02电流寄存器是有符号16位总线电压寄存器低3位永远是0必须右移3位再乘以LSB。这个右移是数据手册明确写的低3位不参与计算。我见过不止一个人直接把寄存器值乘以1.25mV结果电压偏大了8倍。// 读取分流电压原始值换算成实际毫伏值 float INA226_ReadShuntVoltage(void) { int16_t raw (int16_t)INA226_ReadReg(0x01); return raw * 0.0025f; // 2.5μV * 1000 0.0025mV } // 读取电流电流LSB在初始化时确定为1mA float INA226_ReadCurrent(void) { int16_t raw (int16_t)INA226_ReadReg(0x04); return raw * CURRENT_LSB * 1000.0f; // 单位mA } // 读取总线电压注意右移3位去掉无效位 float INA226_ReadBusVoltage(void) { uint16_t raw INA226_ReadReg(0x02); return (raw 3) * 0.00125f; // 1.25mV * 1000 1.25V这里返回伏特 }电流寄存器是补码形式比如反向电流会读出负值所以强制转换成int16_t再计算。总线电压寄存器只用了高13位右移3位后乘1.25mV得到的单位是伏特。如果要显示毫伏可以再乘1000根据项目需求统一单位。功率我没有直接读0x03寄存器而是在应用层用电流乘电压float INA226_ReadPowerWatt(void) { float current INA226_ReadCurrent() / 1000.0f; // 先转成安培 float bus_voltage INA226_ReadBusVoltage(); return current * bus_voltage; }为什么不读功率寄存器因为功率寄存器的LSB和电流LSB、总线电压LSB以及芯片内部系数都有关系而且低3位同样无效很多人直接套一个固定系数就翻车。自己用电流乘电压虽然多一步浮点乘法但结果可控也方便统一单位。4. 避坑指南INA226调试中的五个常见问题4.1 现象I2C通信超时设备无应答系统上电后第一次读寄存器就返回HAL_TIMEOUT示波器上看SCL有时钟但SDA一直没低电平拉下来或者只有主设备连续拉低。原因是多方面的。最常见的还是地址没左移。HAL库的I2C地址参数要求的是8位地址也就是7位地址左移一位。如果你直接填0x40实际上总线访问的是0x20芯片当然不会回应。另一个常见原因是A0/A1引脚悬空INA226的内部逻辑会把悬空引脚的电压读成不确定电平导致实际地址和预设不一致。还有芯片供电电压低于2.7V时I2C接口状态异常也会造成无应答。解决先用一个I2C扫描函数把0x40到0x4F之间的每个地址都发一次读请求看看哪个能收到ACK。然后把A0和A1明确接到GND或者VS不要悬空。最后检查VS引脚对地电压以及旁路电容是否靠近引脚。4.2 现象电流读数始终为零但总线电压正常总线电压能读到比如3.3V但无论负载多大读出来的电流一直是0偶尔跳变一下又弹回0。原因大多是分流电阻没有真正串联到负载回路里。有一种是PCB布局错误IN和IN-接在了主走线的同一侧这样两个引脚之间没有压差采样电压永远为0。另一种更隐蔽是配置寄存器的工作模式没有开启分流电压测量。默认的0x6127是连续分流总线测量但如果之前有人为了省电把模式改成了只测总线电压那0x00寄存器的最低几位就不是7电流自然会读0。解决先用万用表直接测IN和IN-焊盘之间的电压在负载下应该有mV级别压降。如果压降为0检查采样电阻的位置确认电流确实流过电阻。如果压降存在但电流寄存器还是0重写配置寄存器为0x6127然后等一个转换周期再读。4.3 现象电压电流读数漂移严重特别是电流负载电流恒定但每秒读到的电流波动几十毫安甚至几百毫安总线电压也有轻微抖动。原因有三个层面。采样电阻的温漂是首选很多便宜的贴片电阻温漂达到几百ppm/℃负载一大电阻发热阻值变化读数跟着漂。PCB布局上采样走线过长且靠近电感或开关节点会把高频噪声耦合进差分回路。还有一个是芯片本身没有开平均模式默认1次转换时随机噪声直接反映在读数里。解决把采样电阻换成低温漂的金属箔电阻或锰铜电阻再把采样走线改成开尔文接法尽量在IN和IN-引脚处加一个100Ω和100nF的RC低通滤波。然后配置寄存器把平均次数提高到64次或128次也就是写0x4E27或0x5127。平均次数越高噪声压制越好但响应速度会变慢需要根据实际控制周期取舍。4.4 现象功率寄存器读数偏大或偏小读0x03功率寄存器和万用表算出来的功率对不上有时差8倍有时差几十倍。问题出在功率寄存器的LSB不是常数。功率寄存器在芯片内部是电流原始值和总线电压原始值的乘积而电流原始值受校准寄存器影响总线电压原始值还有一个固定的1.25mV电压LSB再加上功率寄存器低3位无效。很多人从别人代码里抄来一个固定系数比如0.025W/LSB但那只在特定Current_LSB和特定电压档位下成立换一个分流电阻或校准值就全错。解决最稳妥的是不读0x03功率寄存器直接用INA226_ReadCurrent() * INA226_ReadBusVoltage()自己计算。如果项目要求必须用内部功率寄存器你要根据数据手册的公式重新推导功率LSB并且把读取值右移3位后再乘。这个坑我自己也踩过后来所有驱动里功率一律用乘法省心。4.5 现象连续读取偶尔卡死程序运行几分钟或几小时后I2C读取返回超时示波器看到SDA线被拉低在0.7V左右SCL也没有正常时钟。原因是I2C总线被某个从设备拉死了。常见的是INA226在供电不稳时进入异常状态SCL释放不了要么是上拉电阻没接或者阻值太大总线无法快速恢复高电平。也有可能是I2C中断优先级配置不当高优先级中断长时间占用CPU导致HAL库的I2C状态机超时没有及时处理。解决给SCL和SDA各加4.7kΩ上拉到3.3V确保无数据传输时总线是高电平。然后检查NVIC配置把I2C的中断优先级调低一些并给所有的HAL_I2C_Mem_Read调用加一个重试逻辑连续失败3次后调用HAL_I2C_DeInit再重新HAL_I2C_Init把总线复位。还有一个小技巧初始化时把I2C的时钟频率从400kHz降到100kHz很多时序问题会奇迹般消失。5. 校准与验证用万用表和电子负载把精度逼到极限5.1 校准流程先测偏移再修正增益大多数情况下直接按标称电阻计算出来的校准值可以用但实际电阻的精度通常在1%到5%之间还有PCB走线电阻会导致电流读数系统偏差。想要高精度就要做一次现场校准。需要的工具很简单一台至少4.5位精度的数字万用表一个可调电子负载或精密电阻以及稳定的直流电源。校准流程我一般分三步。第一步是零电流校准负载端断开让流过分流电阻的电流为0读一次电流寄存器记录偏移值通常是几个LSB。这个偏移量要在软件里减去。第二步是加一个已知电流比如1.000A读取电流寄存器的原始值计算出实际电流LSB公式是实际电流除以原始值。第三步是用实际电流LSB反推校准寄存器值CAL_actual 0.00512 / (LSB_actual × Rshunt)然后把新值写入0x05再读一次电流验证。这一步能同时修正分流电阻标称误差和I2C传输带来的整体增益偏差。注意校准完成后不要再改配置寄存器的转换时间否则校准值会基于旧的时序发生轻微变化。我一般会在校准后重新初始化一遍确保配置和校准值是匹配的。实际操作时给一个计算示例。假设标称电阻10mΩ初始Current_LSB设为1mA写入校准值512。加上1A负载后读原始电流寄存器为996说明实际LSB等于1.004mA。这个误差可能来自电阻偏小或走线额外串联。反推校准值就是0.00512 / (0.001004 × 0.01) ≈ 510.0四舍五入后写510再读电流就接近1.000A了。5.2 验证标准误差不能只看满量程校准后要挂负载验证。我这里有一组实测数据用的是某开发板上的INA226电路电子负载设定电流从0.25A到2A万用表串联在电源回路里。数据如下负载设定(A)万用表电流(A)INA226电流(A)误差(%)0.2500.25010.250-0.040.5000.49980.5010.241.0000.99951.0020.251.5001.50021.5010.052.0002.00032.0030.14这个结果在0.3%以内对大多数电源监测场景足够了。如果你的项目要求1%以内那需要注意万用表校准精度对验证结果的影响如果要求0.1%级别就要用更高精度的校准源并且把环境温度控制好。验证时还要关注两个边界一个是最小电流比如10mA时INA226读到的可能跳变几毫安这属于正常噪声可以通过平均模式压下去另一个是最大电流接近分流电压满量程时线性度会下降这时要检查分流电压寄存器是否接近81.92mV的极限如果快到极限说明分流电阻选得太大或最大电流超出设计范围。我会把这些边界数据记录在工程的注释里方便后人参考。6. 最后的小技巧告警引脚和平均模式让监测更智能6.1 告警引脚配置INA226的ALERT引脚可以在电流、电压、功率超过阈值时主动拉低省去单片机轮询的时间。配置方式是用0x06设置警告上限0x07设置屏蔽和使能位。比如让电流超过2A时触发告警先要算出对应的电流寄存器值写入0x06再在0x07里使能电流告警同时将ALERT引脚配置为比较模式。这样在Keil MDK工程里可以用外部中断来检测过流而不必每次读电流再判断。6.2 平均模式与响应速度的取舍平均次数从1次改成128次噪声能下降一个数量级但转换时间也会从几百微秒拉到几十毫秒。如果是做电池电量监测慢一点没关系如果做电源保护建议平均次数设在4到16次同时在ALERT告警上做快阈值。很多项目里既想低噪声又要快响应我一般用两次读取结果快速读取配置4次平均供控制环使用慢速读取配置128次平均供电量统计使用。6.3 我的收尾习惯从那以后我每次画完INA226的板子都会强制走一遍完整流程先测空载偏移再用电子负载校准最后在固定负载下连续跑一小时记录最大漂移和温升。这个流程看起来老派但能挡掉九成以上的反复调试。驱动代码里所有寄存器读取都封装成独立函数调试器里可以直接观察返回值省得反复插拔杜邦线。希望帮到你。本文还有配套的精品资源点击获取