Посібник користувача ESPRESSIF ESP32-WROOM-DA Автономний модуль з подвійними антенами

Автономний модуль з подвійними антенами
Містить UltraLowPower SoC з двоядерним процесором
Підтримка 2.4 ГГц WiFi, Bluetooth® та Bluetooth LE

 

Про цей документ

У цьому посібнику користувача показано, як розпочати роботу з модулем 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 з двома додатковими антенами на друкованій платі в різних напрямках. Цей модуль вбудований з ESP32-D0WD-V3 з багатим набором інтегрованих компонентів, включаючи спалах SPI і кварцевий генератор 40 МГц. Завдяки двом унікальним антенам на одному модулі, ESP32-WROOM-DA можна використовувати для розробки додатків IoT, які потребують стабільного підключення в широкому спектрі, або для розгортання Wi-Fi у складних та небезпечних середовищах, або для подолання проблем зі зв’язком у Wi-Fi. -Fi-мертві місця. Цей модуль є ідеальним вибором для внутрішніх і зовнішніх пристроїв для розумного дому, промислового керування, побутової електроніки тощо.

Таблиця 1: Технічні характеристики ESP32WROOMDA

1.2 Опис контакту
На діаграмі контактів нижче показано приблизне розташування контактів і двох антен на модулі.

Малюнок 1: Розташування контактів (зверху View)

Модуль має 41 контакт і дві тестові точки. Дивіться визначення контактів у таблиці 2.

Таблиця 2: Визначення контактів

1. Інформацію про конфігурації контактів периферійних пристроїв див. у таблиці даних серії ESP32.
2. GPIO2 і GPIO25 на чіпі ESP32-D0WD-V3 призначені як контрольні точки для керування радіочастотним перемикачем.
Два контакти не виводяться до модуля. Щоб вибрати робочу антену (Антена 1 або Антена 2), налаштуйте GPIO2 і GPIO25 наступним чином:

Таблиця 3: Виберіть Робоча антена

 

2. Почніть роботу з ESP32WROOMDA

2.1 Що вам потрібно

Для розробки додатків для модуля потрібно:

• 1 х модуль ESP32-WROOM-DA
• 1 x тестова плата Espressif RF
• 1 x USB-to-Serial плата
• 1 х кабель Micro-USB
• 1 ПК під керуванням Linux

У цьому посібнику користувача ми беремо операційну систему Linux як прикладampле. Щоб отримати додаткові відомості про конфігурацію в Windows і macOS, зверніться до посібника з програмування ESP-IDF.

2.2 Підключення обладнання

1. Припаяйте модуль ESP32-WROOM-DA до РЧ тестової плати, як показано на малюнку 2.  Малюнок 2: Підключення обладнання
2. Підключіть тестову плату РЧ до плати USB-to-Serial через TXD, RXD і GND.
3. Підключіть плату USB-to-Serial до ПК.
4. Підключіть тестову плату РЧ до ПК або адаптера живлення, щоб увімкнути живлення 5 В, за допомогою кабелю Micro-USB.
5. Під час завантаження підключіть IO0 до GND через перемичку. Потім увімкніть тестову панель.
6. Завантажити прошивку у флеш. Щоб дізнатися більше, перегляньте розділи нижче.
7. Після завантаження зніміть перемичку на IO0 і GND.
8. Знову ввімкніть тестову плату РЧ. ESP32-WROOM-DA перейде в робочий режим. Після ініціалізації чіп зчитує програми з флеш-пам'яті.

Примітка:
IO0 є внутрішньо логічним високим. Якщо IO0 встановлено на підтягування, вибирається режим завантаження. Якщо ця шпилька висувається або плаває ліворуч, вибирається режим завантаження. Для отримання додаткової інформації про ESP32-WROOM-DA, будь ласка, зверніться до таблиці даних ESP32-WROOM-DA.

2.3 Налаштування середовища розробки

Espressif IoT Development Framework (скорочено ESP-IDF) — це платформа для розробки додатків на основі Espressif ESP32. Користувачі можуть розробляти програми з ESP32 в Windows/Linux/macOS на основі ESP-IDF.
Тут ми візьмемо операційну систему Linux як прикладample.

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 install git wget flex bison gperf python python-pip python-setuptools cmake
  ninja-build ccache libffi-dev libssl-dev dfu-util
