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(); //开始写入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中
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); }}运行效果,会在屏幕上显示一个蓝色的按钮
|