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-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 裡有兩個現成的屏幕方案可以參考:

  • 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
問答

發布
問題