IAMMETER Wi-Fi エネルギーメーター: ローカル統合とオープンインターフェースガイド
IAMMETER Wi-Fi エネルギーメーター: ローカル統合とオープンインターフェースガイド
IAMMETERメーターを使用する開発者およびシステムインテグレーター向けそれなしIAMMETER-クラウド。
IAMMETER Wi-Fi エネルギー メーターは、クラウドベースとローカルの両方の統合に対応するように設計されており、開発者が独自のエネルギー管理システム (EMS)、ビル管理システム (BMS)、またはスマート ホーム オートメーション プラットフォームを構築できるようにするオープン API (HTTP、MQTT、Modbus/TCP) を提供します。
IAMMETERファームウェアは継続的にアップグレードされます。 このドキュメントでは、最新のファームウェアでサポートされているすべてのローカルおよびオープン統合機能をリストします。（継続的に更新されます）
1) ファームウェアのアップデート
最新のファームウェアリリースはここから入手できます:
- ファームウェアリリースページ (imeter.club): https://imeter.club/topic/11
2) 実行モード（非クラウド）
デバイスの統合方法または使用方法に基づいてモードを選択します。
| モード | 説明 | 一般的な用途 |
|---|---|---|
| クラウド | IAMMETERクラウドにデータをアップロードする | 🚫 この記事で取り上げていない |
| TCP | サードパーティのサーバーにアップロードするにはTCP/TLSまたMQTT | ローカルサーバー、カスタムブローカー |
| HTTP | サードパーティのサーバーにアップロードするにはHTTP/HTTPS | カスタムREST API/Webバックエンド |
| MQTT | MQTTブローカーにデータを直接アップロードする | 最新のファームウェアでのみ利用可能 |
| スタンドアロン | データのアップロードは不要。メーターはAPIまたはModbus/TCPクライアントに応答するローカルサーバーとして機能します。 | 最新のファームウェアでのみ利用可能 |
レガシーファームウェアUI
最新のファームウェアウェブUI
(ドキュメントの残りの部分は、最新バージョンから変更されずに継続されます。)
3) TCP / TLS / MQTT統合
3.1 TCPとTLS
メーターはデータを TCP/TLS エンドポイントに直接プッシュできます。
🔹 新しいファームウェア構成
最新のファームウェアでの設定プロセスは、以前のバージョンと同様です。
実行モード: TCP
住所：
- TCPサーバーの場合 - 入力
{ドメイン}:{ポート}（例えば。、abc.com:12345).
- TLSサーバーの場合 — 使用
tls://{ドメイン}:{ポート}（例えば。、tls://abc.com:12345).
アップロード間隔:最小アップロード間隔は2秒.
🔹 レガシーファームウェア構成
3.2 MQTT
🔹 新しいファームウェア構成
実行モード: MQTT
住所：IPまたはドメインとポートを入力します。例:192.168.11.163:1883
ユーザー名/パスワード:MQTT ブローカーの資格情報 (ブローカーで必要とされない場合はオプション)
アップロード間隔:最小間隔は2秒. HA MQTT 検出: Home AssistantでMQTT検出を有効にする
🔹 レガシーファームウェア構成
テレメトリをローカルまたはパブリック MQTT ブローカーに公開します。
- ガイド：MQTT 統合ガイド
4) HTTP / HTTPS統合
🔹 レガシーファームウェア構成
メーターはデータをカスタム サーバーに直接送信できます。
- データ ペイロード形式は TCP/MQTT モードと同じです。
- どのポートでも使用できます。
- ポート443HTTPS を自動的に有効にします。
- 詳細：HTTP/HTTPS経由でアップロード
🔹 新しいファームウェア構成
住所：入力形式は従来のファームウェアと同じです。
- ポートが指定されていない場合、デフォルトのポートは80.
- ポートのみ443HTTPS ポストを使用します。その他のすべてのポートは HTTP ポストを使用します。
5) ローカル API (LAN 経由の HTTP)
メーターには LAN IP 経由でローカルにアクセスします。クラウド接続は必要ありません。
5.1 /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
の上級バージョンMonitorjsonWi-Fi信号情報が含まれます:
SSID（接続AP名）署名（信号強度）
5.3 /api/wifidata を取得する
Wi-Fi とネットワーク構成を返します。
{
「バージョン」:「i.75.97.9」、「SN」:「3E0BAF87」、「mac」:「B0F8933C4F94」、「タイプ」:「PM」、「SSID」:「CMCC-laohe」、「IP」:「192.168.11.62」、「ネットマスク」:「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=<秒>
アップロード間隔（秒単位）を設定します。
非クラウド モード (TCP/HTTP/MQTT) で動作します。
の中で最新のファームウェアこのパラメータは、WebUIインターフェースAPI を手動で呼び出す必要はありません。
5.5 /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）が 2 倍になります。 📘CTC比率の説明
の中で最新のファームウェアこのパラメータは、WebUIインターフェースAPI を手動で呼び出す必要はありません。
5.8 GET /api/reactive
有効または無効にする無効電力（Q）と無効エネルギー（kVARh）測定。 📘無効電力ドキュメント
の中で最新のファームウェアこのパラメータは、WebUIインターフェースAPI を手動で呼び出す必要はありません。
5.9 /api/ratio を取得する （WEM3046Tのみ対応）
以来、WEM3046T外部CTを使用する5Aセカンダリ出力（例：1000:5、1500:5、2000:5など） 測定値（電流、電力、エネルギー）にCT比を掛ける必要があります。
例：
/api/ratio?x=400- 設定比率:
/api/ratio?x={ct_ratio} - クエリ比率:
/api/比率
のみWEM3046T外部 5A CT をサポートします。この API は他のモデルでは無効です。
6) JSON形式の一貫性
すべての通信モード —HTTP、TCP、MQTT、ローカルAPI— 同じ JSON 構造を使用します。 📘JSONデータ定義
7) Modbus/TCP サポート
IAMMETERメーターはネイティブサポートModbus/TCPと直接統合できるホームアシスタント, PLC、 またはSCADAシステム。
8) サポートされている統合シナリオ
| システム | プロトコル | 使用例 | リファレンス |
|---|---|---|---|
| ホームアシスタント | HTTP / モドバス / MQTT | ダッシュボードと自動化 | ガイド |
| Node-RED | HTTP / モドバス / MQTT | 自動化フロー | ガイド |
| OpenHAB / ioBroker | HTTP | ローカルダッシュボード | 統合 |
| ザビックス | HTTP | 監視ダッシュボード | 統合 |
| シングスボード | HTTP | IoTの可視化 | 統合 |
| カスタムサーバー | HTTP / MQTT / TCP | エンタープライズまたはローカルデータの取り込み | 独自のシステムを構築する |
9) リソース
10) 開発者概要
| 機能 | アクセス | 注記 |
| --------------------- | ------------------- | ---------------------------------- |
| リアルタイム ローカル データ | ローカル API |/api/monitorjson, /api/モニター|
| サードパーティアップロード | TCP/TLS、HTTP/HTTPS | 同じペイロードスキーマ |
| MQTT パブリッシュ | MQTT ブローカー |/api/mqtt資格情報を設定する |
| ネットメータリング | ローカル API |/api/ネットメトリング|
| 無効電力/エネルギー | ローカル API |/api/リアクティブ|
| Phase-C 乗算器 | ローカル API |/api/ctcratio?x=1 | | CT 比 (WEM3046T) | ローカル API |/api/ratio?x=` |
| Modbus/TCP | Modbus クライアント | HA/PLC/SCADA と互換性あり |
最終更新日: 2025年10月15日
