ESPRESSIF ESP32-C3-MINI-1 Wi-Fi 和蓝牙物联网模块用户手册

类别	参数	规格
无线上网	协议	802.11 b/g/n（高达 150 Mbps）
无线上网	频率范围	2412〜2462兆赫
蓝牙^®	协议	蓝牙^® LE：蓝牙 5 和蓝牙网状网络
蓝牙^®	收音机	1 类、2 类和 3 类发射器
硬件	模块接口	GPIO、SPI、UART、I2C、I2S、遥控外设、LED PWM控制器、通用DMA控制器、TWAI^® 控制器（与 ISO 11898-1 兼容）、温度传感器、SAR ADC
	集成水晶	40 MHz 晶振
	操作量tage/电源	3.0 伏 ~ 3.6 伏
	工作电流	平均：80毫安
	电源提供的最小电流供应	500 毫安
	环境温度	–40°C ~ +105°C
	湿度敏感度 (MSL)	3 级

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

该模块有 53 个引脚。请参见表 2 中的引脚定义。
外设管脚配置请参考 ESP32-C3 Family Datasheet。
表 2：引脚定义

姓名	不。	类型	功能
地线	1，2，11，14，36 53	P	地面
3V3	3	P	电源
NC	4	—	NC
IO2	5	输入/输出/T	GPIO2、ADC1_CH2、FSPIQ
IO3	6	输入/输出/T	GPIO3、ADC1_CH3
NC	7	—	NC
EN	8	I	High：开，使能芯片。低：关闭，芯片断电。注意：不要让 EN 引脚悬空。
NC	9	—	NC
NC	10	—	NC
IO0	12	输入/输出/T	GPIO0、ADC1_CH0、XTAL_32K_P
IO1	13	输入/输出/T	GPIO1、ADC1_CH1、XTAL_32K_N
NC	15	—	NC
IO10	16	输入/输出/T	GPIO10、FSPICS0
NC	17	—	NC
IO4	18	输入/输出/T	GPIO4、ADC1_CH4、FSPIHD、MTMS
IO5	19	输入/输出/T	GPIO5、ADC2_CH0、FSPIWP、MTDI
IO6	20	输入/输出/T	GPIO6、FSPICLK、MTCK
IO7	21	输入/输出/T	GPIO7、FSPID、MTDO
IO8	22	输入/输出/T	GPIO8
IO9	23	输入/输出/T	GPIO9
NC	24	—	NC
NC	25	—	NC
IO18	26	输入/输出/T	GPIO18
IO19	27	输入/输出/T	GPIO19
NC	28	—	NC
NC	29	—	NC
RXD0	30	输入/输出/T	GPIO20、U0RXD、
发送端0	31	输入/输出/T	GPIO21，U0TXD
NC	32	—	NC
NC	33	—	NC
NC	34	—	NC
NC	35	—	NC

开始使用 ESP32C3MINI1

你需要什么

要为 ESP32-C3-MINI-1 模块开发应用程序，您需要：

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

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

硬件连接

将 ESP32-C3-MINI-1 模块焊接到射频测试板上，如图 2 所示。

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

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

下载后，将 IO0 和 GND 上的跳线去掉。
再次启动射频测试板。 ESP32-C3-MINI-1 将切换到工作模式。芯片在初始化时会从 flash 中读取程序。
笔记
IO0 内部为逻辑高电平。如果 IO0 设置为上拉，则选择 Boot 模式。如果该引脚被下拉或悬空，则
选择下载模式。有关 ESP32-C3 MINI-1 的更多信息，请参阅 ESP32-C3-MINI-1 Datasheet。

搭建开发环境

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

安装先决条件
要使用 ESP-IDF 进行编译，您需要获取以下软件包：
- CentOS 7：
  1 sudo yum 安装 git wget flex bison gperf python cmake ninja-build ccache dfuutil
- Ubuntu 和 Debian（一个命令分成两行）：
  1. sudo apt-get install git wget flex bison gperf python python-pip pythonsetuptools cmake
  2. ninja-build ccache libffi-dev libssl-dev dfu-util
- 拱：
  - 1 sudo pacman -S –需要 gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util
    笔记
  - 本指南使用 Linux 上的 ~/esp 目录作为 ESP-IDF 的安装文件夹。
  - 请记住，ESP-IDF 不支持路径中的空格。

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

