移植准备

  1. 基于梁山派屏幕扩展板mcu屏幕源码Screen_MCU移植
  2. 下载lvgl 8.3版本源码下载地址:https://github.com/lvgl/lvgl

  3. 参考文档:https://docs.lvgl.io/8/porting/project.html

    移植步骤

    删除源码

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

  4. demos : lvgl综合案例

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

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

2.导入lvgl到项目screen_mcu中

  1. 在screen_mcu项目中新建third_party文件夹
  2. 将第1个步骤中的lvgl文件夹拷入其中
  3. 将lvgl文件夹中的lv_conf_tempalate.h修改为lv_conf.h

  4. 把lv_conf.h的条件编译指令#if 0修改成#if 1

    3.keil添加分组和头文件

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

image.png

  1. third_party/lvgl/example/porting
  2. third_party/lvgl/src/core
  3. third_party/lvgl/src/draw
  4. third_party/lvgl/src/extra
  5. third_party/lvgl/src/font
  6. third_party/lvgl/src/gpu
  7. third_party/lvgl/src/hal
  8. third_party/lvgl/src/misc
  9. third_party/lvgl/src/widgets
  1. 添加LVGL相关的.c文件到相应分组,如下:

image.png

  1. 添加头文件路径

image.png

  1. 开启C99模式

    3. 移植显示

  2. 把lv_port_disp_template.c/h的条件编译指令#if 0修改成#if 1

  3. lv_port_disp_template.h中包含输出设备驱动头文件lcd.h

  4. lv_port_disp_template.h中宏定义水平和竖直分辨率(默认横屏)

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

  5. 修改 lv_port_disp_template.c中 的 lv_port_disp_init 函数

配置图形数据缓冲模式
在lv_port_disp_init函数中选择一种缓冲模式,注释掉其它两种模式
image.png
修改宽高

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

image.png

  1. 在disp_flush函数中配置打点输出
    1. static void disp_flush(lv_disp_drv_t * disp_drv, const lv_area_t * area, lv_color_t * color_p)
    2. {
    3.  ST7789_Fill(area->x1,area->y1,area->x2,area->y2,(uint16_t*)color_p);
    4.  /*IMPORTANT!!!
    5.   *Inform the graphics library that you are ready with the flushing*/
    6.  lv_disp_flush_ready(disp_drv);
    7. }

