显示接口

要设置显示，必须初始化 lv_disp_buf_t 和 lv_disp_drv_t 变量。

  • lv_disp_buf_t 保存显示缓冲区信息的结构体

  • lv_disp_drv_t HAL要注册的显示驱动程序、与显示交互并处理与图形相关的结构体、回调函数。

显示缓冲区

lv_disp_buf_t 初始化示例：

1    /*A static or global variable to store the buffers*/
2    static lv_disp_buf_t disp_buf;
3
4    /*Static or global buffer(s). The second buffer is optional*/
5    static lv_color_t buf_1[MY_DISP_HOR_RES * 10];
6    static lv_color_t buf_2[MY_DISP_HOR_RES * 10];
7
8    /*Initialize `disp_buf` with the buffer(s) */
9    lv_disp_buf_init(&disp_buf, buf_1, buf_2, MY_DISP_HOR_RES*10);

关于缓冲区大小，有 3 种情况：

  1. 一个缓冲区 LVGL将屏幕的内保存到缓冲区中并将其发送到显示器。缓冲区可以小于屏幕。在这种情况下，较大的区域将被重画成多个部分。如果只有很小的区域发生变化(例如按下按钮)，则只会刷新该部分的区域。

  2. 两个非屏幕大小的缓冲区 具有两个缓冲区的 LVGL 可以将其中一个作为显示缓冲区，而另一缓冲区的内容发送到后台显示。应该使用 DMA 或其他硬件将数据传输到显示器，以让CPU同时绘图。这样，渲染和刷新并行处理。与 一个缓冲区 的情况类似，如果缓冲区小于要刷新的区域，LVGL将按块绘制显示内容

  3. 两个屏幕大小的缓冲区 与两个非屏幕大小的缓冲区相反，LVGL将始终提供整个屏幕的内容，而不仅仅是块。这样，驱动程序可以简单地将帧缓冲区的地址更改为从 LVGL 接收的缓冲区。因此，当MCU具有 LCD/TFT 接口且帧缓冲区只是 RAM 中的一个位置时，这种方法的效果很好。

显示驱动器

一旦缓冲区初始化准备就绪，就需要初始化显示驱动程序。在最简单的情况下，仅需要设置 lv_disp_drv_t 的以下两个字段：

  • buffer 指向已初始化的 lv_disp_buf_t 变量的指针。

  • flush_cb 回调函数，用于将缓冲区的内容复制到显示的特定区域。刷新准备就绪后，需要调用lv_disp_flush_ready()。 LVGL可能会以多个块呈现屏幕，因此多次调用flush_cb。使用 lv_disp_flush_is_last() 可以查看哪块是最后渲染的。

其中，有一些可选的数据字段：

  • hor_res 显示器的水平分辨率。(默认为 lv_conf.h 中的 LV_HOR_RES_MAX )

  • ver_res 显示器的垂直分辨率。 (默认为 lv_conf.h 中的 LV_VER_RES_MAX )

  • color_chroma_key 在 chrome 键控图像上将被绘制为透明的颜色。(默认为 lv_conf.h 中的 LV_COLOR_TRANSP )

  • user_data 驱动程序的自定义用户数据。可以在 lv_conf.h 中修改其类型。

  • anti-aliasing 使用抗锯齿(anti-aliasing)(边缘平滑)。缺省情况下默认为 lv_conf.h 中的 LV_ANTIALIAS 。

  • rotated 如果 1 交换 hor_res 和 ver_res 。两种情况下 LVGL 的绘制方向相同(从上到下的线条)，因此还需要重新配置驱动程序以更改显示器的填充方向。

  • screen_transp 如果为 1 ，则屏幕可以具有透明或不透明的样式。需要在 lv_conf.h 中启用 LV_COLOR_SCREEN_TRANSP 。

要使用GPU，可以使用以下回调：

  • gpu_fill_cb 用颜色填充内存中的区域。

  • gpu_blend_cb 使用不透明度混合两个内存缓冲区。

  • gpu_wait_cb 如果在 GPU 仍在运行 LVGL 的情况下返回了任何 GPU 函数，则在需要确保GPU渲染就绪时将使用此函数。

注意，这些功能需要绘制到内存(RAM)中，而不是直接显示在屏幕上。

