鴻蒙移植指南：打包刷機與設(shè)備調(diào)試

上一篇我們?yōu)榇蠹医饣罅?a target="_blank">OpenHarmony 移植為什么這么難？這篇我們將分享打包刷機與簡單設(shè)備調(diào)試。

打包 boot.img 鏡像

boot.img 打包流程如下：

內(nèi)核+設(shè)備樹打包出帶設(shè)備樹的內(nèi)核

設(shè)備樹內(nèi)核+bootimg.cfg+ramdisk.img 打包成 boot.img

①修改內(nèi)核啟動參數(shù)

修改 boot.img 大?。涸鈮撼龅拇笮∈?8m 多，我們的內(nèi)核因為把模塊編譯進內(nèi)核的緣故，容量會增大，導(dǎo)致使用原有配置文件會無法成功打包，所以我們增大到 16m，小米 6 的 boot 分區(qū)有 64m 不會影響 boot.img 的刷入。

bootsize=0x1000000

修改并添加內(nèi)核啟動參數(shù)：

cmdline=clk_ignore_unusedconsole=tty1console=ttyGS0,115200no_console_suspendhardware=sagitdefault_boot_device=1da4000.ufshcohos.required_mount.system=/dev/block/platform/soc/1da4000.ufshc/by-name/system@/usr@ext4@ro,barrier=1@wait,requiredohos.required_mount.vendor=/dev/block/platform/soc/1da4000.ufshc/by-name/cust@/vendor@ext4@ro,barrier=1@wait,required

其中 hardware 和 default_boot_device 為 OH 初始化時用于識別設(shè)備的參數(shù)，實測不配置也不影響啟動。

hardware=sagitdefault_boot_device=1da4000.ufshc

ohos.required_mount.system 和 ohos.required_mount.vendor 是 OH 啟動必須掛載的兩個分區(qū)，必須進行配置。

ohos.required_mount.system=/dev/block/platform/soc/1da4000.ufshc/by-name/system@/usr@ext4@ro,barrier=1@wait,requiredohos.required_mount.vendor=/dev/block/platform/soc/1da4000.ufshc/by-name/cust@/vendor@ext4@ro,barrier=1@wait,required

console=tty1 是為啟動日志輸出到屏幕，后續(xù)可以進行觀察 OH 的渲染框架是否接管屏幕 console=ttyGS0,115200 為開啟串口控制臺，后續(xù)方便進行輸入命令，進行 debug 調(diào)試等。 其他可按需配置，啟動參數(shù)參考標(biāo)準(zhǔn) Linux。

②打包帶設(shè)備樹的內(nèi)核

命令如下，直接用 cat 命令，把內(nèi)核和設(shè)備樹二進制文件直接輸出成 Image.gz-dtb。

cat${KERNEL_IMAGE_FILE}${DTB}>"${OUT_PKG_DIR}/Image.gz-dtb"

③打包 boot.img

命令如下，使用 abootimg 工具，--create 指定進行 boot.img 創(chuàng)建的位置，-f 指定 bootimg.cfg 位置，-k 指定帶設(shè)備樹內(nèi)核的位置，-r 指定 ramdisk.img 的位置。

abootimg--create"${OUT_PKG_DIR}/boot.img"-f${BOOTCFG}-k"${OUT_PKG_DIR}/Image.gz-dtb"-r"${OUT_PKG_DIR}/ramdisk.img"

OH 的編譯框架已經(jīng)幫我們打包好了 system.img 和 vendor.img，在 out/packages/phone/images 中，復(fù)制 boot.img，system.img 和 vendor.img 到電腦中，準(zhǔn)備進行刷機工作。

注意：刷機會格式化手機，請使用備用機進行刷機，刷機前有需要的話請把手機的數(shù)據(jù)復(fù)制到電腦，刷機有風(fēng)險，請自行判斷，變磚概不負(fù)責(zé)?。?！

刷入鏡像

①TWRP 刷入鏡像

