抱歉,你的浏览器不支持 JavaScript!
登录

HOME ASSISTANT · 集成指南

Home Assistant 电能表集成:MQTT、Modbus TCP 与 IAMMETER-Link

IAMMETER 电能表可通过本地 HTTP、Modbus TCP 或 MQTT 与 Home Assistant 集成。最佳方法取决于您偏好官方集成、基于 UI 的设置、快速本地更新、MQTT 自动发现,还是继续使用 IAMMETER Cloud。

本指南比较可用的方法,并引导您前往相应的设置指南。它涵盖所有当前 IAMMETER 电能表。已停产的 WEM3162 不在其中。

本页内容

我应该使用哪种 Home Assistant 集成?

方法 电表侧设置 Home Assistant 设置 典型更新间隔 完全本地 同时使用 IAMMETER Cloud 自动发现 最适合
Home Assistant Core 保持电表在局域网中可访问 在 YAML 中添加内置 IAMMETER 集成 30 秒 是 是 否 偏好官方内置集成的用户
Home Assistant Modbus 使 Modbus TCP 在局域网中可用 在 YAML 中配置内置 Modbus 集成和传感器 可配置;通常为 1–5 秒 是 是 否 快速监测和实时自动化
手动 MQTT 在电表 WebUI 中配置 MQTT 代理 启用 MQTT 集成并在 YAML 中定义传感器 可配置;最新固件支持低至 2 秒 是,使用本地代理 否 否 需要自定义主题和传感器的用户
HACS HTTP 保持电表在局域网中可访问 通过 HACS 安装 IAMMETER HTTP 并在 UI 中配置 60 秒 是 是 SSDP 辅助 无需 YAML 的 UI 设置
HACS Modbus 使 Modbus TCP 在局域网中可用 通过 HACS 安装 IAMMETER Modbus 并在 UI 中配置 可配置;默认 3 秒 是 是 SSDP 辅助 通过 UI 配置实现快速本地更新
MQTT 发现 在电表 WebUI 中配置代理并启用 HA MQTT 发现 启用 MQTT 集成;传感器将自动创建 可配置;最新固件支持低至 2 秒 是,使用本地代理 否 是 最简单的 MQTT 设置

快速建议:

  • 如果您想要官方内置集成,并且 30 秒的更新间隔足够,请选择 Home Assistant Core。
  • 如果您偏好 UI 配置且不需要快速更新,请选择 HACS HTTP。
  • 如果您希望使用 UI 配置,同时为仪表板和自动化获得更快的本地数据,请选择 HACS Modbus。
  • 如果您熟悉 YAML,并希望完全控制寄存器、传感器和轮询间隔,请选择 Home Assistant Modbus。
  • 如果您已使用 MQTT,并希望 Home Assistant 自动创建设备和实体,请选择 MQTT 发现。
  • 如果您需要完全控制 MQTT 主题、模板和实体定义,请选择 手动 MQTT。

手动 MQTT 和 MQTT 发现会将电表的上传模式更改为 MQTT。在这些模式下,电表不会同时将测量数据上传到 IAMMETER Cloud。当电表上传到 IAMMETER Cloud 时,本地 HTTP 和 Modbus TCP 集成可以继续工作。

1. 官方 Home Assistant Core 集成

官方 IAMMETER 集成包含在 Home Assistant 中,并读取电表的本地 HTTP API。它不需要 HACS,也不需要 Home Assistant 与电表之间的互联网连接。

主要特性:

  • 在 configuration.yaml 中配置;
  • 每 30 秒进行本地 HTTP 轮询;
  • 可与 IAMMETER Cloud 一起使用;
  • 导入和导出能源实体包含 Home Assistant 能源仪表板所需的元数据;
  • 无自动设备发现。

当稳定性和官方 Home Assistant 支持比快速刷新率更重要时,请使用此方法。

2. Home Assistant Modbus TCP 集成

Home Assistant 内置的 Modbus 集成读取电表的本地 Modbus TCP 寄存器。它适用于基于功率的自动化、太阳能余量控制以及其他需要更快更新的应用。

主要特性:

  • 在 YAML 中配置;
  • 可配置的 scan_interval,对于实时自动化通常为 1–5 秒;
  • 完全本地,不依赖互联网;
  • 可与 IAMMETER Cloud 一起使用;
  • 需要正确的寄存器地址、数据类型、缩放比例和能源仪表板元数据。

当不需要秒级数据时,请使用更长的轮询间隔。避免对同一电表运行多个高频 Modbus 客户端。

3. HACS HTTP 集成

IAMMETER HTTP 自定义集成提供了官方 YAML 集成的基于 UI 的替代方案。它通过本地网络读取 /monitorjson,并创建相应的 Home Assistant 实体。

