Ubuntu 下搭建ESP32 ESP-IDF开发环境,并在windows下用VSCode通过SSH登录Ubuntu开发ESP32应用

Ubuntu 下搭建ESP32 ESP-IDF开发环境,网上操作指南很多,本来一直也没有想过要写这么一篇文章。因为我其实不太习惯在linux下开发应用,平时更习惯windows的软件操作,只是因为windows下开发ESP32的应用编译时太慢,让人受不了,所以最后还是选择搭建了一个Ubuntu系统下的ESP32 ESP-IDF的开发环境,并在window系统下通过SSH连接Ubuntu,这样就即可以在window下用esp-idf开发esp32的应用,又不用忍受window下编译的漫长等待。

一、安装依赖项

这里我们假设Ubuntu系统已经安装完毕。我使用的是ubuntu 24.04.2 LTS版本(非虚拟机,如果使用虚拟机安装,可能后面有一些步骤会略有不同)。

sudo apt update

sudo apt-get install vim 
sudo apt install git
sudo apt-get install python3

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

 在ubuntu终端命令行分别输入以上命令并运行。这里一般不会出问题,不多说。

 二、获取ESP-IDF框架

 首先建立工作目录。

mkdir ~/esp
cd ~/esp

这里需要特别强调的一点是:用git命令来clone下来,这就可以可以同步最新的框架版本!不能直接一个downLoad 下载,发现会有错误,切记!

