Skip to content

openeuler-mirror/rockchip

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

92 Commits
documents
documents
 
 
scripts
scripts
 
 
README.en.md
README.en.md
 
 
README.md
README.md
 
 

Repository files navigation

Rockchip

English | 简体中文

本仓库提供适用于 Rockchip 开发板的 openEuler 镜像的构建脚本和相关文档。

文件说明

最新镜像

镜像的基本信息如下所示：

镜像版本

系统用户（密码）

发布时间

大小

内核版本

构建文件系统的源仓库

镜像类型
openEuler 20.03 LTS Firefly-RK3399
  • root (openeuler)

2021/12/20

288 MiB

4.19.90

 openEuler 20.03 LTS 源仓库

压缩后的 RAW 原始镜像
openEuler 20.03 LTS Firefly-RK3399
  • root (openeuler)

2021/12/20

493 MiB

4.19.90

 openEuler 20.03 LTS 源仓库

打包后的 EMMC 刷写文件
openEuler 20.03 LTS RockPi-4A
  • root (openeuler)

2021/12/20

295 MiB

4.19.90

 openEuler 20.03 LTS repository

压缩后的 RAW 原始镜像
openEuler 21.09 Firefly-RK3399
  • root (openeuler)

2021/12/20

420 MiB

5.10.0

 openEuler 21.09 源仓库

压缩后的 RAW 原始镜像
openEuler 21.09 Firefly-RK3399
  • root (openeuler)

2021/12/20

717 MiB

5.10.0

 openEuler 21.09 源仓库

打包后的 EMMC 刷写文件
openEuler 21.09 RockPi-4A
  • root (openeuler)

2021/12/20

717 MiB

5.10.0

 openEuler 21.09 源仓库

压缩后的 RAW 原始镜像
openEuler 22.03 Firefly ITX-3588J
  • root (openeuler)

2023/7/11

494 MiB

5.10.0

 openEuler 22.03 源仓库

压缩后的 RAW 原始镜像
openEuler 22.03 Firefly ITX-3588J + XFCE 桌面
  • root (openeuler)

2023/7/11

1.9 GiB

5.10.0

 openEuler 22.03 源仓库

压缩后的 RAW 原始镜像
openEuler 22.03 LTS SP3 Firefly-RK3399
  • root (openeuler)

2024/1/24

450 MiB

5.10.0

 openEuler 22.03 LTS SP3 源仓库

压缩后的 RAW 原始镜像

镜像构建

须知：
RK3399 当前支持 openEuler 版本：20.03 LTS、20.03 LTS SP1、20.03 LTS SP2、20.03 LTS SP3、22.03 LTS SP2 和 22.03 LTS SP3。 RK3566 当前支持 openEuler 版本：24.03 LTS。 RK3588 当前支持 openEuler 版本：22.03 LTS、22.03 LTS SP2 和 22.03 LTS SP3。 如果构建包含 Xfce/UKUI/DDE 桌面环境的镜像，需要注意三点：

  1. 构建包含 Xfce 桌面环境的镜像，当前只支持 20.03 LTS SP2、20.03 LTS SP3、21.09、22.03 LTS、22.03 LTS SP3、24.03 LTS 版本。
  2. 构建包含 UKUI 或 DDE 桌面环境的镜像，当前只支持 20.03 LTS SP1、20.03 LTS SP2、20.03 LTS SP3、21.09、22.03 LTS、22.03 LTS SP3、24.03 LTS 版本。
  3. 根据需要设置 -s/--spec，其具体意义见该参数的介绍部分。同时需要设置对应 -r/--repo 参数。

准备环境

  • 操作系统：openEuler 、CentOS 8
  • 架构：AArch64 ，如树莓派、 RK3399 开发板、 RK3588 开发板

详细过程参见 openEuler 镜像的构建。

一次构建

构建镜像需执行命令：

sudo bash build.sh -n NAME -k KERNEL_URL -b KERNEL_BRANCH -c BOARD_CONFIG -r REPO_INFO -d DTB_NAME -s SPEC

说明: 基于 build.sh 提供的默认参数，执行 sudo bash build.sh 可构建 Firefly-RK3399 的 openEuler-20.03-LTS 镜像。

