Guida introduttiva all' ESP32Espressif -WROOM-32SE

Per iscriverti a un Account AWS

1. Apri la https://portal.aws.amazon.com/billing/registrazione.

2. Segui le istruzioni online.

   Parte della procedura di registrazione prevede la ricezione di una telefonata o di un messaggio di testo e l'immissione di un codice di verifica sulla tastiera del telefono.

   Quando ti iscrivi a un Account AWS, Utente root dell'account AWSviene creato un. L'utente root dispone dell'accesso a tutte le risorse e tutti i Servizi AWS nell'account. Come best practice di sicurezza, assegna l'accesso amministrativo a un utente e utilizza solo l'utente root per eseguire attività che richiedono l'accesso di un utente root.

Proteggi i tuoi Utente root dell'account AWS

1. Accedi AWS Management Consolecome proprietario dell'account scegliendo Utente root e inserendo il tuo indirizzo Account AWS email. Nella pagina successiva, inserisci la password.

   Per informazioni sull'accesso utilizzando un utente root, consulta la pagina Signing in as the root user della Guida per l'utente di Accedi ad AWS .

2. Abilita l'autenticazione a più fattori (MFA) per l'utente root.

   Per istruzioni, consulta Abilitare un dispositivo MFA virtuale per l'utente Account AWS root (console) nella Guida per l'utente IAM.

Crea un utente con accesso amministrativo

1. Abilita Centro identità IAM.

   Per istruzioni, consulta Abilitazione di AWS IAM Identity Center nella Guida per l'utente di AWS IAM Identity Center .

2. In IAM Identity Center, assegna l'accesso amministrativo a un utente.

   Per un tutorial sull'utilizzo di IAM Identity Center directory come fonte di identità, consulta Configurare l'accesso utente con l'impostazione predefinita IAM Identity Center directory nella Guida per l'AWS IAM Identity Center utente.

Accesso come utente amministratore

• Per accedere con l'utente IAM Identity Center, utilizza l'URL di accesso che è stato inviato al tuo indirizzo e-mail quando hai creato l'utente IAM Identity Center.

  Per informazioni sull'accesso utilizzando un utente IAM Identity Center, consulta AWS Accedere al portale di accesso nella Guida per l'Accedi ad AWS utente.

Assegna l'accesso a ulteriori utenti

1. In IAM Identity Center, crea un set di autorizzazioni conforme alla best practice dell'applicazione di autorizzazioni con il privilegio minimo.

   Segui le istruzioni riportate nella pagina Creazione di un set di autorizzazioni nella Guida per l'utente di AWS IAM Identity Center .

2. Assegna al gruppo prima gli utenti e poi l'accesso con autenticazione unica (Single Sign-On).

   Per istruzioni, consulta Aggiungere gruppi nella Guida per l'utente di AWS IAM Identity Center .

1. Per stabilire una connessione seriale tra la macchina host e ESP32 -WROOM-32SE, installa i driver VCP da USB a UART Bridge CP21 0x. È possibile scaricare i driver da Silicon Labs.

2. Segui i passaggi per stabilire una connessione seriale con. ESP32

3. Dopo aver stabilito una connessione seriale, annotare la porta seriale per la connessione della scheda. Tale informazione sarà necessaria durante il processo di creazione della demo.

1. Configura il FreerTOS Demo Project seguendo i passaggi seguenti. Configurazione delle demo di FreerTOS Ignorare l'ultimo passaggio per formattare le credenziali AWS IoT e seguire invece i passaggi riportati di seguito.

2. Microchip ha fornito diversi strumenti di scripting per facilitare la configurazione delle parti 08A. ATECC6 Accedere alla freertos/vendors/microchip/secure_elements/app/example_trust_chain_tool directory, quindi aprire il file. README.md

3. Seguire le istruzioni contenute nel file README.md per effettuare il provisioning del dispositivo. Queste fasi includono quanto segue:

   1. Crea e registra un'autorità di certificazione con AWS

   2. Genera le tue chiavi sullo ATECC6 08A ed esporta la chiave pubblica e il numero di serie del dispositivo

   3. Genera un certificato per il dispositivo e registralo con AWS

4. Caricare il certificato CA e il certificato del dispositivo sul dispositivo seguendo le istruzioni in Distribuzione delle chiavi in modalità sviluppatore.

Per generare i file di build dell'applicazione demo con CMake

1. Vai alla directory principale della tua cartella di download di FreerTOS.

2. In una finestra della riga di comando, immettere il seguente comando per generare i file di compilazione.

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

   Note

   Per creare l'applicazione per il debug, aggiungere il flag -DCMAKE_BUILD_TYPE=Debug.

   Per generare i file di compilazione dell'applicazione di test, aggiungere il flag -DAFR_ENABLE_TESTS=1.

   Il codice fornito da Espressif utilizza lo stack IP leggero (IwIP) come stack di rete predefinito. Per utilizzare invece lo stack di rete FreeRTOS+TCP, aggiungi il flag al comando. –DAFR_ESP_FREERTOS_TCP CMake

   Per aggiungere la dipendenza LWip per il codice fornito non dal fornitore, aggiungi le seguenti righe al file CMakeLists.txt delle dipendenze, per CMake il tuo componente Wi-Fi personalizzato.

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

