LVGL 在 GRUB2 上的移植
本帖最后由 wintoflash 于 2022-10-1 13:39 编辑效果测试：
1. 前言
LVGL 是一个适用于嵌入式设备的轻量级通用型图形库。
它使用纯 C 语言编写，无任何依赖，支持鼠标/键盘/触摸板等输入设备，支持 UTF-8，比较适合移植到 GRUB2 上。
本文用于记录我尝试移植 LVGL 改造 GRUB2 图形界面的过程，仅供参考，目前尚未完工。
目前我使用的 LVGL 版本是 v8.3，GRUB2 是 2.11-git-d9b4638，编译器是 GCC 12。
参考资料：
[*]LVGL 官方文档
[*]TFT and touch pad drivers for LVGL
[*]UEFI开发学习8 – LVGL GUI库的移植
[*]GRUB2 开发者手册
本帖最后由 wintoflash 于 2022-10-1 13:38 编辑
2. 改造 GRUB2 posix_wrap 库
修改 grub-core/lib/posix_wrap/sys/types.h，添加以下内容：
typedef grub_uint64_t uintmax_t;
typedef grub_int64_t intmax_t;
修改 grub-core/lib/posix_wrap/limits.h，添加以下内容：
#define INT8_MIN GRUB_SCHAR_MIN
#define INT8_MAX GRUB_SCHAR_MAX
#define INT16_MIN GRUB_SHRT_MIN
#define INT16_MAX GRUB_SHRT_MAX
#define INT32_MIN GRUB_INT32_MIN
#define INT32_MAX GRUB_INT32_MAX
#define UINT8_MAX GRUB_UCHAR_MAX
#define UINT16_MAX GRUB_USHRT_MAX
#define UINT32_MAX GRUB_UINT_MAX
修改 grub-core/lib/posix_wrap/inttypes.h：
#ifndef GRUB_POSIX_INTTYPES_H
#define GRUB_POSIX_INTTYPES_H
#include <sys/types.h>
#define PRId32 PRIdGRUB_INT32_T
#define PRIu32 PRIuGRUB_UINT32_T
#define PRIx32 PRIxGRUB_UINT32_T
#define PRId64 PRIdGRUB_INT64_T
#define PRIu64 PRIdGRUB_UINT64_T
#define PRIx64 PRIdGRUB_UINT64_T
#endif
修改 grub-core/lib/posix_wrap/stdint.h，添加以下内容：
#include <limits.h>
修改 grub-core/lib/posix_wrap/string.h， 添加以下函数：
static inline int
strncmp (const char *s1, const char *s2, grub_size_t n)
{
return grub_strncmp (s1, s2, n);
}
static inline char *
strcat (char *dest, const char *src)
{
grub_strcpy (dest + grub_strlen (dest), src);
return dest;
}
3. 修改 GRUB2 compiler-rt
由于 LVGL 中使用到了 64 位整数除法，因此要在 i386 架构下添加 __udivmoddi4 和 __divmoddi4 这两个符号。
修改 include/grub/misc.h：
#if !defined(GRUB_MACHINE_EMU) && (defined(__arm__) || defined(__ia64__) || \
(defined(__riscv) && (__riscv_xlen == 32)))
#define GRUB_DIVISION_IN_SOFTWARE 1
改为
#if !defined(GRUB_MACHINE_EMU) && (defined(__arm__) || defined(__ia64__) || \
defined(__i386__) || (defined(__riscv) && (__riscv_xlen == 32)))
#define GRUB_DIVISION_IN_SOFTWARE 1
修改 gentpl.py：
GROUPS["softdiv"] = GROUPS["arm"] + ["ia64_efi"] + GROUPS["riscv32"]
改为
GROUPS["softdiv"] = GROUPS["arm"] + ["ia64_efi"] + GROUPS["i386"] + GROUPS["riscv32"]
修改 include/grub/compiler-rt.h，在 #if defined(GRUB_DIVISION_IN_SOFTWARE) && GRUB_DIVISION_IN_SOFTWARE 条件里面加入
grub_uint64_t
EXPORT_FUNC (__udivmoddi4) (grub_uint64_t n, grub_uint64_t d, grub_uint64_t *r);
grub_int64_t
EXPORT_FUNC(__divmoddi4) (grub_int64_t n, grub_int64_t d, grub_int64_t *r);
修改 grub-core/kern/compiler-rt.c，在对应条件下加入
grub_uint64_t
__udivmoddi4 (grub_uint64_t n, grub_uint64_t d, grub_uint64_t *r)
{
return grub_divmod64 (n, d, r);
}
grub_int64_t
__divmoddi4 (grub_int64_t n, grub_int64_t d, grub_int64_t *r)
{
return grub_divmod64s (n, d, r);
}
本帖最后由 wintoflash 于 2022-10-1 13:37 编辑
4. 导入 LVGL 源码
在 grub-core 下建立 lvgl 文件夹
将 LVGL 源码目录下的 src 目录复制到 grub-core/lvgl/
将 LVGL 源码目录下的 lvgl.h 复制到 grub-core/lvgl/lvgl.h
创建文件夹 grub-core/lvgl/port
将 LVGL 源码目录下的 lv_conf_template.h 复制到 grub-core/lvgl/port/lv_conf.h
创建文件 grub-core/lvgl/port/module.c
#include <grub/dl.h>
GRUB_MOD_LICENSE ("GPLv3+");
修改 conf/Makefile.common，添加
CFLAGS_LVGL = -Wno-discarded-qualifiers -Wno-redundant-decls -Wno-nested-externs -Wno-suggest-attribute=format -Wno-shadow -Wno-incompatible-pointer-types $(CFLAGS_POSIX)
CPPFLAGS_LVGL = -I$(top_builddir)/grub-core/lvgl/port -DLV_CONF_INCLUDE_SIMPLE $(CPPFLAGS_POSIX)
CFLAGS_LVGLAPP = $(CFLAGS_POSIX)
CPPFLAGS_LVGLAPP = $(CPPFLAGS_LVGL) -I$(top_builddir)/grub-core/lvgl
修改 grub-core/Makefile.core.def，添加
module = {
name = lvgl;
common = lvgl/port/module.c;
common = lvgl/src/core/lv_disp.c;
common = lvgl/src/core/lv_group.c;
common = lvgl/src/core/lv_indev.c;
common = lvgl/src/core/lv_indev_scroll.c;
common = lvgl/src/core/lv_obj.c;
common = lvgl/src/core/lv_obj_class.c;
common = lvgl/src/core/lv_obj_draw.c;
common = lvgl/src/core/lv_obj_pos.c;
common = lvgl/src/core/lv_obj_scroll.c;
common = lvgl/src/core/lv_obj_style.c;
common = lvgl/src/core/lv_obj_style_gen.c;
common = lvgl/src/core/lv_obj_tree.c;
common = lvgl/src/core/lv_event.c;
common = lvgl/src/core/lv_refr.c;
common = lvgl/src/core/lv_theme.c;
common = lvgl/src/draw/lv_draw_arc.c;
common = lvgl/src/draw/lv_draw.c;
common = lvgl/src/draw/lv_draw_img.c;
common = lvgl/src/draw/lv_draw_label.c;
common = lvgl/src/draw/lv_draw_line.c;
common = lvgl/src/draw/lv_draw_mask.c;
common = lvgl/src/draw/lv_draw_rect.c;
common = lvgl/src/draw/lv_draw_transform.c;
common = lvgl/src/draw/lv_draw_layer.c;
common = lvgl/src/draw/lv_draw_triangle.c;
common = lvgl/src/draw/lv_img_buf.c;
common = lvgl/src/draw/lv_img_cache.c;
common = lvgl/src/draw/lv_img_decoder.c;
common = lvgl/src/draw/sw/lv_draw_sw.c;
common = lvgl/src/draw/sw/lv_draw_sw_arc.c;
common = lvgl/src/draw/sw/lv_draw_sw_blend.c;
common = lvgl/src/draw/sw/lv_draw_sw_dither.c;
common = lvgl/src/draw/sw/lv_draw_sw_gradient.c;
common = lvgl/src/draw/sw/lv_draw_sw_img.c;
common = lvgl/src/draw/sw/lv_draw_sw_letter.c;
common = lvgl/src/draw/sw/lv_draw_sw_line.c;
common = lvgl/src/draw/sw/lv_draw_sw_polygon.c;
common = lvgl/src/draw/sw/lv_draw_sw_rect.c;
common = lvgl/src/draw/sw/lv_draw_sw_transform.c;
common = lvgl/src/draw/sw/lv_draw_sw_layer.c;
common = lvgl/src/font/lv_font.c;
common = lvgl/src/font/lv_font_fmt_txt.c;
common = lvgl/src/font/lv_font_loader.c;
common = lvgl/src/font/lv_font_dejavu_16_persian_hebrew.c;
common = lvgl/src/font/lv_font_montserrat_8.c;
common = lvgl/src/font/lv_font_montserrat_10.c;
common = lvgl/src/font/lv_font_montserrat_12.c;
common = lvgl/src/font/lv_font_montserrat_12_subpx.c;
common = lvgl/src/font/lv_font_montserrat_14.c;
common = lvgl/src/font/lv_font_montserrat_16.c;
common = lvgl/src/font/lv_font_montserrat_18.c;
common = lvgl/src/font/lv_font_montserrat_20.c;
common = lvgl/src/font/lv_font_montserrat_22.c;
common = lvgl/src/font/lv_font_montserrat_24.c;
common = lvgl/src/font/lv_font_montserrat_26.c;
common = lvgl/src/font/lv_font_montserrat_28.c;
common = lvgl/src/font/lv_font_montserrat_28_compressed.c;
common = lvgl/src/font/lv_font_montserrat_30.c;
common = lvgl/src/font/lv_font_montserrat_32.c;
common = lvgl/src/font/lv_font_montserrat_34.c;
common = lvgl/src/font/lv_font_montserrat_36.c;
common = lvgl/src/font/lv_font_montserrat_38.c;
common = lvgl/src/font/lv_font_montserrat_40.c;
common = lvgl/src/font/lv_font_montserrat_42.c;
common = lvgl/src/font/lv_font_montserrat_44.c;
common = lvgl/src/font/lv_font_montserrat_46.c;
common = lvgl/src/font/lv_font_montserrat_48.c;
common = lvgl/src/font/lv_font_simsun_16_cjk.c;
common = lvgl/src/font/lv_font_unscii_8.c;
common = lvgl/src/font/lv_font_unscii_16.c;
common = lvgl/src/hal/lv_hal_disp.c;
common = lvgl/src/hal/lv_hal_indev.c;
common = lvgl/src/hal/lv_hal_tick.c;
common = lvgl/src/misc/lv_anim.c;
common = lvgl/src/misc/lv_anim_timeline.c;
common = lvgl/src/misc/lv_area.c;
common = lvgl/src/misc/lv_async.c;
common = lvgl/src/misc/lv_bidi.c;
common = lvgl/src/misc/lv_color.c;
common = lvgl/src/misc/lv_fs.c;
common = lvgl/src/misc/lv_gc.c;
common = lvgl/src/misc/lv_ll.c;
common = lvgl/src/misc/lv_log.c;
common = lvgl/src/misc/lv_lru.c;
common = lvgl/src/misc/lv_math.c;
common = lvgl/src/misc/lv_mem.c;
common = lvgl/src/misc/lv_printf.c;
common = lvgl/src/misc/lv_style.c;
common = lvgl/src/misc/lv_style_gen.c;
common = lvgl/src/misc/lv_timer.c;
common = lvgl/src/misc/lv_tlsf.c;
common = lvgl/src/misc/lv_txt.c;
common = lvgl/src/misc/lv_txt_ap.c;
common = lvgl/src/misc/lv_utils.c;
common = lvgl/src/widgets/lv_arc.c;
common = lvgl/src/widgets/lv_bar.c;
common = lvgl/src/widgets/lv_btn.c;
common = lvgl/src/widgets/lv_btnmatrix.c;
common = lvgl/src/widgets/lv_canvas.c;
common = lvgl/src/widgets/lv_checkbox.c;
common = lvgl/src/widgets/lv_dropdown.c;
common = lvgl/src/widgets/lv_img.c;
common = lvgl/src/widgets/lv_label.c;
common = lvgl/src/widgets/lv_line.c;
common = lvgl/src/widgets/lv_roller.c;
common = lvgl/src/widgets/lv_slider.c;
common = lvgl/src/widgets/lv_switch.c;
common = lvgl/src/widgets/lv_table.c;
common = lvgl/src/widgets/lv_textarea.c;
common = lvgl/src/extra/lv_extra.c;
common = lvgl/src/extra/layouts/flex/lv_flex.c;
common = lvgl/src/extra/layouts/grid/lv_grid.c;
common = lvgl/src/extra/libs/bmp/lv_bmp.c;
common = lvgl/src/extra/libs/gif/gifdec.c;
common = lvgl/src/extra/libs/gif/lv_gif.c;
common = lvgl/src/extra/libs/png/lodepng.c;
common = lvgl/src/extra/libs/png/lv_png.c;
common = lvgl/src/extra/libs/sjpg/lv_sjpg.c;
common = lvgl/src/extra/libs/sjpg/tjpgd.c;
common = lvgl/src/extra/others/fragment/lv_fragment_manager.c;
common = lvgl/src/extra/others/fragment/lv_fragment.c;
common = lvgl/src/extra/others/gridnav/lv_gridnav.c;
common = lvgl/src/extra/others/ime/lv_ime_pinyin.c;
common = lvgl/src/extra/others/imgfont/lv_imgfont.c;
common = lvgl/src/extra/others/monkey/lv_monkey.c;
common = lvgl/src/extra/others/msg/lv_msg.c;
common = lvgl/src/extra/others/snapshot/lv_snapshot.c;
common = lvgl/src/extra/themes/basic/lv_theme_basic.c;
common = lvgl/src/extra/themes/default/lv_theme_default.c;
common = lvgl/src/extra/themes/mono/lv_theme_mono.c;
common = lvgl/src/extra/widgets/animimg/lv_animimg.c;
common = lvgl/src/extra/widgets/calendar/lv_calendar_header_arrow.c;
common = lvgl/src/extra/widgets/calendar/lv_calendar_header_dropdown.c;
common = lvgl/src/extra/widgets/calendar/lv_calendar.c;
common = lvgl/src/extra/widgets/chart/lv_chart.c;
common = lvgl/src/extra/widgets/colorwheel/lv_colorwheel.c;
common = lvgl/src/extra/widgets/imgbtn/lv_imgbtn.c;
common = lvgl/src/extra/widgets/keyboard/lv_keyboard.c;
common = lvgl/src/extra/widgets/led/lv_led.c;
common = lvgl/src/extra/widgets/list/lv_list.c;
common = lvgl/src/extra/widgets/menu/lv_menu.c;
common = lvgl/src/extra/widgets/meter/lv_meter.c;
common = lvgl/src/extra/widgets/msgbox/lv_msgbox.c;
common = lvgl/src/extra/widgets/span/lv_span.c;
common = lvgl/src/extra/widgets/spinbox/lv_spinbox.c;
common = lvgl/src/extra/widgets/spinner/lv_spinner.c;
common = lvgl/src/extra/widgets/tabview/lv_tabview.c;
common = lvgl/src/extra/widgets/tileview/lv_tileview.c;
common = lvgl/src/extra/widgets/win/lv_win.c;
cflags = '$(CFLAGS_LVGL)';
cppflags = '$(CPPFLAGS_LVGL)';
};
编辑 grub-core/lvgl/port/lv_conf.h，参考编译配置：
/**
* @file lv_conf.h
* Configuration file for v8.3.1
*/
/*
* Copy this file as `lv_conf.h`
* 1. simply next to the `lvgl` folder
* 2. or any other places and
* - define `LV_CONF_INCLUDE_SIMPLE`
* - add the path as include path
*/
/* clang-format off */
#if 1 /*Set it to "1" to enable content*/
#ifndef LV_CONF_H
#define LV_CONF_H
#include <stdint.h>
/*====================
COLOR SETTINGS
*====================*/
/*Color depth: 1 (1 byte per pixel), 8 (RGB332), 16 (RGB565), 32 (ARGB8888)*/
#define LV_COLOR_DEPTH 32
/*Swap the 2 bytes of RGB565 color. Useful if the display has an 8-bit interface (e.g. SPI)*/
#define LV_COLOR_16_SWAP 0
/*Enable features to draw on transparent background.
*It's required if opa, and transform_* style properties are used.
*Can be also used if the UI is above another layer, e.g. an OSD menu or video player.*/
#define LV_COLOR_SCREEN_TRANSP 1
/* Adjust color mix functions rounding. GPUs might calculate color mix (blending) differently.
* 0: round down, 64: round up from x.75, 128: round up from half, 192: round up from x.25, 254: round up */
#define LV_COLOR_MIX_ROUND_OFS 0
/*Images pixels with this color will not be drawn if they are chroma keyed)*/
#define LV_COLOR_CHROMA_KEY lv_color_hex(0x00ff00) /*pure green*/
/*=========================
MEMORY SETTINGS
*=========================*/
/*1: use custom malloc/free, 0: use the built-in `lv_mem_alloc()` and `lv_mem_free()`*/
#define LV_MEM_CUSTOM 1
#if LV_MEM_CUSTOM == 0
/*Size of the memory available for `lv_mem_alloc()` in bytes (>= 2kB)*/
#define LV_MEM_SIZE (48U * 1024U) /**/
/*Set an address for the memory pool instead of allocating it as a normal array. Can be in external SRAM too.*/
#define LV_MEM_ADR 0 /*0: unused*/
/*Instead of an address give a memory allocator that will be called to get a memory pool for LVGL. E.g. my_malloc*/
#if LV_MEM_ADR == 0
#undef LV_MEM_POOL_INCLUDE
#undef LV_MEM_POOL_ALLOC
#endif
#else /*LV_MEM_CUSTOM*/
#define LV_MEM_CUSTOM_INCLUDE <stdlib.h> /*Header for the dynamic memory function*/
#define LV_MEM_CUSTOM_ALLOC malloc
#define LV_MEM_CUSTOM_FREE free
#define LV_MEM_CUSTOM_REALLOC realloc
#endif /*LV_MEM_CUSTOM*/
/*Number of the intermediate memory buffer used during rendering and other internal processing mechanisms.
*You will see an error log message if there wasn't enough buffers. */
#define LV_MEM_BUF_MAX_NUM 16
/*Use the standard `memcpy` and `memset` instead of LVGL's own functions. (Might or might not be faster).*/
#define LV_MEMCPY_MEMSET_STD 1
/*====================
HAL SETTINGS
*====================*/
/*Default display refresh period. LVG will redraw changed areas with this period time*/
#define LV_DISP_DEF_REFR_PERIOD 30 /**/
/*Input device read period in milliseconds*/
#define LV_INDEV_DEF_READ_PERIOD 30 /**/
/*Use a custom tick source that tells the elapsed time in milliseconds.
*It removes the need to manually update the tick with `lv_tick_inc()`)*/
#define LV_TICK_CUSTOM 0
#if LV_TICK_CUSTOM
#define LV_TICK_CUSTOM_INCLUDE "Arduino.h" /*Header for the system time function*/
#define LV_TICK_CUSTOM_SYS_TIME_EXPR (millis()) /*Expression evaluating to current system time in ms*/
#endif /*LV_TICK_CUSTOM*/
/*Default Dot Per Inch. Used to initialize default sizes such as widgets sized, style paddings.
*(Not so important, you can adjust it to modify default sizes and spaces)*/
#define LV_DPI_DEF 130 /**/
/*=======================
* FEATURE CONFIGURATION
*=======================*/
/*-------------
* Drawing
*-----------*/
/*Enable complex draw engine.
*Required to draw shadow, gradient, rounded corners, circles, arc, skew lines, image transformations or any masks*/
#define LV_DRAW_COMPLEX 1
#if LV_DRAW_COMPLEX != 0
/*Allow buffering some shadow calculation.
*LV_SHADOW_CACHE_SIZE is the max. shadow size to buffer, where shadow size is `shadow_width + radius`
*Caching has LV_SHADOW_CACHE_SIZE^2 RAM cost*/
#define LV_SHADOW_CACHE_SIZE 0
/* Set number of maximally cached circle data.
* The circumference of 1/4 circle are saved for anti-aliasing
* radius * 4 bytes are used per circle (the most often used radiuses are saved)
* 0: to disable caching */
#define LV_CIRCLE_CACHE_SIZE 4
#endif /*LV_DRAW_COMPLEX*/
/**
* "Simple layers" are used when a widget has `style_opa < 255` to buffer the widget into a layer
* and blend it as an image with the given opacity.
* Note that `bg_opa`, `text_opa` etc don't require buffering into layer)
* The widget can be buffered in smaller chunks to avoid using large buffers.
*
* - LV_LAYER_SIMPLE_BUF_SIZE: the optimal target buffer size. LVGL will try to allocate it
* - LV_LAYER_SIMPLE_FALLBACK_BUF_SIZE: used if `LV_LAYER_SIMPLE_BUF_SIZE` couldn't be allocated.
*
* Both buffer sizes are in bytes.
* "Transformed layers" (where transform_angle/zoom properties are used) use larger buffers
* and can't be drawn in chunks. So these settings affects only widgets with opacity.
*/
#define LV_LAYER_SIMPLE_BUF_SIZE (24 * 1024)
#define LV_LAYER_SIMPLE_FALLBACK_BUF_SIZE (3 * 1024)
/*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.
*0: to disable caching*/
#define LV_IMG_CACHE_DEF_SIZE 1
/*Number of stops allowed per gradient. Increase this to allow more stops.
*This adds (sizeof(lv_color_t) + 1) bytes per additional stop*/
#define LV_GRADIENT_MAX_STOPS 2
/*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.
*0 mean no caching.*/
#define LV_GRAD_CACHE_DEF_SIZE 4096
/*Allow dithering the gradients (to achieve visual smooth color gradients on limited color depth display)
*LV_DITHER_GRADIENT implies allocating one or two more lines of the object's rendering surface
*The increase in memory consumption is (32 bits * object width) plus 24 bits * object width if using error diffusion */
#define LV_DITHER_GRADIENT 1
#if LV_DITHER_GRADIENT
/*Add support for error diffusion dithering.
*Error diffusion dithering gets a much better visual result, but implies more CPU consumption and memory when drawing.
*The increase in memory consumption is (24 bits * object's width)*/
#define LV_DITHER_ERROR_DIFFUSION 1
#endif
/*Maximum buffer size to allocate for rotation.
*Only used if software rotation is enabled in the display driver.*/
#define LV_DISP_ROT_MAX_BUF (10*1024)
/*-------------
* GPU
*-----------*/
/*Use Arm's 2D acceleration library Arm-2D */
#define LV_USE_GPU_ARM2D 0
/*Use STM32's DMA2D (aka Chrom Art) GPU*/
#define LV_USE_GPU_STM32_DMA2D 0
#if LV_USE_GPU_STM32_DMA2D
/*Must be defined to include path of CMSIS header of target processor
e.g. "stm32f769xx.h" or "stm32f429xx.h"*/
#define LV_GPU_DMA2D_CMSIS_INCLUDE
#endif
/*Use SWM341's DMA2D GPU*/
#define LV_USE_GPU_SWM341_DMA2D 0
#if LV_USE_GPU_SWM341_DMA2D
#define LV_GPU_SWM341_DMA2D_INCLUDE "SWM341.h"
#endif
/*Use NXP's PXP GPU iMX RTxxx platforms*/
#define LV_USE_GPU_NXP_PXP 0
#if LV_USE_GPU_NXP_PXP
/*1: Add default bare metal and FreeRTOS interrupt handling routines for PXP (lv_gpu_nxp_pxp_osa.c)
* and call lv_gpu_nxp_pxp_init() automatically during lv_init(). Note that symbol SDK_OS_FREE_RTOS
* has to be defined in order to use FreeRTOS OSA, otherwise bare-metal implementation is selected.
*0: lv_gpu_nxp_pxp_init() has to be called manually before lv_init()
*/
#define LV_USE_GPU_NXP_PXP_AUTO_INIT 0
#endif
/*Use NXP's VG-Lite GPU iMX RTxxx platforms*/
#define LV_USE_GPU_NXP_VG_LITE 0
/*Use SDL renderer API*/
#define LV_USE_GPU_SDL 0
#if LV_USE_GPU_SDL
#define LV_GPU_SDL_INCLUDE_PATH <SDL2/SDL.h>
/*Texture cache size, 8MB by default*/
#define LV_GPU_SDL_LRU_SIZE (1024 * 1024 * 8)
/*Custom blend mode for mask drawing, disable if you need to link with older SDL2 lib*/
#define LV_GPU_SDL_CUSTOM_BLEND_MODE (SDL_VERSION_ATLEAST(2, 0, 6))
#endif
/*-------------
* Logging
*-----------*/
/*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_USER Only logs added by the user
*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
/*Enable/disable LV_LOG_TRACE in modules that produces a huge number of logs*/
#define LV_LOG_TRACE_MEM 1
#define LV_LOG_TRACE_TIMER 1
#define LV_LOG_TRACE_INDEV 1
#define LV_LOG_TRACE_DISP_REFR1
#define LV_LOG_TRACE_EVENT 1
#define LV_LOG_TRACE_OBJ_CREATE 1
#define LV_LOG_TRACE_LAYOUT 1
#define LV_LOG_TRACE_ANIM 1
#endif/*LV_USE_LOG*/
/*-------------
* Asserts
*-----------*/
/*Enable asserts if an operation is failed or an invalid data is found.
*If LV_USE_LOG is enabled an error message will be printed on failure*/
#define LV_USE_ASSERT_NULL 1 /*Check if the parameter is NULL. (Very fast, recommended)*/
#define LV_USE_ASSERT_MALLOC 1 /*Checks is the memory is successfully allocated or no. (Very fast, recommended)*/
#define LV_USE_ASSERT_STYLE 1 /*Check if the styles are properly initialized. (Very fast, recommended)*/
#define LV_USE_ASSERT_MEM_INTEGRITY 0 /*Check the integrity of `lv_mem` after critical operations. (Slow)*/
#define LV_USE_ASSERT_OBJ 0 /*Check the object's type and existence (e.g. not deleted). (Slow)*/
/*Add a custom handler when assert happens e.g. to restart the MCU*/
#define LV_ASSERT_HANDLER_INCLUDE <stdint.h>
#define LV_ASSERT_HANDLER while(1); /*Halt by default*/
/*-------------
* Others
*-----------*/
/*1: Show CPU usage and FPS count*/
#define LV_USE_PERF_MONITOR 0
#if LV_USE_PERF_MONITOR
#define LV_USE_PERF_MONITOR_POS LV_ALIGN_BOTTOM_RIGHT
#endif
/*1: Show the used memory and the memory fragmentation
* Requires LV_MEM_CUSTOM = 0*/
#define LV_USE_MEM_MONITOR 0
#if LV_USE_MEM_MONITOR
#define LV_USE_MEM_MONITOR_POS LV_ALIGN_BOTTOM_LEFT
#endif
/*1: Draw random colored rectangles over the redrawn areas*/
#define LV_USE_REFR_DEBUG 0
/*Change the built in (v)snprintf functions*/
#define LV_SPRINTF_CUSTOM 0
#if LV_SPRINTF_CUSTOM
#define LV_SPRINTF_INCLUDE <stdio.h>
#define lv_snprintfsnprintf
#define lv_vsnprintf vsnprintf
#else /*LV_SPRINTF_CUSTOM*/
#define LV_SPRINTF_USE_FLOAT 0
#endif/*LV_SPRINTF_CUSTOM*/
#define LV_USE_USER_DATA 1
/*Garbage Collector settings
*Used if lvgl is bound 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*/
#endif /*LV_ENABLE_GC*/
/*=====================
*COMPILER SETTINGS
*====================*/
/*For big endian systems set to 1*/
#ifdef GRUB_CPU_WORDS_BIGENDIAN
#define LV_BIG_ENDIAN_SYSTEM 1
#else
#define LV_BIG_ENDIAN_SYSTEM 0
#endif
/*Define a custom attribute to `lv_tick_inc` function*/
#define LV_ATTRIBUTE_TICK_INC
/*Define a custom attribute to `lv_timer_handler` function*/
#define LV_ATTRIBUTE_TIMER_HANDLER
/*Define a custom attribute to `lv_disp_flush_ready` function*/
#define LV_ATTRIBUTE_FLUSH_READY
/*Required alignment size for buffers*/
#define LV_ATTRIBUTE_MEM_ALIGN_SIZE 1
/*Will be added where memories needs to be aligned (with -Os data might not be aligned to boundary by default).
* 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
/*Compiler prefix for a big array declaration in RAM*/
#define LV_ATTRIBUTE_LARGE_RAM_ARRAY
/*Place performance critical functions into a faster memory (e.g RAM)*/
#define LV_ATTRIBUTE_FAST_MEM
/*Prefix variables that are used in GPU accelerated operations, often these need to be placed in RAM sections that are DMA accessible*/
#define LV_ATTRIBUTE_DMA
/*Export integer constant to binding. This macro is used with constants in the form of LV_<CONST> that
*should also appear on LVGL binding API such as Micropython.*/
#define LV_EXPORT_CONST_INT(int_value) struct _silence_gcc_warning /*The default value just prevents GCC warning*/
/*Extend the default -32k..32k coordinate range to -4M..4M by using int32_t for coordinates instead of int16_t*/
#define LV_USE_LARGE_COORD 0
/*==================
* FONT USAGE
*===================*/
/*Montserrat fonts with ASCII range and some symbols using bpp = 4
*https://fonts.google.com/specimen/Montserrat*/
#define LV_FONT_MONTSERRAT_81
#define LV_FONT_MONTSERRAT_10 0
#define LV_FONT_MONTSERRAT_12 1
#define LV_FONT_MONTSERRAT_14 1
#define LV_FONT_MONTSERRAT_16 1
#define LV_FONT_MONTSERRAT_18 1
#define LV_FONT_MONTSERRAT_20 0
#define LV_FONT_MONTSERRAT_22 0
#define LV_FONT_MONTSERRAT_24 1
#define LV_FONT_MONTSERRAT_26 0
#define LV_FONT_MONTSERRAT_28 1
#define LV_FONT_MONTSERRAT_30 0
#define LV_FONT_MONTSERRAT_32 1
#define LV_FONT_MONTSERRAT_34 0
#define LV_FONT_MONTSERRAT_36 1
#define LV_FONT_MONTSERRAT_38 0
#define LV_FONT_MONTSERRAT_40 0
#define LV_FONT_MONTSERRAT_42 0
#define LV_FONT_MONTSERRAT_44 0
#define LV_FONT_MONTSERRAT_46 0
#define LV_FONT_MONTSERRAT_48 1
/*Demonstrate special features*/
#define LV_FONT_MONTSERRAT_12_SUBPX 1
#define LV_FONT_MONTSERRAT_28_COMPRESSED 1/*bpp = 3*/
#define LV_FONT_DEJAVU_16_PERSIAN_HEBREW 1/*Hebrew, Arabic, Persian letters and all their forms*/
#define LV_FONT_SIMSUN_16_CJK 1/*1000 most common CJK radicals*/
/*Pixel perfect monospace fonts*/
#define LV_FONT_UNSCII_81
#define LV_FONT_UNSCII_16 1
/*Optionally declare 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*/
#define LV_FONT_DEFAULT &lv_font_montserrat_16
/*Enable handling large font and/or fonts with a lot of characters.
*The limit depends on the font size, font face and bpp.
*Compiler error will be triggered if a font needs it.*/
#define LV_FONT_FMT_TXT_LARGE 1
/*Enables/disables support for compressed fonts.*/
#define LV_USE_FONT_COMPRESSED 1
/*Enable subpixel rendering*/
#define LV_USE_FONT_SUBPX 0
#if LV_USE_FONT_SUBPX
/*Set the pixel order of the display. Physical order of RGB channels. Doesn't matter with "normal" fonts.*/
#define LV_FONT_SUBPX_BGR 0/*0: RGB; 1:BGR order*/
#endif
/*Enable drawing placeholders when glyph dsc is not found*/
#define LV_USE_FONT_PLACEHOLDER 1
/*=================
*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 0
/*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 Bidirectional Algorithm:
*https://www.w3.org/International/articles/inline-bidi-markup/uba-basics*/
#define LV_USE_BIDI 1
#if LV_USE_BIDI
/*Set the default direction. Supported values:
*`LV_BASE_DIR_LTR` Left-to-Right
*`LV_BASE_DIR_RTL` Right-to-Left
*`LV_BASE_DIR_AUTO` detect texts base direction*/
#define LV_BIDI_BASE_DIR_DEF LV_BASE_DIR_AUTO
#endif
/*Enable Arabic/Persian processing
*In these languages characters should be replaced with an other form based on their position in the text*/
#define LV_USE_ARABIC_PERSIAN_CHARS 1
/*==================
*WIDGET USAGE
*================*/
/*Documentation of the widgets: https://docs.lvgl.io/latest/en/html/widgets/index.html*/
#define LV_USE_ARC 1
#define LV_USE_BAR 1
#define LV_USE_BTN 1
#define LV_USE_BTNMATRIX1
#define LV_USE_CANVAS 1
#define LV_USE_CHECKBOX 1
#define LV_USE_DROPDOWN 1 /*Requires: lv_label*/
#define LV_USE_IMG 1 /*Requires: lv_label*/
#define LV_USE_LABEL 1
#if LV_USE_LABEL
#define LV_LABEL_TEXT_SELECTION 1 /*Enable selecting text of the label*/
#define LV_LABEL_LONG_TXT_HINT 1/*Store some extra info in labels to speed up drawing of very long texts*/
#endif
#define LV_USE_LINE 1
#define LV_USE_ROLLER 1 /*Requires: lv_label*/
#if LV_USE_ROLLER
#define LV_ROLLER_INF_PAGES 7 /*Number of extra "pages" when the roller is infinite*/
#endif
#define LV_USE_SLIDER 1 /*Requires: lv_bar*/
#define LV_USE_SWITCH 1
#define LV_USE_TEXTAREA 1 /*Requires: lv_label*/
#if LV_USE_TEXTAREA != 0
#define LV_TEXTAREA_DEF_PWD_SHOW_TIME 1500 /*ms*/
#endif
#define LV_USE_TABLE 1
/*==================
* EXTRA COMPONENTS
*==================*/
/*-----------
* Widgets
*----------*/
#define LV_USE_ANIMIMG 1
#define LV_USE_CALENDAR 1
#if LV_USE_CALENDAR
#define LV_CALENDAR_WEEK_STARTS_MONDAY 0
#if LV_CALENDAR_WEEK_STARTS_MONDAY
#define LV_CALENDAR_DEFAULT_DAY_NAMES {"Mo", "Tu", "We", "Th", "Fr", "Sa", "Su"}
#else
#define LV_CALENDAR_DEFAULT_DAY_NAMES {"Su", "Mo", "Tu", "We", "Th", "Fr", "Sa"}
#endif
#define LV_CALENDAR_DEFAULT_MONTH_NAMES {"January", "February", "March","April", "May","June", "July", "August", "September", "October", "November", "December"}
#define LV_USE_CALENDAR_HEADER_ARROW 1
#define LV_USE_CALENDAR_HEADER_DROPDOWN 1
#endif/*LV_USE_CALENDAR*/
#define LV_USE_CHART 1
#define LV_USE_COLORWHEEL 1
#define LV_USE_IMGBTN 1
#define LV_USE_KEYBOARD 1
#define LV_USE_LED 1
#define LV_USE_LIST 1
#define LV_USE_MENU 1
#define LV_USE_METER 1
#define LV_USE_MSGBOX 1
#define LV_USE_SPAN 1
#if LV_USE_SPAN
/*A line text can contain maximum num of span descriptor */
#define LV_SPAN_SNIPPET_STACK_SIZE 64
#endif
#define LV_USE_SPINBOX 1
#define LV_USE_SPINNER 1
#define LV_USE_TABVIEW 1
#define LV_USE_TILEVIEW 1
#define LV_USE_WIN 1
/*-----------
* Themes
*----------*/
/*A simple, impressive and very complete theme*/
#define LV_USE_THEME_DEFAULT 1
#if LV_USE_THEME_DEFAULT
/*0: Light mode; 1: Dark mode*/
#define LV_THEME_DEFAULT_DARK 0
/*1: Enable grow on press*/
#define LV_THEME_DEFAULT_GROW 1
/*Default transition time in */
#define LV_THEME_DEFAULT_TRANSITION_TIME 80
#endif /*LV_USE_THEME_DEFAULT*/
/*A very simple theme that is a good starting point for a custom theme*/
#define LV_USE_THEME_BASIC 1
/*A theme designed for monochrome displays*/
#define LV_USE_THEME_MONO 1
/*-----------
* Layouts
*----------*/
/*A layout similar to Flexbox in CSS.*/
#define LV_USE_FLEX 1
/*A layout similar to Grid in CSS.*/
#define LV_USE_GRID 1
/*---------------------
* 3rd party libraries
*--------------------*/
/*File system interfaces for common APIs */
/*API for fopen, fread, etc*/
#define LV_USE_FS_STDIO 0
#if LV_USE_FS_STDIO
#define LV_FS_STDIO_LETTER '\0' /*Set an upper cased letter on which the drive will accessible (e.g. 'A')*/
#define LV_FS_STDIO_PATH "" /*Set the working directory. File/directory paths will be appended to it.*/
#define LV_FS_STDIO_CACHE_SIZE 0 /*>0 to cache this number of bytes in lv_fs_read()*/
#endif
/*API for open, read, etc*/
#define LV_USE_FS_POSIX 0
#if LV_USE_FS_POSIX
#define LV_FS_POSIX_LETTER '\0' /*Set an upper cased letter on which the drive will accessible (e.g. 'A')*/
#define LV_FS_POSIX_PATH "" /*Set the working directory. File/directory paths will be appended to it.*/
#define LV_FS_POSIX_CACHE_SIZE 0 /*>0 to cache this number of bytes in lv_fs_read()*/
#endif
/*API for CreateFile, ReadFile, etc*/
#define LV_USE_FS_WIN32 0
#if LV_USE_FS_WIN32
#define LV_FS_WIN32_LETTER '\0' /*Set an upper cased letter on which the drive will accessible (e.g. 'A')*/
#define LV_FS_WIN32_PATH "" /*Set the working directory. File/directory paths will be appended to it.*/
#define LV_FS_WIN32_CACHE_SIZE 0 /*>0 to cache this number of bytes in lv_fs_read()*/
#endif
/*API for FATFS (needs to be added separately). Uses f_open, f_read, etc*/
#define LV_USE_FS_FATFS 0
#if LV_USE_FS_FATFS
#define LV_FS_FATFS_LETTER '\0' /*Set an upper cased letter on which the drive will accessible (e.g. 'A')*/
#define LV_FS_FATFS_CACHE_SIZE 0 /*>0 to cache this number of bytes in lv_fs_read()*/
#endif
/*PNG decoder library*/
#define LV_USE_PNG 1
/*BMP decoder library*/
#define LV_USE_BMP 1
/* JPG + split JPG decoder library.
* Split JPG is a custom format optimized for embedded systems. */
#define LV_USE_SJPG 1
/*GIF decoder library*/
#define LV_USE_GIF 1
/*QR code library*/
#define LV_USE_QRCODE 0
/*FreeType library*/
#define LV_USE_FREETYPE 0
#if LV_USE_FREETYPE
/*Memory used by FreeType to cache characters (-1: no caching)*/
#define LV_FREETYPE_CACHE_SIZE (16 * 1024)
#if LV_FREETYPE_CACHE_SIZE >= 0
/* 1: bitmap cache use the sbit cache, 0:bitmap cache use the image cache. */
/* sbit cache:it is much more memory efficient for small bitmaps(font size < 256) */
/* if font size >= 256, must be configured as image cache */
#define LV_FREETYPE_SBIT_CACHE 0
/* Maximum number of opened FT_Face/FT_Size objects managed by this cache instance. */
/* (0:use system defaults) */
#define LV_FREETYPE_CACHE_FT_FACES 0
#define LV_FREETYPE_CACHE_FT_SIZES 0
#endif
#endif
/*Rlottie library*/
#define LV_USE_RLOTTIE 0
/*FFmpeg library for image decoding and playing videos
*Supports all major image formats so do not enable other image decoder with it*/
#define LV_USE_FFMPEG 0
#if LV_USE_FFMPEG
/*Dump input information to stderr*/
#define LV_FFMPEG_DUMP_FORMAT 0
#endif
/*-----------
* Others
*----------*/
/*1: Enable API to take snapshot for object*/
#define LV_USE_SNAPSHOT 1
/*1: Enable Monkey test*/
#define LV_USE_MONKEY 0
/*1: Enable grid navigation*/
#define LV_USE_GRIDNAV 1
/*1: Enable lv_obj fragment*/
#define LV_USE_FRAGMENT 1
/*1: Support using images as font in label or span widgets */
#define LV_USE_IMGFONT 1
/*1: Enable a published subscriber based messaging system */
#define LV_USE_MSG 1
/*1: Enable Pinyin input method*/
/*Requires: lv_keyboard*/
#define LV_USE_IME_PINYIN 1
#if LV_USE_IME_PINYIN
/*1: Use default thesaurus*/
/*If you do not use the default thesaurus, be sure to use `lv_ime_pinyin` after setting the thesauruss*/
#define LV_IME_PINYIN_USE_DEFAULT_DICT 1
/*Set the maximum number of candidate panels that can be displayed*/
/*This needs to be adjusted according to the size of the screen*/
#define LV_IME_PINYIN_CAND_TEXT_NUM 6
/*Use 9 key input(k9)*/
#define LV_IME_PINYIN_USE_K9_MODE 0
#if LV_IME_PINYIN_USE_K9_MODE == 1
#define LV_IME_PINYIN_K9_CAND_TEXT_NUM 3
#endif // LV_IME_PINYIN_USE_K9_MODE
#endif
/*==================
* EXAMPLES
*==================*/
/*Enable the examples to be built with the library*/
#define LV_BUILD_EXAMPLES 0
/*===================
* DEMO USAGE
====================*/
/*Show some widget. It might be required to increase `LV_MEM_SIZE` */
#define LV_USE_DEMO_WIDGETS 0
#if LV_USE_DEMO_WIDGETS
#define LV_DEMO_WIDGETS_SLIDESHOW 0
#endif
/*Demonstrate the usage of encoder and keyboard*/
#define LV_USE_DEMO_KEYPAD_AND_ENCODER 0
/*Benchmark your system*/
#define LV_USE_DEMO_BENCHMARK 0
#if LV_USE_DEMO_BENCHMARK
/*Use RGB565A8 images with 16 bit color depth instead of ARGB8565*/
#define LV_DEMO_BENCHMARK_RGB565A8 0
#endif
/*Stress test for LVGL*/
#define LV_USE_DEMO_STRESS 0
/*Music player demo*/
#define LV_USE_DEMO_MUSIC 0
#if LV_USE_DEMO_MUSIC
#define LV_DEMO_MUSIC_SQUARE 0
#define LV_DEMO_MUSIC_LANDSCAPE 0
#define LV_DEMO_MUSIC_ROUND 0
#define LV_DEMO_MUSIC_LARGE 0
#define LV_DEMO_MUSIC_AUTO_PLAY 0
#endif
/*--END OF LV_CONF_H--*/
#endif /*LV_CONF_H*/
#endif /*End of "Content enable"*/
5. 创建测试模块
grub-core/Makefile.core.def
module = {
name = lvgltest;
common = commands/lvgltest.c;
cflags = '$(CFLAGS_LVGLAPP)';
cppflags = '$(CPPFLAGS_LVGLAPP)';
};
grub-core/commands/lvgltest.c
/*
*GRUB--GRand Unified Bootloader
*Copyright (C) 2022A1ive
*
*GRUB is free software: you can redistribute it and/or modify
*it under the terms of the GNU General Public License as published by
*the Free Software Foundation, either version 3 of the License, or
*(at your option) any later version.
*
*GRUB is distributed in the hope that it will be useful,
*but WITHOUT ANY WARRANTY; without even the implied warranty of
*MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.See the
*GNU General Public License for more details.
*
*You should have received a copy of the GNU General Public License
*along with GRUB.If not, see <http://www.gnu.org/licenses/>.
*/
#include <grub/types.h>
#include <grub/misc.h>
#include <grub/mm.h>
#include <grub/err.h>
#include <grub/dl.h>
#include <grub/extcmd.h>
#include <grub/i18n.h>
#include <lvgl.h>
GRUB_MOD_LICENSE ("GPLv3+");
static grub_err_t
grub_cmd_lvgl (grub_extcmd_context_t ctxt __attribute__ ((unused)),
int argc __attribute__ ((unused)),
char **args __attribute__ ((unused)))
{
lv_init ();
grub_printf ("lv_init OK.\n");
return 0;
}
static grub_extcmd_t cmd;
GRUB_MOD_INIT(lvgltest)
{
cmd = grub_register_extcmd ("lvgltest", grub_cmd_lvgl, 0, 0,
N_("LVGL test."), 0);
}
GRUB_MOD_FINI(lvgltest)
{
grub_unregister_extcmd (cmd);
} 本帖最后由 wintoflash 于 2022-9-22 12:01 编辑
6. 添加显示界面
文档：https://docs.lvgl.io/master/porting/display.html
目前仅用于测试 LVGL 是否正常工作，暂不考虑效率，因此使用 Full refresh (One buffer) 模式。
测试中文显示和拼音输入法：
创建 grub-core/lvgl/port/lv_port_disp.c：
/*
*GRUB--GRand Unified Bootloader
*Copyright (C) 2022A1ive
*
*GRUB is free software: you can redistribute it and/or modify
*it under the terms of the GNU General Public License as published by
*the Free Software Foundation, either version 3 of the License, or
*(at your option) any later version.
*
*GRUB is distributed in the hope that it will be useful,
*but WITHOUT ANY WARRANTY; without even the implied warranty of
*MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.See the
*GNU General Public License for more details.
*
*You should have received a copy of the GNU General Public License
*along with GRUB.If not, see <http://www.gnu.org/licenses/>.
*/
#include <grub/misc.h>
#include <grub/mm.h>
#include <grub/term.h>
#include <grub/video.h>
#include <grub/bitmap.h>
#include "../lvgl.h"
#include "lv_port_disp.h"
static lv_disp_drv_t grub_lvgl_disp_drv;
static lv_disp_draw_buf_t grub_lvgl_draw_buf;
static lv_color_t *grub_lvgl_fb;
static uint32_t grub_lvgl_fb_size;
static struct grub_video_bitmap grub_lvgl_bmp =
{
.mode_info =
{
.mode_type = GRUB_VIDEO_MODE_TYPE_RGB | GRUB_VIDEO_MODE_TYPE_ALPHA,
.blit_format = GRUB_VIDEO_BLIT_FORMAT_BGRA_8888,
.bpp = 32,
.bytes_per_pixel = 4,
.number_of_colors = 256,
.blue_mask_size = 8,
.blue_field_pos = 0,
.green_mask_size = 8,
.green_field_pos = 8,
.red_mask_size = 8,
.red_field_pos = 16,
.reserved_mask_size = 8,
.reserved_field_pos = 24,
},
};
static void
grub_lvgl_flush_cb (lv_disp_drv_t *disp_drv, const lv_area_t *area, lv_color_t *color_p)
{
unsigned int width, height;
width = area->x2 - area->x1 + 1;
height = area->y2 - area->y1 + 1;
grub_lvgl_bmp.mode_info.width = width;
grub_lvgl_bmp.mode_info.height = height;
grub_lvgl_bmp.mode_info.pitch = width * 4;
grub_lvgl_bmp.data = &color_p->ch;
grub_video_blit_bitmap(&grub_lvgl_bmp, GRUB_VIDEO_BLIT_BLEND,
area->x1, area->y1, 0, 0, width, height);
grub_refresh();
lv_disp_flush_ready(disp_drv);
}
grub_err_t
lv_port_disp_init(void)
{
struct grub_video_mode_info info;
if (grub_video_get_info(&info) != GRUB_ERR_NONE)
return grub_errno;
grub_printf("%ux%ux%u, format=%d\n",
info.width, info.height, info.bpp, info.blit_format);
grub_lvgl_fb_size = info.height * info.width;
grub_lvgl_fb = grub_calloc(sizeof(lv_color_t), grub_lvgl_fb_size);
if (!grub_lvgl_fb)
return grub_error(GRUB_ERR_OUT_OF_MEMORY, "out of memory");
lv_disp_draw_buf_init(&grub_lvgl_draw_buf, grub_lvgl_fb, NULL, grub_lvgl_fb_size);
lv_disp_drv_init(&grub_lvgl_disp_drv);
grub_lvgl_disp_drv.hor_res = info.width;
grub_lvgl_disp_drv.ver_res = info.height;
grub_lvgl_disp_drv.draw_buf = &grub_lvgl_draw_buf;
grub_lvgl_disp_drv.full_refresh = 1;
grub_lvgl_disp_drv.flush_cb = grub_lvgl_flush_cb;
lv_disp_drv_register(&grub_lvgl_disp_drv);
return GRUB_ERR_NONE;
}
创建 grub-core/lvgl/port/lv_port_disp.h：
#ifndef LV_PORT_DISP_H
#define LV_PORT_DISP_H
#include <grub/err.h>
grub_err_t lv_port_disp_init(void);
#endif /*LV_PORT_DISP_H*/
在 lv_conf.h 中，我们已经将 LV_COLOR_DEPTH 设置为 32，那么 lv_color_t 就是 BGRA8888 格式的 (和 BMP 一样)。
由于 grub_video_bitmap_create 不支持创建 BGRA8888 格式图片，因此只能自己写一个 grub_video_bitmap 的结构体，手动指定各颜色的位置。
在 grub-core/Makefile.core.def 的 lvgl 一节中加入
common = lvgl/port/lv_port_disp.c;
编辑 grub-core/commands/lvgltest.c，添加如下测试内容：
#include <grub/types.h>
#include <grub/misc.h>
#include <grub/mm.h>
#include <grub/err.h>
#include <grub/dl.h>
#include <grub/extcmd.h>
#include <grub/i18n.h>
#include <grub/term.h>
#include <lvgl.h>
#include <port/lv_port_disp.h>
GRUB_MOD_LICENSE ("GPLv3+");
static void ta_event_cb(lv_event_t * e)
{
lv_event_code_t code = lv_event_get_code(e);
lv_obj_t * ta = lv_event_get_target(e);
lv_obj_t * kb = lv_event_get_user_data(e);
if(code == LV_EVENT_FOCUSED)
{
if(lv_indev_get_type(lv_indev_get_act()) != LV_INDEV_TYPE_KEYPAD)
{
lv_keyboard_set_textarea(kb, ta);
lv_obj_clear_flag(kb, LV_OBJ_FLAG_HIDDEN);
}
}
else if(code == LV_EVENT_CANCEL)
{
lv_obj_add_flag(kb, LV_OBJ_FLAG_HIDDEN);
lv_obj_clear_state(ta, LV_STATE_FOCUSED);
lv_indev_reset(NULL, ta); /*To forget the last clicked object to make it focusable again*/
}
}
static grub_err_t
grub_cmd_lvgl (grub_extcmd_context_t ctxt __attribute__ ((unused)),
int argc __attribute__ ((unused)),
char **args __attribute__ ((unused)))
{
lv_init ();
grub_printf ("lv_init OK.\n");
grub_refresh();
if (lv_port_disp_init() != GRUB_ERR_NONE)
{
grub_printf("lv_port_disp_init error %d\n", grub_errno);
return grub_errno;
}
grub_printf("lv_port_disp_init OK.\n");
grub_refresh();
lv_obj_t * pinyin_ime = lv_ime_pinyin_create(lv_scr_act());
lv_obj_set_style_text_font(pinyin_ime, &lv_font_simsun_16_cjk, 0);
/* ta1 */
lv_obj_t * ta1 = lv_textarea_create(lv_scr_act());
lv_textarea_set_one_line(ta1, true);
lv_obj_set_style_text_font(ta1, &lv_font_simsun_16_cjk, 0);
lv_obj_align(ta1, LV_ALIGN_TOP_LEFT, 0, 0);
/*Create a keyboard and add it to ime_pinyin*/
lv_obj_t * kb = lv_keyboard_create(lv_scr_act());
lv_ime_pinyin_set_keyboard(pinyin_ime, kb);
lv_keyboard_set_textarea(kb, ta1);
lv_obj_add_event_cb(ta1, ta_event_cb, LV_EVENT_ALL, kb);
/*Get the cand_panel, and adjust its size and position*/
lv_obj_t * cand_panel = lv_ime_pinyin_get_cand_panel(pinyin_ime);
lv_obj_set_size(cand_panel, LV_PCT(100), LV_PCT(10));
lv_obj_align_to(cand_panel, kb, LV_ALIGN_OUT_TOP_MID, 0, 0);
/*Try using ime_pinyin to output the Chinese below in the ta1 above*/
lv_obj_t * cz_label = lv_label_create(lv_scr_act());
lv_label_set_text(cz_label,
"嵌入式系统（Embedded System），\n"
"是一种嵌入机械或电气系统内部、具有专一功能和实时计算性能的计算机系统。");
lv_obj_set_style_text_font(cz_label, &lv_font_simsun_16_cjk, 0);
lv_obj_set_width(cz_label, 310);
lv_obj_align_to(cz_label, ta1, LV_ALIGN_OUT_BOTTOM_LEFT, 0, 0);
while (1)
{
lv_tick_inc(5);
lv_task_handler();
}
return 0;
}
编译并在虚拟机中运行测试，即可看到图片所示内容。 本帖最后由 wintoflash 于 2022-9-22 21:53 编辑
7. 添加输入设备支持 (键盘)
文档：https://docs.lvgl.io/master/porting/indev.html
暂时仅添加键盘驱动。使用 grub_getkey_no_block() 从 GRUB2 终端获取按键。
根据 lvgl/src/core/lv_group.h，下列按键需要特殊处理：
enum {
LV_KEY_UP = 17,/*0x11*/
LV_KEY_DOWN = 18,/*0x12*/
LV_KEY_RIGHT = 19,/*0x13*/
LV_KEY_LEFT = 20,/*0x14*/
LV_KEY_ESC = 27,/*0x1B*/
LV_KEY_DEL = 127, /*0x7F*/
LV_KEY_BACKSPACE = 8, /*0x08*/
LV_KEY_ENTER = 10,/*0x0A, '\n'*/
LV_KEY_NEXT = 9, /*0x09, '\t'*/
LV_KEY_PREV = 11,/*0x0B, '*/
LV_KEY_HOME = 2, /*0x02, STX*/
LV_KEY_END = 3, /*0x03, ETX*/
};
添加 grub-core/lvgl/port/lv_port_indev.c：
/*
*GRUB--GRand Unified Bootloader
*Copyright (C) 2022A1ive
*
*GRUB is free software: you can redistribute it and/or modify
*it under the terms of the GNU General Public License as published by
*the Free Software Foundation, either version 3 of the License, or
*(at your option) any later version.
*
*GRUB is distributed in the hope that it will be useful,
*but WITHOUT ANY WARRANTY; without even the implied warranty of
*MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.See the
*GNU General Public License for more details.
*
*You should have received a copy of the GNU General Public License
*along with GRUB.If not, see <http://www.gnu.org/licenses/>.
*/
#include <grub/misc.h>
#include <grub/mm.h>
#include <grub/term.h>
#include "../lvgl.h"
#include "lv_port_indev.h"
static lv_indev_drv_t grub_lvgl_indev_drv;
lv_indev_t *grub_lvgl_indev_kbd;
static void
grub_lvgl_kbd_read_cb (lv_indev_drv_t *indev_drv, lv_indev_data_t *data)
{
(void) indev_drv;
static uint32_t last_key = 0, act_key = 0;
/*Get whether the a key is pressed and save the pressed key*/
int key = grub_getkey_noblock();
if(key != GRUB_TERM_NO_KEY)
{
data->state = LV_INDEV_STATE_PR;
switch(key)
{
case GRUB_TERM_KEY_UP:
case GRUB_TERM_CTRL | 'p':
act_key = LV_KEY_UP;
break;
case GRUB_TERM_KEY_DOWN:
case GRUB_TERM_CTRL | 'n':
act_key = LV_KEY_DOWN;
break;
case GRUB_TERM_KEY_RIGHT:
case GRUB_TERM_CTRL | 'f':
act_key = LV_KEY_RIGHT;
break;
case GRUB_TERM_KEY_LEFT:
case GRUB_TERM_CTRL | 'b':
act_key = LV_KEY_LEFT;
break;
case GRUB_TERM_ESC:
act_key = LV_KEY_ESC;
break;
case GRUB_TERM_KEY_DC:
case GRUB_TERM_CTRL | 'd':
act_key = LV_KEY_DEL;
break;
case GRUB_TERM_BACKSPACE:
case GRUB_TERM_CTRL | 'h':
act_key = LV_KEY_BACKSPACE;
break;
case '\n':
case '\r':
act_key = LV_KEY_ENTER;
break;
case '\t':
case GRUB_TERM_KEY_NPAGE:
case GRUB_TERM_CTRL | 'i':
act_key = LV_KEY_NEXT;
break;
case '\v':
case GRUB_TERM_KEY_PPAGE:
case GRUB_TERM_CTRL | 'k':
act_key = LV_KEY_PREV;
break;
case GRUB_TERM_KEY_HOME:
case GRUB_TERM_CTRL | 'a':
act_key = LV_KEY_HOME;
break;
case GRUB_TERM_KEY_END:
case GRUB_TERM_CTRL | 'e':
act_key = LV_KEY_END;
break;
default:
act_key = (uint32_t) key;
}
last_key = act_key;
}
else
{
data->state = LV_INDEV_STATE_REL;
}
data->key = last_key;
}
void lv_port_indev_init(void)
{
/*Register a keypad input device*/
lv_indev_drv_init(&grub_lvgl_indev_drv);
grub_lvgl_indev_drv.type = LV_INDEV_TYPE_KEYPAD;
grub_lvgl_indev_drv.read_cb = grub_lvgl_kbd_read_cb;
grub_lvgl_indev_kbd = lv_indev_drv_register(&grub_lvgl_indev_drv);
}
grub-core/lvgl/port/lv_port_indev.h
#ifndef LV_PORT_INDEV_H
#define LV_PORT_INDEV_H
#include "../lvgl.h"
extern lv_indev_t *grub_lvgl_indev_kbd;
void lv_port_indev_init(void);
#endif /*LV_PORT_INDEV_H*/
在 grub-core/Makefile.core.def 的 lvgl 一节中加入
common = lvgl/port/lv_port_indev.c;
编辑 grub-core/commands/lvgltest.c，加入输入设备相关代码：
...
#include <grub/time.h>
#include <port/lv_port_indev.h>
...
grub_printf("lv_port_disp_init OK.\n");
grub_refresh();
lv_port_indev_init();
grub_printf("lv_port_indev_init OK.\n");
grub_refresh();
lv_group_t *g = lv_group_create();
lv_group_set_default(g);
lv_indev_set_group(grub_lvgl_indev_kbd, g);
...
while (1)
{
lv_tick_inc(5);
lv_task_handler();
grub_millisleep(5);
}
本帖最后由 wintoflash 于 2022-10-1 09:57 编辑
9. 接入 GRUB2 pf2 字体支持
GRUB2 采用的是自定义的 PFF2 点阵字体格式 (https://www.gnu.org/software/gru ... F2-Font-File-Format)
它提供了 grub-mkfont 工具，调用 freetype 以实现 ttf->pf2 字体格式的转换。
在 GRUB2 加载字体后，每个字形 (glyph) 都会被转化成以下格式的结构体：
struct grub_font_glyph
{
grub_font_t font;
/* 字形宽度 (不包含 Horizonal leading，也就是两个字符之间的空隙) */
grub_uint16_t width;
/* 字形高度*/
grub_uint16_t height;
/* 位图 x 偏移*/
grub_int16_t offset_x;
/* 位图 y 偏移*/
grub_int16_t offset_y;
/* Horizonal leading 的有效值*/
grub_uint16_t device_width;
/* 字形的位图，每个比特对应一个像素 (bpp=1)*/
grub_uint8_t bitmap;
};
所有的字形，组成了字体 (font)。
struct grub_font
{
char *name;
grub_file_t file;
char *family;
short point_size;
short weight;
/* 最大宽度 */
short max_char_width;
/* 最大高度 */
short max_char_height;
/* 基线 (base line) 之上的空间 */
short ascent;
/* 基线 (base line) 之下的空间 */
short descent;
short leading;
grub_uint32_t num_chars;
struct char_index_entry *char_index;
grub_uint16_t *bmp_idx;
};
在 lvgl 中，定义字形的结构体为
typedef struct {
const struct _lv_font_t *resolved_font; /* 回退 (fallback) 字体 */
uint16_t adv_w; /* 对应 grub2 中的 device_width */
uint16_t box_w; /* 对应 grub2 中的 width */
uint16_t box_h; /* 对应 grub2 中的 height */
int16_t ofs_x;/* 对应 grub2 中的 offset_x */
int16_t ofs_y;/* 对应 grub2 中的 offset_y */
uint8_t bpp: 4;/* 每像素占据的位宽，对于 grub2，bpp=1 */
uint8_t is_placeholder: 1; /* 是否为占位符 (字体缺少对应字形时显示的占位符) */
} lv_font_glyph_dsc_t;
lvgl 字体的定义为
typedef struct _lv_font_t {
/* 回调函数，用来获取字形的信息 (宽/高等) */
bool (*get_glyph_dsc)(const struct _lv_font_t *, lv_font_glyph_dsc_t *, uint32_t letter, uint32_t letter_next);
/* 回调函数，用来获取字形的位图 */
const uint8_t * (*get_glyph_bitmap)(const struct _lv_font_t *, uint32_t);
/* 任意文本能满足的实际行高度 */
/* 应该对应 grub2 的 max_char_height */
lv_coord_t line_height;
/* 基线，似乎 lvgl 是依据字体高度减去这个值来计算的 */
/* 应该对应 grub2 的 descent ? */
lv_coord_t base_line;
/* 值为 LV_FONT_SUBPX_NONE */
uint8_t subpx: 2;
/* Distance between the top of the underline and base line (< 0 means below the base line) */
/* 应该为 descent 的负值 ？*/
int8_t underline_position;
/* Thickness of the underline */
/* 不知道 */
int8_t underline_thickness;
/* 存储对应的 grub_font_t */
const void * dsc;
const struct _lv_font_t * fallback;
} lv_font_t;
创建 grub-core/lvgl/port/lv_port_font.c 和 grub-core/lvgl/port/lv_port_font.h。
用来从 grub2 pf2 字体取得字形信息的回调函数：
static bool
grub_lvgl_get_glyph_dsc(const lv_font_t *font,
lv_font_glyph_dsc_t *dsc_out,
uint32_t letter, uint32_t letter_next)
{
(void) letter_next;
grub_font_t pf2_font = font->dsc;
struct grub_font_glyph *glyph;
glyph = grub_font_get_glyph_with_fallback(pf2_font, letter);
dsc_out->adv_w = glyph->device_width;
dsc_out->box_h = glyph->height;
dsc_out->box_w = glyph->width;
dsc_out->ofs_x = glyph->offset_x;
dsc_out->ofs_y = glyph->offset_y;
dsc_out->bpp = 1;
return true;
}
如果字体为斜体 (Italic)，且为字符串最后一个字符，adv_w 应该特殊处理。但是正常人在 grub2 下不会用斜体，因此暂不考虑。
grub2 也不支持阿拉伯文等的连字，因此暂时不用考虑下一个字符的不同导致本字符字形的变化。
如果考虑连字和从右向左书写的文字 (如希伯来文/阿拉伯文)，似乎应该使用 grub_font_construct_glyph 函数。
从 grub2 获取字形位图的回调函数：
static const uint8_t *
grub_lvgl_get_glyph_bitmap(const lv_font_t *font, uint32_t unicode_letter)
{
grub_font_t pf2_font = font->dsc;
struct grub_font_glyph *glyph;
glyph = grub_font_get_glyph_with_fallback(pf2_font, unicode_letter);
return glyph->bitmap;
}
将 grub2 字体转成 lvgl 字体的函数：
void lv_port_font_get(lv_font_t *font, const char *name)
{
grub_font_t pf2_font = grub_font_get(name);
font->get_glyph_dsc = grub_lvgl_get_glyph_dsc;
font->get_glyph_bitmap = grub_lvgl_get_glyph_bitmap;
font->line_height = grub_font_get_max_char_height(pf2_font);
font->base_line = grub_font_get_descent(pf2_font);
font->subpx = LV_FONT_SUBPX_NONE;
font->underline_position = -grub_font_get_descent(pf2_font); // 似乎有问题，将来再改
font->dsc = pf2_font;
}
在 lvgltest 中进行测试：
static lv_font_t lv_font_unifont;
lv_port_font_get(&lv_font_unifont, "Unifont");
将 lv_font_simsun_16_cjk 替换为 lv_font_unifont。
可以正常显示 grub2 的字体了。但是字符高度好像有问题 (调整 underline_position ?)。
另外要处理不可打印字符 (CR, LF等)。 ---未完成---
10. 用lvgl实现grub2 boot_menu 和 terminal_box 组件 ---未完成---
11. lvgl 接管 grub2 gfxmenu
12. 实现鼠标支持
---占楼结束--- 不明觉厉
页:
[1]