Le Link SDK est un kit de développement logiciel côté appareil fourni par IoT Platform. Ce SDK simplifie le développement et permet aux appareils de se connecter à IoT Platform. Une fois le SDK obtenu, les fabricants d'appareils peuvent porter le code selon leurs besoins métier. Ils intègrent ainsi le Link SDK dans leurs appareils et connectent ces derniers à IoT Platform.
Prérequis
Avant de développer avec le SDK, effectuez les opérations requises dans la console IoT Platform pour obtenir les informations nécessaires sur les appareils et les topics. Pour plus d'informations, consultez la rubrique Guide de connexion des appareils.
Contexte
De nombreux appareils hétérogènes peuvent se connecter à IoT Platform. IoT Platform met à disposition le Link SDK pour le développement côté appareil, ainsi que le protocole standard Alink.
Pour savoir comment utiliser le protocole Alink, consultez la rubrique Configuration des appareils basée sur le protocole Alink.
Nous vous recommandons d'utiliser le Link SDK pour développer rapidement vos appareils et les connecter à IoT Platform. Le schéma suivant décrit le processus de développement d'un appareil à l'aide du Link SDK.
Pour plus d'informations sur les termes associés, consultez la rubrique Termes.
Intégration du Link SDK
La méthode d'intégration du Link SDK varie selon le type d'appareil :
Appareils IP : appareils prenant en charge le protocole TCP/IP, tels que les appareils Wi-Fi. Ces appareils s'intègrent directement au Link SDK.
Appareils non IP : appareils ne prenant pas en charge le protocole TCP/IP, tels que les appareils ZigBee, BT, KNX et ModBus. Ces appareils ne peuvent se connecter à IoT Platform qu'en passant par une passerelle intégrant le Link SDK. Vous pouvez configurer une méthode de communication personnalisée entre la passerelle et ses sous-appareils. Pour savoir comment configurer le Link SDK for C afin de connecter un sous-appareil à IoT Platform, consultez la rubrique Présentation des passerelles et des sous-appareils.
Sélection d'un type de Link SDK
Les Link SDK sont disponibles pour plusieurs langages de programmation, notamment C, Java, Python, Node.js, Android et iOS. Sélectionnez le SDK correspondant au langage utilisé par votre produit.
|
SDK |
Scénario |
Références de configuration |
Exemple |
|
Link SDK for C |
Appareils embarqués aux ressources limitées, programmés en C |
||
|
Link SDK for Android |
Appareils Android |
||
|
Link SDK for Python |
Le SDK convient aux appareils programmés en Python, mais n'est pas adapté au développement d'applications légères en Python. |
||
|
Link SDK for Java |
Appareils programmés en Java |
||
|
Link SDK for iOS |
Appareils iOS |
Parmi les bibliothèques MQTT open source courantes, on retrouve paho.mqtt.c, paho.mqtt.embedded-c, paho.mqtt.android et paho.mqtt.python.
Portage du Link SDK
Vous devez porter le Link SDK for C sur les appareils embarqués. Les autres types de Link SDK s'intègrent directement aux appareils.
Vous pouvez personnaliser le Link SDK for C en fonction des exigences des appareils que vous souhaitez connecter à IoT Platform. Pour savoir comment configurer le Link SDK for C dans la console IoT Platform, consultez la rubrique Obtention du Link SDK for C.
Le Link SDK for C est compilé en C99. L'implémentation des interfaces système dans le SDK varie selon l'environnement matériel. Il peut être nécessaire de porter le SDK pour l'adapter à votre environnement. Pour plus d'informations sur le portage du SDK, consultez la rubrique Portage du Link SDK for C.
Par défaut, le Link SDK for C utilise l'interface POSIX (Portable Operating System Interface) sous Linux. Vous pouvez intégrer directement le SDK aux appareils Linux sans avoir besoin de le porter.
Environnement matériel | Système d'exploitation | Description | Références |
PC ou système sur puce (SoC) | Linux | Une compilation croisée est requise pour les appareils embarqués. | Intégrer un SDK dans un environnement de développement Linux |
Windows | Aucune implémentation exemple n'est disponible. Vous devez porter le SDK. | ||
Module OpenCPU | Système d'exploitation temps réel (RTOS) | Vous pouvez intégrer le Link SDK en vous basant sur le framework de développement IoT Espressif (ESP-IDF). |
Configuration des fonctionnalités de connexion et de messagerie lors du développement des appareils
IoT Platform prend en charge plusieurs protocoles et méthodes de vérification des appareils, permettant à divers types d'appareils de se connecter. Le tableau suivant présente les solutions de connexion des appareils.
Fonctionnalité | Description | Références |
Connexion multi-protocole | IoT Platform permet la connexion des appareils via des protocoles tels que MQTT (Message Queuing Telemetry Transport), CoAP (Constrained Application Protocol) et HTTP. La plupart des appareils utilisent le protocole MQTT. | Connecter un appareil à IoT Platform à l'aide d'un protocole |
Vérification par certificat unique par appareil | Chaque appareil est vérifié à l'aide d'identifiants distincts. | |
Vérification par certificat unique par produit | Les mêmes identifiants sont utilisés pour vérifier les appareils appartenant au même produit. Cela simplifie les opérations de gravure des identifiants sur les appareils. Remarque La vérification par certificat unique par appareil et la vérification par certificat unique par produit peuvent être utilisées conjointement. La vérification par certificat unique par produit permet d'obtenir les identifiants spécifiques à l'appareil lors de sa première connexion à IoT Platform, puis la vérification par certificat unique par appareil peut prendre le relais. | |
Vérification basée sur le certificat X.509 | Chaque appareil possède un certificat distinct, ce qui permet de le vérifier lors de l'utilisation du protocole TLS (Transport Layer Security). Cette méthode améliore la sécurité. | |
Passerelles et sous-appareils | Une passerelle sert de proxy pour connecter ses sous-appareils à IoT Platform. Une fois qu'un sous-appareil est connecté à IoT Platform, il peut utiliser ses propres topics pour communiquer avec la plateforme. |
Configuration des fonctionnalités métier lors du développement des appareils
Une fois l'appareil connecté à IoT Platform, il peut envoyer et recevoir des messages via la plateforme. L'appareil peut soumettre des données métier à IoT Platform en utilisant l'une des méthodes suivantes :
Topics personnalisés : vous pouvez définir des topics personnalisés ainsi que la charge utile des messages. Pour plus d'informations, consultez la rubrique Utilisation de topics personnalisés pour la communication.
-
Modèles TSL (Thing Specification Language) : vous pouvez définir, soumettre et délivrer les propriétés, événements et services de l'appareil en vous basant sur les modèles TSL. Pour plus d'informations, consultez les rubriques Présentation des modèles TSL et Communication des appareils à l'aide des modèles TSL. Le modèle TSL constitue la fonctionnalité clé d'IoT Platform et offre les avantages suivants :
Stockage structuré des données : simplifie le processus ultérieur de développement des données.
Mise en cache de l'état et des données de l'appareil (device shadow) : l'appareil ou le serveur peut interroger l'état et les données de l'appareil à tout moment.
Visualisation des données : vous pouvez afficher les données de l'appareil dans la console IoT Platform.
Débogage en ligne : vous pouvez déboguer les appareils en ligne.
Configuration des fonctionnalités d'exploitation et de maintenance (O&M) lors du développement des appareils
Si vous envisagez de produire vos appareils en série après avoir configuré leurs fonctionnalités métier, nous vous recommandons de paramétrer les fonctionnalités d'exploitation et de maintenance (O&M) pour faciliter les itérations, la configuration et le dépannage ultérieurs des appareils. Le tableau suivant décrit les fonctionnalités O&M fournies par IoT Platform.
|
Fonctionnalité |
Description |
Références |
|
Mise à jour OTA (Over-the-Air) |
Prend en charge la mise à niveau à distance du firmware des appareils. |
|
|
Reporting des journaux |
Permet aux appareils de soumettre des journaux à IoT Platform. Vous pouvez résoudre les problèmes des appareils en vous basant sur ces journaux. |
|
|
Configuration à distance |
Prend en charge la configuration à distance des appareils. |
|
|
Service NTP (Network Time Protocol) |
Synchronise l'heure du serveur avec les appareils. |