# Phytium-OpenHarmony-Device

**Repository Path**: rk3568_awtk/phytium-openharmony-device

## Basic Information

- **Project Name**: Phytium-OpenHarmony-Device
- **Description**: 该项目介绍，如何在飞腾信息科技有限公司SOC硬件平台上运行 OpenHarmony 标准系统OpenHamony 4.1 release。其中腾锐D系列芯片没有图形模块，需要搭配GPU使用，目前仓库中支持的显卡包含飞腾X100套片、AMD显卡、JM9100显卡。
支持GPU图形硬件加速，以及X100提供的视频解码硬件加速。
支持Linux kernel 5.10。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 30
- **Created**: 2024-12-14
- **Last Updated**: 2024-12-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Phytium OpenHarmony Device 项目
<BR/>

# 简介

## 项目简介

该项目介绍，如何在飞腾信息科技有限公司SOC硬件平台上运行 OpenHarmony 标准系统[OpenHamony 4.1 release](https://gitee.com/openharmony/docs/blob/master/zh-cn/release-notes/OpenHarmony-v4.1-release.md)。其中腾锐D系列芯片没有图形模块，需要搭配GPU使用，目前仓库中支持的显卡包含飞腾X100套片、AMD显卡、JM9100显卡。  
支持GPU图形硬件加速，以及X100提供的视频解码硬件加速。  
支持Linux kernel 5.10。

## 飞腾公司简介
飞腾信息技术有限公司（以下简称“飞腾公司”）是国内领先的自主核心芯片提供商，由中国电子信息产业集团、天津市滨海新区政府和天津先进技术研究院于2014年联合支持成立。详情请参考[飞腾官网](https://www.phytium.com.cn/homepage/index/)介绍。

* [芯片简介](./device_soc_phytium/README.md)
* [开发板简介](./device_board_phytium/README.md)

## 目录结构

```
├── device_board_phytium    #飞腾开发板代码仓库
├── device_soc_phytium      #飞腾芯片代码仓库
├── phytium_env.sh          #自动化合patch脚本
├── vendor_phytium          #飞腾开发板方案定制代码仓库
├── FAQ                     #编译集成常见问题
└── ...
```
<BR/>

# 搭建开发环境
以腾锐D系列为例。

## 1.1 硬件环境

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

## 1.2 下载repo脚本文件

1. 注册码云[gitee](https://gitee.com/signup?redirect_to_url=%2Fdashboard)账号。
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 "your-name"
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  
chmod a+x /usr/local/bin/repo
pip3 install -i https://repo.huaweicloud.com/repository/pypi/simple requests
```

> 注：如果没有访问/usr/local/bin/目录的权限，可将repo下载至其他目录，并将其配置到环境变量。

## 1.3 获取OpenHarmony标准系统源码

通过repo + ssh 下载源码。

```
export WORK_SPACE=/home/xxx/workspace #替换成自己定义的workspace路径
export PROJ_ROOT=$WORK_SPACE/OpenHarmony
mkdir $WORK_SPACE
mkdir $PROJ_ROOT
cd $PROJ_ROOT
repo init -u https://gitee.com/openharmony/manifest -b refs/tags/OpenHarmony-v4.1-Release --no-repo-verify
repo sync -c
repo forall -c 'git lfs pull'
```

## 1.4 获取编译工具链

使用安装包方式获取编译工具链。

```
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 openjdk-11-jdk libtinfo5 npm dosfstools parted kpartx genext2fs libxt-dev libx11-dev xorg-dev mtools
```

## 1.5 执行prebuilts

进入OpenHarmony源码根目录，执行脚本，安装编译器及二进制工具。

```
cd $PROJ_ROOT
bash build/prebuilts_download.sh
```

# 飞腾设备代码下载与整合

## 2.1 下载phytium device源码

创建一个本地目录，然后将phytium device源码下载到该目录。

```
export PHY_DEV=$WORK_SPACE/phytium_device
mkdir $PHY_DEV
cd $PHY_DEV
git clone git@gitee.com:phytium_embedded/phytium-openharmony-device.git
```

## 2.2 整合内核源码
D系列cpu通用内核已开源，但是其设备树，以及X100的内核源码未开源。如果使用Uboot，或者X100，需要邮件联系phytium嵌入式软件部(linan1284@phytium.com.cn)获取。  
```
设备树文件放置位置：device_board_phytium/common/kernel_source/dts/phytium
X100驱动放置位置：vendor_phytium/gpu_model/x100/kernel_source
```

## 2.3 整合phytium device源码

执行phytium_env.sh脚本，将phytium device代码，以及针对openharmony修改的patch集成到OpenHarmony中。

```
./phytium_env.sh  $PROJ_ROOT 0
THE OHOS_PATH_ROOT: /home/xxx/workspace/OpenHarmony
THE DEVICE:         tengrui_d(0)
 #### sync phytium env start！ ####
 #### sync device_soc_phytium  ####
 #### sync device_soc_phytium end  ####
 #### sync device_board_phytium  ####
 #### sync device_board_phytium end  ####
 #### sync vendor_phytium  ####
 #### sync vendor_phytium end  ####
...
...
 #### sync phytium end！ ####

```

> 这里我们需要传入两个参数：
> 第一个是鸿蒙的根目录。
> 第二个是指设备ID，0对应tengrui_d；1对应tenglong_e；2对应phytiumpi-firefly

>注：phytium_env.sh支持清除工程中飞腾相关代码的功能：./phytium_env.sh $PROJ_ROOT 0 1

## 2.4 适配fstab文件

确认存储介质的类型，参考wiki文档[Openharmony多种存储介质配置说明](https://gitee.com/phytium_embedded/phytium-openharmony-device/wikis/%E9%95%9C%E5%83%8F%E7%94%9F%E6%88%90%E4%B8%8E%E7%83%A7%E5%BD%95/Openharmony%E5%A4%9A%E7%A7%8D%E5%AD%98%E5%82%A8%E4%BB%8B%E8%B4%A8%E9%85%8D%E7%BD%AE%E8%AF%B4%E6%98%8E)，根据自己需求修改fstab文件。

# 代码编译

## 3.1 编译OpenHarmony源码

不同显卡目前驱动无法兼容，在编译时需要根据不同硬件添加对应的参数 --gn-args gpu_model=xxx
```
cd $PROJ_ROOT

#### 如果显卡是X100
./build.sh --product-name tengrui_d --ccache --target-cpu arm64 --gn-args gpu_model=x100

#### 如果显卡是AMD
./build.sh --product-name tengrui_d --ccache --target-cpu arm64 --gn-args gpu_model=amd

#### 如果显卡是JM9100
./build.sh --product-name tengrui_d --ccache --target-cpu arm64 --gn-args gpu_model=jm
```

 编译成功提示:

```
post_process
=====build tengrui_d successful.
```

编译生成的文件

```
$PROJ_ROOT/out/tengrui_d/packages/phone/images/boot_uboot.img
$PROJ_ROOT/out/tengrui_d/packages/phone/images/boot_efi.img
$PROJ_ROOT/out/tengrui_d/packages/phone/images/system.img
$PROJ_ROOT/out/tengrui_d/packages/phone/images/vendor.img
$PROJ_ROOT/out/tengrui_d/packages/phone/images/ramdisk.img
```
>注：
>1. boot_uboot.img和boot_efi.img，分别对应uboot启动和UEFI启动的boot分区镜像。
>2. boot分区镜像中主要包含内核镜像Image，ramdisk.img，以及uboot启动必备的设备树文件，UEFI启动必备的引导文件。如果内核源码中缺少设备树文件源文件，不会编译生成设备树文件，boot_uboot.img也就不会生成。


# 镜像烧写

## 4.1 硬盘分区

准备一块SATA硬盘，删除原有分区后，在linux下，使用fdsik命令分区，创建4个分区，依次为boot，system，vendor，userdata，根据实际情况设定，比如可以设定为64M，1.5G，500M，1G。
```
p1 64MB for BOOT/EFI
p2 1.5GB for system
p3 500MB for vendor
p4 1G for data
```
> fdisk命令详细使用方法可自行百度谷歌，或者参考[飞腾嵌入式 LINUX 用户
> 手册](https://gitee.com/phytium_embedded/phytium-sdk/blob/master/%E9%A3%9E%E8%85%BE%E5%B5%8C%E5%85%A5%E5%BC%8FLinux%E7%94%A8%E6%88%B7%E6%89%8B%E5%86%8C.pdf)中的磁盘分区部分内容。

## 4.2 烧录system/vendor/userdata分区

将这三个分区并格式化为ext4，sdX中的X烧写之前先用df命令确认一下是多少，可能是b，c...等，这里一定要注意不要烧错。

```
sudo mkfs.ext4 sdx2
sudo mkfs.ext4 sdx3
sudo mkfs.ext4 sdx4
```

> **！！！注意：**  在格式化之前，用df确认需要烧写的分区，也就是sdx中的x，可能是a、b、c。

使用dd命令将[3.1 编译OpenHarmony源码](#31-编译openharmony源码)章节编译生成的镜像文件烧写到对应分区中。

```
sudo dd if=system.img of=/dev/sdx2 bs=1M
sudo dd if=vendor.img of=/dev/sdx3 bs=1M
```

## 4.3. 烧录boot分区

boot分区的烧录，启动方式不一样，烧录方法不一样，区分为Uboot启动和UEFI启动两种。
```
###uboot 启动
sudo mkfs.ext4 sdx1
sudo dd if=boot_uboot.img of=/dev/sdx1 bs=1M

###UEFI启动
sudo mkfs.vfat sdx1
sudo dd if=boot_efi.img of=/dev/sdx1 bs=1M
```
## 4.4 镜像打包工具

区别于前面提到的烧写流程，我们还提供了一个镜像打包工具，可以将几个分区的img文件打包成一个镜像，通过dd或者winddows下的烧写工具将打包后的镜像一次性烧写到磁盘，不需要对磁盘分区。
工具所在位置：
```
device_board_phytium/common/tools/generate_image/generate_image.sh
```

使用和配置方法详情，请参考wiki文档[镜像生成脚本](https://gitee.com/phytium_embedded/phytium-openharmony-device/wikis/%E9%95%9C%E5%83%8F%E7%94%9F%E6%88%90%E4%B8%8E%E7%83%A7%E5%BD%95/%E9%95%9C%E5%83%8F%E7%94%9F%E6%88%90%E8%84%9A%E6%9C%AC)。

参考命令：
```
cd out/tengrui_d/packages/phone/images/

#uboot启动
./generate_image.sh

#UEFI启动
./generate_image.sh efi
```
打包时会有如下打印信息：
```
start generate phytium_oh_xxx.img
start creating empty image, please wait......
...
...
losetup loopdevice......
generate phytium_oh_xxx.img successfully!!!!!!
```

# 设备启动

将烧写好的SATA硬盘和调试串口线，连接到开发板上。上位机的串口调试工具波特率设置为115200，上电开机。

## 5.1 Uboot启动

在开机阶段，按回车，设置uboot环境变量

```
setenv bootargs console=ttyAMA1,115200 root=/dev/ram0 elevator=deadline rootwait rw loglevel=1 hardware=tengrui_d rootfstype=ext4 initrd=0x93000000,90M
setenv bootcmd "ext4load scsi 0:1 0x90100000 pd2008-devboard-dsk.dtb;ext4load scsi 0:1 0x90200000 Image;ext4load scsi 0:1 0x93000000 ramdisk.img;booti 0x90200000 - 0x90100000"
saveenv
boot
```

## 5.2 UEFI启动

启动参数已经在烧写EFI分区时已写好，上电后，会直接进入系统。

# 维护者邮箱

飞腾信息技术有限公司  
zhangjianwei@phytium.com.cn  
tangkaiwen@phytium.com.cn  
xiayan1086@phytium.com.cn  
libowen1180@phytium.com.cn   
chenzigui1762@phytium.com.cn  
liucaicheng1476@phytium.com.cn