H7-TOOL的ESP串口烧录小程序

MDLZCOOL

项目地址：MDLZCOOL/esp-serial-flasher-lua: H7-TOOL的ESP串口烧录小程序

https://github.com/MDLZCOOL/esp-serial-flasher-lua

H7-TOOL的ESP串口烧录小程序，当前支持ESP8266/ESP32/ESP32-S2/ESP32-S3/ESP32-C2/ESP32-C3/ESP32-C5/ESP32-C6/ESP32-C61/ESP32-H2/ESP32-P4。

特性

• ROM 模式：走芯片 ROM bootloader，没有加载stub，不过根据esp官方的说法，当主机上的闪存容量不是限制因素时，建议使用加载stub的方式，而非直接使用 ROM 引导加载程序进行连接。等后面再实现加载stub的方法，并且做一下对比。
• 支持芯片：ESP8266/ESP32/ESP32-S2/ESP32-S3/ESP32-C2/ESP32-C3/ESP32-C5/ESP32-C6/ESP32-C61/ESP32-H2/ESP32-P4，支持自动检测型号。
• 交互式UI界面：可以选择芯片型号，更改偏移量，执行烧录，查看进度和报错信息。
  
  

硬件接线

H7-TOOL	ESP 芯片	说明
TTLTX	ESP RX	交叉连接
TTLRX	ESP TX	交叉连接
D2	EN / RST	复位控制
D3	GPIO0 (BOOT)	下载模式选择
TVCC	VCC	供电，默认 3.3V

固件文件

默认从地址PATH读取三个固件，注意固件命名必须保持规范一致，默认是 0:/H7-TOOL/Lua/ESP ：

文件	默认偏移
bootloader.bin	0x0000
partition-table.bin	0x8000
firmware.bin	0x10000

• 可自行更改脚本中的PATH来更改固件默认地址。
• 可通过UI界面更改偏移量，可选的包括0x00000/0x01000/0x08000/0x0E000/0x10000/0x100000/0x200000/0x300000/0x400000。
  
  

部署到 H7-TOOL

• 把 esp_serial_flasher.lua 拷到 H7-TOOL 的 Lua 脚本目录，比如 0:/H7-TOOL/Lua/。
• 把固件 .bin 放到 PATH。
• 在 H7-TOOL 上运行该 Lua 脚本。
  
  

UI 操作

按键	作用
↑	上移光标
↓	下移光标
OK	执行动作/切换参数
C	长按退出程序
HOME	退出程序

故障排查

• SYNC 握手失败：检查 TX/RX 是否交叉、EN/BOOT 接线是否正确、波特率是否过高；可先降到 115200 再试。
• 读不到文件：确认路径正确，且 H7-TOOL 未处于 U 盘挂载模式。
• 芯片错误：确认菜单所选型号与实际硬件一致，或改回 Auto 让它自动识别。
  
  

参考

• Espressif esp-serial-flasher
• 《H7-TOOL Lua 脚本 API 手册 V1.2》
  
  

eric2013

谢谢分享

312456990

我猪脑学不会， 能不能讲一下 如何操作

eric2013

312456990 发表于 2026-7-29 10:05
我猪脑学不会， 能不能讲一下 如何操作

部署到 H7-TOOL
把 esp_serial_flasher.lua 拷到 H7-TOOL 的 Lua 脚本目录，比如 0:/H7-TOOL/Lua/。
把固件 .bin 放到 PATH。
在 H7-TOOL 上运行该 Lua 脚本。

312456990

可以用来烧录  MicroPython的固件吗？ ESP32有MicroPython的开发方式

eric2013

312456990 发表于 2026-7-29 10:17
可以用来烧录  MicroPython的固件吗？ ESP32有MicroPython的开发方式

不限制固件内容，只要是固件都可以。

Vxworks

谢谢楼主分享

Amosi

谢谢楼主分享

Amosi

eric2013 发表于 2026-7-29 10:45
不限制固件内容，只要是固件都可以。

是否有个git仓库，收集常用的lua小程序

Amosi

H7 tools做什么修改可以显示中文？执行lua程序，屏幕上中文乱码

Amosi

Amosi 发表于 2026-8-20 14:57
H7 tools做什么修改可以显示中文？执行lua程序，屏幕上中文乱码

通过PC软件 lua执行会出现乱码，copy到emmc 后在调试器执行就显示中文正常

eric2013

Amosi 发表于 2026-8-20 15:05
通过PC软件 lua执行会出现乱码，copy到emmc 后在调试器执行就显示中文正常

上位机改成UTF-8编码了，简单省事些，打开LUA文件后，复制粘贴进来就行了

Amosi

eric2013 发表于 2026-8-20 15:57
上位机改成UTF-8编码了，简单省事些，打开LUA文件后，复制粘贴进来就行了

出现乱码原因是我在github 网页点击copy raw file复制到tool 文件内容目录后就错误了，相关于执行的lua脚本中文内容就是乱码

eric2013

Amosi 发表于 2026-8-21 10:40
出现乱码原因是我在github 网页点击copy raw file复制到tool 文件内容目录后就错误了，相关于执行的lua脚 ...

好的，下载下来后复制就没问题了。