Gestione los comandos y eventos de los dispositivos de IoT

Los comandos del dispositivo permiten administrar de forma remota un dispositivo físico, lo que garantiza un control total sobre el dispositivo, además de realizar actualizaciones críticas de seguridad, software y hardware. Con una gran flota de dispositivos, saber cuándo un dispositivo ejecuta un comando permite supervisar toda la implementación del dispositivo. Un comando del dispositivo o una actualización automática activarán un cambio de estado del dispositivo, lo que a su vez creará un nuevo evento en el dispositivo. Este evento en el dispositivo activará una notificación que se enviará automáticamente a un destino gestionado por el cliente.

Comandos de dispositivos

Una solicitud de comando es el comando que se envía al dispositivo. Una solicitud de comando incluye una carga útil que especifica la acción que se debe realizar, como encender la bombilla. Para enviar un comando de dispositivo, las integraciones gestionadas llaman a la SendManagedThingCommand API en nombre del usuario final y la solicitud de comando se envía al dispositivo.

La respuesta a a SendManagedThingCommand es a traceId y se puede utilizar para realizar un seguimiento de la entrega de comandos y de cualquier flujo de trabajo relacionado con la respuesta traceId a los comandos siempre que sea posible.

Para obtener más información sobre el funcionamiento SendManagedThingCommand de la API, consulte SendManagedThingCommand.

Acción de UpdateState

Para actualizar el estado de un dispositivo, por ejemplo, la hora en que se enciende una luz, usa la UpdateState acción al llamar a la SendManagedThingCommand API. Indique la propiedad del modelo de datos y el nuevo valor con el que está actualizandoparameters. El siguiente ejemplo ilustra una solicitud OnTime de SendManagedThingCommand API que actualiza la bombilla a5.

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

Acción de ReadState

Para obtener el estado más reciente de un dispositivo, incluidos los valores actuales de todas las propiedades del modelo de datos, usa la ReadState acción cuando llames a la SendManagedThingCommand API. EnpropertiesToRead, puedes usar las siguientes opciones:

• Proporcione una propiedad específica del modelo de datos para obtener el valor más reciente, por ejemplo, OnOff para determinar si una luz está encendida o apagada.

• Utilice el operador comodín (*) para leer todas las propiedades del estado del dispositivo para obtener una capacidad.

Los siguientes ejemplos ilustran ambos escenarios para una solicitud de SendManagedThingCommand API mediante la ReadState acción:

{
  "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 del dispositivo

Un evento de dispositivo incluye el estado actual del dispositivo. Esto puede significar que el dispositivo ha cambiado de estado o que está informando de su estado aunque el estado no haya cambiado. Incluye informes de propiedades y eventos que se definen en el modelo de datos. Un evento podría ser que se haya completado el ciclo de la lavadora o que el termostato haya alcanzado la temperatura deseada establecida por el usuario final.

Notificaciones de eventos del dispositivo

Un usuario final puede suscribirse a destinos específicos gestionados por el cliente que cree para recibir actualizaciones sobre eventos específicos del dispositivo. Para crear un destino gestionado por el cliente, llama a la API. CreateDestination Cuando el dispositivo informa de un evento de dispositivo a las integraciones gestionadas, se notifica al destino gestionado por el cliente, si existe alguno.