Unit AC Measure Home Assistant 集成

本教程将介绍如何使用 Unit AC Measure 交流电参数测量单元搭配 AtomS3R 主控，并将其集成到 Home Assistant 中，实现对交流电压、电流、有功功率和能耗的实时监测。

准备工作

硬件清单

1 x Unit AC Measure
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 配置页面，自定义设备功能。

修改配置

外部组件配置

在 YAML 文件中添加 External Components 配置，加载 unit_acmeasure 传感器驱动。

external_components:
  - source: github://m5stack/esphome-yaml/components
    components: unit_acmeasure
    refresh: 0s 

I2C 总线配置

添加 I2C 组件，配置 Unit AC Measure 与 AtomS3R 之间的通信引脚。

i2c:
  sda: GPIO2
  scl: GPIO1
  scan: true 

说明

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

传感器配置

添加 Sensor 组件，启用 AC 测量相关的传感器实体。

sensor:
  - platform: unit_acmeasure
    id: acmeasure1
    address: 0x42
    update_interval: 2s
    voltage:
      name: AC Voltage
    current:
      name: AC Current
    power:
      name: Active Power
    apparent_power:
      name: Apparent Power
    power_factor:
      name: Power Factor
    energy:
      name: Energy 

主要参数说明：

参数	值	说明
`address`	0x42	Unit AC Measure 的 I2C 地址。
`update_interval`	2s	向 Home Assistant 更新 AC 测量数值的时间间隔。
`voltage`	AC Voltage	报告被测回路的交流电压（RMS）。
`current`	AC Current	报告交流电流（RMS）。
`power`	Active Power	报告有功功率（瓦）。
`apparent_power`	Apparent Power	报告视在功率（伏安，VA）。
`power_factor`	Power Factor	报告功率因数（有功功率与视在功率之比）。
`energy`	Energy	报告累计用电量。