ESPRESSIF ESP32-WROOM-DA 双天线独立模块用户手册

1.1 个模块结束view
ESP32-WROOM-DA 是一款功能强大的 Wi-Fi + 蓝牙 + 蓝牙 LE MCU 模块，具有两个不同方向的互补 PCB 天线。该模块内嵌ESP32-D0WD-V3，具有丰富的集成组件，包括SPI flash和40 MHz晶振。 ESP32-WROOM-DA 在单个模块上设计了两个独特的天线，可用于开发需要在广谱上稳定连接的物联网应用，或在具有挑战性和危险的环境中部署 Wi-Fi，或克服 Wi-Fi 中的通信问题-Fi 死角。该模块是智能家居、工业控制、消费电子等室内外设备的理想选择。

表 1：ESP32WROOMDA 规格

1.2 引脚说明
下面的引脚图显示了模块上引脚和两个天线的大致位置。

图 1：引脚布局（顶部 View)

该模块有 41 个引脚和两个测试点。请参见表 2 中的引脚定义。

表 2：引脚定义

1. 外设管脚配置请参考 ESP32 Series Datasheet。
2. ESP2-D25WD-V32 芯片上的 GPIO0 和 GPIO3 设计为测试点来控制 RF Switch。
这两个引脚没有引出到模块。要选择工作天线（天线 1 或天线 2），请按如下方式配置 GPIO2 和 GPIO25：

表 3：选择工作天线

2. 开始使用 ESP32WROOMDA

2.1 您需要什么

要为模块开发应用程序，您需要：

1 x ESP32-WROOM-DA 模块
1 x 乐鑫射频测试板
1 x USB 转串口板
1 x 微型 USB 数据线
1 台运行 Linux 的 PC

在本用户指南中，我们以 Linux 操作系统为例amp乐。有关 Windows 和 macOS 上的配置的更多信息，请参阅 ESP-IDF 编程指南。

2.2 硬件连接

将 ESP32-WROOM-DA 模块焊接到射频测试板上，如图 2 所示。 图 2：硬件连接

通过 TXD、RXD 和 GND 将 RF 测试板连接到 USB 转串口板。
将 USB 转串口板连接到 PC。
通过 Micro-USB 电缆将射频测试板连接到 PC 或电源适配器以启用 5 V 电源。

在下载过程中，通过跳线将 IO0 连接到 GND。然后，打开“ON”测试板。
将固件下载到闪存中。有关详细信息，请参阅以下部分。

下载后，将 IO0 和 GND 上的跳线去掉。
再次启动射频测试板。 ESP32-WROOM-DA 将切换到工作模式。芯片在初始化时会从 flash 中读取程序。

笔记：
IO0 内部为逻辑高电平。如果 IO0 设置为上拉，则选择 Boot 模式。如果此引脚为下拉或悬空，则选择下载模式。有关 ESP32-WROOM-DA 的更多信息，请参阅 ESP32-WROOM-DA Datasheet。

2.3 搭建开发环境

乐鑫物联网开发框架（简称 ESP-IDF）是基于乐鑫 ESP32 开发应用程序的框架。用户可以在基于 ESP-IDF 的 Windows/Linux/macOS 中使用 ESP32 开发应用程序。
这里我们以 Linux 操作系统为例amp勒。

2.3.1 安装先决条件
要使用 ESP-IDF 进行编译，您需要获取以下软件包：

CentOS 7：
sudo yum install 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

笔记：

本指南使用 Linux 上的 ~/esp 目录作为 ESP-IDF 的安装文件夹。

请记住，ESP-IDF 不支持路径中的空格。

2.3.2 获取 ESPIDF
要为 ESP32-WROOM-DA 模块构建应用程序，您需要乐鑫在 ESP-IDF 存储库中提供的软件库。
要获取 ESP-IDF，请创建一个安装目录 (~/esp) 以将 ESP-IDF 下载到并使用“git clone”克隆存储库：
mkdir -p ~/esp 目录
光盘 ~/esp
git clone – 递归 https://github.com/espressif/esp-idf.git
ESP-IDF 将被下载到 ~/esp/esp-idf。有关在给定情况下使用哪个 ESP-IDF 版本的信息，请参阅 ESP-IDF 版本。

2.3.3 设置工具
除了 ESP-IDF，您还需要安装 ESP-IDF 使用的工具，例如编译器、调试器、Python 包等。ESP-IDF 提供了一个名为“install.sh”的脚本来帮助设置工具一气呵成。
cd ~/esp/esp-idf
./安装.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 模块准备应用程序。您可以从 ex 的 get-started/hello_world 项目开始ampESP-IDF 中的 .les 目录。
将 get-started/hello_world 复制到 ~/esp 目录：
光盘 ~/esp
cp -r $IDF_PATH/examples/get-started/hello_world 。
有一个范围的前amp前的项目ampESP-IDF 中的 .les 目录。您可以以与上述相同的方式复制任何项目并运行它。也可以构建 examp就地文件，而不是先复制它们。

2.4.2 连接您的设备
现在将您的 ESP32-WROOM-DA 模块连接到计算机并检查模块在哪个串口下可见。 Linux 中的串行端口名称中以“/dev/tty”开头。运行以下命令两次，先拔下电路板，然后再插上电源。第二次出现的端口就是您需要的端口：
ls /dev/tty*

笔记：
将端口名称放在手边，因为您将在接下来的步骤中使用它。

2.4.3 配置
从步骤 2.4.1 导航到您的“hello_world”目录。启动一个项目，将 ESP32 芯片设置为目标并运行项目配置实用程序“menuconfig”。
cd ~/esp/你好世界
idf.py 设置目标 esp32
idf.py 菜单配置

在打开一个新项目后，应使用 'idf.py set-target esp32' 设置目标一次。如果项目包含一些现有的构建和配置，它们将被清除和初始化。目标可以保存在环境变量中以完全跳过此步骤。有关其他信息，请参阅选择目标。
如果前面的步骤已正确完成，则会出现以下菜单：

图 3：项目配置主窗口

菜单的颜色在您的终端中可能会有所不同。您可以使用选项“–style”更改外观。
请运行“idf.py menuconfig –help”以获取更多信息。

2.4.4 构建项目
通过运行构建项目：
idf.py 构建

该命令将编译应用程序和所有 ESP-IDF 组件，然后生成引导加载程序、分区表和应用程序二进制文件。

$ idf.py 构建
在目录 /path/to/hello_world/build 中运行 cmake
执行“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 (PORT) -b 921600 write_flash –flash_mode dio
–flash_size 检测 –flash_freq 40m 0x10000 build/hello-world.bin build 0x1000
构建/bootloader/bootloader.bin 0x8000 构建/partition_table/partition-table.bin
或运行'idf.py -p PORT flash'

如果没有错误，构建将通过生成固件二进制文件 .bin 来完成 file.

2.4.5 刷入设备
通过运行以下命令将您刚刚构建到 ESP32-WROOM-DA 模块的二进制文件刷新：
idf.py -p 端口 [-b 波特率] 闪存
将 PORT 替换为来自步骤：连接您的设备的模块的串行端口名称。
您还可以通过将 BAUD 替换为您需要的波特率来更改闪光灯波特率。默认波特率为 460800。
有关 idf.py 参数的更多信息，请参阅 idf.py。如果一切顺利，在您移除 IO0 和 GND 上的跳线后，“hello_world”应用程序开始运行，并重新启动测试板。

笔记：
选项“flash”会自动构建并刷新项目，因此不需要运行“idf.py build”。

