ESPRESSIF ESP32-WROOM-DA Modulu Standalone cù Doppia Antenna Manuale d'Usuariu

Notificazione di cambiamentu di documentazione
Espressif furnisce notificazioni per email per mantenevi aghjurnatu 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.

1. Sopraview

1.1 Modulu Overview
ESP32-WROOM-DA hè un putente modulu Wi-Fi + Bluetooth + Bluetooth LE MCU, cù duie antenne PCB cumplementarii in direzzione diffirenti. Stu modulu hè integratu cù ESP32-D0WD-V3 cù un riccu set di cumpunenti integrati cumpresi SPI flash è oscillatore di cristallo 40 MHz. Cù duie antenne uniche cuncepite nantu à un solu modulu, ESP32-WROOM-DA pò esse aduprata per sviluppà applicazioni IoT chì necessitanu una connettività stabile nantu à un largu spettru, o per implementà Wi-Fi in ambienti difficili è periculosi, o per superà i prublemi di cumunicazione in Wi. - Lochi fi-morti. Stu modulu hè una scelta ideale per i dispositi interni è esterni per a casa intelligente, u cuntrollu industriale, l'elettronica di cunsumu, etc.

Tabella 1: Specificazioni ESP32WROOMDA

1.2 Descrizzione Pin
U diagramma di pin sottu mostra u locu apprussimativu di i pin è e duie antenne nantu à u modulu.

Figura 1: Disposizione Pin (Top View)

U modulu hà 41 pins è dui punti di prova. Vede e definizione di pin in a Tabella 2.

Table 2: Pin Definitions

1. Per cunfigurazioni di pin periferiche, fate riferimentu à a Scheda di Dati di Serie ESP32.
2. GPIO2 è GPIO25 nantu à u chip ESP32-D0WD-V3 sò designati cum'è punti di teste per cuntrullà u Switch RF.
I dui pins ùn sò micca purtati fora à u modulu. Per selezziunà l'antenna di travagliu, (Antenna 1 o Antenna 2), cunfigurà GPIO2 è GPIO25 cum'è seguente:

Table 3: Selezziunà l'antenna di travagliu

2. Cumincià nantu à ESP32WROOMDA

2.1 Ciò chì avete bisognu

Per sviluppà applicazioni per u modulu avete bisognu:

1 x Modulu ESP32-WROOM-DA
1 x Scheda di prova RF Espressif

1 x scheda USB-to-Serial
1 x cavu Micro-USB

1 x PC cù Linux

In questa guida d'utilizatore, pigliamu u sistema operatore Linux cum'è example. Per più infurmazione nantu à a cunfigurazione in Windows è macOS, fate riferimentu à a Guida di Programmazione ESP-IDF.

2.2 Cunnessione Hardware

Salda u modulu ESP32-WROOM-DA à a scheda di prova RF cum'è mostra in Figura 2. Figura 2: Cunnessione Hardware
Cunnette a scheda di prova RF à a scheda USB-to-Serial via TXD, RXD è GND.
Cunnette vi USB-to-Serial bordu à u PC.
Cunnette a scheda di prova RF à u PC o un adattatore di alimentazione per attivà l'alimentazione 5 V, via u cable Micro-USB.
Durante u scaricamentu, cunnette IO0 à GND via un jumper. Allora, turnate "ON" u bordu di prova.
Scaricate u firmware in u flash. Per i dettagli, vede e rùbbriche sottu.
Dopu a scaricamentu, sguassate u jumper in IO0 è GND.
Accende di novu a scheda di prova RF. ESP32-WROOM-DA passerà à u modu di travagliu. U chip leghje i prugrammi da u lampu dopu l'inizializazione.

Nota:
IO0 hè internamente alta logica. Se IO0 hè stallatu per pull-up, u modu Boot hè sceltu. Se stu pin hè pull-down o lasciatu flottante, u modu Download hè sceltu. Per più infurmazione nantu à ESP32-WROOM-DA, fate riferimentu à ESP32-WROOM-DA Datasheet.

