ESP32MINI1
用户手册
初步 v0.1
乐鑫系统
版权所有 © 2021
关于本手册
本用户手册介绍了如何开始使用 ESP32-MINI-1 模块。
文件更新
请始终参考最新版本 https://www.espressif.com/en/support/download/documents.
修订历史
有关本文档的修订历史，请参阅最后一页。
文件变更通知
乐鑫提供电子邮件通知，让客户及时了解技术文档的更改。 请订阅 www.espressif.com/zh/subscribe.
认证
下载 Espressif 产品的证书： www.espressif.com/en/certificates.
超过view
1.1 个模块结束view
具有丰富外设的 LE MCU 模块。 该模块是各种物联网应用的理想选择，从家庭自动化、智能建筑、消费电子到工业控制，尤其适用于紧凑空间内的应用，例如灯泡、开关和插座。 ESP32-MINI-1是一款高度集成的小型Wi-Fi+Bluetooth ® +Bluetooth ® 该模块有两个版本：
- 85°C 版本
- 105°C 版本
表 1. ESP1MINI32 规格
| 类别 | 项目 | 规格 |
|
无线上网 |
协议 | 802.11 b/g/n（802.11n 高达 150 Mbps） |
| A-MPDU 和 A-MSDU 聚合和 0.4 µs 保护间隔支持 | ||
| 频率范围 | 2412〜2484兆赫 | |
|
蓝牙® |
协议 | 协议 v4.2 BR/EDR 和蓝牙® LE 规格 |
| 收音机 | 1 类、2 类和 3 类发射器 | |
| 房颤 | ||
| 声音的 | CVSD 和 SBC | |
|
硬件 |
模块接口 |
SD卡、UART、SPI、SDIO、I2C、LED PWM、电机PWM、I2S、红外遥控器、脉冲计数器、GPIO、触摸传感器、ADC、DAC、两线汽车接口（TWAITM, 兼容 ISO11898-1) |
| 集成水晶 | 40 MHz 晶振 | |
| 集成 SPI 闪存 | 4 兆字节 | |
| 操作量tage/电源 | 3.0 伏 ~ 3.6 伏 | |
| 工作电流 | 平均：80毫安 | |
| 电源提供的最小电流 | 500 毫安 | |
| 推荐工作温度范围 | 85 °C 版本：–40 °C ~ +85 °C； 105 °C 版本：–40 °C ~ +105 °C | |
| 湿度敏感度 (MSL) | 3 级 |
1.2 引脚说明
ESP32-MINI-1 有 55 个引脚。 请参见表 1-2 中的引脚定义。
表 1. 引脚定义
| 姓名 | 不。 | 类型 | 功能 |
| 地线 | 1、2、27、38~55 | P | 地面 |
| 3V3 | 3 | P | 电源 |
| I36 | 4 | I | GPIO36、ADC1_CH0、RTC_GPIO0 |
| I37 | 5 | I | GPIO37、ADC1_CH1、RTC_GPIO1 |
| I38 | 6 | I | GPIO38、ADC1_CH2、RTC_GPIO2 |
| I39 | 7 | I | GPIO39、ADC1_CH3、RTC_GPIO3 |
|
EN |
8 |
I |
高：芯片使能 低：芯片断电 笔记： 不要让引脚悬空 |
| I34 | 9 | I | GPIO34、ADC1_CH6、RTC_GPIO4 |
| I35 | 10 | I | GPIO35、ADC1_CH7、RTC_GPIO5 |
| IO32 | 11 | 输入/输出 | GPIO32、XTAL_32K_P（32.768 kHz 晶振输入）、ADC1_CH4、TOUCH9、RTC_GPIO9 |
| IO33 | 12 | 输入/输出 | GPIO33、XTAL_32K_N（32.768 kHz晶振输出）、ADC1_CH5、TOUCH8、RTC_GPIO8 |
| IO25 | 13 | 输入/输出 | GPIO25、DAC_1、ADC2_CH8、RTC_GPIO6、EMAC_RXD0 |
| IO26 | 14 | 输入/输出 | GPIO26、DAC_2、ADC2_CH9、RTC_GPIO7、EMAC_RXD1 |
| IO27 | 15 | 输入/输出 | GPIO27、ADC2_CH7、TOUCH7、RTC_GPIO17、EMAC_RX_DV |
| IO14 | 16 | 输入/输出 | GPIO14、ADC2_CH6、TOUCH6、RTC_GPIO16、MTMS、HSPICLK、HS2_CLK、SD_CLK、EMAC_TXD2 |
| IO12 | 17 | 输入/输出 | GPIO12、ADC2_CH5、TOUCH5、RTC_GPIO15、MTDI、HSPIQ、HS2_DATA2、SD_DATA2、EMAC_TXD3 |
| IO13 | 18 | 输入/输出 | GPIO13、ADC2_CH4、TOUCH4、RTC_GPIO14、MTCK、HSPID、HS2_DATA3、SD_DATA3、EMAC_RX_ER |
| IO15 | 19 | 输入/输出 | GPIO15、ADC2_CH3、TOUCH3、RTC_GPIO13、MTDO、HSPICS0、HS2_CMD、SD_CMD、EMAC_RXD3 |
| IO2 | 20 | 输入/输出 | GPIO2、ADC2_CH2、TOUCH2、RTC_GPIO12、HSPIWP、HS2_DATA0、
SD_DATA0 |
| IO0 | 21 | 输入/输出 | GPIO0、ADC2_CH1、TOUCH1、RTC_GPIO11、CLK_OUT1、EMAC_TX_CLK |
| IO4 | 22 | 输入/输出 | GPIO4、ADC2_CH0、TOUCH0、RTC_GPIO10、HSPIHD、HS2_DATA1、SD_DATA1、EMAC_TX_ER |
| NC | 23 | – | 没有连接 |
| NC | 24 | – | 没有连接 |
| IO9 | 25 | 输入/输出 | GPIO9、HS1_DATA2、U1RXD、SD_DATA2 |
| IO10 | 26 | 输入/输出 | GPIO10、HS1_DATA3、U1TXD、SD_DATA3 |
| NC | 28 | – | 没有连接 |
| IO5 | 29 | 输入/输出 | GPIO5、HS1_DATA6、VSPICS0、EMAC_RX_CLK |
| IO18 | 30 | 输入/输出 | GPIO18、HS1_DATA7、VSPICLK |
| IO23 | 31 | 输入/输出 | GPIO23、HS1_STROBE、VSPID |
| IO19 | 32 | 输入/输出 | GPIO19、VSPIQ、U0CTS、EMAC_TXD0 |
下页续
表 1 – 接上页
| 姓名 | 不。 | 类型 | 功能 |
| IO22 | 33 | 输入/输出 | GPIO22、VSPIWP、U0RTS、EMAC_TXD1 |
| IO21 | 34 | 输入/输出 | GPIO21、VSPIHD、EMAC_TX_EN |
| RXD0 | 35 | 输入/输出 | GPIO3、U0RXD、CLK_OUT2 |
| 发送端0 | 36 | 输入/输出 | GPIO1、U0TXD、CLK_OUT3、EMAC_RXD2 |
| NC | 37 | – | 没有连接 |
¹ ESP6-U7WDH 芯片上的 GPIO8、GPIO11、GPIO16、GPIO17、GPIO32、GPIO4 引脚与模块集成的 SPI flash 相连，不引出。
² 外设管脚配置请参考 ESP32 系列数据表.
开始使用 ESP32MINI1
2.1 您需要什么
要为 ESP32-MINI-1 模块开发应用程序，您需要：
- 1 x ESP32-MINI-1 模块
- 1 x 乐鑫射频测试板
- 1 x USB 转串口板
- 1 x 微型 USB 数据线
- 1 台运行 Linux 的 PC
在本用户指南中，我们以 Linux 操作系统为例amp乐。 有关 Windows 和 macOS 上的配置的更多信息，请参阅 ESP-IDF 编程指南。
2.2 硬件连接
- 将 ESP32-MINI-1 模块焊接到射频测试板上，如图 2-1 所示。
- 通过 TXD、RXD 和 GND 将 RF 测试板连接到 USB 转串口板。
- 将 USB 转串口板连接到 PC。
- 通过 Micro-USB 电缆将射频测试板连接到 PC 或电源适配器以启用 5 V 电源。
- 在下载过程中，通过跳线将 IO0 连接到 GND。 然后，打开测试板。
- 将固件下载到闪存中。 有关详细信息，请参阅以下部分。
- 下载后，将 IO0 和 GND 上的跳线去掉。
- 再次给射频测试板加电。 ESP32-MINI-1 将切换到工作模式。 初始化时芯片会从闪存中读取程序。
笔记：
IO0 内部为逻辑高电平。 如果 IO0 设置为上拉，则选择 Boot 模式。 如果此引脚为下拉或悬空，则选择下载模式。 有关 ESP32-MINI-1 的更多信息，请参阅 ESP32-MINI-1 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-cache 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-MINI-1 模块构建应用程序，您需要乐鑫提供的软件库 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-MINI-1 模块上构建您的第一个项目。
2.4 创建你的第一个项目
2.4.1 启动项目
现在您已准备好为 ESP32-MINI-1 模块准备应用程序。 你可以从 入门/hello_world 来自前任的项目ampESP-IDF 中的 .les 目录。
将 get-started/hello_world 复制到 ~/esp 目录：
光盘 ~/esp
cp -r $IDF_PATH/examples/get-started/hello_world 。
有一系列 examp项目 在前ampESP-IDF 中的 .les 目录。 您可以以与上述相同的方式复制任何项目并运行它。 也可以构建 examp就地文件，而不是先复制它们。
2.4.2 连接您的设备
现在将您的 ESP32-MINI-1 模块连接到计算机并检查模块在哪个串口下可见。 Linux 中的串行端口名称中以“/dev/tty”开头。 运行以下命令两次，首先拔下电路板，然后插入电源。第二次出现的端口就是您需要的端口：
ls /dev/tty*
笔记：
将端口名称放在手边，因为您将在接下来的步骤中使用它。
2.4.3 配置
从步骤 2.4.1 导航到您的“hello_world”目录。 启动一个项目，将 ESP32 芯片设置为目标，然后运行
项目配置实用程序“menuconfig”。
cd ~/esp/你好世界
idf .py set-target esp32
idf .py 菜单配置
在打开一个新项目后，应该使用 'idf.py set-target esp32' 设置目标一次。 如果项目包含一些现有的构建和配置，它们将被清除和初始化。 目标可以保存在环境变量中以完全跳过这一步。 有关其他信息，请参阅选择目标。
如果前面的步骤已正确完成，则会出现以下菜单：
菜单的颜色在您的终端中可能会有所不同。 您可以使用选项“–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 build/bootloader/bootloader。 bin 0x8000 build/ partition_table / partition -table.bin 或运行'idf .py -p PORT flash'
如果没有错误，构建将通过生成固件二进制文件 .bin 来完成 file.
2.4.5 刷入设备
通过运行以下命令将您刚刚构建到 ESP32-MINI-1 模块的二进制文件刷入：
idf .py -p 端口 [-b 波特率] 闪存
将 PORT 替换为来自步骤：连接您的设备的模块的串行端口名称。 您还可以通过将 BAUD 替换为您需要的波特率来更改闪光灯波特率。 默认波特率为 460800。
有关 idf.py 参数的更多信息，请参阅 idf.py。
笔记：
选项“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
引导加载程序/引导加载程序。 bin 0x8000 partition_table / 分区-table.bin 0x10000 hello-world.bin
esptool.py v2.3.1 版本
连接……
检测芯片类型…ESP32
芯片为 ESP32U4WDH（修订版 3）
特点：WiFi、BT、单核
正在上传存根…
运行存根…
存根运行…
将波特率更改为 460800
改变了。
配置闪存大小…
自动检测到的闪存大小：4MB
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 引脚硬复位…
如果一切顺利，在您移除 IO0 和 GND 上的跳线后，“hello_world”应用程序开始运行，并重新启动测试板。
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。 精灵“……
----- /dev/ttyUSB0 115200 上的 idf_monitor ---------
退出：Ctrl+] | 菜单：Ctrl+T | 帮助：Ctrl+T 后跟 Ctrl+H −−ets
8 年 2016 月 00 日 22:57:XNUMX
第一次：0x1（POWERON_RESET），启动：0x13（SPI_FAST_FLASH_BOOT）
等 8 年 2016 月 00 日 22:57:XNUMX…
启动和诊断日志向上滚动后，您应该会看到“Hello world！” 由应用程序打印出来。
…
你好世界！
10 秒后重启……
这是具有 32 个 CPU 内核、WiFi/BT/BLE、硅版本 1、3MB 外部闪存的 esp4 芯片
9 秒后重启……
8 秒后重启……
7 秒后重启……
要退出 IDF 监视器，请使用快捷键 Ctrl+]。
这就是您开始使用 ESP32-MINI-1 模块所需的全部内容！ 现在你准备好尝试其他的了 examp莱斯 在 ESP-IDF 中，或直接开发自己的应用程序。
学习资源
3.1 必读文件
以下链接提供了与 ESP32 相关的文档。
- ESP32 数据表
本文档介绍了 ESP32 硬件的规格，包括超过view,
引脚定义、功能描述、外设接口、电气特性等。 - ESP32 ECO V3 用户指南
本文档描述了 V3 和之前的 ESP32 硅晶圆版本之间的差异。 - ESP32 中错误的 ECO 和解决方法
本文档详细介绍了 ESP32 中的硬件勘误表和解决方法。 - ESP-IDF 编程指南
它包含大量的 ESP-IDF 文档，从硬件指南到 API 参考。 - ESP32 技术参考手册
该手册提供了有关如何使用 ESP32 内存和外围设备的详细信息。 - ESP32 硬件资源
拉链 files包括ESP32模块和开发板的原理图、PCB布局、Gerber和BOM列表。 - ESP32 硬件设计指南
该指南概述了基于 ESP32 系列产品（包括 ESP32 芯片、ESP32 模块和开发板）开发独立或附加系统时推荐的设计实践。 - ESP32 AT 指令集和 Examp莱斯
本文档介绍了 ESP32 AT 命令，解释了如何使用它们，并提供了 examp几个通用 AT 命令的文件。 - 乐鑫产品订购信息
3.2 必备资源
这里是 ESP32 相关的必备资源。
- ESP32 论坛
这是 ESP2 的工程师对工程师 (E32E) 社区，您可以在其中发布问题、分享知识、探索想法并帮助与其他工程师一起解决问题。 - ESP32 GitHub
ESP32 开发项目在 Espressif 的 MIT 许可下在 GitHub 上免费分发。 它旨在帮助开发人员开始使用 ESP32，促进创新和增长有关 ESP32 设备周围硬件和软件的一般知识。 - ESP32 工具
这是一个 web用户可以下载 ESP32 Flash 下载工具和 zip 的页面 file 《ESP32认证与测试》.. - 静电除尘器
这 web页面将用户链接到 ESP32 的官方 IoT 开发框架。 - ESP32 资源
这 web页面提供了所有可用 ESP32 文档、SDK 和工具的链接。
修订历史
| 日期 | 版本 | 发行说明 |
| 2021-01-14 | V0.1 | 初步发布 |
免责声明和版权声明
本文档中的信息，包括 URL 参考，如有更改，恕不另行通知。
本文档中的所有第三方信息均按原样提供，不保证其真实性和准确性。
不对本文档的适销性、非侵权性、任何特定用途的适用性提供任何保证，也不提供因任何提议、规范或 S 引起的任何其他保证AMPLE。
不承担与使用本文档中的信息有关的所有责任，包括侵犯任何所有权的责任。 此处未通过禁止反言或其他方式明示或暗示任何知识产权的许可。
Wi-Fi 联盟成员标志是 Wi-Fi 联盟的商标。 蓝牙标志是蓝牙 SIG 的注册商标。
本文档中提及的所有商品名称、商标和注册商标均为其各自所有者的财产，特此声明。
版权所有 © 2021 乐鑫系统（上海）有限公司。保留所有权利。
乐鑫系统
ESP32-MINI-1 用户手册（初级 v0.1）
乐鑫网
文件/资源
 |
ESPRESSIF ESP32-MINI-1 高集成小尺寸 Wi-Fi+蓝牙模块 [pdf] 用户手册 ESP32MINI1、2AC7Z-ESP32MINI1、2AC7ZESP32MINI1、ESP32-MINI-1 高集成度小尺寸 Wi-Fi 蓝牙模块、ESP32-MINI-1、高集成度小尺寸 Wi-Fi 蓝牙模块 |
