Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Plugin Materi

Apa itu Plugin Matter

Matter Plugin adalah implementasi referensi yang dibuat menggunakan Plugin protokol kustom fitur SDK Hub Integrasi Terkelola. Ini memungkinkan hub Anda untuk mengontrol perangkat Matter baik secara lokal di jaringan yang sama, mengikuti spesifikasi Matter, dan dari jarak jauh melalui integrasi Terkelola.

Plugin Matter disertakan dalam Hub SDK. Ini berkomunikasi dengan perangkat Matter, mengimplementasikan fungsionalitas Matter Controller, dan mengekspos jalur kendali jarak jauh melalui integrasi Terkelola.

chip-tool adalah pengontrol referensi berbasis baris perintah dari connectedhomeip. Ini bertindak sebagai Commissioner/Controller kain Matter, memungkinkan Anda untuk menugaskan perangkat, read/write atribut, dan memanggil perintah dan dimaksudkan untuk pengembangan dan pengujian interoperabilitas. Dalam panduan ini, Plugin Matter akan menggunakan alat chip untuk mengontrol perangkat Matter dan juga mendemonstrasikan commissioning Matter dari Aplikasi Seluler.

Ruang lingkup distribusi ini tidak termasuk aplikasi seluler produksi, juga tidak mencakup sertifikasi dan kegiatan produksi seperti uji lab dan sertifikasi CSA. Ini tetap menjadi bagian dari proses pengembangan produk Anda.

Bagaimana membangun Plugin Matter

Plugin Matter memiliki dependensi berikut selain Hub SDK:

Konfigurasikan repo dengan perintah berikut:

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

Kemudian bangun dengan perintah berikut:

cmake --build .

Setelah membangun, tambahkan jalur perpustakaan ke LD_LIBRARY_PATH:

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

Quickstart: Siapkan dan Jalankan Plugin Matter

Ikuti langkah-langkah di bawah ini untuk mengatur Plugin Matter dan solusi Matter yang sesuai. Aliran mengasumsikan dua mesin: Hub (menjalankan Plugin Hub SDK+Matter) dan Raspberry Pi yang mewakili “Aplikasi Seluler” untuk commissioning dan kontrol dasar.

Manajemen ID Node

Di Matter, setiap node pada kain — termasuk perangkat, pengontrol, dan komisaris — harus memiliki ID Node yang unik. Untuk menghindari tabrakan, diperlukan kebijakan alokasi yang konsisten. Dalam panduan ini, ID Node ditetapkan secara manual; dalam produksi, Anda harus mengelola ID Node dengan benar.

Untuk contoh dalam dokumen ini, alat chip Hub (digunakan oleh Plugin Matter) menggunakan ID Node default112233, dan alat chip pada Aplikasi Seluler Raspberry Pi menggunakan ID Node. 123456 Perangkat yang baru ditugaskan diberi ID Node yang tidak bertentangan pada kain yang sama (misalnya, 101 di quickstart).

Prasyarat

Sebelum Anda mulai, pastikan Anda memiliki yang berikut:

Langkah 1. Siapkan Raspberry Pi (mewakili Aplikasi Seluler)

Rantai yang dihasilkan disimpan di: $HOME/iotmi/matter/chip_tool_config.alpha.ini

Anda akan menyalin file ini ke Hub nanti.

Langkah 2. Siapkan Hub (yang menjalankan Plugin Matter)

Kita juga membutuhkan sha256sum dari chip-tool untuk digunakan nanti. Anda dapat menggunakan perintah berikut untuk mendapatkan sha256sum:

sha256sum /path/to/chip-tool

Langkah-langkah di bawah ini harus dijalankan pada Raspberry Pi yaitu Komisaris.

Langkah 3. Komisi perangkat Matter (pada Raspberry Pi)

Gunakan chip-tool untuk menugaskan perangkat menggunakan kode QR yang didekodekan dan kredensialnya. Wi-Fi Dalam contoh ini, perangkat akan menggunakan ID node 101 dan ID node komisaris adalah123456.

./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/

Catatan:

chip-tool mendukung metode pemasangan yang berbeda, termasuk kode QR atau pemasangan kode PIN dengan Thread atau perangkat. WiFi Untuk informasi selengkapnya tentang perintah pemasangan alat chip, lihat dokumentasi resmi.

Langkah 4. Berikan akses Hub di perangkat (perbarui ACL)

Setelah commissioning, izinkan alat chip Hub untuk mengontrol perangkat. Dalam contoh ini, ID node 123456 (Raspberry Pi) memiliki izin Admin (5) dan ID node 112233 (Hub) memiliki izin Kelola (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/

Langkah 5. Buat hal yang dikelola untuk perangkat (User-Guided Pengaturan)

Contoh respons mencakup ID pekerjaan penyiapan yang dipandu pengguna:

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

Contoh respons:

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

Respons sampel (dengan ID benda terkelola perangkat):

{  
    "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"  
}

Langkah 6. Kontrol perangkat melalui integrasi Terkelola

Gunakan send-managed-thing-command perintah untuk mengirim perintah ke hal yang Anda kelola.

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"

Langkah 7. Membaca status perangkat

Kirim perintah berikut untuk mendapatkan status perangkat.

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

Hasil sampel:

{  
    "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"  
                        }  
                    ]  
                }  
            ]  
        }  
    ]  
}

Langkah 8. Hapus hal yang dikelola dari hub Anda

Jenis perangkat Matter yang didukung

Menambahkan Support untuk Cluster Tambahan

Untuk memperluas Plugin Matter untuk mendukung jenis dan kemampuan perangkat tambahan, modifikasi matter_action_converter.cpp mengikuti pola ini:

Pola implementasi:

Gunakan cluster yang ada sebagai template:

Semua cluster yang didukung (Identifikasi, OnOff,, LevelControl DoorLock, Thermostat, ColorControl, BooleanState) mengikuti struktur ini. Tinjau implementasi yang ada di matter_action_converter.cpp untuk memahami pola lengkapnya.

Integrasikan solusi Matter Controller yang berbeda

Bagian ini memberikan panduan tentang cara mengintegrasikan berbagai solusi Matter Controller dengan Matter Plugin. Ini menguraikan pendekatan yang mungkin dan pertimbangan penting tetapi tidak memberikan kode implementasi rinci.

Ada dua cara utama untuk mengintegrasikan solusi Matter Controller. Yang pertama adalah menggunakan Plugin Matter dengan chip-tool yang disesuaikan. Yang kedua adalah menggunakan Matter Controller pilihan Anda dan integrasi dengan integrasi Terkelola melalui pustaka Protokol Kustom.

Menggunakan Plugin Matter dengan Disesuaikan Chip-Tool

Dalam pendekatan ini, Plugin Matter diperluas untuk bekerja dengan versi yang disesuaikan dari file Chip-Tool. Untuk mencapai ini, Anda mungkin perlu memodifikasi kode sumber Matter Plugin dan memperkenalkan logika tambahan:

Di sisi chip-tool, penyempurnaan berikut juga direkomendasikan:

Menggunakan Existing Matter Controller dengan integrasi Terkelola

Jika Matter Controller Anda tidak didasarkan pada chip-tool (misalnya, Python-based implementasi atau solusi berbasis panggilan fungsi), pendekatan STDIO mungkin tidak cocok. Dalam kasus seperti itu, Anda dapat berintegrasi langsung dengan integrasi Terkelola menggunakanPlugin protokol kustom, saat menggunakan Plugin Matter sebagai referensi. Pertimbangan berikut berlaku untuk instans Mac: