Gerencie comandos e eventos de dispositivos de IoT

Os comandos do dispositivo fornecem a capacidade de gerenciar remotamente um dispositivo físico, garantindo controle total sobre o dispositivo, além de realizar atualizações críticas de segurança, software e hardware. Com uma grande frota de dispositivos, saber quando um dispositivo executa um comando fornece supervisão sobre toda a implementação do dispositivo. Um comando do dispositivo ou uma atualização automática acionará uma mudança de estado do dispositivo, que por sua vez criará um novo evento do dispositivo. Esse evento do dispositivo acionará uma notificação enviada automaticamente para um destino gerenciado pelo cliente.

Comandos de dispositivos

Uma solicitação de comando é o comando que está sendo enviado ao dispositivo. Uma solicitação de comando inclui uma carga útil que especifica a ação a ser tomada, como acender a lâmpada. Para enviar um comando de dispositivo, a SendManagedThingCommand API é chamada em nome do usuário final por integrações gerenciadas e a solicitação de comando é enviada ao dispositivo.

A resposta a a SendManagedThingCommand é a traceId e você pode usá-la traceId para rastrear a entrega do comando e qualquer fluxo de trabalho de resposta ao comando relacionado sempre que possível.

Para obter mais informações sobre a operação SendManagedThingCommand da API, consulte SendManagedThingCommand.

Ação UpdateState

Para atualizar o estado de um dispositivo, como a hora em que uma luz se acende, use a UpdateState ação ao chamar a SendManagedThingCommand API. Forneça a propriedade do modelo de dados e o novo valor no qual você está atualizandoparameters. O exemplo abaixo ilustra uma solicitação de SendManagedThingCommand API atualizando o OnTime de uma lâmpada para5.

{
  "Endpoints": [
    {
      "endpointId": "1",
      "capabilities": [
        {
          "id": "matter.OnOff",
          "name": "On/Off",
          "version": "1",
          "actions": [
            {
              "name": "UpdateState",
              "parameters": {
                "OnTime": 5
              }
            }
          ]
        }
      ]
    }
  ]
}

Ação ReadState

Para obter o estado mais recente de um dispositivo, incluindo os valores atuais de todas as propriedades do modelo de dados, use a ReadState ação ao chamar a SendManagedThingCommand API. EmpropertiesToRead, você pode usar as seguintes opções:

• Forneça uma propriedade específica do modelo de dados para obter o valor mais recente, como OnOff determinar se uma luz está acesa ou apagada.

• Use o operador curinga (*) para ler todas as propriedades de estado do dispositivo para um recurso.

Os exemplos abaixo ilustram os dois cenários para uma solicitação de SendManagedThingCommand API usando a ReadState ação:

{
  "Endpoints": [
    {
      "endpointId": "1",
      "capabilities": [
        {
          "id": "aws.OnOff",
          "name": "On/Off",
          "version": "1",
          "actions": [
            {
              "name": "ReadState",
              "parameters": {
                "propertiesToRead": [ "OnOff" ]
              }
            }
          ]
        }
      ]
    }
  ]
}

{
  "Endpoints": [
    {
      "endpointId": "1",
      "capabilities": [
        {
          "id": "aws.OnOff",
          "name": "On/Off",
          "version": "1",
          "actions": [
            {
              "name": "ReadState",
              "parameters": {
                "propertiesToRead": [ "*" ]
              }
            }
          ]
        }
      ]
    }
  ]}

Eventos do dispositivo

Um evento de dispositivo inclui o estado atual do dispositivo. Isso pode significar que o dispositivo mudou de estado ou está relatando seu estado mesmo que o estado não tenha sido alterado. Ele inclui relatórios de propriedades e eventos definidos no modelo de dados. Um evento pode ser o término do ciclo da máquina de lavar ou o termostato atingir a temperatura desejada definida pelo usuário final.

Notificações de eventos do dispositivo

Um usuário final pode se inscrever em destinos específicos gerenciados pelo cliente que eles criam para atualizações sobre eventos específicos do dispositivo. Para criar um destino gerenciado pelo cliente, chame a CreateDestination API. Quando um evento do dispositivo é reportado às integrações gerenciadas pelo dispositivo, o destino gerenciado pelo cliente é notificado, caso exista.