Commencer à utiliser l'Espressif -WROOM-32SE ESP32

Pour vous inscrire à un Compte AWS

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

2. Suivez les instructions en ligne.

   Une partie de la procédure d'inscription consiste à recevoir un appel téléphonique ou un message texte et à saisir un code de vérification sur le clavier 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 racine.

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

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, octroyez 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’URL de connexion qui a été envoyée à 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'IAM Identity Center, consultez la section Connexion au portail AWS d'accès dans le guide de l'Connexion à AWS utilisateur.

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

1. Dans IAM Identity Center, créez un ensemble d’autorisations qui respecte la bonne pratique consistant à appliquer les autorisations de 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. Pour établir une connexion série entre votre machine hôte et le ESP32 -WROOM-32SE, installez les pilotes VCP CP21 0x 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 aurez besoin pour créer la démonstration.

1. Configurez le projet de démonstration FreeRTOS en suivant les étapes décrites dans. Configuration des démos de FreeRTOS Ignorez la dernière étape Pour formater vos informations d'identification AWS IoT et suivez les étapes ci-dessous à la place.

2. Microchip a fourni plusieurs outils de script pour aider à la configuration des composants ATECC6 08A. Accédez au freertos/vendors/microchip/secure_elements/app/example_trust_chain_tool répertoire, puis ouvrez le README.md fichier.

3. Suivez les instructions du fichier README.md pour mettre en service le périphérique. 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 ATECC6 08A et exportez la clé publique et le numéro de série de l'appareil

   3. Générez un certificat pour l'appareil et enregistrez ce certificat 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 Mise en service de clés en mode développeur.

Pour générer les fichiers de build de l'application de démonstration avec CMake

1. Naviguez jusqu'à 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 générer les fichiers de build.

   cmake -DVENDOR=espressif -DBOARD=esp32_plus_ecc608a_devkitc -DCOMPILER=xtensa-esp32 -S . -B your-build-directory

   Remarques

   Pour générer l'application pour le débogage, ajoutez l'indicateur -DCMAKE_BUILD_TYPE=Debug.

   Pour générer les fichiers de build de l'application de test, ajoutez l'indicateur -DAFR_ENABLE_TESTS=1.

   Le code fourni par Espressif utilise la pile IP légère (lwIP) comme pile réseau par défaut. Pour utiliser la pile réseau FreeRTOS+TCP à la place, ajoutez l'indicateur à la –DAFR_ESP_FREERTOS_TCP commande. CMake

   Pour ajouter la dépendance LWip pour le code fourni par un fournisseur autre que le fournisseur, ajoutez les lignes suivantes CMake au fichier de dépendanceCMakeLists.txt, pour votre composant Wi-Fi personnalisé.

   # Add a dependency on the bluetooth espressif component to the common component
   set(COMPONENT_REQUIRES lwip)

Pour générer l'application avec Make

1. Accédez au répertoire build.

2. Dans une fenêtre de ligne de commande, entrez la commande suivante pour générer l'application avec Make.

   make all -j4

   Note

   Vous devez générer les fichiers de création avec la commande cmake chaque fois que vous passez du projet aws_demos au projet aws_tests et vice versa.

Pour générer les fichiers de build de l'application de démonstration avec CMake

1. Naviguez jusqu'à 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 générer les fichiers de build.

   cmake -DVENDOR=espressif -DBOARD=esp32_plus_ecc608a_devkitc -DCOMPILER=xtensa-esp32 -GNinja -S . -B your-build-directory

   Note

   Pour générer l'application pour le débogage, ajoutez l'indicateur -DCMAKE_BUILD_TYPE=Debug.

   Pour générer les fichiers de build de l'application de test, ajoutez l'indicateur -DAFR_ENABLE_TESTS=1.

   Le code fourni par Espressif utilise la pile IP légère (lwIP) comme pile réseau par défaut. Pour utiliser la pile réseau FreeRTOS+TCP à la place, ajoutez l'indicateur à la –DAFR_ESP_FREERTOS_TCP commande. CMake

   Pour ajouter la dépendance LWip pour le code fourni par un fournisseur autre que le fournisseur, ajoutez les lignes suivantes CMake au fichier de dépendanceCMakeLists.txt, pour votre composant Wi-Fi personnalisé.

   # Add a dependency on the bluetooth espressif component to the common component
   set(COMPONENT_REQUIRES lwip)

Pour générer l'application

1. Accédez au répertoire build.

2. Dans une fenêtre de ligne de commande, entrez la commande suivante pour appeler Ninja afin de générer l'application.

   ninja

   Vous pouvez également utiliser l' CMake interface générique pour créer l'application.

   cmake --build your-build-directory

   Note

   Vous devez générer les fichiers de création avec la commande cmake chaque fois que vous passez du projet aws_demos au projet aws_tests et vice versa.

1. Pour établir une connexion série entre votre machine hôte et le ESP32 -WROOM-32SE, installez les pilotes VCP CP21 0x 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 aurez besoin pour créer la démonstration.

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 et suivez plutôt les étapes ci-dessous.

2. Microchip a fourni plusieurs outils de script pour aider à la configuration des composants ATECC6 08A. Accédez au répertoire freertos/vendors/microchip/secure_elements/app/example_trust_chain_tool et ouvrez le fichier README.md.

3. Suivez les instructions du fichier README.md pour mettre en service le périphérique. 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 ATECC6 08A et exportez la clé publique et le numéro de série de l'appareil

   3. Générez un certificat pour l'appareil et enregistrez ce certificat 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 Mise en service de clés en mode développeur.

Pour créer et flasher le projet

1. Naviguez jusqu'à 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 outils ESP-IDF au PATH de votre terminal :

   Windows

   vendors\espressif\esp-idf\export.bat

   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

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 outils ESP-IDF 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

Pour vous abonner à la rubrique MQTT avec le client AWS IoT MQTT

1. Connectez-vous à la console AWS IoT.

2. Dans le volet de navigation, sélectionnez Test (Tester) pour ouvrir le client MQTT.

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