LVGL基础入门：从零开始搭建你的图形界面
大家好，我是老张。做嵌入式UI开发这些年，我接触过不少图形库，但LVGL是我用得最顺手的一个。今天咱们就来聊聊LVGL的基础知识，以及怎么在RT-Thread上把它跑起来。
说实话，第一次接触LVGL时，我也有点懵。但用顺手之后，你会发现它真的很香。咱们一步步来。
LVGL简介与架构
LVGL是什么？说白了，它是一个开源的嵌入式图形库。专门为资源受限的MCU设计的。你想想看，要在只有几百KB Flash的单片机上跑出流畅的动画效果，这本身就是个技术活。
LVGL的架构设计得很巧妙。我把它拆成三层来看：
- 底层驱动层：负责和硬件打交道，比如显示驱动、触摸驱动
- 核心层：管理对象、事件、动画这些基础功能
- 组件层：提供按钮、标签、滑块等现成控件
我在项目中遇到过一个问题：有个同事直接把LVGL所有功能都编译进去了，结果Flash爆了。其实LVGL支持裁剪，你只需要保留用到的组件就行。这个后面会细说。
核心特点：
- 支持16位、32位微控制器
- 内存占用可低至10KB RAM
- 内置丰富的UI组件（按钮、图表、键盘等）
- 支持触摸、鼠标、键盘输入
- 内置动画引擎
LVGL在RT-Thread上的移植
移植LVGL到RT-Thread，其实没那么复杂。RT-Thread官方已经帮我们做了很多工作。我个人习惯用Env工具来配置，这样最省事。
具体步骤是这样的：
- 在Env中打开menuconfig
- 进入RT-Thread Components → GUI → LVGL
- 勾选Enable LVGL
- 配置显示驱动和触摸驱动
- 保存退出，然后pkgs --update拉取软件包
嗯，这里要注意一点。LVGL的配置项非常多，新手容易看花眼。我建议你先把默认配置跑起来，后面再慢慢调优。
小技巧：如果你用的是STM32系列，RT-Thread的BSP里通常已经集成了LVGL的demo。直接编译就能看到效果。我第一次跑通时，屏幕上出现那个Hello World按钮，心里还挺激动的。
移植过程中最关键的几个配置：
| 配置项 | 说明 | 建议值 |
|---|---|---|
| LV_MEM_SIZE | LVGL动态内存大小 | 32KB起步 |
| LV_HOR_RES_MAX | 水平分辨率 | 根据屏幕设置 |
| LV_VER_RES_MAX | 垂直分辨率 | 根据屏幕设置 |
| LV_COLOR_DEPTH | 颜色深度 | 16或32 |
避坑指南：我曾经因为LV_MEM_SIZE设得太小，导致界面卡死。调试了半天才发现是内存不够。建议至少给32KB，如果控件多，给64KB更稳妥。
第一个LVGL程序：Hello World
好了，环境搭好了，咱们来写第一个程序。这个程序很简单：在屏幕上显示一个按钮，点击按钮时显示"Hello World"。
代码其实不长，我直接贴出来：
#include <lvgl.h>
#include <rtdevice.h>
static void btn_event_cb(lv_event_t * e)
{
lv_event_code_t code = lv_event_get_code(e);
if(code == LV_EVENT_CLICKED) {
static lv_obj_t * label;
label = lv_label_create(lv_scr_act());
lv_label_set_text(label, "Hello World!");
lv_obj_align(label, LV_ALIGN_CENTER, 0, 0);
}
}
void lvgl_hello_world(void)
{
lv_obj_t * btn = lv_btn_create(lv_scr_act());
lv_obj_set_size(btn, 120, 50);
lv_obj_align(btn, LV_ALIGN_CENTER, 0, 0);
lv_obj_t * label = lv_label_create(btn);
lv_label_set_text(label, "Click me");
lv_obj_center(label);
lv_obj_add_event_cb(btn, btn_event_cb, LV_EVENT_ALL, NULL);
}这段代码做了三件事：
- 创建一个按钮，放在屏幕中央
- 在按钮上显示"Click me"文字
- 给按钮绑定点击事件，点击后显示"Hello World"
你可能会问：为什么事件回调里要用static变量？其实是因为每次点击都创建一个新标签，用static可以保证只创建一次。当然，你也可以用全局变量，但我觉得static更干净。
把这个函数放到RT-Thread的线程里调用就行了。比如：
static void lvgl_thread_entry(void *parameter)
{
lvgl_hello_world();
while(1) {
lv_task_handler();
rt_thread_mdelay(5);
}
}这里有个关键点：lv_task_handler()必须定期调用，LVGL才能处理事件和刷新屏幕。我一般放在while循环里，每5ms调用一次。
个人经验：刚开始做LVGL开发时，我总忘记调用lv_task_handler()，结果屏幕死活不刷新。后来养成了习惯，创建LVGL线程时第一件事就是把定时调用写进去。
跑起来之后，你会看到屏幕上出现一个按钮。点击它，"Hello World"就弹出来了。虽然简单，但这是你踏入LVGL世界的第一步。
说实话，看到自己写的代码在屏幕上跑起来，那种成就感还是很棒的。后面咱们会深入讲各种控件的用法，还有动画、样式这些高级功能。今天先把基础打牢。
最后提醒一句：LVGL的文档写得很好，遇到问题先查文档。我当年就是靠啃文档入门的，虽然慢，但基础扎实。