适配 st7789v lcdr128 平台提供了 spi dbi 的 spi tft 接口,具有如下特点:
supports dbi type c 3 line/4 line interface modesupports 2 data lane interface modesupports data source from cpu or dmasupports rgb111/444/565/666/888 video formatmaximum resolution of rgb666 240 x 320@30hz with single data lanemaximum resolution of rgb888 240 x 320@60hz or 320 x 480@30hz with dual data lanesupports tearing effectsupports software flexible control video frame rate同时,提供了 spilcd 驱动框架以供 spi 屏幕使用。
此次适配的spi屏为 zjy240s0800tg11,使用的是 spi 进行驱动。注意请购买带 cs 引脚的 spi 屏幕,由于 st7789v spi 时序问题,cs 引脚直接接地可能会导致初始化无法写入。如果很不幸spi tft是不带 cs 的,请飞线出来连接 cs 引脚(如图所示)
引脚配置如下:
r128 devkit
tft 模块
pa12
cs(飞线)
pa13
clk
pa18
mosi
pa9
blk
pa20
res
pa19
dc
3v3
vcc
gnd
gnd
悬空
miso
载入方案我们使用的开发板是 r128-devkit,需要开发 c906 核心的应用程序,所以载入方案选择 r128s2_module_c906
$ source envsetup.sh $ lunch_rtos 1
设置 spi 驱动屏幕使用的是spi驱动,所以需要勾选spi驱动,运行 mrtos_menuconfig 进入配置页面。前往下列地址找到 spi devices
drivers options --- > soc related device drivers --- > spi devices --- > -*- enable spi driver
配置 spi 引脚打开你喜欢的编辑器,修改文件:board/r128s2/module/configs/sys_config.fex,在这里我们不需要用到 spi hold与spi wp引脚,注释掉即可。
;----------------------------------------------------------------------------------;spi controller configuration;----------------------------------------------------------------------------------;please config spi in dts[spi1]spi1_used = 1spi1_cs_number = 1spi1_cs_bitmap = 1spi1_cs0 = port:pa12spi1_sclk = port:pa13spi1_mosi = port:pa18spi1_miso = port:pa21;spi1_hold = port:pa19;spi1_wp = port:pa20
设置 pwm 驱动屏幕背光使用的是pwm驱动,所以需要勾选pwm驱动,运行 mrtos_menuconfig 进入配置页面。前往下列地址找到 pwm devices
drivers options --- > soc related device drivers --- > pwm devices --- > -*- enable pwm driver
配置 pwm 引脚打开你喜欢的编辑器,修改文件:board/r128s2/module/configs/sys_config.fex,增加 pwm1 节点
[pwm1]pwm_used = 1pwm_positive = port:pa9
设置 spi lcd 驱动spi lcd 由专门的驱动管理。运行 mrtos_menuconfig 进入配置页面。前往下列地址找到 spilcd devices ,注意同时勾选 spilcd hal apis test 方便测试使用。
drivers options --- > soc related device drivers --- > [*] disp driver support(spi_lcd) [*] spilcd hal apis test
编写 spi lcd 显示屏驱动获取屏幕初始化序列首先询问屏厂提供驱动源码
找到 lcd 的初始化序列代码
找到屏幕初始化的源码
整理后的初始化代码如下:
lcd_wr_reg(0x11);delay_ms(120); // delay 120ms// display and color format settinglcd_wr_reg(0x36);lcd_wr_data8(0x00);lcd_wr_reg(0x3a);lcd_wr_data8(0x05);// st7789s frame rate settinglcd_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);// st7789s power settinglcd_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(0xca);lcd_wr_data8(0x0f);lcd_wr_reg(0xc8);lcd_wr_data8(0x08);lcd_wr_reg(0x55);lcd_wr_data8(0x90);lcd_wr_reg(0xd0);lcd_wr_data8(0xa4);lcd_wr_data8(0xa1);// st7789s gamma settinglcd_wr_reg(0xe0);lcd_wr_data8(0xd0);lcd_wr_data8(0x00);lcd_wr_data8(0x06);lcd_wr_data8(0x09);lcd_wr_data8(0x0b);lcd_wr_data8(0x2a);lcd_wr_data8(0x3c);lcd_wr_data8(0x55);lcd_wr_data8(0x4b);lcd_wr_data8(0x08);lcd_wr_data8(0x16);lcd_wr_data8(0x14);lcd_wr_data8(0x19);lcd_wr_data8(0x20);lcd_wr_reg(0xe1);lcd_wr_data8(0xd0);lcd_wr_data8(0x00);lcd_wr_data8(0x06);lcd_wr_data8(0x09);lcd_wr_data8(0x0b);lcd_wr_data8(0x29);lcd_wr_data8(0x36);lcd_wr_data8(0x54);lcd_wr_data8(0x4b);lcd_wr_data8(0x0d);lcd_wr_data8(0x16);lcd_wr_data8(0x14);lcd_wr_data8(0x21);lcd_wr_data8(0x20);lcd_wr_reg(0x29);用现成驱动改写 spi lcd 驱动选择一个现成的 spi lcd 改写即可,这里选择 nv3029s.c 驱动来修改
复制这两个驱动,重命名为 st7789v.c
先编辑 st7789v.h 将 nv3029s 改成 st7789v
#ifndef _st7789v_h#define _st7789v_h#include panels.hstruct __lcd_panel st7789v_panel;#endif /*end of file*/编辑 st7789v.c 将 nv3029s 改成 st7789v
然后将屏厂提供的初始化序列复制进来
然后按照 spi_lcd 框架的接口改写驱动接口,具体接口如下
屏厂函数
spilcd框架接口
lcd_wr_reg
sunxi_lcd_cmd_write
lcd_wr_data8
sunxi_lcd_para_write
delay_ms
sunxi_lcd_delay_ms
完成驱动如下
#include st7789v.hstatic void lcd_power_on(u32 sel);static void lcd_power_off(u32 sel);static void lcd_bl_open(u32 sel);static void lcd_bl_close(u32 sel);static void lcd_panel_init(u32 sel);static void lcd_panel_exit(u32 sel);#define reset(s, v) sunxi_lcd_gpio_set_value(s, 0, v)#define power_en(sel, val) sunxi_lcd_gpio_set_value(sel, 0, val)static struct disp_panel_para info[lcd_fb_max];static void address(unsigned int sel, int x, int y, int width, int height){ sunxi_lcd_cmd_write(sel, 0x2b); /* set row address */ sunxi_lcd_para_write(sel, (y > > 8) & 0xff); sunxi_lcd_para_write(sel, y & 0xff); sunxi_lcd_para_write(sel, (height > > 8) & 0xff); sunxi_lcd_para_write(sel, height & 0xff); sunxi_lcd_cmd_write(sel, 0x2a); /* set coloum address */ sunxi_lcd_para_write(sel, (x > > 8) & 0xff); sunxi_lcd_para_write(sel, x & 0xff); sunxi_lcd_para_write(sel, (width > > 8) & 0xff); sunxi_lcd_para_write(sel, width & 0xff); sunxi_lcd_cmd_write(sel, 0x2c);}static void lcd_panel_init(unsigned int sel){ if (bsp_disp_get_panel_info(sel, &info[sel])) { lcd_fb_wrn(get panel info fail!n); return; } sunxi_lcd_cmd_write(sel, 0x11); sunxi_lcd_delay_ms(120); /* display and color format setting */ sunxi_lcd_cmd_write(sel, 0x36); sunxi_lcd_para_write(sel, 0x00); sunxi_lcd_cmd_write(sel, 0x3a); sunxi_lcd_para_write(sel, 0x05); /* st7789s frame rate setting */ sunxi_lcd_cmd_write(sel, 0xb2); sunxi_lcd_para_write(sel, 0x0c); sunxi_lcd_para_write(sel, 0x0c); sunxi_lcd_para_write(sel, 0x00); sunxi_lcd_para_write(sel, 0x33); sunxi_lcd_para_write(sel, 0x33); sunxi_lcd_cmd_write(sel, 0xb7); sunxi_lcd_para_write(sel, 0x35); /* st7789s power setting */ sunxi_lcd_cmd_write(sel, 0xbb); sunxi_lcd_para_write(sel, 0x35); sunxi_lcd_cmd_write(sel, 0xc0); sunxi_lcd_para_write(sel, 0x2c); sunxi_lcd_cmd_write(sel, 0xc2); sunxi_lcd_para_write(sel, 0x01); sunxi_lcd_cmd_write(sel, 0xc3); sunxi_lcd_para_write(sel, 0x13); sunxi_lcd_cmd_write(sel, 0xc4); sunxi_lcd_para_write(sel, 0x20); sunxi_lcd_cmd_write(sel, 0xc6); sunxi_lcd_para_write(sel, 0x0f); sunxi_lcd_cmd_write(sel, 0xca); sunxi_lcd_para_write(sel, 0x0f); sunxi_lcd_cmd_write(sel, 0xc8); sunxi_lcd_para_write(sel, 0x08); sunxi_lcd_cmd_write(sel, 0x55); sunxi_lcd_para_write(sel, 0x90); sunxi_lcd_cmd_write(sel, 0xd0); sunxi_lcd_para_write(sel, 0xa4); sunxi_lcd_para_write(sel, 0xa1); /* st7789s gamma setting */ sunxi_lcd_cmd_write(sel, 0xe0); sunxi_lcd_para_write(sel, 0xd0); sunxi_lcd_para_write(sel, 0x00); sunxi_lcd_para_write(sel, 0x06); sunxi_lcd_para_write(sel, 0x09); sunxi_lcd_para_write(sel, 0x0b); sunxi_lcd_para_write(sel, 0x2a); sunxi_lcd_para_write(sel, 0x3c); sunxi_lcd_para_write(sel, 0x55); sunxi_lcd_para_write(sel, 0x4b); sunxi_lcd_para_write(sel, 0x08); sunxi_lcd_para_write(sel, 0x16); sunxi_lcd_para_write(sel, 0x14); sunxi_lcd_para_write(sel, 0x19); sunxi_lcd_para_write(sel, 0x20); sunxi_lcd_cmd_write(sel, 0xe1); sunxi_lcd_para_write(sel, 0xd0); sunxi_lcd_para_write(sel, 0x00); sunxi_lcd_para_write(sel, 0x06); sunxi_lcd_para_write(sel, 0x09); sunxi_lcd_para_write(sel, 0x0b); sunxi_lcd_para_write(sel, 0x29); sunxi_lcd_para_write(sel, 0x36); sunxi_lcd_para_write(sel, 0x54); sunxi_lcd_para_write(sel, 0x4b); sunxi_lcd_para_write(sel, 0x0d); sunxi_lcd_para_write(sel, 0x16); sunxi_lcd_para_write(sel, 0x14); sunxi_lcd_para_write(sel, 0x21); sunxi_lcd_para_write(sel, 0x20); sunxi_lcd_cmd_write(sel, 0x29); if (info[sel].lcd_x < info[sel].lcd_y) address(sel, 0, 0, info[sel].lcd_x - 1, info[sel].lcd_y - 1); else address(sel, 0, 0, info[sel].lcd_y - 1, info[sel].lcd_x - 1);}static void lcd_panel_exit(unsigned int sel){ sunxi_lcd_cmd_write(sel, 0x28); sunxi_lcd_delay_ms(20); sunxi_lcd_cmd_write(sel, 0x10); sunxi_lcd_delay_ms(20); sunxi_lcd_pin_cfg(sel, 0);}static s32 lcd_open_flow(u32 sel){ lcd_fb_here; /* open lcd power, and delay 50ms */ lcd_open_func(sel, lcd_power_on, 50); /* open lcd power, than delay 200ms */ lcd_open_func(sel, lcd_panel_init, 200); lcd_open_func(sel, lcd_fb_black_screen, 50); /* open lcd backlight, and delay 0ms */ lcd_open_func(sel, lcd_bl_open, 0); return 0;}static s32 lcd_close_flow(u32 sel){ lcd_fb_here; /* close lcd backlight, and delay 0ms */ lcd_close_func(sel, lcd_bl_close, 50); /* open lcd power, than delay 200ms */ lcd_close_func(sel, lcd_panel_exit, 10); /* close lcd power, and delay 500ms */ lcd_close_func(sel, lcd_power_off, 10); return 0;}static void lcd_power_on(u32 sel){ /* config lcd_power pin to open lcd power0 */ lcd_fb_here; power_en(sel, 1); sunxi_lcd_power_enable(sel, 0); sunxi_lcd_pin_cfg(sel, 1); reset(sel, 1); sunxi_lcd_delay_ms(100); reset(sel, 0); sunxi_lcd_delay_ms(100); reset(sel, 1);}static void lcd_power_off(u32 sel){ lcd_fb_here; /* config lcd_power pin to close lcd power0 */ sunxi_lcd_power_disable(sel, 0); power_en(sel, 0);}static void lcd_bl_open(u32 sel){ sunxi_lcd_pwm_enable(sel); /* config lcd_bl_en pin to open lcd backlight */ sunxi_lcd_backlight_enable(sel); lcd_fb_here;}static void lcd_bl_close(u32 sel){ /* config lcd_bl_en pin to close lcd backlight */ sunxi_lcd_backlight_disable(sel); sunxi_lcd_pwm_disable(sel); lcd_fb_here;}/* sel: 0:lcd0; 1:lcd1 */static s32 lcd_user_defined_func(u32 sel, u32 para1, u32 para2, u32 para3){ lcd_fb_here; return 0;}static int lcd_set_var(unsigned int sel, struct fb_info *p_info){ return 0;}static int lcd_set_addr_win(unsigned int sel, int x, int y, int width, int height){ address(sel, x, y, width, height); return 0;}static int lcd_blank(unsigned int sel, unsigned int en){ return 0;}struct __lcd_panel st7789v_panel = { /* panel driver name, must mach the name of lcd_drv_name in sys_config.fex */ .name = st7789v, .func = { .cfg_open_flow = lcd_open_flow, .cfg_close_flow = lcd_close_flow, .lcd_user_defined_func = lcd_user_defined_func, .blank = lcd_blank, .set_var = lcd_set_var, .set_addr_win = lcd_set_addr_win, },};对接驱动框架完成了屏幕驱动的编写,接下来需要对接到 spilcd 驱动框架。首先编辑 kconfig
增加 st7789v 的配置
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 驱动的引用
如下图
#ifdef config_lcd_support_st7789v &st7789v_panel,#endif之后编辑 panels.h 同样增加引用
如下图
#ifdef config_lcd_support_st7789vextern struct __lcd_panel st7789v_panel;#endif最后编辑外层的 makefile 增加编译选项
如下所示
obj-${config_lcd_support_st7789v} += panels/st7789v.o选择 st7789v 驱动在 spilcd 驱动选择界面可以看到 lcd_fb panels select 选择 spi 屏幕的驱动
进入 lcd_fb panels select 选项
选择并勾选 [*] lcd support st7789v panel
配置 spi lcd 引脚打开你喜欢的编辑器,修改文件:board/r128s2/module/configs/sys_config.fex
[lcd_fb0]lcd_used = 1 lcd_model_name = spilcd lcd_driver_name = st7789v lcd_x = 240 lcd_y = 320 lcd_width = 37 lcd_height = 48 lcd_data_speed = 50lcd_pwm_used = 1lcd_pwm_ch = 1lcd_pwm_freq = 5000 lcd_pwm_pol = 0 lcd_if = 0lcd_pixel_fmt = 11 lcd_dbi_fmt = 2lcd_dbi_clk_mode = 1lcd_dbi_te = 1fb_buffer_num = 2lcd_dbi_if = 4lcd_rgb_order = 0lcd_fps = 60lcd_spi_bus_num = 1lcd_frm = 2lcd_gamma_en = 1lcd_backlight = 100lcd_power_num = 0lcd_gpio_regu_num = 0lcd_bl_percent_num = 0lcd_spi_dc_pin = port:pa19;reset pinlcd_gpio_0 = port:pa20编译打包运行命令 mp 编译打包,可以看到编译了 st7789v.o
测试烧录启动之后,屏幕背光启动,但是屏幕全黑。
输入 test_spilcd ,屏幕显示黄色。
输入 lv_examples 1 可以显示 lvgl 界面
常见问题屏幕白屏屏幕白屏,但是背光亮起
白屏是因为屏幕没有初始化,需要检查屏幕初始化序列或者初始化数据是否正确。
屏幕花屏屏幕花屏,无法控制
花屏一般是因为屏幕初始化后没有正确设置 addrwin,或者初始化序列错误。
lvgl 屏幕颜色不正确出现反色,颜色异常
请配置 lvgl lv_color_depth 参数为 16,lv_color_16_swap 为 1,这是由 spi lcd 的特性决定的。
显示反色运行 test_spilcd ,屏幕显示蓝色。
这是由于屏幕启动了 rb swap,一般是 0x36 寄存器修改
正常显示
sunxi_lcd_cmd_write(sel, 0x36);sunxi_lcd_para_write(sel, 0x00);反色显示
sunxi_lcd_cmd_write(sel, 0x36);sunxi_lcd_para_write(sel, 0x08);
格灵深瞳发布自主研发的大规模沉浸式人机交互系统—大宇宙
第五届&quot;复微杯&quot;2023全国大学生电子设计大赛正式启动!
提问:什么是四层一阶pcb?
骁龙765G VS天玑1000L 谁更拥有旗舰级的性能
moxa推出16口非网管型工业以太网交换机-EDS-316系
全志R128适配ST7789v LCD
使用鸿蒙JS框架写出来的JS代码长什么样
HARRIS发射机中频电路校准原理是什么
LED产业的确定和战略选择
车载导航系统的研究现状及未来发展
Pactum宣布完成由柏林项目A牵头的300万美元种子融资轮
OPPORenoZ详细评测 比较符合年轻人的定位
智能雷达感应方案增添了人们生活的幸福感
艾迈斯半导体用先进的传感器解决方案打造移动设备的未来
美格智能5G技术加速5G行业商用进程之天线!
射频测试设备编程指南——射频移相器
从Siri看下一代智能系统的变革与商机
华兴联合昕诺飞发布UVC LED商用新品
大众车发动机OBD灯反复报警是什么原因
机器人行业也会有用工荒的现象吗