设置工具
除了 ESP-IDF，您还需要安装 ESP-IDF 使用的工具，例如编译器、调试器、Python 包等。ESP-IDF 提供了一个名为“install.sh”的脚本来帮助设置工具一气呵成。
1. cd ~/esp/esp-idf
2. /安装.sh
设置环境变量
安装的工具尚未添加到 PATH 环境变量中。为了使这些工具可以从命令行使用，必须设置一些环境变量。 ESP-IDF 提供了另一个脚本“export.sh”来执行此操作。在您要使用 ESP-IDF 的终端中，运行：
- $HOME/esp/esp-idf/export.sh
  现在一切准备就绪，您可以在 ESP32-C3 MINI-1 模块上构建您的第一个项目。

创建您的第一个项目

开始一个项目
现在您已准备好为 ESP32-C3-MINI-1 模块准备应用程序。您可以从 ex 的 get-started/hello_world 项目开始ampESP-IDF 中的 .les 目录。
将 get-started/hello_world 复制到 ~/esp 目录：
1. 光盘 ~/esp
2. cp -r $IDF_PATH/examples/get-started/hello_world 。
  有一个范围的前amp前的项目ampESP-IDF 中的 .les 目录。您可以以与上述相同的方式复制任何项目并运行它。也可以构建 examp文件到位，而不是先复制它们。
  有一个范围的前amp前的项目ampESP IDF 中的 .les 目录。您可以以与上述相同的方式复制任何项目并运行它。也可以构建 examp文件到位，而不是先复制它们。
连接您的设备
现在将您的 ESP32-C3-MINI-1 模块连接到计算机并检查模块在哪个串口下可见。 Linux 中的串行端口名称中以“/dev/tty”开头。运行以下命令两次，首先使用
板拔下，然后插入。第二次出现的端口是您需要的端口：
- ls /dev/tty*
  笔记
  将端口名称放在手边，因为您将在接下来的步骤中使用它。
配置
从步骤 2.4.1 导航到您的“hello_world”目录。启动一个项目，将 ESP32-C3 设置为目标并运行项目配置实用程序“menuconfig”。
1. cd ~/esp/你好世界
2. idf.py 设置目标 esp32c3
3. idf.py 菜单配置
  在打开一个新项目后，应该使用 'idf.py set-target esp32c3' 设置目标一次。如果项目包含一些现有的构建和配置，它们将被清除和初始化。目标可以保存在环境变量中以完全跳过此步骤。有关其他信息，请参阅选择目标。
  如果前面的步骤已正确完成，则会出现以下菜单：
  图 3：项目配置主窗口
  
  菜单的颜色在您的终端中可能会有所不同。您可以使用选项“–style”更改外观。请运行“idf.py menuconfig –help”获取更多信息
构建项目
通过运行构建项目：
1. idf.py b
  该命令将编译应用程序和所有 ESP-IDF 组件，然后生成引导加载程序、分区表和应用程序二进制文件。
  1. $ idf.py 构建
  2. 在目录 /path/to/hello_world/build 中运行 cmake
  3. 执行“cmake -G Ninja –warn-uninitialized /path/to/hello_world”…
  4. 警告未初始化的值。
  5. — 找到 Git：/usr/bin/git（找到版本“2.17.0”）
  6. — 由于配置而构建空的 aws_iot 组件
  7. — 组件名称：……
  8. — 组件路径：……
  10. …（更多的构建系统行
  12. [527/527] 生成 hello-world.bin
  13. esptool.py v2.3.1 版本
  15. 项目搭建完成。要刷机，请运行以下命令：
  16. ../../../components/esptool_py/esptool/esptool.py -p (PORT) -b 921600 write_flash –flash_mode dio
  17. –flash_size 检测 –flash_freq 40m 0x10000 build/hello world.bin build 0x1000
  18. 构建/bootloader/bootloader.bin 0x8000 构建/partition_table/partition-table.bin
  19. 或运行'idf.py -p PORT flash'
    如果没有错误，构建将通过生成固件二进制文件 .bin 来完成 file.
