TXW81x LCD screen幕点亮教程: 新screen适配流程与常见显示problem排查

Publish in 2026-11-07 16: 40: 59

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

本文基于 FPV-V2. 5. 3. 7 系列 SDK 整理, 不同版本the文件and宏可能略有差别. 技术细节以泰芯官方 "TXW81x LCD FAQ" for准, 官网版本更新更及时.

第一部分: 新screen适配流程

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

1. 配置screen幕 IO

在 project_config. h In the配置screen幕the控制信Noand数据线.

同一组控制信No宏, 在 RGB screenand MCU screen上含义不同:

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

不withthe引脚填 255.

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

  • 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
注意: with到 PB, PC 口时一定要使能 VCAM_EN. PB6~PB15, PC0~PC5 由 VCAM 供电, 不使能the话这些脚none电平输出, screen幕自然点不亮.

如果是 ST7701 这类非直驱 RGB screen, 还要额外配置一路 SPI, with来初始化screen驱芯片the寄存器.

2. 配置 LCDC 驱动

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

字段 说明
lcd_bus_type, bus_width 接口类型 (RGB 或 MCU) and线宽 (8, 16, 18, 24)
color_mode RGB565, RGB666, RGB888
pclk RGB screen是像素时钟, MCU screen是 WR 速率, 按规格书选
screen_w, screen_h screen幕实际宽高
video_w/h, osd_w/h 视频层, OSD 层the尺寸, 起点坐标一般with 0, 0
init_table screen幕寄存器初始化表, MCU screenand非直驱 RGB screen必须配置 (向screen厂索取) ; 直驱 RGB screen填 NULL
vlw/vbp/vfp/hlw/hbp/hfp RGB screenthe消隐and有效区参数, 查规格书或qscreen厂
pclk_inv, de_inv, hs_inv, vs_inv 时钟and同步信No是否反向, 显示异常时先试试反转这几个

3. 配置显存

  • 视频层: 在 lcd. h 里修改 SCALE_WIDTH, SCALE_HIGH (视频旋转后拉伸到the尺寸, 旋转 90° 时宽高要对调) . 视频显存定义在 lcd. c, 有 3 块and 4 块缓冲两种选择.
  • OSD 层: 显存在 lv_port_disp. c. OSD 数据会被压缩到 interface_mgnt. c 里the乒乓编码缓冲In the, OSD 颜色复杂时要加大编码缓冲, 否则编码不全会显示异常.
  • LVGL 缓冲: 在 lv_port_disp. h 里把 MY_DISP_HOR_RES, MY_DISP_VER_RES 设成screen幕实际宽高; 默认缓冲 10 行, SRAM 紧张时可以把缓冲挪到 PSRAM (数组加上 . psram. src 段修饰) .
  • 横screen注意: 旋转withthe行缓冲 lcd_line_buf the行宽必须按实际screen幕设置, 设错会导致系统崩溃. SDK 里the HX8282 横screen配置 (LCD_HX8282_EN) 可以当参考.

4. 配置旋转

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

5. 跑 Demo 验证

在 interface_mgnt. c In the加入 LVGL 自带the benchmark 测试 Demo, 编译烧录, 画面正常就说明适配完成了.

第二部分: 常见显示problem速查

现象 原因 解决
按流程配好, screen幕还是不亮 (FPV-2. 5. 3-29936) 这个版本the lcd. c 在初始化末尾, for兼容开发板强制设成了 MCU 6 线mode screen蔽末尾强制设置像素时钟数量, 重复设置总线宽度the代码
MCU screen有扫screen线 / 撕裂 MCU screen自带显存, 读写不同步 见下文 "MCU screen TE 防撕裂"
解码视频出现锯齿 拉伸输出and旋转输入the乒乓缓冲冲突 在 lcd_done In the把三块解码缓冲the切换顺序错开
RGB screen画面抖动 部分screen对像素时钟停顿很敏感 见下文 "RGB screen画面抖动"
偏色, 对比度不对 screen幕个体差异 with LCDC the对比度, 饱and度, CCM, GAMMA 校正
16 线 MCU screen显示异常 这类screen初始化with 8 线, 刷数据with 16 线 结构体保持 8 线, 初始化完成后再切到 16 线
镜头画面被拉变形 16: 9 镜头配 4: 3 screen, 比例不一致 with scale 裁剪

MCU screen TE 防撕裂

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

RGB screen画面抖动

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

对比度, 饱and度, CCM, GAMMA

  • 对比度 (0~0x1F) and饱and度 (0~0x10) : 先使能再设值, 对应 lcdc_video_enable_constarast, lcdc_video_set_constarast_val, lcdc_video_enable_saturation, lcdc_video_set_saturation_val 等接口 (函数名以 SDK for准) .
  • CCM: 先with色度计测出实际色块, and标准色块比较算出校正矩阵, do线性校色, 解决screen与screen之间the偏色.
  • GAMMA: 数字 GAMMA, 把 RGB 值重映射到查找表In thethe值, do非线性校正.

画面裁剪

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

接 SPI screen

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


调screen遇到problem, 欢迎在社区Ask a question, 附上screen幕Model number, 接口类型and SDK 版本, 能更快定位.

0 Pieces of review

AI
Questions and answers

publish
problem