news 2026/5/11 1:50:52

LVGL9 双物理屏幕驱动入门教程

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
LVGL9 双物理屏幕驱动入门教程

LVGL9 双物理屏幕驱动入门教程

下面以C + LVGL v9为例，介绍如何在一个 MCU 上同时驱动两个独立的物理屏幕（两个lv_display_t），并在每个屏上加载自己的界面。示例代码严格按照工程中lvgl__lvgl组件（LVGL v9 原生 API，例如lv_display_create、lv_display_set_buffers、lv_screen_load等）来写，再按实际硬件做适配。

一、总体思路（LVGL v9 原生 API）

  • 每块物理屏 = 一个显示控制器 (lv_display_t)
    • 使用lv_display_create(hor_res, ver_res)创建显示对象
    • 使用lv_display_set_flush_cb(disp, my_flush_cb)绑定刷新回调
    • 使用lv_display_set_buffers(disp, buf1, buf2, buf_size, LV_DISPLAY_RENDER_MODE_*)绑定帧缓冲
  • 每个显示器有自己的根 Screen
    • 用lv_obj_create(NULL)创建 Screen（根对象）
    • 用lv_screen_load(screen)把 Screen 设置为当前显示器的活动 Screen（与lv_display_set_default(disp)配合使用）
  • 一个lv_timer_handler()轮询即可，所有显示器共用一套 LVGL 任务处理。

二、初始化两个显示器（Display）

假设有两块 240×320 的屏幕，各自有独立的刷新函数my_flush_cb1/my_flush_cb2。

#include"lvgl.h"#defineSCREEN1_HOR_RES240#defineSCREEN1_VER_RES320#defineSCREEN2_HOR_RES240#defineSCREEN2_VER_RES320#defineDISP_BUF_LINES20staticlv_display_t*disp1;staticlv_display_t*disp2;/* 屏幕1 刷新回调（LVGL v9：px_map 是 uint8_t* 原始像素） */staticvoidmy_flush_cb1(lv_display_t*disp,constlv_area_t*area,uint8_t*px_map){LV_UNUSED(disp);/* TODO: 把 px_map 中的像素，按 area->x1..x2, area->y1..y2 写入屏幕1 *//* 刷新结束后必须调用：*/lv_display_flush_ready(disp);}/* 屏幕2 刷新回调 */staticvoidmy_flush_cb2(lv_display_t*disp,constlv_area_t*area,uint8_t*px_map){LV_UNUSED(disp);/* TODO: 把 px_map 写入屏幕2 */lv_display_flush_ready(disp);}voidgui_dual_disp_init(void){lv_init();/* -------- 显示器1：创建 display 并绑定缓冲和刷新回调 -------- */disp1=lv_display_create(SCREEN1_HOR_RES,SCREEN1_VER_RES);/* 计算缓冲区大小（PARTIAL 渲染模式，按行数 * color_size） */uint32_tbuf1_size=SCREEN1_HOR_RES*DISP_BUF_LINES*lv_color_format_get_size(lv_display_get_color_format(disp1));staticuint8_tbuf1_a[SCREEN1_HOR_RES*DISP_BUF_LINES*4];// 预留足够字节，可按 buf1_size 调整staticuint8_tbuf1_b[SCREEN1_HOR_RES*DISP_BUF_LINES*4];lv_display_set_flush_cb(disp1,my_flush_cb1);lv_display_set_buffers(disp1,buf1_a,buf1_b,buf1_size,LV_DISPLAY_RENDER_MODE_PARTIAL);/* -------- 显示器2：同样方式创建 -------- */disp2=lv_display_create(SCREEN2_HOR_RES,SCREEN2_VER_RES);uint32_tbuf2_size=SCREEN2_HOR_RES*DISP_BUF_LINES*lv_color_format_get_size(lv_display_get_color_format(disp2));staticuint8_tbuf2_a[SCREEN2_HOR_RES*DISP_BUF_LINES*4];staticuint8_tbuf2_b[SCREEN2_HOR_RES*DISP_BUF_LINES*4];lv_display_set_flush_cb(disp2,my_flush_cb2);lv_display_set_buffers(disp2,buf2_a,buf2_b,buf2_size,LV_DISPLAY_RENDER_MODE_PARTIAL);}

提示：工程里的lvgl__lvgl组件使用的就是这套 v9 API（见lv_display.h、lcd_stm32_guide.rst等），lv_disp_drv_t/lv_disp_draw_buf_t已被新的lv_display_*API 取代，老名字只是通过lv_api_map_v8.h做了兼容映射。

三、（可选）为每块屏单独配置触摸输入

