下载指导

本文档以 ESP8684-MINI-1 模组为例，介绍如何下载 ESP8684-MINI-1 模组对应的 AT 固件，以及如何将固件烧录到模组上，其它 ESP32-C2 系列模组也可参考本文档。

下载和烧录 AT 固件之前，请确保您已正确连接所需硬件，具体可参考硬件连接。

对于不同系列的模组，AT 默认固件所支持的命令会有所差异。具体可参考 ESP-AT 固件差异。

下载 AT 固件

请按照以下步骤将 AT 固件下载至 PC：

前往 AT 固件
找到您的模组所对应的 AT 固件
点击相应链接进行下载

此处，我们下载了 ESP8684-MINI-1 对应的 ESP32C2-4MB_AT_Bin_V2.5.0.0 固件，该固件的目录结构及其中各个 bin 文件介绍如下，其它 ESP32-C2 系列模组固件的目录结构及 bin 文件也可参考如下介绍：

.
├── at_customize.bin                 // 二级分区表
├── bootloader                       // bootloader
│   └── bootloader.bin
├── customized_partitions            // AT 自定义 bin 文件
│   └── mfg_nvs.bin                  // 量产 NVS 分区
├── download.config                  // 烧录固件的参数
├── esp-at.bin                       // AT 应用固件
├── esp-at.elf
├── esp-at.map
├── factory                          // 量产所需打包好的 bin 文件
│   ├── factory_MINI-1.bin
│   └── factory_parameter.log
├── flasher_args.json                // 下载参数信息新的格式
├── ota_data_initial.bin             // ota data 区初始值
├── partition_table                  // 一级分区列表
│   └── partition-table.bin
├── phy_init_data.bin                // phy 初始值信息
└── sdkconfig                        // AT 固件对应的编译配置

其中，download.config 文件包含烧录固件的参数：

--flash_mode dio --flash_freq 60m --flash_size 4MB
0x0 bootloader/bootloader.bin
0x60000 esp-at.bin
0x8000 partition_table/partition-table.bin
0xd000 ota_data_initial.bin
0xf000 phy_init_data.bin
0x1e000 at_customize.bin
0x1F000 customized_partitions/mfg_nvs.bin

--flash_mode dio 代表此固件采用的 flash dio 模式进行编译；
--flash_freq 60m 代表此固件采用的 flash 通讯频率为 60 MHz；
--flash_size 4MB 代表此固件适用的 flash 最小为 4 MB；
0xd000 ota_data_initial.bin 代表在 0xd000 地址烧录 ota_data_initial.bin 文件。

烧录 AT 固件至设备

请根据您的操作系统选择对应的烧录方法。

Windows

开始烧录之前，请下载 Flash 下载工具。更多有关 Flash 下载工具的介绍，请参考压缩包中 doc 文件夹。

打开 Flash 下载工具；
选择芯片类型；（此处，我们选择 ESP32C2。）
根据您的需求选择一种工作模式；（此处，我们选择 develop。)
根据您的需求选择一种下载接口；（此处，我们选择 uart。)

固件下载配置选择

将 AT 固件烧录至设备，以下两种方式任选其一：
- 直接下载打包好的量产固件至 0x0 地址：勾选 “DoNotChgBin”，使用量产固件的默认配置；
  
  下载至单个地址界面图（点击放大）
- 分开下载多个 bin 文件至不同的地址：根据 download.config 文件进行配置，请勿勾选 “DoNotChgBin”；
  
  下载至多个地址界面图（点击放大）

为了避免烧录出现问题，请查看开发板的下载接口的 COM 端口号，并从 “COM:” 下拉列表中选择该端口号。有关如何查看端口号的详细介绍请参考在 Windows 上查看端口。

烧录完成后, 请检查 AT 固件是否烧录成功。

Linux 或 macOS

开始烧录之前，请安装 esptool.py。

以下两种方式任选其一，将 AT 固件烧录至设备：

分开下载多个 bin 文件至不同的地址：输入以下命令，替换 PORTNAME 和 download.config 参数；

esptool.py --chip auto --port PORTNAME --baud 115200 --before default_reset --after hard_reset write_flash -z download.config

将 PORTNAME 替换成开发板的下载接口名称，若您无法确定该接口名称，请参考在 Linux 和 macOS 上查看端口。

将 download.config 替换成该文件里的参数列表。

以下是将固件烧录至 ESP8684-MINI-1 模组输入的命令：

esptool.py --chip auto --port /dev/tty.usbserial-0001 --baud 115200 --before default_reset --after hard_reset write_flash -z --flash_mode dio --flash_freq 60m --flash_size 4MB 0x0 bootloader/bootloader.bin 0x60000 esp-at.bin 0x8000 partition_table/partition-table.bin 0xd000 ota_data_initial.bin 0xf000 phy_init_data.bin 0x1e000 at_customize.bin 0x1F000 customized_partitions/mfg_nvs.bin

