README.md · OHOS Porting Communities/vendor_opc

# OHOS Porting Communities-开源鸿蒙系统移植社区（OPC）

目前该仓库存放有以下设备适配代码：  
树莓派4B  
小米6  
小米POCO F1  
香橙派5Plus  
FILY F12

<mark>**最新版本适配情况请查看组织首页状态**<mark>

#### 介绍
该项目介绍，如何编译运行 [OpenHarmony 4.1 Release](https://gitee.com/openharmony/docs/blob/master/zh-cn/release-notes/OpenHarmony-v4.1-release.md)标准系统。

# 搭建开发环境
## 1.1 硬件环境
准备一台装有ubuntu20.04系统X86主机，内存最低配置要求16G。 
## 1.2 下载repo脚本文件
1. 注册码云gitee账号。

2. 注册码云SSH公钥，请参考[码云帮助中心](https://gitee.com/help/articles/4191)。

3. 安装[git](https://git-scm.com/book/zh/v2/%E8%B5%B7%E6%AD%A5-%E5%AE%89%E8%A3%85-Git)客户端和[git-lfs](https://gitee.com/vcs-all-in-one/git-lfs?_from=gitee_search#downloading)并配置用户信息。
```
git config --global user.name "yourname"
git config --global user.email "your-email-address"
git config --global credential.helper store
```
4. 安装码云repo工具，可以执行如下命令。
```
curl -s https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 > /usr/local/bin/repo  
pip3 install -i https://repo.huaweicloud.com/repository/pypi/simple requests
```
如果没有权限，可下载至其他目录，并将其配置到环境变量中chmod a+x /usr/local/bin/repo
```
mkdir ~/bin
curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 -o ~/bin/repo 
chmod a+x ~/bin/repo
pip3 install -i https://repo.huaweicloud.com/repository/pypi/simple requests
```
```
vim ~/.bashrc               # 编辑环境变量
export PATH=~/bin:$PATH     # 在环境变量的最后添加一行repo路径信息
source ~/.bashrc            # 应用环境变量
```

## 1.3 获取OpenHarmony标准系统源码
通过repo + ssh 下载（需注册公钥，请参考[码云帮助中心](https://gitee.com/help/articles/4191)）。

```
export WORK_SPACE=/home/xxx/OpenHarmony #替换成自己定义的workspace路径
export PROJ_ROOT=$WORK_SPACE/4.1-Release
mkdir $WORK_SPACE
mkdir $PROJ_ROOT
cd $PROJ_ROOT
repo init -u https://gitee.com/openharmony/manifest.git -b OpenHarmony-4.1-Release --no-repo-verify
repo sync -c
repo forall -c 'git lfs pull'
```
## 1.4 获取编译工具链
参考[OpenHamony快速入门文档](https://gitee.com/openharmony/docs/tree/master/zh-cn/device-dev/quick-start)，基于命令行入门。
```
sudo apt-get update && sudo apt-get install binutils git git-lfs gnupg flex bison gperf build-essential zip curl zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z1-dev ccache libgl1-mesa-dev libxml2-utils xsltproc unzip m4 bc gnutls-bin python3.8 python3-pip ruby default-jdk libssl-dev libtinfo5 genext2fs u-boot-tools mtools mtd-utils scons gcc-arm-none-eabi abootimg
```
## 1.5 执行prebuilts
在源码根目录下执行脚本，安装编译器及二进制工具。
```
cd $PROJ_ROOT
bash build/prebuilts_download.sh
```

# 设备代码下载与整合
## 2.1 下载适配源码
进到项目根目录，下载设备源码：
```
git clone -b OpenHarmony-4.1-Release https://gitee.com/ohos-porting-communities/vendor_opc.git vendor/opc
git clone -b OpenHarmony-4.1-Release https://gitee.com/ohos-porting-communities/device_board_opc.git device/board/opc
git clone -b OpenHarmony-4.1-Release https://gitee.com/ohos-porting-communities/device_soc_opc.git device/soc/opc

#下载香橙派5Plus内核
git clone -b OpenHarmony-4.1-Release https://gitee.com/ohos-porting-communities/linux_5.10_opi.git kernel/linux/linux-5.10-opi

#下载FILY F12内核
git clone -b OpenHarmony-4.1-Release https://gitee.com/ohos-porting-communities/kernel_linux_5.10_f12.git kernel/linux/linux-5.10-f12

#使用Linux6.6内核
git clone -b master https://gitee.com/openharmony/kernel_linux_6.6.git kernel/linux/linux-6.6

#暂不需要
git clone -b master https://gitee.com/ohos-porting-communities/os-openharmony-third-party-bluez.git third_party/bluez
git clone -b master https://gitee.com/ohos-porting-communities/os-openharmony-third-party-pciids.git third_party/pciids
git clone -b master https://gitee.com/ohos-porting-communities/os-openharmony-third-party-libpciaccess.git third_party/libpciaccess
git clone -b master https://gitee.com/ohos-porting-communities/os-openharmony-third-party-minigbm.git third_party/libminigbm
git clone -b master https://gitee.com/mirrors_intel/os-openharmony-third-party-mesa3d.git third_party/mesa3d_intel

git clone https://github.com/intel/libva.git third_party/libva
cd third_party/libva
git reset --hard 1b7d71f68b6ebc7f7c3b80e3eb6b3d888b0463e1
cd -

git clone https://github.com/intel/gmmlib.git third_party/gmmlib
cd third_party/gmmlib
git reset --hard dcc4b85ea3728c848b62fbb164c00f43b519b6fb
cd -

git clone https://github.com/intel/media-driver.git third_party/media-driver
cd third_party/media-driver
git reset --hard 788f0e79716726c17983eacf325fc90b3b3fa009
cd -

git clone https://github.com/projectceladon/libvpl.git third_party/oneVPL
cd third_party/oneVPL
git reset --hard 82449730c6019412c62f061fca31bd17f2c692df
cd -

git clone -b main https://github.com/intel/vpl-gpu-rt.git third_party/oneVPL-Intel-GPU

rm -rf third_party/libjpeg-turbo
git clone https://github.com/libjpeg-turbo/libjpeg-turbo.git third_party/libjpeg-turbo
cd third_party/libjpeg-turbo
git reset --hard 6c610333497302c52ff36046f9ff72f0c3a6dc2e
cd -

rm -rf third_party/x264
git clone -b master https://code.videolan.org/videolan/x264.git third_party/x264

rm -rf third_party/ffmpeg
git clone https://git.ffmpeg.org/ffmpeg.git third_party/ffmpeg
cd third_party/ffmpeg
git reset --hard 7e0d640edf6c3eee1816b105c2f7498c4f948e74
cd -

```
### 根据编译的机型，选择合并补丁或适当修改源码：
```
补丁和说明放置在device/board/opc/common/patches目录下

OpenHarmony4.1Release编译64位版本系统有众多编译错误，
oh4.1_fix.diff补丁为必要修复

代码修改说明：

#香橙派5Plus因为我使用的显示器为4k分辨率，dpi参数较高，
编译前需要修改以下文件，修改dpi参数

vendor/opc/opi5plus/custom_conf/window/display_manager_config.xml

```

# 代码编译
## 3.1 OpenHarmony编译  
```
cd $PROJ_ROOT

#香橙派5Plus
./build.sh --product-name opi5plus --ccache --no-prebuilt-sdk

#FILY F12
./build.sh --product-name f12 --ccache --no-prebuilt-sdk

#X86 pocket2
#首次编译前执行一次合入补丁命令
cd vendor/opc/pocket2/patches
./patch.sh

./build.sh --product-name pocket2 --ccache

```
 编译成功提示:
```
post_process
=====build opi5plus successful.
```

编译生成的文件
```
$PROJ_ROOT/out/opi5plus/packages/phone/images/system.img 
$PROJ_ROOT/out/opi5plus/packages/phone/images/vendor.img
$PROJ_ROOT/out/opi5plus/packages/phone/images/userdata.img
$PROJ_ROOT/out/opi5plus/packages/phone/images/ramdisk.img
```

~~## 3.2 额外镜像编译
编译好OpenHarmony的文件之后使用以下命令内核并打包手机boot.img/树莓派4B完整镜像~~
```
#小米POCO F1
cd device/board/opc/beryllium/kernel
./build_kernel.sh

#小米6
cd device/board/opc/sagit/kernel
./build_kernel.sh

#树莓派4B
./build.sh --product-name rpi4 --ccache --no-prebuilt-sdk --build-target rpi_image

```

# 镜像烧写
手机镜像参考我的文章使用twrp刷入或者bootloader线刷  
https://ost.51cto.com/posts/20924

树莓派4B使用Win32DiskImager烧录整合好的rpi_image.img到microSD卡中

香橙派5Plus和FILY F12参考主线设备rk3568的说明文档使用RKDevTool烧写

# 开源许可协议  
Apache 2.0

# 维护者邮箱 
开源鸿蒙系统移植社区  
598757652@qq.com

OHOS Porting Communities/vendor_opc

简介

发行版

贡献者

近期动态

OHOS Porting Communities/vendor_opc .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

OHOS Porting Communities/vendor_opc