Tutoriel : Utilisation du Kit SDK des appareils AWS IoT pour Embedded C

Cette section décrit comment exécuter le Kit SDK des appareils AWS IoT pour Embedded C.

Étape 1 : installez le Kit SDK des appareils AWS IoT pour Embedded C

Kit SDK des appareils AWS IoT pour Embedded C Il est généralement destiné aux appareils aux ressources limitées qui nécessitent un environnement d'exécution optimisé en langage C. Vous pouvez l'utiliser SDK sur n'importe quel système d'exploitation et l'héberger sur n'importe quel type de processeur (par exemple, MCUs etMPUs). Si vous disposez de davantage de mémoire et de ressources de traitement, nous vous recommandons d'utiliser un AWS IoT appareil ou un appareil mobile de niveau supérieur SDKs (par exemple, C++ JavaScript, Java et Python).

En général, Kit SDK des appareils AWS IoT pour Embedded C il est destiné aux systèmes utilisant MCUs ou bas de gamme exécutant MPUs des systèmes d'exploitation intégrés. Pour l'exemple de programmation présenté dans cette section, nous supposons que votre appareil utilise Linux.

Exemple

1. Kit SDK des appareils AWS IoT pour Embedded C Téléchargez-le sur votre appareil depuis GitHub.

   git clone https://github.com/aws/aws-iot-device-sdk-embedded-c.git --recurse-submodules

   Cette opération crée un répertoire nommé aws-iot-device-sdk-embedded-c dans le répertoire actuel.

2. Accédez à ce répertoire et consultez la dernière version. Consultez github.com/aws/ aws-iot-device-sdk -Embedded-c/tags pour la dernière balise de version.

   cd aws-iot-device-sdk-embedded-c
   git checkout latest-release-tag

3. Installez Open SSL version 1.1.0 ou ultérieure. Les bibliothèques de SSL développement ouvertes sont généralement appelées « libssl-dev » ou « openssl-devel » lorsqu'elles sont installées via un gestionnaire de paquets.

   sudo apt-get install libssl-dev

Étape 2 : Configurer l'exemple d'application

Kit SDK des appareils AWS IoT pour Embedded C Il inclut des exemples d'applications que vous pouvez essayer. Pour des raisons de simplicité, ce didacticiel utilise l'mqtt_demo_mutual_authapplication, qui montre comment se connecter au courtier de AWS IoT Core messages, s'abonner et publier dans MQTT des rubriques.

1. Copiez le certificat et la clé privée que vous avez créés dans Commencer à utiliser les AWS IoT Core didacticiels dans le répertoire build/bin/certificates.

   Note

   Les certificats d'autorité de certification racine et d'appareil sont susceptibles d'expirer ou d'être révoqués. Si ces certificats expirent ou sont révoqués, vous devez copier un nouveau certificat d'autorité de certification ou une nouvelle clé privée et un nouveau certificat d'appareil sur votre appareil.

2. Vous devez configurer l'exemple avec votre point de AWS IoT Core terminaison personnel, votre clé privée, votre certificat et votre certificat CA racine. Accédez au répertoire aws-iot-device-sdk-embedded-c/demos/mqtt/mqtt_demo_mutual_auth.

   Si vous l'avez AWS CLI installé, vous pouvez utiliser cette commande pour trouver le point de terminaison de votre compteURL.

   aws iot describe-endpoint --endpoint-type iot:Data-ATS

   Si ce n'est pas le AWS CLI cas, ouvrez votre AWS IoT console. Dans le panneau de navigation, choisissez Manage (Gérer), puis Things (Objets). Choisissez l'objet IoT pour votre appareil, puis choisissez Interagir. Votre point de terminaison s'affiche dans la HTTPSsection de la page des détails de l'objet.

3. Ouvrez le fichier demo_config.h et mettez à jour les valeurs des éléments suivants :

   AWS_IOT_ENDPOINT

   Votre point de terminaison personnel.

   CLIENT_CERT_PATH

   Le chemin de votre fichier de certificat, par exemple certificates/device.pem.crt".

   CLIENT_PRIVATE_KEY_PATH

   Le nom de votre fichier de clé privée, par exemplecertificates/private.pem.key.

   Par exemple :

   // Get from demo_config.h
   // =================================================
   #define AWS_IOT_ENDPOINT               "my-endpoint-ats.iot.us-east-1.amazonaws.com"
   #define AWS_MQTT_PORT                  8883
   #define CLIENT_IDENTIFIER              "testclient"
   #define ROOT_CA_CERT_PATH              "certificates/AmazonRootCA1.crt"
   #define CLIENT_CERT_PATH               "certificates/my-device-cert.pem.crt"
   #define CLIENT_PRIVATE_KEY_PATH        "certificates/my-device-private-key.pem.key"
   // ================================================= 

4. Vérifiez si vous l'avez CMake installé sur votre appareil à l'aide de cette commande.

   cmake --version

   Si vous voyez les informations de version du compilateur, vous pouvez passer à la section suivante.

   Si vous obtenez une erreur ou ne voyez aucune information, vous devrez alors installer le package cmake à l'aide de cette commande.

   sudo apt-get install cmake

   Réexécutez la cmake --version commande et confirmez qu'CMakeelle a été installée et que vous êtes prêt à continuer.

5. Vérifiez si les outils de développement sont installés sur votre appareil à l'aide de cette commande.

   gcc --version

   Si vous voyez les informations de version du compilateur, vous pouvez passer à la section suivante.

   Si vous obtenez une erreur ou que vous ne voyez aucune information de compilateur, vous devrez installer le package build-essential à l'aide de cette commande.

   sudo apt-get install build-essential

   Exécutez à nouveau la commande gcc --version et vérifiez que les outils de génération ont été installés et que vous êtes prêt à continuer.

Étape 3 : Créer et exécuter l'exemple d'application

Cette procédure explique comment générer l'mqtt_demo_mutual_authapplication sur votre appareil et comment la connecter à la AWS IoT console à l'aide du. Kit SDK des appareils AWS IoT pour Embedded C

Pour exécuter les Kit SDK des appareils AWS IoT pour Embedded C exemples d'applications

1. Accédez à un répertoire de construction aws-iot-device-sdk-embedded-c et créez-le.

   mkdir build && cd build

2. Entrez la CMake commande suivante pour générer les Makefiles nécessaires à la construction.

   cmake ..  

3. Entrez la commande suivante pour créer le fichier d'application exécutable.

   make

4. Exécutez l'application mqtt_demo_mutual_auth avec cette commande.

   cd bin
   ./mqtt_demo_mutual_auth 

   Vous devez voir des résultats similaires à ce qui suit :

   

Votre appareil est maintenant connecté à AWS IoT l'aide du Kit SDK des appareils AWS IoT pour Embedded C.

Vous pouvez également utiliser la AWS IoT console pour afficher les MQTT messages publiés par l'exemple d'application. Pour plus d'informations sur l'utilisation du MQTT client dans la AWS IoT console, consultezAfficher MQTT les messages avec le AWS IoT MQTT client.