Упатство за употреба ESPRESSIF ESP32-WROOM-DA StandAlone модул со двојна антена

Самостоен модул со двојни антени
Содржи UltraLowPower SoC со DualCore процесор
Поддржува WiFi, Bluetooth® и Bluetooth LE од 2.4 GHz

 

За овој документ

Ова упатство за корисникот покажува како да започнете со модулот ESP32-WROOM-DA.

Ажурирања на документи
Секогаш повикувајте се на најновата верзија на https://www.espressif.com/en/support/download/documents.

Историја на ревизии
За историјата на ревизии на овој документ, ве молиме погледнете ја последната страница.

Известување за промена на документацијата
Espressif обезбедува известувања по е-пошта за да ве информира за промените во техничката документација. Ве молиме претплатете се на www.espressif.com/en/subscribe.

Сертификација
Преземете сертификати за производите на Espressif од www.espressif.com/en/certificates.

 

1. Во текотview

1.1 Модулот завршиview
ESP32-WROOM-DA е моќен Wi-Fi + Bluetooth + Bluetooth LE MCU модул, со две дополнителни PCB антени во различни насоки. Овој модул е ​​вграден со ESP32-D0WD-V3 со богат сет на интегрирани компоненти вклучувајќи SPI блиц и кристален осцилатор од 40 MHz. Со две уникатни дизајни на антени на еден единствен модул, ESP32-WROOM-DA може да се користи за развој на IoT апликации на кои им е потребна стабилна поврзаност преку широк спектар, или за распоредување Wi-Fi во предизвикувачки и опасни средини или за надминување на проблемите во комуникацијата во Wi -Фај-мртви точки. Овој модул е ​​идеален избор за внатрешни и надворешни уреди за паметен дом, индустриска контрола, потрошувачка електроника итн.

Табела 1: Спецификации на ESP32WROOMDA

1.2 Опис на ПИН
Дијаграмот на пиновите подолу ја покажува приближната локација на пиновите и двете антени на модулот.

Слика 1: Распоред на иглички (горе View)

Модулот има 41 пина и две точки за тестирање. Видете ги дефинициите на пиновите во Табела 2.

Табела 2: Дефиниции за иглички

1. За конфигурациите на периферните пинови, погледнете го листот со податоци од серијата ESP32.
2. GPIO2 и GPIO25 на чипот ESP32-D0WD-V3 се дизајнирани како точки за тестирање за контрола на RF Switch.
Двата пина не се изведени до модулот. За да ја изберете работната антена, (Антена 1 или Антена 2), конфигурирајте ги GPIO2 и GPIO25 на следниов начин:

Табела 3: Изберете Работна антена

 

2. Започнете со ESP32WROOMDA

2.1 Што ви треба

За да развиете апликации за модул ви треба:

• 1 x ESP32-WROOM-DA модул
• 1 x Espressif RF плочка за тестирање
• 1 x USB-to-Serial плоча
• 1 x Micro-USB кабел
• 1 x компјутер со Linux

Во ова упатство за корисникот, го земаме оперативниот систем Линукс како ексampле. За повеќе информации за конфигурацијата на Windows и macOS, погледнете го Водичот за програмирање ESP-IDF.

2.2 Хардверска врска

1. Залемете го модулот ESP32-WROOM-DA на плочата за тестирање RF како што е прикажано на слика 2.  Слика 2: Хардверско поврзување
2. Поврзете ја таблата за тестирање RF со плочата USB-to-Serial преку TXD, RXD и GND.
3. Поврзете ја USB-to-Serial плочата со компјутерот.
4. Поврзете ја таблата за тестирање RF со компјутерот или со адаптер за напојување за да овозможите напојување од 5 V, преку Micro-USB кабелот.
5. За време на преземањето, поврзете го IO0 со GND преку скокач. Потоа, вклучете ја таблата за тестирање.
6. Преземете го фирмверот во блиц. За детали, видете ги деловите подолу.
7. По преземањето, отстранете го скокачот на IO0 и GND.
8. Повторно напојувајте ја таблата за тестирање RF. ESP32-WROOM-DA ќе се префрли на работен режим. Чипот ќе ги чита програмите од блицот при иницијализацијата.

