ESP32，使用gitee搭建 ESP-IDF 开发框架

深藏阁楼爱情的钟 2022-08-31 11:11 428阅读 0赞

ESP32便宜，开发方便，非常适合初学者用来学习，之前我自己写的开发环境可能不再适合，推荐下面这篇文章。

*=====*

关于如何搭建ESP32的开发环境，乐鑫官方给出了很详细的教程和文档，基本上跟着官方教程来操作，都可以顺利把ESP-IDF的开发环境搭建好，并且运行一个helloworld程序。

乐鑫官方提供的ESP-IDF框架搭建文档，参考以下链接：

https://docs.espressif.com/projects/esp-idf/zh\_CN/latest/esp32/get-started/index.html

网上也有很多关于ESP32开发环境搭建的文章，我个人觉得写得比较好的是以下这两篇，文章已经包括了windows和Linux下的开发环境搭建。

https://blog.csdn.net/qq\_36347513/article/details/115619605

https://hellobug.blog.csdn.net/article/details/108405073

乐鑫官方提供的文档，以及网上大部分ESP32环境搭建的文章，在搭建开发环境获取源码的时候，由于使用了国外知名的程序员交友平台github，往往会导致源码获取中断或失败，github访问失败是一些特别的原因导致的。

正因为这样，很多开发者在搭建开发环境上浪费了很多时间，甚至还没开始就想放弃。为了解决国内开发者从github上获取ESP相关仓库缓慢的问题，乐鑫提供了在gitee上获取ESP-IDF源码的方法。

在windows上搭建ESP-IDF开发环境的时候，可以使用乐鑫提供的ESP-IDF工具安装器，指定优先选择Espressif的下载服务器，上面提供的博客文章，已经有提及，本文主要是使用Linux命令行的方式搭建开发环境。

为什么使用Linux命令行搭建开发环境，主要是因为自由度高，虽然操作略复杂，但乐鑫官方很多资料和文档，都是基于Linux或windows命令行的方式开发的，因此，建议开发者学习一下如何使用命令行搭建ESP32的开发环境。

阅读本文需要有一定的Linux或windows命令行操作基础，需要掌握一定的git命令使用，以及具备一些脚本使用的基础知识。ESP32的开发环境搭建，均使用了git命令，Linux命令行，以及可执行脚本。

**建议先阅读 ESP-IDF 编程指南快速入门 的相关章节，对开发环境搭建有一个基本的了解，并且已经完成第一步的安装准备工作，再执行本文的相关操作。**

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

1、执行以下命令，在/opt目录下创建esp32文件夹，并修改文件夹的权限为可读可写，命令如下图所示。

cd /opt/

mkdir esp32

chmod 666 esp32/

ls -al

![2f89ac18cb1a3e3fced67389d2b3a7a1.png][]

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

cd esp32/

git clone https://gitee.com/EspressifSystems/esp-gitee-tools.git

git clone https://gitee.com/EspressifSystems/esp-idf.git

![df9600f93c2d5ad377662b4094ac7161.png][]

3、在esp-gitee-tools工具包里面，提供了一个submodule-update.sh脚本，用来更新ESP-IDF框架的子模块，这个脚本主要是使用了gitee作为镜像源，更新ESP-IDF框架必要的子模块，避免了在github下载缓慢或出错的情况。

cd esp-gitee-tools/

export EGT\_PATH=$(pwd)

cd ../esp-idf/

$EGT\_PATH/submodule-update.sh

![393969ee7453e23352247bd10ef801bf.png][]

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

![9e432bf2bc02185715e266e721ae2fea.png][]

4、下载完ESP-IDF源码后，还需要下载和设置ESP相关的工具，比如编译器，调试器，Python包，等等。由于github下载缓慢，可以优先选用乐鑫的下载服务器进行github资源下载。

export IDF\_GITHUB\_ASSETS="dl.espressif.com/github\_assets"

./install.sh

![00ceaa2d321284910b03d333262060ef.png][]

编译器、调试器和Python包这些工具，默认下载在/root/.espressif目录下，也可以通过修改环境变量来改变这个下载目录，但为了方便起见，不建议修改，如下图所示。

![6fa8356a0e74941fbf0ff80e7d25f2a9.png][]

下载完成后，如下图所示。

![228918ebf7e8e4581b33d42ca1efd574.png][]

5、工具包下载完成后，还需要设置环境变量，让操作终端知道当前的工具包位置，根据下载完成的提示，需要在esp-idf目录下，执行export.sh脚本，来完成环境变量的配置，如下图所示。

. ./export.sh

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

![beb725cc9fd51cc096bf98d8cf80ba4e.png][]

为了方便在任何终端使用配置好的环境变量，不用每次重新打开终端窗口都敲一堆指令去，可以为该脚本创建一个别名，在/root/.bashrc添加以下指令，重启终端后，就可以用get\_idf指令来刷新环境变量了。

alias get\_idf='. /opt/esp32/esp-idf/export.sh'

![91577a6e3fc16e0dd03951ecc6457d65.png][]

6、在ESP-IDF的目录下面，examples文件夹包含了一系列例程，我们可以使用examples文件夹里面的 get-started/helloworld工程，来验证开发环境是否搭建成功。复制helloworld工程到esp32目录，复制完成后，如下图所示。

cp examples/get-started/hello\_world/ ../ -a

![727195e59b8380963ea44612d60349dc.png][]

