Go to file

openeuler-ci-bot a8eab6f2cd

From: @chainsx 
Reviewed-by: @woqidaideshi 
Signed-off-by: @woqidaideshi

2025-10-22 07:27:06 +00:00

documents

更新README文件描述，添加rk356x/rk3576线刷文件

2025-10-22 15:17:40 +08:00

scripts

更新README文件描述，添加rk356x/rk3576线刷文件

2025-10-22 15:17:40 +08:00

.gitignore

更新交叉编译工具链，修复跨架构构建

2025-09-18 14:59:31 +08:00

LICENSE

documents and scripts for RPi and Rockchip

2024-11-08 17:43:01 +08:00

OWNERS

documents and scripts for RPi and Rockchip

2024-11-08 17:43:01 +08:00

README.en.md

RPi: release openEuler 25.09

2025-10-22 11:26:08 +08:00

README.md

更新README文件描述，添加rk356x/rk3576线刷文件

2025-10-22 15:17:40 +08:00

README.en.md

SBC-sig

English | 简体中文

This repository is the main repository of the openEuler SBC (Single-Board Computer) SIG. It provides information related to SBC SIG, build scripts and documentation for openEuler images suitable for development boards such as Raspberry Pi, Rockchip and Allwinner.

SBC-sig

To Do List

Raspberry Pi
1. Migrate openEuler to Raspberry Pi CM4
Rockchip
Allwinner
1. Migrate openEuler 5.10 kernel to Allwinner SoCs

How to collaborate

You can get introduction of openEuler SBC SIG from sig-SBC.

Issues: welcome to collaborate with us by creating new issues or reply opened issues. You can get repository list from sig-SBC.
Join Slack workspace: openeuler-sbc
- Invite link
Weekly meeting schedule
- Meeting Time: The 1st and 3rd Wednesday of each month, 17:00 - 17:30 UTC+8.
- Meeting Link: There are two methods to get the meeting link which will be updated before each meeting.
  - Log in to the openEuler Community website, then view the booking information of sig-SBC例会 in the meeting calendar.
  - Search openEuler in mini programs of WeChat, add OpenAtom openEuler mini program. Then click 会议 and view the booking information of sig-SBC例会.
- Meeting Agenda
- Meeting Minutes
Warmly welcome to submit Pull Requests.

File description

**NOTE: **

Recommendation: use the latest images provided in the chapter How to download latest image of this documentation.

How to download latest image

Raspberry Pi

Note:
Currently, only the openEuler 24.03 LTS SP1/25.03/24.03 LTS SP2/25.09 Raspberry Pi images support both Raspberry Pi 5 and Raspberry Pi 3B/3B+/4B/400, while other versions of the Raspberry Pi images only support Raspberry Pi 3B/3B+/4B/400.

Basic information of the images for Raspberry Pi is as follows. more images

Version	System user(password)	Release date	Size	Kernel version	Repository of rootfs
openEuler 25.09 alpha1	root (openeuler) pi (raspberry)	2025/10/17	363 MiB	6.6.0-102.0.0.1	openEuler 25.09 源仓库
openEuler 25.09 alpha1 (UKUI desktop and Chinese input method)	root (openeuler) pi (raspberry)	2025/10/17	1.7 GiB	6.6.0-102.0.0.1	openEuler 25.09 源仓库
openEuler 25.09 alpha1 (DDE desktop and Chinese input method)	root (openeuler) pi (raspberry)	2025/10/17	1.6 GiB	6.6.0-102.0.0.1	openEuler 25.09 源仓库
openEuler 25.09 alpha1 (GNOME desktop and Chinese input method)	root (openeuler) pi (raspberry)	2025/10/17	2.4 GiB	6.6.0-102.0.0.1	openEuler 25.09 源仓库
openEuler 25.09 alpha1 (DevStation and Chinese input method)	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 alpha1	root (openeuler) pi (raspberry)	2024/07/06	235 MiB	5.10.0-209.0.0.21	openEuler 22.03 LTS SP4 repository
openEuler 22.03 LTS SP4 alpha1 (UKUI desktop and Chinese input method)	root (openeuler) pi (raspberry)	2024/07/06	1.5 GiB	5.10.0-209.0.0.21	openEuler 22.03 LTS SP4 repository
openEuler 22.03 LTS SP4 alpha1 (DDE desktop and Chinese input method)	root (openeuler) pi (raspberry)	2024/07/06	1.4 GiB	5.10.0-209.0.0.21	openEuler 22.03 LTS SP4 repository
openEuler 22.03 LTS SP4 alpha1 (Xfce desktop and Chinese input method)	root (openeuler) pi (raspberry)	2024/07/06	2.0 GiB	5.10.0-209.0.0.21	openEuler 22.03 LTS SP4 repository
openEuler 22.03 LTS SP4 alpha1 (EFI boot)	root (openeuler) pi (raspberry)	2024/07/06	255 MiB	5.10.0-217.0.0.22	openEuler 22.03 LTS SP4 repository
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 repository

