701N屏幕驱动配置说明

📎 原始文档：https://www.kdocs.cn/l/curU6xjG1ejl

701N屏幕驱动配置说明文档

Zhuhai Jieli Technology Co.,LTD

修改记录

版本	更新日期	描述
1.0	2021 / 12 / 13	701N watch屏幕驱动配置使用手册
更新：		●建立初始版本

目录
一、整体介绍...................................................................................................... 4
（一）编写目的.........................................................................................................................................4
（二）规格.................................................................................................................................................4
二、 SPI屏接口时序...........................................................................................5
（一） 3-wire SPI时序以及配置............................................................................................................... 5
（二） 3-wire DSPI时序以及配置............................................................................................................6
（三） 4-wire SPI时序以及配置...............................................................................................................8
（四） 4-wire DSPI时序以及配置.......................................................................................................... 10
（五） QSPI时序以及配置......................................................................................................................11
三、屏幕驱动参数配置说明............................................................................ 15
（一）板级配置....................................................................................................................................... 15
（二）屏幕相关参数配置....................................................................................................................... 16
（三）屏幕接口注册............................................................................................................................... 18
四、屏幕驱动具体配置.................................................................................... 20
（一）配置相关说明...............................................................................................................................20
1． 4wire-spi ................................................................................................................................... 21
2． 4wire-dspi ................................................................................................................................. 23
3． 3wire-spi ................................................................................................................................... 24
4． 3wire-dspi ................................................................................................................................. 25
5． qspi ........................................................................................................................................... 26
五、客户常见问题反馈解答............................................................................28
Q1:3wire-SPI和4wire-SPI有什么区别？ ................................................................................................28

一、整体介绍

（一）编写目的

该文档主要描述701x_SDK开发包的屏幕驱动配置的使用说明及开发中注意的一些问题，为用户进行二次开发提供参考。

（二）规格

701x 系列芯片的硬件推屏模块可支持SPI屏( SPI/DSPI/QSPI)、8bit MCU 屏以及8bit RGB屏，颜色类型支持RGB565、RGB666 以及RGB888，最大可支持480x480分辨率。

二、SPI屏接口时序

（一）3-wire SPI 时序以及配置

(1) RGB565, 1P2T, 1T 8B
配置：
#define SPI_IF_MODE ( SPI_MODE| SPI_WIRE3)
#define OUT_FORMAT FORMAT_RGB565
#define PIXEL_TYPE (PIXEL_ 1P2T |PIXEL_ 1T 8B)
(2) RGB666, 1P3T, 1T 8B
配置：
#define SPI_IF_MODE ( SPI_MODE| SPI_WIRE3)
#define OUT_FORMAT FORMAT_RGB666
#define PIXEL_TYPE (PIXEL_ 1P3T |PIXEL_ 1T 8B)
(3) RGB565, 1T 16B
配置：
#define SPI_IF_MODE ( SPI_MODE| SPI_WIRE3)
#define OUT_FORMAT FORMAT_RGB565
#define PIXEL_TYPE (PIXEL_ 1P 1T |PIXEL_ 1T 16B)
(4) RGB666, 1T 18B
配置：
#define SPI_IF_MODE ( SPI_MODE| SPI_WIRE3)
#define OUT_FORMAT FORMAT_RGB666
#define PIXEL_TYPE (PIXEL_ 1P 1T |PIXEL_ 1T 18B)
(5) RGB888, 1T24B
配置：
#define SPI_IF_MODE ( SPI_MODE| SPI_WIRE3)
#define OUT_FORMAT FORMAT_RGB888
#define PIXEL_TYPE (PIXEL_ 1P 1T |PIXEL_ 1T24B)

（二）3-wire DSPI 时序以及配置

(1) RGB565， 1P 1T
配置：
#define SPI_IF_MODE (DSPI_MODE| SPI_WIRE3)
#define OUT_FORMAT FORMAT_RGB565
#define PIXEL_TYPE (PIXEL_ 1P 1T |PIXEL_ 1T 8B)
(2) RGB666， 1P 1T
配置：
#define SPI_IF_MODE (DSPI_MODE| SPI_WIRE3)
#define OUT_FORMAT FORMAT_RGB666
#define PIXEL_TYPE (PIXEL_ 1P 1T |PIXEL_ 1T9B)
(3) RGB666， 2P3T
配置：
#define SPI_IF_MODE (DSPI_MODE| SPI_WIRE3)
#define OUT_FORMAT FORMAT_RGB666
#define PIXEL_TYPE (PIXEL_2P3T |PIXEL_ 1T6B)
(4) RGB888， 1P 1T
配置：
#define SPI_IF_MODE (DSPI_MODE| SPI_WIRE3)
#define OUT_FORMAT FORMAT_RGB888
#define PIXEL_TYPE (PIXEL_ 1P 1T |PIXEL_ 1T 12B)
(5) RGB888， 2P3T
配置：
#define SPI_IF_MODE (DSPI_MODE| SPI_WIRE3)
#define OUT_FORMAT FORMAT_RGB888
#define PIXEL_TYPE (PIXEL_2P3T |PIXEL_ 1T 8B)

