开始之前
IAMMETER 模拟器是一个在线电表模拟器，帮助你在购买硬件之前测试电表功能。你可以体验 Local API、Modbus/TCP、HTTP/HTTPS 上传、MQTT/MQTTS 及第三方平台集成。
Home Assistant 用户可以在安装真实电表之前，先建立连接、检查实体读数，并尝试配置仪表盘和自动化。
本教程使用 WEM2067 模拟器演示 IAMMETER HTTP 接入，并使用模拟器的公共三相服务演示 Modbus/TCP 接入。截图中的配置和读数仅作为示例。
1. 打开 WEM2067 模拟器
WEM2067 是面向家庭用户的双通道电表，支持分相电网监测和单相家庭光伏监测。
在单相家庭光伏系统中，两个通道可分别测量电网购电/上网和逆变器输出端的光伏发电；在分相电网监测中，两个通道分别测量电网的两条火线。
在默认的“逆变器与电网”模拟场景中，A 通道表示逆变器发电，B 通道表示电网购电/上网。WEM2067 的 HTTP 接口提供这两个通道的数据。
2. 测试 IAMMETER HTTP 集成
通过 HACS 安装 IAMMETER HTTP，然后重启 Home Assistant。已经安装的用户请更新到支持完整 HTTP/HTTPS URL 的版本。
Home Assistant 必须能够解析 simulator.iammeter.com，并访问 HTTPS 443 或 HTTP 80 端口。本教程使用 HACS 自定义集成，不代表 HA Core 内置集成也支持自定义 URL 路径。
2.1. 添加模拟电表
在 HA 中依次打开“设置 → 设备与服务 → 添加集成”，选择 IAMMETER HTTP。
将下面的完整数据接口 URL 粘贴到支持完整 URL 的地址字段中。较新版本也接受电表页面的基础 URL，并自动追加 /monitorjson。使用完整 URL 时，独立的端口字段会被忽略；读取公共模拟器数据时，用户名和密码留空。
添加后，检查 A/B 通道的电压、电流、功率和累计电量实体是否有读数，并观察其更新。WEM2067 返回的 SN 为 ZAT3LQD9，不创建 C 通道实体。
WEM2067 HTTP 数据接口 URL
https://simulator.iammeter.com/WEM2067/monitorjson
2.2. 测试仪表盘和自动化
使用这些实体构建功率和电量仪表盘。下图只是一个示例，实际布局由你的仪表盘配置决定。
通过家庭光伏曲线，可以观察不同发电和用电条件下的读数，并检查自动化是否按预期触发。
- 向电网上网时发送测试通知。
- 用电功率超过设定值时触发提醒。
- 根据光伏发电和电网功率测试负载控制逻辑。
2.3. 切换到真实电表
接入真实电表时，使用它的本地 IP 地址和 HTTP 80 端口，或者填写完整的本地 /monitorjson URL，如下所示。修改后检查读数是否正常更新。
“重新配置”会校验设备身份。如果真实电表的 SN 不同，集成提示设备不匹配，请将真表添加为新设备，并检查仪表盘和自动化中的实体引用。仅替换地址并不保证已有实体或电量历史自动迁移。
真实电表地址示例
http://192.168.1.100/monitorjson
3. 测试 Modbus/TCP 集成
通过 HACS 安装 IAMMETER Modbus TCP，并参考仓库中的安装说明。主机字段填写域名，不要填写 HTTP URL。
公共 Modbus 服务独立于网页选择的型号，始终以 WEM3050T 身份提供完整三相寄存器：A 为逆变器，B 为电网，C 未连接且读数为零。集成要求选择型号时，请使用 Auto 或 WEM3050T。
Home Assistant 需要能够连接模拟器的原生 TCP 502 端口。连接后检查测量实体，并确认读数持续更新。
| 设置项 | 值 |
|---|---|
| 主机地址 | simulator.iammeter.com |
| 端口 | 502 |
| 型号 | Auto / WEM3050T |
3.1. 测试无功参数
兼容的集成版本除了提供电压、电流、有功功率和电量，还可提供无功功率（var 或 kvar）、感性无功电量（kvarh）及容性无功电量（kvarh）。默认感性负载场景下，容性无功电量为零属于正常结果。
在对应会话开启 Reactive 后，monitorjson 和上传 JSON 也会包含无功数据；/api/monitor 不返回这些字段。浏览器设置不会自动传递到 HA 的独立请求中，实际可用实体取决于接口、数据源和集成版本。
切换到真实电表时，将 Modbus 主机改为真表的本地 IP，核对型号和寄存器缩放，端口通常仍为 502。公共模拟器的缩放可能与单相真表不同。
4. 模拟器如何生成数据
模拟器按 24 小时家庭光伏场景生成数据，光伏发电和家庭用电随时间变化。电网功率等于家庭用电减去光伏发电，正值表示购电，负值表示上网，PF 始终非负。
将曲线与 HA 中的读数对照，检查自动化触发时机。例如，光伏发电增加时，电网功率是否从购电变为上网，对应自动化是否执行？
没有浏览器会话的公共 HTTP 读取和公共 Modbus/TCP 使用默认的“逆变器与电网”数据源。你在浏览器中选择的数据源不会自动改变 HA 使用的数据源。
5. 其他测试
也可以通过 MQTT 测试 Home Assistant：在模拟器 Settings 中配置一个模拟器后端能够访问的 Broker，并让 HA 连接到同一个 Broker。公网模拟器服务器无法直接连接仅在家庭局域网内开放的 Broker。
WEM2067 的主题为 device/ZAT3LQD9/realtime。默认情况下，页面无活动 5 分钟后停止上传；测试期间请保持模拟器页面活跃。
下面的 MQTT Discovery 文章介绍的是真实 IAMMETER 电表。目前模拟器只发布测量 JSON，不发布 Home Assistant MQTT Discovery 配置消息。测试模拟器时请使用手动 MQTT 传感器配置。