基本信息
用法: esptool.py [选项] 命令 [参数]...
esptool.py v4.8.1 - 用于对乐鑫系统级芯片进行闪存编程、配置和交互的串口工具。
选项参数表
| 选项 |
简写 |
参数类型 |
描述 |
--chip |
-c |
[auto|esp8266|esp32|esp32s2|esp32s3|esp32c3|esp32c2|esp32c6|esp32c61|esp32c5|esp32h2|esp32h21|esp32p4|esp32h4] |
目标芯片类型 |
--port |
-p |
TEXT |
串口设备 |
--baud |
-b |
INTEGER |
编程/读取时使用的串口波特率 |
--port-filter |
|
[TEXT] |
串口设备过滤器，格式可为 vid=NUMBER, pid=NUMBER, name=子字符串, serial=子字符串 |
--before |
|
[default-reset|usb-reset|no-reset|no-reset-n-o-sync] |
连接芯片前执行的复位方式 |
--after |
-a |
[hard-reset|soft-reset|no-reset|no-reset-stub|watchdog-reset] |
操作完成后执行的复位方式 |
--no-stub |
|
|
禁用启动编程器stub，仅与ROM引导加载程序通信（某些功能将不可用） |
--trace |
-t |
|
启用esptool.py交互的跟踪级输出 |
--override-vddsdio |
|
[1.8V|1.9V|OFF] |
覆盖ESP32 VDDSDIO内部电压调节器（慎用） |
--connect-attempts |
|
INTEGER |
连接尝试次数（负值或0表示无限尝试，默认值：7） |
--help |
-h |
|
显示此帮助信息并退出 |
基本命令表
| 命令 |
功能描述 |
write-flash |
将二进制文件写入闪存（格式：地址 文件名，用空格分隔） |
read-flash |
读取SPI闪存内容 |
erase-flash |
擦除SPI闪存 |
erase-region |
擦除SPI闪存的特定区域 |
read-mac |
打印设备MAC地址 |
flash-id |
打印SPI闪存制造商和设备ID |
elf2image |
从ELF文件创建应用程序镜像 |
image-info |
打印固件镜像（引导加载程序或应用程序）信息 |
merge-bin |
将多个原始二进制文件合并为单个可闪存文件 |
version |
打印esptool版本 |
高级命令表
| 命令 |
功能描述 |
verify-flash |
验证二进制文件与闪存内容是否一致 |
load-ram |
下载镜像到RAM并执行 |
dump-mem |
将任意内存区域导出到文件 |
read-mem |
读取任意内存地址 |
write-mem |
修改或写入任意内存地址 |
read-flash-status |
读取SPI闪存状态寄存器 |
write-flash-status |
写入SPI闪存状态寄存器 |
read-flash-sfdp |
读取SPI闪存SFDP（串行闪存可发现参数） |
get-security-info |
打印安全信息报告 |
chip-id |
打印设备芯片ID |
run |
运行闪存中加载的应用程序代码 |
python esptool.py --port COM7 chip-id
esptool.py v4.8.1
Serial port COM7:
Connecting....
Detecting chip type... ESP8266
Connected to ESP8266 on COM7:
Chip type: ESP8266EX
Features: Wi-Fi, 160MHz
Crystal frequency: 26MHz
MAC: 5c:cf:7f:87:3e:78
Uploading stub flasher...
Running stub flasher...
Stub flasher running.
Chip ID: 0x00873e78
Hard resetting via RTS pin...