View a markdown version of this page

Débuter avec l'Espressif ESP32-WROOM-32SE - 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.

Débuter avec l'Espressif ESP32-WROOM-32SE

Important

Cette intégration de référence est hébergée sur le Amazon-FreeRTOS référentiel qui est obsolète. Nous vous recommandons de commencer ici lorsque vous créez un nouveau projet. Si vous possédez déjà un projet FreeRTOS basé sur le référentiel désormais Amazon-FreeRTOS obsolète, consultez le. Amazon-FreeRTOS Guide de migration du référentiel Github

Ce tutoriel explique comment démarrer avec l'Espressif ESP32-WROOM-32SE. Pour en acheter un auprès de notre partenaire sur le catalogue des appareils AWS partenaires, consultez ESP32-WROOM-32SE.

Présentation de

Ce didacticiel vous guide à travers les étapes suivantes :

  1. Connectez votre carte à un appareil hôte.

  2. Installation du logiciel sur votre machine hôte pour développer et déboguer les applications intégrées de votre carte de microcontrôleur.

  3. Compilez de manière croisée une application de démonstration FreeRTOS en une image binaire.

  4. Chargement de l’image binaire de l’application dans votre carte et exécution de l’application.

  5. Surveillez et déboguez l'application en cours d'exécution à l'aide d'une connexion série.

Conditions préalables

Avant de commencer à utiliser FreeRTOS sur votre tableau Espressif, vous devez configurer votre compte et vos autorisations. AWS

Inscrivez-vous pour un Compte AWS

Pour commencer AWS, vous avez besoin d'un Compte AWS. Pour plus d'informations sur la création d'un Compte AWS, voir Getting started with an Compte AWS dans le Guide de Gestion de compte AWS référence.

Pour activer l’accès, ajoutez des autorisations à vos utilisateurs, groupes ou rôles :

Mise en route

Note

Les commandes Linux de ce didacticiel nécessitent que vous utilisiez le shell Bash.

  1. Configurez le matériel Espressif.

    Pour plus d'informations sur la configuration du matériel de la carte de ESP32-WROOM-32SE développement, consultez le guide ESP32-DevKitC de démarrage de la version 4.

    Important

    Lorsque vous atteignez la section Installation étape par étape du guide, suivez jusqu'à ce que vous ayez terminé l'étape 4 (Configuration des variables d'environnement). Arrêtez-vous après avoir terminé l'étape 4 et suivez les étapes restantes ici.

  2. Téléchargez Amazon GitHubFreeRTOS depuis. (Pour obtenir des instructions, consultez le README.mdfichier.)

  3. Configurez votre environnement de développement.

    Pour communiquer avec votre tableau, vous devez installer une chaîne d'outils. Espressif fournit le logiciel ESP-IDF pour développer des logiciels pour leurs cartes. Comme ESP-IDF sa propre version du noyau FreeRTOS est intégrée en tant que composant, Amazon FreeRTOS inclut une version personnalisée de la ESP-IDF version 4.2 dans laquelle le noyau FreeRTOS a été supprimé. Cela résout les problèmes liés aux fichiers dupliqués lors de la compilation. Pour utiliser la version personnalisée de la ESP-IDF version 4.2 incluse dans Amazon FreeRTOS, suivez les instructions ci-dessous correspondant au système d'exploitation de votre machine hôte.

    Windows

    1. Téléchargez ESP-IDF le programme d'installation universel en ligne pour Windows.

    2. Exécutez le programme d'installation en ligne universel.

    3. Lorsque vous arrivez à l'étape Télécharger ou utiliser ESP-IDF, sélectionnez Utiliser un ESP-IDF répertoire existant et définissez Choisir un ESP-IDF répertoire existant surfreertos/vendors/espressif/esp-idf.

    4. Terminez l'installation.

    macOS

    1. Suivez les instructions de la configuration standard des prérequis de la chaîne d'outils (ESP-IDF v4.2) pour macOS.

      Important

      Lorsque vous atteignez les instructions ESP-IDF « Obtenir » sous Prochaines étapes, arrêtez-vous, puis revenez aux instructions de cette page.

    2. Ouvrez une fenêtre de ligne de commande.

    3. Accédez au répertoire de téléchargement de FreeRTOS, puis exécutez le script suivant pour télécharger et installer la chaîne d'outils espressif pour votre plateforme.

      vendors/espressif/esp-idf/install.sh
    4. Ajoutez les ESP-IDF outils de la chaîne d'outils au chemin de votre terminal à l'aide de la commande suivante.

      source vendors/espressif/esp-idf/export.sh

    Linux

    1. Suivez les instructions de la configuration standard des prérequis de la chaîne d'outils (ESP-IDF v4.2) pour Linux.

      Important

      Lorsque vous atteignez les instructions ESP-IDF « Obtenir » sous Prochaines étapes, arrêtez-vous, puis revenez aux instructions de cette page.

    2. Ouvrez une fenêtre de ligne de commande.

    3. Accédez au répertoire de téléchargement de FreeRTOS, puis exécutez le script suivant pour télécharger et installer la chaîne d'outils Espressif pour votre plateforme.

      vendors/espressif/esp-idf/install.sh
    4. Ajoutez les ESP-IDF outils de la chaîne d'outils au chemin de votre terminal à l'aide de la commande suivante.

      source vendors/espressif/esp-idf/export.sh
  4. Établissez une connexion série.

    1. Pour établir une connexion série entre votre machine hôte et le ESP32-WROOM-32SE, installez les pilotes VCP CP210x USB to UART Bridge. Vous pouvez télécharger ces pilotes à partir de Silicon Labs.

    2. Suivez les étapes pour établir une connexion série avec ESP32.

    3. Une fois que vous avez établi une connexion série, notez le port série pour la connexion de votre carte. Vous en avez besoin pour flasher la démo.

Configuration des applications de démonstration FreeRTOS

Pour ce didacticiel, le fichier de configuration FreeRTOS se trouve à l'adresse. freertos/vendors/espressif/boards/board-name/aws_demos/config_files/FreeRTOSConfig.h (Par exemple, si cette option AFR_BOARD espressif.esp32_devkitc est sélectionnée, le fichier de configuration se trouve à l'adressefreertos/vendors/espressif/boards/esp32/aws_demos/config_files/FreeRTOSConfig.h.)

