Star1
0
代码
代码
Issues5
Pull Requests
流水线
项目讨论
Wiki
分析
Star1
0
woqidaideshiwoqidaideshideprecated info
2637b0b3创建于 2024年11月15日历史提交

DEPRECATED. Please refer to SBC-sig

raspberrypi

English | 简体中文

This repository is main repository of openEuler RaspberryPi SIG, and provides scripts for building openEuler image for Raspberry Pi and related documents.

In addition, RaspberryPi SIG also aims to migrate openEuler to other SoCs, such as Rockchip and Allwinner.

To Do List

  1. Raspberry Pi
    1. Migrate openEuler 22.09 to Raspberry Pi
    2. Migrate openEuler to Raspberry Pi CM4
  2. Rockchip
    1. Migrate openEuler 22.09 to RK3399 SoCs
    2. Migrate openEuler 22.03 LTS (Next) to Rockchip SoCs
    3. Migrate openEuler 22.03 LTS (Next) to ITX-3588J SoCs
  3. 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-raspberrypi
  • 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-RaspberryPi例会 in the meeting calendar.
      • Search openEuler in mini programs of WeChat, add openEuler mini program. Then click 会议 and view the booking information of sig-RaspberryPi例会.
    • Meeting Agenda
    • Meeting Minutes
  • Warmly welcome to submit Pull Requests.

File description

**NOTE: **

How to download latest image

Basic information of the image is as follows. more images

Version

System user(password)

Release date

Size

Kernel version

Repository of rootfs
openEuler 24.09 alpha1
  • root (openeuler)
  • pi (raspberry)

2024/10/14

271 MiB

6.6.0-45.0.0.9

 openEuler 24.09 repository
openEuler 24.09 alpha1 (UKUI desktop and Chinese input method)
  • root (openeuler)
  • pi (raspberry)

2024/10/14

1.6 GiB

6.6.0-45.0.0.9

 openEuler 24.09 repository
openEuler 24.09 alpha1 (DDE desktop and Chinese input method)
  • root (openeuler)
  • pi (raspberry)

2024/10/14

1.7 GiB

6.6.0-45.0.0.9

 openEuler 24.09 repository
openEuler 24.09 alpha1 (Xfce desktop and Chinese input method)
  • root (openeuler)
  • pi (raspberry)

2024/10/14

2.2 GiB

6.6.0-45.0.0.9

 openEuler 24.09 repository
openEuler 24.09 alpha1 (EFI boot)
  • root (openeuler)
  • pi (raspberry)

2024/10/14

298 MiB

6.6.0-46.0.0.10

 openEuler 24.09 repository
openEuler 24.09
  • root（openeuler）
  • pi（raspberry）

2024/09/29

268 MiB

6.6.0-45.0.0.9

 openEuler 24.09 repository
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
openEuler 24.03 LTS alpha1
  • root (openeuler)
  • pi (raspberry)

2024/06/24

214 MiB

6.6.0-26.0.0.4

 openEuler 24.03 LTS repository
openEuler 24.03 LTS alpha1 (UKUI desktop and Chinese input method)
  • root (openeuler)
  • pi (raspberry)

2024/06/24

1.6 GiB

6.6.0-26.0.0.4

 openEuler 24.03 LTS repository
openEuler 24.03 LTS alpha1 (DDE desktop and Chinese input method)
  • root (openeuler)
  • pi (raspberry)

2024/06/24

1.7 GiB

6.6.0-26.0.0.4

 openEuler 24.03 LTS repository
openEuler 24.03 LTS alpha1 (Xfce desktop and Chinese input method)
  • root (openeuler)
  • pi (raspberry)

2024/06/24

2.2 GiB

6.6.0-26.0.0.4

 openEuler 24.03 LTS repository
openEuler 24.03 LTS alpha1 (EFI boot)
  • root (openeuler)
  • pi (raspberry)

2024/06/24

330 MiB

6.6.0-30.0.0.6

 openEuler 24.03 LTS repository
openEuler 24.03 LTS
  • root（openeuler）
  • pi（raspberry）

2024/06/04

244 MiB

6.6.0-26.0.0.4

 openEuler 24.03 LTS repository

Other information:

How to Use image

Refer to Install openEuler on an SD card and How to use Raspberry Pi for details about how to use the image on Raspberry Pi.

How to build image locally

Prepare the environment

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

  • OS: openEuler or CentOS 7/8
  • Hardware: AArch64 hardware, such as Raspberry Pi

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

Run the scripts to build image

Refer to Script for building openEuler image for Raspberry Pi for details.

Quickly Build without kernel compilation(Recommended)

