IAMMETER が SunSpec Modbus/TCP 対応を追加：モデルマッピングと導入ガイド

IAMMETER のファームウェア i.91.065.18 は、既存の Modbus/TCP サービスに読み取り専用の SunSpec 整数メーターモデルマップを追加します。SunSpec モデルを理解するソフトウェアは、これにより標準的な手順で IAMMETER メーターを検出し、ローカルネットワーク経由で選択した電気的測定値を読み取ることができます。

これはインターフェースの追加であり、測定システムの置き換えではありません。メーターはこれまでと同じ方法でデータを収集し続けます。既存の IAMMETER Modbus レジスタ、HTTP API、MQTT ペイロード、NEM 設定は変更されません。

SunSpec は、Modbus 保持レジスタにマッピングできる標準的なデバイス情報モデルを定義しています。そのマップは SunS マーカーで始まり、続いて Common モデルとデバイス固有モデルが並びます。クライアントは各モデルの ID と長さを順に読み取ることで、これらを検出できます。SunSpec Modbus 仕様パッケージには、0 ベースの Modbus マップ位置や未実装値の扱いを含むモデル検出パターンが記載されています。SunSpec Modbus は、メーター、インバーター、蓄電設備など、分散型エネルギー連携の分野で広く利用されています。

IAMMETER は、メーター データに焦点を当てた読み取り専用のサブセットを実装します。この実装は SunSpec 認定されていません。この機能を認定、完全な SunSpec 準拠、またはすべてのサードパーティの SunSpec クライアントが設定なしで動作することの保証として扱わないでください。

現在のファームウェア モデルのマッピング

これらの行は、現在のファームウェア モデルのマッピングを説明します。ここで報告される物理デバイスの検証は WEM3080T のみを対象としています。リストされている他のモデルでもデバイスのテストが必要です。

WEM2067 の場合、モデル 202 は純正の分割フェーズ設置を表します。この文書では、無関係な 2 つの単相回路を同じ電気的構成として説明していません。

モデル 204 のコードにはホスト テストの範囲がありますが、ファームウェアはまだ自動的に検出して WEM3080TD 用に選択しません。したがって、この記事はモデル 204 の入手可能性を主張するものではありません。 WEM3046TE も専用のモデル識別検証をまだ受けていません。最初のリリースでは整数モデルのみが提供されます。浮動小数点モデル 211 ～ 214 は使用できません。

クライアントが読み取ることができる内容

整数メーター モデルは、相電圧、相電流、相有効電力、合計有効電力、周波数、相力率、および相ごとおよび合計インポート/エクスポート有効エネルギー アキュムレータを公開します。共通モデルは、モデル、ファームウェアのバージョン、シリアル番号などのデバイス識別データを提供します。

SunSpec マップでは、エネルギーは Wh で表されます。力率は パーセント で表されます。合計エネルギー ポイントは、メーターの既存の合計フィールドと NEM セマンティクス を再利用します。 IAMMETER は、このマッピングに位相アキュムレータを追加して 3 相の合計を再計算しません。 NEM 設定はこれらのアキュムレータの意味に影響を与えるため、クライアントは総エネルギーが常に位相エネルギーの合計と等しいと想定してはなりません。

この最初のバージョンでは、無効電力と無効電力量、皮相電力と皮相電力量、多相総力率、イベント フラグなどのいくつかのフィールドが意図的に省略されています。それらの標準の位置はモデル内に残り、適切な使用不可マーカーを返します。 SunSpec クライアントは、使用できない値を測定値として解釈するのではなく、それを認識する必要があります。

電圧の解釈が重要です

相の値はメーターから取得されます。一部の線間電圧ポイントは、モデルマッピングのために導出されています。

• モデル 202 の線間電圧は UA + UB です。
• モデル 203 の線間電圧は、相電圧に √3 を掛けた近似値であり、線間を直接測定した値ではありません。不平衡なシステムや位相角のずれは誤差を生じることがあります。

この違いは、直接測定された線間電圧を必要とするアプリケーションにとって重要です。制御やコンプライアンスの判断に導出値を使用する前に、モデルのポイント定義と接続構成を確認してください。

Modbus/TCP で接続する

