鴻蒙富設備移植指南：編譯框架適配

上一篇我們成功將 OpenHarmony 移植到小米 6 手機上，今天給大家講解 OpenHarmony 編譯部分。

OH 編譯框架適配

特別說明：OH 3.2 beta4 我移植過多款設備，輸入子系統會開機崩潰，還沒找到具體原因。

移植的時候 OH 3.2 beta5 還沒出來了，所以小米 6 先以樹莓派移植時比較順利的 OH 3.2 beta3 版本進行移植，勇于嘗試的同學可以基于最新的 OH3.2 beta5 版本。

修改編譯框架需要 GN 相關的知識，同時社區也有豐富的文章講解鴻蒙的編譯框架，有疑問時可以先查看社區文章進行學習。

OH 編譯框架適配新設備時，在 3.2 版本的前提下，需要新增 3 個文件夾，以下為我適配小米 6 的目錄：

/device/board/xiaomi/sagit

/device/soc/qualcomm/

/vendor/xiaomi/sagit

基本配置思路是參考官方開發板，復制 hihope 的 rk3568，替換成自己的，比如小米 6 的代號是 sagit，需要把 rk3568 替換成 sagit。

以下進行簡單舉例，詳細移植方法之前有發過移植適配的文章，可以先看，別的大神也都發過，編譯框架的移植適配套路都差不多，在此不再重復講解，文章中的代碼是 beta1 的，查看代碼倉時請切換到 beta3 分支。

https://ost.51cto.com/posts/14280

修改配置文件：config.json；修改 GN 編譯文件：各級目錄下的 x.gn，x.gni，x.build。

config.json 舉例：

.build 文件舉例：

.gn 文件文件舉例：

定制部分可以先不做，先把編譯需要的文件補充完整，并修改替換掉必要的部分：

hihope--->xiaomi

rk3568--->sagit（soc目錄下是rk3568--->msm8998）

rockchip--->qualcomm

./build.sh--product-namesagit--ccache

修改時會不斷有修改漏的或者錯的地方，沒有經驗的話可能會花比較長的時間，新手需要注意，成功的標志是編譯完成并顯示 build successful。

OH編譯框架定制

①vendor 部分的定制修改

OH 編譯的起點是從 vendor 下的 config.json 開始的，我們首先進行這個配置文件的修改，首先加密相關的這兩個選項關掉，降低移植難度。

ril 蜂窩網絡相關，xiaomi6 沒有驅動進行使能，去掉，新增 graphic 配置，覆蓋掉 rich.json 繼承過來的配置，配置關閉 gpu 渲染。

ab 分區啟動不適配，設置成 false：

config.json 可以在 subsystems 內配置完所有組件，但是那樣組件列表會很長。 不同的設備配置會有大量重復的配置，所以大部分重復的組件都添加到了 rich.json 這個文件中，源碼在 productdefine/common/inherit 下，方便開發者繼承引用。 如果開發者需要定制某項組件的屬性，只要像我一樣在產品的 config.json 中再聲明一遍即可覆蓋，其他文件沒有特別需要定制修改的地方，這里不再做講解。

②board 部分的定制修改

在 board 中，我刪掉了 bootanimation，updater，定制了 kernel，增加了 frimware，test。 刪掉 bootanimation 是因為這個是廠商根據 OH 動畫生成工具生成的動畫，我不需要定制開機畫面所以去掉了 bootanimation，updater 也是一樣，我不需要更新分區，所以不需要配置也刪掉了。 我也定制了 kernel 的編譯方式，因為 OH 官方的編譯方式是從 board 倉中統一轉到 kernel/linux/build 下，調用里面的編譯腳本，采用官方 OH 內核+soc 廠商 patch+config 的形式進行編譯。 我是采用第三方內核的方式進行移植，所以不適用官方的編譯方式，需要自己定制編譯腳本。

增加 frimware 是為了在 ramdisk 中添加驅動固件，test 是自己找的一些測試例子，用來輔助移植。

定制 kernel 編譯方式，官方的編譯方式可以概括為：

復制 kernel 源碼到 out/KERNEL_OBJ/kernel/src_tmp 目錄下

打上 hdf.patch（使內核支持 hdf 驅動框架）

打上 soc.patch（使內核支持對應的芯片平臺）

復制 config（復制對應芯片平臺的內核配置到 out 下的 kernel 目錄）

編譯內核，設備樹

我是參考了官方的 build 方式，精簡不用的判斷，定制了自己的編譯方式，概括為：

復制我定制的 kernel 源碼到 out/KERNEL_OBJ/kernel/src_tmp 目錄下

打上 hdf.patch（使內核支持 hdf 驅動框架）

復制 config（修改復制為放置在我 board 倉下的 config）

編譯內核，設備樹

內核源碼我是采用了 pmOS 的 msm8998 的主線代碼：

QualcommSnapdragon835Mainline/Linux·GitLab

https://gitlab.com/msm8998-mainline/linux

克隆代碼到 kernel 目錄下：

gitclonehttps://gitlab.com/msm8998-mainline/linux.git-bmainline/6.0linux-sagit

定制 ramdisk：把上一篇解包得到的固件放到源碼目錄中。

新建 BUILD.gn，每個文件都寫一個配置：

四個文件寫完配置之后放到一個分組里：

對應到上層目錄的 BUILD.gn：

定制分區配置：根據上一篇我們獲取到的分區信息，修改分區配置，另外 rk3568 的 data 分區采用 f2fs 格式，我們采用 ext4 格式。

所以和采用的是舊的格式，可以參考 fstab.A311D 的配置。

定制 test：這個目錄下是我自己添加的輔助移植測試顯示基本功能的例子，來源自【何小龍】的 drm 系列文章，用于學習 drm 和測試顯示屏驅動，大家感興趣的話可以去看看何小龍的文章。

不懂如何添加到 OH 編譯框架的話可以去我開源的樹莓派 board 倉參考：

https://gitee.com/diemit/device_board_raspberrypi/tree/OpenHarmony-3.2-Beta4/rpi4/test

③soc 部分的定制修改

soc 目錄是為了適配各種硬件的比如顯示，GPU，WIFI 等待，這里我只定制了 display，目標不要太大，使用 cpu 渲染適配 display 就可以顯示開機了。

display 源碼是采用 OH 官方的示例，源代碼在： 直接復制到 qualcomm/msm8998/hardware 下并改名成 display。

修改 drm_display.cpp 文件：修改 drm 驅動名稱為【msm】。

驅動名新手可能怎么找可能會比較懵，可以進入內核源碼目錄下的 driver/gpu/drm/ 對應的 gpu，找到有 xxxdrv.c 的文件，找到 drm_driver 結構體，找到 name 屬性。

樹莓派的 gpu 是 vc4：

高通的是 msm：

修改 drm_allocator.cpp 文件：注釋掉海思的私有函數，我們不需要，順便刪掉 hisilicon_drm.h 的引用和 hisilicon_drm.h 文件。

添加 display_gfx.c 文件：內部不用實現，這部分是 2d 圖形加速適配的，先不適配。

修改 BUILD.gn 文件：修改基本原則是把 def 去掉，include 改為自己的目錄。

display_device 需要部分修改適配，根據樹莓派移植經驗。

添加 display_gfx 的動態庫編譯配置：

display 這部分的移植都可以參照我之前移植樹莓派的教程，源碼也開源的，這里只是部分講解，完整代碼請去代碼倉查看。 至此 OH 編譯框架適配說明完畢，執行編譯命令，確保能夠編譯成功?。?！ 下一篇將進行 Linux 內核的定制適配和 boot.img 打包，敬請期待！

審核編輯：湯梓紅