• Арка:
  sudo pacman -S – потрібен 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 ~/особливо
cd ~/особливо
git clone – рекурсивний https://github.com/espressif/esp-idf.git
ESP-IDF буде завантажено в ~/esp/esp-idf. Зверніться до ESP-IDF Versions, щоб отримати інформацію про те, яку версію ESP-IDF використовувати в певній ситуації.

2.3.3 Налаштувати інструменти
Окрім ESP-IDF, вам також потрібно встановити інструменти, які використовує ESP-IDF, такі як компілятор, налагоджувач, пакети Python тощо. ESP-IDF надає сценарій під назвою install.sh, щоб допомогти налаштувати інструменти за один прийом.
cd ~/esp/esp-idf
./install.sh

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 з examples каталог в ESP-IDF.
Скопіюйте get-started/hello_world в каталог ~/esp:
cd ~/особливо
cp -r $IDF_PATH/examples/get-started/hello_world .
Існує ряд example проекти в examples каталог в ESP-IDF. Ви можете скопіювати будь-який проект, як описано вище, і запустити його. Також можливе будівництво прampфайли на місці, без попереднього копіювання.

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 set-target esp32
idf.py menuconfig

Встановлення цілі за допомогою '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-uninitialized /path/to/hello_world”…
Попереджати про неініціалізовані значення.
— Знайдено 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 (ПОРТ) -b 921600 write_flash –flash_mode dio
–flash_size виявлення –flash_freq 40m 0x10000 build/hello-world.bin build 0x1000
build/bootloader/bootloader.bin 0x8000 build/partition_table/partition-table.bin
або запустіть 'idf.py -p PORT flash'

Якщо помилок немає, збірка завершиться створенням двійкового файлу .bin мікропрограми file.

2.4.5 Flash на пристрої
Запрограмуйте двійкові файли, які ви щойно вбудували у свій модуль ESP32-WROOM-DA, запустивши:
idf.py -p PORT [-b BAUD] спалахує
Замініть PORT на назву послідовного порту вашого модуля з кроку: Підключіть пристрій.
Ви також можете змінити швидкість передачі даних, замінивши BAUD на потрібну швидкість передачі даних. Швидкість передачі за замовчуванням становить 460800 бод.
Для отримання додаткової інформації про аргументи idf.py див. idf.py. Якщо все пройшло добре, програма «hello_world» почне працювати після того, як ви видалите перемичку на IO0 і GND і знову ввімкнете тестову плату.

Примітка:
Параметр 'flash' автоматично створює та флешує проект, тому запускати 'idf.py build' не потрібно.

Запуск 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, двоядерний
Завантаження заглушки…
Запущена заглушка…
Початок роботи…
Зміна швидкості передачі даних на 460800
Змінено.
Налаштування розміру спалаху…
Розмір автоматично виявленого Flash: 8 МБ
Параметри Flash встановлені на 0x0220
Стиснуто 22992 байт до 13019…
Записав 22992 байти (13019 стиснених) при 0x00001000 за 0.3 секунди (ефективна 558.9 кбіт/с)…
Хеш даних підтверджено.
Стиснуто 3072 байт до 82…
Записав 3072 байти (82 стиснених) при 0x00008000 за 0.0 секунди (ефективна 5789.3 кбіт/с)…
Хеш даних підтверджено.
Стиснуто 136672 байт до 67544…
Записав 136672 байти (67544 стиснених) при 0x00010000 за 1.9 секунди (ефективна 567.5 кбіт/с)…
Хеш даних підтверджено.

Залишаючи…
Апаратне скидання за допомогою PIN-коду 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

перший:0x1 (POWERON_RESET),завантаження:0x13 (SPI_FAST_FLASH_BOOT)
ets 8 червня 2016 00:22:57
…

Після прокручування журналів запуску та діагностики вгору ви повинні побачити «Привіт, світ!» роздруковані за допомогою програми.
…
Привіт світ!
Перезапуск через 10 секунд…
Це чіп esp32 з 2 ядрами ЦП, WiFi/BT/BLE, кремнієва версія 3, 8 МБ спалаху
Перезапуск через 9 секунд…
Перезапуск через 8 секунд…
Перезапуск через 7 секунд…