Забелешка:
IO0 е внатрешно логички висок. Ако IO0 е поставен на pull-up, се избира режимот за подигање. Ако оваа игла се спушта надолу или се остава да лебди, се избира режимот за преземање. За повеќе информации за ESP32-WROOM-DA, ве молиме погледнете го листот со податоци ESP32-WROOM-DA.

2.3 Поставете развојна средина

Рамката за развој на Espressif IoT (кратко ESP-IDF) е рамка за развој на апликации базирани на Espressif ESP32. Корисниците можат да развиваат апликации со ESP32 во Windows/Linux/macOS базирани на ESP-IDF.
Овде го земаме оперативниот систем Линукс како ексampле.

2.3.1 Предуслови за инсталирање
За да се компајлирате со ESP-IDF, треба да ги добиете следните пакети:

• CentOS 7:
  sudo yum инсталирај git wget flex bison gperf python cmake ninja-build ccache dfu-util
• Ubuntu и Debian (една команда се дели на две линии):
  sudo apt-get инсталирај git wget flex bison gperf python python-pip python-setuptools cmake
  Ninja-build ccache libffi-dev libssl-dev dfu-util
• Арх:
  sudo pacman -S –needed gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util

Забелешка:

• Овој водич го користи директориумот ~/esp на Linux како папка за инсталација за ESP-IDF.
• Имајте на ум дека ESP-IDF не поддржува празни места во патеките.

2.3.2 Земете ESPIDF
За да изградите апликации за модулот ESP32-WROOM-DA, потребни ви се софтверските библиотеки обезбедени од Espressif во складиштето ESP-IDF.
За да добиете ESP-IDF, креирајте директориум за инсталација (~/esp) за преземање на ESP-IDF и клонирање на складиштето со „git clone“:
mkdir -p ~/esp
cd ~/esp
git клон – рекурзивен https://github.com/espressif/esp-idf.git
ESP-IDF ќе се преземе во ~/esp/esp-idf. Консултирајте се со верзии на ESP-IDF за информации за тоа која верзија на ESP-IDF да се користи во дадена ситуација.

2.3.3 Поставување Алатки
Освен ESP-IDF, треба да ги инсталирате и алатките што ги користи ESP-IDF, како што се компајлерот, дебагерот, Пајтон пакетите итн. ESP-IDF обезбедува скрипта наречена „install.sh“ за да помогне во поставувањето на алатките во едно движење.
cd ~/esp/esp-idf
./инсталирај.ш

2.3.4 Поставување на променливи на животната средина
Инсталираните алатки сè уште не се додадени во променливата на околината PATH. За да се направат алатките употребливи од командната линија, мора да се постават некои променливи на околината. ESP-IDF обезбедува друга скрипта „export.sh“ која го прави тоа. Во терминалот каде што ќе користите ESP-IDF, стартувајте:
. $HOME/esp/esp-idf/export.sh
Сега сè е подготвено, можете да го изградите вашиот прв проект на модулот ESP32-WROOM-DA.

2.4 Направете го вашиот прв проект

2.4.1 Започнете проект
Сега сте подготвени да ја подготвите вашата апликација за модулот ESP32-WROOM-DA. Можете да започнете со проектот get-started/hello_world од прamples директориум во ESP-IDF.
Копирајте start-started/hello_world во директориумот ~/esp:
cd ~/esp
cp -r $IDF_PATH/ексamples/get-started/hello_world .
Постои низа на ексampле проекти во ексamples директориум во ESP-IDF. Можете да копирате кој било проект на ист начин како што е претставен погоре и да го извршите. Исто така е можно да се изгради ексamples in-place, без претходно да ги копирате.

