ESP32学习笔记 -- 使用gitee搭建 ESP-MDF 开发框架

Posted 2021-08-16 工程师进阶笔记

上一篇文章讲述了如何使用gitee搭建ESP-IDF开发框架，上一篇文章的具体内容，请查看以下链接。

ESP32学习笔记 -- （1）使用gitee搭建 ESP-IDF 开发框架

除了ESP-IDF开发框架，乐鑫还提供了针对WIFI组建MESH网络的开发框架，ESP-MDF。这个框架是基于ESP-IDF封装的ESP-WIFI-MESH开发架构。

有关ESP-WIFI-MESH的介绍和快速入门，可以查看官方提供的文档内容：

ESP-WIFI-MESH相关概念介绍

ESP-MDF 快速入门文档

由于ESP-MDF是基于ESP-IDF作了进一步的封装，因此，ESP-MDF的开发环境搭建基本与ESP-IDF相同，但官方提供的资料都是基于github来进行搭建的，如果不能顺利访问github，在搭建过程中会出现下载缓慢或中断。

这里提供一种使用gitee搭建ESP-MDF开发框架的方法，建议在搭建ESP-MDF开发框架之前，首先进行一次ESP-IDF开发框架的搭建。

本文使用的操作系统是ubuntu18.04，操作目录是/opt/esp32，使用root用户进行操作，如果没有特别说明，操作路径均是相对路径，在执行命令的时候，重点注意命令的执行路径是相对路径还是绝对路径。

1、进入esp32目录，在该目录下执行git clone 命令，获取ESP-MDF在gitee上托管的源码，注意，这次的git clone仅仅是获取ESP-MDF的源码，还没有包含ESP-IDF以及其子模块，ESP-MDF的源码需要结合ESP-IDF及其子模块才能使用，子模块在后面的步骤进行获取。

cd /opt/esp32/
git clone https://gitee.com/EspressifSystems/esp-mdf.git

 2、在gitee网站上，查看当前的ESP-MDF源码版本，发现源码包里面需要使用esp-idf这个子模块，这个子模块对应的版本分支是e9cf9e2，如下图所示。

 3、删除esp-mdf目录里面的esp-idf这个文件夹，然后在esp-mdf目录里面执行git clone命令，把对应版本的esp-idf克隆到esp-mdf目录，命令如下图所示。

rm -rf esp-idf/
git clone -b release/v4.3 https://gitee.com/EspressifSystems/esp-idf
cd esp-idf/
git checkout e9cf9e297

 4、在上一篇文章中，我们曾经使用过esp-gitee-tools去更新esp-idf的子模块，在本篇文章中，更新esp-mdf/esp-idf这个目录里面的子模块，也是使用同样的方法。根据上一篇文章的内容，先设置好esp-gitee-tools这个目录的EGT_PATH环境变量，然后在esp-mdf/esp-idf目录下，执行submodule-update.sh脚本。

cd /opt/esp32/esp-gitee-tools/
export EGT_PATH=$(pwd)
cd ../esp-mdf/esp-idf
$EGT_PATH/submodule-update.sh

 耐心等待一段时间后，如果网络没有问题的话，子模块一般都会更新完成，至此，整个ESP-IDF的源码及子模块已经下载完毕，如下图所示。

 5、进入esp-mdf/esp-idf目录，执行install.sh脚本，安装esp-idf环境，这些步骤跟上一篇文章是完全一样的，如下图所示。

export IDF_GITHUB_ASSETS="dl.espressif.com/github_assets"
./install.sh

 6、在esp-mdf/esp-idf目录下，执行export.sh脚本，来完成环境变量的配置，如下图所示。

. ./export.sh
（注意，命令开始的“.”与export.sh脚本之间，有一个空格）

7、为了后面能顺利编译源码，需要先设置MDF_PATH环境变量，让编译器知道esp-mdf源码的所在目录，设置命令如下图所示。

export MDF_PATH=/opt/esp32/esp-mdf

8、完成上面的配置后，就可以开始编译esp-mdf/examples/get-started目录下的示例程序了，如下图所示。

cd /opt/esp32/esd-mdf/examples/get-started
idf.py build

 编译的时候，有可能会出现需要下载Adafruit-GFX-Library这个库，并且下载网站是指向了github，有可能会出现下载缓慢或中断。

解决方法就是，先在自己的gitee账户里面，同步github上面的Adafruit-GFX-Library仓库，然后把esp-mdf/目录下的.gitmodules文件，修改为指向自己gitee的Adafruit-GFX-Library仓库，如下图所示。

9、最后，再在esp-mdf/examples/get-started目录下执行idf.py build命令，可以看见示例程序配置成功，并且可以顺利编译通过，可以下载到开发板运行了。至此，ESP-MDF的开发环境搭建完成。