Щоб вийти з монітора IDF, використовуйте ярлик Ctrl+].
Це все, що вам потрібно, щоб почати роботу з модулем ESP32-WROOM-DA! Тепер ви готові спробувати іншого колишньогоamples в ESP-IDF, або перейдіть прямо до розробки власних програм.

 

3. Заява FCC США

Ідентифікатор FCC: 2AC7ZESPWROOMDA
Цей пристрій відповідає частині 15 правил FCC. Експлуатація залежить від таких двох умов:

• Цей пристрій не може створювати шкідливих перешкод.
• Цей пристрій має сприймати будь-які отримані перешкоди, включаючи перешкоди, які можуть спричинити небажану роботу.

Це обладнання було протестовано та встановлено, що воно відповідає обмеженням для цифрових пристроїв класу B відповідно до частини 15 Правил FCC. Ці обмеження покликані забезпечити розумний захист від шкідливих перешкод у житловій установці.

Це обладнання генерує, використовує та може випромінювати радіочастотну енергію та, якщо його встановити та використовувати не відповідно до інструкцій, може створювати шкідливі перешкоди радіозв’язку. Однак немає жодної гарантії, що перешкоди не виникнуть під час конкретного встановлення. Якщо це обладнання справді створює шкідливі перешкоди радіо- чи телевізійному прийому, що можна визначити, вимкнувши й увімкнувши обладнання, користувачеві пропонується спробувати усунути перешкоди одним із таких заходів:

• Переорієнтуйте або перемістіть приймальну антену.
• Збільште відстань між обладнанням і приймачем.
• Підключіть обладнання до іншої розетки, ніж та, до якої підключено приймач.
• Зверніться по допомогу до дилера або досвідченого радіо/телетехніка.

Увага:
Будь-які зміни або модифікації, не схвалені прямо стороною, відповідальною за відповідність, можуть позбавити користувача права на використання обладнання.

Це обладнання відповідає обмеженням впливу радіочастотного випромінювання FCC, встановленим для неконтрольованого середовища. Цей пристрій та його антена не повинні розміщуватися або працювати разом з будь-якою іншою антеною чи передавачем. Антени, що використовуються для цього передавача, повинні бути встановлені на відстані не менше 20 см від усіх людей і не повинні розміщуватися разом або працювати разом з будь-якою іншою антеною або передавачем.

Для європейських ринків відповідні директиви вказані нижче:
Виробник кінцевого продукту несе відповідальність за перевірку того, чи діють інші стандарти, рекомендації чи директиви за межами цих областей. Зверніть увагу, що вимоги до SAR стосуються лише портативних пристроїв, а не мобільних пристроїв, як визначено нижче:

• Портативний пристрій: портативний пристрій визначається як передавальний пристрій, призначений для використання таким чином, щоб випромінювальна структура(и) пристрою знаходилась/перебувала в межах 20 сантиметрів від тіла користувача.
• Мобільний пристрій: Мобільний пристрій визначається як передавальний пристрій, призначений для використання в інших місцях, ніж фіксовані, і який зазвичай використовується таким чином, що відстань між випромінювальною структурою(ами) передавача зазвичай підтримується щонайменше 20 сантиметрів. і тіло користувача або людей, що знаходяться поблизу. У цьому контексті термін «фіксоване розташування» означає, що пристрій фізично захищений в одному місці і його неможливо легко перемістити в інше місце.

Інструкції з інтеграції OEM
Цей пристрій призначений лише для інтеграторів OEM за наступних умов. Модуль можна використовувати для встановлення на іншому хості. Антена повинна бути встановлена ​​так, щоб між антеною та користувачами залишалося 20 см, а модуль передавача не можна було розташувати разом із будь-яким іншим передавачем або антеною. Модуль слід використовувати лише з вбудованою(ими) антеною(ами), яка(и) була спочатку перевірена та сертифікована з цим модулем. Поки виконуються 3 вищезазначені умови, подальше тестування передавача не буде потрібно. Однак інтегратор OEM все ще відповідає за тестування кінцевого продукту на наявність будь-яких додаткових вимог щодо відповідності встановленим цим модулем (наприклад,ample, випромінювання цифрових пристроїв, вимоги до периферії ПК тощо)