Per compilare l'applicazione con Make

1. Passa alla directory build.

2. In una finestra della riga di comando, immettere il seguente comando per compilare l'applicazione con Make.

   make all -j4

   Nota

   È necessario generare i file compilati con il comando cmake ogni volta che si passa dal progetto aws_demos al progetto aws_tests.

Per generare i file di build dell'applicazione demo con CMake

1. Vai alla directory principale della tua cartella di download di FreerTOS.

2. In una finestra della riga di comando, immettere il seguente comando per generare i file di compilazione.

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

   Nota

   Per creare l'applicazione per il debug, aggiungere il flag -DCMAKE_BUILD_TYPE=Debug.

   Per generare i file di compilazione dell'applicazione di test, aggiungere il flag -DAFR_ENABLE_TESTS=1.

   Il codice fornito da Espressif utilizza lo stack IP leggero (IwIP) come stack di rete predefinito. Per utilizzare invece lo stack di rete FreeRTOS+TCP, aggiungi il flag al comando. –DAFR_ESP_FREERTOS_TCP CMake

   Per aggiungere la dipendenza LWip per il codice fornito non dal fornitore, aggiungi le seguenti righe al file CMakeLists.txt delle dipendenze, per CMake il tuo componente Wi-Fi personalizzato.

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

Per compilare l'applicazione

1. Passa alla directory build.

2. In una finestra della riga di comando, immettere il seguente comando per richiamare Ninja per compilare l'applicazione.

   ninja

   Oppure, usa l'interfaccia generica CMake per creare l'applicazione.

   cmake --build your-build-directory

   Nota

   È necessario generare i file compilati con il comando cmake ogni volta che si passa dal progetto aws_demos al progetto aws_tests.

1. Per stabilire una connessione seriale tra la macchina host e ESP32 -WROOM-32SE, installa i driver VCP da USB a UART Bridge 0x. CP21 È possibile scaricare i driver da Silicon Labs.

2. Segui i passaggi per stabilire una connessione seriale con. ESP32

3. Dopo aver stabilito una connessione seriale, annotare la porta seriale per la connessione della scheda. Tale informazione sarà necessaria durante il processo di creazione della demo.

1. Configura il FreerTOS Demo Project seguendo i passaggi seguenti. Configurazione delle demo di FreerTOS Quando arrivi all'ultimo passaggio per formattare AWS IoT le tue credenziali, FERMATI e segui invece i passaggi seguenti.

2. Microchip ha fornito diversi strumenti di scripting per facilitare la configurazione dei componenti 08A. ATECC6 Passare alla directory freertos/vendors/microchip/secure_elements/app/example_trust_chain_tool e aprire il file README.md.

3. Seguire le istruzioni contenute nel file README.md per effettuare il provisioning del dispositivo. Queste fasi includono quanto segue:

   1. Crea e registra un'autorità di certificazione con AWS

   2. Genera le tue chiavi sullo ATECC6 08A ed esporta la chiave pubblica e il numero di serie del dispositivo

   3. Genera un certificato per il dispositivo e registralo con AWS

4. Caricare il certificato CA e il certificato del dispositivo sul dispositivo seguendo le istruzioni in Distribuzione delle chiavi in modalità sviluppatore.

Per creare e aggiornare il progetto

1. Vai alla directory principale della tua cartella di download di FreerTOS.

2. In una finestra a riga di comando, inserisci il seguente comando per aggiungere gli strumenti ESP-IDF al PATH del tuo terminale:

   Windows

   vendors\espressif\esp-idf\export.bat

   Linux /macOS

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

3. Configura cmake nella build directory e crea l'immagine del firmware con il seguente comando.

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

   Dovresti vedere un output come questo nell'esempio seguente.

   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' 

   Se non ci sono errori, la build genererà i file.bin binari del firmware.

4. Cancellate la memoria flash della scheda di sviluppo con il seguente comando.

   idf.py erase_flash 

5. Usa idf.py lo script per eseguire il flashing del file binario dell'applicazione sulla tua scheda.

   idf.py flash

6. Monitora l'uscita dalla porta seriale della scheda con il seguente comando.

   idf.py monitor

Per creare e aggiornare il progetto

1. In una finestra a riga di comando, vai alla radice della tua directory di download di FreerTOS.

2. Esegui lo script seguente per aggiungere gli strumenti ESP-IDF al PATH della tua shell.

   Windows

   vendors\espressif\esp-idf\export.bat

   Linux /macOS

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

3. Immettete il seguente comando per generare i file di build.

   Con 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
   

   Con 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. Cancella il flash e poi fai lampeggiare la lavagna.

   Con Unix Makefiles

   make -C ./YOUR_BUILD_DIRECTORY erase_flash

   make -C ./YOUR_BUILD_DIRECTORY flash

   Con Ninja

   ninja -C ./YOUR_BUILD_DIRECTORY erase_flash

   ninja -C ./YOUR_BUILD_DIRECTORY flash

Per abbonarsi all'argomento MQTT con il client MQTT AWS IoT

1. Accedi alla AWS IoT console .

2. Nel riquadro di navigazione scegliere Test per aprire il client MQTT.

3. In Argomento sottoscrizione, digitare your-thing-name/example/topic, quindi scegliere Effettua sottoscrizione all'argomento.