LVGL 在 GRUB2 上的移植

wintoflash

效果测试：


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 开发者手册
  

myes001

确实厉害，到哪一步了？

zash

不明觉厉

wintoflash

---占楼结束---

wintoflash

---未完成---
11. lvgl 接管 grub2 gfxmenu
12. 实现鼠标支持

wintoflash

---未完成---
10. 用lvgl实现grub2 boot_menu 和 terminal_box 组件

wintoflash

9. 接入 GRUB2 pf2 字体支持
GRUB2 采用的是自定义的 PFF2 点阵字体格式 (https://www.gnu.org/software/gru ... F2-Font-File-Format)
它提供了 grub-mkfont 工具，调用 freetype 以实现 ttf->pf2 字体格式的转换。
在 GRUB2 加载字体后，每个字形 (glyph) 都会被转化成以下格式的结构体：

1. struct grub_font_glyph
   
2. {
   
3.   grub_font_t font;
   
4.   /* 字形宽度 (不包含 Horizonal leading，也就是两个字符之间的空隙) */
   
5.   grub_uint16_t width;
   
6. 
   
7.   /* 字形高度  */
   
8.   grub_uint16_t height;
   
9. 
   
10.   /* 位图 x 偏移  */
    
11.   grub_int16_t offset_x;
    
12. 
    
13.   /* 位图 y 偏移  */
    
14.   grub_int16_t offset_y;
    
15. 
    
16.   /* Horizonal leading 的有效值  */
    
17.   grub_uint16_t device_width;
    
18. 
    
19.   /* 字形的位图，每个比特对应一个像素 (bpp=1)  */
    
20.   grub_uint8_t bitmap[0];
    
21. };

复制代码

所有的字形，组成了字体 (font)。

1. struct grub_font
   
2. {
   
3.   char *name;
   
4.   grub_file_t file;
   
5.   char *family;
   
6.   short point_size;
   
7.   short weight;
   
8.   /* 最大宽度 */
   
9.   short max_char_width;
   
10.   /* 最大高度 */
    
11.   short max_char_height;
    
12.   /* 基线 (base line) 之上的空间 */
    
13.   short ascent;
    
14. /* 基线 (base line) 之下的空间 */
    
15.   short descent;
    
16.   short leading;
    
17.   grub_uint32_t num_chars;
    
18.   struct char_index_entry *char_index;
    
19.   grub_uint16_t *bmp_idx;
    
20. };

复制代码

在 lvgl 中，定义字形的结构体为

1. typedef struct {
   
2.     const struct _lv_font_t *resolved_font; /* 回退 (fallback) 字体 */
   
3.     uint16_t adv_w; /* 对应 grub2 中的 device_width */
   
4.     uint16_t box_w; /* 对应 grub2 中的 width */
   
5.     uint16_t box_h; /* 对应 grub2 中的 height */
   
6.     int16_t ofs_x;  /* 对应 grub2 中的 offset_x */
   
7.     int16_t ofs_y;  /* 对应 grub2 中的 offset_y */
   
8.     uint8_t bpp: 4;  /* 每像素占据的位宽，对于 grub2，bpp=1 */
   
9.     uint8_t is_placeholder: 1; /* 是否为占位符 (字体缺少对应字形时显示的占位符) */
   
10. } lv_font_glyph_dsc_t;

复制代码

lvgl 字体的定义为

1. typedef struct _lv_font_t {
   
2.     /* 回调函数，用来获取字形的信息 (宽/高等) */
   
3.     bool (*get_glyph_dsc)(const struct _lv_font_t *, lv_font_glyph_dsc_t *, uint32_t letter, uint32_t letter_next);
   
4.     /* 回调函数，用来获取字形的位图 */
   
5.     const uint8_t * (*get_glyph_bitmap)(const struct _lv_font_t *, uint32_t);
   
6.     /* 任意文本能满足的实际行高度 */
   
7.     /* 应该对应 grub2 的 max_char_height */
   
8.     lv_coord_t line_height;
   
9.     /* 基线，似乎 lvgl 是依据字体高度减去这个值来计算的 */
   
10.     /* 应该对应 grub2 的 descent ? */
    
11.     lv_coord_t base_line;
    
12.     /* 值为 LV_FONT_SUBPX_NONE */
    
13.     uint8_t subpx  : 2;
    
14.     /* Distance between the top of the underline and base line (< 0 means below the base line) */
    
15.     /* 应该为 descent 的负值 ？*/
    
16.     int8_t underline_position;
    
17.     /* Thickness of the underline */
    
18.     /* 不知道 */
    
19.     int8_t underline_thickness;
    
20.     /* 存储对应的 grub_font_t */
    
21.     const void * dsc;
    
22.     const struct _lv_font_t * fallback;
    
23. } lv_font_t;

复制代码

创建 grub-core/lvgl/port/lv_port_font.c 和 grub-core/lvgl/port/lv_port_font.h。
用来从 grub2 pf2 字体取得字形信息的回调函数：

1. static bool
   
2. grub_lvgl_get_glyph_dsc(const lv_font_t *font,
   
3.                         lv_font_glyph_dsc_t *dsc_out,
   
4.                         uint32_t letter, uint32_t letter_next)
   
5. {
   
6.   (void) letter_next;
   
7.   grub_font_t pf2_font = font->dsc;
   
8.   struct grub_font_glyph *glyph;
   
9. 
   
10.   glyph = grub_font_get_glyph_with_fallback(pf2_font, letter);
    
11. 
    
12.   dsc_out->adv_w = glyph->device_width;
    
13.   dsc_out->box_h = glyph->height;
    
14.   dsc_out->box_w = glyph->width;
    
15.   dsc_out->ofs_x = glyph->offset_x;
    
16.   dsc_out->ofs_y = glyph->offset_y;
    
17.   dsc_out->bpp = 1;
    
18. 
    
19.   return true;
    
20. }

复制代码

如果字体为斜体 (Italic)，且为字符串最后一个字符，adv_w 应该特殊处理。但是正常人在 grub2 下不会用斜体，因此暂不考虑。
grub2 也不支持阿拉伯文等的连字，因此暂时不用考虑下一个字符的不同导致本字符字形的变化。
如果考虑连字和从右向左书写的文字 (如希伯来文/阿拉伯文)，似乎应该使用 grub_font_construct_glyph 函数。
从 grub2 获取字形位图的回调函数：

1. static const uint8_t *
   
2. grub_lvgl_get_glyph_bitmap(const lv_font_t *font, uint32_t unicode_letter)
   
3. {
   
4.   grub_font_t pf2_font = font->dsc;
   
5.   struct grub_font_glyph *glyph;
   
6. 
   
7.   glyph = grub_font_get_glyph_with_fallback(pf2_font, unicode_letter);
   
8.   return glyph->bitmap;
   
9. }

复制代码

将 grub2 字体转成 lvgl 字体的函数：

1. void lv_port_font_get(lv_font_t *font, const char *name)
   
2. {
   
3.   grub_font_t pf2_font = grub_font_get(name);
   
4.   font->get_glyph_dsc = grub_lvgl_get_glyph_dsc;
   
5.   font->get_glyph_bitmap = grub_lvgl_get_glyph_bitmap;
   
6.   font->line_height = grub_font_get_max_char_height(pf2_font);
   
7.   font->base_line = grub_font_get_descent(pf2_font);
   
8.   font->subpx = LV_FONT_SUBPX_NONE;
   
9.   font->underline_position = -grub_font_get_descent(pf2_font); // 似乎有问题，将来再改
   
10.   font->dsc = pf2_font;
    
11. }

复制代码

在 lvgltest 中进行测试：

1. static lv_font_t lv_font_unifont;
   
2. lv_port_font_get(&lv_font_unifont, "Unifont");

复制代码

将 lv_font_simsun_16_cjk 替换为 lv_font_unifont。

可以正常显示 grub2 的字体了。但是字符高度好像有问题 (调整 underline_position ?)。
另外要处理不可打印字符 (CR, LF等)。

wintoflash

7. 添加输入设备支持 (键盘)
文档：https://docs.lvgl.io/master/porting/indev.html

暂时仅添加键盘驱动。使用 grub_getkey_no_block() 从 GRUB2 终端获取按键。
根据 lvgl/src/core/lv_group.h，下列按键需要特殊处理：

1. enum {
   
2.     LV_KEY_UP        = 17,  /*0x11*/
   
3.     LV_KEY_DOWN      = 18,  /*0x12*/
   
4.     LV_KEY_RIGHT     = 19,  /*0x13*/
   
5.     LV_KEY_LEFT      = 20,  /*0x14*/
   
6.     LV_KEY_ESC       = 27,  /*0x1B*/
   
7.     LV_KEY_DEL       = 127, /*0x7F*/
   
8.     LV_KEY_BACKSPACE = 8,   /*0x08*/
   
9.     LV_KEY_ENTER     = 10,  /*0x0A, '\n'*/
   
10.     LV_KEY_NEXT      = 9,   /*0x09, '\t'*/
    
11.     LV_KEY_PREV      = 11,  /*0x0B, '*/
    
12.     LV_KEY_HOME      = 2,   /*0x02, STX*/
    
13.     LV_KEY_END       = 3,   /*0x03, ETX*/
    
14. };

复制代码

添加 grub-core/lvgl/port/lv_port_indev.c：

1. /*
   
2. *  GRUB  --  GRand Unified Bootloader
   
3. *  Copyright (C) 2022  A1ive
   
4. *
   
5. *  GRUB is free software: you can redistribute it and/or modify
   
6. *  it under the terms of the GNU General Public License as published by
   
7. *  the Free Software Foundation, either version 3 of the License, or
   
8. *  (at your option) any later version.
   
9. *
   
10. *  GRUB is distributed in the hope that it will be useful,
    
11. *  but WITHOUT ANY WARRANTY; without even the implied warranty of
    
12. *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    
13. *  GNU General Public License for more details.
    
14. *
    
15. *  You should have received a copy of the GNU General Public License
    
16. *  along with GRUB.  If not, see <http://www.gnu.org/licenses/>.
    
17. */
    
18. 
    
19. #include <grub/misc.h>
    
20. #include <grub/mm.h>
    
21. #include <grub/term.h>
    
22. 
    
23. #include "../lvgl.h"
    
24. #include "lv_port_indev.h"
    
25. 
    
26. static lv_indev_drv_t grub_lvgl_indev_drv;
    
27. lv_indev_t *grub_lvgl_indev_kbd;
    
28. 
    
29. static void
    
30. grub_lvgl_kbd_read_cb (lv_indev_drv_t *indev_drv, lv_indev_data_t *data)
    
31. {
    
32.   (void) indev_drv;
    
33.   static uint32_t last_key = 0, act_key = 0;
    
34.   /*Get whether the a key is pressed and save the pressed key*/
    
35.   int key = grub_getkey_noblock();
    
36.   if(key != GRUB_TERM_NO_KEY)
    
37.   {
    
38.     data->state = LV_INDEV_STATE_PR;
    
39.     switch(key)
    
40.     {
    
41.       case GRUB_TERM_KEY_UP:
    
42.       case GRUB_TERM_CTRL | 'p':
    
43.         act_key = LV_KEY_UP;
    
44.         break;
    
45.       case GRUB_TERM_KEY_DOWN:
    
46.       case GRUB_TERM_CTRL | 'n':
    
47.         act_key = LV_KEY_DOWN;
    
48.         break;
    
49.       case GRUB_TERM_KEY_RIGHT:
    
50.       case GRUB_TERM_CTRL | 'f':
    
51.         act_key = LV_KEY_RIGHT;
    
52.         break;
    
53.       case GRUB_TERM_KEY_LEFT:
    
54.       case GRUB_TERM_CTRL | 'b':
    
55.         act_key = LV_KEY_LEFT;
    
56.         break;
    
57.       case GRUB_TERM_ESC:
    
58.         act_key = LV_KEY_ESC;
    
59.         break;
    
60.       case GRUB_TERM_KEY_DC:
    
61.       case GRUB_TERM_CTRL | 'd':
    
62.         act_key = LV_KEY_DEL;
    
63.         break;
    
64.       case GRUB_TERM_BACKSPACE:
    
65.       case GRUB_TERM_CTRL | 'h':
    
66.         act_key = LV_KEY_BACKSPACE;
    
67.         break;
    
68.       case '\n':
    
69.       case '\r':
    
70.         act_key = LV_KEY_ENTER;
    
71.         break;
    
72.       case '\t':
    
73.       case GRUB_TERM_KEY_NPAGE:
    
74.       case GRUB_TERM_CTRL | 'i':
    
75.         act_key = LV_KEY_NEXT;
    
76.         break;
    
77.       case '\v':
    
78.       case GRUB_TERM_KEY_PPAGE:
    
79.       case GRUB_TERM_CTRL | 'k':
    
80.         act_key = LV_KEY_PREV;
    
81.         break;
    
82.       case GRUB_TERM_KEY_HOME:
    
83.       case GRUB_TERM_CTRL | 'a':
    
84.         act_key = LV_KEY_HOME;
    
85.         break;
    
86.       case GRUB_TERM_KEY_END:
    
87.       case GRUB_TERM_CTRL | 'e':
    
88.         act_key = LV_KEY_END;
    
89.         break;
    
90.       default:
    
91.         act_key = (uint32_t) key;
    
92.     }
    
93.     last_key = act_key;
    
94.   }
    
95.   else
    
96.   {
    
97.     data->state = LV_INDEV_STATE_REL;
    
98.   }
    
99. 
    
100.   data->key = last_key;
     
101. }
     
102. 
     
103. void lv_port_indev_init(void)
     
104. {
     
105.     /*Register a keypad input device*/
     
106.     lv_indev_drv_init(&grub_lvgl_indev_drv);
     
107.     grub_lvgl_indev_drv.type = LV_INDEV_TYPE_KEYPAD;
     
108.     grub_lvgl_indev_drv.read_cb = grub_lvgl_kbd_read_cb;
     
109.     grub_lvgl_indev_kbd = lv_indev_drv_register(&grub_lvgl_indev_drv);
     
110. }

复制代码

grub-core/lvgl/port/lv_port_indev.h

1. #ifndef LV_PORT_INDEV_H
   
2. #define LV_PORT_INDEV_H
   
3. #include "../lvgl.h"
   
4. extern lv_indev_t *grub_lvgl_indev_kbd;
   
5. void lv_port_indev_init(void);
   
6. #endif /*LV_PORT_INDEV_H*/

复制代码

在 grub-core/Makefile.core.def 的 lvgl 一节中加入

1. common = lvgl/port/lv_port_indev.c;

复制代码

编辑 grub-core/commands/lvgltest.c，加入输入设备相关代码：

1. ...
   
2. #include <grub/time.h>
   
3. #include <port/lv_port_indev.h>
   
4. ...
   
5.   grub_printf("lv_port_disp_init OK.\n");
   
6.   grub_refresh();
   
7.   lv_port_indev_init();
   
8.   grub_printf("lv_port_indev_init OK.\n");
   
9.   grub_refresh();
   
10. 
    
11.   lv_group_t *g = lv_group_create();
    
12.   lv_group_set_default(g);
    
13.   lv_indev_set_group(grub_lvgl_indev_kbd, g);
    
14. ...
    
15.   while (1)
    
16.   {
    
17.     lv_tick_inc(5);
    
18.     lv_task_handler();
    
19.     grub_millisleep(5);
    
20.   }
    

复制代码

wintoflash

6. 添加显示界面
文档：https://docs.lvgl.io/master/porting/display.html
目前仅用于测试 LVGL 是否正常工作，暂不考虑效率，因此使用 Full refresh (One buffer) 模式。
测试中文显示和拼音输入法：

创建 grub-core/lvgl/port/lv_port_disp.c：

1. /*
   
2. *  GRUB  --  GRand Unified Bootloader
   
3. *  Copyright (C) 2022  A1ive
   
4. *
   
5. *  GRUB is free software: you can redistribute it and/or modify
   
6. *  it under the terms of the GNU General Public License as published by
   
7. *  the Free Software Foundation, either version 3 of the License, or
   
8. *  (at your option) any later version.
   
9. *
   
10. *  GRUB is distributed in the hope that it will be useful,
    
11. *  but WITHOUT ANY WARRANTY; without even the implied warranty of
    
12. *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    
13. *  GNU General Public License for more details.
    
14. *
    
15. *  You should have received a copy of the GNU General Public License
    
16. *  along with GRUB.  If not, see <http://www.gnu.org/licenses/>.
    
17. */
    
18. 
    
19. #include <grub/misc.h>
    
20. #include <grub/mm.h>
    
21. #include <grub/term.h>
    
22. #include <grub/video.h>
    
23. #include <grub/bitmap.h>
    
24. 
    
25. #include "../lvgl.h"
    
26. #include "lv_port_disp.h"
    
27. 
    
28. static lv_disp_drv_t grub_lvgl_disp_drv;
    
29. static lv_disp_draw_buf_t grub_lvgl_draw_buf;
    
30. static lv_color_t *grub_lvgl_fb;
    
31. static uint32_t grub_lvgl_fb_size;
    
32. static struct grub_video_bitmap grub_lvgl_bmp =
    
33. {
    
34.   .mode_info =
    
35.   {
    
36.     .mode_type = GRUB_VIDEO_MODE_TYPE_RGB | GRUB_VIDEO_MODE_TYPE_ALPHA,
    
37.     .blit_format = GRUB_VIDEO_BLIT_FORMAT_BGRA_8888,
    
38.     .bpp = 32,
    
39.     .bytes_per_pixel = 4,
    
40.     .number_of_colors = 256,
    
41.     .blue_mask_size = 8,
    
42.     .blue_field_pos = 0,
    
43.     .green_mask_size = 8,
    
44.     .green_field_pos = 8,
    
45.     .red_mask_size = 8,
    
46.     .red_field_pos = 16,
    
47.     .reserved_mask_size = 8,
    
48.     .reserved_field_pos = 24,
    
49.   },
    
50. };
    
51. 
    
52. static void
    
53. grub_lvgl_flush_cb (lv_disp_drv_t *disp_drv, const lv_area_t *area, lv_color_t *color_p)
    
54. {
    
55.   unsigned int width, height;
    
56.   width = area->x2 - area->x1 + 1;
    
57.   height = area->y2 - area->y1 + 1;
    
58. 
    
59.   grub_lvgl_bmp.mode_info.width = width;
    
60.   grub_lvgl_bmp.mode_info.height = height;
    
61.   grub_lvgl_bmp.mode_info.pitch = width * 4;
    
62.   grub_lvgl_bmp.data = &color_p->ch;
    
63. 
    
64.   grub_video_blit_bitmap(&grub_lvgl_bmp, GRUB_VIDEO_BLIT_BLEND,
    
65.                          area->x1, area->y1, 0, 0, width, height);
    
66. 
    
67.   grub_refresh();
    
68.   lv_disp_flush_ready(disp_drv);
    
69. }
    
70. 
    
71. 
    
72. grub_err_t
    
73. lv_port_disp_init(void)
    
74. {
    
75.   struct grub_video_mode_info info;
    
76.   if (grub_video_get_info(&info) != GRUB_ERR_NONE)
    
77.     return grub_errno;
    
78.   grub_printf("%ux%ux%u, format=%d\n",
    
79.               info.width, info.height, info.bpp, info.blit_format);
    
80.   grub_lvgl_fb_size = info.height * info.width;
    
81.   grub_lvgl_fb = grub_calloc(sizeof(lv_color_t), grub_lvgl_fb_size);
    
82.   if (!grub_lvgl_fb)
    
83.     return grub_error(GRUB_ERR_OUT_OF_MEMORY, "out of memory");
    
84.   lv_disp_draw_buf_init(&grub_lvgl_draw_buf, grub_lvgl_fb, NULL, grub_lvgl_fb_size);
    
85. 
    
86.   lv_disp_drv_init(&grub_lvgl_disp_drv);
    
87.   grub_lvgl_disp_drv.hor_res = info.width;
    
88.   grub_lvgl_disp_drv.ver_res = info.height;
    
89.   grub_lvgl_disp_drv.draw_buf = &grub_lvgl_draw_buf;
    
90.   grub_lvgl_disp_drv.full_refresh = 1;
    
91.   grub_lvgl_disp_drv.flush_cb = grub_lvgl_flush_cb;
    
92.   lv_disp_drv_register(&grub_lvgl_disp_drv);
    
93. 
    
94.   return GRUB_ERR_NONE;
    
95. }

复制代码

创建 grub-core/lvgl/port/lv_port_disp.h：

1. #ifndef LV_PORT_DISP_H
   
2. #define LV_PORT_DISP_H
   
3. #include <grub/err.h>
   
4. grub_err_t lv_port_disp_init(void);
   
5. #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 一节中加入

1. common = lvgl/port/lv_port_disp.c;

复制代码

编辑 grub-core/commands/lvgltest.c，添加如下测试内容：

1. #include <grub/types.h>
   
2. #include <grub/misc.h>
   
3. #include <grub/mm.h>
   
4. #include <grub/err.h>
   
5. #include <grub/dl.h>
   
6. #include <grub/extcmd.h>
   
7. #include <grub/i18n.h>
   
8. #include <grub/term.h>
   
9. 
   
10. #include <lvgl.h>
    
11. #include <port/lv_port_disp.h>
    
12. 
    
13. GRUB_MOD_LICENSE ("GPLv3+");
    
14. 
    
15. static void ta_event_cb(lv_event_t * e)
    
16. {
    
17.   lv_event_code_t code = lv_event_get_code(e);
    
18.   lv_obj_t * ta = lv_event_get_target(e);
    
19.   lv_obj_t * kb = lv_event_get_user_data(e);
    
20. 
    
21.   if(code == LV_EVENT_FOCUSED)
    
22.   {
    
23.     if(lv_indev_get_type(lv_indev_get_act()) != LV_INDEV_TYPE_KEYPAD)
    
24.     {
    
25.       lv_keyboard_set_textarea(kb, ta);
    
26.       lv_obj_clear_flag(kb, LV_OBJ_FLAG_HIDDEN);
    
27.     }
    
28.   }
    
29.   else if(code == LV_EVENT_CANCEL)
    
30.   {
    
31.     lv_obj_add_flag(kb, LV_OBJ_FLAG_HIDDEN);
    
32.     lv_obj_clear_state(ta, LV_STATE_FOCUSED);
    
33.     lv_indev_reset(NULL, ta);   /*To forget the last clicked object to make it focusable again*/
    
34.   }
    
35. }
    
36. 
    
37. static grub_err_t
    
38. grub_cmd_lvgl (grub_extcmd_context_t ctxt __attribute__ ((unused)),
    
39.                int argc __attribute__ ((unused)),
    
40.                char **args __attribute__ ((unused)))
    
41. {
    
42.   lv_init ();
    
43.   grub_printf ("lv_init OK.\n");
    
44.   grub_refresh();
    
45.   if (lv_port_disp_init() != GRUB_ERR_NONE)
    
46.   {
    
47.     grub_printf("lv_port_disp_init error %d\n", grub_errno);
    
48.     return grub_errno;
    
49.   }
    
50.   grub_printf("lv_port_disp_init OK.\n");
    
51.   grub_refresh();
    
52. 
    
53.   lv_obj_t * pinyin_ime = lv_ime_pinyin_create(lv_scr_act());
    
54.   lv_obj_set_style_text_font(pinyin_ime, &lv_font_simsun_16_cjk, 0);
    
55. 
    
56.   /* ta1 */
    
57.   lv_obj_t * ta1 = lv_textarea_create(lv_scr_act());
    
58.   lv_textarea_set_one_line(ta1, true);
    
59.   lv_obj_set_style_text_font(ta1, &lv_font_simsun_16_cjk, 0);
    
60.   lv_obj_align(ta1, LV_ALIGN_TOP_LEFT, 0, 0);
    
61. 
    
62.   /*Create a keyboard and add it to ime_pinyin*/
    
63.   lv_obj_t * kb = lv_keyboard_create(lv_scr_act());
    
64.   lv_ime_pinyin_set_keyboard(pinyin_ime, kb);
    
65.   lv_keyboard_set_textarea(kb, ta1);
    
66. 
    
67.   lv_obj_add_event_cb(ta1, ta_event_cb, LV_EVENT_ALL, kb);
    
68. 
    
69.   /*Get the cand_panel, and adjust its size and position*/
    
70.   lv_obj_t * cand_panel = lv_ime_pinyin_get_cand_panel(pinyin_ime);
    
71.   lv_obj_set_size(cand_panel, LV_PCT(100), LV_PCT(10));
    
72.   lv_obj_align_to(cand_panel, kb, LV_ALIGN_OUT_TOP_MID, 0, 0);
    
73. 
    
74.   /*Try using ime_pinyin to output the Chinese below in the ta1 above*/
    
75.   lv_obj_t * cz_label = lv_label_create(lv_scr_act());
    
76.   lv_label_set_text(cz_label,
    
77.                     "嵌入式系统（Embedded System），\n"
    
78.                     "是一种嵌入机械或电气系统内部、具有专一功能和实时计算性能的计算机系统。");
    
79.   lv_obj_set_style_text_font(cz_label, &lv_font_simsun_16_cjk, 0);
    
80.   lv_obj_set_width(cz_label, 310);
    
81.   lv_obj_align_to(cz_label, ta1, LV_ALIGN_OUT_BOTTOM_LEFT, 0, 0);
    
82. 
    
83.   while (1)
    
84.   {
    
85.     lv_tick_inc(5);
    
86.     lv_task_handler();
    
87.   }
    
88. 
    
89.   return 0;
    
90. }

复制代码

编译并在虚拟机中运行测试，即可看到图片所示内容。

wintoflash

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

1. #include <grub/dl.h>
   
2. GRUB_MOD_LICENSE ("GPLv3+");

复制代码

修改 conf/Makefile.common，添加

1. CFLAGS_LVGL = -Wno-discarded-qualifiers -Wno-redundant-decls -Wno-nested-externs -Wno-suggest-attribute=format -Wno-shadow -Wno-incompatible-pointer-types $(CFLAGS_POSIX)
   
2. CPPFLAGS_LVGL = -I$(top_builddir)/grub-core/lvgl/port -DLV_CONF_INCLUDE_SIMPLE $(CPPFLAGS_POSIX)
   
3. 
   
4. CFLAGS_LVGLAPP = $(CFLAGS_POSIX)
   
5. CPPFLAGS_LVGLAPP = $(CPPFLAGS_LVGL) -I$(top_builddir)/grub-core/lvgl

复制代码

修改 grub-core/Makefile.core.def，添加

1. module = {
   
2.   name = lvgl;
   
3.   common = lvgl/port/module.c;
   
4. 
   
5.   common = lvgl/src/core/lv_disp.c;
   
6.   common = lvgl/src/core/lv_group.c;
   
7.   common = lvgl/src/core/lv_indev.c;
   
8.   common = lvgl/src/core/lv_indev_scroll.c;
   
9.   common = lvgl/src/core/lv_obj.c;
   
10.   common = lvgl/src/core/lv_obj_class.c;
    
11.   common = lvgl/src/core/lv_obj_draw.c;
    
12.   common = lvgl/src/core/lv_obj_pos.c;
    
13.   common = lvgl/src/core/lv_obj_scroll.c;
    
14.   common = lvgl/src/core/lv_obj_style.c;
    
15.   common = lvgl/src/core/lv_obj_style_gen.c;
    
16.   common = lvgl/src/core/lv_obj_tree.c;
    
17.   common = lvgl/src/core/lv_event.c;
    
18.   common = lvgl/src/core/lv_refr.c;
    
19.   common = lvgl/src/core/lv_theme.c;
    
20. 
    
21.   common = lvgl/src/draw/lv_draw_arc.c;
    
22.   common = lvgl/src/draw/lv_draw.c;
    
23.   common = lvgl/src/draw/lv_draw_img.c;
    
24.   common = lvgl/src/draw/lv_draw_label.c;
    
25.   common = lvgl/src/draw/lv_draw_line.c;
    
26.   common = lvgl/src/draw/lv_draw_mask.c;
    
27.   common = lvgl/src/draw/lv_draw_rect.c;
    
28.   common = lvgl/src/draw/lv_draw_transform.c;
    
29.   common = lvgl/src/draw/lv_draw_layer.c;
    
30.   common = lvgl/src/draw/lv_draw_triangle.c;
    
31.   common = lvgl/src/draw/lv_img_buf.c;
    
32.   common = lvgl/src/draw/lv_img_cache.c;
    
33.   common = lvgl/src/draw/lv_img_decoder.c;
    
34.   common = lvgl/src/draw/sw/lv_draw_sw.c;
    
35.   common = lvgl/src/draw/sw/lv_draw_sw_arc.c;
    
36.   common = lvgl/src/draw/sw/lv_draw_sw_blend.c;
    
37.   common = lvgl/src/draw/sw/lv_draw_sw_dither.c;
    
38.   common = lvgl/src/draw/sw/lv_draw_sw_gradient.c;
    
39.   common = lvgl/src/draw/sw/lv_draw_sw_img.c;
    
40.   common = lvgl/src/draw/sw/lv_draw_sw_letter.c;
    
41.   common = lvgl/src/draw/sw/lv_draw_sw_line.c;
    
42.   common = lvgl/src/draw/sw/lv_draw_sw_polygon.c;
    
43.   common = lvgl/src/draw/sw/lv_draw_sw_rect.c;
    
44.   common = lvgl/src/draw/sw/lv_draw_sw_transform.c;
    
45.   common = lvgl/src/draw/sw/lv_draw_sw_layer.c;
    
46. 
    
47.   common = lvgl/src/font/lv_font.c;
    
48.   common = lvgl/src/font/lv_font_fmt_txt.c;
    
49.   common = lvgl/src/font/lv_font_loader.c;
    
50.   common = lvgl/src/font/lv_font_dejavu_16_persian_hebrew.c;
    
51.   common = lvgl/src/font/lv_font_montserrat_8.c;
    
52.   common = lvgl/src/font/lv_font_montserrat_10.c;
    
53.   common = lvgl/src/font/lv_font_montserrat_12.c;
    
54.   common = lvgl/src/font/lv_font_montserrat_12_subpx.c;
    
55.   common = lvgl/src/font/lv_font_montserrat_14.c;
    
56.   common = lvgl/src/font/lv_font_montserrat_16.c;
    
57.   common = lvgl/src/font/lv_font_montserrat_18.c;
    
58.   common = lvgl/src/font/lv_font_montserrat_20.c;
    
59.   common = lvgl/src/font/lv_font_montserrat_22.c;
    
60.   common = lvgl/src/font/lv_font_montserrat_24.c;
    
61.   common = lvgl/src/font/lv_font_montserrat_26.c;
    
62.   common = lvgl/src/font/lv_font_montserrat_28.c;
    
63.   common = lvgl/src/font/lv_font_montserrat_28_compressed.c;
    
64.   common = lvgl/src/font/lv_font_montserrat_30.c;
    
65.   common = lvgl/src/font/lv_font_montserrat_32.c;
    
66.   common = lvgl/src/font/lv_font_montserrat_34.c;
    
67.   common = lvgl/src/font/lv_font_montserrat_36.c;
    
68.   common = lvgl/src/font/lv_font_montserrat_38.c;
    
69.   common = lvgl/src/font/lv_font_montserrat_40.c;
    
70.   common = lvgl/src/font/lv_font_montserrat_42.c;
    
71.   common = lvgl/src/font/lv_font_montserrat_44.c;
    
72.   common = lvgl/src/font/lv_font_montserrat_46.c;
    
73.   common = lvgl/src/font/lv_font_montserrat_48.c;
    
74.   common = lvgl/src/font/lv_font_simsun_16_cjk.c;
    
75.   common = lvgl/src/font/lv_font_unscii_8.c;
    
76.   common = lvgl/src/font/lv_font_unscii_16.c;
    
77. 
    
78.   common = lvgl/src/hal/lv_hal_disp.c;
    
79.   common = lvgl/src/hal/lv_hal_indev.c;
    
80.   common = lvgl/src/hal/lv_hal_tick.c;
    
81. 
    
82.   common = lvgl/src/misc/lv_anim.c;
    
83.   common = lvgl/src/misc/lv_anim_timeline.c;
    
84.   common = lvgl/src/misc/lv_area.c;
    
85.   common = lvgl/src/misc/lv_async.c;
    
86.   common = lvgl/src/misc/lv_bidi.c;
    
87.   common = lvgl/src/misc/lv_color.c;
    
88.   common = lvgl/src/misc/lv_fs.c;
    
89.   common = lvgl/src/misc/lv_gc.c;
    
90.   common = lvgl/src/misc/lv_ll.c;
    
91.   common = lvgl/src/misc/lv_log.c;
    
92.   common = lvgl/src/misc/lv_lru.c;
    
93.   common = lvgl/src/misc/lv_math.c;
    
94.   common = lvgl/src/misc/lv_mem.c;
    
95.   common = lvgl/src/misc/lv_printf.c;
    
96.   common = lvgl/src/misc/lv_style.c;
    
97.   common = lvgl/src/misc/lv_style_gen.c;
    
98.   common = lvgl/src/misc/lv_timer.c;
    
99.   common = lvgl/src/misc/lv_tlsf.c;
    
100.   common = lvgl/src/misc/lv_txt.c;
     
101.   common = lvgl/src/misc/lv_txt_ap.c;
     
102.   common = lvgl/src/misc/lv_utils.c;
     
103. 
     
104.   common = lvgl/src/widgets/lv_arc.c;
     
105.   common = lvgl/src/widgets/lv_bar.c;
     
106.   common = lvgl/src/widgets/lv_btn.c;
     
107.   common = lvgl/src/widgets/lv_btnmatrix.c;
     
108.   common = lvgl/src/widgets/lv_canvas.c;
     
109.   common = lvgl/src/widgets/lv_checkbox.c;
     
110.   common = lvgl/src/widgets/lv_dropdown.c;
     
111.   common = lvgl/src/widgets/lv_img.c;
     
112.   common = lvgl/src/widgets/lv_label.c;
     
113.   common = lvgl/src/widgets/lv_line.c;
     
114.   common = lvgl/src/widgets/lv_roller.c;
     
115.   common = lvgl/src/widgets/lv_slider.c;
     
116.   common = lvgl/src/widgets/lv_switch.c;
     
117.   common = lvgl/src/widgets/lv_table.c;
     
118.   common = lvgl/src/widgets/lv_textarea.c;
     
119. 
     
120.   common = lvgl/src/extra/lv_extra.c;
     
121. 
     
122.   common = lvgl/src/extra/layouts/flex/lv_flex.c;
     
123.   common = lvgl/src/extra/layouts/grid/lv_grid.c;
     
124. 
     
125.   common = lvgl/src/extra/libs/bmp/lv_bmp.c;
     
126.   common = lvgl/src/extra/libs/gif/gifdec.c;
     
127.   common = lvgl/src/extra/libs/gif/lv_gif.c;
     
128.   common = lvgl/src/extra/libs/png/lodepng.c;
     
129.   common = lvgl/src/extra/libs/png/lv_png.c;
     
130.   common = lvgl/src/extra/libs/sjpg/lv_sjpg.c;
     
131.   common = lvgl/src/extra/libs/sjpg/tjpgd.c;
     
132. 
     
133.   common = lvgl/src/extra/others/fragment/lv_fragment_manager.c;
     
134.   common = lvgl/src/extra/others/fragment/lv_fragment.c;
     
135.   common = lvgl/src/extra/others/gridnav/lv_gridnav.c;
     
136.   common = lvgl/src/extra/others/ime/lv_ime_pinyin.c;
     
137.   common = lvgl/src/extra/others/imgfont/lv_imgfont.c;
     
138.   common = lvgl/src/extra/others/monkey/lv_monkey.c;
     
139.   common = lvgl/src/extra/others/msg/lv_msg.c;
     
140.   common = lvgl/src/extra/others/snapshot/lv_snapshot.c;
     
141. 
     
142.   common = lvgl/src/extra/themes/basic/lv_theme_basic.c;
     
143.   common = lvgl/src/extra/themes/default/lv_theme_default.c;
     
144.   common = lvgl/src/extra/themes/mono/lv_theme_mono.c;
     
145. 
     
146.   common = lvgl/src/extra/widgets/animimg/lv_animimg.c;
     
147.   common = lvgl/src/extra/widgets/calendar/lv_calendar_header_arrow.c;
     
148.   common = lvgl/src/extra/widgets/calendar/lv_calendar_header_dropdown.c;
     
149.   common = lvgl/src/extra/widgets/calendar/lv_calendar.c;
     
150.   common = lvgl/src/extra/widgets/chart/lv_chart.c;
     
151.   common = lvgl/src/extra/widgets/colorwheel/lv_colorwheel.c;
     
152.   common = lvgl/src/extra/widgets/imgbtn/lv_imgbtn.c;
     
153.   common = lvgl/src/extra/widgets/keyboard/lv_keyboard.c;
     
154.   common = lvgl/src/extra/widgets/led/lv_led.c;
     
155.   common = lvgl/src/extra/widgets/list/lv_list.c;
     
156.   common = lvgl/src/extra/widgets/menu/lv_menu.c;
     
157.   common = lvgl/src/extra/widgets/meter/lv_meter.c;
     
158.   common = lvgl/src/extra/widgets/msgbox/lv_msgbox.c;
     
159.   common = lvgl/src/extra/widgets/span/lv_span.c;
     
160.   common = lvgl/src/extra/widgets/spinbox/lv_spinbox.c;
     
161.   common = lvgl/src/extra/widgets/spinner/lv_spinner.c;
     
162.   common = lvgl/src/extra/widgets/tabview/lv_tabview.c;
     
163.   common = lvgl/src/extra/widgets/tileview/lv_tileview.c;
     
164.   common = lvgl/src/extra/widgets/win/lv_win.c;
     
165. 
     
166.   cflags = '$(CFLAGS_LVGL)';
     
167.   cppflags = '$(CPPFLAGS_LVGL)';
     
168. };

复制代码

编辑 grub-core/lvgl/port/lv_conf.h，参考编译配置：

1. /**
   
2. * @file lv_conf.h
   
3. * Configuration file for v8.3.1
   
4. */
   
5. 
   
6. /*
   
7. * Copy this file as `lv_conf.h`
   
8. * 1. simply next to the `lvgl` folder
   
9. * 2. or any other places and
   
10. *    - define `LV_CONF_INCLUDE_SIMPLE`
    
11. *    - add the path as include path
    
12. */
    
13. 
    
14. /* clang-format off */
    
15. #if 1 /*Set it to "1" to enable content*/
    
16. 
    
17. #ifndef LV_CONF_H
    
18. #define LV_CONF_H
    
19. 
    
20. #include <stdint.h>
    
21. 
    
22. /*====================
    
23.    COLOR SETTINGS
    
24. *====================*/
    
25. 
    
26. /*Color depth: 1 (1 byte per pixel), 8 (RGB332), 16 (RGB565), 32 (ARGB8888)*/
    
27. #define LV_COLOR_DEPTH 32
    
28. 
    
29. /*Swap the 2 bytes of RGB565 color. Useful if the display has an 8-bit interface (e.g. SPI)*/
    
30. #define LV_COLOR_16_SWAP 0
    
31. 
    
32. /*Enable features to draw on transparent background.
    
33. *It's required if opa, and transform_* style properties are used.
    
34. *Can be also used if the UI is above another layer, e.g. an OSD menu or video player.*/
    
35. #define LV_COLOR_SCREEN_TRANSP 1
    
36. 
    
37. /* Adjust color mix functions rounding. GPUs might calculate color mix (blending) differently.
    
38. * 0: round down, 64: round up from x.75, 128: round up from half, 192: round up from x.25, 254: round up */
    
39. #define LV_COLOR_MIX_ROUND_OFS 0
    
40. 
    
41. /*Images pixels with this color will not be drawn if they are chroma keyed)*/
    
42. #define LV_COLOR_CHROMA_KEY lv_color_hex(0x00ff00)         /*pure green*/
    
43. 
    
44. /*=========================
    
45.    MEMORY SETTINGS
    
46. *=========================*/
    
47. 
    
48. /*1: use custom malloc/free, 0: use the built-in `lv_mem_alloc()` and `lv_mem_free()`*/
    
49. #define LV_MEM_CUSTOM 1
    
50. #if LV_MEM_CUSTOM == 0
    
51.     /*Size of the memory available for `lv_mem_alloc()` in bytes (>= 2kB)*/
    
52.     #define LV_MEM_SIZE (48U * 1024U)          /*[bytes]*/
    
53. 
    
54.     /*Set an address for the memory pool instead of allocating it as a normal array. Can be in external SRAM too.*/
    
55.     #define LV_MEM_ADR 0     /*0: unused*/
    
56.     /*Instead of an address give a memory allocator that will be called to get a memory pool for LVGL. E.g. my_malloc*/
    
57.     #if LV_MEM_ADR == 0
    
58.         #undef LV_MEM_POOL_INCLUDE
    
59.         #undef LV_MEM_POOL_ALLOC
    
60.     #endif
    
61. 
    
62. #else       /*LV_MEM_CUSTOM*/
    
63.     #define LV_MEM_CUSTOM_INCLUDE <stdlib.h>   /*Header for the dynamic memory function*/
    
64.     #define LV_MEM_CUSTOM_ALLOC   malloc
    
65.     #define LV_MEM_CUSTOM_FREE    free
    
66.     #define LV_MEM_CUSTOM_REALLOC realloc
    
67. #endif     /*LV_MEM_CUSTOM*/
    
68. 
    
69. /*Number of the intermediate memory buffer used during rendering and other internal processing mechanisms.
    
70. *You will see an error log message if there wasn't enough buffers. */
    
71. #define LV_MEM_BUF_MAX_NUM 16
    
72. 
    
73. /*Use the standard `memcpy` and `memset` instead of LVGL's own functions. (Might or might not be faster).*/
    
74. #define LV_MEMCPY_MEMSET_STD 1
    
75. 
    
76. /*====================
    
77.    HAL SETTINGS
    
78. *====================*/
    
79. 
    
80. /*Default display refresh period. LVG will redraw changed areas with this period time*/
    
81. #define LV_DISP_DEF_REFR_PERIOD 30      /*[ms]*/
    
82. 
    
83. /*Input device read period in milliseconds*/
    
84. #define LV_INDEV_DEF_READ_PERIOD 30     /*[ms]*/
    
85. 
    
86. /*Use a custom tick source that tells the elapsed time in milliseconds.
    
87. *It removes the need to manually update the tick with `lv_tick_inc()`)*/
    
88. #define LV_TICK_CUSTOM 0
    
89. #if LV_TICK_CUSTOM
    
90.     #define LV_TICK_CUSTOM_INCLUDE "Arduino.h"         /*Header for the system time function*/
    
91.     #define LV_TICK_CUSTOM_SYS_TIME_EXPR (millis())    /*Expression evaluating to current system time in ms*/
    
92. #endif   /*LV_TICK_CUSTOM*/
    
93. 
    
94. /*Default Dot Per Inch. Used to initialize default sizes such as widgets sized, style paddings.
    
95. *(Not so important, you can adjust it to modify default sizes and spaces)*/
    
96. #define LV_DPI_DEF 130     /*[px/inch]*/
    
97. 
    
98. /*=======================
    
99. * FEATURE CONFIGURATION
    
100. *=======================*/
     
101. 
     
102. /*-------------
     
103. * Drawing
     
104. *-----------*/
     
105. 
     
106. /*Enable complex draw engine.
     
107. *Required to draw shadow, gradient, rounded corners, circles, arc, skew lines, image transformations or any masks*/
     
108. #define LV_DRAW_COMPLEX 1
     
109. #if LV_DRAW_COMPLEX != 0
     
110. 
     
111.     /*Allow buffering some shadow calculation.
     
112.     *LV_SHADOW_CACHE_SIZE is the max. shadow size to buffer, where shadow size is `shadow_width + radius`
     
113.     *Caching has LV_SHADOW_CACHE_SIZE^2 RAM cost*/
     
114.     #define LV_SHADOW_CACHE_SIZE 0
     
115. 
     
116.     /* Set number of maximally cached circle data.
     
117.     * The circumference of 1/4 circle are saved for anti-aliasing
     
118.     * radius * 4 bytes are used per circle (the most often used radiuses are saved)
     
119.     * 0: to disable caching */
     
120.     #define LV_CIRCLE_CACHE_SIZE 4
     
121. #endif /*LV_DRAW_COMPLEX*/
     
122. 
     
123. /**
     
124. * "Simple layers" are used when a widget has `style_opa < 255` to buffer the widget into a layer
     
125. * and blend it as an image with the given opacity.
     
126. * Note that `bg_opa`, `text_opa` etc don't require buffering into layer)
     
127. * The widget can be buffered in smaller chunks to avoid using large buffers.
     
128. *
     
129. * - LV_LAYER_SIMPLE_BUF_SIZE: [bytes] the optimal target buffer size. LVGL will try to allocate it
     
130. * - LV_LAYER_SIMPLE_FALLBACK_BUF_SIZE: [bytes]  used if `LV_LAYER_SIMPLE_BUF_SIZE` couldn't be allocated.
     
131. *
     
132. * Both buffer sizes are in bytes.
     
133. * "Transformed layers" (where transform_angle/zoom properties are used) use larger buffers
     
134. * and can't be drawn in chunks. So these settings affects only widgets with opacity.
     
135. */
     
136. #define LV_LAYER_SIMPLE_BUF_SIZE          (24 * 1024)
     
137. #define LV_LAYER_SIMPLE_FALLBACK_BUF_SIZE (3 * 1024)
     
138. 
     
139. /*Default image cache size. Image caching keeps the images opened.
     
140. *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)
     
141. *With complex image decoders (e.g. PNG or JPG) caching can save the continuous open/decode of images.
     
142. *However the opened images might consume additional RAM.
     
143. *0: to disable caching*/
     
144. #define LV_IMG_CACHE_DEF_SIZE 1
     
145. 
     
146. /*Number of stops allowed per gradient. Increase this to allow more stops.
     
147. *This adds (sizeof(lv_color_t) + 1) bytes per additional stop*/
     
148. #define LV_GRADIENT_MAX_STOPS 2
     
149. 
     
150. /*Default gradient buffer size.
     
151. *When LVGL calculates the gradient "maps" it can save them into a cache to avoid calculating them again.
     
152. *LV_GRAD_CACHE_DEF_SIZE sets the size of this cache in bytes.
     
153. *If the cache is too small the map will be allocated only while it's required for the drawing.
     
154. *0 mean no caching.*/
     
155. #define LV_GRAD_CACHE_DEF_SIZE 4096
     
156. 
     
157. /*Allow dithering the gradients (to achieve visual smooth color gradients on limited color depth display)
     
158. *LV_DITHER_GRADIENT implies allocating one or two more lines of the object's rendering surface
     
159. *The increase in memory consumption is (32 bits * object width) plus 24 bits * object width if using error diffusion */
     
160. #define LV_DITHER_GRADIENT 1
     
161. #if LV_DITHER_GRADIENT
     
162.     /*Add support for error diffusion dithering.
     
163.      *Error diffusion dithering gets a much better visual result, but implies more CPU consumption and memory when drawing.
     
164.      *The increase in memory consumption is (24 bits * object's width)*/
     
165.     #define LV_DITHER_ERROR_DIFFUSION 1
     
166. #endif
     
167. 
     
168. /*Maximum buffer size to allocate for rotation.
     
169. *Only used if software rotation is enabled in the display driver.*/
     
170. #define LV_DISP_ROT_MAX_BUF (10*1024)
     
171. 
     
172. /*-------------
     
173. * GPU
     
174. *-----------*/
     
175. 
     
176. /*Use Arm's 2D acceleration library Arm-2D */
     
177. #define LV_USE_GPU_ARM2D 0
     
178. 
     
179. /*Use STM32's DMA2D (aka Chrom Art) GPU*/
     
180. #define LV_USE_GPU_STM32_DMA2D 0
     
181. #if LV_USE_GPU_STM32_DMA2D
     
182.     /*Must be defined to include path of CMSIS header of target processor
     
183.     e.g. "stm32f769xx.h" or "stm32f429xx.h"*/
     
184.     #define LV_GPU_DMA2D_CMSIS_INCLUDE
     
185. #endif
     
186. 
     
187. /*Use SWM341's DMA2D GPU*/
     
188. #define LV_USE_GPU_SWM341_DMA2D 0
     
189. #if LV_USE_GPU_SWM341_DMA2D
     
190.     #define LV_GPU_SWM341_DMA2D_INCLUDE "SWM341.h"
     
191. #endif
     
192. 
     
193. /*Use NXP's PXP GPU iMX RTxxx platforms*/
     
194. #define LV_USE_GPU_NXP_PXP 0
     
195. #if LV_USE_GPU_NXP_PXP
     
196.     /*1: Add default bare metal and FreeRTOS interrupt handling routines for PXP (lv_gpu_nxp_pxp_osa.c)
     
197.     *   and call lv_gpu_nxp_pxp_init() automatically during lv_init(). Note that symbol SDK_OS_FREE_RTOS
     
198.     *   has to be defined in order to use FreeRTOS OSA, otherwise bare-metal implementation is selected.
     
199.     *0: lv_gpu_nxp_pxp_init() has to be called manually before lv_init()
     
200.     */
     
201.     #define LV_USE_GPU_NXP_PXP_AUTO_INIT 0
     
202. #endif
     
203. 
     
204. /*Use NXP's VG-Lite GPU iMX RTxxx platforms*/
     
205. #define LV_USE_GPU_NXP_VG_LITE 0
     
206. 
     
207. /*Use SDL renderer API*/
     
208. #define LV_USE_GPU_SDL 0
     
209. #if LV_USE_GPU_SDL
     
210.     #define LV_GPU_SDL_INCLUDE_PATH <SDL2/SDL.h>
     
211.     /*Texture cache size, 8MB by default*/
     
212.     #define LV_GPU_SDL_LRU_SIZE (1024 * 1024 * 8)
     
213.     /*Custom blend mode for mask drawing, disable if you need to link with older SDL2 lib*/
     
214.     #define LV_GPU_SDL_CUSTOM_BLEND_MODE (SDL_VERSION_ATLEAST(2, 0, 6))
     
215. #endif
     
216. 
     
217. /*-------------
     
218. * Logging
     
219. *-----------*/
     
220. 
     
221. /*Enable the log module*/
     
222. #define LV_USE_LOG 0
     
223. #if LV_USE_LOG
     
224. 
     
225.     /*How important log should be added:
     
226.     *LV_LOG_LEVEL_TRACE       A lot of logs to give detailed information
     
227.     *LV_LOG_LEVEL_INFO        Log important events
     
228.     *LV_LOG_LEVEL_WARN        Log if something unwanted happened but didn't cause a problem
     
229.     *LV_LOG_LEVEL_ERROR       Only critical issue, when the system may fail
     
230.     *LV_LOG_LEVEL_USER        Only logs added by the user
     
231.     *LV_LOG_LEVEL_NONE        Do not log anything*/
     
232.     #define LV_LOG_LEVEL LV_LOG_LEVEL_WARN
     
233. 
     
234.     /*1: Print the log with 'printf';
     
235.     *0: User need to register a callback with `lv_log_register_print_cb()`*/
     
236.     #define LV_LOG_PRINTF 0
     
237. 
     
238.     /*Enable/disable LV_LOG_TRACE in modules that produces a huge number of logs*/
     
239.     #define LV_LOG_TRACE_MEM        1
     
240.     #define LV_LOG_TRACE_TIMER      1
     
241.     #define LV_LOG_TRACE_INDEV      1
     
242.     #define LV_LOG_TRACE_DISP_REFR  1
     
243.     #define LV_LOG_TRACE_EVENT      1
     
244.     #define LV_LOG_TRACE_OBJ_CREATE 1
     
245.     #define LV_LOG_TRACE_LAYOUT     1
     
246.     #define LV_LOG_TRACE_ANIM       1
     
247. 
     
248. #endif  /*LV_USE_LOG*/
     
249. 
     
250. /*-------------
     
251. * Asserts
     
252. *-----------*/
     
253. 
     
254. /*Enable asserts if an operation is failed or an invalid data is found.
     
255. *If LV_USE_LOG is enabled an error message will be printed on failure*/
     
256. #define LV_USE_ASSERT_NULL          1   /*Check if the parameter is NULL. (Very fast, recommended)*/
     
257. #define LV_USE_ASSERT_MALLOC        1   /*Checks is the memory is successfully allocated or no. (Very fast, recommended)*/
     
258. #define LV_USE_ASSERT_STYLE         1   /*Check if the styles are properly initialized. (Very fast, recommended)*/
     
259. #define LV_USE_ASSERT_MEM_INTEGRITY 0   /*Check the integrity of `lv_mem` after critical operations. (Slow)*/
     
260. #define LV_USE_ASSERT_OBJ           0   /*Check the object's type and existence (e.g. not deleted). (Slow)*/
     
261. 
     
262. /*Add a custom handler when assert happens e.g. to restart the MCU*/
     
263. #define LV_ASSERT_HANDLER_INCLUDE <stdint.h>
     
264. #define LV_ASSERT_HANDLER while(1);   /*Halt by default*/
     
265. 
     
266. /*-------------
     
267. * Others
     
268. *-----------*/
     
269. 
     
270. /*1: Show CPU usage and FPS count*/
     
271. #define LV_USE_PERF_MONITOR 0
     
272. #if LV_USE_PERF_MONITOR
     
273.     #define LV_USE_PERF_MONITOR_POS LV_ALIGN_BOTTOM_RIGHT
     
274. #endif
     
275. 
     
276. /*1: Show the used memory and the memory fragmentation
     
277. * Requires LV_MEM_CUSTOM = 0*/
     
278. #define LV_USE_MEM_MONITOR 0
     
279. #if LV_USE_MEM_MONITOR
     
280.     #define LV_USE_MEM_MONITOR_POS LV_ALIGN_BOTTOM_LEFT
     
281. #endif
     
282. 
     
283. /*1: Draw random colored rectangles over the redrawn areas*/
     
284. #define LV_USE_REFR_DEBUG 0
     
285. 
     
286. /*Change the built in (v)snprintf functions*/
     
287. #define LV_SPRINTF_CUSTOM 0
     
288. #if LV_SPRINTF_CUSTOM
     
289.     #define LV_SPRINTF_INCLUDE <stdio.h>
     
290.     #define lv_snprintf  snprintf
     
291.     #define lv_vsnprintf vsnprintf
     
292. #else   /*LV_SPRINTF_CUSTOM*/
     
293.     #define LV_SPRINTF_USE_FLOAT 0
     
294. #endif  /*LV_SPRINTF_CUSTOM*/
     
295. 
     
296. #define LV_USE_USER_DATA 1
     
297. 
     
298. /*Garbage Collector settings
     
299. *Used if lvgl is bound to higher level language and the memory is managed by that language*/
     
300. #define LV_ENABLE_GC 0
     
301. #if LV_ENABLE_GC != 0
     
302.     #define LV_GC_INCLUDE "gc.h"                           /*Include Garbage Collector related things*/
     
303. #endif /*LV_ENABLE_GC*/
     
304. 
     
305. /*=====================
     
306. *  COMPILER SETTINGS
     
307. *====================*/
     
308. 
     
309. /*For big endian systems set to 1*/
     
310. #ifdef GRUB_CPU_WORDS_BIGENDIAN
     
311. #define LV_BIG_ENDIAN_SYSTEM 1
     
312. #else
     
313. #define LV_BIG_ENDIAN_SYSTEM 0
     
314. #endif
     
315. 
     
316. /*Define a custom attribute to `lv_tick_inc` function*/
     
317. #define LV_ATTRIBUTE_TICK_INC
     
318. 
     
319. /*Define a custom attribute to `lv_timer_handler` function*/
     
320. #define LV_ATTRIBUTE_TIMER_HANDLER
     
321. 
     
322. /*Define a custom attribute to `lv_disp_flush_ready` function*/
     
323. #define LV_ATTRIBUTE_FLUSH_READY
     
324. 
     
325. /*Required alignment size for buffers*/
     
326. #define LV_ATTRIBUTE_MEM_ALIGN_SIZE 1
     
327. 
     
328. /*Will be added where memories needs to be aligned (with -Os data might not be aligned to boundary by default).
     
329. * E.g. __attribute__((aligned(4)))*/
     
330. #define LV_ATTRIBUTE_MEM_ALIGN
     
331. 
     
332. /*Attribute to mark large constant arrays for example font's bitmaps*/
     
333. #define LV_ATTRIBUTE_LARGE_CONST
     
334. 
     
335. /*Compiler prefix for a big array declaration in RAM*/
     
336. #define LV_ATTRIBUTE_LARGE_RAM_ARRAY
     
337. 
     
338. /*Place performance critical functions into a faster memory (e.g RAM)*/
     
339. #define LV_ATTRIBUTE_FAST_MEM
     
340. 
     
341. /*Prefix variables that are used in GPU accelerated operations, often these need to be placed in RAM sections that are DMA accessible*/
     
342. #define LV_ATTRIBUTE_DMA
     
343. 
     
344. /*Export integer constant to binding. This macro is used with constants in the form of LV_<CONST> that
     
345. *should also appear on LVGL binding API such as Micropython.*/
     
346. #define LV_EXPORT_CONST_INT(int_value) struct _silence_gcc_warning /*The default value just prevents GCC warning*/
     
347. 
     
348. /*Extend the default -32k..32k coordinate range to -4M..4M by using int32_t for coordinates instead of int16_t*/
     
349. #define LV_USE_LARGE_COORD 0
     
350. 
     
351. /*==================
     
352. *   FONT USAGE
     
353. *===================*/
     
354. 
     
355. /*Montserrat fonts with ASCII range and some symbols using bpp = 4
     
356. *https://fonts.google.com/specimen/Montserrat*/
     
357. #define LV_FONT_MONTSERRAT_8  1
     
358. #define LV_FONT_MONTSERRAT_10 0
     
359. #define LV_FONT_MONTSERRAT_12 1
     
360. #define LV_FONT_MONTSERRAT_14 1
     
361. #define LV_FONT_MONTSERRAT_16 1
     
362. #define LV_FONT_MONTSERRAT_18 1
     
363. #define LV_FONT_MONTSERRAT_20 0
     
364. #define LV_FONT_MONTSERRAT_22 0
     
365. #define LV_FONT_MONTSERRAT_24 1
     
366. #define LV_FONT_MONTSERRAT_26 0
     
367. #define LV_FONT_MONTSERRAT_28 1
     
368. #define LV_FONT_MONTSERRAT_30 0
     
369. #define LV_FONT_MONTSERRAT_32 1
     
370. #define LV_FONT_MONTSERRAT_34 0
     
371. #define LV_FONT_MONTSERRAT_36 1
     
372. #define LV_FONT_MONTSERRAT_38 0
     
373. #define LV_FONT_MONTSERRAT_40 0
     
374. #define LV_FONT_MONTSERRAT_42 0
     
375. #define LV_FONT_MONTSERRAT_44 0
     
376. #define LV_FONT_MONTSERRAT_46 0
     
377. #define LV_FONT_MONTSERRAT_48 1
     
378. 
     
379. /*Demonstrate special features*/
     
380. #define LV_FONT_MONTSERRAT_12_SUBPX      1
     
381. #define LV_FONT_MONTSERRAT_28_COMPRESSED 1  /*bpp = 3*/
     
382. #define LV_FONT_DEJAVU_16_PERSIAN_HEBREW 1  /*Hebrew, Arabic, Persian letters and all their forms*/
     
383. #define LV_FONT_SIMSUN_16_CJK            1  /*1000 most common CJK radicals*/
     
384. 
     
385. /*Pixel perfect monospace fonts*/
     
386. #define LV_FONT_UNSCII_8  1
     
387. #define LV_FONT_UNSCII_16 1
     
388. 
     
389. /*Optionally declare custom fonts here.
     
390. *You can use these fonts as default font too and they will be available globally.
     
391. *E.g. #define LV_FONT_CUSTOM_DECLARE   LV_FONT_DECLARE(my_font_1) LV_FONT_DECLARE(my_font_2)*/
     
392. #define LV_FONT_CUSTOM_DECLARE
     
393. 
     
394. /*Always set a default font*/
     
395. #define LV_FONT_DEFAULT &lv_font_montserrat_16
     
396. 
     
397. /*Enable handling large font and/or fonts with a lot of characters.
     
398. *The limit depends on the font size, font face and bpp.
     
399. *Compiler error will be triggered if a font needs it.*/
     
400. #define LV_FONT_FMT_TXT_LARGE 1
     
401. 
     
402. /*Enables/disables support for compressed fonts.*/
     
403. #define LV_USE_FONT_COMPRESSED 1
     
404. 
     
405. /*Enable subpixel rendering*/
     
406. #define LV_USE_FONT_SUBPX 0
     
407. #if LV_USE_FONT_SUBPX
     
408.     /*Set the pixel order of the display. Physical order of RGB channels. Doesn't matter with "normal" fonts.*/
     
409.     #define LV_FONT_SUBPX_BGR 0  /*0: RGB; 1:BGR order*/
     
410. #endif
     
411. 
     
412. /*Enable drawing placeholders when glyph dsc is not found*/
     
413. #define LV_USE_FONT_PLACEHOLDER 1
     
414. 
     
415. /*=================
     
416. *  TEXT SETTINGS
     
417. *=================*/
     
418. 
     
419. /**
     
420. * Select a character encoding for strings.
     
421. * Your IDE or editor should have the same character encoding
     
422. * - LV_TXT_ENC_UTF8
     
423. * - LV_TXT_ENC_ASCII
     
424. */
     
425. #define LV_TXT_ENC LV_TXT_ENC_UTF8
     
426. 
     
427. /*Can break (wrap) texts on these chars*/
     
428. #define LV_TXT_BREAK_CHARS " ,.;:-_"
     
429. 
     
430. /*If a word is at least this long, will break wherever "prettiest"
     
431. *To disable, set to a value <= 0*/
     
432. #define LV_TXT_LINE_BREAK_LONG_LEN 0
     
433. 
     
434. /*Minimum number of characters in a long word to put on a line before a break.
     
435. *Depends on LV_TXT_LINE_BREAK_LONG_LEN.*/
     
436. #define LV_TXT_LINE_BREAK_LONG_PRE_MIN_LEN 3
     
437. 
     
438. /*Minimum number of characters in a long word to put on a line after a break.
     
439. *Depends on LV_TXT_LINE_BREAK_LONG_LEN.*/
     
440. #define LV_TXT_LINE_BREAK_LONG_POST_MIN_LEN 3
     
441. 
     
442. /*The control character to use for signalling text recoloring.*/
     
443. #define LV_TXT_COLOR_CMD "#"
     
444. 
     
445. /*Support bidirectional texts. Allows mixing Left-to-Right and Right-to-Left texts.
     
446. *The direction will be processed according to the Unicode Bidirectional Algorithm:
     
447. *https://www.w3.org/International/articles/inline-bidi-markup/uba-basics*/
     
448. #define LV_USE_BIDI 1
     
449. #if LV_USE_BIDI
     
450.     /*Set the default direction. Supported values:
     
451.     *`LV_BASE_DIR_LTR` Left-to-Right
     
452.     *`LV_BASE_DIR_RTL` Right-to-Left
     
453.     *`LV_BASE_DIR_AUTO` detect texts base direction*/
     
454.     #define LV_BIDI_BASE_DIR_DEF LV_BASE_DIR_AUTO
     
455. #endif
     
456. 
     
457. /*Enable Arabic/Persian processing
     
458. *In these languages characters should be replaced with an other form based on their position in the text*/
     
459. #define LV_USE_ARABIC_PERSIAN_CHARS 1
     
460. 
     
461. /*==================
     
462. *  WIDGET USAGE
     
463. *================*/
     
464. 
     
465. /*Documentation of the widgets: https://docs.lvgl.io/latest/en/html/widgets/index.html*/
     
466. 
     
467. #define LV_USE_ARC        1
     
468. 
     
469. #define LV_USE_BAR        1
     
470. 
     
471. #define LV_USE_BTN        1
     
472. 
     
473. #define LV_USE_BTNMATRIX  1
     
474. 
     
475. #define LV_USE_CANVAS     1
     
476. 
     
477. #define LV_USE_CHECKBOX   1
     
478. 
     
479. #define LV_USE_DROPDOWN   1   /*Requires: lv_label*/
     
480. 
     
481. #define LV_USE_IMG        1   /*Requires: lv_label*/
     
482. 
     
483. #define LV_USE_LABEL      1
     
484. #if LV_USE_LABEL
     
485.     #define LV_LABEL_TEXT_SELECTION 1 /*Enable selecting text of the label*/
     
486.     #define LV_LABEL_LONG_TXT_HINT 1  /*Store some extra info in labels to speed up drawing of very long texts*/
     
487. #endif
     
488. 
     
489. #define LV_USE_LINE       1
     
490. 
     
491. #define LV_USE_ROLLER     1   /*Requires: lv_label*/
     
492. #if LV_USE_ROLLER
     
493.     #define LV_ROLLER_INF_PAGES 7 /*Number of extra "pages" when the roller is infinite*/
     
494. #endif
     
495. 
     
496. #define LV_USE_SLIDER     1   /*Requires: lv_bar*/
     
497. 
     
498. #define LV_USE_SWITCH     1
     
499. 
     
500. #define LV_USE_TEXTAREA   1   /*Requires: lv_label*/
     
501. #if LV_USE_TEXTAREA != 0
     
502.     #define LV_TEXTAREA_DEF_PWD_SHOW_TIME 1500    /*ms*/
     
503. #endif
     
504. 
     
505. #define LV_USE_TABLE      1
     
506. 
     
507. /*==================
     
508. * EXTRA COMPONENTS
     
509. *==================*/
     
510. 
     
511. /*-----------
     
512. * Widgets
     
513. *----------*/
     
514. #define LV_USE_ANIMIMG    1
     
515. 
     
516. #define LV_USE_CALENDAR   1
     
517. #if LV_USE_CALENDAR
     
518.     #define LV_CALENDAR_WEEK_STARTS_MONDAY 0
     
519.     #if LV_CALENDAR_WEEK_STARTS_MONDAY
     
520.         #define LV_CALENDAR_DEFAULT_DAY_NAMES {"Mo", "Tu", "We", "Th", "Fr", "Sa", "Su"}
     
521.     #else
     
522.         #define LV_CALENDAR_DEFAULT_DAY_NAMES {"Su", "Mo", "Tu", "We", "Th", "Fr", "Sa"}
     
523.     #endif
     
524. 
     
525.     #define LV_CALENDAR_DEFAULT_MONTH_NAMES {"January", "February", "March",  "April", "May",  "June", "July", "August", "September", "October", "November", "December"}
     
526.     #define LV_USE_CALENDAR_HEADER_ARROW 1
     
527.     #define LV_USE_CALENDAR_HEADER_DROPDOWN 1
     
528. #endif  /*LV_USE_CALENDAR*/
     
529. 
     
530. #define LV_USE_CHART      1
     
531. 
     
532. #define LV_USE_COLORWHEEL 1
     
533. 
     
534. #define LV_USE_IMGBTN     1
     
535. 
     
536. #define LV_USE_KEYBOARD   1
     
537. 
     
538. #define LV_USE_LED        1
     
539. 
     
540. #define LV_USE_LIST       1
     
541. 
     
542. #define LV_USE_MENU       1
     
543. 
     
544. #define LV_USE_METER      1
     
545. 
     
546. #define LV_USE_MSGBOX     1
     
547. 
     
548. #define LV_USE_SPAN       1
     
549. #if LV_USE_SPAN
     
550.     /*A line text can contain maximum num of span descriptor */
     
551.     #define LV_SPAN_SNIPPET_STACK_SIZE 64
     
552. #endif
     
553. 
     
554. #define LV_USE_SPINBOX    1
     
555. 
     
556. #define LV_USE_SPINNER    1
     
557. 
     
558. #define LV_USE_TABVIEW    1
     
559. 
     
560. #define LV_USE_TILEVIEW   1
     
561. 
     
562. #define LV_USE_WIN        1
     
563. 
     
564. /*-----------
     
565. * Themes
     
566. *----------*/
     
567. 
     
568. /*A simple, impressive and very complete theme*/
     
569. #define LV_USE_THEME_DEFAULT 1
     
570. #if LV_USE_THEME_DEFAULT
     
571. 
     
572.     /*0: Light mode; 1: Dark mode*/
     
573.     #define LV_THEME_DEFAULT_DARK 0
     
574. 
     
575.     /*1: Enable grow on press*/
     
576.     #define LV_THEME_DEFAULT_GROW 1
     
577. 
     
578.     /*Default transition time in [ms]*/
     
579.     #define LV_THEME_DEFAULT_TRANSITION_TIME 80
     
580. #endif /*LV_USE_THEME_DEFAULT*/
     
581. 
     
582. /*A very simple theme that is a good starting point for a custom theme*/
     
583. #define LV_USE_THEME_BASIC 1
     
584. 
     
585. /*A theme designed for monochrome displays*/
     
586. #define LV_USE_THEME_MONO 1
     
587. 
     
588. /*-----------
     
589. * Layouts
     
590. *----------*/
     
591. 
     
592. /*A layout similar to Flexbox in CSS.*/
     
593. #define LV_USE_FLEX 1
     
594. 
     
595. /*A layout similar to Grid in CSS.*/
     
596. #define LV_USE_GRID 1
     
597. 
     
598. /*---------------------
     
599. * 3rd party libraries
     
600. *--------------------*/
     
601. 
     
602. /*File system interfaces for common APIs */
     
603. 
     
604. /*API for fopen, fread, etc*/
     
605. #define LV_USE_FS_STDIO 0
     
606. #if LV_USE_FS_STDIO
     
607.     #define LV_FS_STDIO_LETTER '\0'     /*Set an upper cased letter on which the drive will accessible (e.g. 'A')*/
     
608.     #define LV_FS_STDIO_PATH ""         /*Set the working directory. File/directory paths will be appended to it.*/
     
609.     #define LV_FS_STDIO_CACHE_SIZE 0    /*>0 to cache this number of bytes in lv_fs_read()*/
     
610. #endif
     
611. 
     
612. /*API for open, read, etc*/
     
613. #define LV_USE_FS_POSIX 0
     
614. #if LV_USE_FS_POSIX
     
615.     #define LV_FS_POSIX_LETTER '\0'     /*Set an upper cased letter on which the drive will accessible (e.g. 'A')*/
     
616.     #define LV_FS_POSIX_PATH ""         /*Set the working directory. File/directory paths will be appended to it.*/
     
617.     #define LV_FS_POSIX_CACHE_SIZE 0    /*>0 to cache this number of bytes in lv_fs_read()*/
     
618. #endif
     
619. 
     
620. /*API for CreateFile, ReadFile, etc*/
     
621. #define LV_USE_FS_WIN32 0
     
622. #if LV_USE_FS_WIN32
     
623.     #define LV_FS_WIN32_LETTER '\0'     /*Set an upper cased letter on which the drive will accessible (e.g. 'A')*/
     
624.     #define LV_FS_WIN32_PATH ""         /*Set the working directory. File/directory paths will be appended to it.*/
     
625.     #define LV_FS_WIN32_CACHE_SIZE 0    /*>0 to cache this number of bytes in lv_fs_read()*/
     
626. #endif
     
627. 
     
628. /*API for FATFS (needs to be added separately). Uses f_open, f_read, etc*/
     
629. #define LV_USE_FS_FATFS 0
     
630. #if LV_USE_FS_FATFS
     
631.     #define LV_FS_FATFS_LETTER '\0'     /*Set an upper cased letter on which the drive will accessible (e.g. 'A')*/
     
632.     #define LV_FS_FATFS_CACHE_SIZE 0    /*>0 to cache this number of bytes in lv_fs_read()*/
     
633. #endif
     
634. 
     
635. /*PNG decoder library*/
     
636. #define LV_USE_PNG 1
     
637. 
     
638. /*BMP decoder library*/
     
639. #define LV_USE_BMP 1
     
640. 
     
641. /* JPG + split JPG decoder library.
     
642. * Split JPG is a custom format optimized for embedded systems. */
     
643. #define LV_USE_SJPG 1
     
644. 
     
645. /*GIF decoder library*/
     
646. #define LV_USE_GIF 1
     
647. 
     
648. /*QR code library*/
     
649. #define LV_USE_QRCODE 0
     
650. 
     
651. /*FreeType library*/
     
652. #define LV_USE_FREETYPE 0
     
653. #if LV_USE_FREETYPE
     
654.     /*Memory used by FreeType to cache characters [bytes] (-1: no caching)*/
     
655.     #define LV_FREETYPE_CACHE_SIZE (16 * 1024)
     
656.     #if LV_FREETYPE_CACHE_SIZE >= 0
     
657.         /* 1: bitmap cache use the sbit cache, 0:bitmap cache use the image cache. */
     
658.         /* sbit cache:it is much more memory efficient for small bitmaps(font size < 256) */
     
659.         /* if font size >= 256, must be configured as image cache */
     
660.         #define LV_FREETYPE_SBIT_CACHE 0
     
661.         /* Maximum number of opened FT_Face/FT_Size objects managed by this cache instance. */
     
662.         /* (0:use system defaults) */
     
663.         #define LV_FREETYPE_CACHE_FT_FACES 0
     
664.         #define LV_FREETYPE_CACHE_FT_SIZES 0
     
665.     #endif
     
666. #endif
     
667. 
     
668. /*Rlottie library*/
     
669. #define LV_USE_RLOTTIE 0
     
670. 
     
671. /*FFmpeg library for image decoding and playing videos
     
672. *Supports all major image formats so do not enable other image decoder with it*/
     
673. #define LV_USE_FFMPEG 0
     
674. #if LV_USE_FFMPEG
     
675.     /*Dump input information to stderr*/
     
676.     #define LV_FFMPEG_DUMP_FORMAT 0
     
677. #endif
     
678. 
     
679. /*-----------
     
680. * Others
     
681. *----------*/
     
682. 
     
683. /*1: Enable API to take snapshot for object*/
     
684. #define LV_USE_SNAPSHOT 1
     
685. 
     
686. /*1: Enable Monkey test*/
     
687. #define LV_USE_MONKEY 0
     
688. 
     
689. /*1: Enable grid navigation*/
     
690. #define LV_USE_GRIDNAV 1
     
691. 
     
692. /*1: Enable lv_obj fragment*/
     
693. #define LV_USE_FRAGMENT 1
     
694. 
     
695. /*1: Support using images as font in label or span widgets */
     
696. #define LV_USE_IMGFONT 1
     
697. 
     
698. /*1: Enable a published subscriber based messaging system */
     
699. #define LV_USE_MSG 1
     
700. 
     
701. /*1: Enable Pinyin input method*/
     
702. /*Requires: lv_keyboard*/
     
703. #define LV_USE_IME_PINYIN 1
     
704. #if LV_USE_IME_PINYIN
     
705.     /*1: Use default thesaurus*/
     
706.     /*If you do not use the default thesaurus, be sure to use `lv_ime_pinyin` after setting the thesauruss*/
     
707.     #define LV_IME_PINYIN_USE_DEFAULT_DICT 1
     
708.     /*Set the maximum number of candidate panels that can be displayed*/
     
709.     /*This needs to be adjusted according to the size of the screen*/
     
710.     #define LV_IME_PINYIN_CAND_TEXT_NUM 6
     
711. 
     
712.     /*Use 9 key input(k9)*/
     
713.     #define LV_IME_PINYIN_USE_K9_MODE      0
     
714.     #if LV_IME_PINYIN_USE_K9_MODE == 1
     
715.         #define LV_IME_PINYIN_K9_CAND_TEXT_NUM 3
     
716.     #endif // LV_IME_PINYIN_USE_K9_MODE
     
717. #endif
     
718. 
     
719. /*==================
     
720. * EXAMPLES
     
721. *==================*/
     
722. 
     
723. /*Enable the examples to be built with the library*/
     
724. #define LV_BUILD_EXAMPLES 0
     
725. 
     
726. /*===================
     
727. * DEMO USAGE
     
728. ====================*/
     
729. 
     
730. /*Show some widget. It might be required to increase `LV_MEM_SIZE` */
     
731. #define LV_USE_DEMO_WIDGETS 0
     
732. #if LV_USE_DEMO_WIDGETS
     
733. #define LV_DEMO_WIDGETS_SLIDESHOW 0
     
734. #endif
     
735. 
     
736. /*Demonstrate the usage of encoder and keyboard*/
     
737. #define LV_USE_DEMO_KEYPAD_AND_ENCODER 0
     
738. 
     
739. /*Benchmark your system*/
     
740. #define LV_USE_DEMO_BENCHMARK 0
     
741. #if LV_USE_DEMO_BENCHMARK
     
742. /*Use RGB565A8 images with 16 bit color depth instead of ARGB8565*/
     
743. #define LV_DEMO_BENCHMARK_RGB565A8 0
     
744. #endif
     
745. 
     
746. /*Stress test for LVGL*/
     
747. #define LV_USE_DEMO_STRESS 0
     
748. 
     
749. /*Music player demo*/
     
750. #define LV_USE_DEMO_MUSIC 0
     
751. #if LV_USE_DEMO_MUSIC
     
752.     #define LV_DEMO_MUSIC_SQUARE    0
     
753.     #define LV_DEMO_MUSIC_LANDSCAPE 0
     
754.     #define LV_DEMO_MUSIC_ROUND     0
     
755.     #define LV_DEMO_MUSIC_LARGE     0
     
756.     #define LV_DEMO_MUSIC_AUTO_PLAY 0
     
757. #endif
     
758. 
     
759. /*--END OF LV_CONF_H--*/
     
760. 
     
761. #endif /*LV_CONF_H*/
     
762. 
     
763. #endif /*End of "Content enable"*/

复制代码

5. 创建测试模块
grub-core/Makefile.core.def

1. module = {
   
2.   name = lvgltest;
   
3.   common = commands/lvgltest.c;
   
4.   cflags = '$(CFLAGS_LVGLAPP)';
   
5.   cppflags = '$(CPPFLAGS_LVGLAPP)';
   
6. };

复制代码

grub-core/commands/lvgltest.c

1. /*
   
2. *  GRUB  --  GRand Unified Bootloader
   
3. *  Copyright (C) 2022  A1ive
   
4. *
   
5. *  GRUB is free software: you can redistribute it and/or modify
   
6. *  it under the terms of the GNU General Public License as published by
   
7. *  the Free Software Foundation, either version 3 of the License, or
   
8. *  (at your option) any later version.
   
9. *
   
10. *  GRUB is distributed in the hope that it will be useful,
    
11. *  but WITHOUT ANY WARRANTY; without even the implied warranty of
    
12. *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    
13. *  GNU General Public License for more details.
    
14. *
    
15. *  You should have received a copy of the GNU General Public License
    
16. *  along with GRUB.  If not, see <http://www.gnu.org/licenses/>.
    
17. */
    
18. 
    
19. #include <grub/types.h>
    
20. #include <grub/misc.h>
    
21. #include <grub/mm.h>
    
22. #include <grub/err.h>
    
23. #include <grub/dl.h>
    
24. #include <grub/extcmd.h>
    
25. #include <grub/i18n.h>
    
26. 
    
27. #include <lvgl.h>
    
28. 
    
29. GRUB_MOD_LICENSE ("GPLv3+");
    
30. 
    
31. static grub_err_t
    
32. grub_cmd_lvgl (grub_extcmd_context_t ctxt __attribute__ ((unused)),
    
33.                int argc __attribute__ ((unused)),
    
34.                char **args __attribute__ ((unused)))
    
35. {
    
36.   lv_init ();
    
37.   grub_printf ("lv_init OK.\n");
    
38.   return 0;
    
39. }
    
40. 
    
41. static grub_extcmd_t cmd;
    
42. 
    
43. GRUB_MOD_INIT(lvgltest)
    
44. {
    
45.   cmd = grub_register_extcmd ("lvgltest", grub_cmd_lvgl, 0, 0,
    
46.                               N_("LVGL test."), 0);
    
47. }
    
48. 
    
49. GRUB_MOD_FINI(lvgltest)
    
50. {
    
51.   grub_unregister_extcmd (cmd);
    
52. }

复制代码

wintoflash

2. 改造 GRUB2 posix_wrap 库
修改 grub-core/lib/posix_wrap/sys/types.h，添加以下内容：

1. typedef grub_uint64_t uintmax_t;
   
2. typedef grub_int64_t intmax_t;

复制代码

修改 grub-core/lib/posix_wrap/limits.h，添加以下内容：

1. #define INT8_MIN GRUB_SCHAR_MIN
   
2. #define INT8_MAX GRUB_SCHAR_MAX
   
3. #define INT16_MIN GRUB_SHRT_MIN
   
4. #define INT16_MAX GRUB_SHRT_MAX
   
5. #define INT32_MIN GRUB_INT32_MIN
   
6. #define INT32_MAX GRUB_INT32_MAX
   
7. 
   
8. #define UINT8_MAX GRUB_UCHAR_MAX
   
9. #define UINT16_MAX GRUB_USHRT_MAX
   
10. #define UINT32_MAX GRUB_UINT_MAX

复制代码

修改 grub-core/lib/posix_wrap/inttypes.h：

1. #ifndef GRUB_POSIX_INTTYPES_H
   
2. #define GRUB_POSIX_INTTYPES_H
   
3. 
   
4. #include <sys/types.h>
   
5. 
   
6. #define PRId32 PRIdGRUB_INT32_T
   
7. #define PRIu32 PRIuGRUB_UINT32_T
   
8. #define PRIx32 PRIxGRUB_UINT32_T
   
9. 
   
10. #define PRId64 PRIdGRUB_INT64_T
    
11. #define PRIu64 PRIdGRUB_UINT64_T
    
12. #define PRIx64 PRIdGRUB_UINT64_T
    
13. 
    
14. #endif

复制代码

修改 grub-core/lib/posix_wrap/stdint.h，添加以下内容：

1. #include <limits.h>

复制代码

修改 grub-core/lib/posix_wrap/string.h， 添加以下函数：

1. static inline int
   
2. strncmp (const char *s1, const char *s2, grub_size_t n)
   
3. {
   
4.   return grub_strncmp (s1, s2, n);
   
5. }
   
6. 
   
7. static inline char *
   
8. strcat (char *dest, const char *src)
   
9. {
   
10.   grub_strcpy (dest + grub_strlen (dest), src);
    
11.   return dest;
    
12. }

复制代码

3. 修改 GRUB2 compiler-rt
由于 LVGL 中使用到了 64 位整数除法，因此要在 i386 架构下添加 __udivmoddi4 和 __divmoddi4 这两个符号。
修改 include/grub/misc.h：

1. #if !defined(GRUB_MACHINE_EMU) && (defined(__arm__) || defined(__ia64__) || \
   
2.     (defined(__riscv) && (__riscv_xlen == 32)))
   
