【STM32】INA3221三通道电压电流采集模块，HAL库

田甲2024-11-03 11:24

一、简单介绍

芯片的datasheet地址：

INA3221 三通道、高侧测量、分流和总线电压监视器，具有兼容 I2C 和 SMBUS 的接口 datasheet (Rev. B)

笔者所使用的INA3221是淘宝买的模块

原理图

模块的三个通道的电压都是一样，都是POWER。这个芯片采用的是高侧测量：每个通道有两个引脚，一个连接负载去给负载供电，另一个回来，回到GND

经过笔者测量和观察，采样电阻的阻值应该是100mΩ

二、模块与接线

INA3221使用IIC通信协议进行读写，笔者使用的是STM32G030F6P6单片机来操作，读者按实际情况类推即可，cubeMX配置，基本都大差不差。

POWER连接外部电源的正极

GND连接外部电源的负极

将模块的GND与单片机的GND连接起来，注意这里地接在一起，如果单片机连着电脑，请务必小心操作，不要接反也不要短路

三、cubemx配置

设置时钟

用内部的RC震荡就可以了，也可以使用外部晶振，但如果用外部晶振的话，这颗晶振必须是有源的，之前看一些G030的板子焊了一个无源晶振，有点匪夷所思。

设置IIC

打算把电压和电流显示在0.96寸的oled上，因此就开了两个IIC，当然了，只开一个也可以，把INA3221和OLED都接在一个IIC总线上就行了，但为了方便，笔者开了两个。

这里的频率可以开到1Mhz，如果是103C8T6，应该是到不了的😋

数据量很小，DMA就不开了

设置GPIO

由于模块上自带了LED灯，所以就没必要开输入IO口给模块，可以开一个监控单片机程序运行的LED

至此，cubeMX配置完毕

四、keil配置

五、驱动编写

打开手册关于编程的章节

支持快速IIC传输，且高位在前

不管是读还是写，一开始要发一个寄存器指针过去，定位一下寄存器

寄存器读写函数

cpp 复制代码 
static void INA3221_ReadReg(INA3221_regType *reg)
{
   HAL_I2C_Mem_Read(INA3321_I2C, INA3221_I2C_ADDRESS, reg->address, 1, &reg->data, 2, 0xFFFF);
   DataReverse(reg->data, &reg->data);
}
 
 
static void INA3221_WriteReg(INA3221_regType *reg)
{
   DataReverse(reg->data, &reg->data);
   HAL_I2C_Mem_Write(INA3321_I2C, INA3221_I2C_ADDRESS, reg->address, 1, &reg->data, 2, 0xFFFF);
}

寄存器表

先简单读一下芯片的ID，看看是否能正常通信

读芯片的id号，值是0x2032，但波形是3220，因此要翻转一下高低字节

代码如下

cpp 复制代码 
static void DataReverse(uint16_t raw, uint16_t* cook)
{
   *cook = ((uint8_t)(raw) << 8) | (raw >> 8);
}

读channel的bus电压值

一个位代表8mV，但寄存器里面的左移三位又刚好弥补了这一点，因此直接读到的就是电压值。

代码如下

cpp 复制代码 
static void INA3221_Sample_Volt()
{
   INA3221_ReadReg(&volt1);
   INA3221_ReadReg(&volt2);
   INA3221_ReadReg(&volt3);
}

读channel的shunt电压值

一个位代表40uV，满量程是163.8mV，因此这个用的100mΩ的模块最大采集电流为1638mA

shunt可以是负数，代表反向电流，但模块设计成IN-接PWR了，笔者就只实验了正向电流

代码如下

cpp 复制代码 
static void INA3221_Calculate_Current(uint32_t* current)
{
   current[0] = shunt1.data >> 3;
   /* 40uV per LSB */
   current[0] *= 4;
   current[0] = current[0] * 10 / SHUNT_RESISTOR;
 
 
   current[1] = shunt2.data >> 3;
 
   /* 40uV per LSB */
   current[1] *= 4;
   current[1] = current[1] * 10 / SHUNT_RESISTOR;
 
 
   current[2] = shunt3.data >> 3;
 
   /* 40uV per LSB */
   current[2] *= 4;
   current[2] = current[2] * 10 / SHUNT_RESISTOR;
}

