在Ubuntu2004中搭建基于ESP-IDF v5.1的ESP32-S3开发环境

在Ubuntu2004中搭建基于ESP-IDF v5.1的ESP32-S3开发环境

---

目录

[1 基本资料](#1 基本资料)
[2 注意事项](#2 注意事项)

[2.1 子模块检出失败处理](#2.1 子模块检出失败处理)

[2.2 选择 Espressif 下载服务器](#2.2 选择 Espressif 下载服务器)

[2.3 自定义工具安装路径](#2.3 自定义工具安装路径)

[2.4 导出环境变量](#2.4 导出环境变量)

[2.5 测试基础环境](#2.5 测试基础环境)
[3 创建自己的工程](#3 创建自己的工程)

[3.1 创建基础应用工程](#3.1 创建基础应用工程)

[3.2 创建组件(用于打包自己的静态库)工程](#3.2 创建组件(用于打包自己的静态库)工程)

---

1 基本资料

在进行开发环境的搭建的时候，需要优先参考官方文档资料，包括：ESP-IDF 编程指南 、ESP-IDF 构建系统 。

---

2 注意事项

2.1 子模块检出失败处理

有时候因为网络原因，会有些子模块检出失败，这时候进入esp-idf路径执行下这个子模块更新命令就好了：

git submodule update --init --recursive

2.2 选择 Espressif 下载服务器

选择从Espressif 下载服务器下载相关工具，会比从github上下载更稳定：

export IDF_GITHUB_ASSETS="dl.espressif.com/github_assets"

2.3 自定义工具安装路径

自定义工具安装路径，可以更方便自行管理、切换工具链版本等操作：

export IDF_TOOLS_PATH=$HOME/你的开发空间目录/espressif

2.4 导出环境变量

在经过2.2、2.3的配置之后，就可以执行 install.sh 脚本，执行完之后再导出环境变量（其实并不只是环境变量）到当前命令行：

cd $HOME/你的开发空间目录/esp-idf-v5.1
. $HOME/你的开发空间目录/esp-idf-v5.1/export.sh

2.5 测试基础环境

测试基础环境就直接用hello_world工程测试就行了,执行如下命令：

cd $HOME/你的开发空间目录/hello_world
idf.py set-target esp32s3
idf.py menuconfig
idf.py build

---

3 创建自己的工程

3.1 创建基础应用工程

在你的开发空间目录，创建一个你的工程目录（不在idf目录下）：

cd $HOME/你的开发空间目录/
mkdir 你的应用工程目录

cd $HOME/你的开发空间目录/你的应用工程目录
idf.py create-project 你的应用工程

cd $HOME/你的开发空间目录/你的应用工程目录/你的应用工程
idf.py set-target esp32s3
idf.py menuconfig
idf.py build

3.2 创建组件(用于打包自己的静态库)工程

在你的开发空间目录，创建一个你的工程目录（不在idf目录下）：

cd $HOME/你的开发空间目录/
mkdir 你的组件工程目录

cd $HOME/你的开发空间目录/你的组件工程目录
idf.py create-project 你的组件工程

cd $HOME/你的开发空间目录/你的组件工程目录/你的组件工程
idf.py -C components create-component 你的组件名
idf.py set-target esp32s3
idf.py menuconfig
idf.py build