脚本执行完成后，会在脚本所在目录的 build/YYYY-MM-DD 文件夹下生成以下文件：

  • 打包后的 EMMC 刷写文件：openEuler-VERSION-BOARD-RELEASE.tar.gz。
  • 压缩后的 RAW 原始镜像：openEuler-VERSION-BOARD-ARCH-RELEASE.img.xz。

打包后的 EMMC 刷写文件和压缩后的 RAW 原始镜像文件有什么区别？

  1. 打包后的 EMMC 刷写文件：指需要使用 RKDevTool 或者 rkdeveloptool 来刷入到例如 Firefly-RK3399 这一类自带 EMMC 储存介质的开发板中。
  2. 压缩后的 RAW 原始镜像文件：通常指的是一个完整的磁盘镜像文件，其中包含了所有磁盘扇区的数据。可以刷写到例如 SD 卡、EMMC 等多种储存介质中。
  3. 带 EMMC 的开发板也可以使用 SD 卡启动镜像，启动选择的储存介质各不相同，如果 EMMC 启动优先级大于 SD 卡，则优先启动 EMMC 内的系统，在这种情况下若想使用 SD 卡内的系统需要先清空 EMMC。
  4. EMMC 刷写过程在 刷写到 EMMC 中介绍；SD 卡刷写过程在 刷写到 SD 卡 中介绍。

各个参数意义：

  1. -n, --name IMAGE_NAME

    构建的镜像名称，例如：openEuler-20.03-LTS-Firefly-RK3399-aarch64-alpha1 或 openEuler-21.09-Firefly-RK3399-aarch64-alpha1。

  2. -k, --kernel KERNEL_URL

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

  3. -b, --branch KERNEL_BRANCH

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

  4. -c, --config BOARD_CONFIG

    开发板对应的 defconfig 的文件名称，对应 u-boot/configs 下 BOARD_CONFIG 文件，默认为 firefly-rk3399_defconfig；如需在 RK3588 开发板上使用预编译的 u-boot，可以将此项设置为 none。

  5. -r, --repo REPO_INFO

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

    • 开发源 repo 文件的 URL，如 https://gitee.com/src-openeuler/openEuler-repos/raw/openEuler-20.03-LTS/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/OS/aarch64/ http://repo.openeuler.org/openEuler-20.03-LTS/EPOL/aarch64/。

  6. -d, --device-tree DTB_NAME

    内核设备树中的设备名称，和开发板名称有一点区别，对应 kernel/arch/arm64/boot/dts/rockchip 下的 DTB_NAME.dts 文件，默认为 rk3399-firefly。

  7. -p, --platform PLATFORM

    开发板所使用的平台，目前支持的平台有：rockchip、phytium，默认为 rockchip。

  8. -s, --spec SPEC

    构建的镜像版本：

    • headless，无图形界面版的镜像。
    • xfce，带 Xfce 桌面以及中文字体、输入法等全部配套软件。
    • ukui，带 UKUI 桌面及必要的配套软件（不包括中文字体以及输入法）。
    • dde，带 DDE 桌面及必要的配套软件（不包括中文字体以及输入法）。
    • rpmlist 文件路径，其中包含镜像中要安装的软件列表，内容参考 rpmlist。

    默认使用 headless 选项。

  9. -h, --help

    显示帮助信息。

适用的 RK3399 开发板:

