ESP32开发环境搭建

转载已于 2025-08-21 13:24:44 修改 · 51 阅读

0 ·

CC 4.0 BY-SA版权

原文链接：https://gitee.com/vi-iot

文章标签：

#单片机

于 2025-07-14 14:04:55 首次发布

ESP32开发环境搭建

1，软件安装
- 1.1， vmware安装
2，工程目录和编译

1，软件安装

vmware
ubuntu
vscode
MobaXterm
16G内存和200G以上硬盘空间

1.1， vmware安装

在这里插入图片描述

全名，sa；用户名，sa；密码，123；确认，123；

启动虚拟机，安装ubuntu系统，请注意

全名，sa；用户名，sa；密码，123；确认，123；
选择update的地方，选择cancel，
提示安装openssl，选择安装。

虚拟机开机后界面如下
在这里插入图片描述
输入用户名和密码登录，安装工具

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

因为github 的访问问题，我们很难直接从github上拉取完整的esp-idf源码，但乐鑫官方提
供了一个下载工具，我们通过这个工具可以轻松的获取到esp-idf。

首先我们新建一个esp32目录，存放我们所有esp32相关的东西

mkdir esp32
cd esp32

拉取esp-gitee-tools 工具

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

将github的地址自动替换成jihulab上的镜像地址，这样就不用担心github
的访问问题了

cd esp-gitee-tools
 ./jihu-mirror.sh set

先回到esp32目录,后拉取esp-idf

git clone--recursive https://github.com/espressif/esp-idf.git

进入esp-idf目录，需要基于esp-idfv5.2版本进行开发，需要切换版本

git checkout v5.2

输入git branch查看结果
在这里插入图片描述
确认版本后让子模块也切换对应的版本

git submodule update--init--recursive

安装编译工具，需要esp-gitee-tools工具目录下的install.sh脚本
在esp-idf目录下

../esp-gitee-tools/install.sh

等待完成后，我们的esp-idf就部署完成了。

2，工程目录和编译

例程下载到esp32目录里面

cd ~/esp32
 git clone--recursive https://gitee.com/vi-iot/esp32-board.git

这个仓库包含了很多个工程，每个工程都是可以单独编译的。

2.1，代码编译

使用mobaxterm工具SSH登录ubuntu

在这里插入图片描述

点击OK后，输入密码，就可以登录ubuntu了

设置esp-idf的环境变量

cd esp32/esp-idf
source export.sh

执行完export.sh 脚本后，会出现如下
在这里插入图片描述
说明设置环境变量成功。因为这次设置只是针对当前登录的用户，我们退出了重新登录
这些环境变量就没有了，我们又要重新执行一下以上命令。
解决方法
使用vim打开~/.profile，在该文件最后一行插入

source esp32/esp-idf/export.sh

这样每次登录就会自动执行这条语句。

进入esp32-board文件夹，进入helloworld工程目录
编译工程

idf.py build

2.2，代码浏览和编辑

使用vscode工具，安装插件

Chinese Language
Remote - SSH

对Remote -SSH进行配置

保存，重启一下VSCode，就能看见可以连接的远程主机了

在这里插入图片描述
输入密码登录，选择打开文件夹，在这里可以可看到工程文件。
vscode SSH远程登陆虚拟机后，需要安装两个插件
c/c++
esp-idf
装好后，最好重启一下VSCode，重复上述步骤登录ubuntu和打开helloworld工程文件夹，

按下ctrl+shift+p，弹出搜索框，搜索ESP-IDF:AddvscodeConfigurationFolder，在下拉列
表出现后，点击一下就可以了，这步的目的是为了把esp-idf里面的源码路径也加到我们的
工程中，现在我们可以通过按着ctrl键点击函数或变量进行跳转看代码了
如果vscode 使用ctrl+鼠标左键无法跳转到esp-idf库中的函数查看代码，可以重复执行以上方法。

项目配置

idf.py menuconfig

1，设置主频
Component config
Alt
ESP System Settings
Alt
CPU frequency 修改主频到240MHz
Alt
2，回到顶层，选择Serial flasher config
Alt
Flash size 设置为4MB
3， Component config -> ESP PSRAM
勾选项目，保存退出。