新建项目

创建例程

• 使用快捷键 F1 ，输入esp-idf:show examples projects
  

• 选择你当前的IDF版本
  

• 以Hello world例程为例

①选择对应例程
②其readme会说明该例程适用于什么芯片（下文有介绍例程怎么使用与文件结构，这里略）
③点击创建例程

• 选择放置例程的路径，要求无例程同名文件夹
  

修改COM口

• 此处显示使用对应的COM口，点击可以修改对应COM口
• 请根据设备对应COM口进行选择（可通过设备管理器查看）
• 若出现下载失败的情况请点击复位按键1秒以上或进入下载模式，等待 PC 端重新识别到设备后再次下载
  

修改驱动对象

• 选择我们需要驱动的对象，也就是我们的主芯片为ESP32S3
  

• 选择openocd的路径，这里对我们没有影响，所以我们随便选择一个即可
  

其余状态栏简介

①.ESP-IDF开发环境版本管理器，当我们的工程需要区分开发环境版本时，可以通过安装不同版本的ESP-IDF来分别管理，当工程使用特定版本时，可以通过使用它来切换
②.设备烧录COM口，选择以将编译好的程序烧录进芯片上
③.set-target 芯片型号选择，选择对应的芯片型号，如:ESP32-P4-Nano需要选择 esp32p4 为目标芯片
④.menuconfig，点击修改sdkconfig配置文件内容，项目配置详细资料
⑤.fullclean 清理按钮，当工程编译报错或其他操作污染编译内容时，通过点击清理全部编译内容
⑥. Build 构建工程，当一个工程满足构建时，通过此按钮进行编译
⑦.当前下载方式，默认为UART
⑧.flash烧录按钮，当一个工程Build构建通过时，选择对应开发板COM口，点击此按钮可以将编译好的固件烧录至芯片
⑨.monitor开启烧录口监控，当一个工程Build-->flash后，可通过点击此按钮查看烧录、调试口输出的l0g，以便观察应用程序是否正常工作
⑩.Debug调试
⑪.Build Flash Monitor 一键按钮，用于连续执行Build-->Flash-->Monitor，常被称作小火苗

编译、烧录、串口监视

• 点击我们之前介绍的 编译，烧录，打开串口监视器按键
  

• 编译可能需要较长时间才能完成，尤其是在第一次编译时
  

• 在此过程中，ESP-IDF可能会占用大量CPU资源，因此可能会导致系统卡顿
  
• 若是新工程首次烧录程序，将需要选择下载方式，选择 UART
  

• 后续也可在 下载方式 处进行修改（点击即可弹出选项）
  

• 因为板载自动下载电路，无需手动操作即可自动下载
• 下载成功后，自动进入串口监视器，可以看到芯片输出对应的信息并提示10S后重启
  

使用IDF 示例程序

软件内部打开

• 打开 VScode 软件，选择文件夹打开示例
  

• 选择提供的 ESP-IDF 下的示例，点击选择文件(位于 示例程序/Demo/ESP-IDF 路径下)
  

软件外部打开

• 正确选择工程目录，打开工程，否则会影响后续程序编译烧录
  

• 连接设备后，选择好COM口和型号，点击下方编译并烧录即可实现程序控制
  

ESP-IDF工程项目详解

• 组件（Component）:ESP-IDF中的组件是构建应用的基本模块，每个组件通常是相对独立的代码库或库，能实现特定的功能或服务，可以被应用程序或是其他组件重复使用，类似于Python开发中的库的定义。
  • 组件的引用：Python开发环境中引入库只需要“import 库名或路径”即可，而ESP-IDF基于C语言基础，引入库是通过CMakeLists.txt进行配置和定义的。
  • CmakeLists.txt的作用：ESP-IDF编译时编译工具CMake会首先通过读取工程目录的顶层CMakeLists.txt的内容来读取构建规则，识别需要编译的内容。当在CMakeLists.txt中引入了需要的组件、程序后，编译工具CMake会根据索引导入每个所需要编译的内容。编译过程如：

【程序说明】

• 通过GPIO连接的模拟量电压经过ADC转换成数字量，然后通过计算得到实际的锂电池电压，并打印到终端。

【硬件连接】

• 使用USB线把板子接入电脑

【代码分析】

• adc_bsp_init(void) ：初始化 ADC1，包括创建 ADC 单次触发单元并配置 ADC1 的通道 3。
• adc_get_value(float *value,int *data) ：读取 ADC1 通道 3 的值，并根据参考电压和分辨率计算出对应的电压值存储在传入的指针指向的位置，如果读取失败则存储 0。
• adc_example(void* parameter)：初始化 ADC1 后，创建一个ADC任务，该任务每隔 1 秒读取一次ADC的值，通过读取的ADC原始值计算出系统的电压。

【运行效果】

• 程序编译下载完成，打开串口监控可以看到打印输出的ADC的值和电压，如下图所示：
  

【程序说明】

• 通过I2C协议，分别对PCF85063芯片进行初始化、设置时间、间隔读取时间，然后打印到终端