git clone -b v5.4 --recursive https://github.com/es
<think>我们正在Ubuntu系统上使用已下载的ESP-IDF v3.0搭建ESP32开发环境。根据引用内容,我们可以整合步骤,但需要注意引用[1]和[3]提供了一些通用步骤,而引用[2]提到了使用Gitee搭建,但这里我们使用已下载的ESP-IDF v3.0。 步骤: 1. 安装依赖项:这是必须的,因为ESP-IDF需要一些工具和库支持。 2. 设置ESP-IDF环境:因为我们已经有下载好的ESP-IDF v3.0,所以不需要通过git克隆,但需要设置环境变量。 3. 编译和烧录:创建示例工程测试。 具体步骤: 一、安装依赖项 根据引用[1]和[3],我们需要安装一些依赖包。打开终端,执行以下命令: ```bash sudo apt-get update 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 ``` 注意:对于ESP-IDF v3.0,可能还需要其他依赖,但以上是基础。 二、使用已下载的ESP-IDF 假设我们已经将ESP-IDF v3.0下载到了某个目录,例如:`~/esp/esp-idf-v3.0`。 1. 设置环境变量: 我们需要设置`IDF_PATH`环境变量,将其添加到profile中,以便每次登录时自动设置。 ```bash echo "export IDF_PATH=~/esp/esp-idf-v3.0" >> ~/.profile source ~/.profile ``` 2. 安装编译工具链和工具: 进入ESP-IDF目录,运行安装脚本: ```bash cd $IDF_PATH ./install.sh ``` 注意:安装脚本会下载工具链(如编译器、调试器等)安装到`$HOME/.espressif`目录。如果下载过程中遇到网络问题,可以考虑设置环境变量选择国内镜像(如引用[3]提到的选择Espressif下载服务器): ```bash export IDF_GITHUB_ASSETS="dl.espressif.com/github_assets" ./install.sh ``` 3. 导出环境变量: 除了`IDF_PATH`,我们还需要将工具链的路径添加到环境变量中。在`$IDF_PATH/export.sh`脚本中已经设置好,我们只需执行: ```bash . $IDF_PATH/export.sh ``` 为了每次打开终端自动设置,可以将该命令添加到`~/.profile`或`~/.bashrc`中: ```bash echo "source $IDF_PATH/export.sh" >> ~/.profile ``` 三、测试环境 1. 创建示例工程: 我们可以使用`hello_world`示例。 ```bash cp -r $IDF_PATH/examples/get-started/hello_world ~/esp/hello_world cd ~/esp/hello_world ``` 2. 配置工程(可选): 对于ESP32,通常我们可以使用默认配置。如果需要修改,使用: ```bash make menuconfig ``` 注意:在v3.0版本,使用的是`make`而不是`idf.py`(v4.0及以上使用idf.py)。 3. 编译工程: ```bash make all ``` 4. 烧录到开发板: 连接开发板,确定串口设备(如`/dev/ttyUSB0`),然后执行: ```bash make flash ``` 注意:可能需要权限,可以将当前用户加入dialout组: ```bash sudo usermod -a -G dialout $USER ``` 然后重新登录。 5. 监视串口输出: ```bash make monitor ``` 四、注意事项 - 如果之前安装过其他版本的ESP-IDF,请确保环境变量设置正确指向v3.0。 - 如果编译过程中出现错误,可能是依赖项没有安装完全,请根据错误信息安装相应的包。 - 由于v3.0版本较旧,可能不支持最新的Ubuntu版本,如果遇到问题,可以考虑使用Docker容器或者虚拟机运行较旧的Ubuntu版本。 以上步骤基于引用内容整合,针对已下载的ESP-IDF v3.0进行调整。 相关问题: 1. 如何解决在Ubuntu上安装ESP-IDF依赖项时出现的错误? 2. 如何更新ESP-IDF到新版本? 3. 如何为不同的ESP32项目设置不同的ESP-IDF版本?</think>### Ubuntu 下使用已下载的 ESP-IDF v3.0 搭建 ESP32 开发环境 #### 步骤 1:安装依赖项 ```bash sudo apt-get update sudo apt-get install git wget flex bison gperf python3 python3-pip python3-setuptools cmake ninja-build ccache libffi-dev libssl-dev dfu-util ``` #### 步骤 2:配置 ESP-IDF 环境 1. **设置环境变量** 打开终端,导航到 ESP-IDF v3.0 目录(假设路径为 `~/esp/esp-idf-v3.0`): ```bash cd ~/esp/esp-idf-v3.0 export IDF_PATH=$(pwd) # 设置临时环境变量 echo "export IDF_PATH=$(pwd)" >> ~/.bashrc # 永久生效 ``` 2. **安装 Python 依赖** ```bash python3 -m pip install --user -r $IDF_PATH/requirements.txt ``` #### 步骤 3:配置工具链 ```bash ./install.sh # 运行 ESP-IDF 的安装脚本 source export.sh # 激活环境变量 ``` > **注意**:若遇网络问题,可通过环境变量选择国内镜像: > `export IDF_GITHUB_ASSETS="dl.espressif.com/github_assets"`[^3] #### 步骤 4:测试环境 1. **编译示例工程** ```bash cp -r $IDF_PATH/examples/get-started/hello_world ~/esp/ cd ~/esp/hello_world make all # 编译项目 ``` 2. **烧录固件**(需连接 ESP32 开发板) ```bash make flash # 烧录固件 make monitor # 查看串口输出 ``` #### 常见问题解决 - **权限问题**:将用户加入 `dialout` 组以访问串口 ```bash sudo usermod -a -G dialout $USER ``` - **子模块缺失**:手动初始化子模块 ```bash cd $IDF_PATH git submodule update --init --recursive ``` #### 环境验证 成功编译烧录后,串口监视器应显示: ``` Hello world! This is ESP32 chip with 2 CPU cores... ``` > **关键提示**: > - ESP-IDF v3.0 使用 `make` 编译系统(v4.0+ 使用 `idf.py`) > - 确保 Python 版本 ≥3.7(可通过 `python3 --version` 检查) > - 完整文档参考:[ESP-IDF v3.0 官方指南](https://docs.espressif.com/projects/esp-idf/zh_CN/v3.0/) --- ### 相关问题 1. 如何解决 ESP-IDF v3.0 编译时的 `fatal error: esp_log.h: No such file` 错误? 2. 在 Ubuntu 中如何切换多个 ESP-IDF 版本(如 v3.0 和 v5.1)? 3. 如何配置 VSCode 通过 SSH 远程开发 ESP32 项目?[^1]
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

永远的元子

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值