主函数编写

cpp 复制代码 
int main(void)
{

  /* USER CODE BEGIN 1 */

  /* USER CODE END 1 */

  /* MCU Configuration--------------------------------------------------------*/

  /* Reset of all peripherals, Initializes the Flash interface and the Systick. */
  HAL_Init();

  /* USER CODE BEGIN Init */

  /* USER CODE END Init */

  /* Configure the system clock */
  SystemClock_Config();

  /* USER CODE BEGIN SysInit */

  /* USER CODE END SysInit */

  /* Initialize all configured peripherals */
  MX_GPIO_Init();
  MX_I2C2_Init();
  MX_I2C1_Init();
  /* USER CODE BEGIN 2 */
INA3221_Init();
OLED_Init();
OLED_Clear();
OLED_ShowString(0,0,"C1",16);
OLED_ShowString(0,2,"C2",16);
OLED_ShowString(0,4,"C3",16);
  /* USER CODE END 2 */

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {
    INA3221_GetVolt();
    INA3221_GetCurrent();

    sprintf(info[0], "%.2fV ", voltage[0]/1000.0f);
    sprintf(info[1], "%.2fV ", voltage[1]/1000.0f);
    sprintf(info[2], "%.2fV ", voltage[2]/1000.0f);
    OLED_ShowString(20,0,info[0],16);
    OLED_ShowString(20,2,info[1],16);
    OLED_ShowString(20,4,info[2],16);

    sprintf(info[3], "%.3fA", current[0]/1000.0f);
    sprintf(info[4], "%.3fA", current[1]/1000.0f);
    sprintf(info[5], "%.3fA", current[2]/1000.0f);
    OLED_ShowString(80,0,info[3],16);
    OLED_ShowString(80,2,info[4],16);
    OLED_ShowString(80,4,info[5],16);

    HAL_GPIO_TogglePin(LED_GPIO_Port,LED_Pin);
    HAL_Delay(100);
    /* USER CODE END WHILE */

    /* USER CODE BEGIN 3 */
  }
  /* USER CODE END 3 */
}

六、效果展示

七、驱动附录

ina3221.h

cpp 复制代码 
#ifndef INA3221_H
#define INA3221_H


#include"i2c.h"
#include "stdint.h"
#include "main.h"


typedef struct
{
	uint8_t address;
	uint16_t data;
}INA3221_regType;

typedef enum
{
	CH1,
	CH2,
	CH3,
}INA3221_SHUNTChannelType;

/**
 * prepare for mask enable register
 */
typedef struct
{
	uint8_t CF1;
	uint8_t CF2;
	uint8_t CF3;
	uint8_t WF1;
	uint8_t WF2;
	uint8_t WF3;
}INA3221_FlagType;


extern INA3221_regType dieID;
extern INA3221_regType mask_enable;

extern INA3221_regType volt1;
extern INA3221_regType shunt1;
extern INA3221_regType volt2;
extern INA3221_regType shunt2;
extern INA3221_regType volt3;
extern INA3221_regType shunt3;


extern uint32_t current[3];
extern uint16_t voltage[3];

extern INA3221_FlagType INA3221_flag;

void INA3221_Config();
void INA3221_Init();
void INA3221_Reset();
void INA3221_ReadDieID();
void INA3221_ReadmanufactID();
void INA3221_GetVolt();
void INA3221_GetCurrent();

#endif

ina3221.c

cpp 复制代码 
#include "INA3221.h"

#define INA3321_I2C &hi2c1
#define INA3221_I2C_ADDRESS 0x80

/*shunt resistor mohm*/
#define SHUNT_RESISTOR 			100

