新建项目

创建例程

• 使用快捷键 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会根据索引导入每个所需要编译的内容。编译过程如：

【程序说明】

• 本示例演示了板载各个设备的功能，页面一显示SD Card，Flash Size，Battery Voltage等参数，页面二为音乐播放界面；另外，此示例增加语音识别功能。

【硬件连接】

• 将SD卡插入开发板中(不插SD卡也能使用)
• 将开发板接入电脑

【代码分析】

• Driver_Init()：初始化硬件、驱动和系统所需的资源，并创建一个任务来循环执行硬件驱动
  • 硬件初始化：Driver_Init()负责初始化多个硬件模块，如电源管理、时钟、I2C总线、外部I/O、传感器等
  • 任务创建：xTaskCreatePinnedToCore()创建了一个 FreeRTOS 任务 Driver_Loop，并将其绑定到核心0。这意味着 Driver_Loop 函数将不断循环执行，处理硬件的相关操作。此任务将与其他任务并发运行，有助于硬件驱动的实时性
  • 模块化设计：初始化函数将各硬件初始化分散到不同的模块，易于维护和扩展。如果有新硬件需要支持，只需在这里添加初始化代码即可

• Driver_Loop()：这个函数在 FreeRTOS 任务中循环运行，定期执行各硬件驱动的工作。它是大部分硬件驱动操作的核心部分
  • 循环执行硬件驱动：Driver_Loop()中定期调用多个硬件驱动的循环函数，如 QMI8658_Loop()、PCF85063_Loop()、BAT_Get_Volts() 和 PWR_Loop()，这些都是实时执行的硬件操作
    • QMI8658_Loop()：处理与QMI8658传感器的交互，读取传感器数据
    • PCF85063_Loop()：处理PCF85063时钟模块，更新时间
    • BAT_Get_Volts()：获取当前电池电压，以确保设备电池电量满足要求
    • PWR_Loop()：执行电源管理任务，监控电源状态、控制电源的开启或关闭
  • 定时任务：通过 vTaskDelay(pdMS_TO_TICKS(100))，Driver_Loop()函数每100毫秒延时一次，这有助于确保任务不会占用过多CPU资源，也避免对硬件进行过于频繁的操作
  • 删除任务：vTaskDelete(NULL) 是用来删除当前任务的，但由于 while(1) 是一个死循环，实际上这行代码永远不会执行

【运行效果】

• LCD屏幕显示

• LCD屏幕显示参数说明

• 页面 2 为播放 SD 卡根目录下的 mp3 音频的 UI 页面
• 本程序默认启用语音识别，唤醒词为 “hi esp”，唤醒后，背光变暗后即可说出指令（背光未变暗则表示未被唤醒，识别要求较为严格，发音需要标准，语速放缓）
• 以下提供几种格式的MIC测试音频(请注意，每次hi esp唤醒失败的话请重新将音频调至该次唤醒词播放处重新播放)
• 请不要在使用喇叭播放音频时进行语音识别
• 测试音频中之所以播放两次唤醒词，是由于当前固件版本首次唤醒需要聚焦设备（比喻），并且当前固件并不允许关闭该功能

// 指令
Turn on the backlight
Turn off the backlight
Backlight is brightest
Backlight is darkest