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 和初始化表。