Gunakan pengaturan yang dipandu pengguna 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 yang dipandu pengguna 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 yang dipandu pengguna.

Prasyarat

Selesaikan langkah-langkah ini sebelum mencoba untuk onboard perangkat:

Prasyarat: Aktifkan mode pemasangan pada perangkat Z Wave Anda

Aktifkan mode pemasangan pada perangkat gelombang-Z. Mode pemasangan dapat bervariasi untuk setiap perangkat Z-Wave, jadi lihat instruksi perangkat untuk mengatur mode pemasangan dengan benar. Biasanya tombol yang harus ditekan pengguna.

Langkah 1: Mulai penemuan perangkat

Mulai penemuan perangkat untuk hub Anda untuk mendapatkan ID pekerjaan penemuan yang digunakan untuk onboard perangkat Anda.

Untuk memulai penemuan perangkat

  • Gunakan start-device-discoveryperintah untuk mendapatkan ID pekerjaan penemuan.

    start-device-discoverycontoh

    #For Zigbee
  aws iot-managed-integrations start-device-discovery --discovery-type ZIGBEE \
  --controller-identifier HUB_MANAGED_THING_ID
  
  #For Zwave
  aws iot-managed-integrations start-device-discovery --discovery-type ZWAVE \
  --controller-identifier HUB_MANAGED_THING \
  --authentication-material-type ZWAVE_INSTALL_CODE \
  --authentication-material 13333
  
  #For Cloud
  aws iot-managed-integrations start-device-discovery --discovery-type CLOUD \
  --account-association-id C2C_ASSOCIATION_ID \
  
  #For Custom
  aws iot-managed-thing start-device-discovery --discovery-type CUSTOM \
  --controller-identifier HUB_MANAGED_THING_ID \
  --custom-protocol-detail NAME : NON_EMPTY_STRING \

    Tanggapan:

    {
      "Id": DISCOVERY_JOB_ID,
      "StartedAt": "2025-06-03T14:43:12.726000-07:00"
  }
    catatan

    Ada perintah terpisah untuk perangkat Z-wave dan Zigbee.

    Untuk informasi selengkapnya, lihat start-device-discoveryAPI di Referensi AWS CLI Perintah integrasi terkelola.

Langkah 2: Kueri ID pekerjaan penemuan

Gunakan list-discovered-devices perintah untuk mendapatkan materi otentikasi perangkat Anda.

Untuk menanyakan ID pekerjaan penemuan Anda

  • Gunakan ID pekerjaan penemuan dengan list-discovered-devices perintah untuk mendapatkan materi otentikasi perangkat Anda.

    aws iot-managed-integrations list-discovered-devices --identifier DISCOVERY_JOB_ID

Tanggapan:

"Items": [
    {
        "DeviceTypes": [],
        "DiscoveredAt": "2025-06-03T14:43:37.619000-07:00",
        "AuthenticationMaterial": AUTHENTICATION_MATERIAL
    }
]

Langkah 3: Buat hal yang dikelola untuk perangkat Anda

Gunakan create-managed-thing perintah untuk membuat hal yang dikelola 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

    aws iot-managed-integrations create-managed-thing \
  --role  DEVICE --authentication-material-type DISCOVERED_DEVICE \
  --authentication-material "AUTHENTICATION_MATERIAL"

    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: Kueri hal yang dikelola

Anda dapat memeriksa apakah hal yang dikelola diaktifkan dengan menggunakan get-managed-thing perintah.

Untuk menanyakan hal yang dikelola

  • Gunakan get-managed-thing perintah untuk memeriksa apakah status penyediaan hal yang dikelola disetel ke. ACTIVATED

    get-managed-thingcontoh

    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/DEVICE_MANAGED_THING_ID,
      "Role": "DEVICE",
      "ProvisioningStatus": "ACTIVATED",
      "MacAddress": "MAC_ADDRESS",
      "ParentControllerId": "PARENT_CONTROLLER_ID",
      "CreatedAt": "2025-06-03T14:46:35.149000-07:00",
      "UpdatedAt": "2025-06-03T14:46:37.500000-07:00",
      "Tags": {}
  }

    Untuk informasi selengkapnya, lihat get-managed-thingperintah dalam Integrasi terkelola AWS CLI Command Reference.

Langkah 5: Dapatkan kemampuan hal yang dikelola

Anda dapat melihat daftar tindakan yang tersedia dari hal terkelola dengan menggunakanget-managed-thing-capabiltiies.

Untuk mendapatkan kemampuan perangkat

  • Gunakan get-managed-thing-capabilities perintah untuk mendapatkan ID endpoint. Perhatikan juga daftar tindakan yang mungkin.

    get-managed-thing-capabilitiescontoh

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

    Tanggapan:

    {
      "ManagedThingId": "DEVICE_MANAGED_THING_ID",
      "CapabilityReport": {
          "version": "1.0.0",
          "nodeId": "zb.539D+4A1D",
          "endpoints": [
              {
                  "id": "1",
                  "deviceTypes": [
                      "Unknown Device"
                  ],
                  "capabilities": [
                      {
                          "id": "matter.OnOff@1.4",
                          "name": "On/Off",
                          "version": "6",
                          "properties": [
                              "OnOff",
                              "OnOff",
                              "OnTime",
                              "OffWaitTime"
                          ],
                          "actions": [
                              "Off",
                              "On",
                              "Toggle",
                              "OffWithEffect",
                              "OnWithRecallGlobalScene",
                              "OnWithTimedOff"
                          ],
                          ...
  }

    Untuk informasi selengkapnya, lihat get-managed-thing-capabilitiesperintah dalam Integrasi terkelola AWS CLICommand Reference.

Langkah 6: Kirim perintah ke hal yang dikelola

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

Kirim perintah ke hal yang dikelola menggunakan tindakan sakelar.

  • Gunakan send-managed-thing-command perintah untuk mengirim perintah toggle action.

    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: Periksa status hal yang dikelola

Periksa status hal yang dikelola untuk memvalidasi tindakan sakelar berhasil.

Untuk memeriksa status perangkat yang dikelola

  • Gunakan get-managed-thing-state perintah untuk memvalidasi tindakan toggle berhasil.

    get-managed-thing-statecontoh

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

    Tanggapan:

    {
      "Endpoints": [
          {
              "endpointId": "1",
              "capabilities": [
                  {
                      "id": "matter.OnOff@1.4",
                      "name": "On/Off",
                      "version": "1.4",
                      "properties": [
                          {
                              "name": "OnOff",
                              "value": {
                                  "propertyValue": true,
                                  "lastChangedAt": "2025-06-03T21:50:39.886Z"
                              }
                          }
                      ]
                  }
              ]
          }
      ]
  }

    Untuk informasi selengkapnya, lihat get-managed-thing-stateperintah dalam Integrasi terkelola AWS CLICommand Reference.

Langkah 8: Hapus hal yang dikelola dari hub Anda

Bersihkan hub Anda dengan menghapus hal yang dikelola.

Untuk menghapus hal yang dikelola

  • Gunakan delete-managed-thingperintah untuk menghapus hal yang dikelola.

    delete-managed-thingcontoh

    aws iot-managed-integrations delete-managed-thing \
  --identifier 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 delete-managed-thing perintah.

    catatan

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