View a markdown version of this page

Pengaturan sederhana untuk onboard dan mengoperasikan perangkat - Integrasi Terkelola untuk AWS IoT Device Management

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

Pengaturan sederhana untuk onboard dan mengoperasikan perangkat

Siapkan perangkat Anda untuk di-onboard ke hub Integrasi Terkelola dengan membuat hal terkelola dan menghubungkannya ke hub Anda. Bagian ini menjelaskan langkah-langkah untuk menyelesaikan proses orientasi perangkat menggunakan pengaturan sederhana.

Prasyarat

Selesaikan langkah-langkah ini sebelum mencoba untuk onboard perangkat:

Langkah 1: Buat loker kredenal

Buat loker kredenal untuk perangkat Anda.

Untuk membuat loker kredenal
  • Gunakan perintah create-credential-locker. Menjalankan perintah ini akan memicu pembuatan semua sumber daya manufaktur termasuk Wi-Fi setup key pair dan sertifikat perangkat.

    create-credential-lockercontoh

    aws iot-managed-integrations create-credential-locker \ --name "DEVICE_NAME"

    Tanggapan:

    { "Id": "LOCKER_ID" "Arn": "arn:aws:iotmanagedintegrations:AWS_REGION:AWS_ACCOUNT_ID:credential-locker/LOCKER_ID "CreatedAt": "2025-06-09T13:58:52.977000+08:00" }

    Untuk informasi selengkapnya, lihat perintah create-credential-locker di Referensi Perintah Integrasi Terkelola. AWS CLI

Langkah 2: Tambahkan loker kredenal ke hub Anda

Tambahkan loker kredenal ke hub Anda.

Untuk menambahkan loker kredenal ke hub Anda
  • Gunakan perintah berikut untuk menambahkan loker kredenal ke hub Anda.

    aws iotmi --region AWS_REGION --endpoint AWS_ENDPOINT update-managed-thing \ --identifier "HUB_MANAGED_THING_ID" --credential-locker-id "LOCKER_ID"

Langkah 3: Buat hal yang dikelola dengan kredensi.

Buat hal yang dikelola dengan kredensional untuk perangkat Anda. Setiap perangkat membutuhkan hal yang dikelola sendiri.

Untuk membuat hal yang dikelola
  • Gunakan create-managed-thing perintah untuk membuat hal yang dikelola untuk perangkat Anda.

    create-managed-thingcontoh

    #ZWAVE: aws iot-managed-integrations create-managed-thing --role DEVICE \ --authentication-material '900137947003133...' \ #auth material from zwave qr code --authentication-material-type ZWAVE_QR_BAR_CODE \ --credential-locker-id ${locker_id} #ZIGBEE: aws iot-managed-integrations create-managed-thing --role DEVICE \ --authentication-material 'Z:286...$I:A4DC00.' \ #auth material from zigbee qr code --authentication-material-type ZIGBEE_QR_BAR_CODE \ --credential-locker-id ${locker_id}
    catatan

    Ada perintah terpisah untuk Z-wave dan perangkat Zigbee.

    Tanggapan:

    { "Id": "DEVICE_MANAGED_THING_ID" "Arn": "arn:aws:iotmanagedintegrations:AWS_REGION:AWS_ACCOUNT_ID:managed-thing/DEVICE_MANAGED_THING_ID" "CreatedAt": "2025-06-09T13:58:52.977000+08:00" }

    Untuk informasi selengkapnya, lihat perintah create-managed-thing di Referensi Perintah Integrasi Terkelola. AWS CLI

Langkah 4: Colokkan perangkat dan periksa statusnya.

Colokkan perangkat dan periksa statusnya.
  • Gunakan get-managed-thing perintah untuk memeriksa status perangkat Anda. Hal ProvisioningStatus yang dikelola Anda harus DIAKTIFKAN. Untuk informasi selengkapnya ProvisioningStatus, lihat Penyediaan Perangkat.

    get-managed-thingcontoh

    #KINESIS NOTIFICATION: { "version": "1.0.0", "messageId": "4ac684bb7f4c41adbb2eecc1e7991xxx", "messageType": "DEVICE_LIFE_CYCLE", "source": "aws.iotmanagedintegrations", "customerAccountId": "12345678901", "timestamp": "2025-06-10T05:30:59.852659650Z", "region": "us-east-1", "resources": ["XXX"], "payload": { "deviceDetails": { "id": "1e84f61fa79a41219534b6fd57052XXX", "arn": "XXX", "createdAt": "2025-06-09T06:24:34.336120179Z", "updatedAt": "2025-06-10T05:30:59.784157019Z" }, "status": "ACTIVATED" } } aws iot-managed-integrations get-managed-thing \ --identifier :"DEVICE_MANAGED_THING_ID"

    Tanggapan:

    { "Id": "DEVICE_MANAGED_THING_ID" "Arn": "arn:aws:iotmanagedintegrations:AWS_REGION:AWS_ACCOUNT_ID:managed-thing/MANAGED_THING_ID" "CreatedAt": "2025-06-09T13:58:52.977000+08:00" }

    Untuk informasi selengkapnya, lihat perintah get-managed-thing di Referensi Perintah Integrasi Terkelola. AWS CLI

Langkah 5: Dapatkan Kemampuan Perangkat

Gunakan get-managed-thing-capabilities perintah untuk mendapatkan ID titik akhir Anda dan melihat daftar tindakan yang mungkin untuk perangkat Anda.

Untuk mendapatkan kemampuan perangkat
  • Gunakan get-managed-thing-capabilities perintah dan catat ID titik akhir.

    get-managed-thing-capabiltiescontoh

    aws iotmi get-managed-thing-capabilities \ --identifier "DEVICE_MANAGED_THING_ID"

    Tanggapan:

    { "ManagedThingId": "1e84f61fa79a41219534b6fd57052cbc", "CapabilityReport": { "version": "1.0.0", "nodeId": "zw.FCB10009+06", "endpoints": [ { "id": "ENDPOINT_ID" "deviceTypes": [ "On/Off Switch" ], "capabilities": [ { "id": "matter.OnOff@1.4", "name": "On/Off", "version": "6", "properties": [ "OnOff" ], "actions": [ "Off", "On" ], "events": [] } ... }

    Untuk informasi selengkapnya, lihat perintah get-managed-thing-abilities di Referensi Perintah Integrasi Terkelola. AWS CLI

Langkah 6: Kirim perintah ke hal yang dikelola

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

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

    send-managed-thing-commandcontoh

    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 "ENDPOINT_ID"
    catatan

    Contoh ini menggunakan jq cli tetapi Anda juga dapat meneruskan seluruh string endpointId

    Tanggapan:

    { "TraceId": "TRACE_ID" }

    Untuk informasi selengkapnya, lihat perintah send-managed-thing-command di Referensi Perintah Integrasi Terkelola. AWS CLI

Langkah 7: Hapus hal yang dikelola dari hub Anda

Bersihkan hub Anda dengan menghapus hal yang dikelola.

Untuk menghapus hal yang dikelola
  • Gunakan delete-managed-thing perintah untuk menghapus hal yang dikelola dari hub perangkat Anda.

    delete-managed-thingcontoh

    aws iot-managed-integrations delete-managed-thing \ --identifier "DEVICE_MANAGED_THING_ID"

    Untuk informasi selengkapnya, lihat perintah delete-managed-thing di Referensi Perintah Integrasi Terkelola. AWS CLI

    catatan

    Jika perangkat macet dalam DELETE_IN_PROGRESS keadaan, tambahkan --force bendera ke file. delete-managed-thing command

    catatan

    Untuk Z-wave perangkat, Anda harus meletakkan perangkat ke mode berpasangan setelah menjalankan perintah.