其他一些可选的回调，使单色、灰度或其他非标准RGB显示一起使用时更轻松、优化：

  • rounder_cb 四舍五入要重绘的区域的坐标。例如。 2x2像素可以转换为2x8。如果显示控制器只能刷新特定高度或宽度的区域(对于单色显示器，通常为8 px高)，则可以使用它。

  • set_px_cb 编写显示缓冲区的自定义函数。如果显示器具有特殊的颜色格式，则可用于更紧凑地存储像素。 (例如1位单色，2位灰度等)。这样，lv_disp_buf_t中使用的缓冲区可以较小，以仅保留给定区域大小所需的位数。 set_px_cb不能与两个屏幕大小的缓冲区一起显示缓冲区配置。

  • monitor_cb 回调函数告诉在多少时间内刷新了多少像素。

  • clean_dcache_cb 清除与显示相关的所有缓存的回调

要设置 lv_disp_drv_t 变量的字段，需要使用 lv_disp_drv_init(＆disp_drv) 进行初始化。最后，要为 LVGL 注册显示设备，需要调用lv_disp_drv_register(＆disp_drv)。

代码示例：

1    lv_disp_drv_t disp_drv;                 /*A variable to hold the drivers. Can be local variable*/
2    lv_disp_drv_init(&disp_drv);            /*Basic initialization*/
3    disp_drv.buffer = &disp_buf;            /*Set an initialized buffer*/
4    disp_drv.flush_cb = my_flush_cb;        /*Set a flush callback to draw to the display*/
5    lv_disp_t * disp;
6    disp = lv_disp_drv_register(&disp_drv); /*Register the driver and save the created display objects*/

回调的一些简单示例：

 1    void my_flush_cb(lv_disp_drv_t * disp_drv, const lv_area_t * area, lv_color_t * color_p)
 2    {
 3            /*The most simple case (but also the slowest) to put all pixels to the screen one-by-one*/
 4            int32_t x, y;
 5            for(y = area->y1; y <= area->y2; y++) {
 6                    for(x = area->x1; x <= area->x2; x++) {
 7                            put_px(x, y, *color_p)
 8                            color_p++;
 9                    }
10            }
11
12            /* IMPORTANT!!!
13             * Inform the graphics library that you are ready with the flushing*/
14            lv_disp_flush_ready(disp);
15    }
16
17    void my_gpu_fill_cb(lv_disp_drv_t * disp_drv, lv_color_t * dest_buf, const lv_area_t * dest_area, const lv_area_t * fill_area, lv_color_t color);
18    {
19            /*It's an example code which should be done by your GPU*/
20            uint32_t x, y;
21            dest_buf += dest_width * fill_area->y1; /*Go to the first line*/
22
23            for(y = fill_area->y1; y < fill_area->y2; y++) {
24                    for(x = fill_area->x1; x < fill_area->x2; x++) {
25                            dest_buf[x] = color;
26                    }
27                    dest_buf+=dest_width;    /*Go to the next line*/
28            }
29    }
30
31    void my_gpu_blend_cb(lv_disp_drv_t * disp_drv, lv_color_t * dest, const lv_color_t * src, uint32_t length, lv_opa_t opa)
32    {
33            /*It's an example code which should be done by your GPU*/
34            uint32_t i;
35            for(i = 0; i < length; i++) {
36                    dest[i] = lv_color_mix(dest[i], src[i], opa);
37            }
38    }
39
40    void my_rounder_cb(lv_disp_drv_t * disp_drv, lv_area_t * area)
41    {
42      /* Update the areas as needed. Can be only larger.
43       * For example to always have lines 8 px height:*/
44       area->y1 = area->y1 & 0x07;
45       area->y2 = (area->y2 & 0x07) + 8;
46    }
47
48    void my_set_px_cb(lv_disp_drv_t * disp_drv, uint8_t * buf, lv_coord_t buf_w, lv_coord_t x, lv_coord_t y, lv_color_t color, lv_opa_t opa)
49    {
50            /* Write to the buffer as required for the display.
51             * Write only 1-bit for monochrome displays mapped vertically:*/
52     buf += buf_w * (y >> 3) + x;
53     if(lv_color_brightness(color) > 128) (*buf) |= (1 << (y % 8));
54     else (*buf) &= ~(1 << (y % 8));
55    }
56
57    void my_monitor_cb(lv_disp_drv_t * disp_drv, uint32_t time, uint32_t px)
58    {
59      printf("%d px refreshed in %d ms\n", time, ms);
60    }
61
62    void my_clean_dcache_cb(lv_disp_drv_t * disp_drv, uint32)
63    {
64      /* Example for Cortex-M (CMSIS) */
65      SCB_CleanInvalidateDCache();
66    }

相关APIs

TODO