在MDK中自动部署LVGL,在stm32f407ZGT6移植LVGL-8.3
- 一、硬件平台
- 二、实现功能
- 三、移植步骤
-
- 1、下载LVGL-8.4
- 2、MDK中安装LVGL-8.4
- 3、配置RTE
- [4、配置头文件 lv_conf_cmsis.h](#4、配置头文件 lv_conf_cmsis.h)
- 5、配置lv_port_disp_template
- 四、添加心跳相关文件
- 五、修改main函数
- 六、配置MDK编译选项
- 七、在LVGL中显示字符串
一、硬件平台
核心板:正点原子 探索者 STM32F407ZGT6
4'3寸电容触摸屏
二、实现功能
1、运行lv_demo_benchmark.c这个demo实例;
2、在屏幕上显示字符串。
三、移植步骤
1、下载LVGL-8.4
下载的渠道很多:
- 微信公众号:裸机思维
这里有两个版本的 cmsis-pack:
- v8.4.0 : 官方的维护性更新,这是目前最稳定也最推荐的版本。
- v9.2.1: LVGL9 的稳定性更新。加入对ST-DMA2D的支持,加入对Ne maGFX的支持。加入新Demo eBike。
- gitee
lvgl/lvgl - Gitee.com
2、MDK中安装LVGL-8.4
直接通过MDK的Pack-Installer进行直接安装。
下载解压之后,得到pack包:
然后在Pack Installer中安装即可。
安装成功,可以在RTE中可以看到安装的LVGL。
为了确保工程文件的完整性,把C:\Keil_v5\ARM\PACK\LVGL\lvgl\8.4.0目录下的demo、examples、src、lvgl.h复制到自己的工程目录...\MDK-ARM\RTE\LVGL中。
3、配置RTE
在MDK中通过菜单 Project->Manage->Run-Time Enviroment 打开RTE配置窗口,找到LVGL将其展开,勾选benchmark、Essential、Extra Themes和porting。
单击"OK",可以看到LVGL已经自动加入到工程列表中。
4、配置头文件 lv_conf_cmsis.h
是对lvgl组件进行配置,包括屏幕尺寸、颜色深度、RGB565模式等。具体请参考LVGL配置与移植指南-CSDN博客 。
重要的是
:将开头处 #if 0 修改为 #if 1,使整个头文件生效。
可以根据实际情况,修改其他参数,例如把所需内存改小一些:
#define LV_MEM_SIZE (16U * 1024U) /*[bytes]*/
5、配置lv_port_disp_template
- 打开
lv_port_disp_template.h
,将开头处#if 0
修改为#if 1
,使整个头文件生效。 - 包含lcd.h
c
#include lcd.h
- 打开
lv_port_disp_template.c
,将开头处#if 0
修改为#if 1
,使整个头文件生效。 - 修改屏幕分辨率
c
#define MY_DISP_HOR_RES 480
#define MY_DISP_VER_RES 800
- 选择定义缓冲区的方式。LVGL提供了三种缓冲的方式:第一种只有一个缓冲区;第二种有2个缓冲区,用于DMA;第三种是2个全缓冲区。本次选择第一种,把其他2种定义缓冲区的代码删除。否则,可能在编译时出现容量不足的错误。
- 修改disp_init函数,增加LCD驱动中的初始化代码。
c
static void disp_init(void)
{
/*You code here*/
lcd_init();
}
- 修改disp_flush函数,增加正点原子的填充函数。
c
static void disp_flush(lv_disp_drv_t * disp_drv, const lv_area_t * area, lv_color_t * color_p)
{
lcd_color_fill(area->x1, area->y1, area->x2, area->y2, (uint16_t *)color_p);
/*IMPORTANT!!!
*Inform the graphics library that you are ready with the flushing*/
lv_disp_flush_ready(disp_drv);
}
- 在RTE_Components.h文件中,定义宏:
#define LV_LVGL_H_INCLUDE_SIMPLE
四、添加心跳相关文件
LVGL的 30ms 心跳 通过调用定时器7的中断来实现。
1、在STM32CubeMX中配置TIM7的参数
预分频8400-1,时钟计数300-1,那么30ms产生一次更新中断。
2、使能中断,中断优先级尽可能高

配置完成之后,自动生成TIM7的配置和初始化代码。
3、编写中断回调函数
c
void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim)
{
if(htim->Instance == TIM6) {
//HAL_GPIO_TogglePin(GPIOF, GPIO_PIN_10); // LED1翻转
}
else if(htim->Instance == TIM7) {
lv_tick_inc(30); // 关键!通知LVGL时间流逝30ms
}
}
4、在main函数中调用配置、初始化和使能中断的HAL库函数
c
MX_TIM7_Init();
HAL_TIM_Base_Start_IT(&htim7);// 启动TIM7中断
五、修改main函数
1、对LVGL进行初始化
- 增加包含头文件
c
#include "RTE_Components.h"
#include "lv_port_disp_template.h"
- 在main函数中增加初始化函数
cpp
lv_init(); // lvgl系统初始化
lv_port_disp_init(); // lvgl显示接口初始化,放在lv_init()的后面
2、在while中,增加lv_task_handler函数。
在 LVGL 中,lv_task_handler() 是 核心任务处理函数,负责执行 LVGL 的内部任务调度(如界面刷新、动画处理、输入设备事件处理等)。
c
while (1)
{
/* USER CODE END WHILE */
/* USER CODE BEGIN 3 */
delay_ms(1000);
lv_task_handler(); // lvgl的事务处理
}
3、运行lv_demo_benchmark
- 在main函数中增加头文件
c
#include "lv_demo_benchmark.h"
- 在"魔术棒"->"C/C++"->"Define"中,添加
LV_USE_DEMO_BENCHMARK

