本文章 来自原创专栏《ESP32教学专栏 (基于ESP-IDF)》,讲解如何使用 ESP-IDF 构建 ESP32 程序,发布文章并会持续为已发布文章添加新内容! 每篇文章都经过了精打细磨!
↓↓↓通过下方对话框进入专栏目录页↓↓↓
CSDN 请求进入目录 _ O x
是否进入ESP32教学导航(基于ESP-IDF)?
确定
ESP-IDF 是由乐鑫Espressif官方提供的一套ESP32系列SoC的物联网开发套件(Espressif IoT Development Framework)提供了从工程创建,编译,烧录,调试,量产等的完整解决方案。本文将介绍如何在Windows下搭建ESP-IDF开发环境。
敬告:
① 如果你想使用Arduino来开发ESP32,目前可参考的资料较多,请读者自行查阅。
② 使用Arduino开发ESP32,很难发挥ESP32的全部实力,强烈推荐相关专业人士或技术爱好者转为 ESP-IDF 开发。
③ ESP-IDF是乐鑫官方推荐的SDK。
注意:
下文的 “开发环境” 和 “编程环境” 的含义并非相同
编程环境:指代码编写的人机交互环境,例如使Clion IDE或者VS Code等工具对开发环境的耦合和优化。
开发环境:指ESP-IDF工程的建立,配置,编译,调试,量产等基础操作的环境。开发环境不包含编程环境
在文章开始之前,先感受一下Clion带来的流畅丝滑的变成体验吧!
① 丝滑头文件
② 丝滑结构体
③ 丝滑提示
文章目录
(一)开发环境搭建
一、安装相关依赖
ESP-IDF 及其工具等需要依赖以下组件
- 如果你的操作系统是
Debian
系(如Debian
、Ubuntu
、Deepin
、Raspberry Pi OS
等)
sudo apt-get install git wget flex bison gperf python3 python3-pip python3-setuptools cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0
- 如果你的操作系统是
CentOS 7 & 8
(目前仍然支持CentOS 7
,但是强烈建议使用CentOS 8
)
sudo yum -y update && sudo yum install git wget flex bison gperf python3 python3-pip python3-setuptools cmake ninja-build ccache dfu-util libusbx
- 如果你的操作系统是
Arch
系(如Arch Linux
、Manjaro
等)
sudo pacman -S --needed gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util libusb
使用 ESP-IDF 需要
CMake 3.5
或以上版本。较早的 Linux 发行版可能需要升级自身的软件源仓库,或开启backports
套件库,或安装 “cmake3
” 软件包(不是安装 “cmake
”)。
如果上述列表中,并没有您使用的系统,请参考您所用系统的相关文档,查看安装软件包所用的命令。
二、获取ESP-IDF
1. 方法一(推荐):从以下链接下载开箱即用的ESP-IDF
由于国内访问Github较慢,官方给我们提供了一个开箱即用的ESP-IDF。前往ESP-IDF的Github或Gitee发行版本页面即可找到(下文已给出)
ESP-IDF v4.4直接下载:https://dl.espressif.com/github_assets/espressif/esp-idf/releases/download/v4.4/esp-idf-v4.4.zip
ESP-IDF v4.3.2直接下载:https://dl.espressif.com/github_assets/espressif/esp-idf/releases/download/v4.3.2/esp-idf-v4.3.2.zip
下载后解压到合适的位置即可
如果你想要获取其他版本,请从ESP-IDF官方github或者gitee查看最新发行版,并使用提供的对应版本的命令行
Github 发行版页 :https://github.com/espressif/esp-idf/tags
Gitee 发行版页:https://gitee.com/EspressifSystems/esp-idf/releases
2. 方法二:从github克隆ESP-IDF仓库的发行版
进入你想放置ESP-IDF文件夹的目录。然后执行以下命令获取esp-idf(git会自动创建esp-idf文件夹)
默认情况下,建议安装到~/esp/
下
mkdir -p ~/esp
cd ~/esp
① 例如,获取4.3.2版本发行版。(在此文章发布时,此为最新的稳定版,可能将来会成为旧版)
git clone -b v4.3.2 --recursive https://github.com/espressif/esp-idf.git esp-idf-v4.3.2
git会自动创建esp-idf-v4.3.2文件夹
② 再如,获取master分支(通常不是发行版,也可能不是稳定版,如果你并不确定自己要使用哪个版本,而是仅仅是想要入门ESP32开发,建议使用此命令克隆master分支)
git clone --recursive https://github.com/espressif/esp-idf.git
git会自动创建esp-idf文件夹
如果你想要获取其他版本,请从ESP-IDF官方github或者gitee查看最新发行版,并使用提供的对应版本的命令行
Github 发行版页 :https://github.com/espressif/esp-idf/tags
Gitee 发行版页:https://gitee.com/EspressifSystems/esp-idf/releases
三、安装所需工具
1. 直接安装
接下来将会安装以下组建:
① 内置的 Python 虚拟环境(多数脚本由python编写,需要使用python执行。为防止干扰到其他的python,安装器会提供一个内置的python)
② 交叉编译器(这是在电脑上编译ESP32可执行文件必要的编译器,由于为在一种平台上编译出另一平台上的可执行文件,故称“交叉编译器”)
③ OpenOCD(针对高级用户。这是ESP32进行JTAG调试必要的组件,同样也支持STLink对stm32进行在线调试)
④ CMake 和 Ninja 编译工具 (这是连接源文件和交叉编译器的桥梁工具)
使用cd
命令,切换到ESP-IDF的目录,并执行此目录下的install.sh
cd ~/esp/esp-idf
./install.sh
或
cd ~/esp/esp-idf-v4.3.2
./install.sh
2. 使用 Espressif 的 Github 下载服务器加速下载
若下载缓慢,或中途有无法连接服务器的情况,请使用乐鑫 Espressif 官方提供的 Github 下载服务器加速下载。只需要临时加一个环境变量IDF_GITHUB_ASSETS
,内容为dl.espressif.com/github_assets
即可。
cd ~/esp/esp-idf
export IDF_GITHUB_ASSETS="dl.espressif.com/github_assets"
./install.sh
该设置只影响从 Github 发布版本中下载的单个工具,它并不会改变访问任何 Git 仓库的 URL。
上述两种方法都会默认在$HOME/.espressif/
内下载所需的工具链,这个目录可以更改,但是不建议更改。更改方法见官网https://docs.espressif.com/projects/e