Débuter avec l'Espressif ESP32-S2

1. Configurez le matériel Espressif.

   Pour plus d'informations sur la configuration matérielle de la carte de ESP32-S2 développement, consultez le ESP32-S2-Saola-1 Guide de démarrage.

   Important

   Lorsque vous accédez à la section Démarrage des guides Espressif, arrêtez-vous, puis revenez aux instructions de cette page.

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-DevKitC, 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. Si vous utilisez macOS ou Linux, ouvrez une invite de terminal. Si vous utilisez Windows, ouvrez l'application « ESP-IDF  4.x CMD » (si vous avez inclus cette option lors de l'installation de la ESP-IDF chaîne d'outils) ou l'application « Invite de commandes » dans le cas contraire.

2. Pour vérifier que Python3 est installé, exécutez la commande suivante :

   python --version

   La version installée s'affiche. Si Python 3.0.1 ou version ultérieure n'est pas installé, vous pouvez l'installer depuis le site Web de Python.

3. Vous avez besoin de l'interface de ligne de AWS commande (CLI) pour exécuter AWS IoT des commandes. Si vous utilisez Windows, utilisez la easy_install awscli commande pour installer la AWS CLI dans l'application « Command » ou « ESP-IDF  4.x CMD ».

   Si vous utilisez macOS ou Linux, consultez la section Installation de l' AWS interface de ligne de commande.

4. Exécuter

   aws configure

   et configurez la AWS CLI avec votre ID de clé d' AWS accès, votre clé d'accès secrète et votre AWS région par défaut. Pour plus d'informations, consultez Configuration de l'interface CLI AWS (français non garanti).

5. Utilisez la commande suivante pour installer le AWS SDK pour Python (boto3) :

   • Sous Windows, dans l'application « Command » ou « ESP-IDF  4.x CMD », exécutez

     easy_install boto3

   • Sur macOS ou Linux, exécutez

     pip install tornado nose --user

     puis exécutez

     pip install boto3 --user

Pour exécuter le script de configuration

1. Pour configurer le script, ouvrez freertos/tools/aws_config_quick_start/configure.json et définissez les attributs suivants :

   afr_source_dir

   Chemin d’accès complet vers l'annuaire freertos sur votre ordinateur. Assurez-vous d'utiliser des barres obliques pour spécifier ce chemin.

   thing_name

   Le nom que vous souhaitez attribuer à l' AWS IoT élément qui représente votre tableau.

   wifi_ssid

   Le SSID de votre Wi-Fi réseau.

   wifi_password

   Le mot de passe de votre Wi-Fi réseau.

   wifi_security

   Type de sécurité de votre Wi-Fi réseau. Les types de sécurité valides sont les suivants :

   • eWiFiSecurityOpen (Ouvrir, aucune sécurité)

   • eWiFiSecurityWEP (Sécurité WEP)

   • eWiFiSecurityWPA (Sécurité WPA)

   • eWiFiSecurityWPA2 (Sécurité WPA2)

2. Si vous utilisez macOS ou Linux, ouvrez une invite de terminal. Si vous utilisez Windows, ouvrez l'application « ESP-IDF  4.x CMD » ou « Command ».

3. Accédez au freertos/tools/aws_config_quick_start répertoire et exécutez

   python SetupAWS.py setup

   Le script effectue les opérations suivantes :

   • Crée n' AWS IoT importe quel objet, certificat et politique.

   • Attache la AWS IoT politique au certificat et le certificat à l' AWS IoT objet.

   • Renseigne le aws_clientcredential.h fichier avec votre AWS IoT point de terminaison, votre Wi-Fi SSID et vos informations d'identification.

   • Formate votre certificat et votre clé privée et les écrit dans le fichier aws_clientcredential_keys.h d'en-tête.

   Note

   Le certificat est codé en dur à des fins de démonstration uniquement. Production-level les applications doivent stocker ces fichiers dans un emplacement sécurisé.

   Pour plus d'informations à ce sujetSetupAWS.py, consultez le README.md dans le freertos/tools/aws_config_quick_start répertoire.

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 le champ Rubrique d'abonnement, saisissez your-thing-name/example/topic, puis choisissez S'abonner à la rubrique.

Pour créer et flasher le projet

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=esp32s2_saola_1 -DCOMPILER=xtensa-esp32s2 build

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

   Executing action: all (aliases: build)
      Running cmake in directory /path/to/hello_world/build
      Executing "cmake -G Ninja -DPYTHON_DEPS_CHECKED=1 -DESP_PLATFORM=1 -DVENDOR=espressif -DBOARD=esp32s2_saola_1 -DCOMPILER=xtensa-esp32s2 -DCCACHE_ENABLE=0 /path/to/hello_world"...
      -- The C compiler identification is GNU 8.4.0
      -- The CXX compiler identification is GNU 8.4.0
      -- The ASM compiler identification is GNU
   
      ... (more lines of build system output)
   
      [1628/1628] Generating binary image from built executable
      esptool.py v3.0
      Generated /path/to/hello_world/build/aws_demos.bin
   
      Project build complete. To flash, run this command:
      esptool.py -p (PORT) -b 460800 --before default_reset --after hard_reset --chip esp32s2  write_flash --flash_mode dio --flash_size detect --flash_freq 80m 0x1000 build/bootloader/bootloader.bin 0x8000 build/partition_table/partition-table.bin 0x16000 build/ota_data_initial.bin 0x20000 build/aws_demos.bin
      or run 'idf.py -p (PORT) flash' 

   S'il n'y a pas d'erreur, la compilation génère 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=esp32s2_saola_1 -DCOMPILER=xtensa-esp32s2 -S . -B ./YOUR_BUILD_DIRECTORY -DAFR_ENABLE_ALL_MODULES=1 -DAFR_ENABLE_TESTS=0

   • Avec Ninja

     cmake -DVENDOR=espressif -DBOARD=esp32s2_saola_1 -DCOMPILER=xtensa-esp32s2 -S . -B ./YOUR_BUILD_DIRECTORY -DAFR_ENABLE_ALL_MODULES=1 -DAFR_ENABLE_TESTS=0 -GNinja

4. Générez le projet.

   • Avec Unix Makefiles

     make -C ./YOUR_BUILD_DIRECTORY -j8

   • Avec Ninja

     ninja -C ./YOUR_BUILD_DIRECTORY -j8

5. 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