TXW81x LCD 屏幕点亮教程:新屏适配流程与常见显示问题排查

发布于 2026-11-07 16:40:59

给 TXW81x 换一块新屏,或者调屏时遇到不亮、撕裂、抖动、偏色,都可以按这篇来。前半部分是新屏适配的完整流程,后半部分是常见显示问题速查。

本文基于 FPV-V2.5.3.7 系列 SDK 整理,不同版本的文件和宏可能略有差别。技术细节以泰芯官方《TXW81x LCD FAQ》为准,官网版本更新更及时。

第一部分:新屏适配流程

动手之前,先读屏幕规格书,确认接口类型(RGB / MCU 8080 / SPI)、数据线宽和时序参数。整体分四步:配置 IO、配置 LCDC 驱动、配置显存、配置旋转,最后跑一个 Demo 验证。

1. 配置屏幕 IO

在 project_config.h 中配置屏幕的控制信号和数据线。

同一组控制信号宏,在 RGB 屏和 MCU 屏上含义不同:

宏RGB 屏MCU 屏
PIN_LCD_RESET复位(背光控制可参照这个配)复位
DOTCLK_PWR像素时钟 DOTCLK写信号 WR
DE_ERDDE 同步读信号 RD
VS_CS帧同步 VS片选 CS
HS_DC行同步 HS命令 / 数据选择 DC
LCD_TE不用TE 信号

不用的引脚填 255。

数据线按屏幕的线宽配置,默认颜色顺序下:

  • RGB888(24 位):D0~D23 依次对应 B0~B7、G0~G7、R0~R7
  • RGB666(18 位):D0~D17 依次对应 B0~B5、G0~G5、R0~R5
  • RGB565(16 位):D0~D15 依次对应 B0~B4、G0~G5、R0~R4
  • MCU 8080 8 位:默认接 D0~D7
注意:用到 PB、PC 口时一定要使能 VCAM_EN。 PB6~PB15、PC0~PC5 由 VCAM 供电,不使能的话这些脚没有电平输出,屏幕自然点不亮。

如果是 ST7701 这类非直驱 RGB 屏,还要额外配置一路 SPI,用来初始化屏驱芯片的寄存器。

2. 配置 LCDC 驱动

在 sdk/lib/bus/spi/lcd 目录下复制一份现有驱动来改:RGB 屏参考 st7701s.c,MCU 屏参考 st7789v_mcu.c。重点字段:

字段说明
lcd_bus_type、bus_width接口类型(RGB 或 MCU)和线宽(8、16、18、24)
color_modeRGB565、RGB666、RGB888
pclkRGB 屏是像素时钟,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/hfpRGB 屏的消隐和有效区参数,查规格书或问屏厂
pclk_inv、de_inv、hs_inv、vs_inv时钟和同步信号是否反向,显示异常时先试试反转这几个

3. 配置显存

  • 视频层:在 lcd.h 里修改 SCALE_WIDTH、SCALE_HIGH(视频旋转后拉伸到的尺寸,旋转 90° 时宽高要对调)。视频显存定义在 lcd.c,有 3 块和 4 块缓冲两种选择。
  • OSD 层:显存在 lv_port_disp.c。OSD 数据会被压缩到 interface_mgnt.c 里的乒乓编码缓冲中,OSD 颜色复杂时要加大编码缓冲,否则编码不全会显示异常。
  • LVGL 缓冲:在 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)可以当参考。

4. 配置旋转

  • OSD 层:由 LVGL 软件旋转,设置 sw_rotate = 1 和 rotated(90 / 180 / 270)。不生效的话,检查别处是不是又设置了一次。
  • 视频层:硬件旋转,调用 lcdc_set_rotate_mirror(lcd_dev, 0, LCD_ROTATE_90),可参考 user_demo.c 中进入首页时的调用。
  • 视频层旋转 180° 比较特殊:YUV 数据的偏移会变化,参考 lcd.h 中 LCD_SET_ROTATE_180 的处理。

5. 跑 Demo 验证

在 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 裁剪

MCU 屏 TE 防撕裂

  1. 新版 SDK 已支持 TE 信号直接触发 LCDC 发送:配置好 LCD_TE 宏对应的引脚和触发沿即可,不用再自己接外部中断。
  2. 在屏幕端打开 TE 功能(ST7789 对应 35h 指令)。
  3. 让“写”快于“读”:屏幕端用 C6h 调整扫描速率,主控端用 pclk 调整写入速率,保证一帧写完发生在下一个 TE 到来之前。
  4. 屏幕扫描方向要和主控写入方向一致(ST7789 用 36h 的 MY、MX 位调整),否则照样会有扫屏线。

RGB 屏画面抖动

  • 补齐 DCLK:参考官网新版 SDK 中的 LCD_FILL_CLK,用两个 timer 补足像素时钟。
  • 提升 PSRAM 带宽:外设多时 PSRAM 带宽吃紧,部分型号的 PSRAM 可以提到 240MHz。
  • 写 Flash 时开启 auto kick:保存参数、OTA 等写 Flash 的操作容易引起闪屏,在写之前打开、写完关闭:
lcdc_video_enable_auto_ks(lcd_dev, 1);
/* 在这里执行保存参数、OTA 等写 Flash 操作 */
os_sleep_ms(10);
lcdc_video_enable_auto_ks(lcd_dev, 0);

对比度、饱和度、CCM、GAMMA

  • 对比度(0~0x1F)和饱和度(0~0x10):先使能再设值,对应 lcdc_video_enable_constarast、lcdc_video_set_constarast_val、lcdc_video_enable_saturation、lcdc_video_set_saturation_val 等接口(函数名以 SDK 为准)。
  • CCM:先用色度计测出实际色块,和标准色块比较算出校正矩阵,做线性校色,解决屏与屏之间的偏色。
  • GAMMA:数字 GAMMA,把 RGB 值重映射到查找表中的值,做非线性校正。

画面裁剪

100 万像素镜头输出是 16:9,320×240 的屏是 4:3,直接显示会被拉变形。可以用 scale 先拉伸到接近的比例,再只截取屏幕大小的一块输出——显示面积会小一点,但不会变形。目前 scale2、scale3 支持裁剪。

接 SPI 屏

LCDC 不直接支持 SPI 屏,做法是截取 OSD 层和视频层的显存数据,再通过 SPI 打点函数写入屏幕。视频层数据是 YUV420,要靠 CPU 软件转成 RGB565,屏越大越慢,大屏放视频不推荐,更适合 160×80 这类小屏。


调屏遇到问题,欢迎在社区提问,附上屏幕型号、接口类型和 SDK 版本,能更快定位。

0 条评论

AI
问答

发布
问题