# Phytium-OpenHarmony-TengruiD-X100

**Repository Path**: jiashengyang/phytium-openharmony-d2000-device

## Basic Information

- **Project Name**: Phytium-OpenHarmony-TengruiD-X100
- **Description**: 该项目介绍，如何在飞腾信息科技有限公司的 Phytium D系列CPU + X100 DEV平台上运行OpenHarmony标准系统。支持X100提供的视频解码硬件加速，以及图形显示硬件加速。支持Linux kernel 5.10
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 27
- **Created**: 2024-10-29
- **Last Updated**: 2024-10-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Phytium-OpenHarmony-Dxxxx-X100

## 介绍

该项目介绍，如何在飞腾信息科技有限公司的 Phytium D系列CPU + X100硬件平台上运行 OpenHarmony 标准系统[OpenHamony 4.1 release](https://gitee.com/openharmony/docs/blob/master/zh-cn/release-notes/OpenHarmony-v4.1-release.md)。
支持X100提供的视频解码硬件加速，以及图形显示硬件加速。
支持Linux kernel 5.10。

# 搭建开发环境

## 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
```

## 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-d2000-device.git
```

## 2.2 整合内核源码
从我们发布的OpenHarmony Release 4.1的适配代码版本开始，我们优化了D2000内核代码编译和释放的方式，会以patch的形式释放内核源码，将发布的kernel_source文件拷贝到device_board_phytium/d2000/kernel_source目录，内核会跟随OpenHarmony操作系统一起编译。但是D2000源码暂未开源，需要邮件联系phytium嵌入式软件部(linan1284@phytium.com.cn)获取kernel源码patch。  

kernel_source主要包括phytium_patch、pytium_standard_defconfig以及dts三个部分，可以根据项目需求和硬件平台按需获取。  
1. phytium_patch:飞腾通用内核补丁，包含phytium通用补丁phytium.patch，X100 gpu内核驱动补丁gpu.patch，X100 vpu内核驱动补丁vpu.patch。
2. pytium_standard_defconfig：内核编译config文件。
3. dts：D2000 demo板设备树，Uboot启动需要，如果是其他板卡，需要找对应的板卡厂商获取设备树文件。

## 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:         d2000(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对应d2000；1对应e2000；2对应phytiumpi-firefly

## 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源码

```
cd $PROJ_ROOT
./build.sh --product-name d2000 --ccache --target-cpu arm64
```

 编译成功提示:

```
post_process
=====build d2000 successful.
```

编译生成的文件

```
$PROJ_ROOT/out/d2000/packages/phone/images/boot_uboot.img
$PROJ_ROOT/out/d2000/packages/phone/images/system.img
$PROJ_ROOT/out/d2000/packages/phone/images/vendor.img
$PROJ_ROOT/out/d2000/packages/phone/images/ramdisk.img
```

# 镜像烧写

## 4.1 硬盘分区

准备一块SATA硬盘，删除原有分区后，在linux下，使用fdsik命令分区，创建4个分区，依次为boot，system，vendor，userdata，根据实际情况设定，比如可以设定为500M，3G，500M，10G。p1 500MB for BOOT/EFIp2 3GB for systemp3 500MB for vendorp4 10G 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启动两种。

### 4.3.1 Uboot启动

系统编译默认生成的是uboot启动下的boot_uboot.img，先将boot分区格式化成ext4，然后烧入boot镜像文件。

```
sudo mkfs.ext4 sdx1
sudo dd if=boot_uboot.img of=/dev/sdx1 bs=1M
```

### 4.3.2 UEFI启动

需要先用make_boot.sh脚本生成UEFI启动下的boot_efi.img，然后将boot分区格式化成vfat，最后烧入boot镜像文件。make_boot.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)。

```
./make_boot.sh ./ efi
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/d2000/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硬盘和调试串口线，连接到d2000 DEV板上。上位机的串口调试工具波特率设置为115200，上电开机。

## 5.1 Uboot启动

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

```
setenv bootargs console=ttyAMA1,115200 earlycon=p1011,0x28001000 root=/dev/ram0 elevator=deadline rootwait rw loglevel=6 hardware=d2000 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