Implementieren Sie die AWS.SendCommand Operation

Dieser AWS.SendCommand Vorgang ermöglicht es Managed Integrations for AWS IoT Device Management , Befehle, die vom Endbenutzer initiiert wurden, über den AWS Kunden an Ihren Ressourcenserver zu senden. Ihr Ressourcenserver unterstützt möglicherweise mehrere Gerätetypen, wobei jeder Typ sein eigenes Antwortmodell hat.

Die Befehlsausführung ist ein asynchroner Prozess, bei dem Managed Integrations for eine Anfrage zur Befehlsausführung mit a AWS IoT Device Management sendettraceId, die Ihr Connector in eine Befehlsantwort einbezieht, die AWS IoT Device Management über die API an Managed Integrations zurückgesendet wird. SendConnectorEvent Managed Integrations for AWS IoT Device Management erwartet, dass der Ressourcenserver eine Antwort zurückgibt, in der bestätigt wird, dass der Befehl empfangen wurde, aber nicht unbedingt angibt, dass der Befehl ausgeführt wurde.

Arbeitsablauf für die Ausführung von Gerätebefehlen

Das folgende Diagramm veranschaulicht den Ablauf der Befehlsausführung anhand eines Beispiels, bei dem der Endbenutzer versucht, die Beleuchtung seines Hauses einzuschalten:

Workflow-Schritte

Anforderungen an den C2C-Anschluss für die Ausführung von Gerätebefehlen

In der folgenden Liste sind die Anforderungen für Ihren C2C-Anschluss aufgeführt, um eine erfolgreiche Ausführung von Gerätebefehlen zu ermöglichen.

Prozess der Befehlsausführung

Schritt 1: Managed Integrations sendet den Befehl an den Connector

Senden Sie je nach Autorisierungstyp eine POST-Anfrage mit einer der folgenden Payloads:

OAuth 2.0-Anfrage:

/Send-Command
{
     "header": {
          "auth": {                 
              "token": "ashriu32yr97feqy7afsaf",  
              "type": "OAuth2.0"
          }
     },
     "payload": {
          "operationName": "AWS.SendCommand",
          "operationVersion": "1.0",
          "connectorId": "Your-Connector-Id",
          "connectorDeviceId": "Your_Device_Id",
          "traceId": "traceId-3241u78123419",
          "endpoints": [{
              "id": "1",    
              "clusters": [{
                  "id": "0x0202",
                  "commands": [{
                      "0xff01": 
                          {
                              "0x0000": "3”
                  		}
                  }]
              }]
          }]
     }
  }

Allgemeine Autorisierungsanfrage:

/Send-Command
{
     "header": {
          "auth": {
              "secretsManager": {
                  "arn": "string",
                  "versionId": "string"
              },
              "type": "GeneralAuthorization"
          }
     },
     "payload": {
          "operationName": "AWS.SendCommand",
          "operationVersion": "1.0",
          "connectorId": "Your-Connector-Id",
          "connectorDeviceId": "Your_Device_Id",
          "traceId": "traceId-3241u78123419",
          "endpoints": [{
              "id": "1",    
              "clusters": [{
                  "id": "0x0202",
                  "commands": [{
                      "0xff01": 
                          {
                              "0x0000": "3"
                  		}
                  }]
              }]
          }]
     }
}

Schritt 2: ACK-Befehl für den C2C-Anschluss

{
     "header":{
          "responseCode":200
     },
     "payload":{
          "responseMessage": "Successfully received send-command request for connector 'Your-Connector-Id' and connector-device-id 'Your_Device_Id'" 
     }
  }

Schritt 3: Der Connector sendet ein Befehlsantwortereignis für das Gerät

AWS-API: /SendConnectorEvent
URI: POST /connector-event/{Your-Connector-Id}

{
   "UserId": "End-User-Id",
   "Operation": "DEVICE_COMMAND_RESPONSE",
   "OperationVersion": "1.0",
   "StatusCode": 200,
   "Message": “Example message”,
   "ConnectorDeviceId": "Your_Device_Id",
   "TraceId": "traceId-3241u78123419",
   "MatterEndpoint": {
        "id": "1",    
        "clusters": [{
            "id": "0x0202",
            "attributes": [
                {
                    "0x0000": “3”
                }
            ],
            "commands": [
                "0xff01": 
                {
                    "0x0000": "3”
                }            
 		]
        }]
    }
}

In der Anfrage sind die „Endpunkte“ des Dolmetscherthemas enthalten AWS.SendCommand

Verwaltete Integrationen verwenden die bei der Geräteerkennung gemeldeten Gerätefunktionen, um zu ermitteln, welche Befehle ein Gerät annehmen kann. Jede Gerätefunktion wird durch AWS Implementierungen des Matter Data Model modelliert. Somit werden alle eingehenden Befehle aus dem Feld „Befehle“ innerhalb eines bestimmten Clusters abgeleitet. Es liegt in der Verantwortung Ihres Konnektors, das Feld „Endpunkte“ zu analysieren, den entsprechenden Matter-Befehl zu ermitteln und ihn so zu übersetzen, dass der richtige Befehl das Gerät erreicht. In der Regel bedeutet dies, das Matter-Datenmodell in die entsprechenden API-Anfragen zu übersetzen.

Nachdem der Befehl ausgeführt wurde, ermittelt Ihr Konnektor, welche `Attribute`, die durch die AWS Implementierungen des Matter-Datenmodells definiert wurden, sich dadurch geändert haben. Diese Änderungen werden dann über API-DEVICE_COMMAND_RESPONSE-Ereignisse, die mit der API gesendet werden, an verwaltete Integrationen für AWS IoT Device Management gemeldet. SendConnectorEvent

Betrachten Sie das Feld `endpoints`, das in der folgenden Beispielnutzlast enthalten ist: AWS.SendCommand

          "endpoints": [{
              "id": "1",    
              "clusters": [{
                  "id": "0x0202",
                  "commands": [{
                      "0xff01": 
                          {
                              "0x0000": "3”
                  		}
                  }]
              }]
          }]

Managed Integrations hat zwei „benutzerdefinierte“ Befehlstypen definiert, die nicht unbedingt durch AWS Implementierungen des Matterdatenmodells definiert sind: Die Befehle ReadState und UpdateState . Um vom Thema definierte Clusterattribute abzurufen und festzulegen, sendet Managed Integrations Ihrem Connector eine AWS.SendCommand Anfrage mit Befehls-IDs, die sich auf UpdateState (id: 0xff01) oder ReadState (id: 0xff02) beziehen, mit entsprechenden Attributparametern, die entweder aktualisiert oder gelesen werden müssen. Diese Befehle können für JEDEN Gerätetyp für Attribute aufgerufen werden, die in der entsprechenden Implementierung des Matter-Datenmodells als veränderbar (aktualisierbar) oder abrufbar (lesbar) festgelegt sind. AWS