移植准备
- 基于GD32屏幕扩展板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添加分组和头文件
- 使用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
- 添加LVGL相关的.c文件到相应分组,如下:
- 添加头文件路径
- 开启C99模式
3. 移植显示
- 把lv_port_disp_template.c/h的条件编译指令#if 0修改成#if 1
- lv_port_disp_template.h中包含输出设备驱动头文件lcd.h
- lv_port_disp_template.h中宏定义水平和竖直分辨率(默认横屏)
#define MY_DISP_HOR_RES 240 //水平分辨率
#define MY_DISP_VER_RES 280 //垂直分辨率
- 修改 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;
- 初始化ST7789
/*Initialize your display and the required peripherals.*/
static void disp_init(void)
{
/*You code here*/
ST7789_Init();
}
- 在disp_flush函数中配置打点输出
static void disp_flush(lv_disp_drv_t * disp_drv, const lv_area_t * area, lv_color_t * color_p)
{
if(disp_flush_enabled) {
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(); //触摸屏初始化
}
- 配置触摸检测函数
/*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;
}
提示
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.添加测试案例
测试按钮
#include "gd32f4xx.h"
#include "systick.h"
#include <stdio.h>
#include <string.h>
#include "USART.h"
#include "I2C.h"
#include "st7789.h"
#include "cst816t.h"
#include "lvgl.h"
#include "lv_port_disp.h"
#include "lv_port_indev.h"
// 事件回调
void event_handler(lv_event_t* e) {
lv_event_code_t code = lv_event_get_code(e);
if (code == LV_EVENT_VALUE_CHANGED) {
printf("toggled btn\n");
}
}
void demo_button_checkable() {
// 获取显示图层
lv_obj_t* screen = lv_scr_act();
// 创建按钮
lv_obj_t* btn = lv_btn_create(screen);
// 设置按钮尺寸
lv_obj_set_size(btn, 120, 50);
// 4. 在按钮上创建文本并居中显示
lv_obj_t* label = lv_label_create(btn);
lv_label_set_text(label, "Toggle");
// lv_obj_center(label);
lv_obj_align(label, LV_ALIGN_CENTER, 0, 0);
// 5. 设置按钮可选中
lv_obj_add_flag(btn, LV_OBJ_FLAG_CHECKABLE);
// 默认选中
// lv_obj_add_state(btn, LV_STATE_CHECKED);
lv_obj_add_event_cb(btn, event_handler, LV_EVENT_VALUE_CHANGED, NULL);
// 居中
lv_obj_center(btn);
}
主函数
int main(void) {
// 配置全局中断分组
nvic_priority_group_set(NVIC_PRIGROUP_PRE2_SUB2);
// 初始化系统嘀嗒定时器
systick_config();
// 初始化USART
USART_init();
I2C_init();
// 1. 初始化LVGL
lv_init();
// 2.显示屏驱动初始化
lv_port_disp_init();
// 3. 触摸屏(输入设备要在屏幕初始化之后再init,否则会失效)
lv_port_indev_init();
demo_button_checkable();
while(1) {
// 4. 每隔x毫秒调用一次心跳
lv_tick_inc(1);
// 5. 执行定时任务(屏幕渲染,事件处理)
lv_timer_handler();
// 休眠1ms
delay_1ms(1);
}
}
测试音乐界面
- keil添加lvgl/demos/music文件夹下所有.c文件
- 添加相关头文件路径
..\..\third_party\lvgl\demos
..\..\third_party\lvgl\demos\music
- 修改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
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();
// 这里必须先初始化disp再初始化indev
lv_port_disp_init();
lv_port_indev_init();
lv_demo_music();
while(1)
{
lv_tick_inc(1);
lv_timer_handler();
delay_1ms(1);
}
}
2. 提高堆栈内存大小
修改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,周期位per
time = (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 / pre
timere_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文件和头文件即可
错误处理
错误一
.\Objects\GD32F450.axf: Error: L6218E: Undefined symbol __aeabi_assert (referred from qrcodegen.o).
解决方案:
添加NDEBUG
宏定义
设置如下即可