翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Matter プラグイン

Matter プラグインとは

Matter Plugin は、 Managed Integrations Hub SDK カスタムプロトコルプラグインの機能を使用して構築されたリファレンス実装です。これにより、ハブは、Matter 仕様に従って、同じネットワーク上のローカルデバイスと、マネージド統合を介してリモートの両方で Matter デバイスを制御できます。

Matter プラグインは Hub SDK に含まれています。Matter デバイスと通信し、Matter Controller 機能を実装し、マネージド統合を介してリモートコントロールパスを公開します。

chip-tool は、connectedhomeip のコマンドラインベースのリファレンスコントローラーです。Matter ファブリックのコミッショナー/コントローラーとして機能し、デバイスのコミッショニング、属性の読み取り/書き込み、コマンドの呼び出しを可能にし、開発と相互運用性のテストを目的としています。このガイドでは、Matter プラグインはチップツールを使用して Matter デバイスを制御し、モバイルアプリからの Matter コミッショニングもデモンストレーションします。

このディストリビューションの範囲には、本番稼働用モバイルアプリケーションは含まれません。また、CSA ラボテストや認定などの認定や本番稼働用アクティビティも対象としていません。これらは引き続き製品開発プロセスの一部です。

Matter プラグインを構築する方法

Matter プラグインには、Hub SDK に加えて次の依存関係があります。

次のコマンドを使用してリポジトリを設定します。

cd IotMI-DeviceSDK-MatterPlugin  
mkdir build  
cd build  
cmake ..

次に、次のコマンドを使用してビルドします。

cmake --build .

構築後、ライブラリパスを LD_LIBRARY_PATH に追加します。

export LD_LIBRARY_PATH=/path/to/libraries:$LD_LIBRARY_PATH

クイックスタート: Matter プラグインをセットアップして実行する

Matter プラグインと対応する Matter ソリューションをセットアップするには、以下のステップに従います。このフローでは、コミッショニングと基本制御用の「モバイルアプリ」を表す Hub (Hub SDK + Matter プラグインを実行) と Raspberry Pi の 2 つのマシンを想定しています。

ノード ID 管理

Matter では、デバイス、コントローラー、コミッショナーなど、ファブリック上のすべてのノードに一意のノード ID が必要です。衝突を回避するには、一貫した割り当てポリシーが必要です。このガイドでは、ノード IDsます。本番環境では、ノード IDsを適切に管理する必要があります。

このドキュメントの例では、Hub のチップツール ( Matter プラグインで使用) はデフォルトのノード ID を使用し112233、モバイルアプリ Raspberry Pi のチップツールはノード ID を使用します123456。新しくコミッショニングされたデバイスには、同じファブリック (クイックスタートの 101 など) に競合しないノード IDs が割り当てられます。

前提条件

作業を開始する前に、次の項目が揃っていることを確認してください。

ステップ 1. Raspberry Pi (モバイルアプリを表す) を準備する

生成されたチェーンは、次の場所に保存されます。 $HOME/iotmi/matter/chip_tool_config.alpha.ini

このファイルは後で Hub にコピーします。

ステップ 2. ハブを準備する ( Matter プラグインを実行する)

また、後で使用するために、チップツールの sha256sum も必要です。次のコマンドを使用して sha256sum を取得できます。

sha256sum /path/to/chip-tool

以下の手順は、Raspberry Pi、つまりコミッショナーで実行します。

ステップ 3. Matter デバイスのコミッショニング (Raspberry Pi 上)

チップツールを使用して、デコードされた QR コードを使用してデバイスをコミッショニングし、Wi-Fi 認証情報をプロビジョニングします。この例では、デバイスはノード ID 101 を使用し、コミッショナーノード ID は です123456。

./chip-tool pairing code-wifi 101 \  
    YOUR_WIFI_SSID YOUR_WIFI_PW  \  
    MT:MFAA0W8C00UFQV2VL00 \  
    --bypass-attestation-verifier 1 \  
    --commissioner-nodeid 123456 \  
    --storage-directory $HOME/iotmi/matter/

注意:

chip-tool は、QR コードや PIN コードと Thread または WiFi デバイスとのペアリングなど、さまざまなペアリング方法をサポートしています。chip-tool pairing コマンドの詳細については、公式ドキュメントを参照してください。

ステップ 4. デバイスに対する Hub アクセスの付与 (ACL の更新)

コミッショニング後、Hub のチップツールがデバイスを制御できるようにします。この例では、ノード ID 123456 (Raspberry Pi) には管理者アクセス許可 (5) があり、ノード ID 112233 (Hub) には管理アクセス許可 (4) があります。

