嵌入式 Linux 下的 LVGL 移植

本文记录如何将 LVGL 移植到嵌入式 Linux 系统中。

Hello阿尔法

5348人浏览 · 2024-02-27 19:48:56

Hello阿尔法 · 2024-02-27 19:48:56 发布

LVGL（Light and Versatile Graphics Library）是一个轻量化的、开源的、在嵌入式系统中广泛使用的图形库，它提供了一套丰富的控件和组件，只需要少量的内存和计算资源，使得在资源受限的设备上创建高端的图形界面成为可能。本文记录如何将 LVGL 移植到嵌入式 Linux 系统中。

编程环境：Windows11 VS Code
编译环境：Ubuntu18.04 交叉编译
测试平台：正点原子 i.MX6ULL
显示屏：5inch RGB 800×480

准备

打开 LVGL 的 Github 主页，分别下载 lvgl、lv_drivers、lv_port_linux_frame_buffer 仓库源码

lvgl 和 lv_drivers 我这里选择了当前最新的已发布版本：

创建工程

创建 lvgl_demo 文件夹；
将 lvgl、lv_drivers 复制到 lvgl_demo 中；
将 lv_port_linux_frame_buffer 仓库中的 main.c 文件和 makefile 文件复制到 lvgl_demo 中；
将 lvgl 中的 lv_conf_template.h 文件复制到 lvgl_demo 中并且改名为 lv_conf.h；
将 lv_drivers 中的 lv_drv_conf_template.h 文件复制到 lvgl_demo 中并且改名为 lv_drv_conf.h；
创建好的工程目录如图所示：

修改配置

修改 lv_drv_conf.h

将 #if 0 改成 #if 1：

将 USE_FBDEV 的值改为 1，使能 frame buffer 设备：

将 USE_EVDEV 的值改为 1，配置触控输入设备的文件路径：

可以通过 cat /dev/input/eventx 的方式查看输入事件，x 为事件编号，通过触摸屏幕时查看有没有内容输出确认 x。

修改 lv_conf.h

将 #if 0 改成 #if 1：

根据实际情况适当扩大内存：

这里可以修改刷新频率，默认为 30ms：

配置 Tick：

使能 widgets demo：

修改 main.c

修改后的 main.c 文件如下所示：

#include "lvgl/lvgl.h"
#include "lvgl/demos/lv_demos.h"
#include "lv_drivers/display/fbdev.h"
#include "lv_drivers/indev/evdev.h"
#include <unistd.h>
#include <time.h>
#include <sys/time.h>

#define DISP_BUF_SIZE (800 * 480)

int main(void)
{
    lv_init();

    /*Linux frame buffer device init*/
    fbdev_init();

    /*A small buffer for LittlevGL to draw the screen's content*/
    static lv_color_t buf[DISP_BUF_SIZE];

    /*Initialize a descriptor for the buffer*/
    static lv_disp_draw_buf_t disp_buf;
    lv_disp_draw_buf_init(&disp_buf, buf, NULL, DISP_BUF_SIZE);

    /*Initialize and register a display driver*/
    static lv_disp_drv_t disp_drv;
    lv_disp_drv_init(&disp_drv);
    disp_drv.draw_buf   = &disp_buf;
    disp_drv.flush_cb   = fbdev_flush;
    disp_drv.hor_res    = 800;
    disp_drv.ver_res    = 480;
    lv_disp_drv_register(&disp_drv);

    /* Linux input device init */
    evdev_init();

    /* Initialize and register a display input driver */
    lv_indev_drv_t indev_drv;
    lv_indev_drv_init(&indev_drv);      /*Basic initialization*/

    indev_drv.type = LV_INDEV_TYPE_POINTER;
    indev_drv.read_cb = evdev_read;
    lv_indev_t * my_indev = lv_indev_drv_register(&indev_drv); 

    /*Create a Demo*/
    lv_demo_widgets();

    /*Handle LVGL tasks*/
    while(1) {
        lv_timer_handler();
        usleep(5000);
    }

    return 0;
}

/*Set in lv_conf.h as `LV_TICK_CUSTOM_SYS_TIME_EXPR`*/
uint32_t custom_tick_get(void)
{
    static uint64_t start_ms = 0;
    if(start_ms == 0) {
        struct timeval tv_start;
        gettimeofday(&tv_start, NULL);
        start_ms = (tv_start.tv_sec * 1000000 + tv_start.tv_usec) / 1000;
    }

    struct timeval tv_now;
    gettimeofday(&tv_now, NULL);
    uint64_t now_ms;
    now_ms = (tv_now.tv_sec * 1000000 + tv_now.tv_usec) / 1000;

    uint32_t time_ms = now_ms - start_ms;
    return time_ms;
}

修改 Makefile

指定编译器，因为我在编译前会设置编译器环境变量，为避免错误，此处注释掉该配置，使用环境下默认编译器：

添加 lv_drivers.mk，注释掉鼠标样式源文件：

修改了下构建目标名称：

若编译过程中出现未识别的编译选项，如报 error: unrecognized command line option '-Wshift-negative-value' 类似错误，可删除 -Wshift-negative-value 选项，该选项的作用是检查左移操作（<<）中可能出现的负数：