ESP-IDF 文档中对项目的介绍主要依靠 IDF Python 脚本。乐鑫在 VSCODE 中提供了插件,使用图形界面更方便地配置项目。本文从零开始建立项目、配置 SDK,最后调试终端上输出 Helloworld。
新建项目
打开 ESP-IDF 插件首页,点击 New project
建立项目。
在此页需配置项目的名称、路径。如果已经有配置好的组件库,可以直接添加;没有的话项目建立之后可以再通过组件编辑器添加。串口在项目建立完后也可以很方便的更改。配置完成后点击 Choose Template
。
首先在左上角下拉栏中选择 ESP-IDF
,然后在下面出现的示例中选择和应用最相近的一个。这里选择 sample_project
。之后点击右上角的 Create project using template sample_project
。
这是项目默认文件,其中 main
是项目程序所在位置。CMakeLists
是编译项目所需的配置文件。更多项目文件的说明参照 ESP-IDF 项目文件。
添加组件
在新项目中再次打开 ESP-IDF 插件首页,点击 Components manager
。
在 ESP Registry
中可以方便地增加组件,在其中搜索组件,直接点击 Install
。插件会自动下载并添加到项目中。
这里添加 modbus 和 lvgl 两个库,安装组件后增加一些文件、文件夹
- managed_components:存储下载的组件文件
- depenendencies.lock:保存依赖树、版本、来源和哈希值
- sdkconfig:SDK 配置文件,不要直接编辑,插件提供了
SDK Configuration editor
专门用于修改该文件。
SDK 配置
点击底部状态栏中的齿轮图标,打开 SDK Configuration Editor。
- ESP System Settings 》CPU frequency 选择 240MHz
- ESP PSRAM 》 Support for external, SPI-connected RAM 勾选
- Serial flasher config》Flash size 选择 16MB
- Compiler options》Optimization Level 选择 Optimize for performance (-O2)
- Partition Table》Partition Table 选择 Custom partition table CSV
将下面内容保存在项目根目录上,保存为 partitions.csv。
# Name, Type, SubType, Offset, Size, Flags
# Note: if you have increased the bootloader size, make sure to update the offsets to avoid overlap
nvs, data, nvs, , 0x6000,
phy_init, data, phy, , 0x1000,
factory, app, factory, , 4M,
- 在手册查看确认 PSRAM 工作模式,配置 SPI RAM config》Mode (QUAD/OCT) of SPI RAM chip in use
输出 Helloworld!
编辑 main/main.c
#include <stdio.h>
#include "esp_log.h"
static char *TAG = "app_main";
void app_main(void)
{
ESP_LOGI(TAG, "Helloworld!");
}
编译并烧录程序
在监视窗口中可以看到 Helloworld!
,说明项目建立完成。
参考
Windows 平台工具链的标准设置 – ESP32-S3 – — ESP-IDF 编程指南 v5.3 文档 (espressif.com)
【ESP32】打造全网最强esp-idf基础教程——2.环境搭建补充和工程目录解析-CSDN博客
ESP32-S3-LCD-EV-Board v1.5 – – — esp-dev-kits latest 文档 (espressif.com)