NOTICE:
Most openEuler versions are currently supported, i.e., 20.09, 20.03 LTS SP1, 21.03, 20.03 LTS SP2, 21.09, 20.03 LTS SP3, 22.03 LTS, 22.09, 22.03 LTS SP1, 23.03, 22.03 LTS SP2, 22.03 LTS SP3, 24.03 LTS, 22.03 LTS SP4 and 24.09. When building an image with Xfce/UKUI/DDE desktop environment, you need to pay attention to three issues:

  1. For building an image with Xfce desktop environment, note that only openEuler 21.03, 20.03 LTS SP2, 21.09, 20.03 LTS SP3, 22.03 LTS, 22.09, 22.03 LTS SP1, 23.03, 22.03 LTS SP2, 22.03 LTS SP3, 24.03 LTS, 22.03 LTS SP4 and 24.09 are currently supported.
  2. For building an image with DDE desktop environment, note that only openEuler 20.03 LTS SP1, 21.03, 20.03 LTS SP2, 21.09, 20.03 LTS SP3, 22.03 LTS, 22.09, 22.03 LTS SP1, 23.03, 22.03 LTS SP2, 22.03 LTS SP3, 24.03 LTS, 22.03 LTS SP4 and 24.09 are currently supported.
  3. Need to set the parameter -s/--spec. Please refer to the description of this parameter for details.

Build images with packages of raspberrypi-kernel, raspberrypi-firmware, and raspberrypi-bluetooth.

Run the following command to build an image:

sudo bash build-image.sh -d DIR -r REPO -n IMAGE_NAME -s SPEC

The meaning of each parameter:

  1. -d, --dir DIR

    The directory for storing the image and other temporary files, which defaults to be the directory in which the script resides. If the DIR does not exist, it will be created automatically.

    After building the image, you can find the image in DIR/raspi_output/img/ as shown in the script output.

  2. -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-21.03/generic.repo.
    • The path of target repo file:
    • List of repo's baseurls: "http://repo.openeuler.org/openEuler-21.03/OS/aarch64/ http://repo.openeuler.org/openEuler-21.03/EPOL/aarch64/".

  3. -n, --name IMAGE_NAME

    The image name to be built.

    For example, openEuler-21.03.img. The default is openEuler-raspi-aarch64.img, or it is automatically generated based on parameter: -n, --name IMAGE_NAME.

  4. -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 without CJK fonts and IME.
    • dde, image with DDE desktop environment and fundamental software without CJK fonts and IME.
    • 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.

  5. -h, --help

    Display help information.

Build with kernel compilation

Here, we provide two approaches to build an image, which both include compiling kernel and downloading firmware files of Raspberry Pi. These approaches will take considerably longer.

NOTICE:
Three openEuler versions are currently supported, i.e., 20.03 LTS, 20.09, 20.03 LTS SP1, 21.03, 20.03 LTS SP2, 21.09, 20.03 LTS SP3, 22.03 LTS, 22.09, 22.03 LTS SP1, 23.03, 22.03 LTS SP2, 22.03 LTS SP3, 24.03 LTS, 22.03 LTS SP4 and 24.09. When building an image with Xfce/UKUI/DDE desktop environment, you need to pay attention to four issues:

  1. For building an image with Xfce desktop environment, note that only openEuler 21.03, 20.03 LTS SP2, 21.09, 20.03 LTS SP3, 22.03 LTS, 22.09, 22.03 LTS SP1, 23.03, 22.03 LTS SP2, 22.03 LTS SP3, 24.03 LTS, 22.03 LTS SP4 and 24.09 are currently supported.
    • openEuler 21.03: You need to select the branch openEuler-21.03 of the openEuler kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/kernel.git and set the parameter -b/--branch to openEuler-21.03.
    • openEuler 20.03 LTS SP2/20.03 LTS SP3: You need to select the branch openEuler-20.03-LTS of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to openEuler-20.03-LTS.
    • openEuler 21.09: You need to select the branch openEuler-21.09 of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to openEuler-21.09.
    • openEuler 22.03 LTS: You need to select the branch openEuler-22.03-LTS of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to openEuler-22.03-LTS.
    • openEuler 22.09: You need to select the branch openEuler-22.09 of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to openEuler-22.09.
    • openEuler 22.03 LTS SP1: You need to select the branch openEuler-22.03-LTS-SP1 of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to openEuler-22.03-LTS-SP1.
    • openEuler 23.03: You need to select the branch openEuler-23.03 of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to openEuler-23.03.
    • openEuler 22.03 LTS SP2: You need to select the branch openEuler-22.03-LTS-SP2 of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to openEuler-22.03-LTS-SP2.
    • openEuler 22.03 LTS SP3/22.03 LTS SP4: You need to select the branch OLK-5.10 of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to OLK-5.10.
    • openEuler 24.03 LTS/24.09: You need to select the branch OLK-6.6 of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to OLK-6.6.
  2. For building an image with UKUI desktop environment, note that only openEuler 20.09, 20.03 LTS SP1, 21.03, 20.03 LTS SP2, 21.09, 20.03 LTS SP3, 22.03 LTS, 22.09, 22.03 LTS SP1, 23.03, 22.03 LTS SP2, 22.03 LTS SP3, 24.03 LTS, 22.03 LTS SP4 and 24.09 are currently supported.
    • openEuler 20.09: You need to select the branch openEuler-20.09 of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to openEuler-20.09.
    • openEuler 20.03 LTS SP1/20.03 LTS SP2/20.03 LTS SP3: You need to select the branch openEuler-20.03-LTS of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to openEuler-20.03-LTS.
    • openEuler 21.03: You need to select the branch openEuler-21.03 of the openEuler kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/kernel.git and set the parameter -b/--branch to openEuler-21.03.
    • openEuler 21.09: You need to select the branch openEuler-21.09 of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to openEuler-21.09.
    • openEuler 22.03 LTS: You need to select the branch openEuler-22.03-LTS of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to openEuler-22.03-LTS.
    • openEuler 22.09: You need to select the branch openEuler-22.09 of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to openEuler-22.09.
    • openEuler 22.03 LTS SP1: You need to select the branch openEuler-22.03-LTS-SP1 of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to openEuler-22.03-LTS-SP1.
    • openEuler 23.03: You need to select the branch openEuler-23.03 of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to openEuler-23.03.
    • openEuler 22.03 LTS SP2: You need to select the branch openEuler-22.03-LTS-SP2 of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to openEuler-22.03-LTS-SP2.
    • openEuler 22.03 LTS SP3/22.03 LTS SP4: You need to select the branch OLK-5.10 of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to OLK-5.10.
    • openEuler 24.03 LTS/24.09: You need to select the branch OLK-6.6 of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to OLK-6.6.
  3. For building an image with DDE desktop environment, note that only openEuler 20.03 LTS SP1, 21.03, 20.03 LTS SP2, 21.09, 20.03 LTS SP3, 22.03 LTS, 22.09, 22.03 LTS SP1, 23.03, 22.03 LTS SP2, 22.03 LTS SP3, 24.03 LTS, 22.03 LTS SP4 and 24.09 are currently supported.
    • openEuler 20.03 LTS SP1/20.03 LTS SP2/20.03 LTS SP3: You need to select the branch openEuler-20.03-LTS of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to openEuler-20.03-LTS.
    • openEuler 21.03: You need to select the branch openEuler-21.03 of the openEuler kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/kernel.git and set the parameter -b/--branch to openEuler-21.03.
    • openEuler 21.09: You need to select the branch openEuler-21.09 of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to openEuler-21.09.
    • openEuler 22.03 LTS: You need to select the branch openEuler-22.03-LTS of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to openEuler-22.03-LTS.
    • openEuler 22.09: You need to select the branch openEuler-22.09 of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to openEuler-22.09.
    • openEuler 22.03 LTS SP1: You need to select the branch openEuler-22.03-LTS-SP1 of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to openEuler-22.03-LTS-SP1.
    • openEuler 23.03: You need to select the branch openEuler-23.03 of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to openEuler-23.03.
    • openEuler 22.03 LTS SP2: You need to select the branch openEuler-22.03-LTS-SP2 of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to openEuler-22.03-LTS-SP2.
    • openEuler 22.03 LTS SP3/22.03 LTS SP4: You need to select the branch OLK-5.10 of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to OLK-5.10.
    • openEuler 24.03 LTS/24.09: You need to select the branch OLK-6.6 of the openEuler-RaspberryPi kernel, i.e., set the parameter -k/--kernel to git@gitee.com:openeuler/raspberrypi-kernel.git and set the parameter -b/--branch to OLK-6.6.
  4. Need to set the parameter -s/--spec. Please refer to the description of this parameter for details.
Build on host

Run the following command to build an image:

sudo bash build-image-common.sh -n IMAGE_NAME -k KERNEL_URL -b KERNEL_BRANCH -c KERNEL_DEFCONFIG -r REPO -s SPEC --cores N

After building the image, you can find the image in raspi_output_common/img/ of the directory in which the script resides as shown in the script output.

The meaning of each parameter:

  1. -n, --name IMAGE_NAME

    The image name to be built.

    For example, openEuler-20.03-LTS-SP1.img. The default is openEuler-raspi-aarch64.img, or it is automatically generated based on parameter: -n, --name IMAGE_NAME.

  2. -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.

  3. -b, --branch KERNEL_BRANCH

    The branch name of kernel source repository, which defaults to openEuler-20.03-LTS. openEuler-21.09, openEuler-20.03-LTS or openEuler-20.09 is recommended.

  4. -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.

  5. -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-SP1/generic.repo
    • The path of target repo file:
    • List of repo's baseurls: "http://repo.openeuler.org/openEuler-20.03-LTS-SP1/OS/aarch64/ http://repo.openeuler.org/openEuler-20.03-LTS-SP1/EPOL/aarch64/".

  6. -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 without CJK fonts and IME.
    • dde, image with DDE desktop environment and fundamental software without CJK fonts and IME.
    • 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.

  7. --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.

Build in a Docker container

Run the following command to build an image:

sudo bash build-image-docker.sh -d DOCKER_FILE -n IMAGE_NAME -k KERNEL_URL -b KERNEL_BRANCH -c KERNEL_DEFCONFIG -r REPO --cores N

After building the image, you can find the image in raspi_output_common/img/ 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:

  1. -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.