4、显示驱动调试：帧缓冲区配置检查、刷新回调函数验证、显示时序参数调优
显示驱动，说白了就是LVGL和硬件屏幕之间的那座桥。桥要是没搭好，画面要么花屏，要么闪屏，要么干脆黑屏。我调试过不下二十种屏幕驱动，从128x64的单色OLED到1024x600的RGB屏，踩过的坑能写满一页A4纸。今天咱们就聚焦三个核心点：帧缓冲区、刷新回调、时序参数。
4.1 帧缓冲区配置检查
帧缓冲区，就是LVGL画图的地方。它的大小、位置、对齐方式，任何一个出问题，画面都会跟着遭殃。
4.1.1 缓冲区大小怎么定？
LVGL支持三种缓冲区模式：单缓冲、双缓冲、全缓冲。我个人习惯从单缓冲开始调试，因为最简单，出问题容易定位。
/* 单缓冲示例 */
static lv_disp_draw_buf_t draw_buf;
static lv_color_t buf[LV_HOR_RES_MAX * 10]; // 10行像素
lv_disp_draw_buf_init(&draw_buf, buf, NULL, LV_HOR_RES_MAX * 10);这里有个关键点：缓冲区大小必须是 LV_HOR_RES_MAX 的整数倍。为什么？因为LVGL每次刷新至少是一整行。我曾经遇到一个项目，同事把大小设成了 LV_HOR_RES_MAX * 9，结果屏幕底部总有一条花带。查了半天，就是缓冲区没对齐。
4.1.2 双缓冲的坑
双缓冲模式下，你需要提供两个缓冲区。LVGL在一个缓冲区里画图，同时把另一个缓冲区的内容刷到屏幕。这样能避免撕裂。
/* 双缓冲示例 */
static lv_color_t buf_1[LV_HOR_RES_MAX * 20];
static lv_color_t buf_2[LV_HOR_RES_MAX * 20];
lv_disp_draw_buf_init(&draw_buf, buf_1, buf_2, LV_HOR_RES_MAX * 20);嗯，这里要注意：两个缓冲区的大小必须完全一样。我见过有人把第二个缓冲区设小了，结果LVGL往里面写数据时越界，直接覆盖了其他变量。那画面，简直是一场灾难。
4.2 刷新回调函数验证
刷新回调函数 flush_cb 是LVGL和硬件之间的桥梁。LVGL画完一帧后，会调用这个函数，把缓冲区数据发送到屏幕。
4.2.1 回调函数的基本结构
static void my_flush_cb(lv_disp_drv_t * disp_drv, const lv_area_t * area, lv_color_t * color_p)
{
/* 将color_p指向的数据发送到屏幕的area区域 */
/* 例如：使用SPI或并行接口发送数据 */
/* 重要：发送完成后必须调用此函数 */
lv_disp_flush_ready(disp_drv);
}你想想看，如果忘了调用 lv_disp_flush_ready，LVGL会认为刷新还没完成，就一直等着。结果就是屏幕卡死，动不了。我刚开始学LVGL时就犯过这个错，折腾了两天才找到原因。
4.2.2 验证刷新回调的常用方法
怎么验证回调函数工作正常？我一般用三步法：
- 打印法：在回调函数里加个打印，看它被调用了没。
- 填充法：手动往缓冲区里填颜色数据，看屏幕有没有反应。
- 计时法：测量回调函数的执行时间，看是否超过帧间隔。
4.2.3 常见问题：回调函数不被调用
如果回调函数压根没被调用，先检查这几项：
lv_disp_drv_t结构体是否注册了flush_cb？- 显示驱动是否调用了
lv_disp_drv_register？ - LVGL的
lv_timer_handler是否在周期执行？
说白了，就是LVGL的时钟没跑起来。我遇到过最奇葩的情况是，同事把 lv_timer_handler 放在了中断里，结果优先级设得太低，一直被其他中断抢占。回调函数偶尔才被调用一次，屏幕闪得像迪斯科。
4.3 显示时序参数调优
时序参数，就是告诉屏幕控制器什么时候该做什么。包括行同步、场同步、像素时钟、前后肩等。这些参数错了，屏幕要么不亮，要么显示错位。
4.3.1 时序参数从哪里来？
最靠谱的来源是屏幕的数据手册。但说实话，有些国产屏的数据手册写得跟天书一样。这时候怎么办？
| 参数 | 典型值范围 | 调试建议 |
|---|---|---|
| HBP (水平后肩) | 2 ~ 100 | 先设大一点，比如50，再慢慢减小 |
| HFP (水平前肩) | 2 ~ 100 | 和HBP保持相近 |
| VBP (垂直后肩) | 2 ~ 50 | 先设20，再调整 |
| VFP (垂直前肩) | 2 ~ 50 | 和VBP保持相近 |
| 像素时钟 | 取决于分辨率 | 从低往高调，直到画面稳定 |
4.3.2 调优步骤
我个人习惯按这个顺序调：
- 先保证能点亮：用数据手册里的推荐值，或者用相近屏幕的参数。别追求完美，先让屏幕显示内容。
- 调整像素时钟：如果画面有闪烁或条纹，多半是时钟太快或太慢。用示波器看时钟波形，确保占空比50%。
- 微调前后肩：如果画面偏移或边缘有黑边，调整HBP和HFP。我一般每次加5，直到画面居中。
核心原则： 时序参数调优没有捷径，就是试错。但每次只改一个参数，改完看效果。同时改多个参数，出了问题你都不知道是哪个引起的。
4.3.3 一个真实案例
我曾经调试一块480x272的RGB屏，数据手册上写的像素时钟是9MHz。但实际显示时，画面总是偏左，右边有黑边。我调了HBP和HFP，从10调到50，画面还是偏。
后来我用示波器一看，发现像素时钟实际只有8.5MHz。原来MCU的PLL配置有误差。我把时钟调到9MHz后，再微调HBP到30，画面就完美居中了。
所以你看，有时候问题不在时序参数本身，而在时钟源。调试时要全面考虑。
4.4 总结
显示驱动调试，说白了就是三板斧：缓冲区配置要正确，刷新回调要完整，时序参数要匹配。这三样都对了，屏幕基本就能正常工作。
嗯，最后提醒一句：调试时别急着上复杂界面。先用LVGL的 lv_demo_widgets() 或者画个纯色矩形，确认显示没问题了，再上你的UI。这样能省下大量排查时间。