pdf-icon

Atom Socket Home Assistant 集成

简介

Atom Socket 是一款与 ATOM 控制器兼容的智能电源插座。它集成了 HLW8032 高精度能量计量芯片,可以通过串行通信测量电压、电流、功率和功率因数。该插座遵循日本标准,包括一个单通道继电器(AC 100–120V,10A)用于电源控制。与 Wi-Fi–enabled ATOM 控制器配对时,它支持远程控制和能源监控。板载 HY2.0-4P 接口允许与外部设备交互,例如继电器信号输入和按钮信号输出。

准备工作

  • Home Assistant 主机
  • 在 Home Assistant 中安装并启用 ESPHome Builder
提示
本教程使用 ESPHome 2025.12.5 编译和上传固件。如果遇到编译/上传问题,请考虑切换 ESPHome 版本。

步骤 1. 创建新设备

  • 点击右下角的绿色按钮创建设备。

步骤 2. 创建设备名称

  • 点击 CONTINUE

  • 点击 New Device Setup

  • 输入设备名称,然后点击 NEXT

步骤 3. 选择设备类型

  • 点击 ESP32

  • 点击 SKIP

步骤 4. 开始编辑 YAML 文件

  • 点击 EDIT。我们可以通过 YAML 文件自定义设备功能。

设备设置

以下是代码的核心部分。下面提供了相关的参考和说明。

传感器配置

  • 添加 传感器 组件

  • 主要芯片模块是 HLW8032 能量计量芯片,负责收集和读取电压、电流和功率等传感器数据。

sensor:
  - platform: hlw8032
    voltage:
      name: HLW8032 Voltage
      id: hlw8032_voltage
    current:
      name: HLW8032 Current
      id: hlw8032_current
    power:
      name: HLW8032 Power
      id: hlw8032_power
    apparent_power:
      name: HLW8032 Apparent Power
      id: hlw8032_apparent_power
    power_factor:
      name: HLW8032 Power Factor
      id: hlw8032_power_factor

开关配置

switch:
  - platform: gpio
    name: "Atom Socket"
    pin:
      number: GPIO23
      inverted: False
    restore_mode: ALWAYS_ON

固件编译

  • 再次点击 INSTALL 来刷新固件,并等待其完成。

  • 进行更改后,点击右上角的 SAVEINSTALL,然后在弹出窗口中选择 Manual Download

  • 固件编译完成后,点击下载并选择 Factory format(Previously Modern)

提示
点击 Atom Socket 查看完整的示例配置。第一次编译可能需要一段时间,具体取决于 Home Assistant 主机的性能和网络质量。

固件上传

  • 通过 USB Type-C 数据线将设备连接到您的主机。打开 ESPHome Web 并点击 CONNECT 以连接到设备。

  • 找到对应的串行端口号

  • 点击 INSTALL

  • 选择之前编译的固件进行上传。

提示
请注意,下载完成后,必须重置设备。

Home Assistant 集成

  • 点击 设置 -> 设备和服务 检查设备。

  • 我们可以在 发现 部分找到相应的设备。

  • 添加设备后,数据将正确显示。

  • 最后,我们将这些实体添加到仪表板,下面显示它们的显示结果。

提示
仅当继电器开关打开时,HLW8032 视在功率HLW8032 功率 才会显示数据。
On This Page