- Generated on Thu Sep 24 2026 04:06:25 by
1.13.2
LVGL package for RIOT. More...
LVGL package for RIOT.
The package can be configured with using several variables. These variables can either be configured using CFLAGS or using Kconfig (via make menuconfig). LVGL_TASK_THREAD_PRIO cannot be configured via Kconfig.
CONFIG_LVGL_INACTIVITY_PERIOD_MS: maximum inactivity period before going to sleep in ms. (default: 5s)CONFIG_LVGL_TASK_HANDLER_DELAY_MS: delay between lvgl task handle call in us. (default: 5ms)LVGL_TASK_THREAD_PRIO: lvgl task handler thread priority. (default: THREAD_PRIORITY_MAIN - 1)Example of command line for changing the max activity period to 5s:
See LVGL Drivers.
Files | |
| file | lvgl_riot.h |
| Definition for the LVGL engine initialization. | |
| file | lvgl_riot_conf.h |
| Definitions specific to RIOT for the LVGL engine. | |
| #define | LV_CONF_H 1 |
| LVGL configuration macros. | |
| #define | LV_COLOR_DEPTH 16 |
| Color depth. | |
| #define | LV_COLOR_16_SWAP 0 |
| Swap the 2 bytes of RGB565 color. | |
| #define | LV_COLOR_16_SWAP 0 |
| Swap the 2 bytes of RGB565 color. | |
| #define | LV_COLOR_SCREEN_TRANSP 0 |
| Enable more complex drawing routines to manage screen transparency. | |
| #define | LV_COLOR_CHROMA_KEY lv_color_hex(0x00ff00) |
| Image pixels with this color will not be drawn if they are chroma keyed. | |
| #define | LV_MEM_CUSTOM 0 |
| Memory allocation functions. | |
| #define | LV_MEM_SIZE (5U * 1024U) |
Size of the memory available for lv_mem_alloc() in bytes (>= 2kB) | |
| #define | LV_MEM_ADR 0 /* 0: unused */ |
| Set an address for the memory pool instead of allocating it as a normal array. | |
| #define | LV_MEM_BUF_MAX_NUM 16 |
| Number of the intermediate memory buffers. | |
| #define | LV_MEMCPY_MEMSET_STD 1 |
Use the standard memcpy and memset instead of LVGL's own functions. | |
| #define | LV_DISP_DEF_REFR_PERIOD 30 /* [ms] */ |
| Default display refresh period. | |
| #define | LV_INDEV_DEF_READ_PERIOD 30 /* [ms] */ |
| Input device read period in milliseconds. | |
| #define | LV_DPI_DEF 130 /* [px/inch] */ |
| Default Dot Per Inch. | |
| #define | LV_DRAW_COMPLEX 1 |
| Enable complex draw engine. | |
| #define | LV_IMG_CACHE_DEF_SIZE 0 |
| Default image cache size. | |
| #define | LV_GRADIENT_MAX_STOPS 2 |
| Number of stops allowed per gradient. | |
| #define | LV_GRAD_CACHE_DEF_SIZE 0 |
| Default gradient buffer size. | |
| #define | LV_DISP_ROT_MAX_BUF (10*1024) |
| Maximum buffer size to allocate for rotation. | |
| #define | LV_USE_GPU_STM32_DMA2D 0 |
| Use STM32's DMA2D (aka Chrom Art) GPU. | |
| #define | LV_USE_GPU_NXP_PXP 0 |
| Use NXP's PXP GPU iMX RTxxx platforms. | |
| #define | LV_USE_GPU_NXP_VG_LITE 0 |
| Use NXP's VG-Lite GPU iMX RTxxx platforms. | |
| #define | LV_USE_LOG 0 |
| Enable the log module. | |
| #define | LV_USE_ASSERT_NULL 0 |
| Enable asserts if an operation is failed or an invalid data is found. | |
| #define | LV_USE_ASSERT_MALLOC 0 |
| Checks is the memory is successfully allocated or no. | |
| #define | LV_USE_ASSERT_STYLE 0 |
| Check if the styles are properly initialized. | |
| #define | LV_USE_ASSERT_MEM_INTEGRITY 0 |
Check the integrity of lv_mem after critical operations. | |
| #define | LV_USE_ASSERT_OBJ 0 |
| Check the object's type and existence (e.g. | |
| #define | LV_ASSERT_HANDLER_INCLUDE <stdint.h> |
| Add a custom handler when assert happens e.g. | |
| #define | LV_ASSERT_HANDLER while (1) {}; |
| Halt by default. | |
| #define | LV_USE_PERF_MONITOR 0 |
| 1: Show CPU usage and FPS count in the right bottom corner | |
| #define | LV_USE_MEM_MONITOR 0 |
1: Show the used memory and the memory fragmentation in the left bottom corner Requires LV_MEM_CUSTOM = 0 | |
| #define | LV_USE_REFR_DEBUG 0 |
| 1: Draw random colored rectangles over the redrawn areas | |
| #define | LV_SPRINTF_CUSTOM 0 |
| Change the built in (v)snprintf functions. | |
| #define | LV_SPRINTF_USE_FLOAT 0 |
| Don't use float with sprintf. | |
| #define | LV_USE_USER_DATA 1 |
| enable custom user data in LVGL data field | |
| #define | LV_ENABLE_GC 0 |
| Garbage Collector settings. | |
| #define | LV_BIG_ENDIAN_SYSTEM 0 |
| For big endian systems set to 1. | |
| #define | LV_ATTRIBUTE_TICK_INC |
Define a custom attribute to the lv_tick_inc() function. | |
| #define | LV_ATTRIBUTE_TIMER_HANDLER |
Define a custom attribute to the lv_timer_handler() function. | |
| #define | LV_ATTRIBUTE_FLUSH_READY |
Define a custom attribute to the lv_disp_flush_ready() function. | |
| #define | LV_ATTRIBUTE_MEM_ALIGN_SIZE 1 |
| Required alignment size for buffers. | |
| #define | LV_ATTRIBUTE_LARGE_CONST |
| Attribute to mark large constant arrays for example font's bitmaps. | |
| #define | LV_ATTRIBUTE_LARGE_RAM_ARRAY |
| Compiler prefix for a big array declaration in RAM. | |
| #define | LV_ATTRIBUTE_FAST_MEM |
| Place performance critical functions into a faster memory (e.g RAM) | |
| #define | LV_ATTRIBUTE_DMA |
| Prefix variables used in GPU accelerated operations. | |
| #define | LV_EXPORT_CONST_INT(int_value) |
| Export integer constant to binding. | |
| #define | LV_USE_LARGE_COORD 0 |
| Extend the default -32k..32k coordinate range to -4M..4M by using int32_t for coordinates instead of int16_t. | |
| #define LV_ASSERT_HANDLER_INCLUDE <stdint.h> |
| #define LV_ATTRIBUTE_DMA |
| #define LV_ATTRIBUTE_FAST_MEM |
| #define LV_ATTRIBUTE_FLUSH_READY |
| #define LV_ATTRIBUTE_LARGE_CONST |
| #define LV_ATTRIBUTE_LARGE_RAM_ARRAY |
| #define LV_ATTRIBUTE_MEM_ALIGN_SIZE 1 |
| #define LV_ATTRIBUTE_TICK_INC |
| #define LV_ATTRIBUTE_TIMER_HANDLER |
| #define LV_BIG_ENDIAN_SYSTEM 0 |
| #define LV_COLOR_16_SWAP 0 |
| #define LV_COLOR_16_SWAP 0 |
| #define LV_COLOR_CHROMA_KEY lv_color_hex(0x00ff00) |
| #define LV_COLOR_DEPTH 16 |
| #define LV_COLOR_SCREEN_TRANSP 0 |
| #define LV_DISP_DEF_REFR_PERIOD 30 /* [ms] */ |
| #define LV_DISP_ROT_MAX_BUF (10*1024) |
| #define LV_DPI_DEF 130 /* [px/inch] */ |
| #define LV_DRAW_COMPLEX 1 |
| #define LV_ENABLE_GC 0 |
| #define LV_EXPORT_CONST_INT | ( | int_value | ) |
| #define LV_GRAD_CACHE_DEF_SIZE 0 |
Default gradient buffer size.
When LVGL calculates the gradient "maps" it can save them into a cache to avoid calculating them again. LV_GRAD_CACHE_DEF_SIZE sets the size of this cache in bytes. If the cache is too small the map will be allocated only while it's required for the drawing. Set to 0 to disable caching.
| #define LV_GRADIENT_MAX_STOPS 2 |
| #define LV_IMG_CACHE_DEF_SIZE 0 |
Default image cache size.
Image caching keeps the images opened. If only the built-in image formats are used there is no real advantage of caching (i.e. if no new image decoder is added). With complex image decoders (e.g. PNG or JPG) caching can save the continuous open/decode of images. However the opened images might consume additional RAM.
Set to 0 to disable caching.
| #define LV_INDEV_DEF_READ_PERIOD 30 /* [ms] */ |
| #define LV_MEM_ADR 0 /* 0: unused */ |
| #define LV_MEM_BUF_MAX_NUM 16 |
| #define LV_MEM_CUSTOM 0 |
| #define LV_MEM_SIZE (5U * 1024U) |
| #define LV_MEMCPY_MEMSET_STD 1 |
| #define LV_SPRINTF_CUSTOM 0 |
| #define LV_SPRINTF_USE_FLOAT 0 |
| #define LV_USE_ASSERT_MALLOC 0 |
| #define LV_USE_ASSERT_MEM_INTEGRITY 0 |
| #define LV_USE_ASSERT_NULL 0 |
| #define LV_USE_ASSERT_OBJ 0 |
| #define LV_USE_ASSERT_STYLE 0 |
| #define LV_USE_GPU_NXP_PXP 0 |
| #define LV_USE_GPU_NXP_VG_LITE 0 |
| #define LV_USE_GPU_STM32_DMA2D 0 |
| #define LV_USE_LARGE_COORD 0 |
| #define LV_USE_MEM_MONITOR 0 |
| #define LV_USE_PERF_MONITOR 0 |
| #define LV_USE_REFR_DEBUG 0 |
1.13.2