如果两块屏都要触控，需要两个lv_indev_t，并分别绑定到disp1/disp2（v9 原生用lv_indev_set_display，你工程里也可以继续用兼容宏）。

staticlv_indev_t*indev1;staticlv_indev_t*indev2;/* 触摸读取回调1 */staticvoidmy_touch_read1(lv_indev_drv_t*drv,lv_indev_data_t*data){// TODO: 读取触摸屏1坐标，填充>}/* 触摸读取回调2 */staticvoidmy_touch_read2(lv_indev_drv_t*drv,lv_indev_data_t*data){// TODO: 读取触摸屏2坐标}voidgui_dual_input_init(void){/* 屏幕1输入 */staticlv_indev_drv_tindev_drv1;lv_indev_drv_init(&indev_drv1);indev_drv1.type=LV_INDEV_TYPE_POINTER;indev_drv1.read_cb=my_touch_read1;indev1=lv_indev_drv_register(&indev_drv1);lv_indev_set_display(indev1,disp1);// 绑定到显示器1/* 屏幕2输入 */staticlv_indev_drv_tindev_drv2;lv_indev_drv_init(&indev_drv2);indev_drv2.type=LV_INDEV_TYPE_POINTER;indev_drv2.read_cb=my_touch_read2;indev2=lv_indev_drv_register(&indev_drv2);lv_indev_set_display(indev2,disp2);// 绑定到显示器2}

四、为每个显示器创建并加载 Screen

关键点是：在创建 Screen 或控件前先用lv_disp_set_default(dispX)切换当前显示器，或者用lv_disp_get_scr_act(disp)拿到该显示器的根对象。

staticlv_obj_t*scr1;staticlv_obj_t*scr2;staticvoidcreate_screens_for_dual_display(void){/* ==== 显示器1的界面 ==== */lv_disp_set_default(disp1);// 切换当前默认显示器scr1=lv_obj_create(NULL);// 新建一个 Screen（根对象）lv_obj_set_style_bg_color(scr1,lv_color_hex(0x000000),0);lv_scr_load(scr1);// 或：lv_disp_load_scr(disp1, scr1);// 在屏幕1上创建控件lv_obj_t*label1=lv_label_create(scr1);lv_label_set_text(label1,"Hello, Display 1");lv_obj_align(label1,LV_ALIGN_CENTER,0,0);/* ==== 显示器2的界面 ==== */lv_disp_set_default(disp2);// 切换到第二个显示器scr2=lv_obj_create(NULL);lv_obj_set_style_bg_color(scr2,lv_color_hex(0x202020),0);lv_scr_load(scr2);// 或：lv_disp_load_scr(disp2, scr2);lv_obj_t*label2=lv_label_create(scr2);lv_label_set_text(label2,"Hello, Display 2");lv_obj_align(label2,LV_ALIGN_CENTER,0,0);}

也可以不调用lv_scr_load()，而是使用：

lv_disp_load_scr(disp1,scr1);lv_disp_load_scr(disp2,scr2);

效果是一样的，只是更明确指定了要加载到哪个显示器。

五、在某个屏上切换界面（可选，带动画）

如果某个物理屏需要在多个界面之间切换，比如副屏加载不同的菜单，可以在对应的disp上用lv_scr_load或lv_scr_load_anim。

// 为屏幕2预先创建另一个界面staticlv_obj_t*scr2_alt=NULL;staticvoidcreate_alt_screen_for_disp2(void){lv_disp_set_default(disp2);scr2_alt=lv_obj_create(NULL);lv_obj_set_style_bg_color(scr2_alt,lv_color_hex(0x003366),0);lv_obj_t*label=lv_label_create(scr2_alt);lv_label_set_text(label,"Display 2 - ALT");lv_obj_align(label,LV_ALIGN_CENTER,0,0);}/* 在某个事件中调用这个函数 */voidswitch_disp2_to_alt(void){if(scr2_alt==NULL){create_alt_screen_for_disp2();}lv_disp_set_default(disp2);// 确保当前默认显示器是第二个// 直接切换：// lv_scr_load(scr2_alt);// 或使用带动画的切换：lv_scr_load_anim(scr2_alt,LV_SCR_LOAD_ANIM_MOVE_LEFT,300,0,false);}

如果你已经有自己的封装（比如SwitchToScreenWithAnim），只要在调用前先lv_disp_set_default(dispX)，再调用你自己的封装即可。

六、主循环（共享lv_timer_handler）

无论有几个显示器、多少个 Screen，主循环只需要一个lv_timer_handler()：

voidapp_main(void){gui_dual_disp_init();gui_dual_input_init();// 如有触摸create_screens_for_dual_display();while(1){lv_timer_handler();// LVGL 9 对应的处理函数delay_ms(5);// 根据系统换成 vTaskDelay / HAL_Delay}}

七、常见注意事项

  • 内存占用

    • 两块 240×320×16bpp 的屏，如果每块屏用 1 个SCREEN_HOR_RES * 20的缓冲区，大约：
      • 每块缓冲区：240 * 20 * 2 byte ≈ 9.6 KB
      • 两块 ≈ 19 KB（不含 LVGL 内部堆和控件开销）
    • 如果内存紧张，可以：
      • 减少缓冲区高度（例如*10行）
      • 使用单缓冲（second buffer = NULL）

  • 多线程 / RTOS

    • 在 FreeRTOS / ESP-IDF 下，通常会用一个 GUI 任务：
      • 任务里循环调用lv_timer_handler()
      • 其他任务通过消息队列或事件向 GUI 任务请求界面更新（避免多任务同时操作 LVGL）

  • 不同分辨率 / 方向

    • 每个显示器可以有自己的hor_res/ver_res。
    • 需要旋转时，可使用disp_drv.sw_rotate和disp_drv.rotated（若硬件不支持旋转）。

  • 输入设备绑定

    • 一个输入设备可以指定绑定到某个lv_disp_t，这样同一个坐标系只作用在对应的屏幕上（lv_indev_set_disp(indev, disp)）。

通过以上步骤，就可以在 LVGL9 中同时驱动两个物理屏幕，并在每个屏上加载不同的界面、独立处理输入。如果你已经有单屏工程，只需要：

  1. 再注册一个lv_disp_drv_t和flush_cb作为第二块屏；
  2. 为第二块屏创建自己的 Screen 并lv_disp_load_scr(disp2, scr2)；
  3. 保持原有lv_timer_handler()循环不变，即可完成双屏扩展。
版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/5/8 15:21:19

MQTT网络传输协议巩固知识基础题（2）

1. MQTT 中的 Client ID 最大长度是多少？ A. 64 字符 B. 128 字符 C. 256 字符 D. 没有限制 答案：D 解析： MQTT 协议规范没有明确规定 Client ID 的最大长度，但实际实现中通常有限制。 2. MQTT 中的 Keep Alive 时间单位是什么？ A. 毫秒 B. 秒 C. 分钟 D. 小时 答案：…

作者头像 李华
网站建设 2026/5/9 3:14:40

Gemini 3 Pro国内使用教程（2025最新教程）

Gemini 3 Pro在编程、长文本处理、数学推理、科研文献解析以及图像识别等多个领域均展现出卓越性能，吸引了大量国内用户的关注。许多人都听闻过其强大功能，并渴望亲自体验，然而受网络条件、支付方式与账户注册等多重因素限制，能够…

作者头像 李华
网站建设 2026/5/10 19:16:03

leetcode 困难题 753. Cracking the Safe 破解保险箱

Problem: 753. Cracking the Safe 破解保险箱 解题过程 太难了，不会的，看了官方题解和另一个人的题解，总算稍稍理解了，dfs(0);，dfs从0开始，因n-1个0，实际数值还是0，所以的话就从0开始…

作者头像 李华
网站建设 2026/5/5 10:33:36

百度网盘解析工具终极指南：3分钟告别下载限速烦恼

百度网盘解析工具终极指南：3分钟告别下载限速烦恼 【免费下载链接】baidu-wangpan-parse 获取百度网盘分享文件的下载地址 项目地址: https://gitcode.com/gh_mirrors/ba/baidu-wangpan-parse 还在为百度网盘的龟速下载而抓狂吗？每次看着几十KB的…

作者头像 李华
网站建设 2026/5/9 13:05:34

LobeChat能否实现单元测试生成？覆盖率提升辅助工具

LobeChat能否实现单元测试生成？覆盖率提升辅助工具 在现代软件开发中，高质量的单元测试是保障系统稳定性的基石。然而，现实往往令人沮丧：许多团队仍在手动编写重复的测试用例，或是面对遗留代码束手无策——既不敢重构…

作者头像 李华
网站建设 2026/5/6 19:23:22

LobeChat能否用于生成产品命名？创业公司品牌策划帮手

LobeChat 能否成为创业公司的品牌命名利器？ 在智能硬件发布会的前夜，创始团队围坐在会议室里，白板上贴满了潦草的便签纸——“SmartRing”“LifeBand”“NovaFit”……这些名字要么已被注册，要么听起来像十年前的产品。时间一分一…

作者头像 李华