由于访问 Github 的速度较慢,在此记录通过 gitee 国内码云镜像下载配置 ESP-MDF 库的流程。
1 克隆 ESP-MDF
打开 CMD 指定窗口,输入以下指令来克隆 Gitee 上的 ESP-MDF,如下:
git clone https://gitee.com/EspressifSystems/esp-mdf
注:如能顺利访问 github(如不行,直接跳过此注释),可直接通过
git submodule update --init --recursive
下载 submodule 库,对应步骤请参考 这里。
2 克隆 ESP-IDF
此时要下载 ESP-MDF 下的指定 ESP-IDF 库。可以在 ESP-MDF 下的 ESP-IDF 看到对应的 commit,然后需要下载对应版本的 ESP-IDF ,如下:
git clone -b release/v4.3 https://gitee.com/EspressifSystems/esp-idf
cd esp-idf/
git checkout e9cf9e297
git pull
然后步骤要按照 esp-gitee-tools 工具步骤去操作,详细请看链接:submodule-update 使用
3 环境搭建
由于 windows 下不支持运行 .sh 脚本,因此需要提前安装好 git 以及 python 环境,然后进入 git bash 命令里面操作。首先在 windows 桌面点击右键,然后点击 Git Bash Here
,打开 GIt Bash 界面。如下:
此时通过 esp-gitee-tools 安装 ESP-IDF 对应的 submodule,如下:
上述操作完成后,将此完整的 ESP-IDF 复制到 ESP-MDF 仓库下面来替换原 ESP-MDF 下的 ESP-IDF。
此时运行 cmd
进入 windows 的控制界面, 然后进入到 ESP-MDF 目录下的 ESP-IDF 进行环境搭建。如下:
install.bat
export.bat
运行完成后将会 cmd 界面看到 idf.py build
的打印。此时需要设置 MDF_PATH 路径,如下:
set MDF_PATH=E:\espressif\esp-mdf\
如果不设置 MDF_PATH 环境路径将会无法编译通过,会出现如下图所示的错误:
成功设置 MDF_PATH 环境路径后就可以开始编译 ESP-MDF 下的 example 了。如下:
成功的 log 如下图所示:
同时也可以通过如下指令直接编译烧写,对应的命令如下:
idf.py -p COM -b 921600 flash monitor