stm32移植lvgl

1、lvgl简介

lvgl是一款全部用c语言实现的ui图形库,对硬件的要求比较低,可以较为流畅的运行在单片机上。并且完全开源,对按钮,触摸,编码器旋钮等支持的非常到位。且开发的界面较为美观,符合时下主流的审美。

目前最新版本已经更新到了8.3版本,官网地址为https://lvgl.io/。本次移植使用的是8.1版本。下载链接为https://github.com/lvgl/lvgl/releases/tag/v8.1.0

2、lvgl源码

下载完成后接下,源码根目录如下
stm32移植lvgl_第1张图片
移植需要用的目录是src和examples文件夹。src存放的源码,examples是示例

2.1stm32工程新建lvgl文件夹

stm32移植lvgl_第2张图片
将lvgl8.1目录下的src examples lvgl.h lv_conf_template.h拷贝放入lvgl文件夹
stm32移植lvgl_第3张图片
lvgl文件目录如下:
stm32移植lvgl_第4张图片
将lv_conf_template.h改为lv_conf.h
stm32移植lvgl_第5张图片
打开lv_config.h 将第一行#if 0 改为 #if 1,来使能lv_conf.h。

2.2porting文件夹

打开lvgl/examples/porting文件夹,这个文件夹放的是与硬件层交互的数据。
stm32移植lvgl_第6张图片
将8个文件中的_template全部去掉,lv_port_disp.h中将#if 0改为#if 1。将宏定义中的_TEMP去掉。将lv_port_disp.c中的宏定义改为#include “lv_port_disp.h”。其他fs indev也依照此进行修改。
fs 是跟文件系统相关的。
indev是跟输入设备相关的,按钮,触摸屏,鼠标等相关的。

stm32移植lvgl_第7张图片

3 修改stm32工程

用keilmdk打开工程。

3.1使能c99

stm32移植lvgl_第8张图片
在配置界面将c99 mode选项勾选。
lvgl中结构体初始化用到了指定初始化功能,这个功能c99标准才支持。不勾选编译会出错

3.2添加lvgl 和lvgl_port组

项目下添加lvgl和lvgl_port组
stm32移植lvgl_第9张图片

3.2添加port文件

打开组管理器,添加disp和indev,位于lvgl/examples/porting,因为没有用到文件系统,故没有添加fs
stm32移植lvgl_第10张图片

3.2添加lvgl源文件

将lvgl/src目录下的core draw font hal misc widgets文件夹下的所有文件全部添加进lvgl组

stm32移植lvgl_第11张图片
将lvgl/src/extra/目录下的文件添加进lvgl组。具体为:

layouts目录下所有子目录文件
themes目录下所有子目录文件
widgets目录下所有子目录文件
lv_extra.c

stm32移植lvgl_第12张图片

3.3配置中添加source目录

将lvgl ,src,porting文件夹添加到源路径下。
stm32移植lvgl_第13张图片

4 编译

完成上述后,编译会报错。这里就直接把要修改的地方写出来。

4.1修改lv_port_disp.h

将其中的#include改为如下
stm32移植lvgl_第14张图片

4.2添加屏幕像素宏定义

在lv_conf.h中添加屏幕像素宏定义,我用的屏幕大小是320*240,按照实际填写

#define MY_DISP_HOR_RES 320
#define MY_DISP_VER_RES 240
stm32移植lvgl_第15张图片

4.3设置lvglbuffer

在lvgl_port_disp.c中有三种大小的buffer,这里选择1,lvgl默认选择的就是1。
3是全尺寸屏幕刷新,消耗的内存太大,如果使用了外部sram优选方式3,选了方式3还需要添加LV_VER_RES_MAX宏定义。

将方式2和3屏蔽掉.后续根据实际使用进行调整。
stm32移植lvgl_第16张图片
然后将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修改如下

stm32移植lvgl_第17张图片

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];//写入数据 
	}		  
}  

5.2添加lvgl tick函数

lvgl运行都要依靠1ms周期的时钟。所有需要在stm32系统时钟中断中将lvgl的tick函数添加进来。系统时钟中断一般位于xit.c中
stm32移植lvgl_第18张图片

5.3在主循环中添加lvgl句柄函数

在主循环或者os的任务主循环中添加

lv_task_handler();

主循环的周期为10ms。

stm32移植lvgl_第19张图片
至此lvgl移植完成。

5.4运行示例

在lvgl组中添加示例文件。位于lvgl/examples/get_started文件夹
stm32移植lvgl_第20张图片
进入主循环前初始化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);
	
	}
}

运行效果,会在屏幕上显示一个蓝色的按钮

stm32移植lvgl_第21张图片

你可能感兴趣的:(STM32,lvgl,stm32,lvgl,图形库,移植,界面)