Benutzergeführte Einrichtung zur Einbindung und Bedienung von Geräten - Verwaltete Integrationen für AWS IoT Device Management
Voraussetzungen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Benutzergeführte Einrichtung zur Einbindung und Bedienung von Geräten

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 der benutzergeführten Einrichtung abzuschließen.

Voraussetzungen

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

Voraussetzung: Aktivieren Sie den Pairing-Modus auf Ihrem Z Wave-Gerät

Aktivieren Sie den Pairing-Modus auf dem Z-Wave-Gerät. Der Pairing-Modus kann für jedes Z-Wave-Gerät unterschiedlich sein. Lesen Sie daher die Anweisungen des Geräts, um den Pairing-Modus richtig einzurichten. In der Regel handelt es sich um eine Taste, die der Benutzer drücken muss.

Schritt 1: Starten Sie die Geräteerkennung

Starten Sie die Geräteerkennung für Ihren Hub, um eine Discovery-Job-ID zu erhalten, die zum Onboarding Ihres Geräts verwendet wird.

Um die Geräteerkennung zu starten

  • Verwenden Sie den start-device-discoveryBefehl, um die Discovery-Job-ID abzurufen.

    start-device-discovery-Beispiel

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

    Antwort:

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

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

    Weitere Informationen zur start-device-discoveryAPI finden Sie in der Befehlsreferenz für verwaltete Integrationen. AWS CLI

Schritt 2: Fragen Sie die Discovery-Job-ID ab

Verwenden Sie den list-discovered-devices Befehl, um das Authentifizierungsmaterial Ihres Geräts abzurufen.

Um Ihre Discovery-Job-ID abzufragen

  • Verwenden Sie die Discovery-Job-ID zusammen mit dem list-discovered-devices Befehl, um das Authentifizierungsmaterial Ihres Geräts abzurufen.

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

Antwort:

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

Schritt 3: Erstellen Sie ein verwaltetes Objekt für Ihr Gerät

Verwenden Sie den create-managed-thing Befehl, um ein verwaltetes Objekt für Ihr Gerät zu erstellen. 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

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

    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 zu diesem AWS CLI Befehl.

Schritt 4: Fragen Sie das verwaltete Ding ab

Mit dem get-managed-thing Befehl können Sie überprüfen, ob ein verwaltetes Ding aktiviert ist.

Um eine verwaltete Sache abzufragen

  • Verwenden Sie den get-managed-thing Befehl, um zu überprüfen, ob der Bereitstellungsstatus des verwalteten Objekts auf ACTIVATED gesetzt ist.

    get-managed-thing-Beispiel

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

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

Schritt 5: Holen Sie sich die Funktionen für verwaltete Dinge

Sie können eine Liste der verfügbaren Aktionen für ein verwaltetes Ding anzeigen, indem Sie den verwendenget-managed-thing-capabiltiies.

Um die Funktionen eines Geräts abzurufen

  • Verwenden Sie den get-managed-thing-capabilities Befehl, um die Endpunkt-ID abzurufen. Beachten Sie auch die Liste der möglichen Aktionen.

    get-managed-thing-capabilities-Beispiel

    aws iot-managed-integrations get-managed-thing-capabilities \
  --identifier "DEVICE_MANAGED_THING_ID"

    Antwort:

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

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

Schritt 6: Senden Sie einen Befehl an das verwaltete Ding

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

Senden Sie mithilfe einer Umschaltaktion einen Befehl an das verwaltete Ding.

  • Verwenden Sie den send-managed-thing-command Befehl, um einen Befehl zum Umschalten 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 Zeichenfolge übergeben endpointId

    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: Überprüfen Sie den Status des verwalteten Dings

Überprüfen Sie den Status des verwalteten Dings, um zu überprüfen, ob die Umschaltaktion erfolgreich war.

Um den Gerätestatus eines verwalteten Objekts zu überprüfen

  • Verwenden Sie den get-managed-thing-state Befehl, um zu überprüfen, ob die Umschaltaktion erfolgreich war.

    get-managed-thing-state-Beispiel

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

    Antwort:

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

    Weitere Informationen zu diesem Befehl finden Sie in der get-managed-thing-stateBefehlsreferenz für verwaltete Integrationen AWS CLI.

Schritt 8: Entferne das verwaltete Ding von deinem Hub

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

Um ein verwaltetes Ding zu löschen

  • Verwenden Sie den delete-managed-thingBefehl, um ein verwaltetes Ding zu entfernen.

    delete-managed-thing-Beispiel

    aws iot-managed-integrations delete-managed-thing \
  --identifier MANAGED_THING_ID

    Weitere Informationen finden Sie unter dem delete-managed-thingBefehl in der AWS CLI Befehlsreferenz für verwaltete Integrationen.

    Anmerkung

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

    Anmerkung

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