chainsx 42b7c15e7c 添加 Amlogic A311D (Khadas-VIM3) 的支持

2025-12-17 18:22:24 +08:00

29 KiB

Raw Blame History

SBC-sig

English | 简体中文

本仓库是 openEuler 社区 SBC (Single-Board Computer) SIG 组的主仓库，提供 SIG 组相关信息以及适用于树莓派、Rockchip、全志、晶晨等开发板的 openEuler 镜像的构建脚本和相关文档。

SBC-sig

To Do List

如何参与 SIG 组

SIG 组基本信息位于 sig-SBC。

建立或回复 issue：欢迎通过建立或回复 issue 来讨论，此 SIG 组维护的仓库列表可在 sig-SBC 中查看。
加入 Slack 群组：openeuler-sbc
- 加入群组链接
SIG 组会议：每个月的第一个和第三个周三下午 17:00 - 17:30 会进行一次讨论会议
- 会议链接：有以下两种获取方式
  - openEuler 社区网站下的会议日历中查看 sig-SBC例会 预定信息。
  - 微信小程序搜索 openEuler，添加 OpenAtom openEuler 小程序，可在其会议栏目查看 sig-SBC例会 预定信息。
- 会议议题：每次会议前填写要讨论的议题，我们也会从 issue 列表中提取本周讨论的内容。
- 会议记录：每次会议结束后会议结论会更新在此 issue 中。
重要的事说三遍：欢迎提交 PR！欢迎提交 PR！欢迎提交 PR！

文件说明

说明：

建议直接使用本文档最新镜像章节中给出的 openEuler 的树莓派/Rockchip 等镜像。

最新镜像

树莓派

须知：
当前只有 openEuler 24.03 LTS SP1/25.03/24.03 LTS SP2/25.09 版本的树莓派镜像同时支持树莓派 5 和树莓派 3B/3B+/4B/400，其他版本的树莓派镜像只支持树莓派 3B/3B+/4B/400。

树莓派镜像的基本信息如下所示。更多树莓派镜像

镜像版本	系统用户（密码）	发布时间	大小	内核版本	构建文件系统的源仓库
openEuler 25.09 内测版	root（openeuler） pi（raspberry）	2025/10/17	363 MiB	6.6.0-102.0.0.1	openEuler 25.09 源仓库
openEuler 25.09 内测版（UKUI 桌面、中文输入法）	root（openeuler） pi（raspberry）	2025/10/17	1.7 GiB	6.6.0-102.0.0.1	openEuler 25.09 源仓库
openEuler 25.09 内测版（DDE 桌面、中文输入法）	root（openeuler） pi（raspberry）	2025/10/17	1.6 GiB	6.6.0-102.0.0.1	openEuler 25.09 源仓库
openEuler 25.09 内测版（GNOME 桌面、中文输入法）	root（openeuler） pi（raspberry）	2025/10/17	2.4 GiB	6.6.0-102.0.0.1	openEuler 25.09 源仓库
openEuler 25.09 内测版（DevStation 开发者工作站、中文输入法）	root（openeuler） pi（raspberry）	2025/10/17	1.4 GiB	6.6.0-102.0.0.1	openEuler 25.09 源仓库
openEuler 25.09	root（openeuler） pi（raspberry）	2025/09/29	330.1 MiB	6.6.0-102.0.0.1	openEuler 25.09 源仓库
openEuler 22.03 LTS SP4 内测版	root（openeuler） pi（raspberry）	2024/07/06	235 MiB	5.10.0-209.0.0.21	openEuler 22.03 LTS SP4 源仓库
openEuler 22.03 LTS SP4 内测版（UKUI 桌面、中文输入法）	root（openeuler） pi（raspberry）	2024/07/06	1.5 GiB	5.10.0-209.0.0.21	openEuler 22.03 LTS SP4 源仓库
openEuler 22.03 LTS SP4 内测版（DDE 桌面、中文输入法）	root（openeuler） pi（raspberry）	2024/07/06	1.4 GiB	5.10.0-209.0.0.21	openEuler 22.03 LTS SP4 源仓库
openEuler 22.03 LTS SP4 内测版（Xfce 桌面、中文输入法）	root（openeuler） pi（raspberry）	2024/07/06	2.0 GiB	5.10.0-209.0.0.21	openEuler 22.03 LTS SP4 源仓库
openEuler 22.03 LTS SP4 内测版（EFI 引导启动）	root（openeuler） pi（raspberry）	2024/07/06	255 MiB	5.10.0-217.0.0.22	openEuler 22.03 LTS SP4 源仓库
openEuler 22.03 LTS SP4	root（openeuler） pi（raspberry）	2024/06/29	229 MiB	5.10.0-209.0.0.21	openEuler 22.03 LTS SP4 源仓库

