TXW82x 的显示控制器(LCDC)比 81x 升级了不少:可以直接驱动 SPI 屏(不用再占用 SPI 总线),还支持 MIPI-DSI 屏。这篇讲怎么把一块新屏点亮,以及黑屏、偏色、抖动、撕裂这几类常见问题怎么处理。
内容整理自泰芯《TXW82x LCD FAQ》(V1.3)、《TXW82x 硬件设计指南》和《TXW82x_FPV_SDK 开发文档》。FAQ 以 SDK 2.7.0.7 系列版本为基础,新版本以实际代码为准。
| 屏接口 | 说明 |
|---|---|
| MIPI-DSI | QFN68、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 里有两个现成的屏幕方案可以参考:
CUSTOMER_ID 6):ST7701S MIPI 屏 + LVGL + H.264 / JPEG 解码播放。CUSTOMER_ID 3):ST7789 SPI 屏 + LVGL。屏的 IO 电压、背光升压、DSI lane 配错,可能损坏屏或主控。不要用「背光亮了」判断屏已经初始化成功。
1. 配置引脚
SPI 屏常用的脚:CS(片选)、SCL(时钟)、SDA(数据)、DC(命令 / 数据选择)、TE(防撕裂同步)、RES(复位)。
PIN_FROM_PARAM:到 project/txw82xApp/config.cfg 里配。project_config.h 里改。2. 配置 LCDC 参数
新增一款屏,照着 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 打开对应字号。
步骤和 SPI 屏类似,参考驱动换成 st7701s_mipi.c:
pclk:MIPI 像素时钟。参考配置 ST7701S 用 24MHz,2-lane 下单 lane 速率约 24×3×8÷2 = 288MHz,帧率约 51fps。帧率够用就好,一味提高会增加功耗和 PSRAM 带宽压力。lane_num:按屏的要求设 1 或 2。DSI_MODULE_CLK480,超过选 DSI_MODULE_CLK_960M(在 mipi_dsi_driver.c 里配置)。init_table:向屏厂要,以 END 结尾。0x29 打开显示之前,先发 0x23 让像素全亮,或让驱动 IC 进入自测模式,并在 DSI 切高速模式前停住。能亮说明命令通路是好的,问题在后面的视频时序。偏色但不是 RGB 顺序问题:可能是屏锁存出错。试着把 vbp 上下微调 1~3,或者把 hs_inv / vs_inv 极性反过来。
先用纯色 framebuffer 验证面板、电源、复位和时序,屏能显示纯色后,再查视频层、OSD 层、LVGL 和播放器。
按顺序尝试:
lcd_hardware_init565 里打开,处理帧间停时钟导致抖动的屏,RGB / MIPI 屏都建议开。device.c 里调大旋转读通道的 burst,提高 PSRAM 读取效率。lcd_driver_init 里增加 OSD FIFO,对 OSD 抖动有改善。带显存的屏会遇到撕裂问题,SDK 默认没有做 TE 同步。做法是把屏的 TE 脚接到 IO,配置上升沿外部中断,在中断里再启动一帧刷新。
点屏遇到问题,欢迎在社区提问,附上屏的型号、驱动 IC 和初始化表。