Guida introduttiva all'Espressif ESP32 - DevKit C e al ESP-WROVER-KIT

Per iscriverti a un Account AWS

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

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

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

1. Abilita IAM Identity Center.

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

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

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

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. Configura l'hardware Espressif.

   • Per informazioni sulla configurazione dell'hardware della scheda di sviluppo ESP32 - DevKit C, vedere la ESP32- Guida introduttiva di DevKit C V4.

   • Per informazioni sulla configurazione dell'hardware della scheda di ESP-WROVER-KIT sviluppo, vedere la Guida introduttiva alla ESP-WROVER-KIT V4.1.

   Importante

   Quando arrivi alla sezione Guida introduttiva delle guide di Espressif, fermati e poi torna alle istruzioni in questa pagina.

2. Scarica Amazon Free RTOS da GitHub. (Per istruzioni, consulta il READMEfile.md).

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

   1. Scarica ESP IDF l'Universal Online Installer per Windows.

   2. Esegui l'Universal Online Installer.

   3. Quando arrivi alla fase Scarica o usa ESP - IDF, seleziona Usa una IDF cartella esistente ESP - e imposta Scegli esistente ESP - IDF directory sufreertos/vendors/espressif/esp-idf.

   4. Completa l'installazione.

   macOS

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

   2. Aprire una finestra a riga di comando.

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

   4. Aggiungi gli strumenti della IDF toolchain ESP - al percorso del tuo terminale con il seguente comando.

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

   Linux

   1. 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 e torna alle istruzioni riportate in questa pagina.

   2. Aprire una finestra a riga di comando.

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

   4. Aggiungi gli strumenti della IDF toolchain ESP - al percorso del tuo terminale con il seguente comando.

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

4. Stabilisci una connessione seriale.

   1. Per stabilire una connessione seriale tra la macchina host e ESP32 - DevKit C, è necessario installare i VCP driver CP21 0x USB to UART Bridge. È possibile scaricare i driver da Silicon Labs.

      Per stabilire una connessione seriale tra la macchina host e il ESP32 - WROVER -KIT, è necessario installare il driver della COM porta FTDI virtuale. È possibile scaricare questo driver da FTDI.

   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. Ti serve per eseguire il flashing della demo.

1. Se utilizzi macOS o Linux, apri un prompt del terminale. Se usi Windows, apri l'app "ESP- IDF 4.xCMD" (se hai incluso questa opzione quando hai installato la IDF toolchain ESP -), altrimenti l'app «Command Prompt».

2. Per verificare che Python3 sia installato, esegui

   python --version

   Viene visualizzata la versione installata. Se non avete installato Python 3.0.1 o versioni successive, potete installarlo dal sito Web di Python.

3. È necessaria l'interfaccia a riga di AWS comando (CLI) per eseguire i comandi. AWS IoT Se usi Windows, usa il easy_install awscli comando per installarlo AWS CLI nell'app «Comando» o "ESP- IDF 4.xCMD».

   Se utilizzi macOS o Linux, consulta Installazione di. AWS CLI

4. Esecuzione

   aws configure

   e configurali AWS CLI con l'ID della chiave di AWS accesso, la chiave di accesso segreta e la AWS regione predefinita. Per ulteriori informazioni, vedere Configurazione di AWS CLI.

5. Usa il seguente comando per installare AWS SDK for Python (boto3):

   • Su Windows, nell'app «Comando» o "ESP- IDF 4.xCMD", esegui

     pip install boto3 --user

     Nota

     Consulta la documentazione di Boto3 per i dettagli.

   • Su macOS o Linux, esegui

     pip install tornado nose --user

     e poi esegui

     pip install boto3 --user

   Free RTOS include lo SetupAWS.py script per semplificare la configurazione della scheda Espressif a cui connettersi. AWS IoT Per configurare lo script, apri freertos/tools/aws_config_quick_start/configure.json e imposta i seguenti attributi:

   afr_source_dir

   Il percorso completo della directory freertos sul computer. Assicurarsi di utilizzare le barre per specificare questo percorso.

   thing_name

   Il nome che vuoi assegnare all' AWS IoT oggetto che rappresenta la tua scheda.

   wifi_ssid

   La SSID tua rete Wi-Fi.

   wifi_password

   La password della rete Wi-Fi.

   wifi_security

   Il tipo di sicurezza della rete Wi-Fi.

   I seguenti sono tipi di sicurezza validi:

   • eWiFiSecurityOpen (Aperto, nessuna protezione)

   • eWiFiSecurityWEP(WEPsicurezza)

   • eWiFiSecurityWPA(WPAsicurezza)

   • eWiFiSecurityWPA2(WPA2sicurezza)

6. Esegui lo script di configurazione.

   1. Se utilizzi macOS o Linux, apri un prompt del terminale. Se usi Windows, apri l'app "ESP- IDF 4.xCMD" o «Command».

   2. Vai alla freertos/tools/aws_config_quick_start directory ed esegui

      python SetupAWS.py setup

      Lo script svolge le seguenti funzioni:

      • Crea un oggetto, un certificato e una policy IoT.

      • Allega la policy IoT al certificato e il certificato all' AWS IoT oggetto.

      • Compila il aws_clientcredential.h file con l' AWS IoT endpoint, la rete Wi-Fi SSID e le credenziali.

      • Formatta il certificato e la chiave privata e li scrive nel file di intestazioneaws_clientcredential_keys.h.

      Nota

      Il certificato è codificato solo a scopo dimostrativo. Le applicazioni a livello di produzione devono archiviare questi file in un percorso sicuro.

      Per ulteriori informazioni in meritoSetupAWS.py, vedere README.md nella directory. freertos/tools/aws_config_quick_start

Per iscriverti all'MQTTargomento con il AWS IoT MQTT cliente

1. Passare alla console AWS IoT.

2. Nel riquadro di navigazione, scegli Test, quindi scegli MQTTTest Client.

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

Crea ed esegui il flash gratuitamente RTOS su Windows, Linux e macOS (ESP- IDF v4.2)

1. Vai alla radice della tua directory di RTOS download gratuiti.

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

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

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

   L'output restituito dovrebbe essere simile al 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

   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

Per creare e aggiornare il progetto

1. In una finestra a riga di comando, vai alla radice della cartella dei RTOS download gratuiti.

2. Esegui lo script seguente per aggiungere gli IDF strumenti ESP - alla shellPATH.

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

   Con 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. Compilare il progetto.

   Con Unix Makefiles

   make -C ./YOUR_BUILD_DIRECTORY -j8 

   Con Ninja

   ninja -C ./YOUR_BUILD_DIRECTORY -j8

5. 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 configurare l'applicazione SDK demo mobile Free RTOS Bluetooth Low Energy

1. Segui le istruzioni riportate SDK mobili per dispositivi Bluetooth FreerTOS per scaricarla e installarla SDK per la tua piattaforma mobile sul tuo computer host.

2. Seguire le istruzioni in Applicazione dimostrativa FreerTOS Bluetooth Low Energy Mobile SDK per configurare l'applicazione demo mobile sul dispositivo mobile.