1. 項(xiàng)目緣起為什么選擇6.25英寸DSI LCD最近在折騰一個(gè)便攜式顯示終端項(xiàng)目核心需求是找一塊尺寸適中、接口現(xiàn)代、驅(qū)動(dòng)相對簡單的屏幕。市面上常見的HDMI、MIPI DSI、LVDS接口屏幕琳瑯滿目最終我鎖定了一塊6.25英寸的MIPI DSI LCD。這個(gè)尺寸很有意思它比手機(jī)屏幕大能顯示更多內(nèi)容又比傳統(tǒng)的7寸、10寸屏小巧便攜非常適合嵌入到手持設(shè)備、便攜儀表或者作為小型主機(jī)的第二屏。更重要的是DSIDisplay Serial Interface作為移動(dòng)設(shè)備顯示的主流接口其高帶寬、低引腳數(shù)的特性對于追求緊湊設(shè)計(jì)和低功耗的項(xiàng)目來說幾乎是目前的最優(yōu)解。然而從“點(diǎn)亮”到“完美驅(qū)動(dòng)”這條路遠(yuǎn)比想象中曲折。官方資料往往語焉不詳Linux內(nèi)核的配置更是深坑無數(shù)。這篇文章就是把我從選型、硬件連接、內(nèi)核驅(qū)動(dòng)適配、到最終解決花屏、背光調(diào)節(jié)等一系列問題的完整過程記錄下來。如果你也正在為一塊DSI屏幕而頭疼希望這篇超過五千字的實(shí)戰(zhàn)筆記能幫你少走彎路。2. 硬件選型與接口深探不只是接上線那么簡單拿到一塊6.25寸DSI屏第一步不是急著上電而是徹底搞清楚它的“身份證信息”。這通常藏在屏幕背面的型號(hào)標(biāo)簽或配套的規(guī)格書上。2.1 核心參數(shù)解讀屏幕的“體檢報(bào)告”一份典型的規(guī)格書會(huì)包含以下關(guān)鍵信息每一項(xiàng)都直接影響后續(xù)的驅(qū)動(dòng)配置分辨率比如常見的1080x1920豎屏或1920x1080橫屏。這決定了dts中display-timings的詳細(xì)參數(shù)。接口類型明確為MIPI DSI。通常還會(huì)注明是DSI-1、DSI-2還是DSI-4 lane通道數(shù)。通道數(shù)越多理論上支持的分辨率和刷新率越高。我手頭這塊屏是DSI-4 lane。供電電壓屏幕通常需要多路供電。核心電壓VCC可能是3.3V或1.8VIO電壓VCC_IO也類似背光LED,LED-則是另一套可能是升壓驅(qū)動(dòng)。務(wù)必核對清楚接錯(cuò)電壓瞬間燒屏。背光類型與驅(qū)動(dòng)是普通的LED背光還是需要恒流驅(qū)動(dòng)的規(guī)格書上會(huì)標(biāo)明背光正向電壓如10V-30V和電流如60mA。這決定了你需要選擇什么樣的背光驅(qū)動(dòng)電路。初始化序列Init Code這是屏幕的“啟動(dòng)密碼”。廠家通常會(huì)提供一個(gè)十六進(jìn)制數(shù)組用于在DSI鏈路初始化后通過DSI的DCSDisplay Command Set命令對屏幕內(nèi)部的控制器進(jìn)行配置包括伽馬校正、色彩模式、掃描方向等。沒有這個(gè)序列屏幕可能點(diǎn)亮但顯示異常如顏色不對、花屏。注意很多廉價(jià)屏或通用屏可能不提供規(guī)格書或者提供的序列是過時(shí)的。這時(shí)需要向賣家索要或者根據(jù)主控芯片型號(hào)如ILI9881C, ST7701S去查找公版的初始化代碼再進(jìn)行調(diào)整。2.2 與主控板的連接信號(hào)與電源的舞蹈我使用的核心板是瑞芯微的RK3566它原生帶有一個(gè)MIPI DSI TX接口。連接時(shí)需要關(guān)注兩組線信號(hào)線差分對DSI的Clock Lane和Data Lane。對于4-lane屏幕就是CLK/- D0/- D1/- D2/- D3/-。需要嚴(yán)格按照主控板和屏幕FPC連接器的定義一一對應(yīng)連接。差分線對PCB布線有要求但如果是現(xiàn)成的板對板連接器通常只需防呆插好即可。電源與控制線屏幕供電根據(jù)規(guī)格書提供VCC和VCC_IO?？梢杂珊诵陌宓碾娫淳W(wǎng)絡(luò)引出但要注意電流能力是否足夠必要時(shí)需加LDO。背光供電這是最容易出問題的地方。RK3566的背光控制引腳通常是PWM驅(qū)動(dòng)輸出的是3.3V的邏輯電平信號(hào)無法直接驅(qū)動(dòng)高壓背光串。必須外接背光驅(qū)動(dòng)電路。我選用了一顆常見的背光驅(qū)動(dòng)芯片OCP8122它將PWM信號(hào)轉(zhuǎn)換為恒流輸出驅(qū)動(dòng)屏幕的LED背光串。復(fù)位RESET與使能ENABLE屏幕一般有復(fù)位引腳低電平有效。使能引腳有時(shí)叫TE或STB用于控制屏幕進(jìn)入/退出睡眠模式。這些都需要連接到主控的GPIO并在設(shè)備樹中正確配置。硬件連接檢查清單[ ] 差分線對是否連接正確正負(fù)未接反[ ] 屏幕各路供電電壓是否與規(guī)格書一致萬用表實(shí)測[ ] 背光驅(qū)動(dòng)電路輸入PWM, 使能是否接到主控GPIO輸出是否接到屏幕背光接口[ ] 復(fù)位引腳是否接了上拉電阻并由GPIO控制3. Linux內(nèi)核驅(qū)動(dòng)適配設(shè)備樹DTS的魔法硬件連接無誤后真正的挑戰(zhàn)在于軟件核心是編寫正確的設(shè)備樹Device Tree源文件.dts或.dtsi。設(shè)備樹告訴Linux內(nèi)核這塊屏幕的存在和所有細(xì)節(jié)。3.1 構(gòu)建DSI顯示節(jié)點(diǎn)框架在核心板對應(yīng)的設(shè)備樹文件中如rk3566-xxx.dtsi我們需要在dsi0節(jié)點(diǎn)下添加一個(gè)panel子節(jié)點(diǎn)。以下是一個(gè)精簡的框架你需要填入自己的參數(shù)dsi0 { status okay; panel0 { compatible your-panel-compatible-string; // 關(guān)鍵用于匹配驅(qū)動(dòng) reg 0; backlight backlight; // 關(guān)聯(lián)背光節(jié)點(diǎn) reset-gpios gpio0 RK_PC5 GPIO_ACTIVE_LOW; // 復(fù)位GPIO enable-gpios gpio0 RK_PC6 GPIO_ACTIVE_HIGH; // 使能GPIO // 供電控制對應(yīng)regulator vcc-supply vcc_lcd; iovcc-supply vcc_lcd_io; ports { #address-cells 1; #size-cells 0; port0 { reg 0; panel_in_dsi: endpoint { remote-endpoint dsi_out_panel; }; }; }; }; }; // 定義DSI輸出端口 dsi_out_panel: endpoint0 { remote-endpoint panel_in_dsi; >panel0 { // ... 其他屬性同上 display-timings { native-mode timing0; timing0: timing0 { clock-frequency 148500000; // 像素時(shí)鐘單位Hz hactive 1080; // 水平有效像素 vactive 1920; // 垂直有效像素 hfront-porch 20; // 水平前肩 hsync-len 10; // 水平同步脈沖寬度 hback-porch 20; // 水平后肩 vfront-porch 10; // 垂直前肩 vsync-len 2; // 垂直同步脈沖寬度 vback-porch 10; // 垂直后肩 hsync-active 0; // 水平同步極性 (0低有效) vsync-active 0; // 垂直同步極性 de-active 1; // 數(shù)據(jù)使能極性 pixelclk-active 0; // 像素時(shí)鐘極性 }; }; };如何計(jì)算clock-frequency公式clock-frequency (hactive hfront-porch hsync-len hback-porch) * (vactive vfront-porch vsync-len vback-porch) * 刷新率例如對于1080x192060Hz總行像素10802010201130總幀行數(shù)1920102101942。則clock-frequency ≈ 1130 * 1942 * 60 ≈ 131.7 MHz。但實(shí)際值需要根據(jù)屏幕數(shù)據(jù)手冊的典型值填寫我這里是148.5M這是一個(gè)非常常見的標(biāo)準(zhǔn)值與1080p60Hz的HDMI時(shí)鐘一致。切忌自己亂算以規(guī)格書為準(zhǔn)3.3 注入初始化序列屏幕的“啟動(dòng)代碼”這是驅(qū)動(dòng)屏幕內(nèi)部控制器的關(guān)鍵。序列通過panel-init-sequence屬性傳遞。序列是一組命令類型 命令參數(shù) 延遲的組合。panel0 { // ... 其他屬性 panel-init-sequence [ 39 00 04 B9 F1 12 83 // 發(fā)送4字節(jié)命令 B9, 參數(shù)為 F1 12 83 39 00 1C BA 33 81 05 F9 0E 0E 20 00 00 00 00 00 00 00 44 25 00 91 0A 00 00 02 4F D1 00 00 37 15 00 02 CF FF // 發(fā)送2字節(jié)命令 CF, 參數(shù) FF 05 78 01 11 // 發(fā)送 DCS 命令 0x11 (Sleep Out)并延遲120ms 05 32 01 29 // 發(fā)送 DCS 命令 0x29 (Display On)并延遲50ms ]; };39代表DTYPE_DCS_LWRITE即長寫命令。15代表DTYPE_DCS_WRITE1即單字節(jié)參數(shù)命令。05代表DTYPE_DCS_WRITE即無參數(shù)DCS命令。第二列00通常是寄存器地址位一般填0。第三列是命令字節(jié)數(shù)包括命令號(hào)本身。后續(xù)是具體的命令和參數(shù)。最后一個(gè)數(shù)字是延遲單位是毫秒。78是十六進(jìn)制即120ms。獲取與調(diào)試初始化序列最佳來源屏幕廠家提供的規(guī)格書或驅(qū)動(dòng)代碼。次選方案根據(jù)屏幕主控IC型號(hào)如通過屏幕FPC上的絲印或拆解得知搜索“IC型號(hào) initialization code”。例如“ILI9881C init code”。終極調(diào)試如果沒有序列屏幕可能點(diǎn)亮但顯示異常。你可以嘗試只發(fā)送0x11和0x29這兩個(gè)最基礎(chǔ)的DCS命令如果屏幕能亮但花屏說明硬件通路是通的問題就在初始化序列。此時(shí)需要借助邏輯分析儀抓取原廠驅(qū)動(dòng)板如樹莓派的DSI總線數(shù)據(jù)解析出完整的初始化序列。這是一個(gè)高階操作但對解決疑難雜癥非常有效。4. 背光驅(qū)動(dòng)配置讓屏幕“亮”起來屏幕顯示正常了但背光不亮一切仍是徒勞。背光驅(qū)動(dòng)涉及硬件電路和軟件配置兩方面。4.1 硬件電路OCP8122實(shí)戰(zhàn)接線我使用的OCP8122是一個(gè)支持PWM調(diào)光的升壓型LED驅(qū)動(dòng)芯片。典型接線如下VIN接系統(tǒng)電源如5V。EN使能引腳接主控GPIO高電平有效。PWMPWM調(diào)光輸入接主控的PWM輸出引腳。FB電流反饋通過一個(gè)精密電阻如R_fb 0.1V / I_led接地用于設(shè)定LED電流。LX功率開關(guān)節(jié)點(diǎn)接電感和二極管。OUT輸出接LED背光串的正極。計(jì)算反饋電阻假設(shè)屏幕背光要求電流I_led 60mAOCP8122的反饋電壓V_fb 0.1V。則R_fb V_fb / I_led 0.1V / 0.06A ≈ 1.67Ω。選擇一個(gè)接近的標(biāo)準(zhǔn)阻值如1.8Ω。4.2 設(shè)備樹中的背光節(jié)點(diǎn)需要在設(shè)備樹中定義背光節(jié)點(diǎn)并與panel節(jié)點(diǎn)的backlight屬性關(guān)聯(lián)。backlight: backlight { compatible pwm-backlight; pwms pwm4 0 50000 0; // 使用PWM4周期50kHz極性正常 brightness-levels 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100; default-brightness-level 50; // 默認(rèn)50%亮度 enable-gpios gpio0 RK_PC7 GPIO_ACTIVE_HIGH; // 背光芯片使能GPIO };pwm4 0 50000 0表示使用pwm4設(shè)備的第0個(gè)通道PWM周期為1/50000 Hz 20us即50kHz極性為0占空比越大越亮。brightness-levels這是一個(gè)從0到100的映射表內(nèi)核會(huì)將亮度值0-100映射到對應(yīng)的PWM占空比。這里簡單線性映射。enable-gpios控制背光驅(qū)動(dòng)芯片的使能腳在背光開啟/關(guān)閉時(shí)操作。4.3 調(diào)試背光從無到有先硬件后軟件用萬用表測量背光驅(qū)動(dòng)芯片的輸入電壓VIN、使能腳EN和PWM腳電壓。確保上電后EN為高PWM腳有波形。檢查PWM輸出可以通過echo 0 /sys/class/backlight/backlight/bl_power先確保背光節(jié)點(diǎn)注冊成功來嘗試關(guān)閉背光觀察PWM引腳波形是否變化?；蛘咧苯硬僮?sys/class/pwm/pwmchipX下的節(jié)點(diǎn)來手動(dòng)輸出PWM測試硬件電路是否正常。內(nèi)核配置確保內(nèi)核配置了CONFIG_BACKLIGHT_PWM和CONFIG_BACKLIGHT_CLASS_DEVICE。5. 常見問題排查實(shí)錄我踩過的那些坑驅(qū)動(dòng)一塊新屏幕幾乎不可能一次成功。下面是我遇到并解決的一些典型問題。5.1 問題一內(nèi)核啟動(dòng)后屏幕完全無反應(yīng)黑屏排查步驟檢查電源用萬用表測量屏幕FPC連接器上的VCC、VCC_IO、RESET、TE等引腳電壓。RESET引腳在啟動(dòng)后應(yīng)為高電平如果配置為低電平復(fù)位。VCC和VCC_IO必須在規(guī)定電壓。檢查背光用手電筒斜著照射屏幕仔細(xì)看。如果能看到非常暗淡的圖像俗稱“鬼影”說明屏幕已經(jīng)點(diǎn)亮只是背光沒開。問題集中在背光驅(qū)動(dòng)電路。查看內(nèi)核日志dmesg | grep -i dsi或dmesg | grep -i panel。關(guān)注是否有“probe failed”、“cannot find panel”等錯(cuò)誤。如果能看到“DSI link probed”、“panel probed”等信息說明驅(qū)動(dòng)加載了。檢查設(shè)備樹綁定使用cat /proc/device-tree/dsi0/panel0/compatible查看內(nèi)核是否成功讀取了你的compatible字符串。如果不匹配驅(qū)動(dòng)不會(huì)綁定。降低難度測試嘗試在設(shè)備樹中注釋掉復(fù)雜的panel-init-sequence只保留最基本的0x11和0x29命令并增加足夠的延遲。排除初始化序列錯(cuò)誤導(dǎo)致屏幕卡死在初始化階段。5.2 問題二屏幕點(diǎn)亮但花屏、閃屏、顏色錯(cuò)亂這是最令人頭疼的情況說明通信通了但參數(shù)不對。首要懷疑對象初始化序列。這是概率最高的原因。序列中的某個(gè)命令參數(shù)不正確導(dǎo)致屏幕控制器狀態(tài)異常。逐一核對序列中的每一個(gè)字節(jié)最好能找到原廠代碼進(jìn)行比對。有時(shí)序列中包含了針對特定批次屏幕的微調(diào)。檢查顯示時(shí)序display-timings參數(shù)錯(cuò)誤會(huì)導(dǎo)致像素采樣錯(cuò)位產(chǎn)生花屏。重點(diǎn)檢查hactive/vactive是否與屏幕物理分辨率一致clock-frequency是否在屏幕支持的范圍內(nèi)?？梢試L試微調(diào)hfront-porch、hsync-len等參數(shù)。檢查數(shù)據(jù)lane配置設(shè)備樹中>