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.
Procédures décrites dans cette section
É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
-
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. -
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
-
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_auth
application, qui montre comment se connecter au courtier de AWS IoT Core messages, s'abonner et publier dans MQTT des rubriques.
-
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.
-
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. -
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 exemple
certificates/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" // ================================================= -
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.
-
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_auth
application sur votre appareil et comment la connecter à la AWS IoT console
Pour exécuter les Kit SDK des appareils AWS IoT pour Embedded C exemples d'applications
-
Accédez à un répertoire de construction
aws-iot-device-sdk-embedded-c
et créez-le.mkdir build && cd build
-
Entrez la CMake commande suivante pour générer les Makefiles nécessaires à la construction.
cmake ..
-
Entrez la commande suivante pour créer le fichier d'application exécutable.
make
-
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