第 2 节

ESP32环境搭建

Linux

打开下面的网站, https://docs.espressif.com/projects/esp-idf/zh_CN/stable/esp32/get-started/linux-macos-setup.html

安装依赖

alt text

第一步按照这个网站所示,如果你是Ubuntu

sudo apt-get install git wget flex bison gperf python3 python3-pip python3-venv cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0

如果你是Fedora

sudo dnf -y makecache && sudo dnf install git wget flex bison gperf python3 python3-setuptools cmake ninja-build ccache dfu-util libusbx

alt text

获取 ESP-IDF

alt text

看看目前最新稳定版是哪个版本

alt text

如上图所示,为5.5.2版本. 接下来,你选择一个你要存放固件的文件夹, 比如我要放在/home/tungchiahui/UserFolder/Applications/文件夹下(其中/home/tungchiahui可用~/代替) 那么

cd ~/UserFolder/Applications
mkdir -p ./esp
cd ./esp
# 记得版本号要改成最新稳定版(网络环境一定要好)
git clone -b v5.5.2 --recursive https://github.com/espressif/esp-idf.git

alt text

如图才是成功,不是下面这样的都是没下载成功的 alt text

设置工具

alt text

cd ./esp-idf
# 选择国内服务器
export IDF_GITHUB_ASSETS="dl.espressif.cn/github_assets"
./install.sh all

alt text

上图就是成功的样子,这里要复制一下我红色圈起来的东西(export.sh的路径),下一个环境配置中要使用,比如我这里复制下来的路径是 ~/UserFolder/Applications/esp/esp-idf/export.sh

设置环境变量

此时，刚刚安装的工具尚未添加至 PATH 环境变量，无法通过“命令窗口”使用这些工具。因此，必须设置一些环境变量。这可以通过 ESP-IDF 提供的另一个脚本进行设置。

vim ~/.bashrc

添加下面这句(这里要填你具体存放的路径,也就是刚才复制的那串路径,记得把~改成$HOME,增加健壮性)

alias get_idf='. $HOME/UserFolder/Applications/esp/esp-idf/export.sh'

alt text

source ~/.bashrc

alt text

配置VScode

https://docs.espressif.com/projects/vscode-esp-idf-extension/zh_CN/latest/index.html

安装ESP-IDF插件

alt text

点击 Express 并选择下载服务器：

按下图的选,因为我们刚才配置过环境了,这里不要再选择版本了,直接去选择从我的电脑里找到ESP-IDF

alt text

他会自动帮你补全所有工具链

alt text

右下角这么显示则为成功

alt text

紧接着要配置 openOCD : alt text 复制上面这行,并开终端(任意终端都行,不用管路径)运行

sudo cp --update=none /home/tungchiahui/.espressif/tools/openocd-esp32/v0.12.0-esp32-20250707/openocd-esp32/share/openocd/contrib/60-openocd.rules /etc/udev/rules.d

alt text