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.
Verwenden Sie die benutzergeführte 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 der benutzergeführten 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_DISCOVERY-STATUS-Ereignisbenachrichtigungen.
Benutzergeführte Einrichtungsschritte
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-identifierHUB_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-idC2C_ASSOCIATION_ID
\ #For Custom aws iot-managed-thing start-device-discovery --discovery-type CUSTOM \ --controller-identifierHUB_MANAGED_THING_ID
\ --custom-protocol-detailNAME : 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 aufACTIVATED
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 iotmi 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 dendelete-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.