闪存到设备上
通过运行以下命令将您刚刚构建到 ESP32-C3-MINI-1 模块的二进制文件刷入：
1. idf.py -p 端口 [-b 波特率] 闪存
  将 PORT 替换为来自步骤：连接您的设备的模块的串行端口名称。
  您还可以通过将 BAUD 替换为您需要的波特率来更改闪光灯波特率。默认波特率为 460800。
  有关 idf.py 参数的更多信息，请参阅 idf.py。

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

…
esptool.py –chip esp32c3 -p /dev/ttyUSB0 -b 460800 –before=default_reset –after=hard_reset write_flash –flash_mode dio –flash_freq 80m –flash_size 2MB 0x 8000 partition_table/partition-table.bin 0x0 bootloader/bootloader.bin 0x10000 你好-world.bin
esptool.py v3.0 版本
串口/dev/ttyUSB0
连接……
芯片为ESP32-C3
特点：无线网络
晶体为 40MHz
MAC: 7c:df:a1:40:02:a4
正在上传存根…
运行存根…
存根运行…
将波特率更改为 460800
改变了。
正在配置闪存大小...
将 3072 字节压缩为 103…
写入 0x00008000… (100 %)
在 3072 秒内（有效 103 kbit/s）在 0x00008000 处写入了 0.0 个字节（4238.1 个压缩）……
验证的数据哈希。
将 18960 字节压缩为 11311…
写入 0x00000000… (100 %)
在 18960 秒内（有效 11311 kbit/s）在 0x00000000 处写入了 0.3 字节（584.9 压缩）……
验证的数据哈希。
将 145520 字节压缩为 71984…
写入 0x00010000… (20 %)
写入 0x00014000… (40 %)
写入 0x00018000… (60 %)
写入 0x0001c000… (80 %)
写入 0x00020000… (100 %)
在 145520 秒内（有效 71984 kbit/s）在 0x00010000 处写入了 2.3 字节（504.4 压缩）……
验证的数据哈希。
离开…
通过 RTS 引脚硬复位…
完毕

如果一切顺利，在您移除 IO0 和 GND 上的跳线后，“hello_world”应用程序开始运行，并重新启动测试板。

监视器

要检查“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 秒后重启……
这是 esp32c3 芯片，具有 1 个 CPU 内核、WiFi/BLE、4MB 外部闪存
9 秒后重启……
8 秒后重启……
7 秒后重启……

要退出 IDF 监视器，请使用快捷键 Ctrl+]。

这就是您开始使用 ESP32-C3-MINI-1 模块所需的全部内容！现在你准备好尝试其他的前任了ampESP-IDF 中的文件，或者直接开发自己的应用程序。

学习资源

必读文件
请熟悉以下文件：
ESP32-C3 系列数据表
这是对ESP32-C3硬件规格的介绍，包括超过view，引脚定义，
功能描述、外围接口、电气特性等

ESP-IDF 编程指南
ESP-IDF 开发框架的大量文档，从硬件指南到 API
参考。
ESP32-C3 技术参考手册
有关如何使用 ESP32-C3 内存和外设的详细信息。
乐鑫产品订购信息

重要资源

以下是与 ESP32-C3 相关的重要资源。

ESP32 论坛
乐鑫产品的工程师对工程师 (E2E) 社区，您可以在其中发布问题、分享知识、探索想法并帮助与其他工程师一起解决问题。

修订历史

日期	版本	发行说明
2021-02-01	V0.1	初步发布

免责声明和版权声明
本文档中的信息，包括 URL 参考，如有更改，恕不另行通知。
本文档中的所有第三方信息均按原样提供，不保证其真实性和准确性。不对本文档的适销性、非侵权性、任何特定用途的适用性提供任何保证，也不提供因任何建议、规范或 S 引起的任何其他保证AMPLE。
不承担与使用本文档中的信息有关的所有责任，包括侵犯任何所有权的责任。此处未通过禁止反言或其他方式明示或暗示任何知识产权的许可。
Wi-Fi 联盟成员标志是 Wi-Fi 联盟的商标。蓝牙标志是蓝牙 SIG 的注册商标。
本文档中提及的所有商品名称、商标和注册商标均为其各自所有者的财产，特此声明。
版权所有 © 2021 乐鑫系统（上海）有限公司。保留所有权利。