已经测试的开发板如下，其他类型 Rockchip 开发板适用情况待测试。

  1. Firefly-RK3399

    已测试的版本如下：

    • openEuler-20.03-LTS，构建命令如下:

      sudo bash build.sh -n openEuler-20.03-LTS-Firefly-RK3399-aarch64-alpha1 -k https://gitee.com/openeuler/rockchip-kernel.git -b openEuler-20.03-LTS -c firefly-rk3399_defconfig -r https://gitee.com/src-openeuler/openEuler-repos/raw/openEuler-20.03-LTS/generic.repo -d rk3399-firefly -p rockchip -s headless

    • openEuler-22.03-LTS-SP3，构建命令如下：

      sudo bash build.sh -n openEuler-22.03-LTS-SP3-Firefly-RK3399-aarch64-alpha1 -k https://gitee.com/openeuler/rockchip-kernel.git -b openEuler-22.03-LTS-SP3 -c firefly-rk3399_defconfig -r https://gitee.com/src-openeuler/openEuler-repos/raw/openEuler-22.03-LTS-SP3/generic.repo -d rk3399-firefly -p rockchip -s headless

  2. RockPi-4A

    已测试的版本如下：

    • openEuler-20.03-LTS，构建命令如下:

      sudo bash build.sh -n openEuler-20.03-LTS-RockPi-4A-aarch64-alpha1 -k https://gitee.com/openeuler/rockchip-kernel.git -b openEuler-20.03-LTS -c rock-pi-4-rk3399_defconfig -r https://gitee.com/src-openeuler/openEuler-repos/raw/openEuler-20.03-LTS/generic.repo -d rk3399-rock-pi-4a -p rockchip -s headless

    • openEuler-22.03-LTS，构建命令如下：

      sudo bash build.sh -n openEuler-22.03-LTS-RockPi-4A-aarch64-alpha1 -k https://gitee.com/openeuler/kernel.git -b openEuler-22.03-LTS -c rock-pi-4-rk3399_defconfig -r https://gitee.com/src-openeuler/openEuler-repos/raw/openEuler-22.03-LTS/generic.repo -d rk3399-rock-pi-4a -p rockchip -s headless

适用的 RK3588 开发板:

已经测试的开发板如下，其他类型 RK3588 开发板适用情况待测试。

  1. Firefly ITX-3588J

    已测试的版本如下：

    • openEuler-22.03-LTS，构建命令如下:

      sudo bash build.sh -n openEuler-22.03-RK3588-Firefly-ITX-3588J-aarch64-alpha1 -k https://gitee.com/openeuler/rockchip-kernel.git -b openEuler-22.03-LTS-RK3588 -c none -r https://gitee.com/src-openeuler/openEuler-repos/raw/openEuler-22.03-LTS/generic.repo -d rk3588-firefly-itx-3588j -p rockchip -s headless

  2. Firefly ROC-RK3588S-PC

    已测试的版本如下：

    • openEuler-22.03-LTS，构建命令如下:

      sudo bash build.sh -n openEuler-22.03-LTS-Station-M3-aarch64-alpha1 -k https://gitee.com/openeuler/rockchip-kernel.git -b openEuler-22.03-LTS-RK3588 -c none -r https://gitee.com/src-openeuler/openEuler-repos/raw/openEuler-22.03-LTS/generic.repo -d rk3588s-roc-pc -p rockchip -s headless

  3. Radxa Rock-5B

    已测试的版本如下：

    • openEuler-22.03-LTS，构建命令如下:

      sudo bash build.sh -n openEuler-22.03-LTS-Rock5B-aarch64-alpha1 -k https://gitee.com/openeuler/rockchip-kernel.git -b openEuler-22.03-LTS-RK3588 -c none -r https://gitee.com/src-openeuler/openEuler-repos/raw/openEuler-22.03-LTS/generic.repo -d rk3588-rock-5b -p rockchip -s headless

适用的 RK356X 开发板:

