給 TXW81x 換一塊新屏,或者調屏時遇到不亮、撕裂、抖動、偏色,都可以按這篇來。前半部分是新屏適配的完整流程,後半部分是常見顯示問題速查。
本文基於 FPV-V2.5.3.7 系列 SDK 整理,不同版本的文件和宏可能略有差別。技術細節以泰芯官方《TXW81x LCD FAQ》為準,官網版本更新更及時。
動手之前,先讀屏幕規格書,確認接口類型(RGB / MCU 8080 / SPI)、數據線寬和時序參數。整體分四步:配置 IO、配置 LCDC 驅動、配置顯存、配置旋轉,最後跑一個 Demo 驗證。
在 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。
數據線按屏幕的線寬配置,默認顏色順序下:
注意:用到 PB、PC 口時一定要使能VCAM_EN。 PB6~PB15、PC0~PC5 由 VCAM 供電,不使能的話這些腳沒有電平輸出,屏幕自然點不亮。如果是 ST7701 這類非直驅 RGB 屏,還要額外配置一路 SPI,用來初始化屏驅芯片的寄存器。
在 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
|
時鐘和同步信號是否反向,顯示異常時先試試反轉這幾個 |
lcd.h 裡修改 SCALE_WIDTH、SCALE_HIGH(視頻旋轉後拉伸到的尺寸,旋轉 90° 時寬高要對調)。視頻顯存定義在 lcd.c,有 3 塊和 4 塊緩沖兩種選擇。lv_port_disp.c。OSD 數據會被壓縮到 interface_mgnt.c 裡的乒乓編碼緩沖中,OSD 顏色複雜時要加大編碼緩沖,否則編碼不全會顯示異常。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)可以當參考。sw_rotate = 1 和 rotated(90 / 180 / 270)。不生效的話,檢查別處是不是又設置了一次。lcdc_set_rotate_mirror(lcd_dev, 0, LCD_ROTATE_90),可參考 user_demo.c 中進入首頁時的調用。lcd.h 中 LCD_SET_ROTATE_180 的處理。在 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 裁剪 |
LCD_TE 宏對應的引腳和觸發沿即可,不用再自己接外部中斷。35h 指令)。C6h 調整掃描速率,主控端用 pclk 調整寫入速率,保證一帧寫完發生在下一個 TE 到來之前。36h 的 MY、MX 位調整),否則照樣會有掃屏線。LCD_FILL_CLK,用兩個 timer 補足像素時鐘。lcdc_video_enable_auto_ks(lcd_dev, 1);
/* 在這裡執行保存參數、OTA 等寫 Flash 操作 */
os_sleep_ms(10);
lcdc_video_enable_auto_ks(lcd_dev, 0);
lcdc_video_enable_constarast、lcdc_video_set_constarast_val、lcdc_video_enable_saturation、lcdc_video_set_saturation_val 等接口(函數名以 SDK 為準)。100 萬像素鏡頭輸出是 16:9,320×240 的屏是 4:3,直接顯示會被拉變形。可以用 scale 先拉伸到接近的比例,再只截取屏幕大小的一塊輸出——顯示面積會小一點,但不會變形。目前 scale2、scale3 支持裁剪。
LCDC 不直接支持 SPI 屏,做法是截取 OSD 層和視頻層的顯存數據,再通過 SPI 打點函數寫入屏幕。視頻層數據是 YUV420,要靠 CPU 軟件轉成 RGB565,屏越大越慢,大屏放視頻不推薦,更適合 160×80 這類小屏。
調屏遇到問題,歡迎在社區提問,附上屏幕型號、接口類型和 SDK 版本,能更快定位。