3. #define GRUB_DIVISION_IN_SOFTWARE 1

复制代码

改为

1. #if !defined(GRUB_MACHINE_EMU) && (defined(__arm__) || defined(__ia64__) || \
   
2.     defined(__i386__) || (defined(__riscv) && (__riscv_xlen == 32)))
   
3. #define GRUB_DIVISION_IN_SOFTWARE 1

复制代码

修改 gentpl.py：

1. GROUPS["softdiv"] = GROUPS["arm"] + ["ia64_efi"] + GROUPS["riscv32"]

复制代码

改为

1. 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 条件里面加入

1. grub_uint64_t
   
2. EXPORT_FUNC (__udivmoddi4) (grub_uint64_t n, grub_uint64_t d, grub_uint64_t *r);
   
3. 
   
4. grub_int64_t
   
5. EXPORT_FUNC(__divmoddi4) (grub_int64_t n, grub_int64_t d, grub_int64_t *r);

复制代码

修改 grub-core/kern/compiler-rt.c，在对应条件下加入

1. grub_uint64_t
   
2. __udivmoddi4 (grub_uint64_t n, grub_uint64_t d, grub_uint64_t *r)
   
3. {
   
4.   return grub_divmod64 (n, d, r);
   
5. }
   
6. 
   
7. grub_int64_t
   
8. __divmoddi4 (grub_int64_t n, grub_int64_t d, grub_int64_t *r)
   
9. {
   
10.   return grub_divmod64s (n, d, r);
    
11. }

复制代码