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 MQTT mensagens. 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 incluem a modificação das configurações do dispositivo, a transmissão de leituras do sensor ou o upload de registros. Os dispositivos podem então executar o comando e retornar 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, você deve usar o AWS-IoT namespace padrão. Ao usar esse namespace, você deve fornecer uma carga útil ao criar o comando. A carga será usada quando você executar o comando no dispositivo de destino. Se quiser criar um comando para AWS IoT FleetWise em vez disso, você deve usar o AWS-IoT-FleetWise namespace em vez disso. Para obter mais informações, consulte Comandos remotos no guia do AWS IoT FleetWise desenvolvedor para comandos.

Ao criar o comando, você deve fornecer uma carga que defina as ações que o dispositivo deve executar. A carga pode usar qualquer formato de sua escolha. Para garantir que o dispositivo possa ler e entender corretamente as informações que você está enviando, recomendamos que você especifique o tipo de formato da carga útil no comando. Se seus dispositivos usaremMQTT5, eles poderão seguir o MQTT padrão 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ê deve especificar um dispositivo de destino que receberá o comando e executará ações. Se o seu dispositivo foi registrado como uma coisa com AWS IoT, você pode usar o nome da coisa. Se seu dispositivo não tiver sido registrado, você poderá usar o ID do MQTT cliente em vez disso. O ID do cliente é um identificador exclusivo para seu dispositivo ou cliente definido no MQTT protocolo. Ele pode ser usado para conectar seu dispositivo AWS IoT a.

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) é entregue ao dispositivo de destino. Agora, um ID exclusivo de execução de comando é gerado para o destino. O dispositivo pode então executar o comando e relatar seu progresso para AWS IoT o. 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 se inscrito no 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 sucesso um recurso de comando, ele estará em um estado disponível. O comando agora pode ser usado para enviar uma execução de comando para o dispositivo.

Se você não pretende mais usar um comando, você pode marcá-lo como obsoleto. 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 tiver sido descontinuado por um período maior que o tempo limite máximo, o comando será excluído automaticamente. Essa ação é permanente e não pode ser desfeita. Por padrão, a duração máxima do tempo limite é de 12 horas. Se o comando não estiver obsoleto ou tiver sido preterido por um período menor que o tempo limite máximo, o comando estará em um estado de exclusão pendente. O comando será removido automaticamente da sua conta após o tempo limite máximo.