Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Guida introduttiva all'ESP32Espressif - -32SE WROOM
Importante
Questa integrazione di riferimento è ospitata nel RTOS repository Amazon-Free che è obsoleto. Ti consigliamo di iniziare da qui quando crei un nuovo progetto. Se hai già un RTOS progetto Free esistente basato sull'ormai obsoleto repository Amazon-FreeRTOS, consulta il. Guida alla migrazione del RTOS repository Github gratuito da Amazon
Nota
-
Attualmente, la RTOS porta gratuita per ESP32 - WROOM -32SE non supporta la funzionalità symmetric multiprocessing (). SMP
Questo tutorial mostra come iniziare con Espressif - -32SE. ESP32 WROOM Per acquistarne uno dal nostro partner nel catalogo Partner Device, AWS vedi - -32SE. ESP32 WROOM
Panoramica
Questo tutorial descrive le seguenti procedure:
-
Connessione della scheda a un computer host.
-
Installazione del software sul computer host per lo sviluppo e il debug di applicazioni integrate per la scheda con microcontrollore.
-
Compila in modo incrociato un'applicazione RTOS demo gratuita su un'immagine binaria.
-
Caricamento dell'immagine binaria dell'applicazione sulla scheda in uso e successiva esecuzione dell'applicazione.
-
Monitora ed esegui il debug dell'applicazione in esecuzione utilizzando una connessione seriale.
Prerequisiti
Prima di iniziare a usare Free RTOS sulla tua scheda Espressif, devi configurare il tuo AWS account e le autorizzazioni.
Registrati per un Account AWS
Se non ne hai uno Account AWS, completa i seguenti passaggi per crearne uno.
Per iscriverti a un Account AWS
Apri la https://portal.aws.amazon.com/billing/registrazione.
Segui le istruzioni online.
Nel corso della procedura di registrazione riceverai una telefonata, durante la quale sarà necessario inserire un codice di verifica attraverso la 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.
AWS ti invia un'email di conferma dopo il completamento della procedura di registrazione. In qualsiasi momento, puoi visualizzare l'attività corrente del tuo account e gestirlo accedendo a https://aws.amazon.com/
Crea un utente con accesso amministrativo
Dopo esserti registrato Account AWS, proteggi Utente root dell'account AWS AWS IAM Identity Center, abilita e crea un utente amministrativo in modo da non utilizzare l'utente root per le attività quotidiane.
Proteggi i tuoi Utente root dell'account AWS
-
Accedi AWS Management Console
come 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 .
-
Attiva l'autenticazione a più fattori (MFA) per il tuo utente root.
Per istruzioni, consulta Abilitare un MFA dispositivo virtuale per l'utente Account AWS root (console) nella Guida per l'IAMutente.
Crea un utente con accesso amministrativo
-
Abilita IAM Identity Center.
Per istruzioni, consulta Abilitazione di AWS IAM Identity Center nella Guida per l'utente di AWS IAM Identity Center .
-
In IAM Identity Center, concedi 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 i valori predefiniti IAM Identity Center directory nella Guida per l'AWS IAM Identity Center utente.
Accesso come utente amministratore
-
Per accedere con l'utente dell'IAMIdentity Center, utilizza l'accesso URL che è stato inviato al tuo indirizzo e-mail quando hai creato l'utente IAM Identity Center.
Per informazioni sull'accesso tramite un utente di IAM Identity Center, consulta Accesso al portale di AWS accesso nella Guida per l'Accedi ad AWS utente.
Assegna l'accesso a ulteriori utenti
-
In IAM Identity Center, crea un set di autorizzazioni che segua la migliore pratica di applicazione delle autorizzazioni con privilegi minimi.
Segui le istruzioni riportate nella pagina Creazione di un set di autorizzazioni nella Guida per l'utente di AWS IAM Identity Center .
-
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 .
Per fornire l'accesso, aggiungi autorizzazioni ai tuoi utenti, gruppi o ruoli:
-
Utenti e gruppi in: AWS IAM Identity Center
Crea un set di autorizzazioni. Segui le istruzioni riportate nella pagina Create a permission set (Creazione di un set di autorizzazioni) nella Guida per l'utente di AWS IAM Identity Center .
-
Utenti gestiti IAM tramite un provider di identità:
Crea un ruolo per la federazione delle identità. Segui le istruzioni riportate in Creare un ruolo per un provider di identità di terze parti (federazione) nella Guida per l'IAMutente.
-
IAMutenti:
-
Crea un ruolo che l'utente possa assumere. Segui le istruzioni riportate in Creare un ruolo per un IAM utente nella Guida per l'IAMutente.
-
(Non consigliato) Collega una policy direttamente a un utente o aggiungi un utente a un gruppo di utenti. Segui le istruzioni riportate in Aggiungere autorizzazioni a un utente (console) nella Guida per l'IAMutente.
-
Inizia a usare
Nota
I comandi Linux in questo tutorial richiedono l'uso della shell Bash.
-
Configura l'hardware Espressif.
Per informazioni sulla configurazione dell'hardware della scheda di sviluppo ESP32 - WROOM -32SE, consultate la ESP32- DevKit C
V4 Getting Started Guide. Importante
Una volta raggiunta la sezione Step by Step della guida, prosegui fino al completamento del Passaggio 4 (Impostazione delle variabili di ambiente). Interrompi dopo aver completato il Passaggio 4 e segui i passaggi rimanenti qui.
-
Scarica Amazon Free RTOS da GitHub
. (Per istruzioni, consulta il READMEfile.md ). -
Configura il tuo ambiente di sviluppo.
Per comunicare con la scheda, è necessario installare una toolchain. Espressif fornisce la ESP possibilità di sviluppare software IDF per le proprie schede. Poiché ESP - IDF ha una propria versione del RTOS kernel gratuito integrata come componente, Amazon Free RTOS include una versione personalizzata di ESP - IDF v4.2 con il RTOS kernel gratuito rimosso. Questo risolve i problemi relativi ai file duplicati durante la compilazione. Per utilizzare la versione personalizzata di ESP - IDF v4.2 inclusa in Amazon FreeRTOS, segui le istruzioni riportate di seguito per il sistema operativo della tua macchina host.
Windows
-
Scarica ESP IDF l'Universal Online Installer per Windows
. -
Esegui l'Universal Online Installer.
-
Quando arrivi alla fase Scarica o usa ESP - IDF, seleziona Usa una IDF cartella esistente ESP - e imposta Scegli esistente ESP - IDF directory su
.freertos
/vendors/espressif/esp-idf -
Completa l'installazione.
macOS
-
Segui le istruzioni nella configurazione standard dei prerequisiti della Toolchain (ESP- IDF v4.2) per
macOS. Importante
Quando raggiungi le istruzioni «Ottieni ESP -IDF» in Passaggi successivi, interrompi e poi torna alle istruzioni in questa pagina.
-
Aprire una finestra a riga di comando.
-
Vai alla directory dei RTOS download gratuiti, quindi esegui lo script seguente per scaricare e installare la toolchain espressif per la tua piattaforma.
vendors/espressif/esp-idf/install.sh
-
Aggiungi gli strumenti della IDF toolchain ESP - al percorso del tuo terminale con il seguente comando.
source vendors/espressif/esp-idf/export.sh
Linux
-
Segui le istruzioni riportate nella Configurazione standard dei prerequisiti della Toolchain (ESP- IDF v4.2
) per Linux. Importante
Quando raggiungi le istruzioni «Ottieni ESP -IDF» riportate nella sezione Passaggi successivi, interrompi l'operazione e torna alle istruzioni riportate in questa pagina.
-
Aprire una finestra a riga di comando.
-
Vai alla directory dei RTOS download gratuiti, quindi esegui lo script seguente per scaricare e installare la toolchain Espressif per la tua piattaforma.
vendors/espressif/esp-idf/install.sh
-
Aggiungi gli strumenti della IDF toolchain ESP - al percorso del tuo terminale con il seguente comando.
source vendors/espressif/esp-idf/export.sh
-
-
Stabilisci una connessione seriale.
-
Per stabilire una connessione seriale tra la macchina host e il ESP32 - WROOM -32SE, installa i driver CP21 0x USB to UART Bridge. VCP È possibile scaricare i driver da Silicon Labs
. -
Segui i passaggi per stabilire una connessione seriale con
. ESP32 -
Dopo aver stabilito una connessione seriale, annotare la porta seriale per la connessione della scheda. Ti serve per eseguire il flashing della demo.
-
Configura le applicazioni RTOS demo gratuite
Per questo tutorial, il file RTOS di configurazione gratuito si trova in
. (Ad esempio, se freertos
/vendors/espressif/boards/board-name
/aws_demos/config_files/FreeRTOSConfig.hAFR_BOARD espressif.esp32_devkitc
viene scelto, il file di configurazione si trova in
.) freertos
/vendors/espressif/boards/esp32/aws_demos/config_files/FreeRTOSConfig.h
Importante
Il dispositivo ATECC6 08A ha un'inizializzazione unica che viene bloccata sul dispositivo la prima volta che viene eseguito un progetto (durante la chiamata a). C_InitToken
Tuttavia, il progetto RTOS demo gratuito e il progetto di test hanno configurazioni diverse. Se il dispositivo è bloccato durante le configurazioni del progetto demo, non tutti i test nel progetto di test avranno esito positivo.
-
Configura il progetto Free RTOS Demo seguendo i passaggi indicatiConfigurazione delle demo gratuite RTOS. Quando arrivi all'ultimo passaggio per formattare AWS IoT le tue credenziali, fermati ed esegui i seguenti passaggi.
-
Microchip ha fornito diversi strumenti di scripting per facilitare la configurazione dei componenti 08A. ATECC6 Passare alla directory
e aprire il filefreertos
/vendors/microchip/example_trust_chain_toolREADME.md
. -
Per effettuare il provisioning del dispositivo, seguite le istruzioni contenute nel file.
README.md
Queste fasi includono quanto segue:-
Crea e registra un'autorità di certificazione con AWS.
-
Genera le tue chiavi sullo ATECC6 08A ed esporta la chiave pubblica e il numero di serie del dispositivo.
-
Genera un certificato per il dispositivo e registralo con AWS.
-
-
Caricare il certificato CA e il certificato del dispositivo sul dispositivo seguendo le istruzioni in Distribuzione delle chiavi in modalità sviluppatore.
Monitoraggio MQTT dei messaggi sul AWS cloud
Prima di eseguire il progetto RTOS demo gratuito, puoi configurare il MQTT client nella AWS IoT console per monitorare i messaggi che il tuo dispositivo invia al AWS Cloud.
Per iscriverti all'MQTTargomento con il AWS IoT MQTT cliente
-
Accedere alla console AWS IoT
. -
Nel riquadro di navigazione, scegli Test, quindi scegli MQTTTest Client.
-
Nell'argomento Abbonamento, inserisci
e quindi scegli Sottoscrivi all'argomento.your-thing-name
/example/topic
Crea, esegui il flashing ed esegui il progetto RTOS demo gratuito utilizzando lo script idf.py
È possibile utilizzare l'IDFutilità di Espressif (idf.py
) per generare i file di build, creare il file binario dell'applicazione e eseguire il flashing dei file binari sul dispositivo.
Nota
Alcune configurazioni potrebbero richiedere l'utilizzo dell'opzione port "-p port-name
" con idf.py
per specificare la porta corretta, come nell'esempio seguente.
idf.py -p /dev/cu.usbserial-00101301B flash
Crea ed esegui il flash gratuitamente RTOS su Windows, Linux e macOS (ESP- IDF v4.2)
-
Vai alla radice della tua directory di RTOS download gratuiti.
-
In una finestra a riga di comando, inserisci il seguente comando per aggiungere gli IDF strumenti ESP - al tuo terminalePATH:
- Windows (app «Comando»)
-
vendors\espressif\esp-idf\export.bat
- Windows (app» ESP - IDF CMD 4x")
-
(Questa operazione è già stata eseguita quando hai aperto l'app).
- Linux /macOS
-
source vendors/espressif/esp-idf/export.sh
-
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.
-
Cancellate la memoria flash della scheda di sviluppo con il seguente comando.
idf.py erase_flash
-
Usa
idf.py
lo script per eseguire il flashing del file binario dell'applicazione sulla tua scheda.idf.py flash
-
Monitora l'uscita dalla porta seriale della scheda con il seguente comando.
idf.py monitor
Nota
-
È possibile combinare questi comandi come nell'esempio seguente.
idf.py erase_flash flash monitor
-
Per alcune configurazioni della macchina host, è necessario specificare la porta quando si esegue il flashing della scheda, come nell'esempio seguente.
idf.py erase_flash flash monitor -p /dev/ttyUSB1
-
Build and Flash Free con RTOS CMake
Oltre a utilizzare lo idf.py
script fornito da IDF SDK per creare ed eseguire il codice, puoi anche creare il progetto conCMake. Attualmente supporta Unix Makefile e il sistema di build Ninja.
Per creare e aggiornare il progetto
-
In una finestra a riga di comando, vai alla radice della cartella dei RTOS download gratuiti.
-
Esegui lo script seguente per aggiungere gli IDF strumenti ESP - a quelli della tua shellPATH.
- Windows
-
vendors\espressif\esp-idf\export.bat
- Linux /macOS
-
source vendors/espressif/esp-idf/export.sh
-
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
-
Cancella il flash e poi fai lampeggiare la lavagna.
- Con Unix Makefiles
-
make -C ./
YOUR_BUILD_DIRECTORY
erase_flashmake -C ./
YOUR_BUILD_DIRECTORY
flash - Con Ninja
-
ninja -C ./
YOUR_BUILD_DIRECTORY
erase_flashninja -C ./
YOUR_BUILD_DIRECTORY
flash
Informazioni aggiuntive
Per ulteriori informazioni sull'utilizzo e la risoluzione dei problemi delle ESP32 schede Espressif, consulta i seguenti argomenti: