Implementar la AWS.SendCommand operación

La AWS.SendCommand operación permite a Managed Integrations AWS IoT Device Management enviar los comandos iniciados por el usuario final a través del AWS cliente a su servidor de recursos. El servidor de recursos puede admitir varios tipos de dispositivos, cada uno de los cuales tiene su propio modelo de respuesta.

La ejecución de comandos es un proceso asíncrono en el que Managed Integrations for AWS IoT Device Management envía una solicitud de ejecución de comandos con untraceId, que el conector incluirá en una respuesta de comando que se devolverá a Managed Integrations a través de la API. AWS IoT Device Management SendConnectorEvent Managed Integrations for AWS IoT Device Management espera que el servidor de recursos devuelva una respuesta confirmando que se ha recibido el comando, pero no que indique necesariamente que se ha ejecutado.

Flujo de trabajo de ejecución de comandos

El siguiente diagrama ilustra el flujo de ejecución de comandos con un ejemplo en el que el usuario final intenta encender las luces de su casa:

Pasos del flujo de trabajo

Requisitos del conector C2C para la ejecución de comandos del dispositivo

La siguiente lista describe los requisitos de su conector C2C para facilitar la ejecución correcta de los comandos del dispositivo.

Proceso de ejecución de comandos

Paso 1: Managed Integrations envía el comando al conector

Envíe una solicitud POST con una de las siguientes cargas útiles, según el tipo de autorización:

Solicitud de OAuth 2.0:

/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”
                  		}
                  }]
              }]
          }]
     }
  }

Solicitud de autorización general:

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

Paso 2: Comando ACK del conector C2C

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

Paso 3: El conector envía el evento de respuesta al comando del dispositivo

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”
                }            
 		]
        }]
    }
}

El asunto de interpretación («puntos finales») está incluido en la solicitud AWS.SendCommand

Las integraciones gestionadas utilizarán las capacidades del dispositivo informadas durante la detección del dispositivo para determinar qué comandos puede aceptar un dispositivo. Las capacidades de cada dispositivo se modelan mediante AWS implementaciones del modelo de datos de materia; por lo tanto, todos los comandos entrantes se derivarán del campo «comandos» de un clúster determinado. Es responsabilidad del conector analizar el campo «puntos finales», determinar el comando Matter correspondiente y traducirlo de forma que el comando correcto llegue al dispositivo. Normalmente, esto implica traducir el modelo de datos de Matter a las solicitudes de API relacionadas.

Una vez ejecutado el comando, el conector determina qué «atributos» definidos en AWS las implementaciones del modelo de datos de Matter han cambiado en consecuencia. A continuación, estos cambios se notifican a las integraciones gestionadas de AWS IoT Device Management mediante los eventos DEVICE_COMMAND_RESPONSE de la API enviados con la API. SendConnectorEvent

Considere el campo «puntos finales» incluido en la siguiente carga útil de ejemplo: AWS.SendCommand

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

Managed Integrations ha definido dos tipos de comandos «personalizados» que AWS las implementaciones del Matter Data Model no definen estrictamente: los comandos ReadState y UpdateState . Para obtener y establecer los atributos del clúster definidos por Matter, Managed Integrations enviará al conector una AWS.SendCommand solicitud con los identificadores de comando correspondientes a UpdateState (id: 0xff01) o ReadState (id: 0xff02), con los parámetros correspondientes de los atributos que deben actualizarse o leerse. Estos comandos se pueden invocar en CUALQUIER tipo de dispositivo para los atributos que estén configurados como mutables (actualizables) o recuperables (legibles) a partir de la implementación correspondiente del modelo de datos de Matter. AWS