Conceitos e status de comandos

Comandos são instruções enviadas da nuvem para seus dispositivos de IoT. Essas instruções (carga útil do comando) são enviadas aos dispositivos como mensagens do MQTT. Depois que os dispositivos receberem a carga útil do comando, eles poderão processar as instruções para realizar a ação correspondente. Exemplos dessas ações são a modificação das configurações do dispositivo, a transmissão de leituras do sensor ou o upload de logs. Os dispositivos podem então executar o comando e exibir o resultado para a nuvem. Isso permite monitorar e controlar remotamente os dispositivos conectados.

Ao usar o recurso de comandos, você pode especificar o namespace para o comando. Quando quiser criar um comando no AWS IoT Device Management, use o namespace padrão da AWS-IoT. Ao usar esse namespace, você deve fornecer uma carga útil ao criar o comando. A carga útil será usada quando você executar o comando no dispositivo de destino. Se, em vez disso, quiser criar um comando para AWS IoT FleetWise, use o namespace AWS-IoT-FleetWise. Para acessar mais informações, consulte Remote commands no Guia do desenvolvedor do AWS IoT FleetWise para comandos.

Ao criar o comando, você deve fornecer uma carga útil que defina as ações a serem realizadas pelo dispositivo. A carga útil pode usar qualquer formato de sua escolha. Para garantir que o dispositivo possa ler e entender corretamente as informações enviadas, recomendamos especificar o tipo de formato da carga útil no comando. Se seus dispositivos usam o MQTT5, eles podem seguir o padrão MQTT para identificar o formato da carga útil. Um indicador de formato para JSON ou CBOR estará disponível no tópico de solicitação de comandos.

Quando quiser executar o comando, você deverá especificar um dispositivo de destino que vai recebê-lo e realizar as ações. Se o seu dispositivo tiver sido registrado como uma coisa com AWS IoT, você pode usar o nome da coisa. Se o dispositivo não tiver sido registrado, você poderá usar o ID do cliente do MQTT. O ID do cliente é um identificador exclusivo para o dispositivo ou o cliente definido no protocolo MQTT. Ele pode ser usado para conectar seu dispositivo à AWS IoT.

A execução de um comando é uma instância de um comando executado no dispositivo de destino. Quando você inicia a execução, o comando (carga útil) é entregue ao dispositivo de destino. Um ID exclusivo de execução de comando agora é gerado para o destino. O dispositivo pode então executar o comando e relatar seu andamento na AWS IoT. A lógica do lado do dispositivo determina como o comando será executado e como o status será publicado nos tópicos reservados.

Antes de executar o comando, seu dispositivo deve ter assinado o tópico de solicitação de comandos. Quando você envia a solicitação à nuvem para executar o comando, a carga útil será enviada ao dispositivo no tópico de solicitação de comandos. Depois que o dispositivo executa o comando, ele pode publicar o resultado e o status da execução no tópico de resposta do comando. Para obter mais informações, consulte Tópicos de comandos.

Depois de criar com êxito um recurso de comando, ele estará em um estado disponível. O comando agora pode ser usado para enviar uma execução de comando ao dispositivo.

Se você não pretende mais usar um comando, pode marcá-lo como suspenso. Nesse estado, você não pode enviar nenhuma nova execução do comando para seus dispositivos. Todas as execuções pendentes que já tenham sido iniciadas continuarão sendo executadas no dispositivo até serem concluídas. Para enviar novas execuções, você deve restaurar o comando para que ele fique disponível.

Quando você marca um comando para exclusão, se o comando permanecer suspenso por um período maior que o tempo limite máximo, ele será excluído automaticamente. Essa ação é permanente, portanto, não pode ser desfeita. Por padrão, o tempo limite máximo é de 12 horas. Se o comando não for suspenso ou permanecer suspenso por um período menor que o valor do tempo limite máximo, ele entrará no estado de exclusão pendente. O comando será removido automaticamente da sua conta após o tempo limite máximo.