Since v7.7.1 LVGL includes a Kconfig file, so LVGL can be used as an ESP-IDF v4 component.
Get the LVGL demo project for ESP32¶
We've created lv_port_esp32, a project using ESP-IDF and LVGL to show one of the demos from lv_examples. You are able to configure the project to use one of the many supported display controllers, see lvgl_esp32_drivers for a complete list of supported display and indev (touch) controllers.
Use LVGL in your ESP32 project¶
ESP-IDF v4 framework is the suggested version to use.
You are suggested to add LVGL as a "component". This component can be located inside a directory named "components" on your project root directory.
When your project is a git repository you can include LVGL as a git submodule:
git submodule add https://github.com/lvgl/lvgl.git components/lvgl
The above command will clone LVGL's main repository into the
components/lvgl directory. LVGL includes a
CMakeLists.txt file that sets some configuration options so you can use LVGL right away.
When you are ready to configure LVGL launch the configuration menu with
idf.py menuconfig on your project root directory, go to
Component config and then
Use lvgl_esp32_drivers in your project¶
You are suggested to add
lvgl_esp32_drivers as a "component". This component can be located inside a directory named "components" on your project root directory.
When your project is a git repository you can include
lvgl_esp32_drivers as a git submodule:
git submodule add https://github.com/lvgl/lvgl_esp32_drivers.git components/lvgl_esp32_drivers
Support for ESP32-S2¶
Basic support for ESP32-S2 has been added into the