#define POWER_VALID_UPPER 		10000

#define POWER_VALID_LOWER 		9000

/**
 * register address table
 */
typedef enum
{
	SHUNT_CH1 = 0x01,
	VOLT_CH1,
	SHUNT_CH2,
	VOLT_CH2,
	SHUNT_CH3,
	VOLT_CH3,
	CRITICAL_CH1,
	WARNING_CH1,
	CRITICAL_CH2,
	WARNING_CH2,
	CRITICAL_CH3,
	WARNING_CH3,
	SHUNT_VOLT_SUM,
	SHUNT_VOLT_SUM_LIMIT,
	MASK_ENABLE,
	POWER_VALID_HIGH = 0x10,
	POWER_VALID_LOW,
}INA3221_RegAddressType;

/**
 * average samples
 */
typedef enum
{
	AVG_1,
	AVG_4,
	AVG_16,
	AVG_64,
	AVG_128,
	AVG_256,
	AVG_512,
	AVG_1024,
}INA3221_AVGType;

/**
 * average samples
 */
typedef enum
{
	CONV_TIME_140US,
	CONV_TIME_204US,
	CONV_TIME_332US,
	CONV_TIME_588US,
	CONV_TIME_1_1MS,
	CONV_TIME_2_116MS,
	CONV_TIME_4_156MS,
	CONV_TIME_8_244MS,
}INA3221_CTType;

/**
 * average samples
 */
typedef enum
{
	POWER_DOWN,
	SHUNT_SINGLE,
	BUS_SINGLE,
	SHUNT_BUS_SINGLE,
	POWER_DN,
	SHUNT_CONTINUOUS,
	BUS_CONTINUOUS,
	SHUNT_BUS_CONTINUOUS,
}INA3221_ModeType;


INA3221_regType cfg = {.address = 0};

INA3221_regType volt1 = {.address = VOLT_CH1};
INA3221_regType shunt1 = {.address = SHUNT_CH1};
INA3221_regType volt2 = {.address = VOLT_CH2};
INA3221_regType shunt2 = {.address = SHUNT_CH2};
INA3221_regType volt3 = {.address = VOLT_CH3};
INA3221_regType shunt3 = {.address = SHUNT_CH3};

INA3221_regType critical_ch1 = {.address = CRITICAL_CH1};
INA3221_regType critical_ch2 = {.address = CRITICAL_CH2};
INA3221_regType critical_ch3 = {.address = CRITICAL_CH3};
INA3221_regType warning_ch1 = {.address = WARNING_CH1};
INA3221_regType warning_ch2 = {.address = WARNING_CH2};
INA3221_regType warning_ch3 = {.address = WARNING_CH3};

INA3221_regType mask_enable = {.address = MASK_ENABLE};

INA3221_regType power_valid_upper = {.address = POWER_VALID_HIGH};
INA3221_regType power_valid_lower = {.address = POWER_VALID_LOW};

INA3221_regType manufactID = {.address = 0xFE};
INA3221_regType dieID = {.address = 0xFF};

/* store power voltage */
uint32_t current[3];
/* store power current */
uint16_t voltage[3];

INA3221_FlagType INA3221_flag;
/**
 * exchange data high and low byte for word variable
 */
static void DataReverse(uint16_t raw, uint16_t* cook);

/**
 * read register value
 */
static void INA3221_ReadReg(INA3221_regType *reg);

/**
 * write register value
 */
static void INA3221_WriteReg(INA3221_regType *reg);

/**
 * cacluate voltages from volt register value
 */
static void INA3221_Calculate_Volt(uint16_t* volt);

/**
 * cacluate currents from shunt register value
 */
static void INA3221_Calculate_Current(uint32_t* current);

/**
 * set limite value for current alert
 */
static void INA3221_SetLimit(INA3221_regType *reg, uint16_t volt);

/**
 * just read volt registers
 */
static void INA3221_Sample_Volt();

