vendor_opc:基于 OpenHarmony 6.0 的设备适配移植项目

OHOS Porting Communities-开源鸿蒙系统移植社区-vendor整合代码仓

Branch1Tags0
FilesLast commitLast update
2 years ago
1 year ago
1 year ago
11 months ago
1 year ago
1 year ago
2 years ago
2 years ago
1 year ago
2 years ago
2 years ago
1 year ago
11 months ago

OHOS Porting Communities-开源鸿蒙系统移植社区(OPC)

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

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

介绍

该项目介绍,如何编译运行 OpenHarmony 6.0 Release标准系统。

搭建开发环境

1.1 硬件环境

准备一台装有ubuntu20.04系统X86主机,内存最低配置要求16G。

1.2 下载repo脚本文件

  1. 注册码云gitee账号。

  2. 注册码云SSH公钥,请参考码云帮助中心。

  3. 安装git客户端和git-lfs并配置用户信息。

git config --global user.name "yourname"
git config --global user.email "your-email-address"
git config --global credential.helper store
  1. 安装码云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 下载(需注册公钥,请参考码云帮助中心)。

export WORK_SPACE=/home/xxx/OpenHarmony #替换成自己定义的workspace路径
export PROJ_ROOT=$WORK_SPACE/60b1
mkdir $WORK_SPACE
mkdir $PROJ_ROOT
cd $PROJ_ROOT
repo init -u https://gitee.com/ohos-porting-communities/manifest.git -b OpenHarmony-6.0-Release --no-repo-verify
repo sync -c
repo forall -c 'git lfs pull'

1.4 获取编译工具链

参考OpenHamony快速入门文档,基于命令行入门。

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 libelf-dev libxcursor-dev libxrandr-dev libxinerama-dev autoconf automake libtool

1.5 执行prebuilts

在源码根目录下执行脚本,安装编译器及二进制工具。

cd $PROJ_ROOT
bash build/prebuilts_download.sh

代码调整(可选)

根据编译的机型,适当修改源码:


代码修改举例说明:

#香橙派5Plus因为我默认使用了5.5寸LCD触摸屏,HDMI输出会镜像触屏比例显示,显示异常的可以修改以下文件

device/board/opc/opi5plus/kernel/build_kernel.sh
注释掉patch -p1 < ${KERNEL_PATCH_PATH}/0001-enable-lcd.patch

另外根据自己显示器比例修改dpi参数

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


代码编译

3.1 OpenHarmony编译

cd $PROJ_ROOT  


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

#香橙派5Ultra
./build.sh --product-name opi5ultra --ccache

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

#X86 general
./build.sh --product-name x86_general --ccache

#X86 qemu
./build.sh --product-name x86_general --ccache --gn-args=is_qemu=true

编译成功提示:

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 --build-target rpi_image


镜像烧写

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

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

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

x86镜像烧写

使用U盘进行启动:
1、准备一个8G以上高速U盘
2、使用DiskGenius将U盘转换为GUID分区表格式
3、使用DiskGenius分区工具分出4个分区,分区依次如下:(*新建分区时点击详细参数,删除分区名字)
boot	500M	fat32
system	3G	    ext4
vendor	500M	ext4
data	5G	    ext4

4、直接复制device/board/opc/x86_general/loader文件夹内容到boot分区根目录

5、使用Linux的dd命令烧录镜像,用df确认需要烧写的分区,也就是sdx中的x,可能是a、b、c(*Windows可以按照cmder应用实现支持dd命令)
sudo dd if=system.img of=/dev/sdx2 bs=1M
sudo dd if=vendor.img of=/dev/sdx3 bs=1M

6、data分区为格式化空分区

7、插入电脑,BIOS选择U盘启动

X86 QEMU运行

1、到qemu官网下载并安装qemu-w64-setup-20250422.exe或其他版本,qemu加速依赖hyper-v,需自己检查是否打开
2、使用管理员权限打开终端,输入【Set-ExecutionPolicy RemoteSigned】,打开windows powershell
3、新建oh_qemu,oh_qemu/system-image文件夹,
将系统镜像复制到system-image文件夹中,
复制vendor/opc/x86_general/qemu_x86_run_windows.ps1到oh_qemu

目录结构如下

oh_qemu
│  qemu_x86_run_windows.ps1
│
└─system-image
        bzImage
        eng_system.img
        ramdisk.img
        system.img
        updater.img
        userdata.img
        vendor.img

4、运行oh_qemu/qemu_x86_run_windows.ps1

开源许可协议

Apache 2.0

维护者邮箱

开源鸿蒙系统移植社区
598757652@qq.com

Introduction

OHOS Porting Communities-开源鸿蒙系统移植社区-vendor整合代码仓

Customize your domain