（三）4-wire SPI 时序以及配置

(1) RGB565
配置：

| #define SPI_IF_MODE | ( SPI_MODE| SPI_WIRE4) | | --- | --- | | #define OUT_FORMAT | FORMAT_RGB565 | | #define PIXEL_TYPE | (PIXEL_ 1P 1T |PIXEL_ 1T 16B) | | 或
#define SPI_IF_MODE | ( SPI_MODE| SPI_WIRE4) | | #define OUT_FORMAT | FORMAT_RGB565 | | #define PIXEL_TYPE | (PIXEL_ 1P2T |PIXEL_ 1T 8B) |

(2) RGB666

配置：
#define SPI_IF_MODE ( SPI_MODE| SPI_WIRE4)
#define OUT_FORMAT FORMAT_RGB666
#define PIXEL_TYPE (PIXEL_ 1P 1T |PIXEL_ 1T 18B)或
#define SPI_IF_MODE ( SPI_MODE| SPI_WIRE4)
#define OUT_FORMAT FORMAT_RGB666
#define PIXEL_TYPE (PIXEL_ 1P3T |PIXEL_ 1T 8B)
(3) RGB888
配置：

| #define SPI_IF_MODE | ( SPI_MODE| SPI_WIRE4) | | --- | --- | | #define OUT_FORMAT | FORMAT_RGB888 | | #define PIXEL_TYPE | (PIXEL_ 1P 1T |PIXEL_ 1T24B) | | 或
#define SPI_IF_MODE | ( SPI_MODE| SPI_WIRE4) | | #define OUT_FORMAT | FORMAT_RGB888 | | #define PIXEL_TYPE | (PIXEL_ 1P3T |PIXEL_ 1T 8B) |

（四）4-wire DSPI 时序以及配置

(1) RGB565, 1P 1T
配置：
#define SPI_IF_MODE (DSPI_MODE| SPI_WIRE4)
#define OUT_FORMAT FORMAT_RGB565
#define PIXEL_TYPE (PIXEL_ 1P 1T |PIXEL_ 1T 8B)

(2) RGB666, 1P 1T

配置：
#define SPI_IF_MODE (DSPI_MODE| SPI_WIRE4)
#define OUT_FORMAT FORMAT_RGB666
#define PIXEL_TYPE (PIXEL_ 1P 1T |PIXEL_ 1T9B)

(3) RGB666,2P3T

配置：
#define SPI_IF_MODE (DSPI_MODE| SPI_WIRE4)
#define OUT_FORMAT FORMAT_RGB666
#define PIXEL_TYPE (PIXEL_2P3T |PIXEL_ 1T6B)

(4) RGB888, 1P 1T

配置：
#define SPI_IF_MODE (DSPI_MODE| SPI_WIRE4)
#define OUT_FORMAT FORMAT_RGB888
#define PIXEL_TYPE (PIXEL_ 1P 1T |PIXEL_ 1T 12B)

(5) RGB888,2P3T

配置：
#define SPI_IF_MODE (DSPI_MODE| SPI_WIRE4)
#define OUT_FORMAT FORMAT_RGB888
#define PIXEL_TYPE (PIXEL_2P3T |PIXEL_ 1T 8B)

（五）QSPI 时序以及配置

(1) RGB565

1 RGB565,mode 0(1 lane)
配置：
#define SPI_IF_MODE (QSPI_MODE|QSPI_SUBMODE0)
#define OUT_FORMAT FORMAT_RGB565
#define PIXEL_TYPE (PIXEL_ 1P2T |PIXEL_ 1T 8B)
2 RGB565,mode 1(4 lane)
配置：
#define SPI_IF_MODE (QSPI_MODE|QSPI_SUBMODE1)
#define OUT_FORMAT FORMAT_RGB565
#define PIXEL_TYPE (PIXEL_ 1P2T |PIXEL_ 1T2B)
(2) RGB666
1 RGB666,mode 0(1 lane)
配置：
#define SPI_IF_MODE (QSPI_MODE|QSPI_SUBMODE0)
#define OUT_FORMAT FORMAT_RGB666
#define PIXEL_TYPE (PIXEL_ 1P3T |PIXEL_ 1T 8B)
2 RGB666,mode 1(4 lane)
配置：
#define SPI_IF_MODE (QSPI_MODE|QSPI_SUBMODE1)
#define OUT_FORMAT FORMAT_RGB666
#define PIXEL_TYPE (PIXEL_ 1P3T |PIXEL_ 1T2B)
3 RGB666,mode 2(4 lane)
配置：
#define SPI_IF_MODE (QSPI_MODE|QSPI_SUBMODE2)
#define OUT_FORMAT FORMAT_RGB666
#define PIXEL_TYPE (PIXEL_ 1P3T |PIXEL_ 1T2B)

