Commencer à utiliser l'Espressif ESP32 - DevKit C et le ESP-WROVER-KIT

Pour vous inscrire à un Compte AWS

1. Ouvrez l'https://portal.aws.amazon.com/billing/inscription.

2. Suivez les instructions en ligne.

   Dans le cadre de la procédure d‘inscription, vous recevrez un appel téléphonique et vous saisirez un code de vérification en utilisant le clavier numérique du téléphone.

   Lorsque vous vous inscrivez à un Compte AWS, un Utilisateur racine d'un compte AWSest créé. Par défaut, seul l‘utilisateur racine a accès à l‘ensemble des Services AWS et des ressources de ce compte. La meilleure pratique de sécurité consiste à attribuer un accès administratif à un utilisateur, et à utiliser uniquement l‘utilisateur racine pour effectuer les tâches nécessitant un accès utilisateur racine.

Sécurisez votre Utilisateur racine d'un compte AWS

1. Connectez-vous en AWS Management Consoletant que propriétaire du compte en choisissant Utilisateur root et en saisissant votre adresse Compte AWS e-mail. Sur la page suivante, saisissez votre mot de passe.

   Pour obtenir de l‘aide pour vous connecter en utilisant l‘utilisateur racine, consultez Connexion en tant qu‘utilisateur racine dans le Guide de l‘utilisateur Connexion à AWS .

2. Activez l'authentification multifactorielle (MFA) pour votre utilisateur root.

   Pour obtenir des instructions, voir Activer un MFA périphérique virtuel pour votre utilisateur Compte AWS root (console) dans le guide de IAM l'utilisateur.

Création d'un utilisateur doté d'un accès administratif

1. Activez IAM Identity Center.

   Pour obtenir des instructions, consultez Activation d’ AWS IAM Identity Center dans le Guide de l’utilisateur AWS IAM Identity Center .

2. Dans IAM Identity Center, accordez un accès administratif à un utilisateur.

   Pour un didacticiel sur l'utilisation du Répertoire IAM Identity Center comme source d'identité, voir Configurer l'accès utilisateur par défaut Répertoire IAM Identity Center dans le Guide de AWS IAM Identity Center l'utilisateur.

Connexion en tant qu‘utilisateur doté d'un accès administratif

• Pour vous connecter avec votre utilisateur IAM Identity Center, utilisez l'URLidentifiant envoyé à votre adresse e-mail lorsque vous avez créé l'utilisateur IAM Identity Center.

  Pour obtenir de l'aide pour vous connecter en utilisant un utilisateur d'IAMIdentity Center, consultez la section Connexion au portail AWS d'accès dans le guide de Connexion à AWS l'utilisateur.

Attribution d'un accès à d'autres utilisateurs

1. Dans IAM Identity Center, créez un ensemble d'autorisations conforme à la meilleure pratique consistant à appliquer les autorisations du moindre privilège.

   Pour obtenir des instructions, consultez Création d’un ensemble d’autorisations dans le Guide de l’utilisateur AWS IAM Identity Center .

2. Attribuez des utilisateurs à un groupe, puis attribuez un accès par authentification unique au groupe.

   Pour obtenir des instructions, consultez Ajout de groupes dans le Guide de l’utilisateur AWS IAM Identity Center .

1. Configurez le matériel Espressif.

   • Pour plus d'informations sur la configuration matérielle de la carte de développement ESP32 - DevKit C, consultez le Guide de démarrage ESP32 - DevKit C V4.

   • Pour plus d'informations sur la configuration du matériel de la carte de ESP-WROVER-KIT développement, consultez le guide de démarrage de la ESP-WROVER-KIT version 4.1.

   Important

   Lorsque vous atteignez la section Get Started des guides Espressif, arrêtez-vous, puis revenez aux instructions de cette page.

2. Téléchargez Amazon gratuitement RTOS sur GitHub. (Pour obtenir des instructions, consultez le fichier README.md.)

