lvgl移植流程

移植准备

基于梁山派屏幕扩展板mcu屏幕源码Screen_MCU移植
下载lvgl 8.3版本源码下载地址:https://github.com/lvgl/lvgl
参考文档:Set-up a project — LVGL documentation

移植步骤

1. 删除源码

删除源码中不需要的文件夹，仅保留如下内容

demos : lvgl综合案例
examples ：单个功能案例
src ：源代码
lv_conf_template.h ：重要的配置文件，里面存在非常多的开关
lvgl.h ：头文件

将上述内容存放刀名为lvgl的文件夹中

2.导入lvgl到项目screen_mcu中

在screen_mcu项目中新建third_party文件夹
将第1个步骤中的lvgl文件夹拷入其中
将lvgl文件夹中的lv_conf_tempalate.h修改为lv_conf.h
把lv_conf.h的条件编译指令#if 0修改成#if 1

3.keil添加分组和头文件

1. 使用keil打开screen_mcu项目,添加如下分组

third_party/lvgl/example/porting
third_party/lvgl/src/core
third_party/lvgl/src/draw
third_party/lvgl/src/extra
third_party/lvgl/src/font
third_party/lvgl/src/gpu
third_party/lvgl/src/hal
third_party/lvgl/src/misc
third_party/lvgl/src/widgets

2. 添加LVGL相关的.c文件到相应分组,如下:

3. 添加头文件路径

4. 开启C99模式

移植显示
1把lv_port_disp_template.c/h的条件编译指令#if 0修改成#if 1
2lv_port_disp_template.h中包含输出设备驱动头文件lcd.h
3lv_port_disp_template.h中宏定义水平和竖直分辨率(默认横屏)

#define MY_DISP_HOR_RES 240 //水平分辨率#define MY_DISP_VER_RES 280 //垂直分辨率

5. 修改 lv_port_disp_template.c中的 lv_port_disp_init 函数
配置图形数据缓冲模式
在lv_port_disp_init函数中选择一种缓冲模式,注释掉其它两种模式

修改宽高

disp_drv.hor_res = lcddev.width;
disp_drv.ver_res = lcddev.height;

6. 在disp_flush函数中配置打点输出

static void disp_flush(lv_disp_drv_t * disp_drv, const lv_area_t * area, lv_color_t * color_p)
{ST7789_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);
}

4. 移植触摸

把lv_port_indev_tempalte.c/h的条件编译#if 0 修改成# if 1
在lv_port_indev_tempalte.c中裁剪输入设备

只保留touchpad_xxx相关的方法,删除其它方法
lv_port_indev_init中只保留touchpad相关的代码
在touchpad_init方法中执行触摸屏初始化CST816T_Init();

/*Initialize your touchpad*/
static void touchpad_init(void)
{GT1151_Init();              //触摸屏初始化
}

3. 配置触摸检测函数

/*Return true is the touchpad is pressed*/
static bool touchpad_is_pressed(void)
{/*Your code comes here*/return CST816T_is_pressed();// return false;
}

4. 配置坐标获取函数

/*Get the x and y coordinates if the touchpad is pressed*/
static void touchpad_get_xy(lv_coord_t * x, lv_coord_t * y)
{/*Your code comes here*/CST816T_get_xy((uint16_t*)x,(uint16_t*)y);//(*x) = 0;//(*y) = 0;
}

提示

lv_port_indev_template.c修改之后代码如下:

