TXW82x 屏幕点亮:SPI / MIPI-DSI 屏配置步骤与抖动、撕裂排查

发布于 2026-11-08 22:00:10

TXW82x 的显示控制器(LCDC)比 81x 升级了不少:可以直接驱动 SPI 屏(不用再占用 SPI 总线),还支持 MIPI-DSI 屏。这篇讲怎么把一块新屏点亮,以及黑屏、偏色、抖动、撕裂这几类常见问题怎么处理。

内容整理自泰芯《TXW82x LCD FAQ》(V1.3)、《TXW82x 硬件设计指南》和《TXW82x_FPV_SDK 开发文档》。FAQ 以 SDK 2.7.0.7 系列版本为基础,新版本以实际代码为准。

一、支持哪些屏

屏接口说明
MIPI-DSIQFN68、QFN80 封装支持 1/2 lane;TXW826(QFN48)没有 MIPI-DSI
RGB满足电平要求的 GPIO 都可以配成 RGB 屏 IO
MCU(8080 / 6800)同上
SPI / QSPI同上,LCDC 直接驱动

显示分辨率最高 1280×720@60fps。显示有两个视频层和一个 OSD 层(LVGL 界面画在 OSD 层),OSD 支持透明度混合。

SDK 里有两个现成的屏幕方案可以参考:

  • LCD 720P 方案(CUSTOMER_ID 6):ST7701S MIPI 屏 + LVGL + H.264 / JPEG 解码播放。
  • AI 闹钟方案(CUSTOMER_ID 3):ST7789 SPI 屏 + LVGL。

二、硬件注意事项

  • IO 电压要匹配:屏的 IO 电压和主控 IO 电压必须一致,不一致要做电平转换。泰芯学习板上 PB9~PB13 属于 VCC1 电压域,默认 1.8V;接 3.3V 的 SPI 屏时要把 VCC1 改成 3.3V,否则通信不上。
  • MIPI-DSI:差分对之间、P/N 之间都可以调换,但必须整组使用;一组管脚用作 DSI 后,这组里没用到的管脚也不能当普通 GPIO。
  • 背光:背光 EN 和 PWM 脚硬件默认下拉,PWM 频率建议 20kHz 以上;升压二极管的反向耐压和输出电容耐压都要高于背光 IC 的 OVP 电压。
  • 复位:LCD 的 RST 脚在靠近接口处预留一个 102 电容。
屏的 IO 电压、背光升压、DSI lane 配错,可能损坏屏或主控。不要用「背光亮了」判断屏已经初始化成功。

三、点亮一块 SPI 屏

1. 配置引脚

SPI 屏常用的脚:CS(片选)、SCL(时钟)、SDA(数据)、DC(命令 / 数据选择)、TE(防撕裂同步)、RES(复位)。

  • 工程开了 PIN_FROM_PARAM:到 project/txw82xApp/config.cfg 里配。
  • 没开:直接在 project_config.h 里改。

2. 配置 LCDC 参数

新增一款屏,照着 st7735 的驱动文件复制一份改。重点看这几项:

  • 总线类型、总线宽度、颜色模式:先和 st7735 保持一致。
  • pclk:SPI 写入时钟,由系统时钟分频而来,按屏驱动 IC 的要求设置。
  • screen_w / screen_h:屏的实际显示范围。
  • video_w / h、osd_w / h:视频层和 OSD 层的有效显示宽高,不能超过 screen 的宽高。
  • video_x / y、osd_x / y:两层的偏移,不需要就填 0。
  • osd_scan_mode:LVGL 界面的旋转角度;scan_mode 是视频层旋转,谨慎使用。

3. 寄存器初始化表 init_table

一般向屏厂要。常见命令:0x11 退出睡眠(后面加延时)、0x3A 设成 RGB565、0x21 / 0x20 反色开关、0x29 打开显示、0x2A / 0x2B 设置显示区域、0x2C 写显存,表尾用 END 结束。

小技巧:同一个驱动 IC 配不同尺寸的屏时,可以把 0x2A/0x2B 设成驱动 IC 的最大显存范围,用 LCDC 的 x / y 偏移来对齐有效显示区,这样不用每次改初始化表。

4. 检查初始化代码有没有接上

