网上介绍 LVGL 移植的文章非常多,也非常实用。这里介绍了一个新的移植思路,并且也跑通了源码里自带的 benchmark 示例。对于 LVGL ,本文也不多做赘述,直奔移植话题。
先介绍一下移植的硬件:
- 开发板:APM32F427Z-TINY(APM32F407IG-TINY 也可以,通用的方法)
- 显示屏:基于 ST7789 控制器的2.4寸 TFT-LCD,分辨率 240×320,SPI 接口。
常见的移植方案
先简要介绍网上介绍得比较多的方法,是参考源码中的 lv_port_disp_template.c 这个文件,关键内容是:
void lv_port_disp_init(void)
{
/*-------------------------
* Initialize your display
* -----------------------*/
disp_init();
/*------------------------------------
* Create a display and set a flush_cb
* -----------------------------------*/
lv_display_t * disp = lv_display_create(MY_DISP_HOR_RES, MY_DISP_VER_RES);
lv_display_set_flush_cb(disp, disp_flush);
// ...
}
需要实现 disp_flush 这个回调函数。这个函数一般是这样写的:
void disp_flush(lv_display_t *disp_drv, const lv_area_t *area, uint8_t *px_map)
{
if (disp_flush_enabled)
{
int32_t x, y;
unsigned short *p = (unsigned short *)px_map;
for (y = area->y1; y <= area->y2; y++)
{
for (x = area->x1; x <= area->x2; x++)
{
put_px(x, y, *p++);
}
}
}
lv_display_flush_ready(disp_drv);
}
新的移植方法
从某个版本开始,lvgl 就内置了一些常见的控制器驱动,可以浏览 lvgl\src\drivers\display 目录:
├─drm
├─fb
├─ft81x
├─ili9341
├─lcd
├─lovyan_gfx
├─nv3007
├─nxp_elcdif
├─renesas_glcdc
├─st7735
├─st7789
├─st7796
├─st_ltdc
└─tft_espi
这里就用我的移植对象 st7789。遗憾的是,这个内置的驱动并不能在我的硬件上运行但这里提供了新的移植思路。
lvgl\src\drivers\display\st7789\lv_st7789.c 这个文件重点部分:
/* init commands based on LovyanGFX ST7789 driver */
static const uint8_t init_cmd_list[] = {
CMD_GCTRL, 1, 0x44, /* GCTRL -- panel dependent */
CMD_VCOMS, 1, 0x24, /* VCOMS -- panel dependent */
CMD_VRHS, 1, 0x13, /* VRHS - panel dependent */
CMD_PWCTRL1, 2, 0xa4, 0xa1,
CMD_RAMCTRL, 2, 0x00, 0xC0, /* controls mapping of RGB565 to RGB666 */
CMD_PVGAMCTRL, 14, 0xd0, 0x00, 0x02, 0x07, 0x0a, 0x28, 0x32, 0x44, 0x42, 0x06, 0x0e, 0x12, 0x14, 0x17,
CMD_NVGAMCTRL, 14, 0xd0, 0x00, 0x02, 0x07, 0x0a, 0x28, 0x31, 0x54, 0x47, 0x0e, 0x1c, 0x17, 0x1b, 0x1e,
LV_LCD_CMD_SET_GAMMA_CURVE, 1, 0x01,
LV_LCD_CMD_DELAY_MS, LV_LCD_CMD_EOF
};
// ...
lv_display_t * lv_st7789_create(uint32_t hor_res,
uint32_t ver_res,
lv_lcd_flag_t flags,
lv_st7789_send_cmd_cb_t send_cmd_cb,
lv_st7789_send_color_cb_t send_color_cb)
{
lv_display_t * disp = lv_lcd_generic_mipi_create(hor_res,
ver_res,
flags,
send_cmd_cb,
send_color_cb);
lv_lcd_generic_mipi_send_cmd_list(disp, init_cmd_list);
return disp;
}
从文件内容可以看出,这个文件定义了一系列的 st7789 的初始化命令,也就是 init_cmd_list 这个数组。对比我手里的硬件,初始化的参数确实有一些差异,也就导致直接使用这个驱动不能正常工作。
所以,移植的思路也就明确了:修改初始化参数。为了不“污染”源码,把 lv_st7789.c 内容复制出来使用,修改初始化参数以符合我的硬件,当然也包含其他必须的硬件操作:
#include "lvgl_porting.h"
#define BUFF_SIZE (LCD_H_RES * LCD_BUF_LINES * 2)
// ST7789 初始化命令序列
static const uint8_t init_cmd_list[] = {
0x3A, 1, 0x05, //
0x36, 1, 0x00, //
0xB2, 5, 0x0C, 0x0C, 0x00, 0x33, 0x33, //
0xB7, 1, 0x35, //
0xBB, 1, 0x28, //
0xC0, 1, 0x2C, //
0xC2, 1, 0x01, //
0xC3, 1, 0x0B, //
0xC4, 1, 0x20, //
0xC6, 1, 0x0F, //
0xD0, 2, 0xA4, 0xA1, //
0xE9, 3, 0x09, 0x09, 0x08, //
0xE0, 14, 0xD0, 0x01, 0x08, 0x0F, 0x11, 0x2A, 0x36, 0x55, 0x44, 0x3A, 0x0B, 0x06, 0x11, 0x20, //
0xE1, 14, 0xD0, 0x02, 0x07, 0x0A, 0x0B, 0x18, 0x34, 0x43, 0x4A, 0x2B, 0x1B, 0x1C, 0x22, 0x1F, //
LV_LCD_CMD_DELAY_MS, LV_LCD_CMD_EOF
};
static uint8_t buf[BUFF_SIZE] __attribute__((aligned(4)));
static lv_display_t *disp_ = NULL;
void my_lcd_send_cmd(lv_display_t *disp, const uint8_t *cmd,
size_t cmd_size, const uint8_t *param, size_t param_size)
{
(void)disp;
if (cmd_size) {
gpio_set(LCD_DC, CD_CMD_LEVEL);
spi_write(cmd, cmd_size);
}
if (param_size) {
gpio_set(LCD_DC, CD_DAT_LEVEL);
spi_write(param, param_size);
}
}
//
void my_lcd_send_color(lv_display_t *disp, const uint8_t *cmd,
size_t cmd_size, uint8_t *param, size_t param_size)
{
if (cmd_size) {
gpio_set(LCD_DC, CD_CMD_LEVEL);
spi_write(cmd, cmd_size);
}
if (param_size) {
gpio_set(LCD_DC, CD_DAT_LEVEL);
spi_write(param, param_size);
}
lv_display_flush_ready(disp);
}
//
void lv_port_disp_init(void)
{
gpio_set(LCD_RST, 0);
ms_delay(20);
gpio_set(LCD_RST, 1);
disp_ = lv_lcd_generic_mipi_create(LCD_H_RES, LCD_V_RES,
LV_LCD_FLAG_NONE,
my_lcd_send_cmd, my_lcd_send_color);
lv_lcd_generic_mipi_send_cmd_list(disp_, init_cmd_list);
lv_display_set_buffers(disp_, buf, NULL,
BUFF_SIZE, LV_DISPLAY_RENDER_MODE_PARTIAL);
gpio_set(LCD_BL, 1);
}
恭喜,移植关键就完成了~
其他移植部分,也就是时钟相关的内容,与常规的移植一样,示例的主程序是这样:
extern bool lv_demos_create(char * info[], int size);
static const char *demo_name[] = {"benchmark"};
static volatile uint32_t _systick = 0;
void ms_delay(uint32_t ms)
{
volatile uint32_t target = _systick + ms + 1;
while (_systick != target) {
;
}
}
uint32_t get_millisec(void)
{
return _systick;
}
void SysTick_Handler(void)
{
_systick++;
}
int main()
{
SystemCoreClockUpdate();
if (SysTick_Config(SystemCoreClock / 1000)) {
while (1) {
;
}
}
board_init();
printf("\n\nHello world!\n:: %s\n", demo_name[0]);
lv_init();
lv_tick_set_cb(get_millisec);
lv_port_disp_init();
if (!lv_demos_create((char **)&demo_name[0], 1)) {
while(1) {
ms_delay(200);
printf("Fail to create demo\n\n");
}
}
while (1) {
lv_timer_handler();
ms_delay(5);
}
return 0;
}
示例演示


总结
本文介绍的移植方法是基于源码自带的驱动修改而来,只需要修改控制器的初始化参数,而不需要编写发送命令,发送数据,画点等函数,大大简化了移植的过程。
另外的一个优点:很多 SPI 接口的控制器,都能通过修改初始化参数直接驱动起来~~~ 我知道的有:
- ILI9341
- NV3007
- ST7735
- ST7789
- ST7796
- GC9A01
是不是直接爽歪歪?