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 | メーターを LAN 上でアクセス可能に保つ | 組み込みの IAMMETER 統合を YAML で追加する | 30 秒 | はい | はい | いいえ | 公式の組み込み統合を好むユーザー |
| Home Assistant Modbus | Modbus TCP を LAN 上で利用可能にする | 組み込み Modbus 統合とセンサーを YAML で設定する | 設定可能。通常 1~5 秒 | はい | はい | いいえ | 高速監視とリアルタイム自動化 |
| MQTT 手動 | メーターの WebUI で MQTT ブローカーを設定する | MQTT 統合を有効にし、センサーを YAML で定義する | 設定可能。最新ファームウェアは最短 2 秒をサポート | はい(ローカル ブローカー使用時) | いいえ | いいえ | カスタム トピックとセンサーが必要なユーザー |
| HACS HTTP | メーターを LAN 上でアクセス可能に保つ | HACS 経由で IAMMETER HTTP をインストールし、UI で設定する | 60 秒 | はい | はい | SSDP 支援 | YAML なしの UI 設定 |
| HACS Modbus | Modbus TCP を LAN 上で利用可能にする | HACS 経由で IAMMETER Modbus をインストールし、UI で設定する | 設定可能。デフォルト 3 秒 | はい | はい | SSDP 支援 | UI 設定による高速ローカル更新 |
| MQTT Discovery | ブローカーを設定し、メーターの WebUI で HA MQTT Discovery を有効にする | MQTT 統合を有効にする。センサーは自動作成されます | 設定可能。最新ファームウェアは最短 2 秒をサポート | はい(ローカル ブローカー使用時) | いいえ | はい | 最も簡単な MQTT 設定 |
簡単な推奨事項:
- Home Assistant Core を選択するのは、公式の組み込み統合を希望し、30 秒の更新間隔で十分な場合です。
- UI 設定を好み、高速更新を必要としない場合は HACS HTTP を選択してください。
- ダッシュボードや自動化のために、UI 設定でより高速なローカル データを希望する場合は HACS Modbus を選択してください。
- YAML に慣れており、レジスター、センサー、ポーリング間隔を完全に制御したい場合は Home Assistant Modbus を選択してください。
- すでに MQTT を使用しており、Home Assistant にデバイスとエンティティを自動作成させたい場合は MQTT Discovery を選択してください。
- MQTT トピック、テンプレート、エンティティ定義を完全に制御する必要がある場合は MQTT 手動 を選択してください。
MQTT 手動と MQTT Discovery は、メーターのアップロード モードを MQTT に変更します。これらのモードでは、メーターは測定値を IAMMETER Cloud に同時アップロードしません。ローカル HTTP および Modbus TCP 統合は、メーターが IAMMETER Cloud にアップロードしている間も引き続き動作できます。
1. 公式 Home Assistant Core 統合
公式の IAMMETER 統合は Home Assistant に含まれており、メーターのローカル HTTP API を読み取ります。HACS や、Home Assistant とメーター間のインターネット接続は必要ありません。
主な特徴:
configuration.yamlで設定;- 30 秒ごとのローカル HTTP ポーリング;
- IAMMETER Cloud と併用可能;
- 輸入エネルギーと輸出エネルギーのエンティティには、Home Assistant Energy Dashboard に必要なメタデータが含まれます;
- 自動デバイス検出はありません。
高速な更新頻度よりも安定性と公式の Home Assistant サポートを重視する場合は、この方法を使用してください。
2. Home Assistant Modbus TCP 統合
Home Assistant の組み込み Modbus 統合は、メーターのローカル Modbus TCP レジスターを読み取ります。電力ベースの自動化、太陽光余剰制御、その他より高速な更新を必要とするアプリケーションに適しています。
主な特徴:
- YAML で設定;
- 設定可能な
scan_interval。リアルタイム自動化では通常 1~5 秒; - 完全にローカルで、インターネットから独立;
- IAMMETER Cloud と併用可能;
- 正しいレジスター アドレス、データ型、スケール、Energy Dashboard メタデータが必要です。
秒単位のデータが必要ない場合は、より長いポーリング間隔を使用してください。同じメーターに対して複数の高頻度 Modbus クライアントを実行しないでください。
3. HACS HTTP 統合
IAMMETER HTTP カスタム統合は、公式 YAML 統合に代わる UI ベースの手段を提供します。ローカル ネットワーク経由で /monitorjson を読み取り、対応する Home Assistant エンティティを作成します。
主な特徴:
- HACS 経由でインストール;
- Home Assistant のデバイスとサービス UI で設定;
- 60 秒ごとのローカル HTTP ポーリング;
- SSDP はデバイス検出を支援できます;
- IAMMETER Cloud および Energy Dashboard と互換性があります。
UI 設定を好み、1 分間の更新間隔で十分な場合は、この方法を使用してください。
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 統合を有効にします。
- 必要な MQTT センサーと JSON テンプレートを YAML で定義します。
この方法は、複数のアプリケーションが同じ測定値にサブスクライブする必要がある場合、またはカスタム トピックとエンティティ定義が必要な場合に便利です。
6. Home Assistant MQTT Discovery
MQTT Discovery は、手動設定を最小限にしたいユーザー向けです。ブローカーを設定し、メーターの WebUI で HA MQTT Discovery を有効にすると、Home Assistant が IAMMETER デバイスとそのエンティティを自動作成します。
生成される輸入エネルギーと輸出エネルギー エンティティには次が含まれます:
unit_of_measurement: kWh;device_class: energy;state_class: total_increasing.
これらの属性は、Home Assistant Energy Dashboard で使用するために必要なメタデータを提供します。
MQTT Discovery は現在のすべての IAMMETER エネルギー メーターでサポートされています。単相モデルと三相モデルでは、測定チャネルに応じて作成されるエンティティ数が異なります。
対応 IAMMETER エネルギー メーター
現在のすべての IAMMETER エネルギー メーターは、上記の統合方法をサポートしています。Home Assistant での主な違いは、相数または測定チャネル数、したがって作成されるエンティティ数です。
| モデル | 一般的な用途 | Home Assistant サポート | 重要な注意 |
|---|---|---|---|
| WEM3080 | 単相エネルギー監視 | すべての方法 | 単相エンティティ |
| WEM2067 | 単相家庭用太陽光監視 | すべての方法 | 2 つの測定チャネル |
| WEM3080T | 三相エネルギー監視 | すべての方法 | 三相エンティティ |
| WEM3050T | 三相または分相家庭用監視 | すべての方法 | 3 つの測定チャネル |
| WEM3080TD | 三相/三線および特殊配線アプリケーション | すべての方法 | エンティティの解釈は配線モードによって異なります |
| WEM3046T / WEM3046TE | 外部 5 A CT による三相計測 | すべての方法 | 一次側の値を得るには外部 CT 比を適用してください |
WEM3046T と WEM3046TE は、外部変流器の 5 A 二次出力を測定します。CT 比を適用することはこの計測構成の要件であり、Home Assistant の互換性制限ではありません。
Energy Dashboard で IAMMETER エネルギー エンティティを使用する
Home Assistant の Energy Dashboard には、通常、次の属性を持つ kWh 単位の累積輸入エネルギーおよび輸出エネルギー エンティティが必要です:
device_class: energy;state_class: total_increasing.
現在の Core、HACS HTTP、HACS Modbus、MQTT Discovery 統合は、輸入/輸出エネルギー エンティティに必要なメタデータを提供します。手動 Modbus または手動 MQTT 設定では、正しい単位、デバイス クラス、状態クラスを自分で追加する必要があります。
ワット単位の瞬時電力エンティティを、kWh 単位の累積エネルギー エンティティの代用として使用しないでください。
既存の Home Assistant エネルギー データを IAMMETER Cloud に送信する
上記の方法は IAMMETER メーター データを Home Assistant に取り込みます。IAMMETER-Link は逆方向に動作します。Home Assistant にすでに存在するエネルギー エンティティを IAMMETER Virtual Meter と IAMMETER Cloud にアップロードします。
これは、インバーターまたはサードパーティ製メーターにすでに Home Assistant 統合があるが、IAMMETER Cloud のダッシュボード、レポート、またはマルチサイト アクセスも必要な場合に便利です。
IAMMETER-Link は現在、次を提供します:
HACS および UI ベースの設定;
単相および三相の仮想メーター マッピング;
IAMMETER Basic では 300 秒のアップロード間隔;
IAMMETER Pro では 60 秒のアップロード間隔。
Home Assistant エネルギー監視の例
メーターを統合すると、そのリアルタイム電力と累積エネルギー データを次の用途に使用できます:
- 太陽光発電、家庭内消費、系統からの輸入/輸出の監視;
- Modbus TCP を使用したリアルタイム リレー制御;
- Home Assistant と Grafana のダッシュボード;
- 太陽光余剰による EV 充電;
- 太陽光余剰による温水加熱。
サポートが必要ですか?
ファームウェア、エンティティ設定、Energy Dashboard の設定、または統合方法の選択についてご質問がある場合は、IAMMETER コミュニティ フォーラムにアクセスしてください。