IAMMETER Wi-Fi 电能表：本地集成与开放接口指南

IAMMETER Wi-Fi 电能表：本地集成与开放接口指南

面向使用 IAMMETER 电能表进行本地访问、开放 API 或自托管系统的开发者、创客和系统集成商。 IAMMETER Wi-Fi 电能表专为云端监控和本地/开放集成而设计。 它们提供多种开放接口——包括 HTTP API、MQTT、Modbus/TCP、TCP/TLS 以及独立的本地访问——使开发者能够构建自己的：

• 能源管理系统（EMS）
• 楼宇管理系统（BMS）
• 智能家居自动化系统
• 自托管仪表盘和分析平台 这使得 IAMMETER 不仅是一个云连接的电能表。 它还可以作为自定义监控和自动化工作流的开放数据源。

🔎 正在寻找基于这些开放接口构建的完整解决方案？
IAMMETER 的本地 API 和集成选项可用于：
👉 家庭能源监控
👉 太阳能监控
👉 能源成本优化 IAMMETER 固件持续升级。 本文档列出了最新固件支持的本地和开放集成主要功能。（持续更新）

1) 固件更新

在此获取最新固件版本：

• 固件发布页面（imeter.club）：https://imeter.club/topic/11

2) 运行模式（非云端）

根据集成或使用设备的方式选择模式。

旧版固件界面

最新固件 WebUI

为什么这些开放接口很重要

许多用户不希望仅依赖托管的云平台。 有了 IAMMETER 的开放接口，您可以：

• 将所有数据保留在局域网内
• 将遥测数据上传到您自己的服务器
• 与 Home Assistant 或 Node-RED 集成
• 构建自定义仪表盘和自动化逻辑
• 结合电价、太阳能或负载控制逻辑分析能源数据 当您的目标不仅仅是监控，还包括：
• 降低电费
• 提高太阳能自用率
• 构建更智能的家庭能源系统 时，这一点尤其有用。

💡 如果您的目标是将能源数据转化为实际节省，
您可能还想了解：
👉 能源成本优化

3) TCP / TLS / MQTT 集成

3.1 TCP & TLS

电能表可以直接将数据推送到您的 TCP/TLS 端点。

🔹 新固件配置

最新固件中的配置过程与之前版本类似。 运行模式：tcp 地址：

• 对于 TCP 服务器——输入 {domain}:{port}（例如 abc.com:12345）
• 对于 TLS 服务器——使用 tls://{domain}:{port}（例如 tls://abc.com:12345） **上传间隔：**最小上传间隔为 2 秒。

🔹 旧版固件配置

• 指南：第三方服务器集成（TCP/TLS）
• 视频：将能源数据上传到第三方服务器

3.2 MQTT

🔹 新固件配置

运行模式：mqtt
**地址：**输入 IP 或域名及端口，例如 192.168.11.163:1883
**用户名/密码：**MQTT 代理凭据（如果代理不需要则可选） **上传间隔：**最小间隔为 2 秒。
HA MQTT 发现：在 Home Assistant 中启用 MQTT 发现

🔹 旧版固件配置

将遥测数据发布到本地或公共 MQTT 代理。

• 指南：MQTT 集成指南

4) HTTP / HTTPS 集成

🔹 旧版固件配置

电能表可以直接将数据发送到您的自定义服务器。

• 数据载荷格式与 TCP/MQTT 模式相同
• 可以使用任何端口
• 端口 443 自动启用 HTTPS
• 详情：通过 HTTP/HTTPS 上传

🔹 新版固件配置

**地址：**输入格式与旧版固件相同。

• 如果未指定端口，默认端口为 80
• 仅端口 443 使用 HTTPS 发送；所有其他端口使用 HTTP 发送

5) 本地 API（局域网 HTTP）

通过局域网 IP 在本地访问电能表——无需云连接。

5.1 GET /api/monitorjson

返回实时测量数据。
**字段：**电压、电流、有功功率、正向/反向 kWh、频率、功率因数。 示例：

{
  "method": "uploadsn",
  "mac": "B0F8933C4F94",
  "version": "i.75.97.9",
  "server": "em",
  "SN": "3E0BAF87",
  "Datas": [
    [220.0, 9.99, 2198, 11.337, 11.201, 49.99, 1.00],
    [222.5, 9.99, 1100, 11.039, 10.908, 49.99, 0.50],
    [263.5, 9.99, 1213, 10.975, 10.846, 49.99, 0.55]
  ]
}

📘 无功功率测量扩展

5.2 GET /api/monitor

monitorjson 的进阶版本，包含 Wi-Fi 信号信息：

• ssid — 连接的 AP 名称
• sig — 信号强度

5.3 GET /api/wifidata

返回 Wi-Fi 和网络配置。

{
  "version":"i.75.97.9",
  "SN":"3E0BAF87",
  "mac":"B0F8933C4F94",
  "type":"PM",
  "ssid":"CMCC-laohe",
  "ip":"192.168.11.62",
  "netmask":"255.255.255.0",
  "gw":"192.168.11.253",
  "dns":"114.114.114.114",
  "dhcp":1,
  "runMode":"tcp",
  "uploadinterval":60
}

5.4 GET /api/uploadinterval?x=<seconds>

设置上传间隔（秒）。

在非云端模式（TCP/HTTP/MQTT）下生效。 在最新固件中，该参数现在可以直接从 WebUI 界面配置，无需手动调用 API。

5.5 GET /api/mqtt

配置 MQTT 凭据。 📘 MQTT 配置 API 文档 在最新固件中，该参数现在可以直接从 WebUI 界面配置，无需手动调用 API。

5.6 GET /api/netmetring

切换**净能量计量（NEM）**模式。 📘 启用 NEM 模式 在最新固件中，该参数现在可以直接从 WebUI 界面配置，无需手动调用 API。

5.7 GET /api/ctcratio

调整C 相倍率，用于分相或平衡场景。

• x=2 将 C 相读数（电流、功率、kWh）加倍 📘 CTC Ratio 说明 在最新固件中，该参数现在可以直接从 WebUI 界面配置，无需手动调用 API。

5.8 GET /api/reactive

启用或禁用**无功功率（Q）和无功电能（kVARh）**测量。 📘 无功功率文档 在最新固件中，该参数现在可以直接从 WebUI 界面配置，无需手动调用 API。

5.9 GET /api/ratio （仅适用于 WEM3046T）

由于 WEM3046T 使用二次侧输出为 5A 的外部 CT，测量值必须乘以 CT 变比。 示例：

/api/ratio?x=400

• 设置变比：/api/ratio?x={ct_ratio}
• 查询变比：/api/ratio 仅 WEM3046T 支持外部 5A CT——此 API 对其他型号无效。

6) JSON 格式一致性

所有通信模式——HTTP、TCP、MQTT、本地 API——使用相同的 JSON 结构。 📘 JSON 数据定义 这种一致性使得在多个系统之间构建自定义集成、仪表盘和自动化逻辑变得更加容易。

7) Modbus/TCP 支持

IAMMETER 电能表原生支持 Modbus/TCP，可直接与以下系统集成：

• Home Assistant
• PLC
• SCADA 系统
• Modbus/TCP 概述
• Home Assistants Modbus 示例

8) 支持的集成场景

| 系统 | 协议 | 示例用途 | 参考文档 | | ---------------------- | ------------------------ | ------------------------ | ------------------------------------------------------------ | | Home Assistant | HTTP / Modbus / MQTT | 仪表盘与自动化 | 指南 | | Node-RED | HTTP / Modbus / MQTT | 自动化流程 | 指南 | | OpenHAB / ioBroker | HTTP | 本地仪表盘 | 集成 | | Zabbix | HTTP | 监控仪表盘 | 集成 | | ThingsBoard | HTTP | IoT 可视化 | 集成 | | 自定义服务器 | HTTP / MQTT / TCP | 企业或本地数据采集 | 构建自己的系统 |

9) 资源

• 固件发布
• 视频教程
• JSON 定义
• Modbus/TCP 概述
• 开发自己的系统

10) 开发者摘要

| 功能 | 访问方式 | 说明 | | ---------------------- | ---------------- | ------------------------------------- | | 实时本地数据 | 本地 API | /api/monitorjson、/api/monitor | | 第三方上传 | TCP/TLS、HTTP/HTTPS | 相同的数据载荷结构 | | MQTT 推送 | MQTT 代理 | 通过 /api/mqtt 设置凭据 | | 净计量 | 本地 API | /api/netmetring | | 无功功率/无功电能 | 本地 API | /api/reactive | | C 相倍率 | 本地 API | /api/ctcratio?x=1 | | CT 变比（WEM3046T） | 本地 API | /api/ratio?x={ct_ratio} | | Modbus/TCP | Modbus 客户端 | 兼容 HA / PLC / SCADA |

从监控开始，构建自己的系统

IAMMETER 的本地 API 和开放协议让您能够轻松地从简单监控起步，逐步演进到更高级的自定义 EMS 或自动化平台。 如果您正在寻找基于这些功能的实用终端用户解决方案，请从这里开始：

• 👉 家庭能源监控
• 👉 太阳能监控
• 👉 能源成本优化

最后更新：2026 年 3 月 19 日