[MCU] 全志R128使用SPI驱动ST7789V1.47寸LCD

R128 平台提供了 SPI DBI 的 SPI TFT 接口，具有如下特点：

• Supports DBI Type C 3 Line/4 Line Interface Mode
• Supports 2 Data Lane Interface Mode
• Supports data source from CPU or DMA
• Supports RGB111/444/565/666/888 video format
• Maximum resolution of RGB666 240 x 320@30Hz with single data lane
• Maximum resolution of RGB888 240 x 320@60Hz or 320 x 480@30Hz with dual data lane
• Supports tearing effect
• Supports software flexible control video frame rate

同时，提供了 SPILCD 驱动框架以供 SPI 屏幕使用。

此次适配的SPI屏为 ZJY147S0800TG01，使用的是 SPI 进行驱动。

引脚配置如下：

载入方案

我们使用的开发板是 R128-Devkit，需要开发 C906 核心的应用程序，所以载入方案选择 r128s2_module_c906

设置 SPI 驱动

屏幕使用的是SPI驱动，所以需要勾选SPI驱动，运行 mrtos_menuconfig 进入配置页面。前往下列地址找到 SPI Devices

配置 SPI 引脚

打开你喜欢的编辑器，修改文件：board/r128s2/module/configs/sys_config.fex，在这里我们不需要用到 SPI HOLD与SPI WP引脚，注释掉即可。

EEWORLDLINKTK3

设置 PWM 驱动

屏幕背光使用的是PWM驱动，所以需要勾选PWM驱动，运行 mrtos_menuconfig 进入配置页面。前往下列地址找到 PWM Devices

EEWORLDLINKTK4

配置 PWM 引脚

打开你喜欢的编辑器，修改文件：board/r128s2/module/configs/sys_config.fex，增加 PWM1 节点

EEWORLDLINKTK5

设置 SPI LCD 驱动

SPI LCD 由专门的驱动管理。运行 mrtos_menuconfig 进入配置页面。前往下列地址找到 SPILCD Devices ，注意同时勾选 spilcd hal APIs test 方便测试使用。

EEWORLDLINKTK6

整理后的初始化代码如下：

LCD_WR_REG(0x11);
delay_ms(120);
LCD_WR_REG(0x36);
LCD_WR_DATA8(0x00);

LCD_WR_REG(0x3A);
LCD_WR_DATA8(0x05);

LCD_WR_REG(0xB2);
LCD_WR_DATA8(0x0C);
LCD_WR_DATA8(0x0C);
LCD_WR_DATA8(0x00);
LCD_WR_DATA8(0x33);
LCD_WR_DATA8(0x33);

LCD_WR_REG(0xB7);
LCD_WR_DATA8(0x35);

LCD_WR_REG(0xBB);
LCD_WR_DATA8(0x35);

LCD_WR_REG(0xC0);
LCD_WR_DATA8(0x2C);

LCD_WR_REG(0xC2);
LCD_WR_DATA8(0x01);

LCD_WR_REG(0xC3);
LCD_WR_DATA8(0x13);

LCD_WR_REG(0xC4);
LCD_WR_DATA8(0x20);

LCD_WR_REG(0xC6);
LCD_WR_DATA8(0x0F);

LCD_WR_REG(0xD0);
LCD_WR_DATA8(0xA4);
LCD_WR_DATA8(0xA1);

LCD_WR_REG(0xD6);
LCD_WR_DATA8(0xA1);

LCD_WR_REG(0xE0);
LCD_WR_DATA8(0xF0);
LCD_WR_DATA8(0x00);
LCD_WR_DATA8(0x04);
LCD_WR_DATA8(0x04);
LCD_WR_DATA8(0x04);
LCD_WR_DATA8(0x05);
LCD_WR_DATA8(0x29);
LCD_WR_DATA8(0x33);
LCD_WR_DATA8(0x3E);
LCD_WR_DATA8(0x38);
LCD_WR_DATA8(0x12);
LCD_WR_DATA8(0x12);
LCD_WR_DATA8(0x28);
LCD_WR_DATA8(0x30);