【硬件连接】

• 使用USB线把板子接入电脑

【代码分析】

• void i2c_rtc_loop_task(void *arg) ：创建一个RTC任务来实现RTC功能，每隔1秒读取一次RTC芯片的时钟，然后输出到终端。

【运行效果】

• 程序编译下载完成，打开串口监控可以看到打印输出的RTC时间，如下图所示：
  

【程序说明】

• 通过I2C协议，对QMI8658芯片进行初始化设置，然后每隔200毫秒读取对应的姿态信息打印到终端

【硬件连接】

• 使用USB线把板子接入电脑

【代码分析】

• void i2c_qmi_loop_task(void *arg) ：创建一个QMI任务来实现获取姿态信息，在任务中读取并打印加速度计、陀螺仪数据，并将获取的结果输出到串口控制台，间隔200毫秒。

【运行效果】

• 打开串口监控，可以看到打印输出的IMU发出来的原始数据(欧拉角需要自己转换)，如下图所示：
  

【程序说明】

• 通过SDMMC方式驱动SD卡，成功挂载之后把SD卡信息打印到终端。

【硬件连接】

• 上电之前先给板子装上FatFs格式的SD卡

【代码分析】

• sdcard_init(void) ：使用1线SDMMC方式初始化SD卡。
• sdcard_loop_task(void *arg)：测试SD卡读写功能的任务，需要取消#define sdcard_write_Test宏定义的注释。

//#define sdcard_write_Test

【运行效果】

• 点击串口监控设备，可以看到输出的SD卡的信息，practical_size是SD卡的实际容量，如下图所示：
  

【程序说明】

• 该示例可将开发板设置为热点，允许手机或其他处于 STA 模式的设备连接到开发板。

【代码分析】

• 在softap_example_main.c文件找到SSID和PASSWORD，然后手机或其他处于 STA 模式的设备即可使用该 SSID 和 PASSWORD 连接到开发板。

#define EXAMPLE_ESP_WIFI_SSID      "waveshare_esp32"
#define EXAMPLE_ESP_WIFI_PASSWORD      "wav123456"

【运行效果】

烧录完程序，打开串口终端，如果设备连接成功热点之后，会输出该设备的MAC地址和IP地址，如图： 

【程序说明】

• 该示例可将开发板配置为 STA 设备，以连接路由器，从而接入系统网络。

【代码分析】

• 在esp_wifi_bsp.c文件找到ssid和password，然后将其修改为当前环境中可用路由器的SSID 和 Password。

wifi_config_t wifi_config = {
      .sta = {
        .ssid = "PDCN",
        .password = "1234567890",
      },
  };

【运行效果】

烧录完程序，打开串口终端，如果设备连接成功热点之后，会输出所获取的IP地址，如图： 

【程序说明】

• 通过移植LVGL V8，在屏幕上实现一些多功能的GUI界面。

   【硬件连接】

• 使用USB线把板子接入电脑

【代码分析】

• 如果需要旋转90度显示，可以在user_config.h文件找到#define EXAMPLE_Rotate_90宏定义，取消注释即可。
• 如果需要进行背光测试，可以在user_config.h文件找到#define Backlight_Testing宏定义，取消注释即可。

//#define Backlight_Testing
//#define EXAMPLE_Rotate_90

【运行效果】

• 程序烧录完成后，设备的运行效果如下：

【程序说明】

• 通过移植LVGL V9，在屏幕上实现一些多功能的GUI界面。

【硬件连接】

• 使用USB线把板子接入电脑

【代码分析】

• 如果需要旋转90度显示，可以在user_config.h文件找到#define EXAMPLE_Rotate_90宏定义，取消注释即可。
• 如果需要进行背光测试，可以在user_config.h文件找到#define Backlight_Testing宏定义，取消注释即可。

//#define Backlight_Testing
//#define EXAMPLE_Rotate_90

【运行效果】

• 程序烧录完成后，设备的运行效果如下：

【程序说明】

• 综合性工程，简单测试板载硬件功能，也可以直接使用我们提供的BIN固件烧录。

【硬件连接】

• 使用USB线把板子接入电脑

【运行效果】

• 显示屏从红、绿、蓝三种颜色进行跳转(跳转间隔1.5秒)，如图：
  

• 显示完RGB之后，将会自动跳转到测试板载硬件功能界面，如图：
  

1.可以显示ESP32S3叠封的PSRAM和Flash
2.显示接入SD卡的实际容量
3.扫描周围的蓝牙和wifi设备
4.显示接入锂电池电压
5.实时显示rtc时间和QMI姿态数据

• 测试按键功能，如图：
  

1.单击BOOT可以切换界面
2.双击可以控制背光
3.长按可以测试sd卡读写功能，显示sd Test Pass表示测试通过

• 当前示例程序有提供测试固件，可通过直接烧录测试固件来测试板载设备功能正常与否
• bin文件路径：

  ..\ESP32-S3-LCD-3.16-Demo\Firmware