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 电表,单相和三相型号的实体数量不同。
5. 手动 MQTT 集成
在手动 MQTT 模式下,电表将测量数据发布到您的 MQTT 代理,您在 Home Assistant 中定义相应的传感器。
电表侧配置和 Home Assistant 配置是分开的:
- 在电表的最新 WebUI 中配置代理地址、端口、用户名和密码。
- 在 Home Assistant 中启用 MQTT 集成。
- 在 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 目前提供:
HACS 和基于 UI 的配置;
单相和三相虚拟电表映射;
使用 IAMMETER Basic 时为 300 秒上传间隔;
使用 IAMMETER Pro 时为 60 秒上传间隔。
Home Assistant 能源监测示例
电表集成后,其实时功率和累计能源数据可用于:
- 太阳能发电、家庭用电以及电网导入/导出监测;
- 使用 Modbus TCP 的实时继电器控制;
- Home Assistant 和 Grafana 仪表板;
- 太阳能余量电动汽车充电;
- 太阳能余量水加热。
需要帮助?
如果您对固件、实体配置、能源仪表板设置或选择集成方法有疑问,请访问 IAMMETER 社区论坛。