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

1. Configurez le matériel Espressif.

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

   Important

   Lorsque vous accédez à la section Installation étape par étape du guide, continuez jusqu'à terminer 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 FreeRTOS depuis. GitHub (Pour obtenir des instructions, consultez le README.md fichier.)

3. Configurez votre environnement de développement.

   Pour communiquer avec votre tableau, vous devez installer une chaîne d'outils. Espressif leur permet de ESP-IDF 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 dont le noyau FreeRTOS a été supprimé. Cela permet de résoudre 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 avec 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 Universal Online.

   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 le ESP-IDF répertoire existant surfreertos/vendors/espressif/esp-idf.

   4. Terminez l'installation.

   macOS

   1. Suivez les instructions de la section 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, 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 section 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, 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 USB vers UART Bridge CP210x. 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.

1. Configurez le projet de démonstration FreeRTOS en suivant les étapes décrites dans. Configuration des démos FreeRTOS Lorsque vous arrivez à la dernière étape Pour formater vos AWS IoT informations d'identification, arrêtez 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 configurer 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.

Pour vous abonner à la rubrique MQTT avec AWS IoT Client MQTT

1. Connectez-vous à la console AWS IoT.

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

3. Dans Rubrique d'abonnement, saisissez your-thing-name/example/topic puis choisissez S'abonner à la rubrique.

Créez et flashez FreeRTOS sur Windows, Linux et macOS (ESP-IDF v4.2)

1. Accédez à la racine de votre répertoire de téléchargement 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 « Commande »)

   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 pas d'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 carte.

   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 indiqué 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

Pour créer et flasher le projet

1. Dans une fenêtre de ligne de commande, accédez à la racine de votre répertoire de téléchargement 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