TXW81x LCD 屏幕點亮教程:新屏適配流程與常見顯示問題排查

發布於 2026-11-07 16:40:59

給 TXW81x 換一塊新屏,或者調屏時遇到不亮、撕裂、抖動、偏色,都可以按這篇來。前半部分是新屏適配的完整流程,後半部分是常見顯示問題速查。

本文基於 FPV-V2.5.3.7 系列 SDK 整理,不同版本的文件和宏可能略有差別。技術細節以泰芯官方《TXW81x LCD FAQ》為準,官網版本更新更及時。

第一部分:新屏適配流程

動手之前,先讀屏幕規格書,確認接口類型(RGB / MCU 8080 / SPI)、數據線寬和時序參數。整體分四步:配置 IO、配置 LCDC 驅動、配置顯存、配置旋轉,最後跑一個 Demo 驗證。

1. 配置屏幕 IO

在 project_config.h 中配置屏幕的控制信號和數據線。

同一組控制信號宏,在 RGB 屏和 MCU 屏上含義不同:

宏 RGB 屏 MCU 屏
PIN_LCD_RESET 複位(背光控制可參照這個配) 複位
DOTCLK_PWR 像素時鐘 DOTCLK 寫信號 WR
DE_ERD DE 同步 讀信號 RD
VS_CS 帧同步 VS 片選 CS
HS_DC 行同步 HS 命令 / 數據選擇 DC
LCD_TE 不用 TE 信號

不用的引腳填 255。

數據線按屏幕的線寬配置,默認顏色順序下:

  • 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
注意:用到 PB、PC 口時一定要使能 VCAM_EN。 PB6~PB15、PC0~PC5 由 VCAM 供電,不使能的話這些腳沒有電平輸出,屏幕自然點不亮。

如果是 ST7701 這類非直驅 RGB 屏,還要額外配置一路 SPI,用來初始化屏驅芯片的寄存器。

2. 配置 LCDC 驅動

在 sdk/lib/bus/spi/lcd 目錄下複制一份現有驅動來改:RGB 屏參考 st7701s.c,MCU 屏參考 st7789v_mcu.c。重點字段:

字段 說明
lcd_bus_type、bus_width 接口類型(RGB 或 MCU)和線寬(8、16、18、24)
color_mode RGB565、RGB666、RGB888
pclk RGB 屏是像素時鐘,MCU 屏是 WR 速率,按規格書選
screen_w、screen_h 屏幕實際寬高
video_w/h、osd_w/h 視頻層、OSD 層的尺寸,起點坐標一般用 0,0
init_table 屏幕寄存器初始化表,MCU 屏和非直驅 RGB 屏必須配置(向屏廠索取);直驅 RGB 屏填 NULL
vlw/vbp/vfp/hlw/hbp/hfp RGB 屏的消隱和有效區參數,查規格書或問屏廠
pclk_inv、de_inv、hs_inv、vs_inv 時鐘和同步信號是否反向,顯示異常時先試試反轉這幾個

3. 配置顯存

  • 視頻層:在 lcd.h 裡修改 SCALE_WIDTH、SCALE_HIGH(視頻旋轉後拉伸到的尺寸,旋轉 90° 時寬高要對調)。視頻顯存定義在 lcd.c,有 3 塊和 4 塊緩沖兩種選擇。
  • OSD 層:顯存在 lv_port_disp.c。OSD 數據會被壓縮到 interface_mgnt.c 裡的乒乓編碼緩沖中,OSD 顏色複雜時要加大編碼緩沖,否則編碼不全會顯示異常。
  • LVGL 緩沖:在 lv_port_disp.h 裡把 MY_DISP_HOR_RES、MY_DISP_VER_RES 設成屏幕實際寬高;默認緩沖 10 行,SRAM 緊張時可以把緩沖挪到 PSRAM(數組加上 .psram.src 段修飾)。
  • 橫屏注意:旋轉用的行緩沖 lcd_line_buf 的行寬必須按實際屏幕設置,設錯會導致系統崩潰。SDK 裡的 HX8282 橫屏配置(LCD_HX8282_EN)可以當參考。

4. 配置旋轉

  • OSD 層:由 LVGL 軟件旋轉,設置 sw_rotate = 1 和 rotated(90 / 180 / 270)。不生效的話,檢查別處是不是又設置了一次。
  • 視頻層:硬件旋轉,調用 lcdc_set_rotate_mirror(lcd_dev, 0, LCD_ROTATE_90),可參考 user_demo.c 中進入首頁時的調用。
  • 視頻層旋轉 180° 比較特殊:YUV 數據的偏移會變化,參考 lcd.h 中 LCD_SET_ROTATE_180 的處理。

5. 跑 Demo 驗證

在 interface_mgnt.c 中加入 LVGL 自帶的 benchmark 測試 Demo,編譯燒錄,畫面正常就說明適配完成了。

第二部分:常見顯示問題速查

現象 原因 解決
按流程配好,屏幕還是不亮(FPV-2.5.3-29936) 這個版本的 lcd.c 在初始化末尾,為兼容開發板強制設成了 MCU 6 線模式 屏蔽末尾強制設置像素時鐘數量、重複設置總線寬度的代碼
MCU 屏有掃屏線 / 撕裂 MCU 屏自帶顯存,讀寫不同步 見下文“MCU 屏 TE 防撕裂”
解碼視頻出現鋸齒 拉伸輸出和旋轉輸入的乒乓緩沖沖突 在 lcd_done 中把三塊解碼緩沖的切換順序錯開
RGB 屏畫面抖動 部分屏對像素時鐘停頓很敏感 見下文“RGB 屏畫面抖動”
偏色、對比度不對 屏幕個體差異 用 LCDC 的對比度、飽和度、CCM、GAMMA 校正
16 線 MCU 屏顯示異常 這類屏初始化用 8 線,刷數據用 16 線 結構體保持 8 線,初始化完成後再切到 16 線
鏡頭畫面被拉變形 16:9 鏡頭配 4:3 屏,比例不一致 用 scale 裁剪

MCU 屏 TE 防撕裂

  1. 新版 SDK 已支持 TE 信號直接觸發 LCDC 發送:配置好 LCD_TE 宏對應的引腳和觸發沿即可,不用再自己接外部中斷。
  2. 在屏幕端打開 TE 功能(ST7789 對應 35h 指令)。
  3. 讓“寫”快於“讀”:屏幕端用 C6h 調整掃描速率,主控端用 pclk 調整寫入速率,保證一帧寫完發生在下一個 TE 到來之前。
  4. 屏幕掃描方向要和主控寫入方向一致(ST7789 用 36h 的 MY、MX 位調整),否則照樣會有掃屏線。

RGB 屏畫面抖動

  • 補齊 DCLK:參考官網新版 SDK 中的 LCD_FILL_CLK,用兩個 timer 補足像素時鐘。
  • 提升 PSRAM 帶寬:外設多時 PSRAM 帶寬吃緊,部分型號的 PSRAM 可以提到 240MHz。
  • 寫 Flash 時開啟 auto kick:保存參數、OTA 等寫 Flash 的操作容易引起閃屏,在寫之前打開、寫完關閉:
lcdc_video_enable_auto_ks(lcd_dev, 1);
/* 在這裡執行保存參數、OTA 等寫 Flash 操作 */
os_sleep_ms(10);
lcdc_video_enable_auto_ks(lcd_dev, 0);

對比度、飽和度、CCM、GAMMA

  • 對比度(0~0x1F)和飽和度(0~0x10):先使能再設值,對應 lcdc_video_enable_constarast、lcdc_video_set_constarast_val、lcdc_video_enable_saturation、lcdc_video_set_saturation_val 等接口(函數名以 SDK 為準)。
  • CCM:先用色度計測出實際色塊,和標準色塊比較算出校正矩陣,做線性校色,解決屏與屏之間的偏色。
  • GAMMA:數字 GAMMA,把 RGB 值重映射到查找表中的值,做非線性校正。

畫面裁剪

100 萬像素鏡頭輸出是 16:9,320×240 的屏是 4:3,直接顯示會被拉變形。可以用 scale 先拉伸到接近的比例,再只截取屏幕大小的一塊輸出——顯示面積會小一點,但不會變形。目前 scale2、scale3 支持裁剪。

接 SPI 屏

LCDC 不直接支持 SPI 屏,做法是截取 OSD 層和視頻層的顯存數據,再通過 SPI 打點函數寫入屏幕。視頻層數據是 YUV420,要靠 CPU 軟件轉成 RGB565,屏越大越慢,大屏放視頻不推薦,更適合 160×80 這類小屏。


調屏遇到問題,歡迎在社區提問,附上屏幕型號、接口類型和 SDK 版本,能更快定位。

0 條評論

AI
問答

發布
問題