3. Configurez votre environnement de développement.

   Pour communiquer avec votre tableau, vous devez installer une chaîne d'outils. Espressif fournit les outils nécessaires ESP IDF pour développer des logiciels pour leurs cartes. Étant donné que le ESP - IDF possède sa propre version du RTOS noyau libre intégrée en tant que composant, Amazon Free RTOS inclut une version personnalisée du ESP - IDF v4.2 qui supprime le RTOS noyau libre. 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 ESP - IDF v4.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 le ESP programme IDF d'installation en ligne universel 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 IDF répertoire existant ESP et définissez Choisir un IDF répertoire existant ESP 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 « Obtenir ESP - IDF » 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 RTOS téléchargement gratuit, 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 IDF outils ESP - toolchain 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 « Obtenir ESP - IDF » 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 RTOS téléchargement gratuit, 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 IDF outils ESP - toolchain 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 DevKit -C, vous devez installer les VCP pilotes CP21 0x USB to UART Bridge. Vous pouvez télécharger ces pilotes à partir de Silicon Labs.

      Pour établir une connexion série entre votre machine hôte et le ESP32 - WROVER -KIT, vous devez installer le pilote de COM port FTDI virtuel. Vous pouvez télécharger ce pilote sur FTDI.

   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 du terminal. Si vous utilisez Windows, ouvrez l'application « ESP - IDF 4.x CMD » (si vous avez inclus cette option lorsque vous avez installé la IDF chaîne d'outils ESP -), ou l'application « Command Prompt » dans le cas contraire.

2. Pour vérifier que Python3 est installé, exécutez

   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 l'installer AWS CLI dans l'application « Command » ou « ESP - IDF 4.x CMD ».

   Si vous utilisez macOS ou Linux, consultez la section Installation du AWS CLI.

4. Exécuter

   aws configure

   et configurez le AWS CLI avec votre identifiant 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 la section Configuration du AWS CLI.

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

     pip install boto3 --user

     Note

     Consultez la documentation de Boto3 pour plus de détails.

   • Sur macOS ou Linux, exécutez

     pip install tornado nose --user

     puis exécutez

     pip install boto3 --user

   Free RTOS inclut le SetupAWS.py script pour faciliter la configuration de votre carte Espressif à laquelle vous connecter. AWS IoT 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 réseau Wi-Fi.

   wifi_password

   Mot de passe de votre réseau Wi-Fi.

   wifi_security

   Type de sécurité de votre réseau Wi-Fi.

   Les types de sécurité suivants sont valides :

   • eWiFiSecurityOpen (Ouvrir, aucune sécurité)

   • eWiFiSecurityWEP(WEPsécurité)

   • eWiFiSecurityWPA(WPAsécurité)

   • eWiFiSecurityWPA2(WPA2sécurité)

6. Exécutez le script de configuration.

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

   2. 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 un objet, un certificat et une politique IoT.

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

      • Remplit le aws_clientcredential.h fichier avec votre AWS IoT terminal, votre réseau 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. Les applications de niveau production doivent stocker ces fichiers dans un emplacement sécurisé.

      Pour plus d'informationsSetupAWS.py, consultez le README.md dans le freertos/tools/aws_config_quick_start répertoire.

Pour s'abonner à la MQTT rubrique avec le AWS IoT MQTT client

1. Accédez à la console AWS IoT.

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

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

Créez et flashez gratuitement RTOS sous Windows, Linux et macOS (ESP- IDF v4.2)

1. Naviguez jusqu'à la racine de votre répertoire de RTOS téléchargement gratuit.

2. Dans une fenêtre de ligne de commande, entrez la commande suivante pour ajouter les IDF outils ESP - à ceux de votre terminalPATH.

   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 avec la commande suivante.

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

   Vous devriez voir une sortie semblable à la suivante.

      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

Pour créer et flasher le projet

1. Dans une fenêtre de ligne de commande, naviguez jusqu'à la racine de votre répertoire de RTOS téléchargement gratuit.

2. Exécutez le script suivant pour ajouter les IDF outils ESP - à ceux de votre shellPATH.

   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_wrover_kit -DCOMPILER=xtensa-esp32 -S . -B ./YOUR_BUILD_DIRECTORY -DAFR_ENABLE_ALL_MODULES=1 -DAFR_ENABLE_TESTS=0

   Avec Ninja

   cmake -DVENDOR=espressif -DBOARD=esp32_wrover_kit -DCOMPILER=xtensa-esp32 -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

Pour configurer l'application mobile de SDK démonstration gratuite RTOS Bluetooth Low Energy

1. Suivez les instructions SDK mobiles pour appareils Bluetooth FreeRTOS pour télécharger et installer le SDK pour votre plate-forme mobile sur votre ordinateur hôte.

2. Suivez les instructions de la rubrique Application de démonstration du SDK FreeRTOS Bluetooth Low Energy Mobile pour configurer la démonstration d'applications mobiles sur votre appareil mobile.