raspberrypi

English | 简体中文

本仓库是 openEuler 社区树莓派 SIG 组的主仓库，提供 SIG 组相关信息以及适用于树莓派的 openEuler 镜像的构建脚本和相关文档。

此外，树莓派 SIG 还致力于将 openEuler 移植到其他开发板，例如 Rockchip、全志。

• raspberrypi
  • To Do List
  • 如何参与 SIG 组
  • 文件说明
  • 最新镜像
  • 使用镜像
  • 镜像构建
    • 准备环境
    • 构建镜像
      • 快速构建（无需编译内核，推荐）
      • 完全构建（包括编译内核）
        • 主机上构建
        • Docker 容器内构建

To Do List

1. 树莓派
   1. openEuler 22.09 适配到树莓派
   2. 树莓派 CM4 核心板适配、测试
2. Rockchip
   1. openEuler 22.09 适配到 RK3399
   2. openEuler 22.03 LTS (Next) 适配到 Rockchip 开发板
   3. openEuler 22.03 LTS (Next) 适配到 ITX-3588J 开发板
3. 全志
   1. openEuler 5.10 内核适配到全志开发板

如何参与 SIG 组

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

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

文件说明

说明：

• 建议直接使用本文档 最新镜像 章节中给出的 openEuler 的树莓派镜像。
• 如需根据自身需求定制镜像，可参考 openEuler 镜像的构建 和 交叉编译内核。

• documents: 使用文档
  • 刷写镜像
  • 树莓派使用
  • openEuler 镜像的构建
  • 交叉编译内核
  • QEMU 启动树莓派
  • openEuler 20.03 LTS SP2 更新日志
  • openEuler 20.03 LTS SP2 内测版（UKUI 桌面、中文输入法）更新日志
  • openEuler 20.03 LTS SP2 内测版（DDE 桌面、中文输入法）更新日志
  • openEuler 20.03 LTS SP2 内测版（Xfce 桌面、中文输入法）更新日志
  • openEuler 21.09 更新日志
  • openEuler 21.09 内测版（UKUI 桌面、中文输入法）更新日志
  • openEuler 21.09 内测版（DDE 桌面、中文输入法）更新日志
  • openEuler 21.09 内测版（Xfce 桌面、中文输入法）更新日志
  • openEuler 21.09 内测版（LXDE 桌面、中文输入法）更新日志
• scripts: 构建 openEuler 树莓派镜像的脚本
  • 快速构建（不编译内核）
  • 主机上构建（编译内核）
  • Docker 容器中构建（编译内核）

最新镜像

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

其他信息：

• 固件来源：firmware、bluez-firmware、firmware-nonfree

使用镜像

镜像刷写 SD 卡并使用树莓派，详见以下文档：

• 刷写镜像
• 树莓派使用

镜像构建

准备环境

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

• 操作系统：openEuler、CentOS 7、CentOS 8
• 架构：AArch64，如树莓派

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

构建镜像

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

快速构建（无需编译内核，推荐）

须知：
当前支持多个 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 版本。 如果构建包含 Xfce/UKUI/DDE 桌面环境的镜像，需要注意三点：

1. 构建包含 Xfce 桌面环境的镜像，当前只支持 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 版本。
2. 构建包含 DDE 桌面环境的镜像，当前只支持 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 版本。
3. 根据需要设置 -s/--spec，其具体意义见该参数的介绍部分。

使用已有的树莓派内核、固件、蓝牙等 RPM 包构建镜像。

构建镜像需执行命令：

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

各个参数意义：

1. -d, --dir DIR

   构建镜像和临时文件的输出目录，默认为脚本所在目录。如果 DIR 不存在则会自动创建。

   脚本运行结束后，会提示镜像的存储位置，默认保存在 DIR/raspi_output/img/ 下。

2. -r, --repo REPO_INFO

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

   下面分别举例：

   • 开发源 repo 文件的 URL，如 https://gitee.com/src-openeuler/openEuler-repos/raw/openEuler-21.03/generic.repo。
   • 开发源的 repo 文件路径：
     • ./openEuler-21.03.repo：生成 openEuler 21.03 版本的镜像，该文件内容参考 https://gitee.com/src-openeuler/openEuler-repos/blob/openEuler-21.03/generic.repo。
   • 资源库的 baseurl 列表，如 "http://repo.openeuler.org/openEuler-21.03/OS/aarch64/ http://repo.openeuler.org/openEuler-21.03/EPOL/aarch64/"。

