View a markdown version of this page

Benutzergeführte Einrichtung zur Einbindung und Bedienung von Geräten - Verwaltete Integrationen für AWS IoT Device Management
VoraussetzungenVoraussetzung: Aktivieren Sie den Pairing-Modus auf Ihrem Z Wave-GerätSchritt 1: Starten Sie die GeräteerkennungSchritt 2: Fragen Sie die Discovery-Job-ID abSchritt 3: Erstellen Sie ein verwaltetes Objekt für Ihr GerätSchritt 4: Fragen Sie das verwaltete Ding abSchritt 5: Holen Sie sich die Funktionen für verwaltete DingeSchritt 6: Senden Sie einen Befehl an das verwaltete DingSchritt 7: Überprüfen Sie den Status des verwalteten ObjektsSchritt 8: Entfernen Sie das verwaltete Ding von Ihrem Hub

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 Managed Integrations Hub 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 in den Anweisungen des Geräts nach, 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 Befehl start-device-discovery, 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 finden Sie in der Start-Device-Discovery-API in der Managed Integrations Command Reference. 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 Befehl list-discovered-devices, 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
    }
]

Geben Sie Marke und Modell für die erkannten Geräte ein

Bei der Geräteerkennung können erkannte Geräte optional Marken- und Modellinformationen über den Matter Basic Information Cluster melden. Diese Werte werden dann in den ListManagedThingsAntworten ListDiscoveredDevicesund zurückgegeben.

Melden Sie den Basisinformations-Cluster (Cluster0x0028) auf dem Root-Endpunkt des Geräts (0) und ordnen Sie Folgendes zu:

  • VendorName(Attribut0x0001) → Brand

  • ProductName(Attribut0x0003) → Model

Das folgende Beispiel zeigt, wie der Basisinformations-Cluster auf dem Root-Endpunkt gemeldet wird:

"endpoints": [{
    "id": "0",
    "clusters": [{
        "id": "0x0028",
        "attributes": [{
            "id": "0x0001",
            "value": "ExampleBrand"
        }, {
            "id": "0x0003",
            "value": "ExampleModel-X1"
        }]
    }]
}]

Beide Werte sind Zeichenketten mit einer maximalen Länge von 32 Zeichen. Wenn der Basisinformations-Cluster oder eines der Attribute nicht gemeldet wird, wird das entsprechende Feld in der Antwort weggelassen.

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 unter dem Befehl create-managed-thing in der Befehlsreferenz für verwaltete Integrationen. AWS CLI

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. Weitere Informationen zum Bereitstellungsstatus finden Sie unter Gerätebereitstellung.

    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 Befehl get-managed-thing 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 Befehl get-managed-thing-capabilities in der Befehlsreferenz für verwaltete Integrationen. AWS CLI

Schritt 6: Senden Sie einen Befehl an das verwaltete Ding

Sie können den Befehl send-managed-thing-command verwenden, um einen Toggle-Action-Befehl 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 Befehl send-managed-thing-command in der Managed Integrations Command Reference. AWS CLI

Schritt 7: Überprüfen Sie den Status des verwalteten Objekts

Ü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 finden Sie unter dem Befehl get-managed-thing-state in der Befehlsreferenz für verwaltete Integrationen. AWS CLI

Schritt 8: 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 Befehl delete-managed-thing, 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 Befehl delete-managed-thing in der Befehlsreferenz für verwaltete Integrationen. AWS CLI

    Anmerkung

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

    Anmerkung

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