2.3 Stallà l'ambiente di sviluppu

L'Espressif IoT Development Framework (ESP-IDF in breve) hè un framework per sviluppà applicazioni basate nantu à Espressif ESP32. L'utilizatori ponu sviluppà applicazioni cù ESP32 in Windows / Linux / macOS basatu annantu à ESP-IDF.
Quì avemu pigliatu u sistema operatore Linux cum'è example.

2.3.1 Installa Prerequisites
Per cumpilà cù ESP-IDF avete bisognu di ottene i seguenti pacchetti:

CentOS 7:
sudo yum install git wget flex bison gperf python cmake ninja-build ccache dfu-util
Ubuntu è Debian (un cumandamentu si divide in duie linee):
sudo apt-get install git wget flex bison gperf python python-pip python-setuptools cmake
ninja-build ccache libffi-dev libssl-dev dfu-util
arcu:
sudo pacman -S -necessariu gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util

Nota:

Questa guida usa u cartulare ~/esp in Linux cum'è un cartulare di installazione per ESP-IDF.
Tenite in mente chì ESP-IDF ùn sustene micca spazii in camini.

2.3.2 Get ESPIDF
Per custruisce applicazioni per u modulu ESP32-WROOM-DA, avete bisognu di e librerie di software furnite da Espressif in u repository ESP-IDF.
Per uttene ESP-IDF, crea un cartulare di installazione (~/esp) per scaricà ESP-IDF è clone u repository cù 'git clone':
mkdir -p ~/esp
cd ~/esp
git clone -recursive https://github.com/espressif/esp-idf.git
ESP-IDF serà scaricatu in ~/esp/esp-idf. Cunsultate Versioni ESP-IDF per infurmazione nantu à quale versione ESP-IDF à aduprà in una situazione determinata.

2.3.3 Setup Tools
A parte di l'ESP-IDF, avete ancu bisognu di installà l'arnesi utilizati da ESP-IDF, cum'è u compilatore, debugger, pacchetti Python, etc. ESP-IDF furnisce un script chjamatu 'install.sh' per aiutà à stallà l'arnesi. in una volta.
cd ~/esp/esp-idf
./install.sh

2.3.4 Configurate Variabili di Ambiente
L'arnesi installati ùn sò micca ancu aghjuntu à a variabile d'ambiente PATH. Per fà l'arnesi utilizable da a linea di cummanda, alcune variabili di l'ambiente deve esse stabilitu. ESP-IDF furnisce un altru script "export.sh" chì face questu. In u terminale induve avete aduprà ESP-IDF, eseguite:
. $HOME/esp/esp-idf/export.sh
Avà tuttu hè prontu, pudete custruisce u vostru primu prughjettu nantu à u modulu ESP32-WROOM-DA.

2.4 Crea u vostru primu prughjettu

2.4.1 Principià un Prughjettu
Avà site prontu à preparà a vostra applicazione per u modulu ESP32-WROOM-DA. Pudete principià cù u prugettu get-started/hello_world da exampl'annuariu les in ESP-IDF.
Copia get-started/hello_world in u cartulare ~/esp:
cd ~/esp
cp -r $IDF_PATH/examples/get-started/hello_world .
Ci hè una gamma di example prughjetti in l'exampl'annuariu les in ESP-IDF. Pudete copià ogni prughjettu in u listessu modu cum'è prisentatu sopra è eseguisce. Hè ancu pussibule di custruisce examples in-place, senza copiarli prima.

2.4.2 Cunnette u vostru Dispositivu
Avà cunnette u vostru modulu ESP32-WROOM-DA à l'urdinatore è verificate sottu quale portu seriale u modulu hè visibile. I porti seriali in Linux cumincianu cù '/dev/tty' in i so nomi. Eseguite u cumandamentu sottu duie volte, prima cù u bordu unplugged, dopu cù plugged in. U portu chì appare a seconda volta hè quellu chì avete bisognu:
ls /dev/tty*

Nota:
Mantene a porta u nome di u portu cum'è avete bisognu in i prossimi passi.