chip-tool accesscontrol write acl \  
    '[{"fabricIndex":1,"privilege":5,"authMode":2,"subjects":[123456], "targets": null},{"fabricIndex":1,"privilege":4,"authMode":2,"subjects":[112233], "targets": null}]' \  
    101 0 \  
    --commissioner-nodeid 123456  
    --storage-directory $HOME/iotmi/matter/

ステップ 5. デバイスのマネージド型モノを作成する (ユーザーガイド付きセットアップ)

サンプルレスポンスには、ユーザーガイドの設定ジョブ ID が含まれます。

{  
    "Id": "USER_GUIDED_SETUP_JOB_ID",  
    "StartedAt": 1753683326.056  
}

レスポンス例:

{  
    "Items": [  
        {  
            "DeviceTypes": [],  
            "DiscoveredAt": "2025-08-05T06:46:35.407000+08:00",  
            "AuthenticationMaterial": "<AUTH_MATERIAL>"  
        }  
    ]  
}

サンプルレスポンス (デバイスのマネージドモノ ID を使用):

{  
    "Id": "DEVICE_MANAGED_THING_ID",  
    "Arn": "arn:aws:iotmanagedintegrations:eu-west-1:228183742813:managed-thing/515cf5a707ec41aaabb9914a1dd2889f",  
    "CreatedAt": "2025-08-06T15:00:08.718000+08:00"  
}

ステップ 6. マネージド統合によるデバイスの制御

send-managed-thing-command コマンドを使用して、マネージドモノにコマンドを送信します。

json=$(jq -cr '.|@json' <<EOF  
[  
  {  
    "endpointId": "1",  
    "capabilities": [  
      {  
        "id": "matter.OnOff@1.4",  
        "name": "On/Off",  
        "version": "1",  
        "actions": [  
          {  
            "name": "Toggle",  
            "parameters": {}  
          }  
        ]  
      }  
    ]  
  }  
]  
EOF  
)  
aws iot-managed-integrations send-managed-thing-command \  
    --managed-thing-id "DEVICE_MANAGED_THING_ID" \  
    --endpoints "$json"

ステップ 7. 読み取りデバイスの状態

次のコマンドを送信して、デバイスの状態を取得します。

aws iot-managed-integrations get-managed-thing-state \  
    --managed-thing-id "DEVICE_MANAGED_THING_ID"

サンプル結果:

{  
    "Endpoints": [  
        {  
            "endpointId": "1",  
            "capabilities": [  
                {  
                    "id": "matter.OnOff@1.4",  
                    "name": "On/Off",  
                    "version": "1.4",  
                    "properties": [  
                        {  
                            "value": {  
                                "lastChangedAt": "2025-08-14T13:16:02.132Z",  
                                "propertyValue": false  
                            },  
                            "name": "OnOff"  
                        }  
                    ]  
                }  
            ]  
        }  
    ]  
}

ステップ 8. ハブからマネージド型モノを削除する

サポートされている Matter デバイスタイプ

追加のクラスターのサポートの追加

Matter プラグインを拡張して追加のデバイスタイプと機能をサポートするには、次のパターンに従って matter_action_converter.cpp を変更します。

実装パターン:

既存のクラスターをテンプレートとして使用します。

サポートされているすべてのクラスター (Identify、OnOff、LevelControl、DoorLock、サーモスタット、ColorControl、BooleanState) はこの構造に従います。matter_action_converter.cpp の既存の実装を確認して、完全なパターンを理解します。

Matter Controller のさまざまなソリューションを統合する

このセクションでは、さまざまな Matter Controller ソリューションを Matter プラグインと統合する方法に関するガイダンスを提供します。考えられるアプローチと重要な考慮事項を概説していますが、詳細な実装コードは提供していません。

Matter Controller ソリューションを統合するには、主に 2 つの方法があります。1 つ目は、カスタマイズされたチップツールで Matter プラグインを使用することです。2 つ目は、選択した Matter Controller を使用し、カスタムプロトコルライブラリを介してマネージド統合と統合することです。

カスタマイズされたチップツールで Matter プラグインを使用する

このアプローチでは、Matter プラグインが チップツールのカスタマイズされたバージョンで動作するように拡張されています。これを実現するには、Matter Plugin ソースコードを変更し、追加のロジックを導入する必要がある場合があります。

チップツール側では、次の機能強化も推奨されます。

マネージド統合での既存の Matter Controller の使用

Matter Controller がチップツールに基づいていない場合 (Python ベースの実装や関数コールベースのソリューションなど）、STDIO アプローチが適していない可能性があります。このような場合は、 Matter プラグインをリファレンスとして使用しながらカスタムプロトコルプラグイン、 を使用して マネージド統合と直接統合できます。以下の考慮事項に注意してください。