已经测试的开发板如下，其他类型 RK356X 开发板适用情况待测试。

  1. Firefly ROC-RK3566-PC

    已测试的版本如下：

    • openEuler-22.03-LTS-SP2，构建命令如下:

      sudo bash build.sh -n openEuler-22.03-LTS-SP2-Station-M2-aarch64-alpha1 -k https://gitee.com/openeuler/rockchip-kernel.git -b openEuler-22.03-LTS-SP2 -c none -r https://gitee.com/src-openeuler/openEuler-repos/raw/openEuler-22.03-LTS-SP2/generic.repo -d rk3566-roc-pc -p rockchip -s headless

    • openEuler-22.03-LTS-SP3，构建命令如下:

      sudo bash build.sh -n openEuler-22.03-LTS-SP3-Station-M2-aarch64-alpha1 -k https://gitee.com/openeuler/rockchip-kernel.git -b openEuler-22.03-LTS-SP3 -c none -r https://gitee.com/src-openeuler/openEuler-repos/raw/openEuler-22.03-LTS-SP3/generic.repo -d rk3566-roc-pc -p rockchip -s headless

    • openEuler-24.03-LTS，构建命令如下:

      sudo bash build.sh -n openEuler-24.03-LTS-Station-M2-aarch64-alpha1 -k https://gitee.com/openeuler/rockchip-kernel.git -b openEuler-24.03-LTS -c none -r https://gitee.com/src-openeuler/openEuler-repos/raw/openEuler-24.03-LTS/generic.repo -d rk3566-roc-pc -p rockchip -s headless

  2. Firefly ROC-RK3568-PC-SE

    已测试的版本如下：

    • openEuler-22.03-LTS-SP2，构建命令如下:

      sudo bash build.sh -n openEuler-22.03-LTS-SP2-ROC-RK3568-PC-SE-aarch64-alpha1 -k https://gitee.com/openeuler/rockchip-kernel.git -b openEuler-22.03-LTS-SP2 -c none -r https://gitee.com/src-openeuler/openEuler-repos/raw/openEuler-22.03-LTS-SP2/generic.repo -d rk3568-roc-pc-se -p rockchip -s headless

    • openEuler-22.03-LTS-SP3，构建命令如下:

      sudo bash build.sh -n openEuler-22.03-LTS-SP3-ROC-RK3568-PC-SE-aarch64-alpha1 -k https://gitee.com/openeuler/rockchip-kernel.git -b openEuler-22.03-LTS-SP3 -c none -r https://gitee.com/src-openeuler/openEuler-repos/raw/openEuler-22.03-LTS-SP3/generic.repo -d rk3568-roc-pc-se -p rockchip -s headless

适用的 Phytium 开发板:

已经测试的开发板如下，其他类型 Phytium 开发板适用情况待测试。

  1. Phytium Pi 4GB

    已测试的版本如下：

    • openEuler-22.03-LTS-SP3，构建命令如下:

      sudo bash build.sh -n openEuler-22.03-LTS-PhytiumPi-4GB-aarch64-alpha1 -k https://gitee.com/openeuler/phytium-kernel.git -b openEuler-22.03-LTS-Phytium -c none -r https://gitee.com/src-openeuler/openEuler-repos/raw/openEuler-22.03-LTS/generic.repo -d phytiumpi_firefly -p phytium -s headless

    • openEuler-24.03-LTS，构建命令如下:

      sudo bash build.sh -n openEuler-24.03-LTS-PhytiumPi-4GB-aarch64-alpha1 -k https://gitee.com/openeuler/phytium-kernel.git -b openEuler-24.03-LTS-Phytium -c none -r https://gitee.com/src-openeuler/openEuler-repos/raw/openEuler-24.03-LTS/generic.repo -d phytiumpi_firefly -p phytium -s headless

顺序构建

依次执行脚本构建生成压缩后的 SD 卡启动镜像和打包后的 EMMC 刷写文件，过程参考顺序构建。

刷写镜像

刷写到 SD 卡

将压缩后的 RAW 原始镜像解压后写入 SD 卡，请参考树莓派镜像烧录，过程中所用到的镜像应为本项目提供适用于 Rockchip 开发板的镜像。

注意：由于 Firefly-RK3399 与其他 RK3399 开发板不同，会优先启动 EMMC 上的系统，在 Firefly-RK3399 上使用 SD 卡启动镜像之前需要清除 EMMC 上的系统，上电后需要按下电源键来启动。

刷写到 EMMC

将 openEuler 安装到 EMMC，详见刷写EMMC镜像。

问题汇总

  1. 自构建 openEuler 镜像登录时提示 Login incorrect：

    该问题通常有以下几种特征：

    • 根据提示输入 root / openeuler 后提示 Login incorrect
    openEuler 22.03 LTS
Kernel 5.10.0 on an aarch64

openEuler login:root
Password:

Login incorrect
    • chroot 到根目录无法修改密码

    passwd:Authentication token manipulation error

    遇到这一类问题有以下解决方法，如果有更多方法，欢迎反馈：

About

No description, website, or topics provided.

Resources

Readme
Activity
Custom properties

Stars

8 stars

Watchers

2 watching

Forks

2 forks
Report repository

Releases

No releases published

Packages

No packages published

Contributors 7

Languages