我今年在RK3568開發(fā)板上調(diào)OpenHarmony的時(shí)候最大的感受是這個(gè)系統(tǒng)的資料不少但真正講“怎么下手調(diào)硬件”的內(nèi)容太少了。很多新手拿到一塊板子燒完官方鏡像發(fā)現(xiàn)屏幕沒(méi)畫面、串口沒(méi)輸出、外設(shè)不工作然后就卡死在“問(wèn)社區(qū)、翻文檔、瞎猜”這個(gè)循環(huán)里。這篇就是這個(gè)系列教程的“硬件調(diào)試三板斧”實(shí)戰(zhàn)篇。我會(huì)拆解我實(shí)際調(diào)OpenHarmony時(shí)反復(fù)用到的一套方法論——日志通道、設(shè)備樹適配、最小系統(tǒng)驗(yàn)證這三樣配合起來(lái)能解決絕大多數(shù)硬件適配問(wèn)題。文章里會(huì)用RK3568作為具體載體展開但思路和操作流程同樣適用于其他芯片平臺(tái)。適合正在搞OpenHarmony硬件適配的開發(fā)者也適合剛接觸開源鴻蒙、想從“會(huì)燒鏡像”走向“會(huì)調(diào)硬件”的朋友。讀完你會(huì)有兩方面的收獲一是理解OpenHarmony硬件適配的底層邏輯知道系統(tǒng)從上電到進(jìn)shell的完整流程里每一步是怎么跟硬件相關(guān)的二是拿到一套我在實(shí)際項(xiàng)目里驗(yàn)證過(guò)的操作清單包括設(shè)備樹怎么選、串口日志怎么看、燒錄參數(shù)哪里容易踩坑照著做就能少走很多彎路。1. 先把“三板斧”的思路捋清楚為什么是日志、設(shè)備樹、最小系統(tǒng)我最早接觸OpenHarmony的時(shí)候和大多數(shù)人一樣第一步是拿官方鏡像往板子上燒。燒完確實(shí)能開機(jī)能進(jìn)桌面看起來(lái)一切正常。但一旦你想用自己的板子、自己改的外設(shè)、自己畫的核心板問(wèn)題就來(lái)了——鏡像里的設(shè)備樹跟你的硬件對(duì)不上系統(tǒng)起來(lái)一半就卡住或者某個(gè)外設(shè)完全沒(méi)有反應(yīng)。這時(shí)候最要命的不是“不知道怎么修”而是“不知道從哪里開始查”。整個(gè)系統(tǒng)從Bootloader到內(nèi)核再到用戶態(tài)層層疊疊任何一個(gè)環(huán)節(jié)出問(wèn)題都會(huì)表現(xiàn)為表面上的“起不來(lái)”或者“不動(dòng)了”。如果沒(méi)有一套調(diào)試策略你就會(huì)陷入盲人摸象的狀態(tài)。我把這三年調(diào)OpenHarmony硬件的經(jīng)驗(yàn)歸納成三句話也就是標(biāo)題里說(shuō)的“三板斧”第一板斧打通日志通道讓系統(tǒng)開口說(shuō)話。不管是串口還是hilog先保證你能看到啟動(dòng)過(guò)程里每一步發(fā)生了什么而不是面對(duì)一個(gè)黑屏發(fā)呆。第二板斧把設(shè)備樹(DTS)當(dāng)成硬件的“地圖”先學(xué)會(huì)看懂它、選對(duì)它、改對(duì)它。OpenHarmony的Linux內(nèi)核高度依賴設(shè)備樹來(lái)匹配硬件設(shè)備樹錯(cuò)了后面做什么都是白搭。第三板斧砍到最小系統(tǒng)用最小閉環(huán)驗(yàn)證硬件。不要一上來(lái)就調(diào)顯示、調(diào)Camera、調(diào)Wi-Fi先把CPU、內(nèi)存、串口、GPIO這四樣跑通再逐步往上面加功能。這三板斧不是孤立的技術(shù)點(diǎn)而是一條完整的調(diào)試鏈路。日志讓你看見問(wèn)題設(shè)備樹讓你定位問(wèn)題最小系統(tǒng)讓你隔離問(wèn)題。三者配合才能從“不知道發(fā)生了什么”走到“知道是哪一個(gè)節(jié)點(diǎn)出的問(wèn)題”再走到“確認(rèn)只有這一個(gè)地方有問(wèn)題”。1.1 調(diào)OpenHarmony硬件第一步不是寫代碼而是“看現(xiàn)象”很多人有個(gè)誤區(qū)覺(jué)得硬件調(diào)試就是看芯片手冊(cè)、寫寄存器、改驅(qū)動(dòng)。實(shí)際上在OpenHarmony這種大型系統(tǒng)上絕大部分硬件問(wèn)題在初期都不是通過(guò)讀寄存器發(fā)現(xiàn)的而是通過(guò)觀察“系統(tǒng)在哪一步停了”發(fā)現(xiàn)的。比如同樣表現(xiàn)為“串口沒(méi)有任何輸出”可能是DDR初始化沒(méi)過(guò)可能是bootloader沒(méi)編譯對(duì)可能是串口引腳復(fù)用錯(cuò)了也可能是內(nèi)核沒(méi)起來(lái)。你光看一個(gè)“無(wú)輸出”的現(xiàn)象根本無(wú)法區(qū)分到底是哪一種原因。但如果你把調(diào)試串口接上把啟動(dòng)階段的日志打開你會(huì)發(fā)現(xiàn)卡住的位置是完全不同的有的卡在U-Boot的DDR校準(zhǔn)階段有的卡在內(nèi)核解壓之前有的能走到內(nèi)核啟動(dòng)但掛在某個(gè)驅(qū)動(dòng)的probe上。所以我的習(xí)慣是拿到任何一塊板子第一件事不是急著改代碼而是先搭建“可視化”環(huán)境——板子的串口接出來(lái)燒錄工具準(zhǔn)備好電源和復(fù)位按鍵確認(rèn)清楚確保我能實(shí)時(shí)看到系統(tǒng)每一條啟動(dòng)日志。這一步看起來(lái)不起眼但它決定了你后續(xù)所有調(diào)試動(dòng)作的效率。在OpenHarmony社區(qū)里很多新手發(fā)帖問(wèn)“我的板子起不來(lái)了”結(jié)果圖也不貼、日志也不貼別人根本無(wú)法判斷問(wèn)題出在哪。而老手問(wèn)的第一句話幾乎都是“串口日志發(fā)一下看到哪一步停了”這就是實(shí)踐經(jīng)驗(yàn)上的差距。1.2 每一板斧都有自己的定位和邊界不要混著用日志、設(shè)備樹、最小系統(tǒng)這三者不是替代關(guān)系而是配合關(guān)系各管一段日志負(fù)責(zé)“知情”。它告訴你系統(tǒng)的啟動(dòng)進(jìn)度、驅(qū)動(dòng)的加載結(jié)果、運(yùn)行時(shí)拋出的異常。沒(méi)有日志你就是在黑暗里摸象。設(shè)備樹負(fù)責(zé)“定位”。它描述硬件與驅(qū)動(dòng)的綁定關(guān)系系統(tǒng)為什么找不到這個(gè)設(shè)備、為什么會(huì)用錯(cuò)驅(qū)動(dòng)絕大多數(shù)情況下答案都在設(shè)備樹里。最小系統(tǒng)負(fù)責(zé)“隔離”。當(dāng)你懷疑“是不是某個(gè)外設(shè)把系統(tǒng)拖掛了”的時(shí)候最小系統(tǒng)能最快幫你做排除法。舉個(gè)例子假設(shè)你的板子啟動(dòng)后以太網(wǎng)不通。日志告訴你“eth0 link down”設(shè)備樹檢查發(fā)現(xiàn)mac節(jié)點(diǎn)地址配置的是另外一塊板的MAC地址最小系統(tǒng)驗(yàn)證時(shí)去掉所有無(wú)關(guān)驅(qū)動(dòng)單獨(dú)加載網(wǎng)卡驅(qū)動(dòng)結(jié)果正常。這時(shí)候你就能基本斷定問(wèn)題出在設(shè)備樹MAC節(jié)點(diǎn)配置而不是驅(qū)動(dòng)本身。這樣定位問(wèn)題的時(shí)間可能從一天壓縮到一個(gè)小時(shí)。所以我特別建議在你準(zhǔn)備開始OpenHarmony硬件開發(fā)之前先在腦海里建立這張調(diào)試地圖明確這三板斧各自的使用場(chǎng)景和操作順序而不是哪個(gè)順手用哪個(gè)。1.3 用一個(gè)真實(shí)的“上電黑屏”案例串起整條鏈路為了讓這套方法論更有體感我先說(shuō)一個(gè)我實(shí)際遇到的案例。有一塊基于RK3568的自研板客戶反饋上電后HDMI沒(méi)畫面串口也沒(méi)有任何輸出。當(dāng)時(shí)我接手時(shí)第一反應(yīng)是“串口怎么也沒(méi)輸出這個(gè)不正?！?。我先把調(diào)試串口用USB轉(zhuǎn)串口模塊接上波特率從1500000試到115200發(fā)現(xiàn)完全沒(méi)有數(shù)據(jù)。這就說(shuō)明問(wèn)題出在非常早期——要么DDR初始化沒(méi)過(guò)要么U-Boot壓根沒(méi)跑起來(lái)要么串口引腳配置不對(duì)。然后我去查U-Boot設(shè)備樹發(fā)現(xiàn)這塊板子復(fù)用了參考設(shè)計(jì)的串口引腳但實(shí)際硬件上調(diào)試串口用的是另外一組引腳。改完設(shè)備樹重新編譯U-Boot串口終于能看到啟動(dòng)日志了。結(jié)果日志顯示系統(tǒng)卡在內(nèi)核啟動(dòng)的某個(gè)外設(shè)驅(qū)動(dòng)上于是我又去查內(nèi)核設(shè)備樹發(fā)現(xiàn)藍(lán)牙節(jié)點(diǎn)對(duì)不上硬件。把它在設(shè)備樹里disabled之后系統(tǒng)正常進(jìn)shellHDMI畫面也出來(lái)了。這個(gè)案例里三板斧全部用上了日志讓我知道卡住的位置設(shè)備樹幫我修正引腳和節(jié)點(diǎn)配置最小系統(tǒng)思路讓我把外設(shè)逐個(gè)開關(guān)來(lái)確定問(wèn)題范圍?？梢哉f(shuō)沒(méi)有這套流程這個(gè)問(wèn)題大概率要查兩三天因?yàn)楝F(xiàn)象太具有迷惑性了。2. 第一板斧把日志通道打通讓設(shè)備“開口說(shuō)話”我先把這一板斧放在最前面講因?yàn)槿绻氵B日志都看不到后面說(shuō)的設(shè)備樹和最小系統(tǒng)都是紙上談兵。OpenHarmony的日志體系其實(shí)分兩大塊啟動(dòng)早期用串口UART輸出系統(tǒng)起來(lái)之后用hilog輸出。這兩條通道缺一不可而且都有不少細(xì)節(jié)坑。2.1 串口是底線先保證能看到啟動(dòng)過(guò)程OpenHarmony的調(diào)試串口和Linux的調(diào)試串口邏輯一致從U-Boot階段開始串口就會(huì)持續(xù)輸出啟動(dòng)日志。你需要準(zhǔn)備一個(gè)USB轉(zhuǎn)串口模塊一般用3.3V TTL電平的比較穩(wěn)妥常見的CH340、CP2102都可以。接線就三根GND共地、TX接板子的RX、RX接板子的TX千萬(wàn)別接反。波特率這一塊特別容易踩坑。OpenHarmony在部分平臺(tái)上的默認(rèn)調(diào)試波特率是15000001.5M跟傳統(tǒng)Linux常用的115200不一樣。RK3568官方的U-Boot配置里默認(rèn)就是1500000如果你用115200去連屏幕上什么都看不到或者全是亂碼。我建議把串口工具初始波特率直接設(shè)成1500000如果發(fā)現(xiàn)異常再嘗試115200。另外你的USB轉(zhuǎn)串口模塊最好支持1.5M波特率CH340是支持的但有些老模塊或者仿制模塊在1.5M波特率下穩(wěn)定性很差建議用正品芯片的模塊。接線完成后上電前先在串口工具里打開對(duì)應(yīng)的串口再給板子上電這樣能確保從第一條日志開始就被完整捕獲。如果你上電之后發(fā)現(xiàn)串口完全沒(méi)有數(shù)據(jù)優(yōu)先檢查三件事引腳是否接反、GND是否共地、波特率是否正確。這三項(xiàng)占了串口無(wú)輸出問(wèn)題的大頭。2.2 燒錄到底該用哪個(gè)鏡像先搞懂鏡像分區(qū)的邏輯很多剛接觸OpenHarmony的朋友第一次用燒錄工具時(shí)看到那一堆分區(qū)文件和選項(xiàng)直接懵了。其實(shí)燒錄OpenHarmony鏡像本質(zhì)上就是把幾個(gè)關(guān)鍵鏡像文件寫到板子eMMC對(duì)應(yīng)的分區(qū)里去跟你給電腦裝系統(tǒng)寫ISO是類似的。以RK3568為例OpenHarmony的鏡像文件一般是這樣組織的鏡像文件對(duì)應(yīng)分區(qū)作用bootloader.img/ubootU-Boot引導(dǎo)程序ramdisk.img/ramdisk初始化內(nèi)存文件系統(tǒng)system.img/system系統(tǒng)核心鏡像vendor.img/vendor廠商定制鏡像userdata.img/userdata用戶數(shù)據(jù)分區(qū)resource.img/resource資源文件含開機(jī)logo等在Windows上燒錄一般用RKDevTool需要先把板子切到Loader模式或MaskRom模式。Loader模式通常是按住復(fù)位鍵電源鍵進(jìn)入可以在設(shè)備管理器里看到一個(gè)新的USB設(shè)備。我實(shí)際用下來(lái)的經(jīng)驗(yàn)是如果只是調(diào)試內(nèi)核或設(shè)備樹不一定要全量燒錄可以在RKDevTool里只勾選你修改過(guò)的分區(qū)鏡像比如只燒boot_linux.img這樣能大幅縮短燒錄時(shí)間也降低把系統(tǒng)燒壞的風(fēng)險(xiǎn)。燒錄這塊還有一個(gè)小技巧每次修改設(shè)備樹重新編譯之后生成的boot_linux.img變化其實(shí)很大但很多新手不知道這個(gè)文件還分“標(biāo)準(zhǔn)模式”和“快速啟動(dòng)模式”兩種變體。RK3566/RK3568在部分SDK版本里快速啟動(dòng)鏡像和標(biāo)準(zhǔn)鏡像的加載地址不一樣燒錯(cuò)會(huì)導(dǎo)致內(nèi)核起不來(lái)。我的習(xí)慣是編譯完之后去out目錄下確認(rèn)生成的boot鏡像名稱和路徑不要憑經(jīng)驗(yàn)猜測(cè)因?yàn)镾DK更新后文件名可能變化。2.3 hilog抓取進(jìn)階別只會(huì)看全量日志要學(xué)會(huì)過(guò)濾系統(tǒng)起來(lái)之后串口雖然還能看日志但到用戶態(tài)階段大量日志走的是hilog通道。hilog是OpenHarmony自己的日志系統(tǒng)跟Android的logcat是類似的東西用hilog命令來(lái)抓取。很多新手直接運(yùn)行hilog然后被刷屏什么都看不清。我建議是組合使用這幾個(gè)參數(shù)用-h看幫助用-x過(guò)濾敏感或冗長(zhǎng)日志配合管道grep來(lái)定位關(guān)鍵內(nèi)容。最常用的就是這種格式hilog | grep -iE ERROR|FATAL|appspawn|hdf其中hdf是OpenHarmony的驅(qū)動(dòng)框架日志標(biāo)簽硬件外設(shè)的驅(qū)動(dòng)加載、probe失敗、注冊(cè)失敗都會(huì)在這里打日志。如果你調(diào)的外設(shè)驅(qū)動(dòng)起不來(lái)基本都能在hilog里看到HDF相關(guān)的報(bào)錯(cuò)信息。另外hilog默認(rèn)是存在緩沖區(qū)里的如果系統(tǒng)崩潰重啟之前的日志會(huì)丟失。建議在調(diào)試階段把日志重定向到文件hilog -w core -f /data/log/hilog.log這樣系統(tǒng)即使異常重啟日志也還在文件里不會(huì)因?yàn)橹貑⒕腿珌G了。對(duì)調(diào)試那種“運(yùn)行一會(huì)兒就死機(jī)”的問(wèn)題特別管用。2.4 日志調(diào)試的四個(gè)坑我基本都踩過(guò)第一個(gè)坑是串口輸出不全。有些板卡的調(diào)試串口在內(nèi)核早期是正常的但到了某個(gè)階段突然沒(méi)輸出了這不是系統(tǒng)掛了而是對(duì)應(yīng)的串口驅(qū)動(dòng)被重新初始化了或者引腳被復(fù)用去做其他功能。這種情況我會(huì)在設(shè)備樹里檢查uart節(jié)點(diǎn)的status和pinctrl配置。第二個(gè)坑是日志被大量噪音淹沒(méi)。OpenHarmony開機(jī)時(shí)會(huì)有大量系統(tǒng)服務(wù)日志如果你用串口看會(huì)發(fā)現(xiàn)真正有用的錯(cuò)誤信息被刷得完全看不到。我一般是先用串口確認(rèn)系統(tǒng)能啟動(dòng)到用戶態(tài)然后改用hilog grep來(lái)過(guò)濾關(guān)鍵錯(cuò)誤而不是對(duì)著串口日志硬看。第三個(gè)坑是波特率不匹配導(dǎo)致的“假死”。串口工具能打開、能發(fā)送但收不到任何信息或者全是亂碼很可能只是波特率不對(duì)板子本身是完好的。遇到這種情況先別急著懷疑板子壞了把波特率從1500000切到115200試試再不行就檢查模塊是否支持。第四個(gè)坑是燒錄工具沒(méi)進(jìn)入Loader模式。很多時(shí)候串口日志正常、鏡像編譯正確但燒錄工具就是提示“設(shè)備未找到”或“下載失敗”原因往往是板子沒(méi)有真正進(jìn)入Loader模式。我一般的做法是先斷開USB線按住板子上的loader/recovery按鍵再插入U(xiǎn)SB線最后給板子上電。這個(gè)順序比“先上電再按按鍵”的成功率高很多。3. 第二板斧設(shè)備樹選型和修改別再對(duì)著幾十個(gè)dts發(fā)愁如果只能讓我留一個(gè)OpenHarmony硬件適配的技能我一定選設(shè)備樹。因?yàn)镺penHarmony的上層驅(qū)動(dòng)框架HDF和Linux內(nèi)核的設(shè)備模型都把設(shè)備樹當(dāng)成硬件的“事實(shí)來(lái)源”。很多外設(shè)不工作的根源不是驅(qū)動(dòng)寫得差而是設(shè)備樹里壓根沒(méi)有描述或者描述錯(cuò)了。3.1 理解dts它解決的到底是什么問(wèn)題設(shè)備樹的全稱是Device Tree用dts文件描述編譯后生成dtb文件內(nèi)核啟動(dòng)時(shí)讀取它就知道這臺(tái)機(jī)器有哪些硬件、各自掛在哪、用什么參數(shù)初始化。它本質(zhì)上是一份“硬件配置清單”。你類比一下就懂了。假設(shè)你請(qǐng)了一個(gè)廚師團(tuán)隊(duì)內(nèi)核驅(qū)動(dòng)的集合來(lái)給一桌菜硬件設(shè)備做飯。設(shè)備樹就是菜單告訴廚師今天有哪些食材、什么口味、桌號(hào)怎么分配。如果沒(méi)有菜單廚師就只能按默認(rèn)套路來(lái)遇到?jīng)]見過(guò)的食材就會(huì)一臉蒙——這就是設(shè)備樹缺失時(shí)內(nèi)核的狀態(tài)會(huì)嘗試盲猜硬件猜錯(cuò)了就起不來(lái)或驅(qū)動(dòng)不工作。OpenHarmony選型RK3568這種SoC全志、瑞芯微等廠商會(huì)提供參考設(shè)備樹通常一個(gè)SDK里幾十甚至上百個(gè)dts文件對(duì)應(yīng)不同公板、不同內(nèi)存、不同外設(shè)組合。這些文件就是你在特定板子上干活時(shí)的“基礎(chǔ)菜單”。3.2 RK3568設(shè)備樹到底怎么選一套可落地的判斷流程這個(gè)問(wèn)題是社區(qū)里被問(wèn)爛了的“rk3568有這么多設(shè)備樹到底選哪個(gè)”我分享一下自己的判斷流程基本能做到五分鐘內(nèi)鎖定目標(biāo)。首先看你的板子對(duì)應(yīng)哪個(gè)公板方案。RK3568最常見的參考板是EVB1和EVB2對(duì)應(yīng)的設(shè)備樹一般是arch/arm64/boot/dts/rockchip/rk3568-evb.dts arch/arm64/boot/dts/rockchip/rk3568-evb1-v10.dts arch/arm64/boot/dts/rockchip/rk3568-evb2-lp4x-v10.dtsEVB1和EVB2的主要區(qū)別在DDR類型和布局EVB1常見LPDDR4/LPDDR4XEVB2更常見的是LPDDR4X和DDR4組合。如果你的板子是自研的最好先確認(rèn)硬件當(dāng)初參考的是哪個(gè)公板這個(gè)直接問(wèn)硬件工程師最靠譜。其次看DDR容量和型號(hào)。設(shè)備樹里DDR相關(guān)配置直接決定系統(tǒng)能識(shí)別多大內(nèi)存如果選錯(cuò)往往表現(xiàn)為系統(tǒng)只能看到一半內(nèi)存或者啟動(dòng)時(shí)直接報(bào)內(nèi)存相關(guān)的錯(cuò)誤。打開dts文件后關(guān)注memory節(jié)點(diǎn)、dmc節(jié)點(diǎn)、io-domain節(jié)點(diǎn)這幾個(gè)是DDR配置的常見位置。再一個(gè)是看dts里的compatible字段model Rockchip RK3568 EVB2 LP4X V10 Board; compatible rockchip,rk3568-evb2-lp4x-v10, rockchip,rk3568;這個(gè)compatible是內(nèi)核匹配機(jī)器類型的關(guān)鍵字符串。如果你用的是自研板我建議把model和compatible改成你自己的板名以免后續(xù)跟官方公板混淆。改完之后重新編譯內(nèi)核dtb會(huì)打包進(jìn)boot_linux.img燒錄后生效。最后兩步快速確認(rèn)是否選對(duì)了dts。第一步看啟動(dòng)日志系統(tǒng)起來(lái)后執(zhí)行cat /proc/device-tree/model第二步看實(shí)際識(shí)別到的內(nèi)存和外設(shè)執(zhí)行free -m ls /sys/bus/platform/devices/如果model顯示的就是你期望的板名內(nèi)存也識(shí)別正確那說(shuō)明設(shè)備樹選對(duì)了。反之如果model跟你改的不一樣說(shuō)明boot鏡像里的dtb不是你想要的那份需要檢查編譯流程和燒錄路徑。3.3 改設(shè)備樹最小改動(dòng)原則別一上來(lái)就大改新手最容易犯的錯(cuò)是拿到一個(gè)基于核心板設(shè)計(jì)的自定義底板然后直接在官方dts基礎(chǔ)上大段大段地改最后發(fā)現(xiàn)一堆問(wèn)題根本不知道是哪次改動(dòng)引入的。我的習(xí)慣是一次只改一個(gè)外設(shè)改完立刻編譯、燒錄、驗(yàn)證確認(rèn)沒(méi)問(wèn)題再動(dòng)下一個(gè)。假設(shè)你的底板把LED接到了GPIO0_C5而官方dts里這個(gè)引腳被分配給了別的功能。修改是有套路的第一步在dts里找到這個(gè)引腳的pinctrl配置看看它屬于哪個(gè)pinctrl節(jié)點(diǎn)。第二步把對(duì)應(yīng)的引腳功能改成GPIO可以加一個(gè)led節(jié)點(diǎn)來(lái)實(shí)現(xiàn)leds: leds { compatible gpio-leds; led-user { label user_led; gpios gpio0 RK_PC5 GPIO_ACTIVE_HIGH; linux,default-trigger none; }; };第三步檢查gpio0的IO域電壓配置io-domain確保電壓域跟硬件的實(shí)際電平一致否則GPIO輸出高電平時(shí)的實(shí)際電壓可能是錯(cuò)的LED亮得忽明忽暗甚至完全點(diǎn)不亮。這個(gè)最小改動(dòng)原則看起來(lái)慢實(shí)際上是最快的。因?yàn)镺penHarmony的驅(qū)動(dòng)鏈路過(guò)長(zhǎng)一次改太多東西出了問(wèn)題你根本不知道是哪個(gè)環(huán)節(jié)。3.4 用overlay或config方式管理你的自定義改動(dòng)為了不破壞官方dts的完整性O(shè)penHarmony的編譯系統(tǒng)支持dts overlay機(jī)制。簡(jiǎn)單說(shuō)你可以在不改動(dòng)官方dts文件的前提下通過(guò)一個(gè)dts overlay文件覆蓋或者附加節(jié)點(diǎn)類似給菜單貼便利貼“今天這道菜不加辣”。這個(gè)機(jī)制在SDK里通常叫dtbo也就是device tree overlay的二進(jìn)制格式。具體用法各SDK版本差異較大有的版本是直接在dts目錄下新增deprecated文件有的需要在build配置里聲明。我的建議是如果你對(duì)編譯系統(tǒng)還不太熟先別搞overlay老老實(shí)實(shí)在官方dts文件上改把改動(dòng)記錄到一個(gè)自己的筆記里等以后熟悉編譯流程了再遷移到overlay方案。但有一個(gè)點(diǎn)值得從一開始就養(yǎng)成習(xí)慣所有改動(dòng)盡量加注釋說(shuō)明原因比如/* enable uart0 for debug: modified by xxx */這是因?yàn)樵O(shè)備樹文件會(huì)隨著SDK升級(jí)更新如果你不記錄改動(dòng)原因每次升級(jí)SDK都要重新做一遍適配工作量大得離譜。4. 第三板斧砍到最小系統(tǒng)用最小閉環(huán)驗(yàn)證硬件這一板斧很多人不重視但我覺(jué)得它是三板斧里最體現(xiàn)經(jīng)驗(yàn)含量的一步。OpenHarmony是一個(gè)大型系統(tǒng)跑起來(lái)之后有成百上千個(gè)線程和驅(qū)動(dòng)在同時(shí)工作你根本分不清某一個(gè)問(wèn)題到底是哪個(gè)子系統(tǒng)導(dǎo)致的。最小系統(tǒng)思路就是主動(dòng)砍掉那些干擾項(xiàng)把驗(yàn)證范圍縮小到“CPU內(nèi)存串口一個(gè)GPIO”這么小然后再逐步加回功能。4.1 最小系統(tǒng)到底指什么不是讓你拆芯片這里說(shuō)的“最小系統(tǒng)”不是硬件意義上的“能跑Linux的最小電路”而是軟件調(diào)試意義上的“最小可驗(yàn)證組合”。OpenHarmony的最小系統(tǒng)驗(yàn)證我理解成四步上電能不能啟動(dòng)、串口能不能看到shell、GPIO能不能控制、外設(shè)能不能枚舉。你不需要把板子上所有器件都拆掉只需要在設(shè)備樹里臨時(shí)把那些非必要外設(shè)節(jié)點(diǎn)全部disabled讓系統(tǒng)啟動(dòng)時(shí)不去probe它們就能營(yíng)造一個(gè)“接近最小系統(tǒng)”的環(huán)境。為什么這樣有效因?yàn)镺penHarmony的設(shè)備驅(qū)動(dòng)模型是分層級(jí)的如果某個(gè)外設(shè)的probe函數(shù)在等待一個(gè)永遠(yuǎn)不會(huì)來(lái)的中斷或者某個(gè)驅(qū)動(dòng)的初始化函數(shù)里死循環(huán)了整個(gè)系統(tǒng)都可能卡住但串口日志可能顯示一切正常。這時(shí)候你逐個(gè)打開外設(shè)每開一個(gè)就測(cè)試一次找到那個(gè)讓系統(tǒng)“變質(zhì)”的節(jié)點(diǎn)問(wèn)題就水落石出了。4.2 一個(gè)可參考的最小改動(dòng)路徑從U-Boot到安全進(jìn)入shell以RK3568舉例我一般會(huì)按下面這個(gè)順序做最小系統(tǒng)驗(yàn)證第一步先只燒U-Boot不燒內(nèi)核?？创谀芊窨吹経-Boot的版本信息、DDR初始化是否正確。這一步能確認(rèn)板子的電源、時(shí)鐘、DDR和串口這四個(gè)最基本的部分沒(méi)有問(wèn)題。第二步燒最小內(nèi)核鏡像只保留串口、GPIO和內(nèi)存相關(guān)的配置。這時(shí)系統(tǒng)起來(lái)后會(huì)直接進(jìn)到OpenHarmony的shell雖然沒(méi)有任何圖形界面但能執(zhí)行命令就說(shuō)明CPU和內(nèi)存工作正常。這個(gè)階段我會(huì)用GPIO點(diǎn)個(gè)燈來(lái)確認(rèn)運(yùn)維層也正常。第三步在設(shè)備樹里把外設(shè)逐個(gè)打開每打開一個(gè)就重新編譯燒錄跑一遍基本測(cè)試。比如先打開以太網(wǎng)測(cè)試ping通再打開顯示接口測(cè)試畫面輸出接著是USB、SDIO、Wi-Fi逐個(gè)推進(jìn)。這個(gè)順序我在多個(gè)平臺(tái)驗(yàn)證過(guò)效率很高。因?yàn)閁-Boot階段往往能暴露DDR、電源、晶振這類“硬傷”而且驗(yàn)證成本很低。很多新手喜歡一上來(lái)就跑完整系統(tǒng)結(jié)果U-Boot階段就掛了屏幕一片黑排查難度極大。4.3 三板斧組合起來(lái)實(shí)操順序應(yīng)該按這個(gè)節(jié)奏來(lái)我總結(jié)了一個(gè)適合新手照抄的實(shí)操順序準(zhǔn)備好串口線確認(rèn)波特率上電觀察U-Boot日志。如果U-Boot正常再燒內(nèi)核鏡像進(jìn)系統(tǒng)。系統(tǒng)起來(lái)后第一時(shí)間抓hilog確認(rèn)沒(méi)有FATAL級(jí)別的錯(cuò)誤。在設(shè)備樹里禁用所有非必要外設(shè)只留串口和GPIO確認(rèn)系統(tǒng)穩(wěn)定。逐個(gè)開啟外設(shè)每開一個(gè)就做一輪驗(yàn)證排查引入的問(wèn)題。全部外設(shè)正常后再做整機(jī)穩(wěn)定性測(cè)試和性能測(cè)試。這六步走完一臺(tái)板子的OpenHarmony適配工作基本就落地了。后續(xù)如果還有外設(shè)不工作那基本可以鎖定是該外設(shè)的驅(qū)動(dòng)問(wèn)題跟整體系統(tǒng)環(huán)境無(wú)關(guān)排查范圍就小很多了。5. 常見問(wèn)題速查與避坑筆記我把這段時(shí)間幫朋友和同事排查OpenHarmony硬件問(wèn)題時(shí)遇到的典型問(wèn)題匯總成了速查表方便你對(duì)照參考?，F(xiàn)象可能原因排查方向串口無(wú)任何輸出串口引腳接反/GND沒(méi)共地/波特率不對(duì)檢查TTL接線切換1500000和115200U-Boot啟動(dòng)卡住DDR配置或電源時(shí)序異常檢查dts的dmc和io-domain配置內(nèi)核解壓后立即重啟dtb損壞或Image與dtb不匹配確認(rèn)燒錄的boot鏡像來(lái)源檢查dtb編譯打包路徑進(jìn)系統(tǒng)但外設(shè)不工作設(shè)備樹節(jié)點(diǎn)缺失/status為disabled檢查對(duì)應(yīng)外設(shè)的dts狀態(tài)以及pinctrl、io-domain配置系統(tǒng)跑一會(huì)就卡死某個(gè)驅(qū)動(dòng)probe掛起/硬件看門狗觸發(fā)用最小系統(tǒng)逐個(gè)開關(guān)外設(shè)定位問(wèn)題節(jié)點(diǎn)燒錄工具找不到設(shè)備板子沒(méi)進(jìn)Loader/MaskRom模式按住loader鍵再插USB再上電的次序操作hilog全是噪音沒(méi)有加過(guò)濾參數(shù)用hilog x和grep組合過(guò)濾關(guān)鍵日志系統(tǒng)啟動(dòng)正常但內(nèi)存減半DDR容量或通道配置錯(cuò)誤確認(rèn)memory和dmc節(jié)點(diǎn)配置正確GPIO輸出無(wú)電平io-domain電壓域配置不對(duì)檢查io-domain配置與硬件電壓是否一致HDMI無(wú)畫面顯示控制器節(jié)點(diǎn)未配置/分辨率超范圍檢查display節(jié)點(diǎn)drm日志抓取5.1 一個(gè)特別容易忽略的坑DDR配置和啟動(dòng)時(shí)長(zhǎng)的困惑很多人在調(diào)RK3568時(shí)會(huì)發(fā)現(xiàn)一個(gè)讓人疑惑的現(xiàn)象U-Boot啟動(dòng)DDR初始化階段串口停頓了一段時(shí)間然后突然輸出一大段日志。其實(shí)這是正常的RK3568的DDR訓(xùn)練在校準(zhǔn)讀寫時(shí)序耗時(shí)從幾百毫秒到幾秒不等取決于DDR配置和溫度。但如果停頓時(shí)間特別長(zhǎng)或者干脆卡在DDR初始化不出任何后續(xù)日志那我建議先查DDR類型。同一塊板子如果硬件是按DDR4設(shè)計(jì)的但你設(shè)備樹里用的是LPDDR4的參數(shù)就會(huì)出現(xiàn)DDR初始化異常。這個(gè)問(wèn)題的排查方法很簡(jiǎn)單看硬件原理圖上的DDR型號(hào)絲印再對(duì)照設(shè)備樹里的DDR配置確保一一對(duì)應(yīng)。5.2 我最想強(qiáng)調(diào)的一個(gè)習(xí)慣改動(dòng)留痕版本回退是底牌OpenHarmony本身版本迭代很快編譯系統(tǒng)、目錄結(jié)構(gòu)、鏡像格式都在變。同一個(gè)RK3568項(xiàng)目可能今天用這個(gè)SDK版本三個(gè)月后就升級(jí)到了新版本。如果你在調(diào)試過(guò)程中沒(méi)有對(duì)設(shè)備樹的每次改動(dòng)做記錄升級(jí)SDK時(shí)會(huì)非常痛苦因?yàn)槟愀静恢滥男└膭?dòng)是新版本默認(rèn)就有的哪些是你辛辛苦苦調(diào)出來(lái)的。我現(xiàn)在做OpenHarmony硬件適配一定會(huì)維護(hù)一個(gè)簡(jiǎn)單的“適配變更記錄”文檔記錄每次修改的文件、改動(dòng)內(nèi)容、驗(yàn)證結(jié)果、日期。這個(gè)習(xí)慣救了我很多次看起來(lái)多花了幾分鐘但換來(lái)的是整個(gè)項(xiàng)目周期里的確定性。最后再分享一個(gè)我自己很受用的小技巧每次改完設(shè)備樹重新編譯之前先做一次備份把當(dāng)前能正常啟動(dòng)的boot鏡像保存下來(lái)命名成類似boot_working_20250401.img。這樣即使某次編譯失誤或者配置改錯(cuò)也能在五分鐘內(nèi)回到上一個(gè)穩(wěn)定狀態(tài)不需要重新反推是哪一行代碼的問(wèn)題。搞嵌入式開發(fā)給自己留一條后路永遠(yuǎn)是最聰明的做法。