给 TXW81x 换一块新屏,或者调屏时遇到不亮、撕裂、抖动、偏色,都可以按这篇来。前半部分是新屏适配的完整流程,后半部分是常见显示问题速查。
本文基于 FPV-V2.5.3.7 系列 SDK 整理,不同版本的文件和宏可能略有差别。技术细节以泰芯官方《TXW81x LCD FAQ》为准,官网版本更新更及时。动手之前,先读屏幕规格书,确认接口类型(RGB / MCU 8080 / SPI)、数据线宽和时序参数。整体分四步:配置 IO、配置 LCDC 驱动、配置显存、配置旋转,最后跑一个 Demo 验证。
在 project_config.h 中配置屏幕的控制信号和数据线。
同一组控制信号宏,在 RGB 屏和 MCU 屏上含义不同:
| 宏 | RGB 屏 | MCU 屏 |
|---|---|---|
PIN_LCD_RESET | 复位(背光控制可参照这个配) | 复位 |
DOTCLK_PWR | 像素时钟 DOTCLK | 写信号 WR |
DE_ERD | DE 同步 | 读信号 RD |
VS_CS | 帧同步 VS | 片选 CS |
HS_DC | 行同步 HS | 命令 / 数据选择 DC |
LCD_TE | 不用 | TE 信号 |
不用的引脚填 255。
数据线按屏幕的线宽配置,默认颜色顺序下:
注意:用到 PB、PC 口时一定要使能VCAM_EN。 PB6~PB15、PC0~PC5 由 VCAM 供电,不使能的话这些脚没有电平输出,屏幕自然点不亮。如果是 ST7701 这类非直驱 RGB 屏,还要额外配置一路 SPI,用来初始化屏驱芯片的寄存器。
在 sdk/lib/bus/spi/lcd 目录下复制一份现有驱动来改:RGB 屏参考 st7701s.c,MCU 屏参考 st7789v_mcu.c。重点字段:
| 字段 | 说明 |
|---|---|
lcd_bus_type、bus_width | 接口类型(RGB 或 MCU)和线宽(8、16、18、24) |
color_mode | RGB565、RGB666、RGB888 |
pclk | RGB 屏是像素时钟,MCU 屏是 WR 速率,按规格书选 |
screen_w、screen_h | 屏幕实际宽高 |
video_w/h、osd_w/h | 视频层、OSD 层的尺寸,起点坐标一般用 0,0 |
init_table | 屏幕寄存器初始化表,MCU 屏和非直驱 RGB 屏必须配置(向屏厂索取);直驱 RGB 屏填 NULL |
vlw/vbp/vfp/hlw/hbp/hfp | RGB 屏的消隐和有效区参数,查规格书或问屏厂 |
pclk_inv、de_inv、hs_inv、vs_inv | 时钟和同步信号是否反向,显示异常时先试试反转这几个 |
lcd.h 里修改 SCALE_WIDTH、SCALE_HIGH(视频旋转后拉伸到的尺寸,旋转 90° 时宽高要对调)。视频显存定义在 lcd.c,有 3 块和 4 块缓冲两种选择。lv_port_disp.c。OSD 数据会被压缩到 interface_mgnt.c 里的乒乓编码缓冲中,OSD 颜色复杂时要加大编码缓冲,否则编码不全会显示异常。lv_port_disp.h 里把 MY_DISP_HOR_RES、MY_DISP_VER_RES 设成屏幕实际宽高;默认缓冲 10 行,SRAM 紧张时可以把缓冲挪到 PSRAM(数组加上 .psram.src 段修饰)。lcd_line_buf 的行宽必须按实际屏幕设置,设错会导致系统崩溃。SDK 里的 HX8282 横屏配置(LCD_HX8282_EN)可以当参考。sw_rotate = 1 和 rotated(90 / 180 / 270)。不生效的话,检查别处是不是又设置了一次。lcdc_set_rotate_mirror(lcd_dev, 0, LCD_ROTATE_90),可参考 user_demo.c 中进入首页时的调用。lcd.h 中 LCD_SET_ROTATE_180 的处理。在 interface_mgnt.c 中加入 LVGL 自带的 benchmark 测试 Demo,编译烧录,画面正常就说明适配完成了。
| 现象 | 原因 | 解决 |
|---|---|---|
| 按流程配好,屏幕还是不亮(FPV-2.5.3-29936) | 这个版本的 lcd.c 在初始化末尾,为兼容开发板强制设成了 MCU 6 线模式 | 屏蔽末尾强制设置像素时钟数量、重复设置总线宽度的代码 |
| MCU 屏有扫屏线 / 撕裂 | MCU 屏自带显存,读写不同步 | 见下文“MCU 屏 TE 防撕裂” |
| 解码视频出现锯齿 | 拉伸输出和旋转输入的乒乓缓冲冲突 | 在 lcd_done 中把三块解码缓冲的切换顺序错开 |
| RGB 屏画面抖动 | 部分屏对像素时钟停顿很敏感 | 见下文“RGB 屏画面抖动” |
| 偏色、对比度不对 | 屏幕个体差异 | 用 LCDC 的对比度、饱和度、CCM、GAMMA 校正 |
| 16 线 MCU 屏显示异常 | 这类屏初始化用 8 线,刷数据用 16 线 | 结构体保持 8 线,初始化完成后再切到 16 线 |
| 镜头画面被拉变形 | 16:9 镜头配 4:3 屏,比例不一致 | 用 scale 裁剪 |
LCD_TE 宏对应的引脚和触发沿即可,不用再自己接外部中断。35h 指令)。C6h 调整扫描速率,主控端用 pclk 调整写入速率,保证一帧写完发生在下一个 TE 到来之前。36h 的 MY、MX 位调整),否则照样会有扫屏线。LCD_FILL_CLK,用两个 timer 补足像素时钟。lcdc_video_enable_auto_ks(lcd_dev, 1);
/* 在这里执行保存参数、OTA 等写 Flash 操作 */
os_sleep_ms(10);
lcdc_video_enable_auto_ks(lcd_dev, 0);lcdc_video_enable_constarast、lcdc_video_set_constarast_val、lcdc_video_enable_saturation、lcdc_video_set_saturation_val 等接口(函数名以 SDK 为准)。100 万像素镜头输出是 16:9,320×240 的屏是 4:3,直接显示会被拉变形。可以用 scale 先拉伸到接近的比例,再只截取屏幕大小的一块输出——显示面积会小一点,但不会变形。目前 scale2、scale3 支持裁剪。
LCDC 不直接支持 SPI 屏,做法是截取 OSD 层和视频层的显存数据,再通过 SPI 打点函数写入屏幕。视频层数据是 YUV420,要靠 CPU 软件转成 RGB565,屏越大越慢,大屏放视频不推荐,更适合 160×80 这类小屏。
调屏遇到问题,欢迎在社区提问,附上屏幕型号、接口类型和 SDK 版本,能更快定位。