- 调用lv_demo_benchmark函数
c
lv_init(); // lvgl系统初始化
lv_port_disp_init(); // lvgl显示接口初始化,放在lv_init()的后面
lv_demo_benchmark();
六、配置MDK编译选项
1、修改堆栈大小
注意的是:要跑这个Demo,Stack(栈)和 Heap(堆)各自都不能小于 4K,切记,切记!
在STM32CubeMX中修改
2、增加预编译宏
在"魔术棒"->"C/C++"->"Define"中,添加LV_CONF_SKIP
和LV_LVGL_H_INCLUDE_SIMPLE
3、注意:移植 LVGL 必须开启 C99 模式

七、在LVGL中显示字符串
利用LVGL的Labe标签显示字符串。参考资料:
LVGL lv_label标签控件
1、修改lv_conf_cmsis.h
在\RTE\LVGL\lv_conf_cmsis.h文件中,修改成
c
#define LV_FONT_MONTSERRAT_32 1
2、增加预编译宏
在"魔术棒"->"C/C++"->"Define"中,添加LV_FONT_MONTSERRAT_32
3、修改main函数
c
lv_init(); // lvgl系统初始化
lv_port_disp_init(); // lvgl显示接口初始化,放在lv_init()的后面
lv_demo_benchmark();
lv_obj_t * label = lv_label_create(lv_scr_act()); // 在活动屏幕上创建标签
lv_label_set_text(label, "Hello LVGL!"); // 设置文本
lv_obj_align(label, LV_ALIGN_CENTER, 0, 0); // 居中显示
lv_obj_set_style_text_font(label, &lv_font_montserrat_32, LV_PART_MAIN);
-
lv_label_create(lv_scr_act())
创建一个标签对象,并绑定到当前活动屏幕(lv_scr_act() 返回默认屏幕)。
lv_obj_t* 是 LVGL 中所有控件的基类(类似面向对象中的父类)。
-
lv_label_set_text()
设置标签的文本内容(支持动态更新,如显示传感器数据)。
-
lv_obj_align()
将标签对齐到屏幕中心(LV_ALIGN_CENTER),后两个参数是偏移量(这里为 0)。
-
lv_obj_set_style_text_font()
设置字体为 lv_font_montserrat_32(32 像素高的 Montserrat 字体)。
4、while中的lv_task_handler函数,在心跳的控制下处理事务
编译下载运行结果如下: