O Message Queuing Telemetry Transport (MQTT) é um protocolo de mensagens assíncrono e leve, construído sobre TCP/IP, que utiliza o modelo de publicação/assinatura. O Link SDK for C implementa o MQTT 3.1.1 e gerencia a conexão, o keep-alive e a entrega de mensagens. Dessa forma, sua aplicação precisa apenas chamar as operações de API do SDK para conectar dispositivos ao IoT Platform.
Pré-requisitos
-
Ao personalizar um SDK, defina o parâmetro Connect to IoT platform protocol como MQTT 3.1.1 na SDK customization page.
-
As credenciais de autenticação do dispositivo foram obtidas. Utilize um dos métodos a seguir:
Autentique o dispositivo com um certificado emitido pelo IoT Platform. Consulte Obter informações de verificação do dispositivo.
Autentique o dispositivo usando credenciais personalizadas. Consulte Adicionar dispositivos a um produto de gateway MQTT.
Contexto
Para dispositivos que se conectam diretamente ao IoT Platform via MQTT (sem gateway de nuvem), consulte Protocolo MQTT.
Para dispositivos de gateway de nuvem que se conectam via MQTT, consulte Gateways MQTT.
Funcionamento
O Link SDK for C foi projetado para dispositivos com recursos limitados que executam aplicações em C. O SDK gerencia todo o ciclo de vida da conexão MQTT — autenticação, keep-alive e reconexão. Assim, o código da sua aplicação só precisa invocar as operações de API do SDK para publicar mensagens e assinar tópicos.
A figura a seguir ilustra como uma aplicação no lado do dispositivo se conecta ao IoT Platform usando o Link SDK for C.
Para a lista completa de operações de API de conexão MQTT, consulte aiot_mqtt_api.h.
Exemplos
Para exemplos de código ponta a ponta sobre como estabelecer uma conexão MQTT, consulte Exemplo.
Para uma referência dos códigos de erro do SDK retornados durante a conexão, consulte Códigos de erro comuns.