4、LVGL显示驱动移植：framebuffer配置、flush回调函数实现、色彩格式转换

显示驱动移植，说白了就是让LVGL能跟你的屏幕“对上话”。很多初学者卡在这一步，觉得代码跑飞了、花屏了，其实多半是framebuffer没配好，或者flush回调写错了。我当年第一次移植时，屏幕死活不亮，折腾了两天才发现是色彩格式没对齐——嗯，这种坑咱们今天一次性填平。

4.1 Framebuffer配置——显示驱动的“地基”

Framebuffer是Linux或裸机环境下的一块内存区域，说白了就是屏幕的“画板”。LVGL往这块内存里写像素数据，硬件再把它刷到屏幕上。配置framebuffer，核心就三件事：

• 内存地址：告诉系统画板在哪
• 分辨率：宽×高，单位是像素
• 色彩深度：每个像素占多少位

我个人习惯在移植前先确认硬件支持的分辨率和色彩格式。比如一个800×480的RGB565屏幕，每个像素占2字节，那framebuffer大小就是800×480×2 = 768000字节。别算错了，少了会花屏，多了浪费内存。

在Linux下，你可以通过fbset命令查看当前framebuffer参数。我记得有一次在嵌入式板子上跑LVGL，fbset显示分辨率是800×480，但实际屏幕只有480×272——结果LVGL画出来的内容全跑偏了。所以，一定要跟硬件手册或驱动源码核对，别信命令行。

4.2 Flush回调函数实现——LVGL的“快递员”

Flush回调是LVGL显示驱动的核心。LVGL每次绘制完一个区域，就会调用这个函数，把数据“快递”到屏幕上。原型长这样：

static void my_flush_cb(lv_disp_drv_t * disp_drv, const lv_area_t * area, lv_color_t * color_p)
{
    // 1. 获取区域坐标
    int32_t x1 = area->x1;
    int32_t y1 = area->y1;
    int32_t x2 = area->x2;
    int32_t y2 = area->y2;

    // 2. 将color_p中的数据写入framebuffer对应位置
    // 具体实现取决于硬件接口

    // 3. 通知LVGL刷新完成
    lv_disp_flush_ready(disp_drv);
}

这里有个关键点：一定要调用lv_disp_flush_ready()。我曾经见过一个同事，flush回调里写了一大堆数据搬运代码，唯独忘了调用这个函数，结果LVGL一直卡在等待状态，屏幕一动不动。你想想看，快递员把货送到了，却不告诉收件人——那不就白送了嘛。

实际项目中，flush回调里通常要做这几步：

1. 从color_p指针读取像素数据
2. 根据area坐标计算在framebuffer中的偏移
3. 把数据拷贝到framebuffer（或通过SPI/LCD接口发送）
4. 调用lv_disp_flush_ready()释放LVGL的绘制锁

4.3 色彩格式转换——RGB565 vs RGB888

LVGL内部默认使用lv_color_t类型，这个类型的大小由LV_COLOR_DEPTH宏决定。常见的有：

色彩深度	lv_color_t大小	典型格式	适用场景
16位	2字节	RGB565	低成本MCU、小屏幕
24位	3字节	RGB888	高性能MCU、Linux
32位	4字节	ARGB8888	带透明效果的UI

如果你的屏幕是RGB565，但LVGL配置成了RGB888，那颜色就会完全错乱。反过来也一样。为什么会这样？因为每个像素的字节数不同，数据在内存里的排列方式完全不同。

举个例子：一个纯红色像素（R=255, G=0, B=0）

• RGB565：0xF800（二进制：11111 000000 00000）
• RGB888：0xFF0000（二进制：11111111 00000000 00000000）

如果你把RGB888的数据直接塞给RGB565的屏幕，那红色会变成紫色或绿色——我踩过这个坑，调了一下午才发现是格式没转。

4.4 色彩转换实战——手写一个转换函数

当LVGL的色彩深度和屏幕不一致时，你需要在flush回调里做转换。下面是我常用的RGB888转RGB565函数：

static uint16_t rgb888_to_rgb565(uint8_t r, uint8_t g, uint8_t b)
{
    // 取高位，丢掉低位精度
    uint16_t r5 = (r >> 3) & 0x1F;   // 8位 -> 5位
    uint16_t g6 = (g >> 2) & 0x3F;   // 8位 -> 6位
    uint16_t b5 = (b >> 3) & 0x1F;   // 8位 -> 5位

    return (r5 << 11) | (g6 << 5) | b5;
}

反过来，RGB565转RGB888：

static void rgb565_to_rgb888(uint16_t color, uint8_t *r, uint8_t *g, uint8_t *b)
{
    // 提取各分量，并扩展到8位
    *r = ((color >> 11) & 0x1F) << 3;   // 5位 -> 8位
    *g = ((color >> 5)  & 0x3F) << 2;   // 6位 -> 8位
    *b = (color & 0x1F) << 3;            // 5位 -> 8位
}

4.5 完整移植流程——一张图说清楚

下面这张图总结了显示驱动移植的完整流程，从配置到刷新，每一步都离不开：

4.6 避坑指南——我踩过的那些坑

最后分享几个实战中容易翻车的地方：

• 忘记调用lv_disp_flush_ready()：LVGL会一直等待，屏幕不刷新。我曾经调试了一整天，最后发现就是少了一行代码。
• 色彩格式不匹配：LVGL的LV_COLOR_DEPTH和屏幕硬件格式必须一致。不一致时，要么改LVGL配置，要么在flush回调里做转换。
• framebuffer地址写死：有些平台framebuffer地址是动态分配的，写死会导致访问非法内存。我建议用mmap或驱动提供的接口获取地址。
• 区域坐标越界：flush回调里的area坐标可能超出屏幕范围，一定要做边界检查。否则写入越界，轻则花屏，重则死机。