3. -n, --name IMAGE_NAME

   构建的镜像名称。

   例如，openEuler-21.03.img。默认为openEuler-raspi-aarch64.img，或者根据 -n, --name IMAGE_NAME 参数自动生成。

4. -s, --spec SPEC

   构建的镜像版本：

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

   默认使用 headless 选项。

5. -h, --help

   显示帮助信息。

完全构建（包括编译内核）

包含编译内核、下载树莓派相关固件等过程，速度相对较慢。

这里，提供两种构建方式。

须知：
当前支持三个 openEuler 版本，即 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 版本。 如果构建包含 Xfce/UKUI/DDE 桌面环境的镜像，需要注意四点：

1. 构建包含 Xfce 桌面环境的镜像，当前只支持 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 版本，需要选择对应内核源码和分支。
   • openEuler 21.03：需要选择 openEuler 内核 的 openEuler-21.03 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/kernel.git，-b/--branch设置为openEuler-21.03`。
   • openEuler 20.03 LTS SP2/20.03 LTS SP3：需要选择 openEuler-RaspberryPi 内核 的 openEuler-20.03-LTS 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 openEuler-20.03-LTS。
   • openEuler 21.09：需要选择 openEuler-RaspberryPi 内核 的 openEuler-21.09 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 openEuler-21.09。
   • openEuler 22.03 LTS：需要选择 openEuler-RaspberryPi 内核 的 openEuler-22.03-LTS 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 openEuler-22.03-LTS。
   • openEuler 22.09：需要选择 openEuler-RaspberryPi 内核 的 openEuler-22.09 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 openEuler-22.09。
   • openEuler 22.03 LTS SP1：需要选择 openEuler-RaspberryPi 内核 的 openEuler-22.03-LTS-SP1 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 openEuler-22.03-LTS-SP1。
   • openEuler 23.03：需要选择 openEuler-RaspberryPi 内核 的 openEuler-23.03 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 openEuler-23.03。
   • openEuler 22.03 LTS SP2：需要选择 openEuler-RaspberryPi 内核 的 openEuler-22.03-LTS-SP2 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 openEuler-22.03-LTS-SP2。
   • openEuler 22.03 LTS SP3：需要选择 openEuler-RaspberryPi 内核 的 OLK-5.10 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 OLK-5.10。
2. 构建包含 UKUI 桌面环境的镜像，当前只支持 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 版本，需要选择对应内核源码和分支。
   • openEuler 20.09：需要选择 openEuler-RaspberryPi 内核 的 openEuler-20.09 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 openEuler-20.09。
   • openEuler 20.03 LTS SP1/20.03 LTS SP2/20.03 LTS SP3：需要选择 openEuler-RaspberryPi 内核 的 openEuler-20.03-LTS 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 openEuler-20.03-LTS。
   • openEuler 21.03：需要选择 openEuler 内核 的 openEuler-21.03 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/kernel.git，-b/--branch设置为openEuler-21.03`。
   • openEuler 21.09：需要选择 openEuler-RaspberryPi 内核 的 openEuler-21.09 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 openEuler-21.09。
   • openEuler 22.03 LTS：需要选择 openEuler-RaspberryPi 内核 的 openEuler-22.03-LTS 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 openEuler-22.03-LTS。
   • openEuler 22.09：需要选择 openEuler-RaspberryPi 内核 的 openEuler-22.09 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 openEuler-22.09。
   • openEuler 22.03 LTS SP1：需要选择 openEuler-RaspberryPi 内核 的 openEuler-22.03-LTS-SP1 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 openEuler-22.03-LTS-SP1。
   • openEuler 23.03：需要选择 openEuler-RaspberryPi 内核 的 openEuler-23.03 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 openEuler-23.03。
   • openEuler 22.03 LTS SP2：需要选择 openEuler-RaspberryPi 内核 的 openEuler-22.03-LTS-SP2 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 openEuler-22.03-LTS-SP2。
   • openEuler 22.03 LTS SP3：需要选择 openEuler-RaspberryPi 内核 的 OLK-5.10 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 OLK-5.10。
