Message Queuing Telemetry Transport (MQTT) est un protocole de messagerie asynchrone et léger basé sur TCP/IP qui utilise un modèle publication/abonnement. Le Link SDK pour C implémente MQTT 3.1.1 et gère la connexion, le maintien de l'activité (keep-alive) ainsi que la livraison des messages. Votre application n'a donc qu'à appeler les opérations d'API du SDK pour connecter les appareils à IoT Platform.
Prérequis
-
Lorsque vous personnalisez un SDK, définissez le paramètre Connect to IoT platform protocol sur MQTT 3.1.1 dans la page SDK customization page.
-
Obtenez les informations d'authentification de l'appareil. Utilisez l'une des méthodes suivantes :
Authentifiez l'appareil à l'aide d'un certificat d'appareil émis par IoT Platform. Consultez la rubrique Obtenir les informations de vérification de l'appareil.
Authentifiez l'appareil à l'aide d'identifiants personnalisés. Consultez la rubrique Ajouter des appareils à un produit de passerelle MQTT.
Contexte
Pour les appareils se connectant directement à IoT Platform via MQTT (sans passerelle cloud), consultez la rubrique Protocole MQTT.
Pour les appareils de passerelle cloud se connectant via MQTT, consultez la rubrique Passerelles MQTT.
Fonctionnement
Le Link SDK pour C est conçu pour les appareils aux ressources limitées exécutant des applications en C. Le SDK gère l'intégralité du cycle de vie de la connexion MQTT — authentification, maintien de l'activité et reconnexion — de sorte que le code de votre application n'a qu'à appeler les opérations d'API du SDK pour publier des messages et s'abonner à des topics.
La figure suivante illustre la manière dont une application côté appareil se connecte à IoT Platform à l'aide du Link SDK pour C.
Pour obtenir la liste complète des opérations d'API de connexion MQTT, consultez aiot_mqtt_api.h.
Exemples
Pour des exemples de code complets montrant comment établir une connexion MQTT, consultez la rubrique Exemple.
Pour une référence des codes d'erreur du SDK renvoyés lors de la connexion, consultez la rubrique Codes d'erreur courants.