(3) RGB888

1 RGB888,mode 0(1 lane)
配置：
#define SPI_IF_MODE (QSPI_MODE|QSPI_SUBMODE0)
#define OUT_FORMAT FORMAT_RGB888
#define PIXEL_TYPE (PIXEL_ 1P3T |PIXEL_ 1T 8B)
2 RGB888,mode 1(4 lane)
配置：
#define SPI_IF_MODE (QSPI_MODE|QSPI_SUBMODE1)
#define OUT_FORMAT FORMAT_RGB888
#define PIXEL_TYPE (PIXEL_ 1P3T |PIXEL_ 1T2B)
3 RGB888,mode 2(4 lane)
配置：
#define SPI_IF_MODE (QSPI_MODE|QSPI_SUBMODE2)
#define OUT_FORMAT FORMAT_RGB888
#define PIXEL_TYPE (PIXEL_ 1P3T |PIXEL_ 1T2B)

三、屏幕驱动参数配置说明

屏幕驱动三个部分的配置，分别为板级配置，屏幕相关参数配置以及屏幕接口配置。

（一）板级配置

板级配置主要是配置跟屏相关的普通io 口，比如复位脚、背光脚、TE 脚等等。
.pin_reset : 复位脚
.pin_cs : 片选脚
.pin_rs : 命令/数据选择脚（4-wire spi/4-wire dspi）
.pin_bl : 背光控制脚（可接pwm输出，调节背光亮度）
.pin_dc : mcu屏数据/命令选择脚
.pin_en : 屏使能脚（可控制屏的电源开关）
.pin_te : te脚(不带te 的屏可不配)

（二）屏幕相关参数配置

scr_x/scr_y/scr_w/scr_h : SPI/MCU屏有效显示区域设置（可指定屏幕的部分或者全部区域）
in_width：显示缓存宽度(一般跟屏幕有效区域宽度scr_w相等)
in_height : 显示缓存高度(一般跟屏幕有效区域高度scr_h相等)
in_format : 显示缓存格式，一般选择RGB565，如果屏幕接口支持RGB888 格式，同时想要更好的显示效果可选RGB888，不过会消耗更多的内存。
enum OUTPUT_FORMAT {
OUTPUT_FORMAT_RGB888,
OUTPUT_FORMAT_RGB565,} ;
lcd_width : 屏幕的水平分辨率
lcd_height : 屏幕的垂直分辨率
lcd_type : 屏幕接口类型
typedef enum lcd_type_cfg {
LCD_TYPE_SPI,// SPI屏
LCD_TYPE_MCU,// MCU屏
LCD_TYPE_RGB,// RGB屏} LCD_TYPE;
buffer_num : buffer 的数量(范围：1~2)，为了获得更好的性能，一般默认为 2
buffer_size : buffer 的大小，可支持分块（分块可以减少显示缓存的大小），分块的原则是水平方向不分块，垂直方向分块
fps:期望推屏帧率，会通过期望的帧率计算出合适的推屏时钟，可能会跟实际推屏帧率有偏差
spi_mode:参考Chapter 2
pixel_type:参考Chapter 2
out_format:参考Chapter 2
port:SPI 出口选择，SPI屏默认选择SPI_PORTA
#define SPI_PORTA 0
#define SPI_PORTB 1
注：SPI_PORTA支持SPI、DSPI、QSPI接口, SPI_PORTB只支持SPI
以及DSPI
spi_dat_mode:根据屏的 dat 脚是否为双向引脚来选择，一般默认选择 SPI_MODE_UNIDIR
#define SPI_MODE_UNIDIR 0//半双工，d0分时发送接收
#define SPI_MODE_BIDIR 1//全双工，d0发送、d1接收
debug_mode_en:调试模式，一般在调屏时打开，推纯色显示
debug_mode_color:调试模式颜色设置

（三）屏幕接口注册

logo:屏驱动名称，在有多个屏驱动的应用场合，用于匹配屏驱动的标识
row_addr_align:行对齐，根据屏幕手册设置，一般为 1
column_addr_align:列对齐，根据屏幕手册设置，一般为 1
lcd_cmd:初始化命令列表
cmd_cnt:命令数量
param：屏幕参数结构地址
reset:复位引脚接口，对复位时序有特殊要求时注册，否则使用内部通用的复位时序
backlight_ctrl:背光控制接口，熄屏/亮屏时调用
entersleep:屏幕休眠接口，熄屏时调用
exitsleep:屏幕唤醒接口，亮屏时调用