在目录 […]/esp/hello_world 中运行 esptool.py
执行“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 检测 –flash_freq 40m 0x1000
bootloader/bootloader.bin 0x8000 分区表/分区表.bin 0x10000 hello-world.bin
esptool.py v2.3.1 版本
连接……
检测芯片类型…ESP32
芯片是ESP32
特点：WiFi、BT、双核
正在上传存根…
运行存根…
存根运行…
将波特率更改为 460800
改变了。
正在配置闪存大小...
自动检测闪存大小：8MB
Flash 参数设置为 0x0220
将 22992 字节压缩为 13019…
在 22992 秒内（有效 13019 kbit/s）在 0x00001000 处写入了 0.3 字节（558.9 压缩）……
验证的数据哈希。
将 3072 字节压缩为 82…
在 3072 秒内（有效 82 kbit/s）在 0x00008000 处写入了 0.0 字节（5789.3 压缩）……
验证的数据哈希。
将 136672 字节压缩为 67544…
在 136672 秒内（有效 67544 kbit/s）在 0x00010000 处写入了 1.9 字节（567.5 压缩）……
验证的数据哈希。

离开…
通过 RTS 引脚硬复位…

2.4.6 监视器
要检查“hello_world”是否确实在运行，请键入“idf.py -p PORT monitor”，不要忘记将 PORT 替换为您的串行端口名称）。

此命令启动 IDF Monitor 应用程序：

$ idf.py -p /dev/ttyUSB0 监视器
在目录 […]/esp/hello_world/build 中运行 idf_monitor
执行“python […]/esp-idf/tools/idf_monitor.py -b 115200

[…]/esp/hello_world/build/hello-world.elf”…
— /dev/ttyUSB0 115200 上的 idf_monitor —
— 退出：Ctrl+] | 菜单：Ctrl+T | 帮助：Ctrl+T 后跟 Ctrl+H —
等 8 年 2016 月 00 日 22:57:XNUMX

复位：0x1（通电复位），启动：0x13（SPI_FAST_FLASH_BOOT）
等 8 年 2016 月 00 日 22:57:XNUMX
…

启动和诊断日志向上滚动后，您应该会看到“Hello world！” 由应用程序打印出来。
…
你好世界！
10 秒后重启……
这是具有 32 个 CPU 内核、WiFi/BT/BLE、硅版本 2、3MB 闪存的 esp8 芯片
9 秒后重启……
8 秒后重启……
7 秒后重启……

要退出 IDF 监视器，请使用快捷键 Ctrl+]。
这就是您开始使用 ESP32-WROOM-DA 模块所需的全部内容！现在你准备好尝试其他的前任了ampESP-IDF 中的文件，或者直接开发自己的应用程序。

3.美国FCC声明

FCC ID：2AC7ZESPWROOMDA
本设备符合 FCC 规则第 15 部分的规定。操作需遵守以下两个条件：

本设备不得造成有害干扰。
本设备必须承受任何收到的干扰，包括可能导致不良操作的干扰。

本设备经测试证明符合FCC规则第15部分中关于B类数字设备的限制。这些限制旨在提供合理的保护，以防止在住宅安装中产生有害干扰。

本设备会产生、使用并辐射射频能量，如果不按照说明进行安装和使用，可能会对无线电通信造成有害干扰。但是，无法保证在特定安装中不会发生干扰。如果本设备确实对无线电或电视接收造成有害干扰（可通过关闭和打开设备来确定），建议用户尝试通过以下措施之一来纠正干扰：

重新调整或重新定位接收天线。
增加设备与接收器之间的距离。
将设备连接到与接收器不同电路的插座上。
请咨询经销商或经验丰富的无线电/电视技术人员寻求帮助。

警告：
任何未经合规负责方明确批准的更改或修改都可能使用户操作该设备的权限失效。

本设备符合针对不受控制的环境规定的 FCC 射频辐射暴露限制。此设备及其天线不得与任何其他天线或发射器位于同一位置或一起操作。用于此发射器的天线必须安装为与所有人保持至少 20 厘米的距离，并且不得与任何其他天线或发射器位于同一位置或一起操作。

