[APM32F4] 在 APM32F427 上移植 LVGL 的新方法

LVGL 是一个优秀的嵌入式图形库，在网上也有很多移植资料，特别是百问网（https://lvgl.100ask.net/master/intro/introduction.html）的翻译文档是非常好的中文资料。本次介绍一种新的、高效的移植方法。

1、常见移植方案简介
常见的移植方法是基于官方的介绍，最少需要6个步骤就可以实现：

移植关键是第4步：Display Interface，其中核心是实现 Flush Callbackh函数：在指定的区域显示位图：

上图是个说明是最简单、最直接的实现方式。也非常容易从现有驱动实现 LVGL 的移植，因为现成的驱动里肯定具备“画点”的函数。

2、一个新的移植思路
不知道从哪个版本开始，LVGL 源码就提供了 st7789 等几个常见显示驱动芯片的驱动程序。我尝试在自己的硬件上运行，但是非常遗憾，不能运行。在阅读这部分驱动程序的过程中，我发现了一个新的移植方法。
先贴一下源码中关于 st7789 的驱动的文件 lvgl\src\drivers\display\st7789\lv_st7789.c 的主要部分：

从源码可以看到 lv_st7789_creat这个函数是关键，内容就3行：

• 创建一个 lcd_generic_mipi 类型的 display；
• 发送一系列命令；
• 返回第一步创建的 display。

仔细观察init_cmd_list可以发现它是一些用于初始化 st7789 的参数。对比我手上的屏幕，这些参数不合适，所以显示屏不能正常显示

。

基于此，一个移植 LVGL 的新方法就出现了。

为了不影响源码树，把lv_st7789.c/.h 复制到项目目录，修改文件名。然后修改其中init_cmd_list里的参数，使之符合我们拥有的硬件参数。

当然，第一部分关键的6步骤里其他内容还是需要的。可以参考代码仓库的 main.c 文件，运行官方的 benchmark 示例：

看看实际运行的情况：

可以看到，APM32F427 的性能还是不错的。除了最后一个缩放文字示例的帧率只有 14FPS，其他的示例帧率都在 20FPS 以上~

这还是没有开启优化的情况下，优化空间不少。

这种新的移植方法，借鉴了官方实现的 driver 程序，只需要修改初始化参数就可以移植到新的显示控制器。对于遵循 mipi接口的显示驱动可移植性非常不错。

我所知道的可以采用此移植方法的控制器类型有：

• ili9341
• nv3007
• st7735
• st7789
• st7796
• gc9a01

都是常见的显示控制器。

3、结语
APM32F427 这颗 MCU 的主频能上到 240MHz、Flash、SRAM 容量也都非常大，编译 LVGL 官方的示例毫无压力，推荐使用~

可以从Gitee 的代码仓库获取基于 APM32F427 开发板的工程代码：https://gitee.com/quincyzh/lvgl-demo

工程使用 keil 开发，除了 APM32F4xx 的package 外，还需要LVGL::lvgl, 版本9.4.0 (2025-10-16)：

最后吐槽一下APM32F427Z-Tiny 开发板的Arduino 接口：
第一居然用的是排针而不是排母；
第二用排针也就罢了，我自己换成排母也不需要太多功夫，可是板载的接口与标准 Arduino 接口不一样？！！
导致我的Arduino 接口的显示模块只能用杜邦线使用！也就是上面图片中的样子

极海的硬件工程师，赶紧改版吧~~~

---------------------
作者：wangqy_ic
链接：https://bbs.21ic.com/icview-3501013-1-1.html
来源：21ic.com
此文章已获得原创/原创奖标签，著作权归21ic所有，任何人未经允许禁止转载。