移植准备和环境分析
1.1 项目结构分析
在开始移植之前，我们需要先了解现有项目的结构。基于STM32F4的LCD项目具有典型的嵌入式分层架构：
应用层 (app/main.c)
↓
GUI层 (bsp/GUI.c, bsp/test.c)
↓
硬件驱动层 (bsp/LCD, TOUCH, SPI, UART)
↓
MCU外设库 (STM32F4xx StdPeriph Driver)
↓
CMSIS底层接口 (core_cm4.h, system_stm32f4xx.c)
项目目录结构：
d:\LCD\
├── app\ # 应用程序入口
├── board\ # 板级初始化
├── bsp\ # 板级支持包
│ ├── LCD\ # LCD驱动
│ ├── TOUCH\ # 触摸屏驱动
│ ├── SPI\ # SPI通信
│ ├── uart\ # 串口通信
│ ├── GUI.c/.h # 图形用户界面封装
│ ├── lvgl_drv.c/.h # LVGL驱动接口
│ └── touch_lvgl.c/.h # LVGL触摸接口
├── libraries\ # 第三方库
│ ├── CMSIS\ # ARM核心接口
│ └── STM32F4xx_StdPeriph_Driver\ # ST外设库
├── lvgl\ # LVGL源码目录（待添加）
├── module\ # MCU配置和中断处理
└── project\MDK(V5)\ # Keil项目文件
1.2 LVGL版本选择
在本项目中，我们选择LVGL v8.x版本进行移植，该版本具有以下优势：
更好的性能优化
更丰富的控件支持
更灵活的配置选项
更好的内存管理
1.3 硬件资源评估
STM32F4系列MCU资源：
Flash: 512KB-1MB
SRAM: 128KB-192KB
主频: 168MHz
外设: SPI, USART, GPIO等
LCD屏幕参数：
分辨率: 320x240
颜色深度: 16位
接口: SPI或并行接口
实际遇到的问题和解决过程
2.1 初始编译错误分析
在初次尝试编译集成LVGL的项目时，我们遇到了大量的链接错误，错误数量高达87个，主要表现为"Undefined symbol"错误。典型的错误信息如下：
Build started: Project: Project
*** Using Compiler 'V5.06 update 7 (build 960)', folder: 'd:\Keil_v5\ARM\ARMCC\Bin'
Build target 'Project'
linking...
.\Objects\Project.axf: Error: L6218E: Undefined symbol _lv_disp_ll (referred from lv_obj_1.o).
.\Objects\Project.axf: Error: L6218E: Undefined symbol lv_anim_core_init (referred from lv_anim.o).
.\Objects\Project.axf: Error: L6218E: Undefined symbol lv_area_increase (referred from lv_obj.o).
...
2.2 问题定位方法
面对大量的链接错误，我们采用了以下方法进行问题定位：
错误分类：将错误信息按功能模块分类，如显示、动画、内存管理等
依赖分析：分析错误符号之间的依赖关系
源码检查：检查LVGL源码目录结构，确认必要的源文件是否已添加
2.3 逐步解决过程
第一步：添加核心文件
首先，我们添加了LVGL核心功能所需的文件：
src/core/lv_obj.c
src/core/lv_group.c
src/core/lv_indev.c
等等
添加后，错误数量从87个减少到72个。
第二步：添加绘图相关文件
接着，我们添加了绘图模块的文件：
src/draw/lv_draw.c
src/draw/lv_draw_rect.c
src/draw/lv_draw_label.c
src/draw/sw/目录下所有文件
错误数量进一步减少到56个。
第三步：添加杂项功能文件
然后，我们添加了杂项功能文件：
src/misc/lv_timer.c
src/misc/lv_mem.c
src/misc/lv_ll.c
src/misc/lv_gc.c
错误数量减少到48个。
第四步：添加额外组件文件
继续添加额外组件文件：
src/extra/目录下所有文件
src/extra/themes/目录下所有文件
src/extra/layouts/目录下所有文件
错误数量减少到46个。
第五步：解决剩余问题
最后，我们发现还缺少一些关键文件：
src/draw/lv_draw_triangle.c和lv_draw_triangle.h（提供lv_draw_polygon函数）
src/misc/lv_style_gen.c（提供样式设置函数）
添加这些文件后，最终解决了所有链接错误。
文件缺失诊断和查找方法
3.1 链接错误信息解读
链接错误信息通常包含以下关键信息：
错误符号名称：如lv_draw_polygon
引用位置：如referred from lv_canvas.o
错误类型：如Undefined symbol
通过这些信息，我们可以确定：
缺失的是哪个函数或变量
哪个模块在使用这个函数或变量
需要在哪个目录中查找对应的源文件
3.2 源文件定位技巧
方法一：使用grep搜索
在LVGL源码目录中使用grep命令搜索函数名：
grep -r "lv_draw_polygon" lvgl/
方法二：使用IDE搜索功能
在Keil或其他IDE中使用全局搜索功能查找函数声明和定义。
方法三：分析头文件包含关系
查看报错模块包含的头文件，根据头文件找到对应的源文件。
3.3 依赖关系分析
在添加文件时，需要注意以下依赖关系：
核心依赖
lv_obj.c ← 依赖 lv_obj_class.c, lv_obj_style.c, lv_event.c
lv_group.c ← 依赖 lv_ll.c
绘图依赖
lv_draw_polygon ← 在 lv_draw_triangle.c 中定义
lv_draw_rect ← 依赖 lv_draw_sw_rect.c (软件实现)
内存管理依赖
lv_mem.c ← 依赖 lv_tlsf.c, lv_gc.c
样式系统依赖
lv_style_set_* ← 在 lv_style_gen.c 中生成
文件添加详细步骤
4.1 Keil项目分组管理
按照LVGL的目录结构，我们在Keil项目中创建了以下分组：
LVGL_CORE组
包含主头文件：
lvgl.h
LVGL_SRC_CORE组
包含核心功能文件：
lv_obj.c
lv_group.c
lv_indev.c
lv_indev_scroll.c
lv_disp.c
lv_refr.c
lv_event.c
lv_obj_class.c
lv_obj_draw.c
lv_obj_pos.c
lv_obj_scroll.c
lv_obj_style.c
lv_obj_style_gen.c
lv_obj_tree.c
lv_theme.c
LVGL_SRC_DRAW组
包含绘图相关文件：
lv_draw.c
lv_draw_rect.c
lv_draw_label.c
lv_draw_img.c
lv_draw_line.c
lv_draw_arc.c
lv_draw_mask.c
lv_img_buf.c
lv_img_cache.c
lv_img_decoder.c
lv_draw_layer.c
lv_draw_transform.c
lv_draw_triangle.c
lv_draw_triangle.h
软件绘图实现文件：
lv_draw_sw.c
lv_draw_sw_blend.c
lv_draw_sw_rect.c
lv_draw_sw_letter.c
lv_draw_sw_img.c
lv_draw_sw_line.c
lv_draw_sw_arc.c
lv_draw_sw_polygon.c
lv_draw_sw_layer.c
lv_draw_sw_transform.c
lv_draw_sw_gradient.c
LVGL_SRC_EXTRA组
包含额外组件文件：
lv_extra.c
lv_theme_basic.c
lv_theme_default.c
lv_flex.c
lv_grid.c
LVGL_SRC_FONT组
包含字体文件：
lv_font.c
lv_font_fmt_txt.c
lv_font_loader.c
lv_font_montserrat_14.c
LVGL_SRC_HAL组
包含硬件抽象层文件：
lv_hal_disp.c
lv_hal_indev.c
lv_hal_tick.c
LVGL_SRC_MISC组
包含杂项功能文件：
lv_timer.c
lv_mem.c
lv_ll.c
lv_gc.c
lv_tlsf.c
lv_utils.c
lv_style_gen.c
LVGL_SRC_WIDGETS组
包含控件文件：
lv_arc.c
lv_bar.c
lv_btn.c
lv_checkbox.c
lv_dropdown.c
lv_img.c
lv_label.c
lv_line.c
lv_roller.c
lv_slider.c
lv_switch.c
lv_table.c
lv_textarea.c
4.2 源文件添加方法
手动添加步骤
在Keil项目窗口中右键点击对应的组
选择"Add Existing Files to Group"
浏览到LVGL源码目录选择相应文件
点击"Add"按钮添加文件
注意事项
确保每个文件只添加到一个组中，避免重复定义
头文件(.h)应设置为FileType 5
源文件(.c)应设置为FileType 1
4.3 包含路径配置
在Keil项目设置中，需要添加以下包含路径：
右键项目 → Options for Target
选择C/C++选项卡
在Include Paths中添加：
…\lvgl
…\lvgl\src
编译错误分析和解决方法
5.1 链接错误处理
类型1：Undefined symbol错误
这类错误表示链接器找不到函数或变量的定义。
解决方法：
根据错误信息确定缺失的符号名称
在LVGL源码中搜索该符号
将包含该符号定义的源文件添加到项目中
示例：
Error: L6218E: Undefined symbol lv_draw_polygon (referred from lv_canvas.o)
解决：添加lv_draw_triangle.c文件
类型2：Duplicate symbol错误
这类错误表示同一个符号被多次定义。
解决方法：
检查是否将同一文件添加到了多个组中
移除重复的文件引用
5.2 编译错误解决
问题1：头文件未找到
错误信息：
Error: Cannot open source file "lvgl.h"
解决方法：
检查包含路径配置是否正确
确认lvgl.h文件是否存在
问题2：函数声明不匹配
错误信息：
Error: Function "lv_init" declared implicitly
解决方法：
确保包含了正确的头文件
检查函数声明和定义是否一致
5.3 运行时问题排查
问题1：显示异常
可能原因：
LCD驱动未正确初始化
显示缓冲区配置错误
刷新机制未正确实现
解决方法：
检查LCD驱动实现
确认显示缓冲区大小和格式
验证lv_disp_flush_ready()是否正确调用
问题2：触摸无响应
可能原因：
触摸驱动未正确实现
输入设备注册错误
坐标转换问题
解决方法：
常见问题清单
通过遵循以上详细步骤和最佳实践，开发者可以顺利完成LVGL在STM32平台上的移植工作，并能够快速解决移植过程中遇到的各种问题。
————————————————
版权声明：本文为CSDN博主「推推推特」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/grantthing/article/details/152017429
|
-
|