2.4.2 Поврзете го вашиот уред
Сега поврзете го вашиот ESP32-WROOM-DA модул со компјутерот и проверете под која сериска порта е видлив модулот. Сериските порти во Linux започнуваат со „/dev/tty“ во нивните имиња. Извршете ја командата подолу два пати, прво со исклучена плоча, а потоа со вклучена. Портата што се појавува по втор пат е онаа што ви треба:
ls /dev/tty*

Забелешка:
Чувајте го името на портата при рака бидејќи ќе ви треба во следните чекори.

2.4.3 Конфигурирајте
Одете до вашиот директориум „hello_world“ од чекор 2.4.1. Започнете проект, поставете го чипот ESP32 како цел и стартувајте ја алатката за конфигурација на проектот 'menuconfig'.
cd ~/esp/hello_world
idf.py постави цел esp32
Конфигурација на менито idf.py

Поставувањето на целта со „idf.py set-target esp32“ треба да се направи еднаш, откако ќе се отвори нов проект. Ако проектот содржи некои постоечки градби и конфигурации, тие ќе бидат исчистени и иницијализирани. Целта може да се зачува во променливата на околината за воопшто да се прескокне овој чекор. Видете Избор на целта за дополнителни информации.
Ако претходните чекори се направени правилно, се појавува следново мени:

Слика 3: Почетен прозорец за конфигурација на проектот

Боите на менито може да бидат различни во вашиот терминал. Можете да го промените изгледот со опцијата „–стил“.
Ве молиме стартувајте „idf.py menuconfig –help“ за дополнителни информации.

2.4.4 Изградба на проектот
Изградете го проектот со извршување на:
idf.py изгради

Оваа команда ќе ја компајлира апликацијата и сите компоненти на ESP-IDF, а потоа ќе генерира подигнувач, табела за партиции и бинарни датотеки на апликации.

$ idf.py изгради
Вклучување cmake во директориумот /path/to/hello_world/build
Се извршува „cmake -G Ninja –warn-uninicialized /path/to/hello_world“…
Предупредете за неиницијализирани вредности.
— Found Git: /usr/bin/git (пронајдена верзија „2.17.0“)
— Градење празна aws_iot компонента поради конфигурација
— Имиња на компоненти:…
— Патеки на компонентите:…

… (повеќе линии на излез од системот за изградба)

[527/527] Генерирање hello-world.bin
esptool.py v2.3.1

Изградбата на проектот е завршена. За да трепка, извршете ја оваа команда:

../../../components/esptool_py/esptool/esptool.py -p (PORT) -b 921600 write_flash –flash_mode dio
– детектирање на големината на блиц – фреквенција_флеш 40м 0x10000 градба/здраво-свет.bin build 0x1000
build/bootloader/bootloader.bin 0x8000 build/partition_table/partition-table.bin
или стартувајте „idf.py -p PORT flash“

Ако нема грешки, изградбата ќе заврши со генерирање на бинарниот .bin на фирмверот file.

2.4.5 Трепкај на уредот
Трепкајте ги бинарните датотеки што штотуку ги изградивте на вашиот модул ESP32-WROOM-DA со извршување:
idf.py -p PORT [-b BAUD] трепка
Заменете го PORT со името на сериската порта на вашиот модул од Чекор: Поврзете го вашиот уред.
Можете исто така да ја промените брзината на бауд на трепкачите со замена на BAUD со брзината на бауд што ви треба. Стандардната брзина на бауд е 460800.
За повеќе информации за аргументите idf.py, видете idf.py. Ако сè оди добро, апликацијата „hello_world“ започнува да работи откако ќе го отстраните скокачот на IO0 и GND и повторно ќе ја вклучите плочката за тестирање.

Забелешка:
Опцијата „флеш“ автоматски го гради и трепка проектот, така што не е потребно извршување на „изградба на idf.py“.

