lvgl是一款全部用c语言实现的ui图形库,对硬件的要求比较低,可以较为流畅的运行在单片机上。并且完全开源,对按钮,触摸,编码器旋钮等支持的非常到位。且开发的界面较为美观,符合时下主流的审美。
目前最新版本已经更新到了8.3版本,官网地址为https://lvgl.io/。本次移植使用的是8.1版本。下载链接为https://github.com/lvgl/lvgl/releases/tag/v8.1.0
下载完成后接下,源码根目录如下
移植需要用的目录是src和examples文件夹。src存放的源码,examples是示例
将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。
打开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是跟输入设备相关的,按钮,触摸屏,鼠标等相关的。
用keilmdk打开工程。
在配置界面将c99 mode选项勾选。
lvgl中结构体初始化用到了指定初始化功能,这个功能c99标准才支持。不勾选编译会出错
打开组管理器,添加disp和indev,位于lvgl/examples/porting,因为没有用到文件系统,故没有添加fs
将lvgl/src目录下的core draw font hal misc widgets文件夹下的所有文件全部添加进lvgl组
将lvgl/src/extra/目录下的文件添加进lvgl组。具体为:
layouts目录下所有子目录文件
themes目录下所有子目录文件
widgets目录下所有子目录文件
lv_extra.c
完成上述后,编译会报错。这里就直接把要修改的地方写出来。
在lv_conf.h中添加屏幕像素宏定义,我用的屏幕大小是320*240,按照实际填写
在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;
最后进行编译,应该是不会再出现错误了。
这个函数在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(); //开始写入GRAM
for(j=0;j<width;j++)LCD->LCD_RAM=color[i*width+j];//写入数据
}
}
lvgl运行都要依靠1ms周期的时钟。所有需要在stm32系统时钟中断中将lvgl的tick函数添加进来。系统时钟中断一般位于xit.c中
在主循环或者os的任务主循环中添加
lv_task_handler();
主循环的周期为10ms。
在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);
}
}
运行效果,会在屏幕上显示一个蓝色的按钮