Gunakan pengaturan sederhana untuk onboard dan mengoperasikan perangkat - Integrasi terkelola untuk AWS IoT Device Management
Prasyarat

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

Gunakan pengaturan sederhana untuk onboard dan mengoperasikan perangkat

Siapkan perangkat Anda untuk dionboard 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 key pair pengaturan Wi-Fi 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 create-credential-lockerperintah dalam Integrasi terkelola AWS CLI Command Reference.

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 perangkat Z-wave dan 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 create-managed-thingperintah dalam Integrasi terkelola AWS CLI Command Reference.

Langkah 4: Colokkan perangkat dan periksa statusnya.

Colokkan perangkat dan periksa statusnya.

  • Gunakan get-managed-thing perintah untuk memeriksa status perangkat Anda.

    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 get-managed-thingperintah dalam Integrasi terkelola AWS CLI Command Reference.

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 get-managed-thing-capabilitiesperintah dalam Integrasi terkelola AWS CLI Command Reference.

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 send-managed-thing-commandperintah dalam Integrasi terkelola AWS CLI Command Reference.

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 delete-managed-thingperintah dalam Integrasi terkelola AWS CLI Command Reference.

    catatan

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

    catatan

    Untuk perangkat gelombang-Z, Anda harus memasukkan perangkat ke mode berpasangan setelah menjalankan perintah.