OpenHarmony 2.0 如何移植 RK3399
51CTO和華為官方合作共建的鴻蒙技術(shù)社區(qū)
概述
本教程介紹 OpenAtom OpenHarmony(以下簡稱“OpenHarmony”) L2如何快速移植 rk3288/RK3326/RK3399/RK3566 等芯片, 讓開發(fā)者能夠進(jìn)一步開發(fā)和適配 Rockchip 平臺(tái)。
各芯片系統(tǒng)支持狀態(tài)

獲取OpenHarmony L2官網(wǎng)源碼
參考 OpenHarmony官網(wǎng) 獲取最新 master 分支代碼
- repo init -u https://gitee.com/openharmony/manifest.git -b master --no-repo-verify
- repo sync -c
- repo forall -c 'git lfs pull'
獲取Rockchip官方Linux SDK源碼
Rockchip Linux SDK 下載命令如下:

如果您碰到無權(quán)限下載代碼的問題,可訪問:
https://gitee.com/caesar-wang/openharmony-rockchip/issues/I45DEB
編譯說明
OpenHarmony L2 編譯
- bash build/prebuilts_download.sh
- ./build.sh --product-name Hi3516DV300
Rockchip Linux 編譯
- ./build.sh lunch (選擇對(duì)應(yīng)的芯片)
- ./build.sh
RK3399 移植
分區(qū)掛載的處理
- sudo vi init.cfg
- "mount ext4 /dev/block/platform/fe330000.sdhci/by-name/oem /vendor wait rdonly barrier=1",
- "mount ext4 /dev/block/platform/fe330000.sdhci/by-name/userdata /data wait nosuid nodev noatime barrier=1,data=ordered,noauto_da_alloc"
顯示問題
vsync, 請 git apply 打上如下 patch
- patches/
- └── foundation
- └── graphic
- └── standard
- └── vsync.patch
- base commit:
- commit 3301ec6b2669ff1c7014ecbc320dcb41aab16734 (HEAD)
- Merge: 8186179 1441a80
- Author: openharmony_ci <7387629+openharmony_ci@user.noreply.gitee.com>
- Date: Thu Jul 29 08:16:36 2021 +0000
- !16 modify for musl compile
- Merge pull request !16 from huanglei/modify-for-musl-compile
Kernel適配
a. 找到對(duì)應(yīng)設(shè)備
- console:/ $ cat /proc/bus/input/devices
- 找到對(duì)應(yīng)設(shè)備,比如觸摸gsl3673, usb對(duì)應(yīng)的handler event
- I: Bus=0018 Vendor=0000 Product=0000 Version=0000
- N: Name4="gsl3673"
- P: Phys=
- S: Sysfs=/de.vices/platform/ff110000.i2c/i2c-1/91-0040/input/input1
- U: Uniq=
- H: 7 Handlers=event1 cpufreq dmcfreq
- B: PROP=2
- B: EV=10000b
- B: KEY=0
- B: ABS=2658000 0
b. 找到對(duì)應(yīng)設(shè)備. 上面觸摸屏是 event1
- console:/ $ cat /sys/class/input/event1/dev
- 13:65
- 得到從設(shè)備號(hào)是13:65
c. 主設(shè)備號(hào)的文件 data/udev/data/看下有沒有對(duì)應(yīng),沒有的話,copy 一份修改一下比如 tp 修改如下:
- console:/ # cat data/udev/data/c13\:65
- I:1104248553
- E:ID_INPUT=1
- E:ID_INPUT_TOUCHSCREEN=1
調(diào)試工具
- tools/
- ├── busybox
- └── strace
添加工具方便調(diào)試,hilog 也可以調(diào)試
系統(tǒng)分區(qū)說明
鏡像的分區(qū)如下
- ├── MiniLoaderAll.bin
- ├── boot.img
- ├── misc.img
- ├── oem.img
- ├── parameter.txt
- ├── recovery.img
- ├── rootfs.img
- ├── trust.img
- ├── uboot.img
- └── userdata.img
其中 rootfs.img 對(duì)應(yīng) OpenHarmony L2 編譯出來的 system.imgoem.img 對(duì)應(yīng) OpenHarmony L2 編譯出來的 vendor.imguserdata.img 對(duì)應(yīng) OpenHarmony L2 編譯出來的 userdata.img
默認(rèn)分區(qū)說明 ( 下面是 RK3399 IND 分區(qū)參考)

uboot 分區(qū):供 uboot 編譯出來的 uboot.img。
trust 分區(qū):供 uboot 編譯出來的 trust.img。
misc 分區(qū):供 misc.img,給 recovery 使用。
boot 分區(qū):供 kernel 編譯出來的 boot.img。
recovery 分區(qū):供 recovery 編譯出的 recovery.img。
backup 分區(qū):預(yù)留,暫時(shí)沒有用。
oem 分區(qū):供 OHOS 編出來的vendor.img。掛載在 /vendor目錄。
rootfs 分區(qū):供 OHOS 編出來的 system.img。
userdata 分區(qū):供 OHOS 編出來的 userdata.img,掛載在 /data 目錄下。
RK3399EVBIND 固件
預(yù)編好的 Openharmoy L2 固件,適配 RK3399 EVB 行業(yè)版開發(fā)板, 分享如下:
RK3399 EVB IND行業(yè)版-OHOS L2 提取碼: xrry
刷機(jī)說明
RK3399 挖掘機(jī)接口分布圖如下:

RK3399 IND 行業(yè)板接口分布圖如下:

Windows 刷機(jī)說明
SDK 提供 Windows 燒寫工具(工具版本需要 V2.84 或以上),工具位于工程根目錄:
- RK3399_EVB_IND-OHOS_L2-20210810/RKDevTool_Release
如下圖,編譯生成相應(yīng)的固件后,設(shè)備燒寫需要進(jìn)入 MASKROM 或 BootROM 燒寫模式,連接好 USB 下載線后,按住按鍵“MASKROM”不放并按下復(fù)位鍵“RST”后松手,就能進(jìn)入 MASKROM 模式,加載編譯生成固件的相應(yīng)路徑后,點(diǎn)擊“執(zhí)行”進(jìn)行燒寫,也可以按 “recovery" 按鍵不放并按下復(fù)位鍵 “RST” 后松手進(jìn)入 loader 模式進(jìn)行燒寫,下面是 MASKROM 模式的分區(qū)偏移及燒寫文件。(注意:Windows PC 需要在管理員權(quán)限運(yùn)行工具才可執(zhí)行)

注:燒寫前,需安裝最新 USB 驅(qū)動(dòng),驅(qū)動(dòng)詳見:
- tools/DriverAssitant_v5.11.zip
Linux 刷機(jī)說明
Linux 下的燒寫工具位于 tools 目錄下(Linux_Upgrade_Tool 工具版本需要 V1.65 或以上),請確認(rèn)你的板子連接到 MASKROM/loader rockusb。比如編譯生成的固件在 rockdev 目錄下,升級(jí)命令如下:
- sudo ./upgrade_tool ul rockdev/MiniLoaderAll.bin
- sudo ./upgrade_tool di -p rockdev/parameter.txt
- sudo ./upgrade_tool di -u rockdev/uboot.img
- sudo ./upgrade_tool di -t rockdev/trust.img
- sudo ./upgrade_tool di -misc rockdev/misc.img
- sudo ./upgrade_tool di -b rockdev/boot.img
- sudo ./upgrade_tool di -recovery rockdev/recovery.img
- sudo ./upgrade_tool di -oem rockdev/oem.img
- sudo ./upgrade_tool di -rootfs rocdev/rootfs.img
- sudo ./upgrade_tool di -userdata rockdev/userdata.img
- sudo ./upgrade_tool rd
或升級(jí)打包后的完整固件:
- sudo ./upgrade_tool uf rockdev/update.img
或在根目錄,機(jī)器在 MASKROM 狀態(tài)運(yùn)行如下升級(jí):
- ./rkflash.sh
運(yùn)行效果


FAQ
目前發(fā)現(xiàn)存在的一些問題:
1.Launcher顯示顏色反調(diào),需要要求內(nèi)核format更改位DRM_FORMAT_XBGR8888,實(shí)際是 weston 或顯示框架上的問題;
2.vsync 問題,如上顯示補(bǔ)丁 vsync.patch,主要還是框架上的不兼容;
3.OS 對(duì) UI 或框架對(duì)顯示寬需要 16 字節(jié)對(duì)齊,如果遇到寬不是 16 對(duì)齊的分辨率,就會(huì)遇到顯示異常。
TODO
1.適配 Rockchip 的 device 目錄,添加 SOC 內(nèi)核構(gòu)建的子系統(tǒng);
2.使用 OHOS 自帶的 kernel,來適配 Rockchip 平臺(tái);
3.HDF 驅(qū)動(dòng)的移植, LCD、觸摸屏,WiFi 等外設(shè)的適配;
4.Rockchip 音視頻多媒體,圖形加速的適配;
5.Weston 性能、功能優(yōu)化的適配。
51CTO和華為官方合作共建的鴻蒙技術(shù)社區(qū)