对于欧洲市场，相关指令如下所述：
最终产品的制造商有责任验证在这些领域之外是否有其他标准、建议或指令生效。请注意，SAR 要求仅适用于便携式设备，不适用于以下定义的移动设备：

便携式设备：便携式设备定义为设计用于使设备的辐射结构位于用户身体 20 厘米以内的发射设备。
移动设备：移动设备被定义为设计用于非固定位置的发射设备，并且通常以这样的方式使用，即通常在发射机的辐射结构之间保持至少 20 厘米的间隔距离以及用户或附近人员的身体。在这种情况下，术语“固定位置”是指设备在物理上固定在一个位置，并且不能轻易移动到另一个位置。

OEM 集成说明
此设备仅适用于以下条件下的 OEM 集成商该模块可用于安装在另一台主机上。安装天线时，天线与用户之间必须保持 20 厘米的距离，并且发射器模块不得与任何其他发射器或天线位于同一位置。该模块只能与最初使用该模块进行测试和认证的集成天线一起使用。只要满足以上 3 个条件，就不需要进一步的发射机测试。但是，OEM 集成商仍负责测试其最终产品是否符合安装此模块的任何其他合规性要求（例如ample，数字设备发射，PC外围要求等）

注意：
如果这些条件无法满足（例如ample 某些笔记本电脑配置或与另一个发射器共置），则该模块与主机设备组合的 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 公告 – 有关安全性、错误、兼容性、组件可靠性的信息。
http://espressif.com/en/support/documents/advisories

文档更新和更新通知订阅
http://espressif.com/en/support/download/documents

开发者专区

ESP-IDF Programming Guide for ESP32 – ESP-IDF 开发框架的详尽文档。
GitHub 上的 ESP-IDF 和其他开发框架。
http://github.com/espressif
ESP32 BBS 论坛 – 乐鑫产品的工程师对工程师 (E2E) 社区，您可以在其中发布问题，
与其他工程师分享知识、探索想法并帮助解决问题。
http://esp32.com/
ESP 期刊 – 来自 Espressif 的最佳实践、文章和注释。
http://medium.com/the-esp-journal

请参阅 SDK 和演示、应用程序、工具、AT 固件选项卡。
http://espressif.com/en/support/download/sdks-demos

产品

ESP32 系列 SoC – 浏览所有 ESP32 SoC。
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 产品选择器 – 通过比较或应用过滤器，找到适合您需求的 Espressif 硬件产品。
http://products.espressif.com/#/product-selector?language=en

联系我们

请参阅标签销售问题、技术查询、电路原理图和 PCB 设计重新view, 得到 Samples（在线商店），成为我们的供应商，评论和建议。
http://espressif.com/en/contact-us/sales-questions

修订历史

免责声明和版权声明

本文档中的信息，包括 URL 参考，如有更改，恕不另行通知。
本文档中的所有第三方信息均按原样提供，不保证其真实性和准确性。不对本文档的适销性、非侵权性、任何特定用途的适用性提供任何保证，也不提供因任何建议、规范或 S 引起的任何其他保证AMPLE。

不承担与使用本文档中的信息有关的所有责任，包括侵犯任何所有权的责任。此处未通过禁止反言或其他方式明示或暗示任何知识产权的许可。

Wi-Fi 联盟成员标志是 Wi-Fi 联盟的商标。蓝牙标志是
蓝牙 SIG 的注册商标。

本文档中提及的所有商品名称、商标和注册商标均为财产
其各自所有者，特此确认。

阅读有关本手册的更多信息并下载 PDF：

文件/资源

ESPRESSIF ESP32-WROOM-DA 带双天线的独立模块 [pdf] 用户手册
ESP32 -WROOM- DA，带双天线的独立模块，ESP32 -WROOM- DA 带双天线的独立模块

参考

用户手册