基于立创梁山派GD32F470的INA226高精度电流电压功率监测模块移植与驱动开发最近在做一个电池供电的小项目需要精确监测系统的功耗找来找去发现了TI的INA226这个芯片。它精度高、使用简单正好手头有块立创的梁山派开发板GD32F470ZGT6就想着把它俩结合起来用。今天我就把整个移植和驱动的过程包括硬件怎么接、软件怎么写、校准值怎么算一步步分享给大家。如果你也在用国产的GD32芯片做电源管理、能耗监测或者电池管理系统这篇教程应该能帮到你。1. INA226模块与梁山派开发板简介在开始动手之前咱们先快速了解一下今天要用到的两个“主角”。1.1 INA226模块是什么INA226是德州仪器TI推出的一款高精度、低功耗的电流、电压和功率监测芯片。你可以把它理解为一个非常专业的“电表”能帮你实时测量电路中某一点的电压、流过的电流并自动计算出功率功率电压×电流。我用的这个模块是从网上购买的成品核心就是一颗INA226芯片搭配了必要的采样电阻和滤波电容。模块的主要参数如下工作电压2.7V - 5.5V直接用梁山派的3.3V供电就行工作电流典型值只有330μA非常省电通信方式I2C接口时钟速率支持1kHz到2.94MHz测量范围总线电压0V 至 36V可以测电池电压、电源电压电流取决于外部分流电阻我用的模块是0.1欧姆最大测819.2mA高精度增益误差最大0.1%偏移电压最大10μV做精密测量完全够用。这个模块有10个引脚但咱们核心就用4个VCC、GND、SCL、SDA。它支持16个可编程的I2C地址意味着一条I2C总线上最多可以挂16个同样的模块适合做多路监测。1.2 立创梁山派开发板GD32F470ZGT6梁山派是立创EDA推出的一款基于国产GD32F470ZGT6微控制器的开源开发板。这颗芯片是ARM Cortex-M4内核主频高达200MHz性能强劲外设丰富。最重要的是它的生态和资料完全开源对于学习和项目开发非常友好。我们这次主要用到它的GPIO功能来模拟I2C时序以及后续的串口来打印监测数据。2. 硬件连接与原理接线很简单但理解背后的原理能让调试更顺利。2.1 模块工作原理浅析别看INA226个头小里面可是“五脏俱全”电流测量芯片内部通过测量连接在VIN和VIN-引脚之间的一个外部采样电阻Shunt Resistor两端的压降来推算电流。根据欧姆定律电流 I 电压差 / 电阻值。我手头这个模块用的采样电阻是R100也就是0.1欧姆。电压测量芯片直接测量VIN-和GND之间的电压这就是总线电压。ADC转换芯片内部有一个高精度的模数转换器ADC会把上面测到的模拟电压信号转换成数字值。计算与输出数字信号经过内部处理比如校准、平均滤波然后通过I2C接口把电压、电流的原始数据甚至直接计算好的功率值都提供给我们的单片机。2.2 接线图将梁山派和INA226模块连接起来只需要4根线梁山派引脚INA226模块引脚说明3.3VVCC电源正极GNDGND电源地共地非常重要PB10(或其他任意GPIO)SCLI2C时钟线PB11(或其他任意GPIO)SDAI2C数据线注意INA226模块的VIN和VIN-需要串联到你想监测的电路中。例如你想监测一个负载的耗电就把负载的电源正极先接到模块的VIN模块的VIN-再接到负载的正极输入。模块的GND和负载的GND都接到系统的地。3. 软件驱动开发GPIO模拟I2C梁山派虽然有硬件I2C外设但有时为了调试方便或者引脚复用用GPIO模拟软件I2C更灵活。咱们就从这里开始。3.1 为什么用GPIO模拟I2C硬件I2C固然方便但时序是硬件控制的调试时序问题有时不方便。用GPIO模拟你可以完全控制每一个时钟和数据的变化对于学习I2C协议和理解INA226的通信过程特别有帮助。当然它的缺点是速度比硬件I2C慢并且会占用CPU资源。但对于INA226这种低速传感器完全不是问题。3.2 模拟I2C底层驱动代码首先我们需要定义好使用的引脚。这里我假设使用PB10和PB11。// driver_i2c.h 或 main.h 中定义 #define GPIO_SCL GPIO_PIN_10 #define PORT_SCL GPIOB #define RCU_SCL RCU_GPIOB #define GPIO_SDA GPIO_PIN_11 #define PORT_SDA GPIOB #define RCU_SDA RCU_GPIOB #define SCL_PIN GPIO_SCL #define SDA_PIN GPIO_SDA #define I2C_PORT PORT_SDA // 主要针对SDA操作接下来是具体的模拟I2C实现。我把关键函数都加上了详细注释。// driver_i2c.c #include driver_i2c.h #include systick.h /** * brief I2C GPIO引脚初始化 * note 将SCL和SDA引脚配置为开漏输出模式并初始化为高电平。 * 开漏模式配合外部上拉电阻是实现I2C总线“线与”特性的关键。 */ void i2c_gpio_init(void) { /* 使能GPIOB时钟 */ rcu_periph_clock_enable(RCU_SCL); rcu_periph_clock_enable(RCU_SDA); /* 配置SCL为输出模式上拉 */ gpio_mode_set(PORT_SCL, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_SCL); /* 配置为开漏输出速度50MHz */ gpio_output_options_set(PORT_SCL, GPIO_OTYPE_OD, GPIO_OSPEED_50MHZ, GPIO_SCL); /* 配置SDA为输出模式上拉 */ gpio_mode_set(PORT_SDA, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_SDA); /* 配置为开漏输出速度50MHz */ gpio_output_options_set(PORT_SDA, GPIO_OTYPE_OD, GPIO_OSPEED_50MHZ, GPIO_SDA); /* 将总线拉高进入空闲状态 */ gpio_bit_set(I2C_PORT, SDA_PIN); gpio_bit_set(I2C_PORT, SCL_PIN); } /** * brief I2C延时函数 * note 用于产生I2C时序中的延时调整内部的循环次数可以改变I2C通信速度。 */ void i2c_delay() { uint32_t delay 200; // 这个值需要根据主频调整200MHz下大约产生标准速度 while (delay--) { __NOP(); // 空操作消耗时间 } } /** * brief 产生I2C起始信号 * note 在SCL高电平期间SDA产生一个下降沿。 */ static void i2c_start() { gpio_bit_set(I2C_PORT, SDA_PIN); // 确保SDA高 gpio_bit_set(I2C_PORT, SCL_PIN); // 确保SCL高 i2c_delay(); gpio_bit_reset(I2C_PORT, SDA_PIN); // SDA拉低产生起始条件 i2c_delay(); gpio_bit_reset(I2C_PORT, SCL_PIN); // SCL拉低准备发送数据 i2c_delay(); } /** * brief 产生I2C停止信号 * note 在SCL高电平期间SDA产生一个上升沿。 */ static void i2c_stop() { gpio_bit_reset(I2C_PORT, SDA_PIN); // 确保SDA低 gpio_bit_set(I2C_PORT, SCL_PIN); // 拉高SCL i2c_delay(); gpio_bit_set(I2C_PORT, SDA_PIN); // SDA拉高产生停止条件 i2c_delay(); } /** * brief 向I2C总线写入一个字节 * param data: 要写入的字节 * retval 0: 收到从机应答(ACK) 1: 未收到应答(NACK) */ static uint8_t i2c_write_byte(uint8_t data) { uint8_t i, ack; // 从最高位(MSB)开始依次发送8位数据 for (i 0; i 8; i) { if (data 0x80) // 判断当前要发送的位是1还是0 gpio_bit_set(I2C_PORT, SDA_PIN); else gpio_bit_reset(I2C_PORT, SDA_PIN); gpio_bit_set(I2C_PORT, SCL_PIN); // 拉高SCL数据位有效 i2c_delay(); gpio_bit_reset(I2C_PORT, SCL_PIN); // 拉低SCL为下一位数据做准备 i2c_delay(); data 1; // 左移准备发送下一位 } // 发送完8位后释放SDA线准备读取ACK gpio_bit_set(I2C_PORT, SDA_PIN); gpio_bit_set(I2C_PORT, SCL_PIN); i2c_delay(); ack gpio_input_bit_get(I2C_PORT, SDA_PIN); // 读取SDA电平0为ACK1为NACK gpio_bit_reset(I2C_PORT, SCL_PIN); i2c_delay(); return ack; } /** * brief 从I2C总线读取一个字节 * param ack: 读取后是否发送应答。0:发送ACK1:发送NACK通常是最后一个字节 * retval 读取到的数据字节 */ static uint8_t i2c_read_byte(uint8_t ack) { uint8_t i, data 0; gpio_bit_set(I2C_PORT, SDA_PIN); // 确保SDA为高输入模式 for (i 0; i 8; i) { data 1; // 左移为接收新位腾出空间 gpio_bit_set(I2C_PORT, SCL_PIN); // 拉高SCL从机放置数据位 i2c_delay(); if (gpio_input_bit_get(I2C_PORT, SDA_PIN)) // 读取SDA线上的数据 data | 0x01; // 如果为高则最低位置1 gpio_bit_reset(I2C_PORT, SCL_PIN); // 拉低SCL完成此位接收 i2c_delay(); } // 发送ACK或NACK if (ack) gpio_bit_reset(I2C_PORT, SDA_PIN); // 拉低SDA发送ACK else gpio_bit_set(I2C_PORT, SDA_PIN); // 拉高SDA发送NACK gpio_bit_set(I2C_PORT, SCL_PIN); // 拉高SCL使应答信号有效 i2c_delay(); gpio_bit_reset(I2C_PORT, SCL_PIN); // 拉低SCL i2c_delay(); return data; } /** * brief 向I2C设备写入数据 * param dev_addr: 7位设备地址 * param reg_addr: 寄存器地址 * param data: 要写入的数据数组指针 * param len: 数据长度 */ void i2c_write_data(uint8_t dev_addr, uint8_t reg_addr, uint8_t *data, uint8_t len) { i2c_start(); i2c_write_byte((dev_addr 1) 0xFE); // 发送设备地址 写位(0) i2c_write_byte(reg_addr); // 发送寄存器地址 for (uint8_t i 0; i len; i) { i2c_write_byte(data[i]); // 逐个写入数据 } i2c_stop(); } /** * brief 从I2C设备读取数据 * param dev_addr: 7位设备地址 * param reg_addr: 寄存器地址 * param data: 存储读取数据的数组指针 * param len: 要读取的数据长度 */ void i2c_read_data(uint8_t dev_addr, uint8_t reg_addr, uint8_t *data, uint8_t len) { i2c_start(); i2c_write_byte((dev_addr 1) 0xFE); // 发送设备地址 写位(0) i2c_write_byte(reg_addr); // 发送要读取的寄存器地址 i2c_start(); // 发送重复起始条件 i2c_write_byte((dev_addr 1) | 0x01); // 发送设备地址 读位(1) for (uint8_t i 0; i len; i) { // 如果不是最后一个字节发送ACK如果是最后一个字节发送NACK if (i len - 1) data[i] i2c_read_byte(0); // 读字节并发送NACK else data[i] i2c_read_byte(1); // 读字节并发送ACK } i2c_stop(); }有了这套底层驱动我们就可以和任何I2C设备通信了。接下来就是针对INA226的具体应用。4. INA226驱动实现与校准这是最核心的部分涉及到如何配置INA226以及如何把读回来的原始数据转换成真实的电压、电流值。4.1 关键概念校准值计算在写代码之前有一个非常重要的步骤计算校准寄存器Calibration Register的值。这个值决定了电流测量的精度和量程必须根据你实际使用的采样电阻Shunt Resistor来设置。我的模块使用的是0.1欧姆R100的贴片电阻。INA226数据手册给出了计算公式校准值 0.00512 / (电流分辨率 × 采样电阻)其中0.00512是芯片内部的一个固定常数。电流分辨率Current_LSB是你希望电流寄存器每个数字代表多少安培。它决定了电流测量的精度和量程。采样电阻就是你的R1000.1欧姆。这里有个权衡Current_LSB设得越小精度越高但能测量的最大电流也越小。根据手册分流电压寄存器Shunt Voltage Register的最大值是0x7FFF每个LSB对应2.5μV。所以最大分流电压 0x7FFF * 2.5μV ≈ 81.92mV。那么对于0.1欧姆的电阻最大电流 81.92mV / 0.1Ω 819.2mA。只要我们的测量电流不超过819.2mA就行。我选择设置Current_LSB 0.02 mA/bit(即0.00002 A/bit)。代入公式计算校准值 0.00512 / (0.00002 × 0.1) 2560将十进制2560转换为十六进制就是0x0A00。这个值后面要写到INA226的校准寄存器里。提示如果你用的采样电阻不是0.1欧姆或者期望的电流量程不同一定要根据这个公式重新计算校准值。4.2 INA226驱动代码现在我们来编写INA226的应用程序。首先定义设备地址INA226的默认地址是0x407位地址。// bsp_ina226.h #ifndef __BSP_INA226_H #define __BSP_INA226_H #include main.h #define INA226Addr 0x40 // INA226的7位I2C地址 void ina226_init(void); float ina226_get_voltage(void); float ina226_get_current(void); float ina226_get_power(void); #endif// bsp_ina226.c #include bsp_ina226.h #include driver_i2c.h /** * brief INA226初始化 * note 配置模式、平均次数、电压/电流转换时间并写入计算好的校准值。 */ void ina226_init() { uint8_t config_data[2] {0}; // 第一步先复位芯片可选确保芯片处于已知状态 // 向配置寄存器(0x00)写入0x8000触发软件复位 config_data[0] 0x80; // 高字节 config_data[1] 0x00; // 低字节 i2c_write_data(INA226Addr, 0x00, config_data, 2); // 这里最好加个短暂延时等待复位完成 delay_1ms(10); // 第二步配置工作模式 // 配置字0x4527 // 二进制0100 0101 0010 0111 // 含义平均次数16总线电压转换时间1.1ms分流电压转换时间1.1ms // 模式分流和总线电压连续测量 config_data[0] 0x45; // 高字节 config_data[1] 0x27; // 低字节 i2c_write_data(INA226Addr, 0x00, config_data, 2); // 第三步写入校准值这是最关键的一步 // 根据前面的计算对于0.1Ω电阻和0.02mA/LSB校准值为0x0A00 config_data[0] 0x0A; // 高字节 (0x0A00 8) config_data[1] 0x00; // 低字节 (0x0A00 0xFF) i2c_write_data(INA226Addr, 0x05, config_data, 2); // 0x05是校准寄存器地址 } /** * brief 读取总线电压值 * retval 总线电压单位毫伏(mV) * note 总线电压寄存器(0x02)每个LSB为1.25mV。 */ float ina226_get_voltage() { uint8_t voltage_data[2]; i2c_read_data(INA226Addr, 0x02, voltage_data, 2); // 读取电压寄存器 uint16_t raw_data (voltage_data[0] 8) | voltage_data[1]; float voltage_mv (float)raw_data * 1.25f; // 转换为毫伏 return voltage_mv; } /** * brief 读取电流值 * retval 电流值单位毫安(mA) * note 电流寄存器(0x04)的值是带符号的。转换系数由校准值决定我们之前设的Current_LSB是0.02mA/bit。 */ float ina226_get_current() { uint8_t current_data[2]; i2c_read_data(INA226Addr, 0x04, current_data, 2); // 读取电流寄存器 int16_t raw_data (current_data[0] 8) | current_data[1]; // 注意是有符号数 float current_ma raw_data * 0.02f; // 转换为毫安 (Current_LSB 0.02 mA) return current_ma; } /** * brief 读取功率值 * retval 功率值单位毫瓦(mW) * note 功率寄存器(0x03)每个LSB Current_LSB * 25。 * 我们设置的Current_LSB是0.02mA所以功率LSB 0.02 * 25 0.5 mW/bit。 */ float ina226_get_power() { uint8_t power_data[2]; i2c_read_data(INA226Addr, 0x03, power_data, 2); // 读取功率寄存器 uint16_t raw_data (power_data[0] 8) | power_data[1]; float power_mw (float)raw_data * 0.02f * 25.0f; // 转换为毫瓦 return power_mw; }5. 移植验证与结果展示代码都写好了接下来就是上电测试。5.1 主程序示例创建一个main.c文件初始化所有外设然后循环读取并打印数据。// main.c #include gd32f4xx.h #include systick.h #include stdio.h #include driver_i2c.h #include bsp_ina226.h int main(void) { // 系统时钟、延时初始化 systick_config(); // 初始化串口1用于打印数据假设已实现usart_init函数 usart_init(); // 初始化模拟I2C的GPIO i2c_gpio_init(); // 初始化INA226 ina226_init(); printf(INA226 Power Monitor Test Start!\r\n); while(1) { float bus_voltage ina226_get_voltage(); // 单位: mV float current ina226_get_current(); // 单位: mA float power ina226_get_power(); // 单位: mW printf(Voltage: %.2f mV, Current: %.2f mA, Power: %.2f mW\r\n, bus_voltage, current, power); delay_1ms(1000); // 每秒读取一次 } }5.2 连接与测试硬件连接按照第2章的接线图连接好梁山派、INA226模块和你的待测电路比如一个LED加限流电阻。编译下载使用Keil MDK或你喜欢的IDE将程序编译并下载到梁山派开发板。观察结果打开串口助手如Putty、SecureCRT设置好波特率例如115200就能看到每秒打印一次的电压、电流和功率数据。实测现象 我接了一个120欧姆的水泥电阻作为负载同时用万用表测量电压进行对比。串口助手稳定输出如下数据Voltage: 3300.50 mV, Current: 26.84 mA, Power: 88.57 mW根据欧姆定律计算一下电流 I 3.3005V / 120Ω ≈ 27.5mA功率 P 3.3005V * 0.0275A ≈ 90.8mW。考虑到万用表和采样电阻的误差这个结果是非常准确的证明了我们的驱动和校准是正确的。5.3 常见问题与调试技巧读不到数据/全是0首先用万用表检查VCC和GND是否接好电压是否为3.3V。检查SCL和SDA线是否接反、虚焊。用逻辑分析仪或示波器抓一下I2C波形看起始信号、地址、应答信号是否正常。这是最直接的调试方法。确认INA226的设备地址是否正确默认0x40但模块可能通过跳线改了地址。电流/功率值明显不对99%的问题出在校准值再次确认你的采样电阻阻值并严格按照公式计算校准寄存器值。检查ina226_init函数中写入校准寄存器的值是否正确0x0A00。确保你的待测电流没有超过最大量程对于0.1Ω电阻是819.2mA。数据跳动大在ina226_init函数中可以尝试增加平均次数配置寄存器的高三位。例如设置为0x45FF可以将平均次数提高到128次数据会更稳定但转换时间也会变长。检查电源和地线是否稳定在采样电阻两端并联一个0.1uF的电容可以滤除一些噪声。整个工程代码我已经整理好你可以通过立创开源平台或相关论坛找到基于梁山派的完整示例工程里面包含了所有模块的移植代码直接拿来就能用。希望这篇教程能帮你快速在GD32F470上实现高精度的功率监测功能。在实际项目中你可以把读取到的数据通过无线模块发送出去或者用来控制电源开关实现一个智能的能耗管理系统。