按音量鍵上+電源開機進入 TWRP，這時 TWRP 會進入 MTP 模式，把刷機鏡像復(fù)制進手機。

選擇安裝：

選擇刷入鏡像，這時才會顯示我們的刷機文件：

選擇 boot.img，選擇 boot 分區(qū)：

滑動確認(rèn)刷入：

按兩次返回，選擇 system.img，選擇 system 分區(qū)：

同樣按兩次返回，選擇 vendor.img，選擇 vendor 分區(qū)： 回到主頁，選擇清除，選擇格式化 Data 分區(qū)：

輸入 yes，格式化完成后重啟：

②fastboot 刷入鏡像

按音量鍵下+開機鍵進入 fastboot 模式，連接電腦，裝好驅(qū)動，使用以下命令進行刷機：

fastbootflashboot（boot.img的路徑）
fastbootflashsystem（system.img的路徑）
fastbootflashvendor（vendor.img的路徑）
fastbooteraseuserdata
fastbootreboot

簡單調(diào)試經(jīng)驗分享

①設(shè)備不斷重啟

上篇文章中我們配置了 usb 串口，如果內(nèi)核驅(qū)動正常的話手機使用 usb 連接電腦會自動識別為 com 設(shè)備，這時我們使用 xshell，mobaxterm 等工具查看串口日志。 比如一般不斷重啟是因為 render_service 的崩潰，渲染服務(wù)是關(guān)鍵服務(wù)，OH 設(shè)置了崩潰會自動重啟：

為了調(diào)試我們先更改一下設(shè)置，讓它不自動重啟，找到渲染服務(wù)的配置，把 critical 第一個參數(shù)從 1 改成 0，這樣就不會自動重啟了。

②使用 modetest 測試 DRM 驅(qū)動

要使 OH 能順利點亮，我們首先要確認(rèn)內(nèi)核 DRM 驅(qū)動是否正常工作，這里我使用的是 modetest 進行測試。 modetest 的代碼已經(jīng)存在 libdrm 的倉庫中，但是沒有加入 OH 的編譯框架，有需要的同學(xué)可以參考我移植樹莓的 board 倉，里面的 test 文件夾中有寫好的配置。

編譯好 modetest 之后直接運行是沒有效果的，因為 OH 的渲染服務(wù)占用了顯卡，我們先把渲染服務(wù)關(guān)閉：

service_controlstoprender_service

關(guān)閉渲染服務(wù)之后，我們運行 modetest，modetest 會遍歷設(shè)備所有的顯卡，并打印出信息：

modetest

查看 log：

......
tryingtoopendevice'msm'...done
Encoders:
idcrtctypepossiblecrtcspossibleclones
3181DSI0x000000010x00000001

Connectors:
idencoderstatusnamesize(mm)modesencoders
3231connectedDSI-164x114131
modes:
indexnamerefresh(Hz)hdisphsshsehtotvdispvssvsevtot)
#01080x192060.0010801200121612561920192419261930145444flags:;type:preferred,driver
......

我們可以找到，我們的驅(qū)動模塊名為 msm，Connector id 為 32，mode 名為 1080x1920。

查看 modetest 支持的命令，配置這兩個參數(shù)：

-Mmoduleusethegivendriver
-s[,][@]:[#][-][@]setamode

我的命令簡化為：

modetest-Mmsm-s32:1080x1920

運行命令后，手機屏幕顯示出顏色條紋，即為 DRM 驅(qū)動工作正常：

③OH 渲染框架調(diào)試

配置 hilog 打印等級，啟動屏幕調(diào)試 hilog 打?。?/p>

使用命令啟動渲染服務(wù)，并過濾只顯示 display 相關(guān)的內(nèi)容：

hilog-D0xD001400&service_controlstartrender_service

打通串口并能顯示 log 信息之后就是各種調(diào)試代碼了，這部分操作就跟開發(fā)板差不多了，接下去就是對照 log 跟代碼不斷拉扯了，教程只能到這里了，祝各位調(diào)試順利。

審核編輯：湯梓紅