SBC-sig/documents/rockchip/顺序构建.md

# 顺序单独构建

- [顺序单独构建](#顺序单独构建)
  - [准备环境](#准备环境)
  - [编译 u-boot](#编译-u-boot)
  - [构建 boot 镜像](#构建-boot-镜像)
  - [构建 rootfs 镜像](#构建-rootfs-镜像)
  - [可启动镜像构建](#可启动镜像构建)

## 准备环境
- 操作系统：openEuler、 CentOS 8
- 架构：AArch64 ，如树莓派、 RK3399

## 编译 u-boot

编译 u-boot 需执行命令：

`sudo bash build_u-boot.sh -c BOARD_CONFIG`

**说明: 基于 build_u-boot.sh 提供的默认参数，执行 sudo ./build_u-boot.sh 编译 u-boot。**

各个参数意义：

1. -c, --config BOARD_CONFIG

    开发板对应的 defconfig 的文件名称，对应 [u-boot/configs](https://github.com/u-boot/u-boot/tree/master/configs) 下 `BOARD_CONFIG` 文件，默认为 `firefly-rk3399_defconfig`；如需在 RK3588 开发板上使用预编译的 u-boot，可以将此项设置为 `none`。

2.  -h, --help

    显示帮助信息。


## 构建 boot 镜像

构建 boot 镜像需执行命令：

`sudo bash build_boot.sh -k KERNEL_URL -b KERNEL_BRANCH -d DTB_NAME`

**说明: 基于 build_boot.sh 提供的默认参数，执行 sudo ./build_boot.sh 可生成 Firefly-RK3399 的 boot 分区镜像 boot.img。**

各个参数意义：

1. -k, --kernel KERNEL_URL

    内核源码仓库的项目地址，默认为 `https://gitee.com/openeuler/raspberrypi-kernel.git`。可根据需要设置为 `git@gitee.com:openeuler/raspberrypi-kernel.git` 或 `git@gitee.com:openeuler/kernel.git`。

2. -b, --branch KERNEL_BRANCH

    内核源码的对应分支，默认为 openEuler-20.03-LTS。根据 -k 参数有以下选择：

    - -k https://gitee.com/openeuler/rockchip-kernel.git
        - openEuler-20.03-LTS
    - -k https://gitee.com/openeuler/kernel.git
        - openEuler-21.03
        - openEuler-21.09

3. -d, --device-tree DTB_NAME

    内核设备树名称，和开发板名称有一点区别，对应 [kernel/arch/arm64/boot/dts/rockchip](https://gitee.com/openeuler/kernel/tree/master/arch/arm64/boot/dts/rockchip) 下的 `DTB_NAME.dts` 文件，默认为 `rk3399_firefly`

4.  -h, --help

    显示帮助信息。

## 构建 rootfs 镜像

运行 rootfs 构建脚本需执行命令：

`sudo bash build_rootfs.sh -r REPO_INFO -b KERNEL_BRANCH -d DTB_NAME -s SPEC`

**说明: 基于 build_rootfs.sh 提供的默认参数，执行 sudo ./build_rootfs.sh 可生成 Firefly-RK3399 的 rootfs 分区镜像 rootfs.img。**

各个参数意义：

1. -r, --repo REPO_INFO
   
    开发源 repo 文件的 URL 或者路径，也可以是开发源中资源库的 baseurl 列表。注意，如果该参数为资源库的 baseurl 列表，该参数需要使用双引号，各个 baseurl 之间以空格隔开。
    下面分别举例：

    - 开发源 repo 文件的 URL，如 `https://gitee.com/src-openeuler/openEuler-repos/raw/openEuler-20.03-LTS-SP2/generic.repo`。
    - 开发源的 repo 文件路径：
        
        `./openEuler-20.03-LTS.repo`：生成 openEuler 20.03 LTS 版本的镜像，该文件内容参考 <https://gitee.com/src-openeuler/openEuler-repos/blob/openEuler-20.03-LTS/generic.repo>。

    - 资源库的 baseurl 列表，如 `http://repo.openeuler.org/openEuler-20.03-LTS-SP2/OS/aarch64/ http://repo.openeuler.org/openEuler-20.03-LTS-SP2/EPOL/aarch64/`。

2. -b, --branch KERNEL_BRANCH

    内核源码的对应分支，默认为 openEuler-20.03-LTS。根据 -k 参数有以下选择：

    - -k https://gitee.com/openeuler/rockchip-kernel.git
        - openEuler-20.03-LTS
    - -k https://gitee.com/openeuler/kernel.git
        - openEuler-21.03
        - openEuler-21.09

3. -d, --device-tree DTB_NAME

    内核设备树名称，和开发板名称有一点区别，对应 [kernel/arch/arm64/boot/dts/rockchip](https://gitee.com/openeuler/kernel/tree/master/arch/arm64/boot/dts/rockchip) 下的 `DTB_NAME.dts` 文件，默认为 `rk3399_firefly`

4.  -s, --spec SPEC

    构建的镜像版本：
    - `headless`，无图形界面版的镜像。
    - `xfce`，带 Xfce 桌面以及中文字体、输入法等全部配套软件。
    - `ukui`，带 UKUI 桌面及必要的配套软件（不包括中文字体以及输入法）。
    - `dde`，带 DDE 桌面及必要的配套软件（不包括中文字体以及输入法）。
    -  rpmlist 文件路径，其中包含镜像中要安装的软件列表，内容参考 [rpmlist](../../scripts/rockchip/configs/rpmlist)。

    默认使用 `headless` 选项。

5.  -h, --help

    显示帮助信息。
    

## 可启动镜像构建

运行可启动镜像构建脚本需执行命令：

`sudo bash gen_image.sh -n NAME`

**说明: 在确保顺序执行以上脚本并生成对应的文件及文件夹后再执行此脚本**
  
脚本运行结束后，在 scripts/build/YYYY-MM-DD 所在目录生成 openEuler-VERSION-BOARD.img.xz 即为压缩后的 RK3399 SD卡启动镜像，openEuler-VERSION-BOARD.tar.gz 即为打包后的 EMMC 刷写镜像。 

各个参数意义：

1. -n, --name IMAGE_NAME

    构建的镜像名称。

2.  -h, --help

    显示帮助信息。