Се извршува esptool.py во директориумот [...]/esp/hello_world
Се извршува „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
esptool.py v2.3.1
Се поврзува….
Се открива тип на чип… ESP32
Чипот е ESP32
Карактеристики: WiFi, BT, Dual Core
Се поставува никулец…
Никулец за трчање…
Трчање со никулец…
Се менува брзината на бауд на 460800
Сменето.
Се конфигурира големината на блицот…
Автоматско детектирана големина на блиц: 8MB
Поставете ги параметрите на блицот на 0x0220
Компресирани 22992 бајти на 13019…
Напиша 22992 бајти (13019 компресирани) на 0x00001000 за 0.3 секунди (ефективни 558.9 kbit/s)…
Хашот на податоците е потврден.
Компресирани 3072 бајти на 82…
Напиша 3072 бајти (82 компресирани) на 0x00008000 за 0.0 секунди (ефективни 5789.3 kbit/s)…
Хашот на податоците е потврден.
Компресирани 136672 бајти на 67544…
Напиша 136672 бајти (67544 компресирани) на 0x00010000 за 1.9 секунди (ефективни 567.5 kbit/s)…
Хашот на податоците е потврден.

Заминување…
Тешко ресетирање преку RTS пин…

2.4.6 Монитор
За да проверите дали „hello_world“ навистина работи, напишете „idf.py -p PORT monitor“ Не заборавајте да го замените PORT со името на вашата сериска порта).

Оваа команда ја активира апликацијата IDF Monitor:

$ idf.py -p /dev/ttyUSB0 монитор
Вклучување на idf_monitor во директориумот [...]/esp/hello_world/build
Се извршува „python [...]/esp-idf/tools/idf_monitor.py -b 115200

[…]/esp/hello_world/build/hello-world.elf“…
— idf_monitor на /dev/ttyUSB0 115200 —
— Излезете: Ctrl+] | Мени: Ctrl+T | Помош: Ctrl+T проследено со Ctrl+H —
ets 8 јуни 2016 00:22:57

rst: 0x1 (POWERON_RESET), подигање: 0x13 (SPI_FAST_FLASH_BOOT)
ets 8 јуни 2016 00:22:57
…

По стартувањето и дијагностичките дневници дојдете нагоре, треба да видите „Здраво свето! испечатени од апликацијата.
…
Здраво светот!
Се рестартира за 10 секунди…
Ова е чип esp32 со 2 јадра на процесорот, WiFi/BT/BLE, силиконска ревизија 3, блиц 8MB
Се рестартира за 9 секунди…
Се рестартира за 8 секунди…
Се рестартира за 7 секунди…

За да излезете од мониторот IDF, користете ја кратенката Ctrl+].
Тоа е сè што ви треба за да започнете со модулот ESP32-WROOM-DA! Сега сте подготвени да пробате некој друг поранешенamples во ESP-IDF, или одете веднаш кон развивање на сопствени апликации.

 

3. Изјава на FCC на САД

ID на FCC: 2AC7ZESPWROOMDA
Овој уред е во согласност со Дел 15 од Правилата на FCC. Работата е предмет на следниве два услови:

• Овој уред може да не предизвикува штетни пречки.
• Овој уред мора да ги прифати сите примени пречки, вклучително и пречки што може да предизвикаат несакано работење.

Оваа опрема е тестирана и утврдено е дека е во согласност со ограничувањата за дигитален уред од класа Б, согласно Дел15 од правилата на FCC. Овие граници се дизајнирани да обезбедат разумна заштита од штетно мешање во станбена инсталација.

Оваа опрема генерира, користи и може да зрачи енергија на радио фреквенција и, доколку не се инсталира и користи во согласност со упатствата, може да предизвика штетни пречки на радио комуникациите. Сепак, не постои гаранција дека нема да има пречки во одредена инсталација. Доколку оваа опрема предизвика штетни пречки на радио или телевизиски прием, што може да се утврди со исклучување и вклучување на опремата, корисникот се охрабрува да се обиде да ги поправи пречките со една од следниве мерки:

• Преориентирајте ја или преместете ја приемната антена.
• Зголемете го одвојувањето помеѓу опремата и приемникот.
• Поврзете ја опремата во штекер на коло различно од она на кое е поврзан ресиверот.
• Консултирајте се со продавачот или со искусен радио/телевизиски техничар за помош.

