下载指导

[English]

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

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

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

下载 AT 固件

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

  • 前往 AT 固件

  • 找到您的模组所对应的 AT 固件

  • 点击相应链接进行下载

此处,我们下载了 ESP32-C6-MINI-1 对应的 ESP32C6-4MB-AT-V4.0.0.0 固件,该固件的目录结构及其中各个 bin 文件介绍如下,其它 ESP32-C6 系列模组固件的目录结构及 bin 文件也可参考如下介绍:

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

其中,download.config 文件包含烧录固件的参数:

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

  • --flash_mode dio 代表此固件采用的 flash dio 模式进行编译;

  • --flash_freq 80m 代表此固件采用的 flash 通讯频率为 80 MHz;

  • --flash_size 4MB 代表此固件适用的 flash 最小为 4 MB;

  • 0xd000 ota_data_initial.bin 代表在 0xd000 地址烧录 ota_data_initial.bin 文件。

烧录 AT 固件至设备

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

Windows

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

  • 打开 Flash 下载工具;

  • 选择芯片类型;(此处,我们选择 ESP32-C6。)

  • 根据您的需求选择一种工作模式;(此处,我们选择 develop。)

  • 根据您的需求选择一种下载接口;(此处,我们选择 uart。)

固件下载配置选择

固件下载配置选择

  • 将 AT 固件烧录至设备,以下两种方式任选其一:

    • 直接下载打包好的量产固件(即 build/factory 目录下的 factory_XXX.bin)至 0x0 地址:勾选 “DoNotChgBin”,使用量产固件的默认配置;

      下载至单个地址界面图

      下载至单个地址界面图(点击放大)

    • 分开下载多个 bin 文件至不同的地址:根据 download.config 文件进行配置,请勿勾选 “DoNotChgBin”;

      下载至多个地址界面图

      下载至多个地址界面图(点击放大)

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

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

Linux 或 macOS

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

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

  • 分开下载多个 bin 文件至不同的地址:输入以下命令,替换 PORTNAMEdownload.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 替换成该文件里的参数列表。

    以下是将固件烧录至 ESP32-C6-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 80m --flash_size 4MB 0x8000 partition_table/partition-table.bin 0xd000 ota_data_initial.bin 0x0 bootloader/bootloader.bin 0x60000 esp-at.bin 0x1e000 at_customize.bin 0x1f000 customized_partitions/mfg_nvs.bin
    
  • 直接下载打包好的量产固件至 0x0 地址:输入以下命令,替换 PORTNAMEFILEDIRECTORY 参数;

    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

    以下是将固件烧录至 ESP32-C6-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 80m --flash_size 4MB 0x0 factory/factory_ESP32C6-4MB.bin
    

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

检查 AT 固件是否烧录成功

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

  • 打开串口工具,如 SecureCRT;

  • 串口:选择用于发送或接收“AT 命令/响应”的串口(详情请见 硬件连接);

  • 波特率:115200;

  • 数据位:8;

  • 检验位:None;

  • 停止位:1;

  • 流控:None;

  • 输入 “AT+GMR” 命令,并且换行 (CR LF);

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

AT+GMR
AT version:4.0.0.0(3fe3806 - ESP32C6 - Dec 29 2023 11:10:21)
SDK version:v5.1.2-dirty
compile time(89040be7):Jan  2 2024 05:53:07
Bin version:v4.0.0.0(ESP32C6-4MB)

OK

否则,您需要通过以下方式之一检查 ESP32-C6 设备开机日志:

方法 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-C6 开机日志:

ESP-ROM:esp32c6-20220919
Build:Sep 19 2022
rst:0xc (SW_CPU),boot:0x6c (SPI_FAST_FLASH_BOOT)
Saved PC:0x4001975a
SPIWP:0xee
mode:DIO, clock div:2
load:0x4086c410,len:0xd50
load:0x4086e610,len:0x2d74
load:0x40875720,len:0x1800
entry 0x4086c410
I (27) boot: ESP-IDF v5.0-dev-9643-g4bc762621d-dirty 2nd stage bootloader
I (27) boot: compile time Jul  5 2023 11:12:16
I (29) boot: chip revision: v0.1
I (32) boot.esp32c6: SPI Speed      : 40MHz
I (37) boot.esp32c6: SPI Mode       : DIO
I (41) boot.esp32c6: SPI Flash Size : 4MB
I (46) boot: Enabling RNG early entropy source...
I (52) boot: Partition Table:
I (55) boot: ## Label            Usage          Type ST Offset   Length
I (62) boot:  0 otadata          OTA data         01 00 0000d000 00002000
I (70) boot:  1 phy_init         RF data          01 01 0000f000 00001000
I (77) boot:  2 nvs              WiFi data        01 02 00010000 0000e000
I (85) boot:  3 at_customize     unknown          40 00 0001e000 00042000
I (92) boot:  4 ota_0            OTA app          00 10 00060000 001d0000
I (100) boot:  5 ota_1            OTA app          00 11 00230000 001d0000
I (107) boot: End of partition table
I (112) esp_image: segment 0: paddr=00060020 vaddr=42140020 size=30628h (198184) map
I (198) esp_image: segment 1: paddr=00090650 vaddr=40800000 size=0f9c8h ( 63944) load
I (228) esp_image: segment 2: paddr=000a0020 vaddr=42000020 size=13c688h (1296008) map
I (740) esp_image: segment 3: paddr=001dc6b0 vaddr=4080f9c8 size=05bf4h ( 23540) load
I (752) esp_image: segment 4: paddr=001e22ac vaddr=408155c0 size=03c54h ( 15444) load
I (760) esp_image: segment 5: paddr=001e5f08 vaddr=50000000 size=00068h (   104) load
I (771) boot: Loaded app from partition at offset 0x60000
I (772) boot: Disabling RNG early entropy source...
no external 32k oscillator, disable it now.
at param mode: 1
AT cmd port:uart1 tx:7 rx:6 cts:5 rts:4 baudrate:115200
module_name: ESP32C6-4MB
max tx power=78, ret=0
4.0.0