/**
 * just read shunt registers
 */
static void INA3221_Sample_Shunt();

static void DataReverse(uint16_t raw, uint16_t* cook)
{
   *cook = ((uint8_t)(raw) << 8) | (raw >> 8);
}

static void INA3221_ReadReg(INA3221_regType *reg)
{
   HAL_I2C_Mem_Read(INA3321_I2C, INA3221_I2C_ADDRESS, reg->address, 1, &reg->data, 2, 0xFFFF);
   DataReverse(reg->data, &reg->data);
}


static void INA3221_WriteReg(INA3221_regType *reg)
{
   DataReverse(reg->data, &reg->data);
   HAL_I2C_Mem_Write(INA3321_I2C, INA3221_I2C_ADDRESS, reg->address, 1, &reg->data, 2, 0xFFFF);
}


static void INA3221_Calculate_Volt(uint16_t* volt)
{
   *volt = volt1.data;
   *(volt + 1) = volt2.data;
   *(volt + 2) = volt3.data;
}

static void INA3221_Calculate_Current(uint32_t* current)
{
   current[0] = shunt1.data >> 3;
   /* 40uV per LSB */
   current[0] *= 4;
   current[0] = current[0] * 10 / SHUNT_RESISTOR;


   current[1] = shunt2.data >> 3;

   /* 40uV per LSB */
   current[1] *= 4;
   current[1] = current[1] * 10 / SHUNT_RESISTOR;


   current[2] = shunt3.data >> 3;

   /* 40uV per LSB */
   current[2] *= 4;
   current[2] = current[2] * 10 / SHUNT_RESISTOR;
}

static void INA3221_SetLimit(INA3221_regType *reg, uint16_t volt)
{
   reg->data = volt;
   INA3221_WriteReg(reg);
}

static void INA3221_Sample_Volt()
{
   INA3221_ReadReg(&volt1);
   INA3221_ReadReg(&volt2);
   INA3221_ReadReg(&volt3);
}

static void INA3221_Sample_Shunt()
{
   INA3221_ReadReg(&shunt1);
   INA3221_ReadReg(&shunt2);
   INA3221_ReadReg(&shunt3);
}

void INA3221_ReadDieID()
{
   INA3221_ReadReg(&dieID);
}

void INA3221_ReadmanufactID()
{
   INA3221_ReadReg(&manufactID);
}

void INA3221_GetVolt()
{
   INA3221_Sample_Volt();
   INA3221_Calculate_Volt(voltage);
}

void INA3221_GetCurrent()
{
   INA3221_Sample_Shunt();
   INA3221_Calculate_Current(current);
}

void INA3221_Config()
{
   /* read default register value from chip*/
   INA3221_ReadReg(&cfg);

   /* store it in config variable */
   cfg.data |= (cfg.data & !0x0E00) | (AVG_4 << 9);

   /*bus*/
   cfg.data |= (cfg.data & !0x01C0) | (CONV_TIME_2_116MS << 6);
   
   /*shunt*/
   cfg.data |= (cfg.data & !0x38) | (CONV_TIME_2_116MS << 3);

   /* wirte to register value */
   INA3221_WriteReg(&cfg);

   INA3221_ReadReg(&cfg);
}

void INA3221_Set_Critical(INA3221_SHUNTChannelType channel, uint16_t current)
{
   switch (channel)
   {
      case CH1:
      {
         /* 40uV per LSB */
         INA3221_SetLimit(&critical_ch1, (current * SHUNT_RESISTOR / 40) << 3);
         break;
      }
      case CH2:
      {
         INA3221_SetLimit(&critical_ch2, (current * SHUNT_RESISTOR / 40) << 3);
         break;
      }
      case CH3:
      {
         INA3221_SetLimit(&critical_ch3, (current * SHUNT_RESISTOR / 40) << 3);
         break;
      }
      default:
         break;
   }
}

void INA3221_Set_Warning(INA3221_SHUNTChannelType channel, uint16_t current)
{
   switch (channel)
   {
      case CH1:
      {
         INA3221_SetLimit(&warning_ch1, (current * SHUNT_RESISTOR / 40) << 3);
         break;
      }
      case CH2:
      {
         INA3221_SetLimit(&warning_ch2, (current * SHUNT_RESISTOR / 40) << 3);
         break;
      }
      case CH3:
      {
         INA3221_SetLimit(&warning_ch3, (current * SHUNT_RESISTOR / 40) << 3);
         break;
      }
      default:
         break;
   }
}

void INA3221_Reset()
{
   cfg.data = 0x8000;
   INA3221_WriteReg(&cfg);
}

void INA3221_Init()
{
   INA3221_ReadDieID();
   /* reset all registers */
   INA3221_Reset();

   INA3221_Config();
}

八、补充功能

INA3221还带可编程报警和警告输出

一、关键提示

会去比较每个通道的shunt电压值和相应的预设的值，用来判断是否发生过流

二、警告提示

会去比较每个通道的平均shunt电压值和相应的预设的值，用来判断是否发生过流

三、电源有效提示

芯片默认的PV上限是10V，下限是9V，都是可以改写的

意思是在外部高压输入的时候，如果三个通道的电压均高于10V，那么电源OK

如果电压降低，低于9V，电源不OK，模块的灯就会亮起来，因为这几个提示引脚都是开漏输出的

在外部高压输入的时候，如果有任意通道电压<10V，电源不OK，模块的灯就会亮起来，因为这几个提示引脚都是开漏输出的

如果电压升高，高于10V就可以了

有点像施密特触发器

可以把PV上拉到VPU去，这样电压就抬起来了，也可以在PV引脚和地直接串电阻来降压

模块的输入端子里有VPU，根据实际情况使用即可

四、时序控制提示

九、工程链接

STM32INA3221电压电流实时显示OLED工程资源-CSDN文库

相关推荐
网易独家音乐人Mike Zhou3 小时前
【卡尔曼滤波】数据预测Prediction观测器的理论推导及应用 C语言、Python实现（Kalman Filter）
c语言·python·单片机·物联网·算法·嵌入式·iot
zy张起灵3 小时前
48v72v-100v转12v 10A大功率转换电源方案CSM3100SK
经验分享·嵌入式硬件·硬件工程
PegasusYu6 小时前
STM32CUBEIDE FreeRTOS操作教程（九）：eventgroup事件标志组
stm32·教程·rtos·stm32cubeide·free-rtos·eventgroup·时间标志组
lantiandianzi10 小时前
基于单片机的多功能跑步机控制系统
单片机·嵌入式硬件
文弱书生65610 小时前
输出比较简介
stm32
哔哥哔特商务网10 小时前
高集成的MCU方案已成电机应用趋势？
单片机·嵌入式硬件
跟着杰哥学嵌入式10 小时前
单片机进阶硬件部分_day2_项目实践
单片机·嵌入式硬件
电子科技圈11 小时前
IAR与鸿轩科技共同推进汽车未来
科技·嵌入式硬件·mcu·汽车
东芝、铠侠总代1361006839312 小时前
浅谈TLP184小型平面光耦
单片机·嵌入式硬件·物联网·平面
lantiandianzi12 小时前
基于单片机中医药柜管理系统的设计
单片机·嵌入式硬件
热门推荐
01(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明02PyTorch机器学习实现液态神经网络03【HarmonyOS】HUAWEI DevEco Studio 下载地址汇总04玄机平台应急响应—webshell查杀05Coze扣子平台完整体验和实践（附国内和国际版对比）06Ubuntu 20.04使用Livox mid 360 测试 FAST_LIO07【目标跟踪】相机运动补偿08Unity中PICO实现 隔空取物 和 接触抓取物体09RAG 实践- Ollama+RagFlow 部署本地知识库10怎样让音频速度变慢？请跟随以下方法进行操作