O IoT Platform oferece o recurso de device shadow para armazenar em cache os status enviados pelos dispositivos e os comandos enviados pelo IoT Platform. Dispositivos online podem receber comandos diretamente do IoT Platform. Se os dispositivos estiverem offline, eles poderão solicitar os comandos ao IoT Platform assim que retornarem ao estado online. Este artigo descreve como configurar o Link SDK for C para implementar o recurso de device shadow.
Pré-requisitos
-
Ao personalizar o SDK, na opção Device shadow.
Informações básicas
-
Um device shadow é um arquivo JSON armazenado no IoT Platform. O shadow armazena em cache as propriedades enviadas pelo dispositivo (
reported) e as propriedades desejadas pelas aplicações na nuvem (desired).Para mais informações, consulte Visão geral do device shadow.
Para obter detalhes sobre o formato JSON dos device shadows, consulte Formato JSON do device shadow.
Para entender melhor o processo de encaminhamento de dados dos device shadows, consulte Fluxo de dados do device shadow.
no heading
Funcionamento
Um dispositivo chama as operações da API do Link SDK for C para enviar informações de status ao IoT Platform via MQTT. O IoT Platform armazena essas informações em cache como um device shadow. O dispositivo também pode chamar as operações da API para consultar e excluir propriedades no shadow.
A figura a seguir ilustra o processo. Neste exemplo, utiliza-se o arquivo de código de amostra ./demos/shadow_basic_demo.c.
Para mais informações sobre as operações da API específicas para device shadow, consulte aiot_shadow_api.h.
no heading
Exemplos
Para visualizar um exemplo de código do recurso de conexão MQTT, consulte Exemplos de uso.
Para verificar os códigos de erro relacionados ao recurso de conexão MQTT, consulte as descrições de códigos de status em aiot_shadow_api.h.
Instruções
Leia o conteúdo em inglês para compreender O QUE precisa ser comunicado
Escreva o português brasileiro DO ZERO — esqueça a estrutura das frases em inglês
Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão
Tags xref (
<a data-tag="xref" ...>texto</a>) — preserve a tag INTEIRA com todos os atributos na ordem e caixa originais, traduza APENAS o texto visível entre > eAplique todas as regras específicas do idioma rigorosamente
Aplique as regras de stopwords com tolerância zero
Use o modo imperativo em passos numerados e listas de procedimentos
Garanta a consistência terminológica — mesmo termo = mesma tradução em todo o documento
Varie os inícios de frase em listas/tabelas — nenhum início repetido 3+ vezes
Retorne APENAS o documento markdown em português brasileiro, sem explicações