4. 移植触摸

  1. 把lv_port_indev_tempalte.c/h的条件编译#if 0修改成# if 1
  2. 在lv_port_indev_tempalte.c中裁剪输入设备
  • 只保留touchpad_xxx相关的方法,删除其它方法
  • lv_port_indev_init中只保留touchpad相关的代码
  • 在touchpad_init方法中执行触摸屏初始化CST816T_Init();
    1. /*Initialize your touchpad*/
    2. static void touchpad_init(void)
    3. {
    4.   GT1151_Init();              //触摸屏初始化
    5. }

  1. 配置触摸检测函数

    1. /*Return true is the touchpad is pressed*/
    2. static bool touchpad_is_pressed(void)
    3. {
    4.  /*Your code comes here*/
    5.      return CST816T_is_pressed();
    6.  // return false;
    7. }

  2. 配置坐标获取函数

    1. /*Get the x and y coordinates if the touchpad is pressed*/
    2. static void touchpad_get_xy(lv_coord_t * x, lv_coord_t * y)
    3. {
    4.  /*Your code comes here*/
    5.      CST816T_get_xy((uint16_t*)x,(uint16_t*)y);
    6.  //(*x) = 0;
    7.  //(*y) = 0;
    8. }

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

  1. /**
  2.  * @file lv_port_indev_templ.c
  3.  *
  4.  */
  6. /*Copy this file as "lv_port_indev.c" and set this value to "1" to enable content*/
  7. #if 1
  9. /*********************
  10.  *      INCLUDES
  11.  *********************/
  12. #include "lv_port_indev_template.h"
  13. //#include "../../lvgl.h"
  14. #include "cst816t.h"
  16. /*********************
  17.  *      DEFINES
  18.  *********************/
  20. /**********************
  21.  *      TYPEDEFS
  22.  **********************/
  24. /**********************
  25.  *  STATIC PROTOTYPES
  26.  **********************/
  28. static void touchpad_init(void);
  29. static void touchpad_read(lv_indev_drv_t * indev_drv, lv_indev_data_t * data);
  30. static bool touchpad_is_pressed(void);
  31. static void touchpad_get_xy(lv_coord_t * x, lv_coord_t * y);
  33. static void mouse_init(void);
  34. static void mouse_read(lv_indev_drv_t * indev_drv, lv_indev_data_t * data);
  35. static bool mouse_is_pressed(void);
  36. static void mouse_get_xy(lv_coord_t * x, lv_coord_t * y);
  38. static void keypad_init(void);
  39. static void keypad_read(lv_indev_drv_t * indev_drv, lv_indev_data_t * data);
  40. static uint32_t keypad_get_key(void);
  42. static void encoder_init(void);
  43. static void encoder_read(lv_indev_drv_t * indev_drv, lv_indev_data_t * data);
  44. static void encoder_handler(void);
  46. static void button_init(void);
  47. static void button_read(lv_indev_drv_t * indev_drv, lv_indev_data_t * data);
  48. static int8_t button_get_pressed_id(void);
  49. static bool button_is_pressed(uint8_t id);
  51. /**********************
  52.  *  STATIC VARIABLES
  53.  **********************/
  54. lv_indev_t * indev_touchpad;
  55. lv_indev_t * indev_mouse;
  56. lv_indev_t * indev_keypad;
  57. lv_indev_t * indev_encoder;
  58. lv_indev_t * indev_button;
  60. static int32_t encoder_diff;
  61. static lv_indev_state_t encoder_state;
  63. /**********************
  64.  *      MACROS
  65.  **********************/
  67. /**********************
  68.  *   GLOBAL FUNCTIONS
  69.  **********************/
  71. void lv_port_indev_init(void)
  72. {
  73.     /**
  74.      * Here you will find example implementation of input devices supported by LittelvGL:
  75.      *  - Touchpad
  76.      *  - Mouse (with cursor support)
  77.      *  - Keypad (supports GUI usage only with key)
  78.      *  - Encoder (supports GUI usage only with: left, right, push)
  79.      *  - Button (external buttons to press points on the screen)
  80.      *
  81.      *  The `..._read()` function are only examples.
  82.      *  You should shape them according to your hardware
  83.      */
  85.     static lv_indev_drv_t indev_drv;
  87.     /*------------------
  88.      * Touchpad
  89.      * -----------------*/
  91.     /*Initialize your touchpad if you have*/
  92.     touchpad_init();
  94.     /*Register a touchpad input device*/
  95.     lv_indev_drv_init(&indev_drv);
  96.     indev_drv.type = LV_INDEV_TYPE_POINTER;
  97.     indev_drv.read_cb = touchpad_read;
  98.     indev_touchpad = lv_indev_drv_register(&indev_drv);
  101. }
  103. /**********************
  104.  *   STATIC FUNCTIONS
  105.  **********************/
  107. /*------------------
  108.  * Touchpad
  109.  * -----------------*/
  111. /*Initialize your touchpad*/
  112. static void touchpad_init(void)
  113. {
  114.     /*Your code comes here*/
  115.     CST816T_Init();
  116. }
  118. /*Will be called by the library to read the touchpad*/
  119. static void touchpad_read(lv_indev_drv_t * indev_drv, lv_indev_data_t * data)
  120. {
  121.     static lv_coord_t last_x = 0;
  122.     static lv_coord_t last_y = 0;
  124.     /*Save the pressed coordinates and the state*/
  125.     if(touchpad_is_pressed()) {
  126.         touchpad_get_xy(&last_x, &last_y);
  127.         data->state = LV_INDEV_STATE_PR;
  128.     }
  129.     else {
  130.         data->state = LV_INDEV_STATE_REL;
  131.     }
  133.     /*Set the last pressed coordinates*/
  134.     data->point.x = last_x;
  135.     data->point.y = last_y;
  136. }
  138. /*Return true is the touchpad is pressed*/
  139. static bool touchpad_is_pressed(void)
  140. {
  141.     /*Your code comes here*/
  142.         return CST816T_is_pressed();
  143.     // return false;
  144. }
  146. /*Get the x and y coordinates if the touchpad is pressed*/
  147. static void touchpad_get_xy(lv_coord_t * x, lv_coord_t * y)
  148. {
  149.     /*Your code comes here*/
  150.         CST816T_get_xy((uint16_t*)x,(uint16_t*)y);
  151.     //(*x) = 0;
  152.     //(*y) = 0;
  153. }
  156. #else /*Enable this file at the top*/
  158. /*This dummy typedef exists purely to silence -Wpedantic.*/
  159. typedef int keep_pedantic_happy;
  160. #endif

