简单背景
我之前的文章都是推荐使用项目组提供的云服务来编译固件。好处是,简单方便,只需要在网页上选择自己需要的模块就可以了。云服务编译好之后会把固件发送到邮箱。
不过,并不是只能通过云服务获取固件。完全可以通过源码自己编译固件,动手能力强的,可以自己搭建编译环境。神奇的是,乐鑫并没有给出友好的文档说如何搭建。我之前尝试通过alios提供的esp编译环境来搭建nodemcu的编译环境,比较麻烦,各种路径报错。所以,只能通过其他大牛提供的方案。
docker
本文要介绍的是使用marcelstoer提供的Docker镜像,镜像提供了所有需要的编译工具。
这里不介绍如何安装docker,具体方法自行网上搜索。或者看docker官方文档。需要注意的是,docker不支持Windows10家庭版,我曾经在Windows10家庭版上使用docker toolbox来编译固件。不过,我还是推荐使用Linux虚拟机来弄docker,当然mac也可以。
通过docker pull marcelstoer/nodemcu-build
获取docker镜像。
获取固件源码
通过git clone --recurse-submodules https://github.com/nodemcu/nodemcu-firmware.git
克隆远程仓库源码到本地备用。
开始修改固件
在修改固件前,强烈推荐vs code作为编辑器。打开后,vs code监测到c或者c++的文件会提示安装C/C++扩展插件。该插件会自动安装一些工具。安装完成后,vs code支持define高亮显示。
当然缺少配置的情况下,vs code会提示配置c++,主要是include路径之类的。如果只是想编译固件,不打算自己写C模块的话,可以忽略提示。
选择模块
nodemcu的代码主要集中在app文件夹里面,由于只要修改模块,直接到app/include/user_modules.h
调整宏定义就可以了。把不要的模块屏蔽了,把需要的模块打开。但是,需要注意有些模块依赖其他模块一起使用。比如,u8g2这种模块,需要spi或者iic来驱动液晶。
其他配置项
通过app/include/user_config.h
可以配置波特率、flash大小、浮点支持(默认)。还有其他一些配置项。如果你对固件模块比较了解的话,应该可以比较快的看懂这个文件。更多关于固件配置的看这里。
配置tasks
为了避免重复执行docker命令的烦恼。可以配置个tasks(只针对vs code)。具体的做法是,在.vscode文件夹下面新建一个tasks.json文件,把下面的代码复制过去就可以了。
{
// See https://go.microsoft.com/fwlink/?LinkId=733558
// for the documentation about the tasks.json format
"version": "2.0.0",
"tasks": [
{
"label": "build",
"type": "shell",
"command": "docker",
"args": [
"run",
"--rm",
"-it",
"-v",
"`pwd`:/opt/nodemcu-firmware",
"marcelstoer/nodemcu-build",
"build"
],
"group": {
"kind": "build",
"isDefault": true,
}
}
]
}
要编译的时候,使用快捷键CTRL+shift+B就可以编译了。编译过程很快,比起云服务快很多了。