/*** @file lv_port_indev_templ.c**//*Copy this file as "lv_port_indev.c" and set this value to "1" to enable content*/
#if 1/**********************      INCLUDES*********************/
#include "lv_port_indev_template.h"
//#include "../../lvgl.h"
#include "cst816t.h"/**********************      DEFINES*********************//***********************      TYPEDEFS**********************//***********************  STATIC PROTOTYPES**********************/static void touchpad_init(void);
static void touchpad_read(lv_indev_drv_t * indev_drv, lv_indev_data_t * data);
static bool touchpad_is_pressed(void);
static void touchpad_get_xy(lv_coord_t * x, lv_coord_t * y);static void mouse_init(void);
static void mouse_read(lv_indev_drv_t * indev_drv, lv_indev_data_t * data);
static bool mouse_is_pressed(void);
static void mouse_get_xy(lv_coord_t * x, lv_coord_t * y);static void keypad_init(void);
static void keypad_read(lv_indev_drv_t * indev_drv, lv_indev_data_t * data);
static uint32_t keypad_get_key(void);static void encoder_init(void);
static void encoder_read(lv_indev_drv_t * indev_drv, lv_indev_data_t * data);
static void encoder_handler(void);static void button_init(void);
static void button_read(lv_indev_drv_t * indev_drv, lv_indev_data_t * data);
static int8_t button_get_pressed_id(void);
static bool button_is_pressed(uint8_t id);/***********************  STATIC VARIABLES**********************/
lv_indev_t * indev_touchpad;
lv_indev_t * indev_mouse;
lv_indev_t * indev_keypad;
lv_indev_t * indev_encoder;
lv_indev_t * indev_button;static int32_t encoder_diff;
static lv_indev_state_t encoder_state;/***********************      MACROS**********************//***********************   GLOBAL FUNCTIONS**********************/void lv_port_indev_init(void)
{/*** Here you will find example implementation of input devices supported by LittelvGL:*  - Touchpad*  - Mouse (with cursor support)*  - Keypad (supports GUI usage only with key)*  - Encoder (supports GUI usage only with: left, right, push)*  - Button (external buttons to press points on the screen)**  The `..._read()` function are only examples.*  You should shape them according to your hardware*/static lv_indev_drv_t indev_drv;/*------------------* Touchpad* -----------------*//*Initialize your touchpad if you have*/touchpad_init();/*Register a touchpad input device*/lv_indev_drv_init(&indev_drv);indev_drv.type = LV_INDEV_TYPE_POINTER;indev_drv.read_cb = touchpad_read;indev_touchpad = lv_indev_drv_register(&indev_drv);}/***********************   STATIC FUNCTIONS**********************//*------------------* Touchpad* -----------------*//*Initialize your touchpad*/
static void touchpad_init(void)
{/*Your code comes here*/CST816T_Init();
}/*Will be called by the library to read the touchpad*/
static void touchpad_read(lv_indev_drv_t * indev_drv, lv_indev_data_t * data)
{static lv_coord_t last_x = 0;static lv_coord_t last_y = 0;/*Save the pressed coordinates and the state*/if(touchpad_is_pressed()) {touchpad_get_xy(&last_x, &last_y);data->state = LV_INDEV_STATE_PR;}else {data->state = LV_INDEV_STATE_REL;}/*Set the last pressed coordinates*/data->point.x = last_x;data->point.y = last_y;
}/*Return true is the touchpad is pressed*/
static bool touchpad_is_pressed(void)
{/*Your code comes here*/return CST816T_is_pressed();// return false;
}/*Get the x and y coordinates if the touchpad is pressed*/
static void touchpad_get_xy(lv_coord_t * x, lv_coord_t * y)
{/*Your code comes here*/CST816T_get_xy((uint16_t*)x,(uint16_t*)y);//(*x) = 0;//(*y) = 0;
}#else /*Enable this file at the top*//*This dummy typedef exists purely to silence -Wpedantic.*/
typedef int keep_pedantic_happy;
#endif

6.添加测试案例

测试音乐界面

keil添加lvgl/demos/music文件夹下所有.c文件
添加相关头文件路径

..\..\third_party\lvgl\demos
..\..\third_party\lvgl\demos\music

3. 修改lv_conf.h中的

#define LV_USE_DEMO_MUSIC 0 改为 #define LV_USE_DEMO_MUSIC 1

#define LV_FONT_MONTSERRAT_12 0 改为 #define LV_FONT_MONTSERRAT_12 1

#define LV_FONT_MONTSERRAT_16 0 改为#define LV_FONT_MONTSERRAT_16 1

#define LV_USE_DEMO_MUSIC       0
改为
#define LV_USE_DEMO_MUSIC       1#define LV_FONT_MONTSERRAT_12 0
改为
#define LV_FONT_MONTSERRAT_12 1#define LV_FONT_MONTSERRAT_16 0
改为
#define LV_FONT_MONTSERRAT_16 1

7.main.c主函数

#include "gd32f4xx.h"
#include "systick.h"
#include <stdio.h>
#include "main.h"
#include "bsp_basic_timer.h"#include "lcd.h"
#include "touch.h"#include "lvgl.h"#include "lv_demo_music.h"
#include "lv_conf.h"
#include "lv_port_disp_template.h"
#include "lv_port_indev_template.h"int main(void)
{nvic_priority_group_set(NVIC_PRIGROUP_PRE2_SUB2);  // 优先级分组systick_config();	lv_init();lv_port_disp_init();lv_port_indev_init();	lv_demo_music();while(1){lv_tick_inc(1);lv_timer_handler();delay_1ms(5);}
}