Примітка:
У випадку, якщо ці умови не можуть бути виконані (наприклад,ampза певної конфігурації ноутбука або спільного розташування з іншим передавачем), тоді авторизація FCC для цього модуля в поєднанні з хост-обладнанням більше не вважається дійсною, і FCC ID модуля не може використовуватися в кінцевому продукті. У цих обставинах інтегратор OEM буде
відповідати за повторну оцінку. Кінцевий продукт (включаючи передавач) і отримання окремого дозволу FCC.

Кінцевий кінцевий продукт має бути позначений у видимій області таким чином: «Містить FCC ID модуля передавача: 2AC7ZESPWROOMDA» або «Містить FCC ID: 2AC7ZESPWROOMDA».

 

4. Відповідна документація та ресурси

Пов'язана документація

• Технічний довідковий посібник ESP32 – детальна інформація про використання пам’яті та периферійних пристроїв 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 – найкращі методи, статті та примітки від Espressif.
  http://medium.com/the-esp-journal
• Перегляньте вкладки SDK і демонстрації, Програми, Інструменти, AT Firmware.
  http://espressif.com/en/support/download/sdks-demos

Продукти

• SoC серії ESP32 – Перегляньте всі SoC ESP32.
  http://espressif.com/en/products/socs?id=ESP32
• Модулі серії ESP32 – перегляньте всі модулі на базі ESP32.
  http://espressif.com/en/products/modules?id=ESP32
• Комплекти розробників серії ESP32 – перегляньте всі комплекти розробників на основі ESP32.
  http://espressif.com/en/products/devkits?id=ESP32
• ESP Product Selector – знайдіть апаратний продукт Espressif, який відповідає вашим потребам, порівнявши або застосувавши фільтри.
  http://products.espressif.com/#/product-selector?language=en

Зв'яжіться з нами

• Перегляньте вкладки «Питання з продажу», «Технічні запити», «Схема ланцюга» та «Дизайн друкованої плати»view, отримати Сamples (Інтернет-магазини), стань нашим постачальником, коментарі та пропозиції.
  http://espressif.com/en/contact-us/sales-questions

Історія версій

 

Відмова від відповідальності та повідомлення про авторські права

 Інформація в цьому документі, в т.ч URL посилання, можуть бути змінені без попередження.
ВСЯ ІНФОРМАЦІЯ ТРЕТІХ ОСІН В ЦЬОМУ ДОКУМЕНТІ НАДАЄТЬСЯ ЯКІЙ, БЕЗ ГАРАНТІЙ ЇЇ ДОСТИЖНОСТІ ТА ТОЧНОСТІ. ЦЬОМУ ДОКУМЕНТУ НЕ НАДАЄТЬСЯ ГАРАНТІЙ ЩОДО ЇЇ ПРИГОДНОСТІ, НЕПОРУШЕННОСТІ, ПРИХОДНОСТІ ДЛЯ БУДЬ-ЯКОГО ОПРЕДЕЛЕННЯ, АНІ ГАРАНТІЙ ІНШОГО, ЩО ВИНИКАЄ З ПРОПОЗИЦІЇ, СПЕЦИФІКАЦІЇ ЧИAMPLE.

Будь-яка відповідальність, включаючи відповідальність за порушення будь-яких прав власності, пов’язаної з використанням інформації в цьому документі, не несе. У цьому документі не надаються жодні ліцензії, явні чи неявні, шляхом estoppel чи іншим чином, на будь-які права інтелектуальної власності.

Логотип Wi-Fi Alliance Member є торговою маркою Wi-Fi Alliance. Логотип Bluetooth – це a
зареєстрована торгова марка Bluetooth SIG.

Усі торгові назви, торгові марки та зареєстровані торгові марки, згадані в цьому документі, є власністю
їхніх відповідних власників, і цим визнаються.

Авторські права © Espressif Systems (Shanghai) Co., Ltd., 2021. Усі права захищено.

 

Дізнайтеся більше про цей посібник і завантажте PDF:

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

Автономний модуль ESPRESSIF ESP32-WROOM-DA з подвійними антенами [pdfПосібник користувача ESP32 -WROOM- DA, автономний модуль із подвійними антенами, ESP32 -WROOM- DA автономний модуль із подвійними антенами

Список літератури

• Посібник користувача