6.添加测试案例

测试音乐界面

  1. keil添加lvgl/demos/music文件夹下所有.c文件

  2. 添加相关头文件路径

    1. ..\..\third_party\lvgl\demos
    2. ..\..\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

  1. #define LV_USE_DEMO_MUSIC       0
  2. 改为
  3. #define LV_USE_DEMO_MUSIC       1
  5. #define LV_FONT_MONTSERRAT_12 0
  6. 改为
  7. #define LV_FONT_MONTSERRAT_12 1
  9. #define LV_FONT_MONTSERRAT_16 0
  10. 改为
  11. #define LV_FONT_MONTSERRAT_16 1

7.main.c主函数

  1. #include "gd32f4xx.h"
  2. #include "systick.h"
  3. #include <stdio.h>
  4. #include "main.h"
  5. #include "bsp_basic_timer.h"
  7. #include "lcd.h"
  8. #include "touch.h"
  10. #include "lvgl.h"
  12. #include "lv_demo_music.h"
  13. #include "lv_conf.h"
  14. #include "lv_port_disp_template.h"
  15. #include "lv_port_indev_template.h"
  17. int main(void)
  18. {
  19.     nvic_priority_group_set(NVIC_PRIGROUP_PRE2_SUB2);  // 优先级分组
  20.     systick_config();    
  22.     lv_init();
  23.     lv_port_disp_init();
  24.     lv_port_indev_init();    
  26.     lv_demo_music();
  27.     while(1)
  28.     {
  29.         lv_tick_inc(1);
  30.         lv_timer_handler();
  31.         delay_1ms(5);
  32.     }
  33. }

8.提高堆栈内存大小

修改startup_gd32f450_470.s中的Stack_Size

  1. 原始:
  2. Stack_Size      EQU     0x00000400
  3. 修改后:
  4. Stack_Size      EQU     0x00000800

9. 提供时钟

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

  1. #ifndef _BSP_BASIC_TIMER_H
  2. #define _BSP_BASIC_TIMER_H
  4. #include "gd32f4xx.h"
  5. #include "systick.h"
  6. #include "stdio.h"
  7. #include "lvgl.h"
  9. #define BSP_TIMER_RCU                  RCU_TIMER5            // 定时器时钟
  10. #define BSP_TIMER                      TIMER5                // 定时器
  11. #define BSP_TIMER_IRQ                  TIMER5_DAC_IRQn       // 定时器中断
  12. #define BSP_TIMER_IRQHANDLER  TIMER5_DAC_IRQHandler // 定时器中断服务函数
  15. //#define BSP_TIMER_RCU                  RCU_TIMER2                    // 定时器时钟
  16. //#define BSP_TIMER                      TIMER2                            // 定时器
  17. //#define BSP_TIMER_IRQ                TIMER2_IRQn                    // 定时器中断
  18. //#define BSP_TIMER_IRQHANDLER  TIMER2_IRQHandler        // 定时器中断服务函数
  21. void basic_timer_config(uint16_t pre,uint16_t per); // 基本定时器配置
  23. #endif  /* BSP_BASIC_TIMER_H */

