Uživatelská příručka ESPRESSIF ESP32-WROOM-DA Samostatný modul se dvěma anténami
Samostatný modul se dvěma anténami
Obsahuje UltraLowPower SoC s dvoujádrovým CPU
Podpora 2.4 GHz WiFi, Bluetooth® a Bluetooth LE
O tomto dokumentu
Tato uživatelská příručka ukazuje, jak začít s modulem ESP32-WROOM-DA.
Aktualizace dokumentů
Vždy se prosím podívejte na nejnovější verzi na https://www.espressif.com/en/support/download/documents.
Historie revizí
Historii revizí tohoto dokumentu naleznete na poslední stránce.
Oznámení o změně dokumentace
Espressif poskytuje e-mailová upozornění, abyste byli informováni o změnách technické dokumentace. Odebírejte prosím na www.espressif.com/en/subscribe.
Osvědčení
Stáhněte si certifikáty pro produkty Espressif z www.espressif.com/en/certificates.
1. Přesview
1.1 Modul přesview
ESP32-WROOM-DA je výkonný modul Wi-Fi + Bluetooth + Bluetooth LE MCU se dvěma doplňkovými anténami PCB v různých směrech. Tento modul je osazený s ESP32-D0WD-V3 s bohatou sadou integrovaných komponent včetně SPI flash a 40 MHz krystalového oscilátoru. Díky dvěma jedinečným anténám na jednom jediném modulu lze ESP32-WROOM-DA použít k vývoji aplikací IoT, které potřebují stabilní připojení v širokém spektru, nebo k nasazení Wi-Fi v náročných a nebezpečných prostředích nebo k překonání komunikačních problémů v Wi-Fi. -Fi-mrtvá místa. Tento modul je ideální volbou pro vnitřní i venkovní zařízení pro chytrou domácnost, průmyslové řízení, spotřební elektroniku atd.
Tabulka 1: Specifikace ESP32WROOMDA
1.2 Popis kolíku
Schéma pinů níže ukazuje přibližné umístění pinů a dvou antén na modulu.
Obrázek 1: Rozložení kolíků (nahoře View)
Modul má 41 pinů a dva testovací body. Viz definice pinů v tabulce 2.
Tabulka 2: Definice pinů
1. Konfigurace periferních kolíků viz katalogový list řady ESP32.
2. GPIO2 a GPIO25 na čipu ESP32-D0WD-V3 jsou navrženy jako testovací body pro ovládání RF přepínače.
Dva kolíky nejsou vyvedeny do modulu. Chcete-li vybrat pracovní anténu (Anténa 1 nebo Anténa 2), nakonfigurujte GPIO2 a GPIO25 následovně:
Tabulka 3: Vyberte pracovní anténu
2. Začněte na ESP32WROOMDA
2.1 Co potřebujete
K vývoji aplikací pro modul potřebujete:
- 1 x modul ESP32-WROOM-DA
- 1 x testovací deska Espressif RF
- 1 x deska USB-to-Serial
- 1 x kabel micro-USB
- 1 x PC s operačním systémem Linux
V této uživatelské příručce bereme jako příklad operační systém Linuxample. Další informace o konfiguraci ve Windows a macOS najdete v ESP-IDF Programming Guide.
2.2 Hardwarové připojení
- Připájejte modul ESP32-WROOM-DA k RF testovací desce, jak je znázorněno na obrázku 2.
Obrázek 2: Hardwarové připojení - Připojte RF testovací desku k USB-to-Serial desce přes TXD, RXD a GND.
- Připojte desku USB-to-Serial k počítači.
- Připojte RF testovací desku k PC nebo napájecímu adaptéru, abyste umožnili napájení 5 V pomocí kabelu Micro-USB.
- Během stahování propojte IO0 s GND pomocí propojky. Poté testovací desku zapněte.
- Stáhněte si firmware do flash. Podrobnosti viz sekce níže.
- Po stažení odstraňte propojku na IO0 a GND.
- Znovu zapněte RF testovací desku. ESP32-WROOM-DA se přepne do pracovního režimu. Čip bude číst programy z flash po inicializaci.
Poznámka:
IO0 je vnitřně logické vysoké. Pokud je IO0 nastaveno na pull-up, je vybrán režim Boot. Pokud je tento špendlík stahovací nebo plovoucí, je vybrán režim stahování. Další informace o ESP32-WROOM-DA naleznete v datovém listu ESP32-WROOM-DA.
2.3 Nastavení vývojového prostředí
Espressif IoT Development Framework (zkráceně ESP-IDF) je framework pro vývoj aplikací založených na Espressif ESP32. Uživatelé mohou vyvíjet aplikace s ESP32 ve Windows/Linux/macOS založené na ESP-IDF.
Zde bereme operační systém Linux jako example.
2.3.1 Předpoklady instalace
Ke kompilaci s ESP-IDF potřebujete získat následující balíčky:
- Cent OS 7:
sudo yum install git wget flex bison gperf python cmake ninja-build ccache dfu-util - Ubuntu a Debian (jeden příkaz se rozdělí na dva řádky):
sudo apt-get install git wget flex bison gperf python python-pip python-setuptools cmake
ninja-build ccache libffi-dev libssl-dev dfu-util - Oblouk:
sudo pacman -S – potřeba gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util
Poznámka:
- Tato příručka používá adresář ~/esp v systému Linux jako instalační složku pro ESP-IDF.
- Mějte na paměti, že ESP-IDF nepodporuje mezery v cestách.
2.3.2 Získejte ESPIDF
Chcete-li vytvářet aplikace pro modul ESP32-WROOM-DA, potřebujete softwarové knihovny poskytované společností Espressif v repozitáři ESP-IDF.
Chcete-li získat ESP-IDF, vytvořte instalační adresář (~/esp), do kterého stáhněte ESP-IDF a naklonujte úložiště pomocí 'git clone':
mkdir -p ~/esp
cd ~/esp
git klon – rekurzivní https://github.com/espressif/esp-idf.git
ESP-IDF bude staženo do ~/esp/esp-idf. Informace o tom, kterou verzi ESP-IDF použít v dané situaci, najdete ve verzích ESP-IDF.
2.3.3 Nastavení nástrojů
Kromě ESP-IDF musíte také nainstalovat nástroje používané ESP-IDF, jako je kompilátor, debugger, balíčky Pythonu atd. ESP-IDF poskytuje skript s názvem 'install.sh', který vám pomůže nastavit nástroje. na jeden zátah.
cd ~/esp/esp-idf
./install.sh
2.3.4 Nastavení proměnných prostředí
Nainstalované nástroje ještě nejsou přidány do proměnné prostředí PATH. Aby byly nástroje použitelné z příkazového řádku, musí být nastaveny některé proměnné prostředí. ESP-IDF poskytuje další skript 'export.sh', který to dělá. V terminálu, kde budete používat ESP-IDF, spusťte:
. $HOME/esp/esp-idf/export.sh
Nyní je vše připraveno, můžete postavit svůj první projekt na modulu ESP32-WROOM-DA.
2.4 Vytvořte svůj první projekt
2.4.1 Zahájení projektu
Nyní jste připraveni připravit aplikaci pro modul ESP32-WROOM-DA. Můžete začít s projektem get-started/hello_world od examples v ESP-IDF.
Zkopírujte get-started/hello_world do adresáře ~/esp:
cd ~/esp
cp -r $IDF_PATH/examples/get-started/hello_world .
Existuje řada example projekty v examples v ESP-IDF. Jakýkoli projekt můžete zkopírovat stejným způsobem, jak je uvedeno výše, a spustit jej. Je také možné postavit exampsoubory na místě, aniž byste je nejprve zkopírovali.
2.4.2 Připojte své zařízení
Nyní připojte váš modul ESP32-WROOM-DA k počítači a zkontrolujte, pod jakým sériovým portem je modul viditelný. Sériové porty v Linuxu začínají v názvu '/dev/tty'. Spusťte níže uvedený příkaz dvakrát, nejprve s odpojenou deskou a poté se zapojenou. Port, který se objeví podruhé, je ten, který potřebujete:
ls /dev/tty*
Poznámka:
Mějte po ruce název portu, protože jej budete potřebovat v dalších krocích.
2.4.3 Konfigurujte
Přejděte do svého adresáře 'hello_world' z kroku 2.4.1. Spusťte projekt, nastavte čip ESP32 jako cíl a spusťte konfigurační nástroj projektu 'menuconfig'.
cd ~/esp/hello_world
idf.py set-target esp32
idf.py menuconfig
Nastavení cíle pomocí 'idf.py set-target esp32' by mělo být provedeno jednou, po otevření nového projektu. Pokud projekt obsahuje některá existující sestavení a konfigurace, budou vymazány a inicializovány. Cíl lze uložit do proměnné prostředí a tento krok vůbec přeskočit. Další informace naleznete v části Výběr cíle.
Pokud byly předchozí kroky provedeny správně, zobrazí se následující nabídka:
Obrázek 3: Domovské okno Konfigurace projektu
Barvy nabídky se mohou ve vašem terminálu lišit. Vzhled můžete změnit volbou '–style'.
Pro další informace spusťte 'idf.py menuconfig –help'.
2.4.4 Sestavení projektu
Sestavte projekt spuštěním:
sestavení idf.py
Tento příkaz zkompiluje aplikaci a všechny komponenty ESP-IDF, poté vygeneruje zavaděč, tabulku oddílů a binární soubory aplikace.
$ idf.py sestavení
Spuštění cmake v adresáři /path/to/hello_world/build
Probíhá „cmake -G Ninja –warn-uninicialized /path/to/hello_world“…
Varovat před neinicializovanými hodnotami.
— Nalezen Git: /usr/bin/git (nalezená verze „2.17.0“)
— Vytvoření prázdné komponenty aws_iot kvůli konfiguraci
— Názvy součástí: …
— Cesty součástí: …
… (více řádků výstupu sestavení systému)
[527/527] Generování hello-world.binesptool.py v2.3.1
Stavba projektu dokončena. Chcete-li flashovat, spusťte tento příkaz:
../../../components/esptool_py/esptool/esptool.py -p (PORT) -b 921600 write_flash –flash_mode dio
–detekce velikosti flash –flash_freq 40m 0x10000 sestavení/hello-world.bin sestavení 0x1000
build/bootloader/bootloader.bin 0x8000 build/table_partition_table/partition-table.bin
nebo spusťte 'idf.py -p PORT flash'
Pokud se nevyskytnou žádné chyby, sestavení se dokončí vygenerováním binárního souboru .bin firmwaru file.
2.4.5 Flash na zařízení
Flashujte binární soubory, které jste právě zabudovali do modulu ESP32-WROOM-DA spuštěním:
idf.py -p PORT [-b BAUD] flash
Nahraďte PORT názvem sériového portu vašeho modulu z kroku: Připojení zařízení.
Přenosovou rychlost blikání můžete také změnit nahrazením BAUD přenosovou rychlostí, kterou potřebujete. Výchozí přenosová rychlost je 460800 XNUMX.
Další informace o argumentech idf.py naleznete v tématu idf.py. Pokud vše půjde dobře, po odstranění propojky na IO0 a GND a opětovném zapnutí testovací desky se spustí aplikace „hello_world“.
Poznámka:
Možnost 'flash' automaticky vytvoří a flashuje projekt, takže spouštění 'idf.py build' není nutné.
Spuštění esptool.py v adresáři […]/esp/hello_world
Spouštění ”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 –detekce velikosti_flash –flash_freq 40m 0x1000
bootloader/bootloader.bin 0x8000 partition_table/partition-table.bin 0x10000 hello-world.bin
esptool.py v2.3.1
Spojovací….
Detekce typu čipu… ESP32
Čip je ESP32
Vlastnosti: WiFi, BT, Dual Core
Nahrávání útržku…
Běžící pahýl…
Stub běží…
Změna přenosové rychlosti na 460800
Změněno.
Konfigurace velikosti blesku…
Automaticky detekovaná velikost Flash: 8 MB
Parametry Flash nastaveny na 0x0220
Zkomprimováno 22992 bajtů na 13019…
Napsal 22992 bajtů (13019 komprimováno) při 0x00001000 za 0.3 sekundy (efektivní 558.9 kbit/s)…
Hash dat ověřen.
Zkomprimováno 3072 bajtů na 82…
Napsal 3072 bajtů (82 komprimováno) při 0x00008000 za 0.0 sekundy (efektivní 5789.3 kbit/s)…
Hash dat ověřen.
Zkomprimováno 136672 bajtů na 67544…
Napsal 136672 bajtů (67544 komprimováno) při 0x00010000 za 1.9 sekundy (efektivní 567.5 kbit/s)…
Hash dat ověřen.
Odcházení…
Tvrdý reset přes RTS pin…
2.4.6 Monitor
Chcete-li zkontrolovat, zda „hello_world“ skutečně běží, zadejte 'idf.py -p PORT monitor' Nezapomeňte nahradit PORT názvem vašeho sériového portu).
Tento příkaz spustí aplikaci IDF Monitor:
$ idf.py -p /dev/ttyUSB0 monitor
Spuštění idf_monitor v adresáři […]/esp/hello_world/build
Spouštění ”python […]/esp-idf/tools/idf_monitor.py -b 115200
— idf_monitor na /dev/ttyUSB0 115200 —
— Konec: Ctrl+] | Menu: Ctrl+T | Nápověda: Ctrl+T následovaná Ctrl+H —
ets 8. června 2016 00:22:57
rst:0x1 (POWERON_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)
ets 8. června 2016 00:22:57
…
Po spuštění a diagnostických protokolech rolování nahoru by se mělo zobrazit „Ahoj světe!“ vytištěné aplikací.
…
Ahoj světe!
Restartování za 10 sekund…
Toto je čip esp32 se 2 jádry CPU, WiFi/BT/BLE, křemíková revize 3, 8 MB flash
Restartování za 9 sekund…
Restartování za 8 sekund…
Restartování za 7 sekund…
Pro ukončení IDF monitoru použijte klávesovou zkratku Ctrl+].
To je vše, co potřebujete, abyste mohli začít s modulem ESP32-WROOM-DA! Nyní jste připraveni vyzkoušet další exampv ESP-IDF, nebo přejděte rovnou k vývoji vlastních aplikací.
3. Prohlášení FCC USA
FCC ID: 2AC7ZESPWROOMDA
Toto zařízení vyhovuje části 15 pravidel FCC. Provoz podléhá následujícím dvěma podmínkám:
- Toto zařízení nesmí způsobovat škodlivé rušení.
- Toto zařízení musí akceptovat jakékoli přijaté rušení, včetně rušení, které může způsobit nežádoucí provoz.
Toto zařízení bylo testováno a shledáno vyhovujícím omezením pro digitální zařízení třídy B podle části 15 pravidel FCC. Tyto limity jsou navrženy tak, aby poskytovaly přiměřenou ochranu před škodlivým rušením při instalaci v domácnosti.
Toto zařízení generuje, používá a může vyzařovat vysokofrekvenční energii a pokud není instalováno a používáno v souladu s pokyny, může způsobovat škodlivé rušení rádiové komunikace. Nelze však zaručit, že při konkrétní instalaci k rušení nedojde. Pokud toto zařízení způsobuje škodlivé rušení rádiového nebo televizního příjmu, což lze zjistit vypnutím a zapnutím zařízení, doporučujeme uživateli, aby se pokusil napravit rušení jedním z následujících opatření:
- Přeorientujte nebo přemístěte přijímací anténu.
- Zvětšete vzdálenost mezi zařízením a přijímačem.
- Připojte zařízení do zásuvky v jiném okruhu, než ke kterému je připojen přijímač.
- Požádejte o pomoc prodejce nebo zkušeného rádiového/TV technika.
Pozor:
Jakékoli změny nebo úpravy, které nejsou výslovně schváleny stranou odpovědnou za shodu, mohou zrušit oprávnění uživatele provozovat zařízení.
Toto zařízení vyhovuje limitům FCC pro vystavení vysokofrekvenčnímu záření stanoveným pro nekontrolované prostředí. Toto zařízení a jeho anténa nesmí být umístěny nebo provozovány ve spojení s jinou anténou nebo vysílačem. Antény použité pro tento vysílač musí být instalovány tak, aby byla zajištěna vzdálenost nejméně 20 cm od všech osob a nesmějí být umístěny nebo provozovány ve spojení s jinou anténou nebo vysílačem.
Pro evropské trhy jsou příslušné směrnice uvedeny níže:
Je odpovědností výrobce konečného produktu ověřit, zda mimo tyto oblasti platí další normy, doporučení nebo směrnice. Upozorňujeme, že požadavky na SAR jsou specifické pouze pro přenosná zařízení, nikoli pro mobilní zařízení, jak je definováno níže:
- Přenosné zařízení: Přenosné zařízení je definováno jako vysílací zařízení navržené k použití tak, aby vyzařující struktura (struktury) zařízení byla/jsou do 20 centimetrů od těla uživatele.
- Mobilní zařízení: Mobilní zařízení je definováno jako vysílací zařízení navržené k použití na jiných než pevných místech a obecně k použití takovým způsobem, že mezi vyzařovací konstrukcí (strukturami) vysílače je normálně zachována vzdálenost nejméně 20 centimetrů. a tělo uživatele nebo blízkých osob. V této souvislosti termín „pevné umístění“ znamená, že zařízení je fyzicky zabezpečeno na jednom místě a není možné jej snadno přesunout na jiné místo.
Pokyny pro integraci OEM
Toto zařízení je určeno pouze pro OEM integrátory za následujících podmínek Modul lze použít k instalaci do jiného hostitele. Anténa musí být instalována tak, aby mezi anténou a uživateli byla zachována vzdálenost 20 cm a vysílací modul nesmí být umístěn společně s jinou vysílací nebo anténou. Modul lze používat pouze s integrovanou anténou (anténami), která byla původně testována a certifikována s tímto modulem. Pokud jsou splněny 3 výše uvedené podmínky, další test vysílače nebude vyžadován. Integrátor OEM je však stále zodpovědný za testování jejich koncového produktu z hlediska jakýchkoli dalších požadavků na shodu s tímto nainstalovaným modulem (např.ample, vyzařování digitálního zařízení, požadavky na periferní zařízení PC atd.)
Oznámení:
V případě, že tyto podmínky nelze splnit (napřample určitou konfiguraci notebooku nebo společné umístění s jiným vysílačem), pak se autorizace FCC pro tento modul v kombinaci s hostitelským zařízením již nepovažuje za platnou a FCC ID modulu nelze použít na konečném produktu. Za těchto okolností bude OEM integrátor
být zodpovědný za přehodnocení. Konečný produkt (včetně vysílače) a získání samostatné autorizace FCC.
Konečný konečný produkt musí být na viditelném místě označen následujícím textem: „Obsahuje modul vysílače FCC ID: 2AC7ZESPWROOMDA“ nebo „Obsahuje ID FCC: 2AC7ZESPWROOMDA“.
Související dokumentace
- Technická referenční příručka ESP32 – Podrobné informace o použití paměti a periferií ESP32.
- Katalogový list řady ESP32 – Specifikace hardwaru ESP32.
- Pokyny k návrhu hardwaru ESP32 – Pokyny k integraci ESP32 do vašeho hardwarového produktu.
- ESP32 ECO a řešení pro chyby – Oprava chyb návrhu ESP32.
- Certifikáty
http://espressif.com/en/support/documents/certificates - Oznámení o změně produktu/procesu ESP32 (PCN)
http://espressif.com/en/support/documents/pcns - ESP32 Advisories – Informace o zabezpečení, chybách, kompatibilitě, spolehlivosti komponent.
http://espressif.com/en/support/documents/advisories - Aktualizace dokumentace a předplatné upozornění na aktualizace
http://espressif.com/en/support/download/documents
Vývojářská zóna
- ESP-IDF Programming Guide for ESP32 – Rozsáhlá dokumentace pro vývojový rámec ESP-IDF.
- ESP-IDF a další vývojové rámce na GitHubu.
http://github.com/espressif - Fórum ESP32 BBS – Komunita mezi inženýry a inženýry (E2E) pro produkty Espressif, kde můžete pokládat dotazy,
sdílet znalosti, zkoumat nápady a pomáhat řešit problémy s kolegy inženýry.
http://esp32.com/ - ESP Journal – Nejlepší postupy, články a poznámky od lidí z Espressif.
http://medium.com/the-esp-journal - Viz karty SDK a Ukázky, Aplikace, Nástroje, Firmware AT.
http://espressif.com/en/support/download/sdks-demos
Produkty
- SoC řady ESP32 – procházejte všechny SoC ESP32.
http://espressif.com/en/products/socs?id=ESP32 - Moduly řady ESP32 – Prohlédněte si všechny moduly založené na ESP32.
http://espressif.com/en/products/modules?id=ESP32 - Devkity řady ESP32 – procházejte všechny devkity založené na ESP32.
http://espressif.com/en/products/devkits?id=ESP32 - ESP Product Selector – Najděte hardwarový produkt Espressif vhodný pro vaše potřeby porovnáním nebo použitím filtrů.
http://products.espressif.com/#/product-selector?language=en
Kontaktujte nás
- Podívejte se na záložky Prodejní otázky, Technické dotazy, Schéma zapojení a návrh PCB Review, Získejte Samples (Internetové obchody), Staňte se naším dodavatelem, Komentáře a návrhy.
http://espressif.com/en/contact-us/sales-questions
Historie revizí
Zřeknutí se odpovědnosti a upozornění na autorská práva
Informace v tomto dokumentu, včetně URL reference, podléhá změnám bez upozornění.
VŠECHNY INFORMACE TŘETÍCH STRAN V TOMTO DOKUMENTU JSOU POSKYTOVÁNY TAK JAK JSOU, BEZ ŽÁDNÝCH ZÁRUK NA JEHO PRAVOSTI A PŘESNOST. NA TENTO DOKUMENT SE NEPOSKYTUJE ŽÁDNÁ ZÁRUKA ZA JEHO PRODEJNOST, NEPORUŠENÍ PRÁV, VHODNOST PRO JAKÝKOLI KONKRÉTNÍ ÚČEL A NEVZTAHUJE SE ŽÁDNÁ ZÁRUKA JINAK VYPLÝVAJÍCÍ Z JAKÉHOKOLI NÁVRHU, SPECIFIKACE NEBO SAMPLE.
Veškerá odpovědnost, včetně odpovědnosti za porušení jakýchkoliv vlastnických práv, týkající se použití informací v tomto dokumentu, se zříká. Nejsou zde uděleny žádné vyjádřené nebo předpokládané licence k právům duševního vlastnictví, ať už estoppelem nebo jinak.
Logo člena Wi-Fi Alliance je ochrannou známkou Wi-Fi Alliance. Logo Bluetooth je a
registrovaná ochranná známka společnosti Bluetooth SIG.
Všechny obchodní názvy, ochranné známky a registrované ochranné známky uvedené v tomto dokumentu jsou majetkem
jejich příslušných vlastníků a jsou tímto potvrzeny.
Copyright © 2021 Espressif Systems (Shanghai) Co., Ltd. Všechna práva vyhrazena.
Přečtěte si více o této příručce a stáhněte si PDF:
Dokumenty / zdroje
 |
Samostatný modul ESPRESSIF ESP32-WROOM-DA se dvěma anténami [pdfUživatelská příručka ESP32 -WROOM- DA, samostatný modul se dvěma anténami, samostatný modul ESP32 -WROOM- DA se dvěma anténami |