Внимание:
Сите промени или модификации кои не се изрично одобрени од страната одговорна за усогласеноста може да го поништат овластувањето на корисникот да работи со опремата.

Оваа опрема е во согласност со ограничувањата за изложеност на зрачење на FCC RF утврдени за неконтролирана средина. Овој уред и неговата антена не смеат да бидат поставени заедно или да работат заедно со која било друга антена или предавател. Антените што се користат за овој предавател мора да се инсталираат за да обезбедат растојание на одвојување од најмалку 20 cm од сите лица и не смеат да бидат поставени или да работат заедно со која било друга антена или предавател.

За европските пазари релевантните директиви се споменати подолу:
Одговорност на производителот на финалниот производ е да потврди дали натамошните стандарди, препораки или директиви се или не на сила надвор од овие области. Ве молиме имајте предвид дека барањата за SAR се специфични само за преносливи уреди, а не за мобилни уреди како што е дефинирано подолу:

• Пренослив уред: Преносен уред е дефиниран како преносен уред дизајниран да се користи така што зрачичката структура(ите) на уредот е/се во рамките на 20 сантиметри од телото на корисникот.
• Мобилен уред: Мобилен уред е дефиниран како преносен уред дизајниран да се користи на други места освен на фиксни локации и генерално да се користи на таков начин што вообичаено се одржува растојание од најмалку 20 сантиметри помеѓу зрачната структура(ите) на предавателот. и телото на корисникот или блиските лица. Во овој контекст, терминот „фиксна локација“ значи дека уредот е физички обезбеден на една локација и не може лесно да се премести на друга локација.

Инструкции за интеграција на OEM
Овој уред е наменет само за OEM интегратори под следните услови Модулот може да се користи за инсталација во друг хост. Антената мора да биде инсталирана така што да се одржуваат 20 cm помеѓу антената и корисниците, а модулот на предавателот не смее да се наоѓа заедно со кој било друг пренос или антена. Модулот треба да се користи само со интегралните антени кои се првично тестирани и сертифицирани со овој модул. Сè додека се исполнети 3 услови погоре, нема да биде потребно дополнително тестирање на предавателот. Сепак, OEM интеграторот сè уште е одговорен за тестирање на нивниот краен производ за какви било дополнителни барања за усогласеност со инсталираниот модул (на пр.ampле, емисија на дигитален уред, барања за периферни компјутери, итн.)

Забелешка:
Во случај овие услови да не можат да се исполнат (на прampод одредена конфигурација на лаптоп или колокација со друг предавател), тогаш овластувањето на FCC за овој модул во комбинација со опремата на домаќинот повеќе не се смета за валидно и FCC ID на модулот не може да се користи на финалниот производ. Во овие и околности, OEM интеграторот ќе
биде одговорен за повторно оценување. Крајниот производ (вклучувајќи го предавателот) и добивање посебно овластување од FCC.

Финалниот краен производ мора да биде означен на видливо место со следново: „Содржи FCC ID на предавателот: 2AC7ZESPWROOMDA“ или „Содржи FCC ID: 2AC7ZESPWROOMDA“.

 

4. Поврзана документација и ресурси

Поврзана документација

• ESP32 Technical Reference Manual – Детални информации за тоа како да се користи ESP32 меморијата и периферните уреди.
• Лист со податоци од серијата ESP32 – Спецификации на хардверот ESP32.
• Упатства за дизајн на хардвер ESP32 – Упатства за тоа како да го интегрирате ESP32 во вашиот хардверски производ.
• ESP32 ECO и решенија за грешки – Корекција на грешки во дизајнот на ESP32.
• Сертификати
  http://espressif.com/en/support/documents/certificates
• ESP32 Известувања за промена на производ/процес (PCN)
  http://espressif.com/en/support/documents/pcns
• ESP32 Advisories – Информации за безбедност, грешки, компатибилност, доверливост на компонентите.
  http://espressif.com/en/support/documents/advisories