2.4.3 Cunfigurà
Navigate à u vostru cartulare "hello_world" da u Passu 2.4.1. Avviate un Prughjettu, stabilisce u chip ESP32 cum'è u scopu è eseguite l'utilità di cunfigurazione di u prughjettu 'menuconfig'.
cd ~/esp/hello_world
idf.py set-target esp32
idf.py menuconfig

Setting the target with 'idf.py set-target esp32' deve esse fattu una volta, dopu avè apertu un novu prughjettu. Se u prughjettu cuntene alcune custruzzioni è cunfigurazione esistenti, seranu sbulicati è inizializzati. U mira pò esse salvatu in a variabile di l'ambiente per saltà stu passu in tuttu. Vede Selezzione di u Target per infurmazioni supplementari.
Se i passi precedenti sò stati fatti currettamente, u seguente menu appare:

Figura 3: Finestra di cunfigurazione di u prugettu

I culori di u menu puderia esse diffirenti in u vostru terminal. Pudete cambià l'apparenza cù l'opzione '-style'.
Eseguite 'idf.py menuconfig –help' per più infurmazione.

2.4.4 Custruì u Prughjettu
Custruite u prugettu eseguendu:
idf.py custruisce

Stu cumandimu compilerà l'applicazione è tutti i cumpunenti ESP-IDF, allora generà u bootloader, a tabella di partizioni è i binari di l'applicazione.

$ idf.py custruisce
Esegue cmake in u cartulare /path/to/hello_world/build
Esecuzione di "cmake -G Ninja -warn-uninitialized /path/to/hello_world"...
Avvertite nantu à i valori micca inizializzati.
- Trova Git: /usr/bin/git (versione trovata "2.17.0")
- Custruisce un cumpunente aws_iot viotu per via di a cunfigurazione
- Nomi di cumpunenti: ...
— Percorsi di cumpunenti:…

... (più linee di output di u sistema di creazione)

[527/527] Generazione di hello-world.bin
estool.py v2.3.1

Custruzzione di prughjettu cumpletu. Per lampassi, eseguite stu cumandamentu:

../../../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
o eseguite 'idf.py -p PORT flash'

Se ùn ci sò micca errori, a custruzzione finisce generendu u binariu di firmware .bin file.

2.4.5 Flash nantu à u Dispositivu
Flash i binari chì avete appena custruitu nantu à u vostru modulu ESP32-WROOM-DA eseguendu:
idf.py -p PORT [-b BAUD] flash
Sustituisci PORT cù u nome di u portu seriale di u vostru modulu da Step: Connect Your Device.
Pudete ancu cambià a velocità di baud di u flasher rimpiazzendu BAUD cù u baud rate chì avete bisognu. U baud rate predeterminatu hè 460800.
Per più infurmazione nantu à l'argumenti idf.py, vede idf.py. Se tuttu va bè, l'applicazione "hello_world" cumencia à curriri dopu chì avete sguassatu u jumper in IO0 è GND, è rinfriscà a scheda di prova.

Nota:
L'opzione 'flash' custruisce automaticamente è lampeghja u prughjettu, cusì l'esecuzione 'idf.py build' ùn hè micca necessariu.

Eseguisce esptool.py in u cartulare […]/esp/hello_world
Esecuzione di "python [...]/esp-idf/components/esptool_py/esptool/esptool.py -b 460800 write_flash
@flash_project_args"...
esptool.py -b 460800 write_flash –flash_mode dio –flash_size detect –flash_freq 40m 0x1000
bootloader/bootloader.bin 0x8000 partition_table/partition-table.bin 0x10000 hello-world.bin
estool.py v2.3.1
Cunnessu….
Rilevamentu di u tipu di chip... ESP32
U chip hè ESP32
Caratteristiche: WiFi, BT, Dual Core
Caricà stub...
Stub in corsa...
Stub running...
Cambia u baud rate à 460800
Cambiatu.
Configurazione di a dimensione di u flash...
Dimensione Flash rilevata automaticamente: 8 MB
Paràmetri di u Flash stabilitu à 0x0220
Cumpressu 22992 bytes à 13019 ...
Scrive 22992 bytes (13019 compressi) à 0x00001000 in 0.3 seconde (effettiva 558.9 kbit/s)...
Hash di dati verificatu.
Cumpressu 3072 bytes à 82 ...
Scrive 3072 bytes (82 compressi) à 0x00008000 in 0.0 seconde (effettiva 5789.3 kbit/s)...
Hash di dati verificatu.
Cumpressu 136672 bytes à 67544 ...
Scrive 136672 bytes (67544 compressi) à 0x00010000 in 1.9 seconde (effettiva 567.5 kbit/s)...
Hash di dati verificatu.

Partendu…
Resettazione dura via pin RTS...

2.4.6 Monitor
Per verificà se "hello_world" hè veramente in esecuzione, scrivite 'idf.py -p PORT monitor' Ùn vi scurdate di rimpiazzà PORT cù u vostru nome di portu seriale).

Questu cumanda lancia l'applicazione IDF Monitor:

$ idf.py -p /dev/ttyUSB0 monitor
Esecuzione di idf_monitor in u cartulare […]/esp/hello_world/build
Esecuzione di "python [...]/esp-idf/tools/idf_monitor.py -b 115200

[…]/esp/hello_world/build/hello-world.elf”…
- idf_monitor nantu à /dev/ttyUSB0 115200 -
— Quit: Ctrl+] | Menu: Ctrl+T | Aiutu: Ctrl + T seguita da Ctrl + H -
ets 8 Jun 2016 00:22:57

rst: 0x1 (POWERON_RESET), boot: 0x13 (SPI_FAST_FLASH_BOOT)
ets 8 Jun 2016 00:22:57
…

Dopu à l'iniziu è i logs di diagnostica scorri, duvete vede "Hello world!" stampatu da l'applicazione.
…
Salutu mondu !
Ripartendu in 10 seconde...
Questu hè un chip esp32 cù 2 core CPU, WiFi / BT / BLE, rivisione di silicone 3, flash 8MB
Ripartendu in 9 seconde...
Ripartendu in 8 seconde...
Ripartendu in 7 seconde...

Per esce da u monitor IDF, utilizate a scorciata Ctrl +].
Hè tuttu ciò chì avete bisognu per inizià cù u modulu ESP32-WROOM-DA! Avà vi sò prontu à pruvà qualchi altru examples in ESP-IDF, o vai dritta à sviluppà u vostru propriu applicazioni.

3. US FCC Statement

ID FCC: 2AC7ZESPWROOMDA
Stu dispusitivu hè conforme à a Parte 15 di e regule FCC. U funziunamentu hè sottumessu à i seguenti dui cundizioni:

Stu dispusitivu ùn pò causari interferenza dannusu.

Stu dispusitivu deve accettà ogni interferenza ricevuta, cumpresi l'interferenza chì pò causà operazione indesiderata.

Stu equipamentu hè statu pruvatu è truvatu cum'è i limiti per un dispositivu digitale di Classe B, in cunfurmità cù a Parte 15 di e Regule FCC. Questi limiti sò pensati per furnisce una prutezzione raghjone contr'à l'interferenza dannosa in una stallazione residenziale.

Stu equipamentu genera, usa è pò irradià energia di freccia radio è, s'ellu ùn hè micca stallatu è utilizatu in cunfurmità cù l'istruzzioni, pò causà interferenza dannosa à e cumunicazioni radio. Tuttavia, ùn ci hè micca guarantisci chì l'interferenza ùn accade micca in una stallazione particulare. Se stu equipamentu provoca interferenze dannusu à a ricezione di a radiu o di a televisione, chì pò esse determinata spegnendu è accendendu l'equipaggiu, l'utilizatore hè incuraghjitu à pruvà à curregà l'interferenza cù una di e seguenti misure:

Riorientate o rilocate l'antenna di ricezione.
Aumente a separazione trà l'equipaggiu è u ricevitore.
Cunnette l'equipaggiu in una presa in un circuitu diversu da quellu à quale hè cunnessu u ricevitore.

Cunsultate u rivenditore o un tecnicu espertu di radio/TV per aiutu.

Attenzione:
Qualchese mudificazione o mudificazione chì ùn hè micca espressamente appruvata da a parte rispunsevuli di u rispettu pò annullà l'autorità di l'utilizatore per operà l'equipaggiu.

Stu equipamentu hè conforme à i limiti di esposizione à a radiazione RF di FCC stabiliti per un ambiente senza cuntrollu. Stu dispositivu è a so antenna ùn deve esse micca situati o operati in cunjunzione cù qualsiasi altra antenna o trasmettitore. L'antenne aduprate per stu trasmettitore devenu esse installate per furnisce una distanza di separazione di almenu 20 cm da tutte e persone è ùn deve esse micca situate o operate in cunjunzione cù qualsiasi altra antenna o trasmettitore.

Per i mercati europei, e direttive pertinenti sò menzionate quì sottu:
Hè a rispunsabilità di u fabricatore di u pruduttu finali di verificà se altre norme, raccomandazioni o direttive sò o micca in vigore fora di queste zone. Per piacè nutate chì i requisiti SAR sò specifichi solu per i dispositi portatili è micca per i dispositi mobili cum'è definitu quì sottu:

Dispositivu portatile: Un dispositivu portatile hè definitu cum'è un dispositivu trasmettitore pensatu per esse usatu in modu chì a struttura radiante (s) di u dispusitivu hè / sò in 20 centimetri di u corpu di l'utilizatore.
Dispositivu mobile: Un dispositivu mobile hè definitu cum'è un dispositivu trasmettitore cuncepitu per esse usatu in altri posti fissi è per esse generalmente utilizatu in tale manera chì una distanza di separazione di almenu 20 centimetri hè normalmente mantenuta trà e strutture radianti di u trasmettitore. è u corpu di l'utilizatore o persone vicine. In questu cuntestu, u terminu "locu fissu" significa chì u dispusitivu hè fisicu assicuratu in un locu è ùn pò micca esse facilmente spustatu in un altru locu.

Istruzzioni d'integrazione OEM
Stu dispusitivu hè pensatu solu per l'integratori OEM in e seguenti cundizioni U modulu pò esse usatu per installà in un altru host. L'antenna deve esse stallata in modu chì 20 cm hè mantinutu trà l'antenna è l'utilizatori, è u modulu di trasmettitore ùn pò micca esse situatu cù altre trasmissioni o antenne. U modulu deve esse usatu solu cù l'antenna integrale chì hè stata testata è certificata in origine cù stu modulu. Sempre chì e cundizioni 3 sopra sò soddisfatte, ùn sarà micca necessariu più teste di trasmettitore. Tuttavia, l'integratore OEM hè sempre rispunsevule per pruvà u so pruduttu finale per qualsiasi requisitu di cunfurmità supplementu cù stu modulu installatu (per ex.ample, emissione di dispositivi digitale, esigenze periferiche di PC, etc.)

Avvisu:
In l'eventuali chì queste cundizioni ùn ponu esse rispettate (per esampcerta cunfigurazione di laptop o co-location cù un altru trasmettitore), allora l'autorizazione FCC per stu modulu in cumbinazione cù l'equipaggiu ospitu ùn hè più cunsideratu validu è l'ID FCC di u modulu ùn pò micca esse usatu in u pruduttu finali. In questi è circustanza, l'integratore OEM farà
esse rispunsevuli di rivalutà. U pruduttu finitu (cumpresu u trasmettitore) è ottene una autorizazione FCC separata.

U pruduttu finale finale deve esse etichettatu in una zona visibile cù i seguenti: "Contene Modulu Trasmettitore FCC ID: 2AC7ZESPWROOMDA" o "Contene ID FCC: 2AC7ZESPWROOMDA".

4. Documentazione è risorse Related

Documentazione Relativa

Manuale di Riferimentu Tecnicu ESP32 - Informazioni dettagliate nantu à cumu utilizà a memoria ESP32 è i periferichi.

Scheda dati di a serie ESP32 - Specificazioni di u hardware ESP32.
Linee guida di cuncepimentu di hardware ESP32 - Linee guida nantu à cumu integrà l'ESP32 in u vostru pruduttu hardware.
ESP32 ECO è Soluzioni per i Bugs - Correzione di l'errori di cuncepimentu ESP32.

Certificati
http://espressif.com/en/support/documents/certificates
Notificazioni di cambiamentu di produttu/prucessu ESP32 (PCN)
http://espressif.com/en/support/documents/pcns
Cunsiglii ESP32 - Informazioni nantu à a sicurità, i bug, a cumpatibilità, l'affidabilità di i cumpunenti.
http://espressif.com/en/support/documents/advisories

L'aghjurnamenti di a documentazione è l'aghjurnamenti di l'abbonamentu di a notificazione
http://espressif.com/en/support/download/documents

Zona di sviluppatori

Guida di Programmazione ESP-IDF per ESP32 - Ampia documentazione per u quadru di sviluppu ESP-IDF.

ESP-IDF è altri quadri di sviluppu nantu à GitHub.
http://github.com/espressif
Forum ESP32 BBS - Community Engineer-to-Engineer (E2E) per i prudutti Espressif induve pudete postà e dumande,
sparte a cunniscenza, scopre idee è aiuta à risolve i prublemi cù i so cumpagni ingegneri.
http://esp32.com/
L'ESP Journal - Best Practices, Articuli, è Note da Espressif folks.
http://medium.com/the-esp-journal

Vede e tabulazioni SDK è Demos, Apps, Tools, AT Firmware.
http://espressif.com/en/support/download/sdks-demos

I prudutti

SoC di a serie ESP32 - Sfoglia tutti i SoC ESP32.
http://espressif.com/en/products/socs?id=ESP32

Moduli di Serie ESP32 - Sfoglia tutti i moduli basati in ESP32.
http://espressif.com/en/products/modules?id=ESP32
ESP32 Series DevKits - Sfoglia tutti i devkits basati in ESP32.
http://espressif.com/en/products/devkits?id=ESP32
Selettore di produttu ESP - Truvate un pruduttu hardware Espressif adattatu per i vostri bisogni paragunendu o applicà filtri.
http://products.espressif.com/#/product-selector?language=en

Cuntatta ci

Vede e tabulazioni Domande di vendita, Domande tecniche, Schema di circuitu è Disegnu PCB Review, pigliate Samples (Magazzini in linea), Diventate u nostru Fornitore, Cumenti è Suggerimenti.
http://espressif.com/en/contact-us/sales-questions

Storia di rivisione

Disclaimer è Avvisu di Copyright

L'infurmazioni in stu documentu, cumprese URL riferimenti, hè sottumessu à cambià senza avvisu.
TUTTE L'INFORMAZIONI DI TERZI IN QUESTU DOCUMENTU hè furnita cum'è, senza alcuna garanzia per a so autenticità è precisione. NESSUNA GARANTIA hè furnita à stu ducumentu per a so cummercialità, senza infrazione, idoneità à ogni scopu particulari, nè alcuna garanzia altrimenti derivanti da ogni pruposta, specificazione o s.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è a
marca registrata di Bluetooth SIG.

Tutti i nomi di cummerciale, i marchi è i marchi registrati citati in stu documentu sò pruprietà
di i so rispettivi pruprietarii, è sò cunnisciuti.

Leghjite più nantu à stu manuale è scaricate PDF:

Documenti / Risorse

Modulu StandAlone ESPRESSIF ESP32-WROOM-DA cù Doppia Antenna [pdfManuale d'usu
ESP32 -WROOM- DA, Modulu Stand Alone cù Doppia Antenna, ESP32 -WROOM-DA Modulu Stand Alone cù Doppia Antenna

Referenze

Manuale d'usu