Schede di sviluppu ESPRESSIF ESP32-JCI-R
À propositu di Sta Guida
Stu documentu hè destinatu à aiutà l'utilizatori à stallà l'ambiente di sviluppu di software di basa per u sviluppu di applicazioni chì utilizanu hardware basatu nantu à u modulu ESP32-JCI-R.
Note di rilascio
| Data | Versione | Note di liberazione |
| 2020.7 | V0.1 | Liberazione preliminare. |
Notificazione di cambiamentu di documentazione
Espressif furnisce e-mail notifiche per mantene i clienti aghjurnati nantu à i cambiamenti à a documentazione tecnica. Per piacè abbonate à www.espressif.com/en/subscribe.
Certificazione
Scaricate i certificati per i prudutti Espressif da www.espressif.com/en/certificates.
Introduzione
ESP32-JCI-R
ESP32-JCI-R hè un modulu MCU Wi-Fi + BT + BLE putente è genericu chì mira à una larga varietà di applicazioni, chì varieghja da e rete di sensori di bassa putenza à i travaglii più esigenti, cum'è codificazione di voce, streaming di musica è decodificazione MP3. . À u core di stu modulu hè u chip ESP32-D0WD-V3. U chip integratu hè pensatu per esse scalabile è adattativu. Ci hè dui core CPU chì ponu esse cuntrullati individualmente, è a frequenza di u clock CPU hè regulabile da 80 MHz à 240 MHz. L'utilizatore pò ancu spegne u CPU è aduprà u co-processore di bassa putenza per monitorizà constantemente i periferichi per cambiamenti o attraversà i soglia. ESP32 integra un riccu inseme di periferiche, chì varieghja da sensori capacitivi touch, sensori Hall, interfaccia di carta SD, Ethernet, SPI d'alta velocità, UART, I2S è I2C. L'integrazione di Bluetooth, Bluetooth LE è Wi-Fi assicura chì una larga gamma d'applicazioni ponu esse destinate è chì u modulu hè a prova di u futuru: l'usu di Wi-Fi permette una larga gamma fisica è una cunnessione diretta à l'internet attraversu un Wi-Fi. U router durante l'usu di Bluetooth permette à l'utilizatori di cunnetta convenientemente à u telefunu o trasmette balise di bassa energia per a so rilevazione. U currente di sonnu di u chip ESP32 hè menu di 5 μA, facendu adattatu per l'applicazioni elettroniche alimentate da batterie è purtate. ESP32 supporta una velocità di dati finu à 150 Mbps, è una putenza di output di 20 dBm à l'antenna per assicurà a più larga gamma fisica. Comu tali, u chip offre specificazioni di punta in l'industria è u megliu rendimentu per l'integrazione elettronica, a gamma, u cunsumu di energia è a cunnessione. U sistema operatore sceltu per ESP32 hè freeRTOS cù LwIP; TLS 1.2 cù accelerazione hardware hè ancu integrata. L'aghjurnamentu di sicurezza (criptatu) sopra l'aria (OTA) hè ancu supportatu per chì i sviluppatori ponu aghjurnà continuamente i so prudutti ancu dopu a so liberazione.
ESP-IDF
L'Espressif IoT Development Framework (ESP-IDF in breve) hè un framework per sviluppà applicazioni basate nantu à Espressif ESP32. L'utilizatori ponu sviluppà applicazioni in Windows / Linux / MacOS basatu annantu à ESP-IDF.
Preparazione
Per sviluppà applicazioni per ESP32-JCI-R avete bisognu:
- PC caricatu cù u sistema operatore Windows, Linux o Mac
- Toolchain per custruisce l'Applicazione per ESP32
- ESP-IDF cuntene essenzialmente API per ESP32 è scripts per uperà a catena di strumenti
- Un editore di testu per scrive prugrammi (Progetti) in C, per esempiu, Eclipse
- A scheda ESP32 stessu è un cable USB per cunnette à u PC
Cuminciate
Configurazione di Toolchain
U modu più veloce per inizià u sviluppu cù ESP32 hè di installà una catena di strumenti precustruita. Pigliate u vostru OS quì sottu è seguitate istruzzioni furnite.
- Windows
- Linux
- Mac OS
Nota:
Utilizemu u repertoriu ~/esp per installà a catena di strumenti predefinita, ESP-IDF è sample applicazioni. Pudete aduprà un cartulare sfarente, ma avete bisognu di aghjustà i cumandamenti rispettivi. Sicondu a vostra sperienza è e preferenze, invece di utilizà una catena di strumenti prebuilt, pudete vulete persunalizà u vostru ambiente. Per cunfigurà u sistema in u vostru modu, andate à a sezione Configurazione Personalizzata di Toolchain.
Quandu avete finitu di stallà a catena di strumenti, andate à a sezione Get ESP-IDF.
Ottene ESP-IDF
In più di a catena di strumenti (chì cuntene prugrammi per cumpilà è custruisce l'applicazione), avete ancu bisognu di API / biblioteche ESP32 specifiche. Sò furniti da Espressif in u repository ESP-IDF.
Per uttene, apre u terminal, navigate à u cartulare chì vulete mette ESP-IDF, è clone cù u cumandimu git clone:
- cd ~/esp
- git clone -recursive https://github.com/espressif/esp-idf.git
ESP-IDF serà scaricatu in ~/esp/esp-idf.
Nota:
Ùn mancate micca l'opzione -recursive. Se avete digià clonatu ESP-IDF senza questa opzione, eseguite un altru cumandamentu per uttene tutti i submoduli:
- cd ~/esp/esp-idf
- git submodule update -init
Configurate Path à ESP-IDF
I prugrammi di a catena di strumenti accede à ESP-IDF utilizendu a variabile d'ambiente IDF_PATH. Questa variàbile deve esse stallata nantu à u vostru PC, altrimenti, i prughjetti ùn si custruiscenu micca. U paràmetru pò esse fattu manualmente, ogni volta chì u PC hè riavviatu. Un'altra opzione hè di cunfigurà in permanenza definendu IDF_PATH in u prufilu d'utilizatore. Per fà quessa, seguite l'istruzzioni in Add IDF_PATH à u Profilu d'Usuariu.
Inizià un Prughjettu
Avà site prontu à preparà a vostra applicazione per ESP32. Per cumincià rapidamente, useremu u prughjettu hello_world da l'exampl'annuariu les in IDF.
Copia get-started/hello_world in u cartulare ~/esp:
- cd ~/esp
- cp -r $IDF_PATH/examples/get-started/hello_world .
Pudete ancu truvà una gamma di example prughjetti sottu à l'exampl'annuariu les in ESP-IDF. Questi example directory di u prughjettu pò esse copiatu in u listessu modu cum'è prisentatu sopra, per inizià i vostri prughjetti.
Nota:
U sistema di custruzione ESP-IDF ùn sustene micca spazii in camini à ESP-IDF o à prughjetti.
Cunnette
Ci site quasi. Per pudè prucede più, cunnette a scheda ESP32 à u PC, verificate sottu à quale portu seriale hè visibile a scheda è verificate se a cumunicazione seriale funziona. Se ùn site micca sicuru cumu fà, verificate l'istruzzioni in Stabbilisce a cunnessione seriale cù ESP32. Nota u numeru di portu, cum'è serà necessariu in u prossimu passu.
Configurà
Esse in una finestra di terminal, andate à u cartulare di l'applicazione hello_world scrivite cd ~/esp/hello_world. Allora lanciate l'utilità di cunfigurazione di u prugettu menuconfig:
- cd ~/esp/hello_world fate menuconfig
Se i passi precedenti sò stati fatti currettamente, u menu seguente serà visualizatu: 
In u menù, navigate à Serial flasher config> Port serial Default per cunfigurà u portu seriale, induve u prughjettu serà caricatu. Cunfirmate a selezzione premendu Enter, salvà
cunfigurazione scegliendu , è dopu esce da l'applicazione selezziunate .
Nota:
In Windows, i porti seriali anu nomi cum'è COM1. In macOS, cumincianu cù /dev/cu. In Linux, cumincianu cù /dev/tty. (Vede Stabbilisce a Connessione Seriale cù ESP32 per tutti i dettagli.)
Eccu alcuni cunsiglii nantu à a navigazione è l'usu di menuconfig:
- set up & down keys freccia per navigà u menu.
- Aduprate a chjave Enter per andà in un submenu, a chjave Escape per esce o per esce.
- Tipu ? per vede una pantalla d'aiutu. Enter key esce da u screnu d'aiutu.
- Aduprate a chjave di u spaziu, o i chjavi Y è N per attivà (Sì) è disattivà (No) elementi di cunfigurazione cù caselle di spunta "[*]".
- Pressing ? mentre evidenziate un articulu di cunfigurazione mostra aiutu annantu à quellu articulu.
- Type / per circà l'articuli di cunfigurazione.
Nota:
Sè vo site un utilizatore Arch Linux, navigate à a cunfigurazione di l'utillita SDK è cambia u nome di l'interprete Python 2 da python à python2.
Custruite è Flash
Avà pudete custruisce è lampà l'applicazione. Corri:
fà flash
Questu compilerà l'applicazione è tutti i cumpunenti ESP-IDF, generà u bootloader, a tavola di partizioni è i binari di l'applicazione, è flash questi binari à a vostra scheda ESP32. 
Se ùn ci sò micca prublemi, à a fine di u prucessu di custruzzione, duvete vede i missaghji chì descrizanu u prugressu di u prucessu di carica. Infine, u modulu finale serà resettatu è l'applicazione "hello_world" principia. Se vulete usà l'IDE Eclipse invece di eseguisce make, verificate Build and Flash with Eclipse IDE.
Monitor
Per vede se l'applicazione "hello_world" hè veramente in esecuzione, scrive make monitor. Stu cumandamentu lancia l'applicazione IDF Monitor:
Parechje linee sottu, dopu l'iniziu è u logu di diagnosticu, duvete vede "Hello world!" stampatu da l'applicazione. 
Per esce da u monitor, utilizate a scorciata Ctrl +].
Nota:
Se invece di i missaghji sopra, vedete a basura casuale o u monitor fallenu pocu dopu a carica, u vostru bordu hè prubabilmente utilizendu un cristallu 26MHz, mentre chì l'ESP-IDF assume un predeterminatu di 40MHz. Esci da u monitor, torna à u menuconfigurazione, cambia CONFIG_ESP32_XTAL_FREQ_SEL à 26MHz, poi custruite è flash l'applicazione di novu. Questu si trova in make menuconfig in Component config -> ESP32-specific - Frequenza XTAL principale. Per eseguisce make flash and make monitor in one go, type fa u monitor flash. Verificate a sezione IDF Monitor per accurtatoghji pratichi è più dettagli nantu à l'usu di sta applicazione. Hè tuttu ciò chì avete bisognu per cumincià cù ESP32! Avà vi sò prontu à pruvà qualchi altru examples o vai dritta à sviluppà e vostre propiu applicazioni.
Disclaimer è Avvisu di Copyright
L'infurmazioni in stu documentu, cumprese URL riferimenti, hè sottumessu à cambià senza avvisu. QUESTU DOCUMENTU hè furnitu cum'è hè, senza alcuna garanzia, cumpresa qualsiasi garanzia di cummercializazione, non-infrazione, idoneità à ogni scopu particulare, o qualsiasi garanzia chì altrimenti derivanu da ogni pruposta, specificazione,AMPLE. Ogni rispunsabilità, cumpresa a responsabilità per a violazione di qualsiasi diritti di pruprietariu, in relazione à l'usu di l'infurmazioni in stu documentu hè rinunziata. Nisuna licenze espresse o implicite, per estoppel o altrimenti, à qualsiasi diritti di pruprietà intellettuale sò cuncede quì. U logu Wi-Fi Alliance Member hè una marca di u Wi-Fi Alliance. U logu Bluetooth hè una marca registrata di Bluetooth SIG. Tutti i nomi di cummerciale, i marchi è i marchi registrati citati in stu documentu sò a pruprietà di i so rispettivi pruprietarii è sò ricunnisciuti da quì.
Copyright © 2018 Espressif Inc. Tutti i diritti riservati.
Documenti / Risorse
 |
Schede di sviluppu ESPRESSIF ESP32-JCI-R [pdfManuale d'usu ESP32JCIR, 2AC7Z-ESP32JCIR, 2AC7ZESP32JCIR, ESP32-JCI-R, Schede di Sviluppu, ESP32-JCI-R Schede di Sviluppu, Schede |
