Đồng hồ đo năng lượng Wi-Fi IAMMETER: Hướng dẫn tích hợp cục bộ & Giao diện mở
Đồng hồ đo năng lượng Wi-Fi IAMMETER: Hướng dẫn tích hợp cục bộ & Giao diện mở
Dành cho các nhà phát triển và nhà tích hợp hệ thống sử dụng đồng hồ đo IAMMETERkhông cóIAMMETER-Đám mây.
Công tơ điện năng Wi-Fi IAMMETER được thiết kế cho cả tích hợp trên nền tảng đám mây và cục bộ, cung cấp API mở (HTTP, MQTT, Modbus/TCP) cho phép các nhà phát triển xây dựng Hệ thống quản lý năng lượng (EMS), Hệ thống quản lý tòa nhà (BMS) hoặc nền tảng tự động hóa nhà thông minh của riêng họ.
Phần mềm IAMMETER liên tục được nâng cấp. Tài liệu này liệt kê tất cả các tính năng tích hợp cục bộ và mở được hỗ trợ bởi phần mềm mới nhất.(Liên tục cập nhật)
1) Cập nhật chương trình cơ sở
Tải phiên bản phần mềm mới nhất tại đây:
- Trang phát hành chương trình cơ sở (imeter.club): https://imeter.club/topic/11
2) Chế độ chạy (Không phải đám mây)
Chọn chế độ dựa trên cách bạn tích hợp hoặc sử dụng thiết bị.
| Cách thức | Sự mô tả | Sử dụng điển hình |
|---|---|---|
| Đám mây | Tải dữ liệu lên IAMMETER-Cloud | 🚫 Không được đề cập trong bài viết này |
| Giao thức TCP | Tải lên máy chủ của bên thứ ba thông quaTCP/TLShoặcMQTT | Máy chủ cục bộ, nhà môi giới tùy chỉnh |
| HTTP | Tải lên máy chủ của bên thứ ba thông quaHTTP/HTTPS | API REST tùy chỉnh/phần cuối web |
| MQTT | Tải dữ liệu trực tiếp lên môi giới MQTT | Chỉ có sẵn trong phần mềm mới nhất |
| Độc lập | Không tải dữ liệu lên; đồng hồ đo hoạt động như một máy chủ cục bộ phản hồi với API hoặc máy khách Modbus/TCP | Chỉ có sẵn trong phần mềm mới nhất |
Giao diện người dùng chương trình cơ sở cũ
Phần mềm mới nhấtGiao diện web
(Phần còn lại của tài liệu vẫn giữ nguyên so với phiên bản mới nhất.)
3) Tích hợp TCP / TLS / MQTT
3.1 TCP & TLS
Máy đo có thể đẩy dữ liệu trực tiếp đến điểm cuối TCP/TLS của bạn.
🔹 Cấu hình chương trình cơ sở mới
Quá trình cấu hình trong phần mềm mới nhất tương tự như các phiên bản trước.
Chế độ chạy: Giao thức TCP
Địa chỉ:
- Đối với máy chủ TCP — nhập
{tên miền}:{cổng}(ví dụ.,abc.com:12345).
- Đối với máy chủ TLS — sử dụng
tls://{tên miền}:{cổng}(ví dụ.,tls://abc.com:12345).
Khoảng thời gian tải lên:Khoảng thời gian tải lên tối thiểu là2 giây.
🔹 Cấu hình chương trình cơ sở cũ
- Hướng dẫn:Tích hợp máy chủ của bên thứ ba (TCP/TLS)
- Video:Tải dữ liệu năng lượng lên máy chủ của bên thứ ba
3.2 MQTT
🔹 Cấu hình chương trình cơ sở mới
Chế độ chạy: MQTT
Địa chỉ:Nhập IP hoặc tên miền có cổng, ví dụ:192.168.11.163:1883
Tên người dùng / Mật khẩu:Thông tin xác thực của nhà môi giới MQTT (tùy chọn nếu nhà môi giới không yêu cầu)
Khoảng thời gian tải lên:Khoảng cách tối thiểu là2 giây. Khám phá HA MQTT: Bật chức năng khám phá MQTT trong Home Assistant
🔹 Cấu hình chương trình cơ sở cũ
Xuất bản dữ liệu đo từ xa tới một nhà môi giới MQTT cục bộ hoặc công cộng.
- Hướng dẫn:Hướng dẫn tích hợp MQTT
4) Tích hợp HTTP / HTTPS
🔹 Cấu hình chương trình cơ sở cũ
Máy đo có thể đăng dữ liệu trực tiếp lên máy chủ tùy chỉnh của bạn.
- Định dạng tải dữ liệu giống hệt với chế độ TCP/MQTT.
- Có thể sử dụng bất kỳ cổng nào.
- Cảng443tự động bật HTTPS.
- Chi tiết:Tải lên qua HTTP/HTTPS
🔹 Cấu hình chương trình cơ sở mới
Địa chỉ:Định dạng đầu vào giống với phần mềm cũ.
- Nếu không có cổng nào được chỉ định, cổng mặc định là80.
- Chỉ có cổng443sử dụng HTTPS post; tất cả các cổng khác sử dụng HTTP post.
5) API cục bộ (HTTP qua LAN)
Truy cập đồng hồ đo cục bộ thông qua IP LAN — không cần kết nối đám mây.
5.1 NHẬN /api/monitorjson
Trả về dữ liệu đo lường thời gian thực.Các lĩnh vực:Điện áp, Dòng điện, Công suất hoạt động, kWh thuận/nghịch, Tần số, Hệ số công suất.
Ví dụ:
{
"phương thức": "uploadsn",
"mac": "B0F8933C4F94",
"phiên bản": "i.75.97.9",
"máy chủ": "em",
"SN": "3E0BAF87",
"Dữ liệu": [
[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]
]
}📘 Mở rộng đo công suất phản kháng
5.2 NHẬN /api/màn hình
Phiên bản nâng cao củaMàn hìnhjson, bao gồm thông tin tín hiệu Wi-Fi:
SSID(tên AP được kết nối)chữ ký(cường độ tín hiệu)
5.3 NHẬN /api/wifidata
Trả về cấu hình mạng và Wi-Fi.
{
"phiên bản": "i.75.97.9", "SN": "3E0BAF87", "mac": "B0F8933C4F94",
"loại": "PM", "ssid": "CMCC-laohe", "ip": "192.168.11.62",
"mặt nạ mạng": "255.255.255.0", "gw": "192.168.11.253",
"dns": "114.114.114.114", "dhcp": 1, "runMode": "tcp", "uploadinterval": 60
}5.4 NHẬN /api/uploadinterval?x=<giây>
Đặt khoảng thời gian tải lên (tính bằng giây).
Hoạt động ở chế độ không phải Đám mây (TCP/HTTP/MQTT).
TrongPhần mềm mới nhất, tham số này hiện có thể được cấu hình trực tiếp từGiao diện WebUI, mà không cần gọi API theo cách thủ công.
5.5 NHẬN /api/mqtt
Cấu hình thông tin xác thực MQTT. 📘Tài liệu API cấu hình MQTT
TrongPhần mềm mới nhất, tham số này hiện có thể được cấu hình trực tiếp từGiao diện WebUI, mà không cần gọi API theo cách thủ công.
5.6 NHẬN /api/netmetry
Chuyển đổiĐo lường năng lượng ròng (NEM)chế độ. 📘Bật chế độ NEM
TrongPhần mềm mới nhất, tham số này hiện có thể được cấu hình trực tiếp từGiao diện WebUI, mà không cần gọi API theo cách thủ công.
5.7 NHẬN /api/ctcratio
Điều chỉnhBộ nhân pha Ccho các tình huống pha chia tách/cân bằng.
x=2gấp đôi số liệu đo Pha C (dòng điện, công suất, kWh). 📘Giải thích về tỷ lệ CTC
TrongPhần mềm mới nhất, tham số này hiện có thể được cấu hình trực tiếp từGiao diện WebUI, mà không cần gọi API theo cách thủ công.
5.8 NHẬN /api/reactive
Bật hoặc tắtCông suất phản kháng (Q)vàNăng lượng phản ứng (kVARh)đo lường. 📘Tài liệu về công suất phản kháng
TrongPhần mềm mới nhất, tham số này hiện có thể được cấu hình trực tiếp từGiao diện WebUI, mà không cần gọi API theo cách thủ công.
5.9 NHẬN /api/ratio (chỉ có sẵn cho WEM3046T)
Kể từ khiWEM3046Tsử dụng CT bên ngoài vớiĐầu ra thứ cấp 5A(ví dụ: 1000:5, 1500:5, 2000:5, v.v.), các giá trị đo được (dòng điện, công suất, năng lượng) phải được nhân với tỷ số CT.
Ví dụ:
/api/tỷ lệ?x=400- Tỷ lệ đặt:
/api/ratio?x={ct_ratio} - Tỷ lệ truy vấn:
/api/tỷ lệ
Chỉ mộtWEM3046Thỗ trợ CT 5A bên ngoài — API này không hợp lệ với các mẫu khác.
6) Tính nhất quán của định dạng JSON
Tất cả các chế độ giao tiếp —HTTP, TCP, MQTT, API cục bộ— sử dụng cùng một cấu trúc JSON. 📘Định nghĩa dữ liệu JSON
7) Hỗ trợ Modbus/TCP
Đồng hồ đo IAMMETER hỗ trợ gốcModbus / TCP, cho phép tích hợp trực tiếp vớiTrợ lý tại nhà, PLC, hoặcSCADAhệ thống.
8) Các kịch bản tích hợp được hỗ trợ
| Hệ thống | Giao thức | Ví dụ sử dụng | Tài liệu tham khảo |
|---|---|---|---|
| Trợ lý tại nhà | HTTP / Modbus / MQTT | Bảng điều khiển & tự động hóa | Hướng dẫn |
| Node-RED | HTTP / Modbus / MQTT | Luồng tự động hóa | Hướng dẫn |
| OpenHAB / ioBroker | HTTP | Bảng thông tin cục bộ | Hội nhập |
| ZABBIX | HTTP | Bảng điều khiển giám sát | Hội nhập |
| bảng điều khiển | HTTP | Hình ảnh hóa IoT | Hội nhập |
| Máy chủ tùy chỉnh | HTTP / MQTT / TCP | Thu thập dữ liệu doanh nghiệp hoặc cục bộ | Xây dựng hệ thống của riêng bạn |
9) Tài nguyên
- Bản phát hành chương trình cơ sở
- Video hướng dẫn
- Định nghĩa JSON
- Tổng quan về Modbus/TCP
- Phát triển hệ thống của riêng bạn
10) Tóm tắt dành cho nhà phát triển
| Khả năng | Truy cập | Ghi chú |
| --------------------- | ------------------- | ---------------------------------- |
| Dữ liệu cục bộ theo thời gian thực | API cục bộ |/api/monitorjson, /api/màn hình|
| Tải lên của bên thứ ba | TCP/TLS, HTTP/HTTPS | Cùng một lược đồ tải trọng |
| Xuất bản MQTT | Môi giới MQTT |/api/mqttđể thiết lập thông tin xác thực |
| Đo lường mạng | API cục bộ |/api/netmetry|
| Công suất phản kháng/năng lượng | API cục bộ |/api/phản ứng|
| Hệ số nhân Phase-C | API cục bộ |/api/ctcratio?x=1 | | Tỷ lệ CT (WEM3046T) | API cục bộ |/api/ratio?x=` |
| Modbus/TCP | Máy khách Modbus | Tương thích với HA/PLC/SCADA |
Cập nhật lần cuối: 15 tháng 10 năm 2025