瑞芯微等其他开发板

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

镜像版本	系统用户（密码）	发布时间	大小	内核版本	构建文件系统的源仓库	镜像类型
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 原始镜像

镜像构建

准备环境

本仓库的脚本运行环境要求如下：

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

其他架构可以使用 QEMU 模拟器搭建 AArch64 运行环境。

构建镜像

镜像构建使用统一入口 build.sh 或 build-image-docker.sh 在宿主机或者启动 Docker 容器构建树莓派或瑞芯微等开发板镜像。具体参考以下文档：

宿主机上构建镜像

构建镜像需执行命令：

sudo bash build.sh --board BOARD_CONFIG -n NAME -k KERNEL_URL -b KERNEL_BRANCH -c KERNEL_DEFCONFIG -r REPO_INFO -s SPEC --cores N

脚本运行结束后，会提示镜像的存储位置，镜像默认保存在脚本运行所在目录的 build/YYYY-MM-DD/ 下。

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

参数意义

--board BOARD_CONFIG

适用的开发板的版型配置文件在 boards 文件夹中，示例文件 sample.conf，默认为 firefly-rk3399。

其包括的配置参数意义如下：
- platform=PLATFORM
  
  开发板所使用的平台，目前支持的平台有：broadcom、rockchip、phytium、amlogic，默认为 rockchip。
- device-tree=DTB_NAME
  
  内核设备树中的设备名称，和开发板名称有一点区别，对应 kernel/arch/arm64/boot/dts/rockchip 下的 DTB_NAME.dts 文件，默认为 rk3399-firefly。
- ubootconfig=UBOOT_DEFCONFIG
  
  开发板对应的 defconfig 的文件名称，对应 u-boot/configs 下 UBOOT_DEFCONFIG 文件，默认为 firefly-rk3399_defconfig；如需在 RK3588 开发板上使用预编译的 u-boot，可以将此项设置为空：ubootconfig=。
-n, --name IMAGE_NAME

构建的镜像名称，例如：openEuler-20.03-LTS-Firefly-RK3399-aarch64-alpha1 或 openEuler-24.03-LTS-raspi-aarch64-alpha1。
-k, --kernel KERNEL_URL

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

内核源码的对应分支，默认为 openEuler-20.03-LTS。
-c, --config KERNEL_DEFCONFIG

内核编译使用的配置文件名称或路径，默认为 openeuler_rockchip_defconfig。如果该参数为配置文件名称，请确保该文件在内核源码的目录 arch/arm64/configs 或构建框架的 scripts/configs/rockchip 下。
-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/。
-s, --spec SPEC

构建的镜像版本：
- headless，无图形界面版的镜像。
- xfce，带 Xfce 桌面以及中文字体、输入法等全部配套软件。
- ukui，带 UKUI 桌面以及中文字体、输入法等全部配套软件。
- dde，带 DDE 桌面以及中文字体、输入法等全部配套软件。
- gnome，带 GNOME 桌面以及中文字体、输入法等全部配套软件。
- devstation，带 GNOME 桌面、中文字体、输入法、大量开发工具和 IDE 等配套软件。
- rpmlist 文件路径，其中包含镜像中要安装的软件列表，内容参考 rpmlist。
默认使用 headless 选项。
--cores N

并行编译的数量，根据运行脚本的宿主机 CPU 实际数目设定，默认为可用的 CPU 总数。
-h, --help

显示帮助信息。

Docker 容器内构建镜像