ESP32 固件开发
S3 特指带触摸的 ESP32 板子
# ESP32 基础
固件开发,本质上就是在电脑上编代码,然后把交叉编译的二进制程序烧录到硬件上
- 编码:VSCode + Espressif IDF 插件 Vibe 即可
- 编译:ESP-IDF 提供 arm64 交叉编译工具链
- 烧录:ESP-IDF 提供现有的烧录工具 esptool.py(python 包)
很多教程里会使用 Arduino IDE 去开发 ESP32,其实就是在 GUI 里集成了 IDF Cli。IDF 指 IoT Development Framework 物联网开发框架 —— 一个以 idf.py 为入口的 Python 包
# ESP-IDF
ESP-IDF 的 venv 要用 python3.12
用 uv 管理 python 环境
uv python install 3.12 --default
python -V
2
下载前置依赖
xcode-select --install
brew install cmake ninja dfu-util ccache
2
克隆源码
cd ~/Workspace
mkdir -p esp
cd esp
git clone -b v5.4 --depth 1 https://github.com/espressif/esp-idf.git
cd esp-idf
git submodule update --init --recursive --depth 1 --jobs 8 --progress # 下载子模块
git submodule status | grep -c '^-' # 输出 0 OK
2
3
4
5
6
7
install.sh 安装工具链(注意 python3.12)
./install.sh esp32s3
激活环境:导入 esptool 命令
. ./export.sh
验证
idf.py --version
xtensa-esp32s3-elf-gcc --version
which esptool.py
2
3
# esptool
esptool 是 esp-idf 携带的烧录工具,用于读写固件
固件上电,并且电脑正确识别到 /dev/cu.usbmodem1201 后,使用 esptool 查看其容量和 flash 型号
northboat@bogon esp-idf % esptool.py --chip esp32s3 -p /dev/cu.usbmodem1201 flash_id
esptool.py v4.12.0
Serial port /dev/cu.usbmodem1201
Connecting...
Chip is ESP32-S3 (QFN56) (revision v0.2)
Features: WiFi, BLE, Embedded PSRAM 8MB (AP_3v3)
Crystal is 40MHz
USB mode: USB-Serial/JTAG
MAC: c4:9e:7e:0b:77:b4
Uploading stub...
Running stub...
Stub running...
Manufacturer: c8
Device: 4019
Detected flash size: 32MB
Flash type set in eFuse: quad (4 data lines)
Flash voltage set by eFuse to 3.3V
Hard resetting via RTS pin...
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
- 内存 8MB(Embedded PSRAM)
- 闪存 32MB(flash size)
- WiFi,蓝牙,40MHz 屏幕
- USB 接口 USB-Serial/JTAG
导出出厂分区表为 factory_pt.bin(分区表的位置是固定的 0x8000 ~ 0x9000)
northboat@bogon esp-idf % esptool.py --chip esp32s3 -p /dev/cu.usbmodem1201 read_flash 0x8000 0x1000 factory_pt.bin
解析分区表 factory_pt.bin
northboat@bogon esp-idf % python3 ~/Workspace/esp/esp-idf/components/partition_table/gen_esp32part.py factory_pt.bin
Parsing binary partition input...
Verifying table...
# ESP-IDF Partition Table
# Name, Type, SubType, Offset, Size, Flags
nvsfactory,data,nvs,0x9000,200K,
nvs,data,nvs,0x3b000,840K,
otadata,data,ota,0x10d000,8K,
phy_init,data,phy,0x10f000,4K,
model,data,spiffs,0x110000,960K,
factory,app,factory,0x200000,6M,
storage,data,spiffs,0x800000,8M,
2
3
4
5
6
7
8
9
10
11
12
根据分区表位置及偏移量提取 factory app,并查看出厂 APP 信息
esptool.py --chip esp32s3 -p /dev/cu.usbmodem1201 \
read_flash 0x200000 0x600000 ~/Workspace/esp/factory_app.bin
# 查看二进制包
esptool.py image_info --version 2 ~/Workspace/esp/factory_app.bin
esptool.py v4.12.0
File size: 6291456 (bytes)
Detected image type: ESP32-S3
ESP32-S3 image header
=====================
Image version: 1
Entry point: 0x403797cc
Segments: 6
Flash size: 32MB
Flash freq: 80m
Flash mode: DIO
ESP32-S3 extended image header
==============================
WP pin: 0xee (disabled)
Flash pins drive settings: clk_drv: 0x0, q_drv: 0x0, d_drv: 0x0, cs0_drv: 0x0, hd_drv: 0x0, wp_drv: 0x0
Chip ID: 9 (ESP32-S3)
Minimal chip revision: v0.0, (legacy min_rev = 0)
Maximal chip revision: v0.99
Segments information
====================
Segment Length Load addr File offs Memory types
------- ------- ---------- ---------- ------------
0 0x377494 0x3c200020 0x00000018 DROM
1 0x07df0 0x3fca3c00 0x003774b4 BYTE_ACCESSIBLE, MEM_INTERNAL, DRAM
2 0x00d64 0x40378000 0x0037f2ac MEM_INTERNAL, IRAM
3 0x1fba0c 0x42000020 0x00380018 IROM
4 0x1ae38 0x40378d64 0x0057ba2c MEM_INTERNAL, IRAM
5 0x00020 0x50000000 0x0059686c RTC_DATA
ESP32-S3 image footer
=====================
Checksum: 0xae (valid)
Validation hash: 519457a1897f39f45ac914a563a99def7dd946d81660d386d3732ac49c85d546 (valid)
Application information
=======================
Project name: esp32-s3-touch-amoled-1-75c-bro
App version: v1.0.1-12-g198d6b9-dirty
Compile time: Aug 24 2026 10:16:28
ELF file SHA256: a81e55147f246fe640f8fa5a23f83067b9466038d32caed3839509662f1b5fb1
ESP-IDF: v5.5.5
Minimal eFuse block revision: 0.0
Maximal eFuse block revision: 1.99
MMU page size: 64 KB
Secure version: 0
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
备份出厂系统(16MB)
- 完整的存储容量由固件信息
Detected flash size: 32MB得知有 32MB - 为什么只备份 16MB?分区表里最后的一行
storage, data, spiffs, 0x800000, 8M,初始地址 8MB + 偏移量 8MB 的到出厂固件布局的使用上限(这套固件只设计了前 16MB)
esptool.py --chip esp32s3 -p /dev/cu.usbmodem1201 flash_id
esptool.py --chip esp32s3 -p /dev/cu.usbmodem1201 \
read_flash 0 0x1000000 ~/Workspace/esp/factory_backup_16m.bin
2
3
4
# FreeRTOS
ESP32-S3 的内核(几 KB),支持可抢占的任务和线程,单地址空间(读 cache 访问 flash),任务各有栈,通过主程序 void app_main(void) 载入
# 固件开发
# hello-world
新建工程
idf.py create-project hello
cd hello
idf.py set-target esp32s3
2
3
编译
idf.py build
- 产物在
build/下,bootloader.bin、partition-table.bin、hello.bin三个文件分别对应烧录地址 0x0、0x8000、0x10000
烧录
ls /dev/cu.*
idf.py -p /dev/cu.usbmodem1101 flash
2
看日志
idf.py -p /dev/cu.usbmodem1101 monitor
Ctrl+] 退出,原生 USB 下 Ctrl+T Ctrl+R 软复位。和烧录合成一条也是一样的
idf.py -p /dev/cu.usbmodem1101 flash monitor
如果只烧录现成的 bin,不装 IDF 也能烧,单独装 esptool 即可
brew install esptool
esptool.py --chip esp32s3 -p /dev/cu.usbmodem1101 -b 460800 \
write_flash 0x0 bootloader.bin 0x8000 partition-table.bin 0x10000 hello.bin
2
3
也可以先合并成单个文件再一把烧
esptool.py --chip esp32s3 merge_bin -o merged.bin \
--flash_mode dio --flash_size 8MB \
0x0 bootloader.bin 0x8000 partition-table.bin 0x10000 hello.bin
2
3
卸载 esp-idf
rm -rf ~/esp ~/.espressif
# xiaozhi-esp32
https://github.com/78/xiaozhi-esp32
# MotoNav
https://github.com/zyn950929/MotoNav