bsp_basic_timer.c

  2. #include "bsp_basic_timer.h"
  3. //#include "bsp_led.h"
  5. /************************************************
  6. 函数名称 ： basic_timer_config
  7. 功    能 ： 基本定时器配置
  8. 参    数 ： pre：时钟预分频值
  9.                       per：周期 
  10. *************************************************/
  11. void basic_timer_config(uint16_t pre,uint16_t per)
  12. {
  13.     /* 一个周期的时间T = 1/f, 定时时间time = T * 周期
  14.     设预分频值位pre,周期位per
  15.     time = (pre + 1) * (per + 1) / psc_clk
  16.     */
  17.     timer_parameter_struct timere_initpara;                             // 定义定时器结构体
  18.     /* 开启时钟 */
  19.     rcu_periph_clock_enable(BSP_TIMER_RCU);                             // 开启定时器时钟
  20.     /* CK_TIMERx = 4 x CK_APB1  = 4x50M = 200MHZ */
  21.     rcu_timer_clock_prescaler_config(RCU_TIMER_PSC_MUL4); // 配置定时器时钟
  24.     timer_deinit(BSP_TIMER);                                                          // 复位定时器
  25.     /* 配置定时器参数 */
  26.     timere_initpara.prescaler = pre-1;                    //  时钟预分频值 0-65535   psc_clk = CK_TIMER / pre
  27.     timere_initpara.alignedmode = TIMER_COUNTER_EDGE;     // 边缘对齐                  
  28.     timere_initpara.counterdirection = TIMER_COUNTER_UP;  // 向上计数    
  29.     timere_initpara.period = per-1;                       // 周期  
  30.     /* 在输入捕获的时候使用  数字滤波器使用的采样频率之间的分频比例 */
  31.     timere_initpara.clockdivision = TIMER_CKDIV_DIV1;     // 分频因子         
  32.     /* 只有高级定时器才有 配置为x，就重复x+1次进入中断 */    
  33.     timere_initpara.repetitioncounter = 0;                              // 重复计数器 0-255  
  35.     timer_init(BSP_TIMER,&timere_initpara);                                // 初始化定时器
  37.     /* 配置中断优先级 */
  38.     nvic_irq_enable(BSP_TIMER_IRQ,3,2);                                     // 设置中断优先级为 3,2
  39.     /* 使能中断 */
  40.     timer_interrupt_enable(BSP_TIMER,TIMER_INT_UP);       // 使能更新事件中断 
  41.     /* 使能定时器 */
  42.     timer_enable(BSP_TIMER);
  43. }
  45. /************************************************
  46. 函数名称 ： BSP_TIMER_IRQHandler
  47. 功    能 ： 基本定时器中断服务函数 
  48. 参    数 ： 无
  49. 返 回 值 ： 无
  50. 作    者 ： LC
  51. *************************************************/
  52. void BSP_TIMER_IRQHANDLER(void)
  53. {
  54.     /* 这里是定时器中断 */
  55.     if(timer_interrupt_flag_get(BSP_TIMER,TIMER_INT_FLAG_UP) == SET)
  56.     {
  57.         timer_interrupt_flag_clear(BSP_TIMER,TIMER_INT_FLAG_UP);  // 清除中断标志位 
  58.         /* 执行功能 */
  59.         lv_tick_inc(1);
  60.     }
  61. }

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

错误处理

错误一

.\Objects\GD32F450.axf: Error: L6218E: Undefined symbol __aeabi_assert (referred from qrcodegen.o).
解决方案:
设置如下即可
350.png