LCD_WR_REG(0xE1);
LCD_WR_DATA8(0xF0);
LCD_WR_DATA8(0x07);
LCD_WR_DATA8(0x0A);
LCD_WR_DATA8(0x0D);
LCD_WR_DATA8(0x0B);
LCD_WR_DATA8(0x07);
LCD_WR_DATA8(0x28);
LCD_WR_DATA8(0x33);
LCD_WR_DATA8(0x3E);
LCD_WR_DATA8(0x36);
LCD_WR_DATA8(0x14);
LCD_WR_DATA8(0x14);
LCD_WR_DATA8(0x29);
LCD_WR_DATA8(0x32);

LCD_WR_REG(0x21);

LCD_WR_REG(0x11);
delay_ms(120);
LCD_WR_REG(0x29);

用现成驱动改写 SPI LCD 驱动

选择一个现成的 SPI LCD 改写即可，这里选择 nv3029s.c 驱动来修改

EEWORLDLINKTK7

#ifndef _ST7789V_H
#define _ST7789V_H

#include "panels.h"

struct __lcd_panel st7789v_panel;

#endif /*End of file*/

编辑 st7789v.c 将 nv3029s 改成 st7789v

EEWORLDLINKTK8

做如下修改

static void address(unsigned int sel, int x, int y, int width, int height)
{
    sunxi_lcd_cmd_write(sel, 0x2A); /* Set coloum address */
    sunxi_lcd_para_write(sel, (x + 34) >> 8);
    sunxi_lcd_para_write(sel, (x + 34));
    sunxi_lcd_para_write(sel, (width + 34) >> 8);
    sunxi_lcd_para_write(sel, (width + 34));
    sunxi_lcd_cmd_write(sel, 0x2B); /* Set row address */
    sunxi_lcd_para_write(sel, y >> 8);
    sunxi_lcd_para_write(sel, y);
    sunxi_lcd_para_write(sel, height >> 8);
    sunxi_lcd_para_write(sel, height);
    sunxi_lcd_cmd_write(sel, 0x2c);
}

完成驱动如下

对接驱动框架

完成了屏幕驱动的编写，接下来需要对接到 SPILCD 驱动框架。首先编辑 Kconfig

EEWORLDLINKTK9

config LCD_SUPPORT_ST7789V
    bool "LCD support st7789v panel"
    default n
    ---help---
        If you want to support st7789v panel for display driver, select it.

然后编辑 panels.c 在 panel_array 里增加 st7789 驱动的引用

EEWORLDLINKTK10

#ifdef CONFIG_LCD_SUPPORT_ST7789V
    &st7789v_panel,
#endif

之后编辑 panels.h 同样增加引用

EEWORLDLINKTK11

#ifdef CONFIG_LCD_SUPPORT_ST7789V
extern struct __lcd_panel st7789v_panel;
#endif

最后编辑外层的 Makefile 增加编译选项

EEWORLDLINKTK12

obj-${CONFIG_LCD_SUPPORT_ST7789V} += panels/st7789v.o

选择 ST7789V 驱动

在 SPILCD 驱动选择界面可以看到 LCD_FB panels select 选择 SPI 屏幕的驱动

进入 LCD_FB panels select 选项

EEWORLDLINKTK13

配置 SPI LCD 引脚

打开你喜欢的编辑器，修改文件：board/r128s2/module/configs/sys_config.fex

编译打包

运行命令 mp 编译打包，可以看到编译了 st7789v.o

测试

烧录启动之后，屏幕背光启动，但是屏幕全黑。

输入 test_spilcd ，屏幕显示黄色。

输入 lv_examples 1 可以显示 lvgl 界面

常见问题

LVGL 出现 DMA Over Size

这是由于 LVGL 配置的 LV_COLOR_DEPTH 为 32，但是 SPI 屏配置为16位。请修改 lv_conf.h

用SPI驱动ST7789V1.47寸LCD还是很给力的