Configuration de la bibliothèque CoreMQTT à des fins de tests - FreeRTOS

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.

Configuration de la bibliothèque CoreMQTT à des fins de tests

Les appareils périphériques peuvent utiliser le protocole MQTT pour communiquer avec le cloud AWS. AWS IoT héberge un broker MQTT qui envoie et reçoit des messages vers et depuis des appareils périphériques connectés.

La bibliothèque CoreMQTT implémente le protocole MQTT pour les appareils exécutant FreeRTOS. La bibliothèque CoreMQTT n'a pas besoin d'être portée, mais votre projet de test de votre périphérique doit passer tous les tests de qualification MQTT. Pour de plus amples informations, veuillez consulterBibliothèque CoreMQTTdans leManuel de l'utilisateur FreeRTOS.

Prerequisites

Pour configurer les tests pour la bibliothèque CoreMQTT, vous avez besoin des éléments suivants :

  • Un portage de la bibliothèque TLS.

    Pour plus d'informations concernant le portage la bibliothèque TLS sur votre plateforme, consultez Portage de la bibliothèque TLS.

Si vous utilisez un IDE pour générer des projets de test, vous devez configurer le portage de votre bibliothèque dans le projet IDE.

Configuration du projet de test IDE

Pour la configuration de la bibliothèque CoreMQTT dans le projet IDE

  1. Ajoutez tous les fichiers sources de la bibliothèque dans lefreertos/libraries/coreMQTT/sourceet ses sous-répertoires du répertoireaws_testsProjet IDE.

  2. Ajoutez tous les fichiers sources de la couche réseau (utilisés dans les tests) dans lefreertos/libraries/abstractions/transportdirectory etsecure_socketssous-répertoire duaws_testsProjet IDE.

  3. Ajout d'uncore_mqtt_config.h, nécessaire à la création de la bibliothèque CoreMQTT, dans le répertoire des fichiers de configuration à l'adressefreertos/vendors/vendor/boards/board/aws_tests/config_files.

  4. Ajoutez le fichier source de test à l'adressefreertos/tests/integration_test/core_mqtt_system.cvers leaws_testsProjet IDE.

Configuration de votre environnement de test local

Une fois que vous avez configuré la bibliothèque dans le projet IDE, vous devez configurer des fichiers à tester.

Pour configurer les fichiers source et d'en-tête pour les tests MQTT

  • Pour activer les tests MQTT, ouvrez freertos/vendors/vendor-name/boards/board-name/aws_tests/config_files/aws_test_runner_config.h et définissez la macro testrunnerFULL_CORE_MQTT_AWS_IOT_ENABLED sur 1.

Exécution des tests

Pour l’exécution des tests MQTT

  1. Générez le projet de test, puis flashez-le sur votre appareil pour l'exécuter.

  2. Vérifiez les résultats de test dans la console UART. Si chacun des tests est réussi, la phase de test est alors terminée.

Validation

Pour qualifier officiellement un périphérique pour FreeRTOS, vous devez valider le code source porté de l'appareil avecAWS IoTDevice Tester. Suivez les instructions de la sectionUtilisation d’AWS IoTFreeRTOS Device Tester pourdans le manuel de l'utilisateur FreeRTOS afin de configurer Device Tester pour la validation de port. Pour tester le port d'une bibliothèque spécifique, le groupe de test correct doit être activé dans le fichier device.json du dossier configs de Device Tester.

Une fois que vous avez configuré la bibliothèque CoreMQTT pour votre périphérique, vous pouvez démarrer le portage de la bibliothèque de l'agent OTA. Pour obtenir des instructions, consultez Portage duAWS IoTbibliothèque de mises à jour OTA.

Si votre appareil ne prend pas en charge la fonctionnalité OTA, vous pouvez démarrer le portage de la bibliothèque Bluetooth Low Energy. Pour obtenir des instructions, consultez Portage de la bibliothèque Bluetooth Low Energy.

Si votre appareil ne prend pas en charge les fonctionnalités Bluetooth et OTA, vous avez terminé le portage et pouvez donc démarrer le processus de qualification FreeRTOS. ConsultezGuide de qualification FreeRTOSpour plus d'informations, consultez.