Implemente a AWS.SendCommand operação

A AWS.SendCommand operação permite que as integrações gerenciadas enviem comandos iniciados pelo usuário final por meio do AWS cliente para seu servidor de recursos. AWS IoT Device Management Seu servidor de recursos pode oferecer suporte a vários tipos de dispositivos, onde cada tipo tem seu próprio modelo de resposta.

A execução de comandos é um processo assíncrono em que o Managed Integrations for AWS IoT Device Management envia uma solicitação de execução de comando com umtraceId, que seu conector incluirá em uma resposta de comando enviada de volta às Integrações Gerenciadas por meio da API. AWS IoT Device Management SendConnectorEvent O Managed Integrations for AWS IoT Device Management espera que o servidor de recursos retorne uma resposta confirmando que o comando foi recebido, mas não necessariamente indicando que o comando foi executado.

Fluxo de trabalho de execução de comandos do

O diagrama a seguir ilustra o fluxo de execução do comando com um exemplo em que o usuário final tenta acender as luzes de sua casa:

Etapas do fluxo de trabalho

Requisitos do conector C2C para execução de comandos de dispositivos

A lista a seguir descreve os requisitos do conector C2C para facilitar a execução bem-sucedida do comando do dispositivo.

Processo de execução de comandos

Etapa 1: Integrações gerenciadas enviam comando para o conector

Envie uma solicitação POST com uma das seguintes cargas, dependendo do tipo de autorização:

Solicitação do 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”
                  		}
                  }]
              }]
          }]
     }
  }

Solicitação de autorização geral:

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

Etapa 2: Comando ACK do conector C2C

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

Etapa 3: O conector envia o evento de resposta ao comando do 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”
                }            
 		]
        }]
    }
}

Interpretação dos “pontos finais” do assunto incluídos na solicitação AWS.SendCommand

As integrações gerenciadas usarão os recursos do dispositivo relatados durante a descoberta do dispositivo para determinar quais comandos um dispositivo pode aceitar. Cada capacidade do dispositivo é modelada por meio de AWS implementações do Matter Data Model; portanto, todos os comandos recebidos serão derivados do campo `comandos` em um determinado cluster. É responsabilidade do seu conector analisar o campo `endpoints`, determinar o comando Matter correspondente e traduzi-lo de forma que o comando correto chegue ao dispositivo. Normalmente, isso significa traduzir o modelo de dados do Matter nas solicitações de API relacionadas.

Depois que o comando for executado, seu conector determina quais `atributos` definidos pelas AWS implementações do Matter Data Model foram alterados como resultado. Essas alterações são então reportadas às integrações gerenciadas do AWS IoT Device Management por meio de eventos da API DEVICE_COMMAND_RESPONSE enviados com a API. SendConnectorEvent

Considere o campo `endpoints` incluído no seguinte exemplo de carga útil: AWS.SendCommand

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

A Managed Integrations definiu dois tipos de comando “personalizados” que não são estritamente definidos pelas AWS implementações do Matter Data Model: os comandos ReadState e. UpdateState Para obter e definir os atributos de cluster definidos pelo Matter, as Integrações Gerenciadas enviarão ao seu conector uma AWS.SendCommand solicitação com IDs de comando pertencentes a UpdateState (id: 0xff01) ou ReadState (id: 0xff02), com os parâmetros correspondentes dos atributos que devem ser atualizados ou lidos. Esses comandos podem ser invocados para QUALQUER tipo de dispositivo para atributos definidos como mutáveis (atualizáveis) ou recuperáveis (legíveis) a partir da AWS implementação correspondente do Matter Data Model.