7、进入helloworld工程目录，设置目标芯片，使用menuconfig配置工程，对于helloworld示例，由于我使用的ESP32芯片是ESP32-S0WD，这是一款单核芯片，需要把ESP32芯片配置为单核模式，工程配置窗口如下图所示。

cd /opt/esp32/hello\_world

idf.py set-target esp32

idf.py menuconfig

![82a37e9629f4beeb3af07e0477070df6.png][]

8、执行idf.py build构建和编译工程，这个命令可以编译helloworld应用程序和ESP-IDF所有组件，并且会生成bootloader、分区表和应用程序的二进制文件，编译成功后，如下图所示。

idf.py build

![8680f940ba201f3ebb0afb3ac325a5d7.png][]

9、编译完成后，可以使用以下命令，将刚刚生成的二进制文件，烧录到开发板上，/dev/ttyUSB0是开发板在ubuntu18.04的串口端口号，需要根据实际情况进行设置，软件烧录成功后，可以在终端窗口观察到程序运行，打印输出helloworld。

idf.py -p /dev/ttyUSB0 flash monitor

![0f462bfdf00aeec2d8eca98136ca93f6.png][]

10、至此，ESP-IDF开发环境已经搭建完成，在Linux环境下，可以使用vscode作为代码编辑工具，关于vscode的配置，网上已经有不少文章可以参考，这里不再重复描述。

![08ff9c58e1e7d0cedf10bf6a4e8fd514.png][]

\-- END --

*转自，如果有这方面开发要求，可以关注下面公众号，说是发哥朋友*

![b5e110a4489f9e1f39c883fc86223489.png][]

--------------------

**推荐阅读：**

[专辑|Linux文章汇总][Linux]

[专辑|程序人生][Link 1]

[专辑|C语言][C]

[我的知识小密圈][Link 2]

关注公众号，后台回复「**1024**」获取学习资料网盘链接。

**欢迎点赞，关注，转发，在看，您的每一次鼓励，我都将铭记于心~**

![41da8816abc548cc454acb1320a58fd8.png][]

嵌入式Linux

微信扫描二维码，关注我的公众号

[2f89ac18cb1a3e3fced67389d2b3a7a1.png]: /images/20220829/67f49a6969fb47c8b5f7f1e973fb7ca1.png
[df9600f93c2d5ad377662b4094ac7161.png]: /images/20220829/ad399fa1445a46fa908c35322bc935e6.png
[393969ee7453e23352247bd10ef801bf.png]: /images/20220829/d60c0d49280840338b7a650edb9f6dce.png
[9e432bf2bc02185715e266e721ae2fea.png]: /images/20220829/4d7fc768b54b4198be0324f48449637a.png
[00ceaa2d321284910b03d333262060ef.png]: /images/20220829/662a1fdb85e9492f9baa08de64dafa98.png
[6fa8356a0e74941fbf0ff80e7d25f2a9.png]: /images/20220829/4e2ee69d9a9143ae83f438ecde16bc21.png
[228918ebf7e8e4581b33d42ca1efd574.png]: /images/20220829/4bfd260c0e404a569b7cf27b6373d78d.png
[beb725cc9fd51cc096bf98d8cf80ba4e.png]: /images/20220829/8474eec941074094b62cfbdd65a7ce21.png
[91577a6e3fc16e0dd03951ecc6457d65.png]: /images/20220829/385f989b2d9b409980d63e7afd332873.png
[727195e59b8380963ea44612d60349dc.png]: /images/20220829/88d80e46157c44aca37629b6e18eadfa.png
[82a37e9629f4beeb3af07e0477070df6.png]: /images/20220829/69b3ca580dca4e4ba72deda1e70ac827.png
[8680f940ba201f3ebb0afb3ac325a5d7.png]: /images/20220829/3726cb5802d0401b841688bc09ad23d1.png
[0f462bfdf00aeec2d8eca98136ca93f6.png]: /images/20220829/c4523342ee454900bc0e126db0535bf4.png
[08ff9c58e1e7d0cedf10bf6a4e8fd514.png]: /images/20220829/84def4309aed432abe9338a3bc43723f.png
[b5e110a4489f9e1f39c883fc86223489.png]: /images/20220829/2db6bf74d0ca475281c1eed15873fb85.png
[Linux]: https://mp.weixin.qq.com/mp/appmsgalbum?__biz=MzA5NTM3MjIxMw%3D%3D&action=getalbum&album_id=1319528681890709506#wechat_redirect
[Link 1]: https://mp.weixin.qq.com/mp/appmsgalbum?__biz=MzA5NTM3MjIxMw%3D%3D&action=getalbum&album_id=1351786687592202240#wechat_redirect
[C]: https://mp.weixin.qq.com/mp/appmsgalbum?__biz=MzA5NTM3MjIxMw%3D%3D&action=getalbum&album_id=1377857816341577728#wechat_redirect
[Link 2]: http://mp.weixin.qq.com/s?__biz=MzA5NTM3MjIxMw%3D%3D&chksm=9042f716a7357e003fc6c87cfacb76508df6c06e14fb9f01c54aca3801f456b9ff5b6ce71ef3&idx=2&mid=2247492044&scene=21&sn=695b9297a39bf2d5a4548a161892d182#wechat_redirect
[41da8816abc548cc454acb1320a58fd8.png]: /images/20220829/0f31c62c046b4bcfadcc28bf4edbd9a8.png