LVGL移植小记

RISC-V移植LVGL图形库实践记录背景最近在一个RISC-V项目上需要用到图形界面选用了LVGL。移植过程遇到了一些问题记录下来供参考。本文以CH32V307为例LVGL版本为v7.11.0。不同版本之间接口可能有差异请注意对应。一、准备工作硬件主控RISC-V MCUCH32V307显示屏TFT LCDSPI或并口均可调试工具USB转串口、下载器软件IDEMounRiver Studio编译器RISC-V GCC源码LVGL核心库 官方Demo前置条件建议先确保以下几点能正常编译烧录一个简单的裸机工程如点灯LCD底层驱动已经调通能正常画点、填充颜色对C语言和嵌入式开发有一定基础二、获取源码从GitHub克隆在国内可能较慢可以通过官方镜像下载wget https://download.lvgl.io/lvgl/v7/lvgl-v7.11.0.tar.gzwget https://download.lvgl.io/demos/v7/lv_demos-v7.11.0.tar.gz注意核心库与Demo版本需要保持一致否则可能出现运行时错误。解压后得到lvgl和lv_demos两个文件夹。三、工程目录结构建议按以下方式组织文件Project/├── Drivers/ # LCD、触摸等硬件驱动│ ├── lcd.c│ ├── lcd.h│ └── touch.c├── GUI/ # LVGL相关│ ├── lvgl/ # 核心库│ ├── lvgl_port/ # 移植层显示、输入驱动│ └── lv_demos/ # 示例代码├── User/│ └── main.c└── lv_conf.h # LVGL配置文件这样区分便于维护后续升级时也容易替换。四、配置LVGL4.1 复制配置文件将lvgl/lv_conf_template.h复制到工程根目录重命名为lv_conf.h。将lv_demos/lv_examples/lv_ex_conf_template.h复制到工程根目录重命名为lv_ex_conf.h。4.2 修改 lv_conf.h打开lv_conf.h将开头的#if 0改为#if 1启用配置。根据实际硬件修改以下参数以240×480分辨率、16位色深为例/* 屏幕分辨率 */#define LV_HOR_RES_MAX 240#define LV_VER_RES_MAX 480/* 颜色深度16位RGB565 */#define LV_COLOR_DEPTH 16/* DPI设置适合小尺寸屏幕 */#define LV_DPI 130/* 内存配置根据实际RAM大小调整 /#define LV_MEM_SIZE (24U * 1024U) / 24KB足够运行Widgets Demo */#define LV_MEM_CUSTOM 0/* 显示刷新周期30ms ≈ 33FPS */#define LV_DISP_DEF_REFR_PERIOD 30如果出现画面撕裂可以尝试增加刷新周期或减小缓冲区大小最后再考虑增大LV_MEM_SIZE。4.3 修改 lv_ex_conf.h打开lv_ex_conf.h同样将#if 0改为#if 1根据需要开启对应的Demo宏。五、移植显示驱动这是移植的核心部分需要实现一个disp_flush函数将LVGL的绘制数据输出到LCD。5.1 准备移植文件在lvgl/examples/porting/目录下lv_port_disp_template.c→lv_port_disp.clv_port_disp_template.h→lv_port_disp.hlv_port_indev_template.c→lv_port_indev.c如需触摸lv_port_indev_template.h→lv_port_indev.h如需触摸5.2 实现显示驱动打开lv_port_disp.c将文件开头的#if 0改为#if 1。包含LCD驱动头文件#include “lv_port_disp.h”#include “lcd.h”定义显示缓冲区。LVGL提供了三种方案/* 方案1单缓冲最简单适合资源极紧张的场合 */static lv_color_t draw_buf_1[LV_HOR_RES_MAX * 10];lv_disp_buf_init(draw_buf_dsc_1, draw_buf_1, NULL, LV_HOR_RES_MAX * 10);/* 方案2双部分缓冲推荐兼顾性能与内存 */static lv_color_t buf_2_1[LV_HOR_RES_MAX * 20];static lv_color_t buf_2_2[LV_HOR_RES_MAX * 20];lv_disp_buf_init(draw_buf_dsc_2, buf_2_1, buf_2_2, LV_HOR_RES_MAX * 20);/* 方案3双全屏缓冲性能最好内存消耗最大 */static lv_color_t buf_3_1[LV_HOR_RES_MAX * LV_VER_RES_MAX];static lv_color_t buf_3_2[LV_HOR_RES_MAX * LV_VER_RES_MAX];lv_disp_buf_init(draw_buf_dsc_3, buf_3_1, buf_3_2, LV_HOR_RES_MAX * LV_VER_RES_MAX);对于RAM有限的MCU建议使用方案2。实现disp_flush函数void disp_flush(lv_disp_drv_t * disp_drv, const lv_area_t * area, lv_color_t * color_p){int32_t x, y;for(y area-y1; y area-y2; y) {for(x area-x1; x area-x2; x) {lcd_draw_point(x, y, color_p-full);color_p;}}lv_disp_flush_ready(disp_drv);}注意每次写入一个像素后color_p指针需要自增否则会一直写同一个颜色。如果LCD驱动支持区域填充建议改为批量写入能明显提高刷新速度。六、移植触摸驱动可选如果需要触摸功能在lv_port_indev.c中实现坐标读取bool touch_read(lv_indev_drv_t * indev_drv, lv_indev_data_t * data){uint16_t x, y;bool pressed touch_get_coord(x, y);if(pressed) {>七、将LVGL加入工程7.1 添加源文件在IDE中添加以下目录中的所有.c文件lvgl/src/lvgl_port/lv_demos/如果需要Demo7.2 添加头文件路径编译器搜索路径需包含lvgl/lvgl/src/lvgl_port/lv_demos/工程根目录lv_conf.h所在位置7.3 编译器优化选项在使用MounRiver Studio时默认的-O2优化可能导致动画异常。建议改为-Og并勾选-fno-strict-aliasing。位置在项目属性的C/C Build → Settings → Optimization中。八、主程序编写8.1 初始化顺序#include “lvgl.h”#include “lv_port_disp.h”#include “lv_port_indev.h”int main(void){SystemClock_Config();lcd_init();touch_init(); // 可选lv_init();lv_port_disp_init();lv_port_indev_init(); // 可选lv_demo_widgets(); // 或者自定义UIwhile(1) {lv_task_handler();delay_ms(5);}}8.2 提供心跳LVGL需要周期性的时钟中断来驱动动画和定时器。可以在定时器中断中调用void TIMx_IRQHandler(void){lv_tick_inc(1); // 1ms一次}九、编译与调试常见问题找不到 lv_conf.h检查头文件路径是否包含工程根目录或添加宏LV_CONF_INCLUDE_SIMPLE。内存不足减小LV_MEM_SIZE或缓冲区大小。链接错误检查是否所有.c文件都已添加。烧录后如果屏幕正常显示Demo界面说明移植成功。如果黑屏建议按以下顺序检查disp_flush中color_p指针是否自增LCD初始化是否正确lv_conf.h中的分辨率是否与屏幕匹配LVGL初始化是否执行完毕十、一些优化思路如果界面不够流畅可以尝试使用双部分缓冲代替单缓冲在disp_flush中使用区域填充代替逐点绘制适当降低刷新周期如有DMA可用于传输显示数据使用-Og优化等级避免-O2引起的动画问题总结移植LVGL到RISC-V平台核心就是实现显示驱动的disp_flush回调让LVGL能够把绘制数据送到屏幕上。配置好分辨率、颜色深度和内存大小按正确的顺序初始化基本就能跑起来。整个过程不算复杂但细节较多。希望这份记录对你有帮助。