模板: ESP32-S3-VSCODE-IDF
来自Waveshare Wiki
安装VSCode
- 打开VSCode官网的下载页面，选择对应系统和系统位数进行下载
- 运行安装包后，其余均可以默认安装，但这里为了后续的体验建议，建议在此处勾选框中的1、2、3项
- 第一二项开启后，可以直接通过鼠标右键文件或者目录打开VSCode，可以提高后续的使用体验.
- 第三项开启后，选择打开方式时，可以直接选择VSCode
安装Python环境
- 首先，前往Python官网下载Python 3.11。你也可以在Microsoft Store商店下载，这样无需手动配置环境变量。
- 也可以点击我们下载好的：python 3.11.9
- 勾选"Add python.exe to PATH"，将Python加入系统的环境变量。
- 选择自己想要的安装路径，点击"Customize installation",其他配置参考下图：
- 安装完成后，检查一下安装是否成功:win+r ->输入cmd -> python --version,出现下图的信息，则安装成功
安装Espressif IDF插件
- 注：当前插件最新版本为V1.7.1，为体验一致，用户可以选择与我们一样的版本，考虑到网络问题无法下载esp-idf，我们提供了离线包。
版本 描述 下载 esp-idf esp-idf V5.3离线包 百度网盘链接
- 在一个非中文路径下新建一个名为esp的文件夹，将下载好的v5.3-dev.exe放入该文件夹内。双击运行该文件，然后点击Extract以开始解压。
- 解压完成后，创建一个存放编译工具的文件夹在解压后的文件夹中，名为Espressif
- 打开VSCode,使用快捷键Shift+Ctrl+X，进入插件管理器
- 在搜索栏中，输入Espressif IDF，选择对应的插件点击 install即可
- 使用快捷键F1，输入
esp-idf: configure esp-idf extension
- 选择express（此教程针对第一次安装的用户，故只讲述初次的通用安装教程）
- 打开后显示该界面
- 我们按照下图进行设置，配置完成后，点击 install 进行下载：
- 进入下载页面，其会自动安装对应工具与环境，稍等片刻即可,安装完成后，会进入以下界面，说明安装完成：
- 注意：如果之前有安装过ESP-IDF，或者失败过的，请务必彻底删除文件或者创建全新的无中文路径
创建例程
- 我们将以使用官方例程为例来进行演示。
- 使用快捷键F1，输入
esp-idf:show examples projects
- 选择你当前的IDF版本
- 以Hello world例程为例
①选择对应例程 - 选择放置例程的路径，要求无例程同名文件夹
②其readme会说明该例程适用于什么芯片（下文有介绍例程怎么使用与文件结构，这里略）
③点击创建例程
设置COM口
- 此处显示使用对应的COM口，点击可以修改对应COM口
- 我们的USB串行设备为COM5，所以我们选择COM5，请根据自己USB串行设备对应COM口进行选择
- 选择使用的工程或者例程
修改驱动对象
- 此处显示的是使用的驱动对象，点击可以修改对应驱动对象
- 选择使用的工程或者例程
- 点击后需要稍等片刻
- 选择我们需要驱动的对象，也就是我们的主芯片为ESP32S3
- 选择openocd的路径，这里选择USB JTAG
- USB Bridge 是一种通用的接口转换工具，用于将 USB 转换为其他类型的接口，适用于各种设备间的通信和调试。
- USB JTAG 是一种专用的调试和编程工具，专门用于集成电路的调试和编程，提供硬件级别的测试和诊断功能。
状态栏简介
①SDK 配置编辑器，ESP-IDF很多功能与配置可以在其内修改
②全部清理，清空所有编译文件，
③编译
④当前下载方式，默认为UART
⑤烧录当前固件，请在编译后进行
⑥打开串口监视器，用于查看串口信息
⑦编译，烧录，打开串口监视器 一体按键（调试时最常用）
编译、烧录、串口监视
- 点击我们之前介绍的 编译，烧录，打开串口监视器按键
- 编译可能需要较长时间才能完成，尤其是在第一次编译时。
- 在此过程中，ESP-IDF可能会占用大量CPU资源，因此可能会导致系统卡顿。
- 因为我们使用的是USB芯片，并且板载自动下载电路，无需手动操作即可自动下载
- 下载成功后，自动进入串口监视器，可以看到芯片输出对应的信息并提示10S后重启