直接下载打包好的量产固件至 0x0 地址：输入以下命令，替换 PORTNAME 和 FILEDIRECTORY 参数；
```
esptool.py --chip auto --port PORTNAME --baud 115200 --before default_reset --after hard_reset write_flash -z --flash_mode dio --flash_freq 40m --flash_size 4MB 0x0 FILEDIRECTORY
```
将 PORTNAME 替换成开发板的下载接口名称，若您无法确定该接口名称，请参考在 Linux 和 macOS 上查看端口。

将 FILEDIRECTORY 替换成打包好的量产固件的文件路径，通常情况下，文件路径是 factory/XXX.bin。

以下是将固件烧录至 ESP8684-MINI-1 模组输入的命令：
esptool.py --chip auto --port /dev/tty.usbserial-0001 --baud 115200 --before default_reset --after hard_reset write_flash -z --flash_mode dio --flash_freq 60m --flash_size 4MB 0x0 factory/factory_MINI-1.bin

烧录完成后，请检查 AT 固件是否烧录成功。

检查 AT 固件是否烧录成功

请按照以下步骤检查 AT 固件是否烧录成功：

打开串口工具，如 SecureCRT；
串口：选择用于发送或接收“AT 命令/响应”的串口（详情请见硬件连接）；
波特率：115200；
数据位：8；
检验位：None；
停止位：1；
流控：None；
输入 “AT+GMR” 命令，并且换行 (CR LF)；

若如下图所示，响应是 OK, 则表示 AT 固件烧录成功。

AT 响应

否则，您需要通过以下方式之一检查 ESP32-C2 设备开机日志：

方法 1：

打开串口工具，如 SecureCRT；
串口：选择用于“下载固件/输出日志”的串口，串口详情请参阅硬件连接。
波特率：115200；
数据位：8；
检验位：None；
停止位：1；
流控：None；
直接按开发板的 RST 键，若日志和下面的日志相似，则说明 ESP-AT 固件已经正确初始化了。

方法 2：

打开两个串口工具，如 SecureCRT；
串口：分别选择用于发送或接收“AT 命令/响应”的串口以及用于“下载固件/输出日志”的串口，串口详情请参阅硬件连接。
波特率：115200；
数据位：8；
检验位：None；
停止位：1；
流控：None；
在发送或接收“AT 命令/响应”的串口输入 AT+RST 命令，并且换行 (CR LF)，若“下载固件/输出日志”的串口日志和下面的日志相似，则说明 ESP-AT 固件已经正确初始化了。

ESP32-C2 开机日志:

ESP-ROM:esp8684-api2-20220127
Build:Jan 27 2022
rst:0x1 (POWERON),boot:0xc (SPI_FAST_FLASH_BOOT)
SPIWP:0xee
mode:DIO, clock div:1
load:0x3fcd6108,len:0x18b0
load:0x403ae000,len:0x854
load:0x403b0000,len:0x2724
entry 0x403ae000
I (32) boot: ESP-IDF v5.0-dev-5949-g885e501d99-dirty 2nd stage bootloader
I (32) boot: compile time 11:05:11
I (32) boot: chip revision: v1.0
I (36) boot.esp32c2: MMU Page Size  : 64K
I (41) boot.esp32c2: SPI Speed      : 60MHz
I (46) boot.esp32c2: SPI Mode       : DIO
I (50) boot.esp32c2: SPI Flash Size : 4MB
I (55) boot: Enabling RNG early entropy source...
I (61) boot: Partition Table:
I (64) boot: ## Label            Usage          Type ST Offset   Length
I (71) boot:  0 otadata          OTA data         01 00 0000d000 00002000
I (79) boot:  1 phy_init         RF data          01 01 0000f000 00001000
I (86) boot:  2 nvs              WiFi data        01 02 00010000 0000e000
I (94) boot:  3 at_customize     unknown          40 00 0001e000 00042000
I (101) boot:  4 ota_0            OTA app          00 10 00060000 001d0000
I (109) boot:  5 ota_1            OTA app          00 11 00230000 001d0000
I (116) boot: End of partition table
I (121) esp_image: segment 0: paddr=00060020 vaddr=3c0e0020 size=288c8h (166088) map
I (167) esp_image: segment 1: paddr=000888f0 vaddr=3fca6010 size=02c18h ( 11288) load
I (170) esp_image: segment 2: paddr=0008b510 vaddr=40380000 size=04b08h ( 19208) load
I (178) esp_image: segment 3: paddr=00090020 vaddr=42000020 size=d444ch (869452) map
I (378) esp_image: segment 4: paddr=00164474 vaddr=40384b08 size=01508h (  5384) load
I (382) boot: Loaded app from partition at offset 0x60000
I (383) boot: Disabling RNG early entropy source...
at param mode: 1
AT cmd port:uart1 tx:7 rx:6 cts:5 rts:4 baudrate:115200
module_name: ESP32C2-4MB
max tx power=78, ret=0
3.0.0

提供有关此文档的反馈