メーターの既存の Modbus/TCP サービスを有効にして、その LAN アドレスに接続します。

このガイドのアドレスは 0 ベースの Modbus リクエスト アドレス です。一部のアプリケーションでは 1 から始まるレジスタ番号が表示されるため、読み取りを設定する前にその規則を確認してください。 off-by-one アドレスは予期したマーカーを返しません。

以下の各読み取りには、ファンクション コード 03 を使用してください。レジスタ数には、該当する場合、モデル ID と長さが含まれます。

1 つの Modbus リクエストで読み取れるレジスタは 125 個までであるため、コモン モデルとメーター モデルを別々に読み取ってください。クライアントは、将来のすべてのモデル シーケンスについての仮定をハードコーディングするのではなく、モデル ID と長さを発見する必要があります。

整数値とスケールファクター

SunSpec の整数ポイントはスケールファクターを使用します。生の整数値は次の式で変換します。

actual value = register integer × 10^scale factor

例：

W = 12345
W_SF = 1
actual active power = 123450 W

スケールファクターはレンジによって変化することがあります。値とそのスケールファクターが同じ応答に由来するよう、ポーリングサイクルごとにメーターモデル全体を読み取ってください。スケールファクターを無期限にキャッシュしないでください。

検証と現在の制限

検証には 2 つの個別のスコープがあります。

• 実装検証: モデル レイアウト、変換、オーバーフロー、読み取り専用動作、および既存のレジスタの回帰チェックに関するホスト テストに合格しました。 WEM3080T テスト メーターは、既存の HTTP および Modbus インターフェイスに対して電圧と電力をチェックし、モデル 203 の検出と連続読み取りを確認しました。他のメーターモデルおよび個々のサードパーティクライアントについては、さらに物理的なテストが必要です。
• リリース ファイルの検証: ファームウェア i.91.065.18 がビルドされ、アップロードされ、ファイル検証のために再度ダウンロードされました。この正確なリリース ファイルは、この検証サイクル中にフラッシュされませんでした。上記の実装結果は、ダウンロードされたリリース ファイルのデバイス テストとして読み取られるべきではありません。

ファームウェアには、保留中の TCP フレームの改善は含まれていません。現在、受信操作では 1 つの完全なリクエストが必要です。分割または結合された TCP リクエストにより接続が終了する場合があります。 1 つのリクエストを送信し、その応答を待ってから次のリクエストを送ります。ただし、これによって TCP セグメンテーションのリスクがすべて排除されるわけではないことを認識してください。

IAMMETER インストール内でこれが該当する場所

アーキテクチャを選択するには、IAMMETER 統合およびセルフホスティング ソリューション から始めます。 ローカル API およびオープン インターフェイス ガイド では、利用可能なメーター インターフェイスを比較しています。

SunSpec メーター モデルを検出して読み取るためにローカル クライアントを構築する場合は、SunSpec マップを使用します。アプリケーションが IAMMETER 固有のレジスタを必要とする場合は、既存の IAMMETER Modbus/TCP レジスタ マップ を使用します。既存のローカル Modbus パスは Home Assistant エネルギーメーターの統合 に引き続き役立ちますが、HTTP、MQTT、および IAMMETER クラウドは独立したオプションのままです。

ファームウェアをダウンロードします: i.91.065.18.bin。

更新する前に、IAMMETER ファームウェアのアップグレード手順に従い、メーターのモデル、接続方法、ローカル ネットワーク アクセスを確認してください。これは読み取り専用のデータ インターフェイスです。インバータ制御、書き込み操作、またはサードパーティの SunSpec の完全な相互運用性を保証するものではありません。

IAMMETERのSunSpec連携事例を共有して5,000～10,000 Reward Pointsを獲得

実際の機器を使って、SunSpec経由でIAMMETERメーターのデータを読み取ってください。シミュレーターで取得した結果は対象外です。

詳細な連携ドキュメントを作成し、公開フォーラムに投稿した参加者は、IAMMETERの審査後に5,000～10,000 Reward Pointsを獲得できます。ポイント数はドキュメントの品質と完成度に応じて決まります。

活動ページを開き、Applyをクリックして参加。