跳到主要内容

ESP-IDF

本章节包含以下部分，请按需阅读：

ESP-IDF 入门教程​

初次接触 ESP32 ESP-IDF 开发，想要快速上手？我们为您准备了一套通用的 入门教程。

请注意：该教程使用 ESP32-S3-Zero 作为教学示例，所有硬件代码均基于其引脚布局。在动手实践前，建议您对照手中的开发板引脚图，确认引脚配置无误。

配置 ESP-IDF 开发环境​

备注

以下内容以 Windows 系统为例，使用 VS Code + ESP-IDF 扩展 的方式进行开发。Mac/Linux 用户请参考 官方说明。

安装 ESP-IDF 开发环境​

  1. 前往 ESP-IDF Installation Manager 下载 ESP-IDF 安装管理器。这是乐鑫最新推出的跨平台安装工具，下文将演示如何使用其离线安装功能。

    在页面中点击 Offline Installer 标签，然后在筛选栏中选择 Windows 操作系统和你要安装的版本。

    下载 EIM 和整合包

    确认选择无误后，点击下载按钮。浏览器将自动同时下载两个文件：一个是 ESP-IDF 离线整合包(.zst)，另一个是 ESP-IDF 安装器(.exe)。

    下载 EIM 和整合包2

    请耐心等待两个文件下载完成。

  2. 下载完成后，双击运行 ESP-IDF 安装器(eim-gui-windows-x64.exe)。

    启动后，可在右上角将界面语言切换为中文。

    切换 EIM 语言

    安装工具会自动检测同一目录下是否存在离线整合包。点击 从存档安装。

    自动检测整合包

    接下来，选择安装路径。建议使用默认路径；若需自定义，请确保路径中不包含中文或空格。确认无误后，点击 开始安装。

    选择安装路径

  3. 当看到如下界面时，表示 ESP-IDF 已安装成功。

    安装成功

  4. 建议同时安装驱动程序。点击 完成安装，然后点击 安装驱动程序。

    用 ESP-IDF 安装管理器安装驱动

安装 Visual Studio Code 与 ESP-IDF 扩展​

  1. 下载并安装 Visual Studio Code。

  2. 安装时建议勾选 通过 Code 打开操作添加到 Windows 资源管理器文件上下文菜单,以便快速打开项目文件夹。

  3. 在 VS Code 中,点击侧边活动栏中的 扩展图标 扩展图标(或使用快捷键 Ctrl + Shift + X)打开 扩展 视图。

  4. 在搜索框中输入 ESP-IDF,找到 ESP-IDF 扩展并点击安装。

    在 VS Code 中搜索并安装 ESP-IDF 扩展

  5. 当 ESP-IDF 扩展版本 ≥ 2.0 时,扩展会自动检测并识别上述步骤中安装的 ESP-IDF 环境,无需手动配置。

示例程序​

ESP-IDF 示例程序位于 示例程序包 的 ESP-IDF 目录中。

ESP32-S3-Touch-LCD-2.8-Test​

程序说明​

  • 本示例演示了如何在嵌入式设备上集成 LVGL 图形库，通过硬件初始化与图形库初始化的配合，搭建完整的图形界面运行环境。通过持续调用 LVGL 核心循环，确保图形界面实时响应用户交互并刷新系统状态，同时兼顾 CPU 资源的合理占用。

硬件连接​

  • 将 SD 卡接入开发板
  • 将开发板接入电脑

代码分析​

  • Driver_Init()：

    • 进行多个硬件模块的初始化，包括闪存测试、电源、电池、I2C 总线、实时时钟、陀螺仪、背光、SD 卡、音频和显示屏等。确保各个硬件能够正常工作，为系统提供必要的功能支持
    • 初始化 LVGL，为图形界面的显示和交互做准备
    • 可选择调用不同的 LVGL 示例或特定功能，展示不同的图形效果和交互方式

  • app_main()：

    • 持续调用 Lvgl_Loop，确保 LVGL 的图形界面能够不断更新，响应用户的交互操作，并反映系统的状态变化
    • 添加短暂延迟，避免过度占用 CPU 资源，同时让系统有时间处理其他任务或等待外部事件

运行效果​

  • 参数说明：
参数功能说明
SD Card显示 SD 卡的大小连接 SD 卡，若识别失败请将 SD 卡格式化为 FAT32 格式（首次识别失败请等待一会后复位下再查看）
Flash Size显示 Flash 大小当前板载 16MB Flash
Battery Voltage电池电压连接电池时可检测到电池电压
Angular deflection显示板子角度偏移显示三个方向的偏移
RTC Time显示 RTC 时间RTC 时间与当前时间不一致，是因为掉电状态下并不能留存数据，如需要保持 RTC 时间正常，则需连接 RTC 电池并更新 RTC 时间
Wireless scan显示扫描到的 WIFI 个数扫描结束会在末尾显示 Scan Finish
Backlight brightness亮度滑动条调节屏幕亮度
最后由 javen 于 更新