RK3588 ELF2开发板LVGL8.2移植教程

在嵌入式设备开发中，图形用户界面（GUI）的需求持续攀升，选对合适的框架往往直接决定项目的成败。在众多解决方案中，LVGL与Qt是两个最具代表性的名字，但两者的设计理念与适用场景存在显著差异。

LVGL 可理解为专为资源受限的嵌入式环境打造的“轻量级先锋”。它具备高度模块化特性，内存占用极低，无论是简单单片机还是复杂Linux板卡都能稳定运行，甚至无需依赖操作系统。如果项目对成本、功耗和性能有极苛刻要求，LVGL通常是更理性的选择。

相比之下，Qt 更像一个功能完备的“重型武器库”。它远远超出GUI范畴，打包了网络、数据库、多媒体等众多模块。尽管 Qt for Embedded Linux 功能强大，但通常需要更充裕的硬件资源来驱动，因此更常见于工业HMI、车载中控这类“富设备”场景。

今天，我们以 LVGL 8.2 版本为例，手把手演示在 Linux 帧缓冲（Frame Buffer）环境下的完整移植流程。这套方法清晰实用，能帮助你在板卡上快速搭建一个流畅且美观的图形界面应用。

一、源码获取与准备

首先，将必要的源码仓库克隆至本地。我们直接使用8.2版本的发布分支：

git clone -b release/v8.2 https://github.com/lvgl/lv_port_linux_frame_buffer.git
git clone -b release/v8.2 https://github.com/lvgl/lvgl.git
git clone -b release/v8.2 https://github.com/lvgl/lv_drivers.git

克隆完成后，你会得到三个文件夹。接下来，需要将lvgl和lv_drivers两个文件夹整体拷贝到lv_port_linux_frame_buffer目录内。这样，移植所需的全部源代码就已准备就绪。

二、关键配置文件修改

这一步是整个移植过程的核心，主要根据实际硬件屏幕的规格调整几个关键配置文件。请务必以你板卡实际适配的屏幕参数为准进行操作。

2.1 修改显示与内存配置 (lv_conf.h)

打开lv_port_linux_frame_buffer/lv_conf.h文件：

elf@ubuntu:~/work/lvgl8.2$ vi lv_port_linux_frame_buffer/lv_conf.h

需要修改以下几处：

第15行：将0改为1，启用该配置文件。

第27行：设置颜色深度。例如，若屏幕为RGB565格式，则保持LV_COLOR_DEPTH 16。

第49行：将LV_MEM_CUSTOM 0改为1，这样LVGL将使用我们在后续 main.c 中自定义的内存分配方案。

第672行：将0改为1，这样编译时会包含丰富的演示用例（demo），便于后续测试验证。

2.2 修改驱动配置 (lv_drv_conf.h)

接下来，配置显示与输入设备。打开lv_port_linux_frame_buffer/lv_drv_conf.h：

elf@ubuntu:~/work/lvgl8.2$ vi lv_port_linux_frame_buffer/lv_drv_conf.h

第11行：同样，将0改为1，启用驱动配置文件。

第319行：找到帧缓冲（FB）显示驱动的配置，将0改为1，启用Linux帧缓冲显示。

第442行：启用触摸板（指针设备）输入，将0改为1。

第450行：指定触摸设备节点。这里有一个实用技巧：在开发板上执行evtest命令，观察触摸屏幕时哪个设备节点（例如/dev/input/event0）有坐标输出，然后将这里的路径修改为对应的节点。

第453行：将0改为1，允许手动配置屏幕分辨率。

第457行与第459行：这是设定分辨率的关键位置。将LV_DRV_DISP_HOR_RES和LV_DRV_DISP_VER_RES后面的数值，分别改为你屏幕的实际水平像素和垂直像素数。

2.3 修改主程序文件 (main.c)

现在，打开主程序文件进行最后的系统配置：

elf@ubuntu:~/work/lvgl8.2$ vi lv_port_linux_frame_buffer/main.c

第10行：此处定义了LVGL可用的内存池大小。根据你的系统可用内存，调整LV_MEM_SIZE的值（例如32 * 1024U表示32KB）。

第32行与第33行：再次确认并设置屏幕的宽度和高度，确保与前面lv_drv_conf.h中的配置保持一致。

2.4 修改编译脚本 (Makefile)

最后，告知编译系统应该使用哪套工具链。编辑Makefile：

elf@ubuntu:~/work/lvgl8.2$ vi lv_port_linux_frame_buffer/Makefile

第4行：将CC ?= gcc中的gcc替换为你的交叉编译工具链前缀，例如arm-linux-gnueabihf-gcc。

第7行：该行通常用于指定SDL库路径。如果你在纯Linux帧缓冲环境下运行（不依赖SDL模拟），可用#号注释掉整行。

三、编译生成可执行文件

所有配置修改完毕，即可开始编译。进入lv_port_linux_frame_buffer目录，执行编译命令：

elf@ubuntu:~/work/lvgl8.2$ cd lv_port_linux_frame_buffer/
elf@ubuntu:~/work/lvgl8.2/lv_port_linux_frame_buffer$ make -j4

编译过程顺利的话，当前目录下会生成一个名为demo的可执行文件。

elf@ubuntu:~/work/lvgl8.2/lv_port_linux_frame_buffer$ ls demo
demo

四、在开发板上运行测试

将编译好的demo文件拷贝到开发板（例如通过U盘）。

在运行LVGL应用前，如果开发板默认启动了 Weston 等桌面合成器，需先将其关闭，以免占用显示帧缓冲设备：

root@elf2-buildroot:~# /etc/init.d/S49weston stop

然后直接运行demo程序：

root@elf2-buildroot:~# ./demo

如果一切配置正确，屏幕上便会显示出LVGL丰富的内置演示界面，效果如下图所示：

至此，LVGL 8.2 在 Linux 帧缓冲环境下的移植与基础测试顺利完成。接下来，你就可以基于这个框架，着手开发自己的嵌入式图形界面应用了。