Espressif (ESP32 芯片系列)¶
LVGL 可以作为标准的 ESP-IDF 组件使用和配置。
有关 ESP-IDF 构建系统的更多信息,请参阅 此处。
ESP32 的 LVGL 演示项目¶
我们创建了 lv_port_esp32,这是一个使用 ESP-IDF 和 LVGL 的项目,用于展示 demos 中的一个演示。 您可以配置该项目以使用许多支持的显示控制器和目标(芯片)。
有关支持的显示和输入设备(触摸)控制器及目标的完整列表,请参阅 lvgl_esp32_drivers 仓库。
在您的 ESP-IDF 项目中使用 LVGL¶
前置条件¶
ESP-IDF v4.1 及以上版本
带有显示屏的 ESP 开发板
获取 LVGL¶
选项 1: git 子模块
只需将 LVGL 克隆到您的 project_root/components 目录中,它将自动集成到项目中。
如果项目是一个 git 仓库,您可以将 LVGL 包含为一个 git 子模块:
git submodule add https://github.com/lvgl/lvgl.git components/lvgl
上述命令将 LVGL 的主仓库克隆到 components/lvgl 目录中。LVGL 包含一个 CMakeLists.txt 文件,该文件设置了一些配置选项,因此您可以立即使用 LVGL。
选项 2: IDF 组件管理器
LVGL 也通过 IDF 组件管理器 分发。 它允许用户通过以下命令将 LVGL 组件 无缝集成到他们的项目中:
idf.py add-dependency lvgl/lvgl>=8.*
在下一次项目构建期间,LVGL 组件将从组件注册表中获取并添加到项目构建中。
配置¶
准备好配置 LVGL 时,在项目根目录中使用 idf.py menuconfig 启动配置菜单,进入 Component config,然后选择 LVGL configuration。
在 ESP-IDF 项目中使用 lvgl_esp32_drivers¶
您还可以将 lvgl_esp32_drivers 添加为一个“组件”。此组件应位于项目根目录中的一个名为“components”的目录中。
如果您的项目是一个 git 仓库,您可以将 lvgl_esp32_drivers 包含为一个 git 子模块:
git submodule add https://github.com/lvgl/lvgl_esp32_drivers.git components/lvgl_esp32_drivers