主要特性:

  • 通过 HACS 安装;
  • 通过 Home Assistant 的设备与服务 UI 配置;
  • 每 60 秒进行本地 HTTP 轮询;
  • SSDP 可辅助设备发现;
  • 兼容 IAMMETER Cloud 和能源仪表板。

当您偏好 UI 配置且一分钟刷新间隔足够时,请使用此方法。

4. HACS Modbus 集成

IAMMETER Modbus 自定义集成将本地 Modbus TCP 轮询与 Home Assistant UI 配置相结合。对于需要更快更新但不想在 YAML 中定义每个寄存器的用户来说,它是最方便的选项。

主要特性:

  • 通过 HACS 安装并在 UI 中配置;

  • 可配置扫描间隔,更新版集成中默认 3 秒;

  • 本地运行并兼容 IAMMETER Cloud;

  • 创建功率以及导入/导出能源实体,并带有适当的 Home Assistant 元数据;

  • 支持所有当前 IAMMETER 电表,单相和三相型号的实体数量不同。

  • IAMMETER HACS Modbus 集成

  • HACS Modbus 设置指南

5. 手动 MQTT 集成

在手动 MQTT 模式下,电表将测量数据发布到您的 MQTT 代理,您在 Home Assistant 中定义相应的传感器。

电表侧配置和 Home Assistant 配置是分开的:

  1. 在电表的最新 WebUI 中配置代理地址、端口、用户名和密码。
  2. 在 Home Assistant 中启用 MQTT 集成。
  3. 在 YAML 中定义所需的 MQTT 传感器和 JSON 模板。

当多个应用需要订阅相同的测量数据,或者您需要自定义主题和实体定义时,此方法很有用。

6. Home Assistant MQTT 发现

MQTT 发现面向希望尽可能减少手动配置的用户。在电表 WebUI 中配置代理并启用 HA MQTT 发现后,Home Assistant 会自动创建 IAMMETER 设备及其实体。

生成的导入和导出能源实体包括:

  • unit_of_measurement: kWh;
  • device_class: energy;
  • state_class: total_increasing.

这些属性提供在 Home Assistant 能源仪表板中使用所需的元数据。

所有当前 IAMMETER 电能表均支持 MQTT 发现。单相和三相型号会根据其测量通道创建不同数量的实体。

支持的 IAMMETER 电能表

所有当前 IAMMETER 电能表均支持上述集成方法。在 Home Assistant 中的主要区别是相数或测量通道数,因此也是所创建实体的数量。

型号 典型应用 Home Assistant 支持 重要说明
WEM3080 单相能源监测 所有方法 单相实体
WEM2067 单相家庭太阳能监测 所有方法 两个测量通道
WEM3080T 三相能源监测 所有方法 三相实体
WEM3050T 三相或分相家庭监测 所有方法 三个测量通道
WEM3080TD 三相/三线及特殊接线应用 所有方法 实体解释取决于接线模式
WEM3046T / WEM3046TE 使用外部 5 A CT 的三相计量 所有方法 应用外部 CT 变比以获得一次侧值

WEM3046T 和 WEM3046TE 测量外部电流互感器的 5 A 二次输出。应用 CT 变比是这种计量配置的要求,而不是 Home Assistant 兼容性限制。

在能源仪表板中使用 IAMMETER 能源实体

Home Assistant 的能源仪表板需要以 kWh 为单位的累计导入和导出能源实体,通常具有:

  • device_class: energy;
  • state_class: total_increasing.

当前的 Core、HACS HTTP、HACS Modbus 和 MQTT 发现集成会为其导入/导出能源实体提供所需的元数据。使用手动 Modbus 或手动 MQTT 配置时,您必须自行添加正确的单位、设备类别和状态类别。

不要使用以瓦特为单位的瞬时功率实体来替代以 kWh 为单位的累计能源实体。

将现有 Home Assistant 能源数据发送到 IAMMETER Cloud

上述方法将 IAMMETER 电表数据带入 Home Assistant。IAMMETER-Link 的工作方向相反:它将 Home Assistant 中已存在的能源实体上传到 IAMMETER 虚拟电表和 IAMMETER Cloud。

当逆变器或第三方电表已有 Home Assistant 集成,但您还想要 IAMMETER Cloud 仪表板、报告或多站点访问时,这很有用。

IAMMETER-Link 目前提供:

Home Assistant 能源监测示例

电表集成后,其实时功率和累计能源数据可用于:

需要帮助?

如果您对固件、实体配置、能源仪表板设置或选择集成方法有疑问,请访问 IAMMETER 社区论坛。

顶部