Rockchip

Basic information of the image is as follows:

Version	System User (Password)	Release Date	Size	Kernel Version	Repository of rootfs	Image type
openEuler 20.03 LTS Firefly-RK3399	root (openeuler)	2021/12/20	288 MiB	4.19.90	openEuler 20.03 LTS repository	A compressed RAW original image
openEuler 20.03 LTS Firefly-RK3399	root (openeuler)	2021/12/20	493 MiB	4.19.90	openEuler 20.03 LTS repository	A compressed image for the EMMC
openEuler 20.03 LTS RockPi-4A	root (openeuler)	2021/12/20	295 MiB	4.19.90	openEuler 20.03 LTS repository	A compressed RAW original image
openEuler 21.09 Firefly-RK3399	root (openeuler)	2021/12/20	420 MiB	5.10.0	openEuler 21.09 repository	A compressed RAW original image
openEuler 21.09 Firefly-RK3399	root (openeuler)	2021/12/20	717 MiB	5.10.0	openEuler 21.09 repository	A compressed image for the EMMC
openEuler 21.09 RockPi-4A	root (openeuler)	2021/12/20	717 MiB	5.10.0	openEuler 21.09 repository	A compressed RAW original image
openEuler 22.03 Firefly ITX-3588J	root (openeuler)	2023/7/11	494 MiB	5.10.0	openEuler 22.03 repository	A compressed RAW original image
openEuler 22.03 Firefly ITX-3588J + XFCE	root (openeuler)	2023/7/11	1.9 GiB	5.10.0	openEuler 22.03 repository	A compressed RAW original image
openEuler 22.03 LTS SP3 Firefly-RK3399	root (openeuler)	2024/1/23	450 MiB	5.10.0	openEuler 22.03 LTS SP3 repository	A compressed RAW original image

How to build image

Prepare the environment

To build openEuler AArch64 image for Raspberry Pi, Rockchip or other SoCs, the requirements of running scripts of this repository are as follows:

OS: openEuler or CentOS 8
Hardware: AArch64 hardware, such as Raspberry Pi, Firefly RK3399, Firefly ROC-RK3588S-PC

For other architecture hardware, you can use QEMU to build AArch64 system emulation.

Run the scripts to build image

You can use the unified build scripts build.sh or build-image-docker.sh to build images for Raspberry Pi, Rockchip, and other development boards, either directly on the host machine or by launching a Docker container. For details, please refer to the documentation below:

Build on host

Run the following command to build images on the host machine:

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

After building the image, you can find the image in build/YYYY-MM-DD of the directory in which the script resides as shown in the script output.

NOTE: You can directly execute "sudo bash build.sh" to build an openEuler 20.03 LTS image for Firefly-RK3399 with the script's default parameters.

Parameter Descriptions

--board BOARD_CONFIG The board configuration files are located in the boards directory. See the example file sample.conf. The default is firefly-rk3399.

Configuration parameters included:
- platform=PLATFORM
  
  The Hardware platform used by the board. Currently supported platforms are: broadcom, rockchip, phytium. Default is rockchip.
- device-tree=DTB_NAME
  
  The device name in the kernel device tree (slightly different from the board name). Corresponds to the DTB_NAME.dts file under kernel/arch/arm64/boot/dts/rockchip. Default is rk3399-firefly.
- ubootconfig=UBOOT_DEFCONFIG
  
  The defconfig file name for the development board. Corresponds to the UBOOT_DEFCONFIG file under u-boot/configs. Default is firefly-rk3399_defconfig. To use a precompiled u-boot (e.g., on RK3588), set this to empty: ubootconfig=.
-n, --name IMAGE_NAME

The image name to be built. For example, openEuler-20.03-LTS-Firefly-RK3399-aarch64-alpha1 or openEuler-24.03-LTS-raspi-aarch64-alpha1.
-k, --kernel KERNEL_URL

The URL of kernel source repository, which defaults to https://gitee.com/openeuler/raspberrypi-kernel.git. You can set the parameter as git@gitee.com:openeuler/raspberrypi-kernel.git or git@gitee.com:openeuler/kernel.git according to the requirement.
-b, --branch KERNEL_BRANCH

The branch name of kernel source repository, which defaults to openEuler-20.03-LTS.
-c, --config KERNEL_DEFCONFIG

The filename/path of configuration for compiling kernel, which defaults to openeuler-raspi_defconfig. If this parameter is the filename of configuration, please make sure the configuration file in arch/arm64/configs of the kernel source.
-r, --repo REPO_INFO

The URL/path of target repo file, or the list of repositories' baseurls. Note that, the baseurls should be separated by space and enclosed in double quotes. Examples are as follows:
- The URL of target repo file: https://gitee.com/src-openeuler/openEuler-repos/raw/openEuler-20.03-LTS/generic.repo.
- The path of target repo file:
  
  ./openEuler-20.03-LTS.repo：for building openEuler 20.03 LTS image, refer to https://gitee.com/src-openeuler/openEuler-repos/blob/openEuler-20.03-LTS/generic.repo for details.
- List of repo's baseurls: http://repo.openeuler.org/openEuler-20.03-LTS/OS/aarch64/ http://repo.openeuler.org/openEuler-20.03-LTS/EPOL/aarch64/.
-s, --spec SPEC

Specify the image version:
- headless, image without desktop environments.
- xfce, image with Xfce desktop environment and related software including CJK fonts and IME.
- ukui, image with UKUI desktop environment and fundamental software including CJK fonts and IME.
- dde, image with DDE desktop environment and fundamental software including CJK fonts and IME.
- gnome，image with GNOME desktop environment and fundamental software including CJK fonts and IME.
- devstation，image with GNOME desktop environment and fundamental software including CJK fonts, IME, development tools and IDEs.
- The file path of rpmlist, the file contains a list of the software to be installed in the image, refer to rpmlist for details.
The default is headless.
--cores N

The number of parallel compilations, according to the actual number of CPU of the host running the script. The default is the number of processing units available.
-h, --help

Displays help information.

Build in a Docker container

Run the following command to build an image in a Docker container:

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

After building the image, you can find the image in build/YYYY-MM-DD of the directory in which the script resides.

Caution, before running the script, you need to install Docker. The script will automatically import the Docker image into the local system according to the script's parameter: DOCKER_FILE.

In addition to the parameter DOCKER_FILE, the other parameters are the same as the corresponding parameters in Build on host:

-d, --docker DOCKER_FILE

The URL/path of the Docker image, which defaults to https://repo.openeuler.org/openEuler-20.03-LTS-SP1/docker_img/aarch64/openEuler-docker.aarch64.tar.xz. With the default parameter, the script will automatically download the Docker image of openEuler 20.03 LTS SP1 and import it into the local system.

README.en.md Unescape Escape

SBC-sig

To Do List

How to collaborate

File description

How to download latest image

Raspberry Pi

Rockchip

How to build image

Prepare the environment

Run the scripts to build image

Build on host

Build in a Docker container

README.en.md