-
如何制作 NodeMCU ESP32 自定义固件
- 网站名称:如何制作 NodeMCU ESP32 自定义固件
- 网站分类:技术文章
- 收录时间:2025-07-10 14:50
- 网站地址:
“如何制作 NodeMCU ESP32 自定义固件” 网站介绍
最近尝试在 Mac 下制作 nodemcu ESP32 的自定义固件。
本文就来介绍 nodemcu ESP32 自定义固件的编译、烧写、测试的全部过程。
准备固件源码包
从 nodemcu-firmware 官方仓库 下载最新代码,切换到 dev-esp32 分支,更新子模块(submodule):
git clone https://github.com/nodemcu/nodemcu-firmware.git
git checkout dev-esp32
git submodule update --recursive
注意,dev-esp32 分支才是适用于 ESP32 的代码,一定要切换过来仓库的子模块非常多,下载比较慢,要耐心等待
准备构建工具
官方目前提供了 3 种构建工具:云构建、docker 构建和 Linux 本地工具链构建。
目前 esp32 的云构建勾选 u8g2 选项会报错,而安装本地工具链又比较麻烦,所以这里选用 docker 构建方式。
这里一次性把所有依赖工具都装好,后面的步骤就可以直接用了:
- 下载 docker 镜像:docker pull marcelstoer/nodemcu-build
- 下载固件烧写工具:pip install esptool
- 下载命令行串口工具:brew install minicom
官方步骤参考
https://hub.docker.com/r/marcelstoer/nodemcu-build/#build-for-esp32
生成构建配置
熟悉 make 的人应该知道,大项目源码构建一般会有 make menuconfig 和 make 两个阶段。第一个阶段生成配置文件,第二个阶段执行编译。nodemcu 固件构建也是两段式的:先生成配置文件,再执行编译。
确保自己在固件源码包的一级目录内,执行:
docker run --rm -ti -v `pwd`:/opt/nodemcu-firmware marcelstoer/nodemcu-build
configure-esp32
意思是把当前目录的内容挂载到 docker 容器的 /opt/nodemcu-firmware 目录,并进入容器内的交互命令行,执行 configure-esp32 指令。
执行完后,就可以进入到 menu-config 配置界面。按自己的需求勾选选项即可。
如果不知道 docker 参数的作用,参考:Docker 容器使用 | 菜鸟教程
开始构建
保持终端在 docker 容器内,执行:
build-esp32
这时候会进入超长的编译过程,要耐心等待。编译完成后,可以看到终端打印的提示文案:
但是这个烧写提示指示的文件路径是 docker 容器内的,要适当修改后在容器外执行。
烧写固件
回到宿主机环境(退出 docker 容器),确保自己在固件源码包的一级目录内,然后按照 docker 内的烧写提示执行:
esptool.py --chip esp32 --port /dev/cu.usbserial-0001 --baud 115200 --before default_reset --after hard_reset write_flash -z --flash_mode dio --flash_freq 40m --flash_size detect 0x1000 build/bootloader/bootloader.bin 0x10000 build/NodeMCU.bin 0x8000 build/partitions.bin
一共要写入 3 段二进制文件:
- build/bootloader/bootloader.bin:启动引导程序镜像
- build/NodeMCU.bin:系统镜像
- build/partitions.bin:分区镜像
注意区别仅在于 bin 文件路径,例如
/opt/nodemcu-firmware/build/bootloader/bootloader.bin 变为
build/bootloader/bootloader.binMac 下,usb2serial 驱动模拟的串口设备路径一般是 /dev/cu.*,ls 一下很容易找到
烧写成功后可以看到提示:
开机测试
esptool 脚本执行烧录结束后,会自动重启 nodemcu。现在来验证下刚刚的固件能否正常运行。
这里用 minicom 打开串口:
minicom -D /dev/cu.usbserial-0001
如果能看到 nodemcu 回传的系统信息以及 lua 交互命令行,则表示固件制作成功了:
采坑点
ImportError: No module named setuptools
docker 内执行的时候有可能出现 ImportError: No module named setuptools 错误:
解决:Bullding for ESP32 fails: setuptools missing · Issue #86 · marcelstoer/docker-nodemcu-build
更多相关网站
- 详解USB系统基本架构,看它是如何与计算机连接的
- 科普:USB有A口和C口,那有没有B口?
- WinForm 中玩转串口通信:从基础到实战
- ThinkSystem DS系列存储iSCSI端口连接Windows主机基本配置
- 新打印机怎么连接电脑?(爱普生打印机怎么和电脑连接)
- SEW变频器 MDX61B 开环驱动 DR 电机初始化步骤
- 将USB设备使用情况看个清楚(usb使用记录能彻底删除吗)
- 软网推荐:检验硬盘健康状况与性能
- iOS 开发面试通关指南:67 个必知问题
- 三菱编程软件GX WORKS2的安装和调试
- 细节不容忽视 你不知道的接口那些事儿
- 三菱 Works2 编程太难?不存在的!零基础也能啃懂的保姆级教程,
- 电脑硬盘序列号,怎么查看?3种方法整理如下
- 还搞不懂步进电机?一定要看这一文,工作原理+驱动方法,秒懂
- 趣闻:usb的图标设计成这个样子到底有什么特殊的含义?
- 16 种计算机端口及其功能(计算机系统常用的端口和对应服务)
- 10个实用小命令,轻松查出你电脑的真实信息
- 如何在Linux下给zigbee CC2530实现上位机
- 最近发表
- 标签列表
-
- mydisktest_v298 (35)
- sql 日期比较 (33)
- document.appendchild (35)
- 头像打包下载 (35)
- 二调符号库 (23)
- acmecadconverter_8.52绿色版 (25)
- f12019破解 (16)
- 流星蝴蝶剑修改器 (18)
- np++ (17)
- 梦幻诛仙表情包 (36)
- 魔兽模型 (23)
- java面试宝典2019pdf (26)
- beamoff下载 (17)
- disk++ (30)
- vncviewer破解版 (20)
- word文档批量处理大师破解版 (19)
- pk10牛牛 (20)
- 加密与解密第四版pdf (29)
- iteye (26)
- parsevideo (22)
- ckeditor4中文文档 (20)
- centos7.4下载 (32)
- cuda10.1下载 (22)
- intouch2014r2sp1永久授权 (33)
- usb2.0-serial驱动下载 (24)