• Ажурирања на документација и претплата за известување за ажурирање
  http://espressif.com/en/support/download/documents

Програмерска зона

• Водич за програмирање ESP-IDF за ESP32 – Обемна документација за развојната рамка на ESP-IDF.
• ESP-IDF и други развојни рамки на GitHub.
  http://github.com/espressif
• Форум ESP32 BBS – Заедница од инженер-до-инженер (E2E) за производите на Espressif каде што можете да поставувате прашања,
  споделете знаење, истражувајте идеи и помагајте да се решат проблемите со колегите инженери.
  http://esp32.com/
• Списанието ESP – Најдобри практики, написи и белешки од луѓе на Еспресиф.
  http://medium.com/the-esp-journal
• Погледнете ги картичките SDK и демо, Апликации, Алатки, AT фирмвер.
  http://espressif.com/en/support/download/sdks-demos

Производи

• SoC од серијата ESP32 - Прелистајте ги сите ESP32 SoC.
  http://espressif.com/en/products/socs?id=ESP32
• Модули од серијата ESP32 – Прелистајте ги сите модули базирани на ESP32.
  http://espressif.com/en/products/modules?id=ESP32
• DevKits од серијата ESP32 – Прелистајте ги сите уреди базирани на ESP32.
  http://espressif.com/en/products/devkits?id=ESP32
• Избирач на производи ESP – Најдете хардверски производ Espressif погоден за вашите потреби со споредување или примена на филтри.
  http://products.espressif.com/#/product-selector?language=en

Контактирајте со нас

• Видете ги картичките Прашања за продажба, технички прашања, шема на кола и дизајн на ПХБ Реview, Земаamples (онлајн продавници), Станете наш добавувач, коментари и предлози.
  http://espressif.com/en/contact-us/sales-questions

Историја на ревизии

 

Известување за одрекување и авторски права

 Информации во овој документ, вклучувајќи URL референци, е предмет на промена без претходна најава.
СИТЕ ИНФОРМАЦИИ ОД ТРЕТИ ЛИЦА ВО ОВОЈ ДОКУМЕНТ СЕ ОБЕЗБЕДУВАНИ КАКО ШТО СЕ НЕМА ГАРАНЦИЈА ЗА НЕГОВАТА автентичност и точност. НЕ Е ДАДЕНА ГАРАНЦИЈА НА ОВОЈ ДОКУМЕНТ ЗА НЕГОВАТА КОРИСТЕНА, НЕПОВРЕШУВАЊЕ, СООДВЕТНОСТ ЗА КОЈА ПОСЕБНИ НАМЕ, НИТУ НЕ Е НИКАКВА ГАРАНЦИЈА КОЈА ПОИНАКУ ПРОИЗЛЕГУВА ОД КОЈ ПРЕДЛОГ, СПЕЦИФИКАЦИЈАAMPЛЕ.

Се отфрла секаква одговорност, вклучително и одговорност за прекршување на какви било сопственички права, во врска со користењето на информациите во овој документ. Овде не се дадени лиценци изразени или имплицирани, со estoppel или на друг начин, за какви било права на интелектуална сопственост.

Логото на Wi-Fi Alliance Member е заштитен знак на Wi-Fi Alliance. Логото на Bluetooth е a
регистрирана трговска марка на Bluetooth SIG.

Сите трговски имиња, заштитни знаци и регистрирани трговски марки споменати во овој документ се сопственост
на нивните соодветни сопственици, и со ова се признаваат.

Авторски права © 2021 Espressif Systems (Shanghai) Co., Ltd. Сите права се задржани.

 

Прочитајте повеќе за овој прирачник и преземете PDF:

Документи / ресурси

ESPRESSIF ESP32-WROOM-DA самостоен модул со двојни антени [pdf] Упатство за користење ESP32 -WROOM- DA, самостоен модул со двојни антени, ESP32 -WROOM- DA самостоен модул со двојни антени

Референци

• Упатство за употреба