【笔记】LINUX-ubuntu ESP-IDF环境搭建

天昊吖

已于 2024-01-06 17:33:44 修改

阅读量3.6k

点赞数 43

CC 4.0 BY-SA版权

文章标签： linux 笔记 ubuntu

于 2024-01-06 17:32:07 首次发布

本文链接：https://blog.csdn.net/qq_43349114/article/details/135428139

本文详细描述了如何在Ubuntu虚拟机中安装ESP-IDF，包括处理网络问题、安装常用软件、获取并安装ESP-IDF、定义开发路径以及解决遇到的各种硬件兼容性和权限问题。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1.前期准备虚拟机 ubuntu

网上很多教程，不再赘述

正式开始

2.安装准备

乐鑫官方的安装步骤很精简了（但是，国内网的问题，不科学上网大概率会失败在拉取子模块那里）
所以，放弃官方步骤。
参考此篇文章 Linux下搭建ESP-IDF 开发环境教程，适合ESP32/S2/C3/S3系列模组二次开发开始安装

2.1 安装常用软件

sudo apt-get install vim
sudo apt install git

2.2 ubuntu18以上

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

如果18以下版本请看上述参考文章

3.获取 ESP-IDF

3.1 3.2 是重复操作，执行一步就行，推荐3。2

3.1 拉取（这样大概率会失败。跳过这步到3.2 ）

mkdir -p ~/esp
cd ~/esp
git clone --recursive https://github.com/espressif/esp-idf.git

3.2 分步拉取

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

拉取子模块。这步受网络影响，大概率会报错，报错后重复执行，直到成功。

git submodule update --init

3.3 下载工具

这里用乐鑫的方法换成乐鑫服务器地址

cd ~/esp/esp-idf
export IDF_GITHUB_ASSETS="dl.espressif.com/github_assets"

然后，进行安装
（这一步也会经常失败。一直重复操作直到成功）

./install.sh esp32

成功后显示
成功界面

4.定义路径

4.1 添加路径

按步骤执行

vim ~/.bashrc

按下 i ,将下行代码，粘贴到最上边。

export IDF_PATH=/home/[你的用户名]/esp/esp-idf
# 比如我的就是 export IDF_PATH=/home/xcw/esp/esp-idf

按 ESC ，输入 :wq 然后输入

`source ~/.bashrc`

测试是否成功

echo $IDF_PATH

4.2 测试

在esp-idf 目录下。

. ./export.sh

成功：在这里插入图片描述

4.3 可以为执行 export.sh 创建一个别名

重复4.1步骤，加入以下代码

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

这样，你在需要运行，idf的串口，输入 get_idf 便可。

安装完成，后续

后边没什么了，看乐鑫文档就可以。

开始创建工程

遇到问题及解决方案

~~辛酸历程，各种方案试了快十小时了，终于守得云开见月明。~~

1.虚拟机不显示可移动设备

解决方案及思路

1.查看官方说明。usb设备连接到虚拟机
按照官方说明设置，没用。
2.查到解决办法
右键 win 图标
在这里插入图片描述
右键 2 箭头所指，-【属性】-【启动类型】改为自动。下图

完成后，重启电脑，插入设备，便正常了。

2. cp2102 串口模块正常，CH341 DEV/TTY 下不显示

原因：驱动太老，更新驱动。参考；CH340 CH341 Linux驱动最完整使用教程（永久解决/dev/ttyUSB0 permission denied问题

解决

驱动下载：沁恒电子官网

首先执行 uname -r 查看操作系统发行版本
我的系统发行版本

进入驱动路径：cd /lib/modules/5.15.0-91-generic/kernel/drivers/usb/serial/ , ls 查看驱动
卸载驱动 sudo rm -rf ch341.ko

解压下载的驱动，到文件夹内 driver 目录下，有 .C . H 的目录。
make ,生成.ko文件

unzip CH341SER_LINUX.ZIP
cd CH341SER_LINUX/driver
make
sudo make load

复制到目录下

sudo scp ch341.ko /lib/modules/5.15.0-91-generic/kernel/drivers/usb/serial/
sudo depmod

然后重启。

usb 权限问题

修改权限为可读可写可执行

sudo usermod -aG　dialout [你的用户名]