SOC-ESP32S3部分：1、ESP32开发IDF-5.4环境搭建
飞书文档
https://x509p6c8to.feishu.cn/wiki/OnT5w1WV2i2Zt1kKmXoc2WQKnxf
在以前，ESP32开发环境的搭建是一件极其痛苦的事情，因为乐鑫之前只支持Linux的开发方式，安装的开发环境很多插件都在Github上，而很多包又特别大，国内访问Github本身就比较麻烦，这类特别大的包，网络一旦不稳定，很容易下载失败，搭建个环境可能需要一到两天。
而现在，乐鑫官方也知道这个事情，所以他们也推出了Window安装包的环境搭建方式，所以如果你是小白用户，建议使用Window方式，如果Window方式实在安装不了，再考虑Linux方式
| FYI： 环境搭建是学习后续课程的基础，因为不同电脑环境差异较大，你在做搭建环境的过程中可能会遇到各类奇怪的问题，课程很难遍历出所有可能出现的问题，建议你多结合AI工具、搜索引擎进行问题排查，细心点一般都能找到答案的。 乐鑫ESP32是一款非常火的芯片了，网上各方面的资料非常多，可以多搜索多排查。 |
一、Window环境搭建
1.1、安装包下载
文档下载链接：参考飞书文档
百度云盘下载链接：戳这里
官方下载链接：戳这里
课程使用IDF 5.4版本的离线安装包，不建议用在线安装包，比较慢。
1.2、安装流程
安装过程比较简单，下载安装包到本地后，然后直接双击esp-idf-tools-setup-offline-5.4.exe安装即可
| 安装注意事项，不注意会导致安装失败
|
如果提示需要修复长路径的，可以点击应用修复，但是最好不安装到长路径中
这里有几个点需要注意的，务必注意：
限定条件：
请注意 ESP-IDF 和 ESP-IDF 工具的安装路径不能超过 90 个字符，安装路径过长可能会导致构建失败。
ESP-IDF 的安装路径中一定不能包含空格或括号。
除非操作系统配置为支持 Unicode UTF-8，ESP-IDF 的安装路径中也不能包括特殊字符，例如中文、标点符号之类
这个路径需要记下来，后续我们会用到这个路径中的示例源码。
然后就可以点击下一步，这里我们安装课程相关的芯片支持包即可，减少安装磁盘空间
这里我们选择
|
接着就可以点击下一步开始安装了，安装程序会安装以下组件，这些都是自动安装的，不用我们干涉，安装的软件包括：
内置的 Python
交叉编译器
OpenOCD
CMake 和 Ninja 编译工具
ESP-IDF安装结束，我们可以勾选 Run ESP-IDF PowerShell Environment 或 Run ESP-IDF Command Prompt (cmd.exe)，方便验证安装是否有问题
安装程序会在选定的提示符窗口启动 ESP-IDF。例如下方PowerShell的，如果能看到下方打印，也就意味着你安装成功啦。
1.3、安装完成验证
后续我们就可以基于这个窗口进行代码编译和固件烧录。
后续如何打开此窗口呢？我们可以在电脑的开始菜单中搜索esp-idf就可以看到，在这里建议使用power shell，因为指令补全更方便。
至此，安装完成，恭喜你完成了最难的一集。
二、Linux环境搭建
注意，使用Linux环境搭建，需要有Linux相关命令行使用经验，小白用户建议用Window环境搭建，如果要用Linux，先学习下Linux相关知识，建议看书籍：鸟哥的 Linux 私房菜。
2.1、虚拟机安装
2.1.1下载安装包
2024年5月份之后，VMware workstation player不能直接在VMware官网下载,需要在VMware的官网上跳转到broadcom博通网站下载，VMware 从 17.5.2 开始个人非商业使用免费，不需要许可证就可以免费使用了。
官网链接：戳这里 ，这里需要注意，官方网站下载需要注册登录，如果你希望快速安装，可以使用文档提供的版本。
文档下载戳下方：
参考飞书文档
网盘版本：戳这里
2.1.2、安装
虚拟机安装这里就不强调了，网络上教程很多，可以自行搜索下VMware安装流程，基本上是全部下一步即可。
参考：https://www.cnblogs.com/EthanS/p/18211302
2.2、Linux Ubuntu安装
2.2.1下载安装包
虚拟机安装完成后，可以安装Linux系统：
Linux建议使用Ubuntu18.04或Ubuntu20.04，课程验证过这两个版本，安装比较顺利，其它版本可能会有环境不兼容问题，需自行排查解决。
系统镜像下载：戳这里
文档下载戳下方：
飞书文档
网盘版本：戳这里
2.2.2、安装
安装教程参考：https://blog.csdn.net/qq_54712434/article/details/143624068
安装完成后，需要确保系统的CMake 3.16 、Python 3版本，如果系统课程提供的镜像，这里都是没问题的。
使用 ESP-IDF 需要 CMake 3.16 、Python 3以上版本。较早的 Linux 发行版可能需要升级自身的软件源仓库
leo@ubuntu:~/work/esp/demo01$ cmake -version
cmake version 3.16.3
leo@ubuntu:~/work/esp/demo01$ python --version
Python 3.8.102.2、安装依赖工具
安装完成后，打开命令终端，安装以下工具
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-02.3、安装IDF 5.4
这个安装路径要记录下来，后续会用到相关例程源码
mkdir -p ~/esp
cd ~/esp
git clone -b v5.4 --recursive https://github.com/espressif/esp-idf.git
这一步因为要从外网下载大量代码和组件包，极其容易失败，建议上魔法多尝试，出现问题时自行搜索相关教程安装。如果最终搞不定，建议直接到淘宝找代安装服务。除了 ESP-IDF 本身，还需要为支持 ESP32-S3 的项目安装 ESP-IDF 使用的各种工具，比如编译器、调试器、Python 包等。
cd ~/esp/esp-idf
export IDF_GITHUB_ASSETS="dl.espressif.cn/github_assets"
./install.sh esp32s3
这一步因为要下载大量代码和组件包，极其容易失败，建议上魔法多尝试，出现问题时自行搜索相关教程安装。如果最终搞不定，建议直接到淘宝找代安装服务。2.4、设置环境变量&验证安装
leo@ubuntu:~/work/esp/demo01$ gedit ~/.bashrc
alias get_idf='. $HOME/esp/esp-idf/export.sh'使能环境变量
eo@ubuntu:~/work/esp/demo01$ source ~/.bashrc
leo@ubuntu:~/work/esp/demo01$ getidf
Checking "python3" ...
Python 3.8.10
"python3" has been detected
Activating ESP-IDF 5.4
* Checking python version ... 3.8.10
* Checking python dependencies ... OK
* Deactivating the current ESP-IDF environment (if any) ... OK
* Establishing a new ESP-IDF environment ... OK
* Identifying shell ... bash
* Detecting outdated tools in system ... Found tools that are not used by active ESP-IDF version.
For removing old versions of esp32ulp-elf, openocd-esp32, esp32s2ulp-elf, xtensa-esp32-elf, xtensa-esp32s2-elf, riscv32-esp-elf, xtensa-esp32s3-elf use command 'python /home/leo/work/esp/esp-idf/tools/idf_tools.py uninstall'
To free up even more space, remove installation packages of those tools.
Use option python /home/leo/work/esp/esp-idf/tools/idf_tools.py uninstall --remove-archives.
* Shell completion ... Autocompletion code generatedDone! You can now compile ESP-IDF projects.
Go to the project directory and run:idf.py build至此配置完成。