lbuild module: modm:lvgl

LVGL is a free and open-source graphics library providing everything you need to create embedded GUI with easy-to-use graphical elements, beautiful visual effects and low memory footprint.

• https://lvgl.io/
• https://github.com/lvgl/lvgl

Configuration

LVGL defines defaults for all it's configuration settings, which you can find in the configuration template.

This module generates a lv_conf.h file to define the options necessary for integration with modm which are:

• Heap is provided by the modm:platform:heap module.
• Tick is implemented via the modm:platform:clock module.
• LV_LOG_PRINTF = 0: logging is redirected to MODM_LOG_* if the modm:debug module is included and LV_USE_LOG = 1.

To add your own configuration you can create a <lv_conf_local.h> file which will automatically be included at the beginning of our lv_conf.h.

Example <lv_conf_local.h> configuration:

Initialization

modm will call lv_init() as a constructor with priority 1000 and then set the required callbacks for the modm port to work. Static constructors are called afterwards therefore can already use the LVGL functions.

Calling the lv_timer_handler() may require a few kB of stack, so increasing the main stack size via the modm:platform:cortex-m:main_stack_size option or a fiber stack size via the template parameter may be necessary.