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

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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 utiliser le kit SDK sur n'importe quel système d'exploitation et l'héberger sur n'importe quel type de processeur (par exemple, microcontrôleurs et MPU). Si vous disposez de davantage de mémoire et de ressources de traitement, nous vous recommandons d'utiliser l'un des kits de développement logiciel (SDK) pour AWS IoT appareils et appareils mobiles de plus haut niveau (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 qui utilisent des microcontrôleurs ou des MPU bas de gamme exécutant 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. Téléchargez-le Kit SDK des appareils AWS IoT pour Embedded C sur votre appareil à partir de 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 OpenSSL version 1.1.0 ou ultérieure. Les bibliothèques de développement OpenSSL 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 sur des sujets MQTT.

  1. Copiez le certificat et la clé privée que vous avez créés dans Commencer avec AWS IoT Core 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 l'URL du point de terminaison de votre compte.

    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 section HTTPS de la page de 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 CMake est 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

    Exécutez à nouveau la commande cmake --version et confirmez que CMake a été installé 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

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 commande CMake 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 :

    Sortie en ligne de commande pour exécuter l' Kit SDK des appareils AWS IoT pour Embedded C exemple d'application.

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 messages MQTT publiés par l'exemple d'application. Pour de plus amples informations sur l’utilisation du client MQTT dans la console AWS IoT, veuillez consulter Afficher les messages MQTT avec le client AWS IoT MQTT .