1、lvgl简介
lvgl是一款全部用c语言实现的ui图形库,对硬件的要求比较低,可以较为流畅的运行在单片机上。并且完全开源,对按钮,触摸,编码器旋钮等支持的非常到位。且开发的界面较为美观,符合时下主流的审美。
目前最新版本已经更新到了8.3版本,官网地址为https://lvgl.io/。本次移植使用的是8.1版本。下载链接为https://github.com/lvgl/lvgl/releases/tag/v8.1.0
2、lvgl源码
下载完成后接下,源码根目录如下 移植需要用的目录是src和examples文件夹。src存放的源码,examples是示例
2.1stm32工程新建lvgl文件夹
将lvgl8.1目录下的src examples lvgl.h lv_conf_template.h拷贝放入lvgl文件夹 lvgl文件目录如下: 将lv_conf_template.h改为lv_conf.h 打开lv_config.h 将第一行#if 0 改为 #if 1,来使能lv_conf.h。
2.2porting文件夹
打开lvgl/examples/porting文件夹,这个文件夹放的是与硬件层交互的数据。 将8个文件中的_template全部去掉,lv_port_disp.h中将#if 0改为#if 1。将宏定义中的_TEMP去掉。将lv_port_disp.c中的宏定义改为#include “lv_port_disp.h”。其他fs indev也依照此进行修改。 fs 是跟文件系统相关的。 indev是跟输入设备相关的,按钮,触摸屏,鼠标等相关的。
3 修改stm32工程
用keilmdk打开工程。
3.1使能c99
在配置界面将c99 mode选项勾选。 lvgl中结构体初始化用到了指定初始化功能,这个功能c99标准才支持。不勾选编译会出错
3.2添加lvgl 和lvgl_port组
项目下添加lvgl和lvgl_port组
3.2添加port文件
打开组管理器,添加disp和indev,位于lvgl/examples/porting,因为没有用到文件系统,故没有添加fs
3.2添加lvgl源文件
将lvgl/src目录下的core draw font hal misc widgets文件夹下的所有文件全部添加进lvgl组
将lvgl/src/extra/目录下的文件添加进lvgl组。具体为:
layouts目录下所有子目录文件 themes目录下所有子目录文件 widgets目录下所有子目录文件 lv_extra.c
3.3配置中添加source目录
将lvgl ,src,porting文件夹添加到源路径下。
4 编译
完成上述后,编译会报错。这里就直接把要修改的地方写出来。
4.1修改lv_port_disp.h
将其中的#include改为如下
4.2添加屏幕像素宏定义
在lv_conf.h中添加屏幕像素宏定义,我用的屏幕大小是320*240,按照实际填写
#define MY_DISP_HOR_RES 320 #define MY_DISP_VER_RES 240
4.3设置lvglbuffer
在lvgl_port_disp.c中有三种大小的buffer,这里选择1,lvgl默认选择的就是1。 3是全尺寸屏幕刷新,消耗的内存太大,如果使用了外部sram优选方式3,选了方式3还需要添加LV_VER_RES_MAX宏定义。
将方式2和3屏蔽掉.后续根据实际使用进行调整。 然后将lvgl_port_disp.c下面两个变量值设置为如下:
disp_drv.hor_res = MY_DISP_HOR_RES; disp_drv.ver_res = MY_DISP_VER_RES;
最后进行编译,应该是不会再出现错误了。
5、下载到stm32运行
5.1修改disp_flush函数
这个函数在lv_port_disp.c中,lvgl就是通过该函数用户屏幕进行数据交互。这函数的作用是,在一块区域填充颜色。 将disp_flush修改如下
LCD_COLOR_FILL函数如下:可以根据实际使用的屏幕驱动进行修改。
void LCD_Color_Fill(u16 sx,u16 sy,u16 ex,u16 ey,u16 *color)
{
u16 height,width;
u16 i,j;
width=ex-sx+1;
height=ey-sy+1;
for(i=0;i<height;i++)
{
LCD_SetCursor(sx,sy+i);
LCD_WriteRAM_Prepare();
for(j=0;j<width;j++)LCD->LCD_RAM=color[i*width+j];
}
}
5.2添加lvgl tick函数
lvgl运行都要依靠1ms周期的时钟。所有需要在stm32系统时钟中断中将lvgl的tick函数添加进来。系统时钟中断一般位于xit.c中
5.3在主循环中添加lvgl句柄函数
在主循环或者os的任务主循环中添加
lv_task_handler();
主循环的周期为10ms。
至此lvgl移植完成。
5.4运行示例
在lvgl组中添加示例文件。位于lvgl/examples/get_started文件夹 进入主循环前初始化lvgl,lvglport,启动示例。
lv_init(); lv_port_disp_init(); lv_example_get_started_1();
最终任务函数为,我这里用的是freertos,lvgl放到了一个单独的任务中运行。
void lvgl_task(void *pvParameters)
{
lv_init();
lv_port_disp_init();
lv_example_get_started_1();
while(1)
{
lv_task_handler();
vTaskDelay(10);
}
}
运行效果,会在屏幕上显示一个蓝色的按钮
|