Unit INA226 10A/1A Home Assistant 集成

本教程将介绍如何使用 Unit INA226 10A/1A 直流电参数测量单元搭配 AtomS3R 主控，并将其集成到 Home Assistant 中，实现对直流电压、电流、功率的实时监测。

准备工作

硬件清单

1 x Unit INA226 10A / Unit INA226 1A
1 x AtomS3R
1 x HY2.0-4P Grove 连接线 (20cm)
1 x Home Assistant 主机（服务器、迷你电脑、NAS 等）

软件与版本

Home Assistant 2026.2.0 及以上
ESPHome Device Builder 2026.2.2 及以上

创建设备

打开 ESPHome Dashboard，若出现初始引导界面，点击 CONTINUE。

点击右下角的绿色 + 按钮，开始创建新设备。

点击 New Device Setup，进入设备创建向导。

输入设备名称，点击 NEXT。

选择设备类型，点击 ESP32S3。

点击 SKIP，跳过加密密钥设置。

点击 EDIT，进入 YAML 配置页面，自定义设备功能。

修改配置

I2C 总线配置

添加 I2C 组件，配置 Unit INA226 10A/1A 与 AtomS3R 之间的通信引脚。

i2c:
  sda: GPIO2
  scl: GPIO1
  scan: true 

说明

AtomS3R 的 PORT.A 接口对应 SDA: GPIO2，SCL: GPIO1。若使用其他端口，请根据实际引脚进行调整。

传感器配置

添加 Sensor 组件，启用 INA226 传感器实体。

sensor:
  - platform: ina226
    address: 0x41
    # 10A
    shunt_resistance: 0.08 ohm
    # 1A
    # shunt_resistance: 0.005 ohm
    adc_time:
      voltage: 140us
      current: 332us
    adc_averaging: 4
    update_interval: 2s
    current:
      name: "Current"
      accuracy_decimals: 4
    shunt_voltage:
      name: "Shunt_Voltage"
      accuracy_decimals: 5
    bus_voltage:
      name: "Bus_Voltage"
      accuracy_decimals: 4
    power:
      name: "Power"
      accuracy_decimals: 4 

主要参数说明：

参数	值	说明
`address`	0x41	Unit INA226 10A/1A 的 I2C 地址。
`shunt_resistance`	0.08 ohm / 0.005 ohm	10A 使用 0.08，1A 使用 0.005 的分流电阻。
`adc_time`	140us / 332us	ADC 转换时间，电压和电流可分别设置。
`update_interval`	2s	向 Home Assistant 更新测量数值的时间间隔。
`current`	Current	报告直流电流，单位为安培（A）。
`shunt_voltage`	Shunt Voltage	报告分流电压，单位为伏特（V）。
`bus_voltage`	Bus Voltage	报告总线电压，单位为伏特（V）。
`power`	Power	报告功率，单位为瓦特（W）。