Set up a project¶
Get the library¶
LVGL is available on GitHub: https://github.com/lvgl/lvgl.
You can clone it or download the latest version of the library from GitHub.
The graphics library itself is the lvgl directory which should be copied into your project.
There is a configuration header file for LVGL called lv_conf.h. You modify this header to set the library's basic behavior, disable unused modules and features, adjust the size of memory buffers in compile-time, etc.
Copy lvgl/lv_conf_template.h next to the lvgl directory and rename it to lv_conf.h. Open the file and change the
#if 0 at the beginning to
#if 1 to enable its content.
Alternatively, lv_conf.h can be copied to another place but then you should add the
LV_CONF_INCLUDE_SIMPLE define to your compiler options (e.g.
-DLV_CONF_INCLUDE_SIMPLE for gcc compiler) and set the include path manually.
In this case LVGL will attempt to include
lv_conf.h simply with
Comments in the config file explain the meaning of the options. Be sure to set at least
LV_COLOR_DEPTH according to your display's color depth.
To use the graphics library you have to initialize it and setup required components. The order of the initialization is:
Initialize your drivers.
xmilliseconds in an interrupt to report the elapsed time to LVGL. Learn more.
lv_timer_handler()every few milliseconds to handle LVGL related tasks. Learn more.