有些早期 SDK 合并时漏了 SPI 屏的分支。检查 app_lcd.c 的 lcd_hardware_init 和 lcd_hardware_init565 里是否处理了 LCD_BUS_SPI4 类型。

5. 跑 LVGL benchmark 出图

在 app_fpv.c 打开 LVGL 初始化,在 interface_mgnt_v3.c 里屏蔽 main_ui、换成 lv_demo_benchmark,编译烧录看效果。提示缺字体时,在 lv_config.h 打开对应字号。

四、点亮一块 MIPI-DSI 屏

步骤和 SPI 屏类似,参考驱动换成 st7701s_mipi.c:

  1. 配置 DSI 引脚:CLK、D0、D1 三组差分对,加上 RES 复位和背光控制脚。4-lane 屏要接到 2-lane 的 82x 上,需要确认屏能在硬件或软件上设成 2-lane 模式。
  2. pclk:MIPI 像素时钟。参考配置 ST7701S 用 24MHz,2-lane 下单 lane 速率约 24×3×8÷2 = 288MHz,帧率约 51fps。帧率够用就好,一味提高会增加功耗和 PSRAM 带宽压力。
  3. lane_num:按屏的要求设 1 或 2。
  4. DSI 模块时钟:单 lane 速率不超过 480M 选 DSI_MODULE_CLK480,超过选 DSI_MODULE_CLK_960M(在 mipi_dsi_driver.c 里配置)。
  5. porch(行场消隐):按屏厂给的参数填。
  6. init_table:向屏厂要,以 END 结尾。

MIPI 屏调不亮的排查思路

  1. 打开 turnaround 模式,看初始化命令有没有卡住、是否全部发出去。
  2. 用逻辑分析仪(逻辑电平设 1.2V 或 1.5V)抓 data0 在低功耗模式下发的命令,看屏有没有回应。
  3. 在发 0x29 打开显示之前,先发 0x23 让像素全亮,或让驱动 IC 进入自测模式,并在 DSI 切高速模式前停住。能亮说明命令通路是好的,问题在后面的视频时序。
  4. 读回屏的状态寄存器,对照驱动 IC 手册判断。

偏色但不是 RGB 顺序问题:可能是屏锁存出错。试着把 vbp 上下微调 1~3,或者把 hs_inv / vs_inv 极性反过来。

五、常见问题

黑屏

先用纯色 framebuffer 验证面板、电源、复位和时序,屏能显示纯色后,再查视频层、OSD 层、LVGL 和播放器。

屏幕抖动

按顺序尝试:

  1. 打开 dclk 补全:在 lcd_hardware_init565 里打开,处理帧间停时钟导致抖动的屏,RGB / MIPI 屏都建议开。
  2. 缩短帧间隔:视频层旋转 0° 或 180° 时,可以把 linebuf 行数从默认 64 改小到 32、16 或 8。
  3. 调整 DMA burst:在 device.c 里调大旋转读通道的 burst,提高 PSRAM 读取效率。
  4. 加 OSD FIFO:在 lcd_driver_init 里增加 OSD FIFO,对 OSD 抖动有改善。
  5. OTA 或写参数时抖动:写 Flash 可能短暂卡住 CPU,建议开启 LCD autokick。
  6. 大屏 + 频繁解码还抖:把 OSD FIFO 和视频 linebuf 放到 SRAM 最后面,减少内存竞争。

画面撕裂(MCU / SPI 屏)

带显存的屏会遇到撕裂问题,SDK 默认没有做 TE 同步。做法是把屏的 TE 脚接到 IO,配置上升沿外部中断,在中断里再启动一帧刷新。

其他实用功能

  • 录屏模块:82x 新增的录屏模块可以把每帧显存存到 PSRAM,用来判断问题出在应用绘制、屏参配置还是屏本身。
  • Dither:屏本身不支持抖动时,可以打开 82x 的 dither,改善 RGB565 在天空、白墙这类大面积渐变上的色带。会占用 3 行宽度的 SRAM。
  • OSD 透明色:可以设整层透明度、指定某种颜色透明,用来做半透明菜单。
  • 比例不一致插黑边:16:9 画面显示到 4:3 屏时,调视频层 P0 的尺寸和位置,上下留黑,不裁画面。

相关阅读

点屏遇到问题,欢迎在社区提问,附上屏的型号、驱动 IC 和初始化表。

参考资料

0 条评论

AI
问答

发布
问题