准备工作
这里以Windows系统为例,选定一个固定的目录作为SDK环境目录,因为后面要配置环境变量的呀,这里以E:\Environment\ESPIDF
目录为例,接下来配置的所有工具都以便携版为例(如果使用安装版直接安装就可用),如果读者计算机中已有相应工具并已配置到环境变量中则不需要进行相应步骤
下载所需工具
下载SDK
从ESP8266 RTOS SDK的发布页下载SDK包
下载的文件名是ESP8266_RTOS_SDK-v3.4.zip
解压到E:\Environment\ESPIDF\ESP8266_RTOS_SDK
目录
下载编译器
从乐鑫官网下载链接下载,如有更新可参照ESP8266 SDK的Github页的README.md自行下载
下载的文件名是xtensa-lx106-elf-gcc8_4_0-esp-2020r3-win32.zip
解压到E:\Environment\ESPIDF\Xtensa-lx106-elf
目录
下载Git
从Git for windows的发布页下载
这里选用MinGit-2.33.0.2-64-bit.zip
解压到E:\Environment\ESPIDF\Git
目录
下载Python3
从Python官网的Windows下载页下载
这里选用3.8.10的便携版python-3.8.10-embed-amd64.zip
解压到E:\Environment\ESPIDF\Python3
目录
下载CMake(可选)
CLion是内置CMake的,所以这里是可选安装,如果需要用其它编辑器或命令行编译则需要配置
从CMake的Github发布页下载
这里选用cmake-3.21.2-windows-x86_64.zip
解压到E:\Environment\ESPIDF\CMake
目录
下载Ninja
从Ninja的Github发布页下载
这里下载ninja-win.zip
解压到E:\Environment\ESPIDF\Ninja
目录
下载CCache
从CCache的Github发布页下载
这里下载的是ccache-4.4.1-windows-64.zip
解压到E:\Environment\ESPIDF\CCache
目录
下载MConf
从MConf的Github发布页下载
这里下载的是mconf-v4.6.0.0-idf-20190628-win32.zip
解压到E:\Environment\ESPIDF\IdfTools
目录
下载Idf.py包装器
从乐鑫官网下载链接下载
得到idf-exe-v1.0.1.zip
解压到E:\Environment\ESPIDF\IdfTools
目录
配置Python工具包
打开命令提示符,切换到E:\Environment\ESPIDF\python3
下,运行.\python -m pip install -r E:\Environment\ESPIDF\ESP8266_RTOS_SDK\requirements.txt
注:这同样适用于已安装的Python3环境
配置环境变量
注意:以下步骤配置的是全局环境,那么将面临两个问题
- 将会污染全局环境变量,进而可能影响到其它程序
- 可能会被现有的环境变量覆盖,编译时出现无法预计的问题
我们可以选择对IDE或单个项目设置专用的环境变量,示例是CLion开发ESP8266的详细配置过程,如果你只使用特定IDE进行开发那以下步骤就不需要做了
打开系统的环境变量编辑器,在Path
变量中加入以下条目(如果是Win7系统则每个条目后用分号;
间隔)
E:\Environment\ESPIDF\Xtensa-lx106-elf\bin
E:\Environment\ESPIDF\Git\cmd
E:\Environment\ESPIDF\CMake\bin
E:\Environment\ESPIDF\Python3
E:\Environment\ESPIDF\Ninja
E:\Environment\ESPIDF\CCache
E:\Environment\ESPIDF\IdfTools
新建IDF_PATH
变量并设置为E:\Environment\ESPIDF\ESP8266_RTOS_SDK
大功告成
到这里ESP8266的编译环境就配置完成了,可以在项目中使用命令行cmake -G Ninja && ninja
进行编译测试