Important

L'appareil ATECC608A dispose d'une initialisation unique qui est verrouillée sur l'appareil lors de la première exécution d'un projet (lors de l'appel à). C_InitToken Cependant, le projet de démonstration FreeRTOS et le projet de test ont des configurations différentes. Si le périphérique est verrouillé pendant les configurations du projet de démonstration, tous les tests du projet de test ne réussiront pas.

  1. Configurez le projet de démonstration FreeRTOS en suivant les étapes décrites dans. Configuration des démos de FreeRTOS Lorsque vous arrivez à la dernière étape Pour formater vos AWS IoT informations d'identification, arrêtez-vous et effectuez les étapes suivantes.

  2. Microchip fournit plusieurs outils de script pour aider à configurer les composants ATECC608A. Accédez au répertoire freertos/vendors/microchip/example_trust_chain_tool et ouvrez le fichier README.md.

  3. Pour approvisionner votre appareil, suivez les instructions du README.md fichier. Voici les principales étapes à suivre :

    1. Créez et enregistrez une autorité de certification auprès de AWS.

    2. Générez vos clés sur le composant ATECC608A et exportez la clé publique et le numéro de série du périphérique.

    3. Générez un certificat pour l'appareil et enregistrez-le auprès de AWS.

  4. Chargez le certificat d'autorité de certification et le certificat de périphérique sur le périphérique en suivant les instructions de Developer-mode provisionnement des clés.

Surveillance des messages MQTT sur le AWS Cloud

Avant de lancer le projet de démonstration FreeRTOS, vous pouvez configurer le client MQTT dans la console pour surveiller AWS IoT les messages que votre appareil envoie au Cloud. AWS

Pour vous abonner à la rubrique MQTT avec le AWS IoT Client MQTT
  1. Connectez-vous à la console AWS IoT.

  2. Dans le volet de navigation, choisissez Test, puis MQTT Test Client.

  3. Dans Sujet d'abonnement, entrez your-thing-name/example/topic puis choisissez S'abonner au sujet.

Créez, flashez et exécutez le projet de démonstration FreeRTOS à l'aide du script idf.py

Vous pouvez utiliser l'utilitaire IDF (idf.py) d'Espressif pour générer les fichiers de compilation, créer le binaire de l'application et flasher les fichiers binaires sur votre appareil.

Note

Certaines configurations peuvent nécessiter que vous utilisiez l'option de port « -p port-name » with idf.py pour spécifier le port correct, comme dans l'exemple suivant.

idf.py -p /dev/cu.usbserial-00101301B flash
Créez et flashez des FreeRTOS sous Windows, Linux et macOS (v4.2) ESP-IDF
  1. Accédez à la racine de votre répertoire de téléchargement de FreeRTOS.

  2. Dans une fenêtre de ligne de commande, entrez la commande suivante pour ajouter les ESP-IDF outils au PATH de votre terminal :

    Windows (application « Command »)
    vendors\espressif\esp-idf\export.bat
    Windows (application « ESP-IDF  4.x CMD »)

    (Cela a déjà été fait lorsque vous avez ouvert l'application.)

    Linux/ macOS
    source vendors/espressif/esp-idf/export.sh
  3. Configurez cmake dans le build répertoire et créez l'image du microprogramme à l'aide de la commande suivante.

    idf.py -DVENDOR=espressif -DBOARD=esp32_ecc608a_devkitc -DCOMPILER=xtensa-esp32 build

    Vous devriez voir une sortie comme dans l'exemple suivant.

    Running cmake in directory /path/to/hello_world/build Executing "cmake -G Ninja --warn-uninitialized /path/to/hello_world"... Warn about uninitialized values. -- Found Git: /usr/bin/git (found version "2.17.0") -- Building empty aws_iot component due to configuration -- Component names: ... -- Component paths: ... ... (more lines of build system output) [527/527] Generating hello-world.bin esptool.py v2.3.1 Project build complete. To flash, run this command: ../../../components/esptool_py/esptool/esptool.py -p (PORT) -b 921600 write_flash --flash_mode dio --flash_size detect --flash_freq 40m 0x10000 build/hello-world.bin build 0x1000 build/bootloader/bootloader.bin 0x8000 build/partition_table/partition-table.bin or run 'idf.py -p PORT flash'

    S'il n'y a aucune erreur, la compilation générera les fichiers binaires .bin du microprogramme.

  4. Effacez la mémoire flash de votre carte de développement à l'aide de la commande suivante.

    idf.py erase_flash
  5. Utilisez le idf.py script pour flasher le binaire de l'application sur votre tableau.

    idf.py flash
  6. Surveillez la sortie du port série de votre carte à l'aide de la commande suivante.

    idf.py monitor
    Note
    • Vous pouvez combiner ces commandes comme dans l'exemple suivant.

      idf.py erase_flash flash monitor
    • Pour certaines configurations de machine hôte, vous devez spécifier le port lorsque vous flashez la carte, comme dans l'exemple suivant.

      idf.py erase_flash flash monitor -p /dev/ttyUSB1

Créez et flashez des FreeRTOS avec CMake

Outre l'utilisation du idf.py script fourni par le SDK IDF pour créer et exécuter votre code, vous pouvez également créer le projet avec CMake. Actuellement, il supporte Unix Makefile et le système de construction Ninja.

Pour créer et flasher le projet
  1. Dans une fenêtre de ligne de commande, naviguez jusqu'à la racine du répertoire de téléchargement de FreeRTOS.

  2. Exécutez le script suivant pour ajouter les ESP-IDF outils au PATH de votre shell.

    Windows
    vendors\espressif\esp-idf\export.bat
    Linux/ macOS
    source vendors/espressif/esp-idf/export.sh
  3. Entrez la commande suivante pour générer les fichiers de compilation.

    Avec Unix Makefiles
    cmake -DVENDOR=espressif -DBOARD=esp32_plus_ecc608a_devkitc -DCOMPILER=xtensa-esp32 -S . -B ./YOUR_BUILD_DIRECTORY -DAFR_ENABLE_ALL_MODULES=1 -DAFR_ENABLE_TESTS=0
    Avec Ninja
    cmake -DVENDOR=espressif -DBOARD=esp32_plus_ecc608a_devkitc -DCOMPILER=xtensa-esp32 -S . -B ./YOUR_BUILD_DIRECTORY -DAFR_ENABLE_ALL_MODULES=1 -DAFR_ENABLE_TESTS=0 -GNinja
  4. Effacez le flash, puis faites clignoter le tableau.

    Avec Unix Makefiles
    make -C ./YOUR_BUILD_DIRECTORY erase_flash
    make -C ./YOUR_BUILD_DIRECTORY flash
    Avec Ninja
    ninja -C ./YOUR_BUILD_DIRECTORY erase_flash
    ninja -C ./YOUR_BUILD_DIRECTORY flash

Informations supplémentaires

Pour plus d'informations sur l'utilisation et le dépannage des cartes Espressif ESP32, consultez les rubriques suivantes :