diff --git a/pkg/lvgl/Makefile b/pkg/lvgl/Makefile new file mode 100644 index 0000000000..d7c9eb7017 --- /dev/null +++ b/pkg/lvgl/Makefile @@ -0,0 +1,24 @@ +PKG_NAME=lvgl +PKG_URL=https://github.com/littlevgl/lvgl +PKG_VERSION=2ead4959038fcfd01eaee0f124b98a8ae3efec21 # v6.1.2 +PKG_LICENSE=MIT + +include $(RIOTBASE)/pkg/pkg.mk + +LVGL_MODULES = \ + lvgl_core \ + lvgl_draw \ + lvgl_font \ + lvgl_hal \ + lvgl_misc \ + lvgl_objx \ + lvgl_themes \ + # + +.PHONY: lvgl_% + +all: $(LVGL_MODULES) + "$(MAKE)" -C $(PKG_BUILDDIR) -f $(CURDIR)/Makefile.$(PKG_NAME) + +lvgl_%: + MODULE=$@ "$(MAKE)" -C $(PKG_BUILDDIR)/src/lv_$* -f $(CURDIR)/Makefile.lvgl_module diff --git a/pkg/lvgl/Makefile.dep b/pkg/lvgl/Makefile.dep new file mode 100644 index 0000000000..57c09af27b --- /dev/null +++ b/pkg/lvgl/Makefile.dep @@ -0,0 +1,19 @@ +USEMODULE += lvgl_core +USEMODULE += lvgl_draw +USEMODULE += lvgl_font +USEMODULE += lvgl_hal +USEMODULE += lvgl_misc +USEMODULE += lvgl_objx +USEMODULE += lvgl_themes + +ifneq (,$(filter lvgl_contrib,$(USEMODULE))) + USEMODULE += disp_dev + USEMODULE += core_thread_flags + USEMODULE += xtimer +endif + +# lvgl is not compatible with non 32bit platforms +# Building lv_misc triggers the error: +# "left shift count >= width of type [-Werror=shift-count-overflow]" +FEATURES_BLACKLIST += arch_8bit +FEATURES_BLACKLIST += arch_16bit diff --git a/pkg/lvgl/Makefile.include b/pkg/lvgl/Makefile.include new file mode 100644 index 0000000000..004f4b741d --- /dev/null +++ b/pkg/lvgl/Makefile.include @@ -0,0 +1,30 @@ +INCLUDES += -I$(RIOTBASE)/pkg/lvgl/include +INCLUDES += -I$(PKGDIRBASE) + +# Don't use relative includes in lvgl +CFLAGS += -DLV_CONF_INCLUDE_SIMPLE + +ifneq (,$(filter lvgl_contrib,$(USEMODULE))) + DIRS += $(RIOTBASE)/pkg/lvgl/contrib +endif + +# Configuration options +# Graphical settings +LVGL_COLOR_DEPTH ?= 16 +LVGL_COLOR_16_SWAP ?= 1 + +# Memory settings +LVGL_MEM_SIZE ?= 5U*1024U + +# Engine settings +LVGL_INACTIVITY_PERIOD_MS ?= 5*MS_PER_SEC # 5s +LVGL_TASK_HANDLER_DELAY_US ?= 5*US_PER_MS # 5ms +LVGL_TASK_THREAD_PRIO ?= THREAD_PRIORITY_MAIN-1 + +# Set the CFLAGS variable accordingly +CFLAGS += -DLV_COLOR_DEPTH=$(LVGL_COLOR_DEPTH) +CFLAGS += -DLV_COLOR_16_SWAP=$(LVGL_COLOR_16_SWAP) +CFLAGS += -DLV_MEM_SIZE=$(LVGL_MEM_SIZE) +CFLAGS += -DLVGL_INACTIVITY_PERIOD_MS=$(LVGL_INACTIVITY_PERIOD_MS) +CFLAGS += -DLVGL_TASK_HANDLER_DELAY_US=$(LVGL_TASK_HANDLER_DELAY_US) +CFLAGS += -DLVGL_TASK_THREAD_PRIO=$(LVGL_TASK_THREAD_PRIO) diff --git a/pkg/lvgl/Makefile.lvgl b/pkg/lvgl/Makefile.lvgl new file mode 100644 index 0000000000..90dc7499fd --- /dev/null +++ b/pkg/lvgl/Makefile.lvgl @@ -0,0 +1,5 @@ +MODULE = lvgl + +NO_AUTO_SRC = 1 + +include $(RIOTBASE)/Makefile.base diff --git a/pkg/lvgl/Makefile.lvgl_module b/pkg/lvgl/Makefile.lvgl_module new file mode 100644 index 0000000000..bd560e9722 --- /dev/null +++ b/pkg/lvgl/Makefile.lvgl_module @@ -0,0 +1,3 @@ +CFLAGS += -Wno-unused-parameter + +include $(RIOTBASE)/Makefile.base diff --git a/pkg/lvgl/contrib/Makefile b/pkg/lvgl/contrib/Makefile new file mode 100644 index 0000000000..d5fb241738 --- /dev/null +++ b/pkg/lvgl/contrib/Makefile @@ -0,0 +1,3 @@ +MODULE = lvgl_contrib + +include $(RIOTBASE)/Makefile.base diff --git a/pkg/lvgl/contrib/lvgl.c b/pkg/lvgl/contrib/lvgl.c new file mode 100644 index 0000000000..cf0a3b130c --- /dev/null +++ b/pkg/lvgl/contrib/lvgl.c @@ -0,0 +1,121 @@ +/* + * Copyright (C) 2019 Inria + * + * This file is subject to the terms and conditions of the GNU Lesser + * General Public License v2.1. See the file LICENSE in the top level + * directory for more details. + */ + +/** + * @ingroup pkg_lvgl + * @{ + * + * @file + * @brief LittlevGL glue code + * + * @author Alexandre Abadie + * @} + */ + +#include "thread.h" + +#include "xtimer.h" +#include "log.h" + +#include "lvgl/lvgl.h" +#include "lv_conf.h" +#include "lvgl_riot.h" +#include "disp_dev.h" + +#ifndef LVGL_TASK_THREAD_PRIO +#define LVGL_TASK_THREAD_PRIO (THREAD_PRIORITY_MAIN + 1) +#endif + +#ifndef LVGL_COLOR_BUF_SIZE +#define LVGL_COLOR_BUF_SIZE (LV_HOR_RES_MAX * 5) +#endif + +#ifndef LVGL_INACTIVITY_PERIOD_MS +#define LVGL_INACTIVITY_PERIOD_MS (1 * MS_PER_SEC) /* 1s */ +#endif + +#ifndef LVGL_TASK_HANDLER_DELAY_US +#define LVGL_TASK_HANDLER_DELAY_US (5 * US_PER_MS) /* 5ms */ +#endif + +#ifndef LVGL_THREAD_FLAG +#define LVGL_THREAD_FLAG (1 << 7) +#endif + +static char _task_thread_stack[THREAD_STACKSIZE_LARGE]; +static kernel_pid_t _task_thread_pid; + +static lv_disp_buf_t disp_buf; +static lv_color_t buf[LVGL_COLOR_BUF_SIZE]; +static disp_dev_t *_dev = NULL; + +static void *_task_thread(void *arg) +{ + (void)arg; + + while (1) { + /* Normal operation (no sleep) in < LVGL_INACTIVITY_PERIOD_MS msec + inactivity */ + if (lv_disp_get_inactive_time(NULL) < LVGL_INACTIVITY_PERIOD_MS) { + lv_task_handler(); + } + else { + /* Block after LVGL_ACTIVITY_PERIOD msec inactivity */ + thread_flags_wait_one(LVGL_THREAD_FLAG); + + /* trigger an activity so the task handler is called on the next loop */ + lv_disp_trig_activity(NULL); + } + + xtimer_usleep(LVGL_TASK_HANDLER_DELAY_US); + } + + return NULL; +} + +static void _disp_map(lv_disp_drv_t *drv, const lv_area_t *area, lv_color_t *color_p) +{ + if (!_dev) { + return; + } + + disp_dev_map(_dev, area->x1, area->x2, area->y1, area->y2, + (const uint16_t *)color_p); + + LOG_DEBUG("[lvgl] flush display\n"); + + lv_disp_flush_ready(drv); +} + +void lvgl_init(disp_dev_t *dev) +{ + _dev = dev; + lv_init(); + lv_disp_drv_t disp_drv; + lv_disp_drv_init(&disp_drv); + /* Configure horizontal and vertical resolutions based on the + underlying display device parameters */ + disp_drv.hor_res = disp_dev_width(dev); + disp_drv.ver_res = disp_dev_height(dev); + + disp_drv.flush_cb = _disp_map; + disp_drv.buffer = &disp_buf; + lv_disp_drv_register(&disp_drv); + lv_disp_buf_init(&disp_buf, buf, NULL, LVGL_COLOR_BUF_SIZE); + + lv_task_handler(); + _task_thread_pid = thread_create(_task_thread_stack, sizeof(_task_thread_stack), + LVGL_TASK_THREAD_PRIO, THREAD_CREATE_STACKTEST, + _task_thread, NULL, "_task_thread"); +} + +void lvgl_wakeup(void) +{ + thread_t *tcb = (thread_t *)sched_threads[_task_thread_pid]; + thread_flags_set(tcb, LVGL_THREAD_FLAG); +} diff --git a/pkg/lvgl/doc.txt b/pkg/lvgl/doc.txt new file mode 100644 index 0000000000..1ecfe38607 --- /dev/null +++ b/pkg/lvgl/doc.txt @@ -0,0 +1,41 @@ +/** +@defgroup pkg_lvgl LittlevGL - Open-Source Embedded GUI Library +@ingroup pkg +@brief LittlevGL package for RIOT + +@see https://github.com/littlevgl/lvgl + +## Configuration options + +The package can be configured with using several variables. These variables can +either be passed directly to build command line or set in the application +Makefile. + +### Graphical settings + +- `LVGL_COLOR_DEPTH`: configure the color depth in bit of the screen (default: 16) +- `LVGL_COLOR_16_SWAP`: enable byte swap when communicating with the screen + driver (default: 1, enabled) + +### Memory settings + +`LVGL_MEM_SIZE`: configure the maximum memory size used by lvgl. This depends +on the number of lvgl widgets and objects used by the interface (default: +5U*1024U, 5KiB). Must be greater than 2KiB. + +### Engine settings + +- `LVGL_INACTIVITY_PERIOD_MS`: maximum inactivity period before going to sleep in ms. + (default: 1s) +- `LVGL_TASK_HANDLER_DELAY_US`: delay between lvgl task handle call in ms. + (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: + +``` +LVGL_ACTIVITY_PERIOD=5000 make -C tests/pkg_lvgl +``` + + */ diff --git a/pkg/lvgl/include/lv_conf.h b/pkg/lvgl/include/lv_conf.h new file mode 100644 index 0000000000..3eac65a5b2 --- /dev/null +++ b/pkg/lvgl/include/lv_conf.h @@ -0,0 +1,599 @@ +/* + * Copyright (C) 2019 Inria + * + * This file is subject to the terms and conditions of the GNU Lesser + * General Public License v2.1. See the file LICENSE in the top level + * directory for more details. + */ + +/** + * @ingroup pkg_lvgl + * @brief LittlevGL configuration macros + * @{ + * + * @author Alexandre Abadie + */ + +#ifndef LV_CONF_H +#define LV_CONF_H + +#ifdef __cplusplus +extern "C" { +#endif + +#include + +/*==================== + Graphical settings + *====================*/ + +/* Maximal horizontal and vertical resolution to support by the library.*/ +#ifndef LV_HOR_RES_MAX +#define LV_HOR_RES_MAX (320) +#endif + +#ifndef LV_VER_RES_MAX +#define LV_VER_RES_MAX (240) +#endif + +/* Color depth: + * - 1: 1 byte per pixel + * - 8: RGB233 + * - 16: RGB565 + * - 32: ARGB8888 + */ +#ifndef LV_COLOR_DEPTH +#define LV_COLOR_DEPTH 16 +#endif + +/* Swap the 2 bytes of RGB565 color. + * Useful if the display has a 8 bit interface (e.g. SPI)*/ +#ifndef LV_COLOR_16_SWAP +#define LV_COLOR_16_SWAP 1 +#endif + +/* 1: Enable screen transparency. + * Useful for OSD or other overlapping GUIs. + * Requires `LV_COLOR_DEPTH = 32` colors and the screen's style should be modified: `style.body.opa = ...`*/ +#define LV_COLOR_SCREEN_TRANSP 0 + +/*Images pixels with this color will not be drawn (with chroma keying)*/ +#define LV_COLOR_TRANSP LV_COLOR_LIME /*LV_COLOR_LIME: pure green*/ + +/* Enable chroma keying for indexed images. */ +#define LV_INDEXED_CHROMA 1 + +/* Enable anti-aliasing (lines, and radiuses will be smoothed) */ +#define LV_ANTIALIAS 1 + +/* Default display refresh period. + * Can be changed in the display driver (`lv_disp_drv_t`).*/ +#define LV_DISP_DEF_REFR_PERIOD 10 /*[ms]*/ + +/* Dot Per Inch: used to initialize default sizes. + * E.g. a button with width = LV_DPI / 2 -> half inch wide + * (Not so important, you can adjust it to modify default sizes and spaces)*/ +#define LV_DPI 100 /*[px]*/ + +/* Type of coordinates. Should be `int16_t` (or `int32_t` for extreme cases) */ +typedef int16_t lv_coord_t; + +/*========================= + Memory manager settings + *=========================*/ + +/* LittelvGL's internal memory manager's settings. + * The graphical objects and other related data are stored here. */ + +/* 1: use custom malloc/free, 0: use the built-in `lv_mem_alloc` and `lv_mem_free` */ +#define LV_MEM_CUSTOM 0 +#if LV_MEM_CUSTOM == 0 +/* Size of the memory used by `lv_mem_alloc` in bytes (>= 2kB)*/ +#ifndef LV_MEM_SIZE +#define LV_MEM_SIZE (5U * 1024U) +#endif + +/* Compiler prefix for a big array declaration */ +#define LV_MEM_ATTR + +/* Set an address for the memory pool instead of allocating it as an array. + * Can be in external SRAM too. */ +#define LV_MEM_ADR 0 + +/* Automatically defrag. on free. Defrag. means joining the adjacent free cells. */ +#define LV_MEM_AUTO_DEFRAG 1 +#else /*LV_MEM_CUSTOM*/ +#define LV_MEM_CUSTOM_INCLUDE /*Header for the dynamic memory function*/ +#define LV_MEM_CUSTOM_ALLOC malloc /*Wrapper to malloc*/ +#define LV_MEM_CUSTOM_FREE free /*Wrapper to free*/ +#endif /*LV_MEM_CUSTOM*/ + +/* Garbage Collector settings + * Used if lvgl is binded to higher level language and the memory is managed by that language */ +#define LV_ENABLE_GC 0 +#if LV_ENABLE_GC != 0 +#define LV_GC_INCLUDE "gc.h" /*Include Garbage Collector related things*/ +#define LV_MEM_CUSTOM_REALLOC your_realloc /*Wrapper to realloc*/ +#define LV_MEM_CUSTOM_GET_SIZE your_mem_get_size /*Wrapper to lv_mem_get_size*/ +#endif /* LV_ENABLE_GC */ + +/*======================= + Input device settings + *=======================*/ + +/* Input device default settings. + * Can be changed in the Input device driver (`lv_indev_drv_t`)*/ + +/* Input device read period in milliseconds */ +#define LV_INDEV_DEF_READ_PERIOD 30 + +/* Drag threshold in pixels */ +#define LV_INDEV_DEF_DRAG_LIMIT 10 + +/* Drag throw slow-down in [%]. Greater value -> faster slow-down */ +#define LV_INDEV_DEF_DRAG_THROW 20 + +/* Long press time in milliseconds. + * Time to send `LV_EVENT_LONG_PRESSSED`) */ +#define LV_INDEV_DEF_LONG_PRESS_TIME 400 + +/* Repeated trigger period in long press [ms] + * Time between `LV_EVENT_LONG_PRESSED_REPEAT */ +#define LV_INDEV_DEF_LONG_PRESS_REP_TIME 100 + +/*================== + * Feature usage + *==================*/ + +/*1: Enable the Animations */ +#define LV_USE_ANIMATION 1 +#if LV_USE_ANIMATION + +/*Declare the type of the user data of animations (can be e.g. `void *`, `int`, `struct`)*/ +typedef void * lv_anim_user_data_t; +#endif + +/* 1: Enable shadow drawing*/ +#define LV_USE_SHADOW 1 + +/* 1: Enable object groups (for keyboard/encoder navigation) */ +#define LV_USE_GROUP 1 +#if LV_USE_GROUP +typedef void * lv_group_user_data_t; +#endif /*LV_USE_GROUP*/ + +/* 1: Enable GPU interface*/ +#define LV_USE_GPU 0 + +/* 1: Enable file system (might be required for images */ +#define LV_USE_FILESYSTEM 0 +#if LV_USE_FILESYSTEM +/*Declare the type of the user data of file system drivers (can be e.g. `void *`, `int`, `struct`)*/ +typedef void * lv_fs_drv_user_data_t; +#endif + +/*1: Add a `user_data` to drivers and objects*/ +#define LV_USE_USER_DATA 0 + +/*======================== + * Image decoder and cache + *========================*/ + +/* 1: Enable indexed (palette) images */ +#define LV_IMG_CF_INDEXED 1 + +/* 1: Enable alpha indexed images */ +#define LV_IMG_CF_ALPHA 1 + +/* 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. 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. + * LV_IMG_CACHE_DEF_SIZE must be >= 1 */ +#define LV_IMG_CACHE_DEF_SIZE 1 + +/*Declare the type of the user data of image decoder (can be e.g. `void *`, `int`, `struct`)*/ +typedef void * lv_img_decoder_user_data_t; + +/*===================== + * Compiler settings + *====================*/ +/* Define a custom attribute to `lv_tick_inc` function */ +#define LV_ATTRIBUTE_TICK_INC + +/* Define a custom attribute to `lv_task_handler` function */ +#define LV_ATTRIBUTE_TASK_HANDLER + +/* With size optimization (-Os) the compiler might not align data to + * 4 or 8 byte boundary. This alignment will be explicitly applied where needed. + * E.g. __attribute__((aligned(4))) */ +#define LV_ATTRIBUTE_MEM_ALIGN + +/* Attribute to mark large constant arrays for example + * font's bitmaps */ +#define LV_ATTRIBUTE_LARGE_CONST + +/* Export integer constant to binding. + * This macro is used with constants in the form of LV_ that + * should also appear on lvgl binding API such as Micropython + * + * The default value just prevents a GCC warning. + */ +#define LV_EXPORT_CONST_INT(int_value) struct _silence_gcc_warning + +/*=================== + * HAL settings + *==================*/ + +/* 1: use a custom tick source. + * It removes the need to manually update the tick with `lv_tick_inc`) */ +#define LV_TICK_CUSTOM 1 +#if LV_TICK_CUSTOM == 1 +#define LV_TICK_CUSTOM_INCLUDE "xtimer.h" /*Header for the sys time function*/ +#define LV_TICK_CUSTOM_SYS_TIME_EXPR (xtimer_now_usec() / US_PER_MS) /*Expression evaluating to current systime in ms*/ +#endif /*LV_TICK_CUSTOM*/ + +typedef void * lv_disp_drv_user_data_t; /*Type of user data in the display driver*/ +typedef void * lv_indev_drv_user_data_t; /*Type of user data in the input device driver*/ + +/*================ + * Log settings + *===============*/ + +/*1: Enable the log module*/ +#define LV_USE_LOG 0 +#if LV_USE_LOG +/* How important log should be added: + * LV_LOG_LEVEL_TRACE A lot of logs to give detailed information + * LV_LOG_LEVEL_INFO Log important events + * LV_LOG_LEVEL_WARN Log if something unwanted happened but didn't cause a problem + * LV_LOG_LEVEL_ERROR Only critical issue, when the system may fail + * LV_LOG_LEVEL_NONE Do not log anything + */ +#define LV_LOG_LEVEL LV_LOG_LEVEL_WARN + +/* 1: Print the log with 'printf'; + * 0: user need to register a callback with `lv_log_register_print_cb`*/ +#define LV_LOG_PRINTF 0 +#endif /*LV_USE_LOG*/ + +/*================= + * Debug settings + *================*/ + +/* If Debug is enabled LittelvGL validates the parameters of the functions. + * If an invalid parameter is found an error log message is printed and + * the MCU halts at the error. (`LV_USE_LOG` should be enabled) + * If you are debugging the MCU you can pause + * the debugger to see exactly where the issue is. + * + * The behavior of asserts can be overwritten by redefining them here. + * E.g. #define LV_ASSERT_MEM(p) + */ +#define LV_USE_DEBUG 0 +#if LV_USE_DEBUG + +/*Check if the parameter is NULL. (Quite fast) */ +#define LV_USE_ASSERT_NULL 1 + +/*Checks is the memory is successfully allocated or no. (Quite fast)*/ +#define LV_USE_ASSERT_MEM 1 + +/* Check the strings. + * Search for NULL, very long strings, invalid characters, and unnatural repetitions. (Slow) + * If disabled `LV_USE_ASSERT_NULL` will be performed instead (if it's enabled) */ +#define LV_USE_ASSERT_STR 0 + +/* Check NULL, the object's type and existence (e.g. not deleted). (Quite slow) + * If disabled `LV_USE_ASSERT_NULL` will be performed instead (if it's enabled) */ +#define LV_USE_ASSERT_OBJ 0 + +/*Check if the styles are properly initialized. (Fast)*/ +#define LV_USE_ASSERT_STYLE 1 + +#endif /*LV_USE_DEBUG*/ + +/*================ + * THEME USAGE + *================*/ +#define LV_THEME_LIVE_UPDATE 0 /*1: Allow theme switching at run time. Uses 8..10 kB of RAM*/ + +#define LV_USE_THEME_TEMPL 0 /*Just for test*/ +#define LV_USE_THEME_DEFAULT 0 /*Built mainly from the built-in styles. Consumes very few RAM*/ +#define LV_USE_THEME_ALIEN 0 /*Dark futuristic theme*/ +#define LV_USE_THEME_NIGHT 0 /*Dark elegant theme*/ +#define LV_USE_THEME_MONO 0 /*Mono color theme for monochrome displays*/ +#define LV_USE_THEME_MATERIAL 0 /*Flat theme with bold colors and light shadows*/ +#define LV_USE_THEME_ZEN 0 /*Peaceful, mainly light theme */ +#define LV_USE_THEME_NEMO 0 /*Water-like theme based on the movie "Finding Nemo"*/ + +/*================== + * FONT USAGE + *===================*/ + +/* The built-in fonts contains the ASCII range and some Symbols with 4 bit-per-pixel. + * The symbols are available via `LV_SYMBOL_...` defines + * More info about fonts: https://docs.littlevgl.com/#Fonts + * To create a new font go to: https://littlevgl.com/ttf-font-to-c-array + */ + +/* Robot fonts with bpp = 4 + * https://fonts.google.com/specimen/Roboto */ +#define LV_FONT_ROBOTO_12 0 +#define LV_FONT_ROBOTO_16 1 +#define LV_FONT_ROBOTO_22 0 +#define LV_FONT_ROBOTO_28 0 + +/* Demonstrate special features */ +#define LV_FONT_ROBOTO_12_SUBPX 1 +#define LV_FONT_ROBOTO_28_COMPRESSED 1 /*bpp = 3*/ + +/*Pixel perfect monospace font + * http://pelulamu.net/unscii/ */ +#define LV_FONT_UNSCII_8 0 + +/* Optionally declare your custom fonts here. + * You can use these fonts as default font too + * and they will be available globally. E.g. + * #define LV_FONT_CUSTOM_DECLARE LV_FONT_DECLARE(my_font_1) \ + * LV_FONT_DECLARE(my_font_2) + */ +#define LV_FONT_CUSTOM_DECLARE + +/*Always set a default font from the built-in fonts*/ +#define LV_FONT_DEFAULT &lv_font_roboto_16 + +/* Enable it if you have fonts with a lot of characters. + * The limit depends on the font size, font face and bpp + * but with > 10,000 characters if you see issues probably you need to enable it.*/ +#define LV_FONT_FMT_TXT_LARGE 0 + +/* Set the pixel order of the display. + * Important only if "subpx fonts" are used. + * With "normal" font it doesn't matter. + */ +#define LV_FONT_SUBPX_BGR 0 + +/*Declare the type of the user data of fonts (can be e.g. `void *`, `int`, `struct`)*/ +typedef void * lv_font_user_data_t; + +/*================= + * Text settings + *=================*/ + +/* Select a character encoding for strings. + * Your IDE or editor should have the same character encoding + * - LV_TXT_ENC_UTF8 + * - LV_TXT_ENC_ASCII + * */ +#define LV_TXT_ENC LV_TXT_ENC_UTF8 + + /*Can break (wrap) texts on these chars*/ +#define LV_TXT_BREAK_CHARS " ,.;:-_" + +/* If a word is at least this long, will break wherever "prettiest" + * To disable, set to a value <= 0 */ +#define LV_TXT_LINE_BREAK_LONG_LEN 12 + +/* Minimum number of characters in a long word to put on a line before a break. + * Depends on LV_TXT_LINE_BREAK_LONG_LEN. */ +#define LV_TXT_LINE_BREAK_LONG_PRE_MIN_LEN 3 + +/* Minimum number of characters in a long word to put on a line after a break. + * Depends on LV_TXT_LINE_BREAK_LONG_LEN. */ +#define LV_TXT_LINE_BREAK_LONG_POST_MIN_LEN 3 + +/* The control character to use for signalling text recoloring. */ +#define LV_TXT_COLOR_CMD "#" + +/* Support bidirectional texts. + * Allows mixing Left-to-Right and Right-to-Left texts. + * The direction will be processed according to the Unicode Bidirectioanl Algorithm: + * https://www.w3.org/International/articles/inline-bidi-markup/uba-basics*/ +#define LV_USE_BIDI 0 +#if LV_USE_BIDI +/* Set the default direction. Supported values: + * `LV_BIDI_DIR_LTR` Left-to-Right + * `LV_BIDI_DIR_RTL` Right-to-Left + * `LV_BIDI_DIR_AUTO` detect texts base direction */ +#define LV_BIDI_BASE_DIR_DEF LV_BIDI_DIR_AUTO +#endif + +/*Change the built in (v)snprintf functions*/ +#define LV_SPRINTF_CUSTOM 0 +#if LV_SPRINTF_CUSTOM +#define LV_SPRINTF_INCLUDE +#define lv_snprintf snprintf +#define lv_vsnprintf vsnprintf +#endif /*LV_SPRINTF_CUSTOM*/ + +/*=================== + * LV_OBJ SETTINGS + *==================*/ + +/*Declare the type of the user data of object (can be e.g. `void *`, `int`, `struct`)*/ +typedef void * lv_obj_user_data_t; + +/*1: enable `lv_obj_realaign()` based on `lv_obj_align()` parameters*/ +#define LV_USE_OBJ_REALIGN 1 + +/* Enable to make the object clickable on a larger area. + * LV_EXT_CLICK_AREA_OFF or 0: Disable this feature + * LV_EXT_CLICK_AREA_TINY: The extra area can be adjusted horizontally and vertically (0..255 px) + * LV_EXT_CLICK_AREA_FULL: The extra area can be adjusted in all 4 directions (-32k..+32k px) + */ +#define LV_USE_EXT_CLICK_AREA LV_EXT_CLICK_AREA_OFF + +/*================== + * LV OBJ X USAGE + *================*/ +/* + * Documentation of the object types: https://docs.littlevgl.com/#Object-types + */ + +/*Arc (dependencies: -)*/ +#define LV_USE_ARC 1 + +/*Bar (dependencies: -)*/ +#define LV_USE_BAR 1 + +/*Button (dependencies: lv_cont*/ +#define LV_USE_BTN 1 +#if LV_USE_BTN != 0 +/*Enable button-state animations - draw a circle on click (dependencies: LV_USE_ANIMATION)*/ +#define LV_BTN_INK_EFFECT 0 +#endif + +/*Button matrix (dependencies: -)*/ +#define LV_USE_BTNM 1 + +/*Calendar (dependencies: -)*/ +#define LV_USE_CALENDAR 1 + +/*Canvas (dependencies: lv_img)*/ +#define LV_USE_CANVAS 1 + +/*Check box (dependencies: lv_btn, lv_label)*/ +#define LV_USE_CB 1 + +/*Chart (dependencies: -)*/ +#define LV_USE_CHART 1 +#if LV_USE_CHART +#define LV_CHART_AXIS_TICK_LABEL_MAX_LEN 20 +#endif + +/*Container (dependencies: -*/ +#define LV_USE_CONT 1 + +/*Color picker (dependencies: -*/ +#define LV_USE_CPICKER 1 + +/*Drop down list (dependencies: lv_page, lv_label, lv_symbol_def.h)*/ +#define LV_USE_DDLIST 1 +#if LV_USE_DDLIST != 0 +/*Open and close default animation time [ms] (0: no animation)*/ +#define LV_DDLIST_DEF_ANIM_TIME 200 +#endif + +/*Gauge (dependencies:lv_bar, lv_lmeter)*/ +#define LV_USE_GAUGE 1 + +/*Image (dependencies: lv_label*/ +#define LV_USE_IMG 1 + +/*Image Button (dependencies: lv_btn*/ +#define LV_USE_IMGBTN 1 +#if LV_USE_IMGBTN +/*1: The imgbtn requires left, mid and right parts and the width can be set freely*/ +#define LV_IMGBTN_TILED 0 +#endif + +/*Keyboard (dependencies: lv_btnm)*/ +#define LV_USE_KB 1 + +/*Label (dependencies: -*/ +#define LV_USE_LABEL 1 +#if LV_USE_LABEL != 0 +/*Hor, or ver. scroll speed [px/sec] in 'LV_LABEL_LONG_ROLL/ROLL_CIRC' mode*/ +#define LV_LABEL_DEF_SCROLL_SPEED 25 + +/* Waiting period at beginning/end of animation cycle */ +#define LV_LABEL_WAIT_CHAR_COUNT 3 + +/*Enable selecting text of the label */ +#define LV_LABEL_TEXT_SEL 0 + +/*Store extra some info in labels (12 bytes) to speed up drawing of very long texts*/ +#define LV_LABEL_LONG_TXT_HINT 0 +#endif + +/*LED (dependencies: -)*/ +#define LV_USE_LED 1 + +/*Line (dependencies: -*/ +#define LV_USE_LINE 1 + +/*List (dependencies: lv_page, lv_btn, lv_label, (lv_img optionally for icons ))*/ +#define LV_USE_LIST 1 +#if LV_USE_LIST != 0 +/*Default animation time of focusing to a list element [ms] (0: no animation) */ +#define LV_LIST_DEF_ANIM_TIME 100 +#endif + +/*Line meter (dependencies: *;)*/ +#define LV_USE_LMETER 1 + +/*Message box (dependencies: lv_rect, lv_btnm, lv_label)*/ +#define LV_USE_MBOX 1 + +/*Page (dependencies: lv_cont)*/ +#define LV_USE_PAGE 1 +#if LV_USE_PAGE != 0 +/*Focus default animation time [ms] (0: no animation)*/ +#define LV_PAGE_DEF_ANIM_TIME 400 +#endif + +/*Preload (dependencies: lv_arc, lv_anim)*/ +#define LV_USE_PRELOAD 1 +#if LV_USE_PRELOAD != 0 +#define LV_PRELOAD_DEF_ARC_LENGTH 60 /*[deg]*/ +#define LV_PRELOAD_DEF_SPIN_TIME 1000 /*[ms]*/ +#define LV_PRELOAD_DEF_ANIM LV_PRELOAD_TYPE_SPINNING_ARC +#endif + +/*Roller (dependencies: lv_ddlist)*/ +#define LV_USE_ROLLER 1 +#if LV_USE_ROLLER != 0 +/*Focus animation time [ms] (0: no animation)*/ +#define LV_ROLLER_DEF_ANIM_TIME 200 + +/*Number of extra "pages" when the roller is infinite*/ +#define LV_ROLLER_INF_PAGES 7 +#endif + +/*Slider (dependencies: lv_bar)*/ +#define LV_USE_SLIDER 1 + +/*Spinbox (dependencies: lv_ta)*/ +#define LV_USE_SPINBOX 1 + +/*Switch (dependencies: lv_slider)*/ +#define LV_USE_SW 1 + +/*Text area (dependencies: lv_label, lv_page)*/ +#define LV_USE_TA 1 +#if LV_USE_TA != 0 +#define LV_TA_DEF_CURSOR_BLINK_TIME 400 /*ms*/ +#define LV_TA_DEF_PWD_SHOW_TIME 1500 /*ms*/ +#endif + +/*Table (dependencies: lv_label)*/ +#define LV_USE_TABLE 1 +#if LV_USE_TABLE +#define LV_TABLE_COL_MAX 12 +#endif + +/*Tab (dependencies: lv_page, lv_btnm)*/ +#define LV_USE_TABVIEW 1 +#if LV_USE_TABVIEW != 0 +/*Time of slide animation [ms] (0: no animation)*/ +#define LV_TABVIEW_DEF_ANIM_TIME 300 +#endif + +/*Tileview (dependencies: lv_page) */ +#define LV_USE_TILEVIEW 1 +#if LV_USE_TILEVIEW +/*Time of slide animation [ms] (0: no animation)*/ +#define LV_TILEVIEW_DEF_ANIM_TIME 300 +#endif + +/*Window (dependencies: lv_cont, lv_btn, lv_label, lv_img, lv_page)*/ +#define LV_USE_WIN 1 + +#ifdef __cplusplus +} +#endif + +#endif /* LV_CONF_H */ +/** @} */ diff --git a/pkg/lvgl/include/lvgl_riot.h b/pkg/lvgl/include/lvgl_riot.h new file mode 100644 index 0000000000..631156ae19 --- /dev/null +++ b/pkg/lvgl/include/lvgl_riot.h @@ -0,0 +1,48 @@ +/* + * Copyright (C) 2019 Inria + * + * This file is subject to the terms and conditions of the GNU Lesser + * General Public License v2.1. See the file LICENSE in the top level + * directory for more details. + */ + +/** + * @ingroup pkg_lvgl + * @{ + * + * @file + * @brief Definition for the LittlevGL engine initialization + * + * @author Alexandre Abadie + */ + +#ifndef LVGL_RIOT_H +#define LVGL_RIOT_H + +#include "disp_dev.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * @brief Initialize the lvgl display engine + * + * @param[in] dev Pointer to the generic display device + */ +void lvgl_init(disp_dev_t *dev); + +/** + * @brief Wakeup lvgl when inactive + * + * This function unblocks the lvgl task handler thread and will indirectly + * trigger an activity. After calling this function, lvgl remains awake during + * the next LVGL_INACTIVITY_PERIOD_MS ms. + */ +void lvgl_wakeup(void); + +#ifdef __cplusplus +} +#endif + +#endif /* LVGL_RIOT_H */