3. 构建包含 DDE 桌面环境的镜像，当前只支持 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 版本。
   • openEuler 20.03 LTS SP1/20.03 LTS SP2/20.03 LTS SP3：需要选择 openEuler-RaspberryPi 内核 的 openEuler-20.03-LTS 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 openEuler-20.03-LTS。
   • openEuler 21.03：需要选择 openEuler 内核 的 openEuler-21.03 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/kernel.git，-b/--branch设置为openEuler-21.03`。
   • openEuler 21.09：需要选择 openEuler-RaspberryPi 内核 的 openEuler-21.09 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 openEuler-21.09。
   • openEuler 22.03 LTS：需要选择 openEuler-RaspberryPi 内核 的 openEuler-22.03-LTS 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 openEuler-22.03-LTS。
   • openEuler 22.09：需要选择 openEuler-RaspberryPi 内核 的 openEuler-22.09 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 openEuler-22.09。
   • openEuler 22.03 LTS SP1：需要选择 openEuler-RaspberryPi 内核 的 openEuler-22.03-LTS-SP1 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 openEuler-22.03-LTS-SP1。
   • openEuler 23.03：需要选择 openEuler-RaspberryPi 内核 的 openEuler-23.03 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 openEuler-23.03。
   • openEuler 22.03 LTS SP2：需要选择 openEuler-RaspberryPi 内核 的 openEuler-22.03-LTS-SP2 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 openEuler-22.03-LTS-SP2。
   • openEuler 22.03 LTS SP3：需要选择 openEuler-RaspberryPi 内核 的 OLK-5.10 分支，即将参数 -k/--kernel 设置为 git@gitee.com:openeuler/raspberrypi-kernel.git，-b/--branch 设置为 OLK-5.10。
4. 根据需要设置 -s/--spec，其具体意义见该参数的介绍部分。

主机上构建

构建镜像需执行命令：

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

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

各个参数意义：

1. -n, --name IMAGE_NAME

   构建的镜像名称。

   例如，openEuler-20.03-LTS-SP1.img。默认为openEuler-raspi-aarch64.img，或者根据 -n, --name IMAGE_NAME 参数自动生成。

2. -k, --kernel KERNEL_URL

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

3. -b, --branch KERNEL_BRANCH

   内核源码的对应分支，默认为 openEuler-20.03-LTS，推荐使用分支 openEuler-21.09、openEuler-20.03-LTS 或 openEuler-20.09。

4. -c, --config KERNEL_DEFCONFIG

   内核编译使用的配置文件名称或路径，默认为 openeuler-raspi_defconfig。如果该参数为配置文件名称，请确保该文件在内核源码的目录 arch/arm64/configs 下。

5. -r, --repo REPO_INFO

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

   下面分别举例：

   • 开发源 repo 文件的 URL，如 https://gitee.com/src-openeuler/openEuler-repos/raw/openEuler-20.03-LTS-SP1/generic.repo
   • 开发源的 repo 文件路径：
     • ./openEuler-20.03-LTS-SP1.repo：生成 openEuler 20.03 LTS SP1 版本的镜像，该文件内容参考 https://gitee.com/src-openeuler/openEuler-repos/blob/openEuler-20.03-LTS-SP1/generic.repo。
   • 资源库的 baseurl 列表，如 "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

   构建的镜像版本：

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

   默认使用 headless 选项。

7. --cores N

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

Docker 容器内构建

构建镜像需执行命令：

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

脚本运行结束后，镜像默认保存在脚本运行所在目录的 raspi_output_common/img/ 下。

注意！！！运行该脚本前，需安装 Docker 运行环境。该脚本会自动将 DOCKER_FILE 参数对应的 Docker 镜像导入本机系统中。

除参数 DOCKER_FILE 外，剩余参数与主机上构建中对应参数一致：

1. -d, --docker DOCKER_FILE

   Docker 镜像的 URL 或者路径， 默认为 https://repo.openeuler.org/openEuler-20.03-LTS-SP1/docker_img/aarch64/openEuler-docker.aarch64.tar.xz。使用该默认参数时，脚本会自动下载 openEuler 20.03 LTS SP1 的 Docker 镜像，并导入本机系统中。