Verwenden Sie eine einfache Einrichtung, um Geräte zu integrieren und zu bedienen

Richten Sie Ihre Geräte so ein, dass sie in Ihren Hub für verwaltete Integrationen integriert werden, indem Sie ein verwaltetes Objekt erstellen und es mit Ihrem Hub verbinden. In diesem Abschnitt werden die Schritte beschrieben, um den Onboarding-Prozess für Geräte mithilfe einer einfachen Einrichtung abzuschließen.

Voraussetzungen

Gehen Sie wie folgt vor, bevor Sie versuchen, ein Gerät an Bord zu nehmen:

• Integrieren Sie ein Hub-Gerät in den Managed Integrations Hub.

• Installieren Sie die neueste Version von AWS CLI aus der Managed Integrations AWS CLI Command Reference

• Abonnieren Sie DEVICE_LIFE_CYCLE-Ereignisbenachrichtigungen.

Schritt 1: Erstellen Sie einen Anmeldeinformationsspeicher

Erstellen Sie einen Anmeldeinformationsspeicher für Ihr Gerät.

Um einen Anmeldeinformationsspeicher zu erstellen

• Verwenden Sie den create-credential-locker-Befehl. Die Ausführung dieses Befehls löst die Erstellung aller Fertigungsressourcen aus, einschließlich des Wi-Fi-Setup-Schlüsselpaars und des Gerätezertifikats.

  create-credential-locker-Beispiel

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

  Antwort:

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

  Weitere Informationen finden Sie in der create-credential-lockerBefehlsreferenz für verwaltete Integrationen zu diesem AWS CLI Befehl.

Schritt 2: Fügen Sie Ihrem Hub den Credential Locker hinzu

Fügen Sie Ihrem Hub den Credential Locker hinzu.

Um Ihrem Hub ein Schließfach für Anmeldeinformationen hinzuzufügen

• Verwenden Sie den folgenden Befehl, um Ihrem Hub einen Anmeldeinformationsspeicher hinzuzufügen.

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

Schritt 3: Erstellen Sie ein verwaltetes Ding mit Anmeldeinformationen.

Erstellen Sie ein verwaltetes Ding mit Anmeldeinformationen für Ihr Gerät. Jedes Gerät benötigt sein eigenes verwaltetes Ding.

Um ein verwaltetes Ding zu erstellen

• Verwenden Sie den create-managed-thing Befehl, um ein verwaltetes Ding für Ihr Gerät zu erstellen.

  create-managed-thing-Beispiel

  #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}

  Anmerkung

  Es gibt separate Befehle für Z-Wave- und ZigBee-Geräte.

  Antwort:

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

  Weitere Informationen finden Sie in der create-managed-thingBefehlsreferenz für verwaltete Integrationen AWS CLI zu diesem Befehl.

Schritt 4: Schließen Sie das Gerät an und überprüfen Sie seinen Status.

Schließen Sie das Gerät an und überprüfen Sie seinen Status.

• Verwenden Sie den get-managed-thing Befehl, um den Status Ihres Geräts zu überprüfen.

  get-managed-thing-Beispiel

  #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"

  Antwort:

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

  Weitere Informationen zu dem Befehl finden Sie in der get-managed-thing AWS CLIBefehlsreferenz für verwaltete Integrationen.

Schritt 5: Holen Sie sich die Gerätefunktionen

Verwenden Sie den get-managed-thing-capabilities Befehl, um Ihre Endpunkt-ID abzurufen und eine Liste möglicher Aktionen für Ihr Gerät anzuzeigen.

Um die Funktionen eines Geräts abzurufen

• Verwenden Sie den get-managed-thing-capabilities Befehl und notieren Sie sich die Endpunkt-ID.

  get-managed-thing-capabilties-Beispiel

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

  Antwort:

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

  Weitere Informationen finden Sie unter dem get-managed-thing-capabilitiesBefehl in der AWS CLI Befehlsreferenz für verwaltete Integrationen.

Schritt 6: Senden Sie einen Befehl an das verwaltete Ding

Verwenden Sie den send-managed-thing-command Befehl, um einen Befehl zum Umschalten einer Aktion an Ihr verwaltetes Ding zu senden.

Um einen Befehl an Ihr verwaltetes Ding zu senden

• Verwenden Sie den send-managed-thing-command Befehl, um einen Befehl an Ihr verwaltetes Ding zu senden.

  send-managed-thing-command-Beispiel

  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"
            

  Anmerkung

  In diesem Beispiel wird jq cli verwendet, aber Sie können auch die gesamte endpointId Zeichenfolge übergeben

  Antwort:

  {    
  "TraceId": "TRACE_ID"
  }

  Weitere Informationen finden Sie unter dem send-managed-thing-commandBefehl in der Befehlsreferenz für verwaltete Integrationen AWS CLI .

Schritt 7: Entfernen Sie das verwaltete Ding von Ihrem Hub

Bereinigen Sie Ihren Hub, indem Sie das verwaltete Ding entfernen.

Um ein verwaltetes Ding zu löschen

• Verwenden Sie den delete-managed-thing Befehl, um ein verwaltetes Ding von Ihrem Gerätehub zu entfernen.

  delete-managed-thing-Beispiel

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

  Weitere Informationen finden Sie in der delete-managed-thingBefehlsreferenz für verwaltete Integrationen zu diesem AWS CLI Befehl.

  Anmerkung

  Wenn das Gerät in einem bestimmten DELETE_IN_PROGRESS Zustand feststeckt, hängen Sie das --force Kennzeichen an. delete-managed-thing command

  Anmerkung

  Bei Z-Wave-Geräten müssen Sie das Gerät nach der Ausführung des Befehls in den Pairing-Modus versetzen.