IoT Platform ofrece la función de device shadow para almacenar en caché los estados que envían los dispositivos y los comandos que envía IoT Platform. Los dispositivos conectados reciben comandos directamente desde IoT Platform. Si un dispositivo está desconectado, solicite los comandos a IoT Platform una vez que vuelva a conectarse. En este tema se describe cómo configurar Link SDK for C para implementar la función de device shadow.
Requisitos previos
-
Cuando personalice el SDK, seleccione Device shadow.
Contexto
-
Un device shadow es un archivo JSON almacenado en IoT Platform. Este shadow almacena en caché las propiedades enviadas por el dispositivo (
reported) y las propiedades deseadas por las aplicaciones en la nube (desired).Para obtener más información, consulte Device shadow overview.
Para obtener más información sobre el formato JSON de los device shadows, consulte Device shadow JSON format.
Para obtener más información sobre el proceso de reenvío de datos de los device shadows, consulte Device shadow data stream.
sin encabezado
Funcionamiento
El dispositivo invoca las operaciones de API de Link SDK for C para enviar la información de estado a IoT Platform mediante MQTT. IoT Platform almacena esta información en caché como un device shadow. El dispositivo puede invocar las operaciones de API para consultar y eliminar propiedades del shadow.
A continuación se muestra el proceso. En este ejemplo se utiliza el archivo de código de muestra ./demos/shadow_basic_demo.c.
Para obtener más información sobre las operaciones de API específicas de device shadow, consulte aiot_shadow_api.h.
sin encabezado
Ejemplos
Para ver un ejemplo de código de la función de conexión MQTT, consulte Usage examples.
Para conocer los códigos de error relacionados con la función de conexión MQTT, consulte la sección aiot_shadow_api.hDescripciones de códigos de estado.