8.提高堆栈内存大小

修改startup_gd32f450_470.s中的Stack_Size

原始:
Stack_Size EQU 0x00000400
修改后:
Stack_Size EQU 0x00000800

9. 提供时钟

在Hardware下创建timer文件夹,文件夹下定义bsp_basic_timer.h和bsp_basic_timer.c文件,内容如下

bsp_basic_timer.h

#ifndef _BSP_BASIC_TIMER_H
#define _BSP_BASIC_TIMER_H#include "gd32f4xx.h"
#include "systick.h"
#include "stdio.h"
#include "lvgl.h"#define BSP_TIMER_RCU  				RCU_TIMER5            // 定时器时钟
#define BSP_TIMER      				TIMER5                // 定时器
#define BSP_TIMER_IRQ  				TIMER5_DAC_IRQn       // 定时器中断
#define BSP_TIMER_IRQHANDLER  TIMER5_DAC_IRQHandler // 定时器中断服务函数//#define BSP_TIMER_RCU  				RCU_TIMER2					// 定时器时钟
//#define BSP_TIMER      				TIMER2							// 定时器
//#define BSP_TIMER_IRQ  			  TIMER2_IRQn					// 定时器中断
//#define BSP_TIMER_IRQHANDLER  TIMER2_IRQHandler		// 定时器中断服务函数void basic_timer_config(uint16_t pre,uint16_t per); // 基本定时器配置#endif  /* BSP_BASIC_TIMER_H */

bsp_basic_timer.c


#include "bsp_basic_timer.h"
//#include "bsp_led.h"/************************************************
函数名称 ： basic_timer_config
功    能 ： 基本定时器配置
参    数 ： pre：时钟预分频值per：周期 
*************************************************/
void basic_timer_config(uint16_t pre,uint16_t per)
{/* 一个周期的时间T = 1/f, 定时时间time = T * 周期设预分频值位pre,周期位pertime = (pre + 1) * (per + 1) / psc_clk*/timer_parameter_struct timere_initpara; 							// 定义定时器结构体/* 开启时钟 */rcu_periph_clock_enable(BSP_TIMER_RCU); 							// 开启定时器时钟/* CK_TIMERx = 4 x CK_APB1  = 4x50M = 200MHZ */rcu_timer_clock_prescaler_config(RCU_TIMER_PSC_MUL4); // 配置定时器时钟timer_deinit(BSP_TIMER);														  // 复位定时器/* 配置定时器参数 */timere_initpara.prescaler = pre-1;                    //  时钟预分频值 0-65535   psc_clk = CK_TIMER / pretimere_initpara.alignedmode = TIMER_COUNTER_EDGE;     // 边缘对齐                  timere_initpara.counterdirection = TIMER_COUNTER_UP;  // 向上计数    timere_initpara.period = per-1;                       // 周期  /* 在输入捕获的时候使用  数字滤波器使用的采样频率之间的分频比例 */timere_initpara.clockdivision = TIMER_CKDIV_DIV1;     // 分频因子         /* 只有高级定时器才有 配置为x，就重复x+1次进入中断 */    timere_initpara.repetitioncounter = 0;							  // 重复计数器 0-255  timer_init(BSP_TIMER,&timere_initpara);								// 初始化定时器/* 配置中断优先级 */nvic_irq_enable(BSP_TIMER_IRQ,3,2); 									// 设置中断优先级为 3,2/* 使能中断 */timer_interrupt_enable(BSP_TIMER,TIMER_INT_UP);       // 使能更新事件中断 /* 使能定时器 */timer_enable(BSP_TIMER);
}/************************************************
函数名称 ： BSP_TIMER_IRQHandler
功    能 ： 基本定时器中断服务函数 
参    数 ： 无
返 回 值 ： 无
作    者 ： LC
*************************************************/
void BSP_TIMER_IRQHANDLER(void)
{/* 这里是定时器中断 */if(timer_interrupt_flag_get(BSP_TIMER,TIMER_INT_FLAG_UP) == SET){timer_interrupt_flag_clear(BSP_TIMER,TIMER_INT_FLAG_UP);  // 清除中断标志位 /* 执行功能 */lv_tick_inc(1);}
}

定义之后,keil添加.c文件和头文件即可