si0ls / talos-orangepi5

Tools and patches to build Talos Linux for Orange Pi 5

Talos for Orange Pi 5

This repository provides Talos Linux support for the Orange Pi 5 and Orange Pi 5 Plus.

Upstream dependencies

This repo uses upstream dependencies that are not in sync with the last Talos version.

I choose to stick to the mainline kernel to simplify the future updates and to have the latest features and fixes.

⚠️ As this repo use the mainline kernel with patches, the full support of the Orange Pi 5 is not guaranteed (e.g. HDMI is not working).

• Linux kernel: v6.10 (with Armbian patches)
• Talos Linux: v1.8.0-alpha.1

The best effort is made to keep the overlay in sync with the upstream dependencies. This repository will be updated as soon as the new versions are available.

Install

The images provided in this repository do not includes a bootloader as the Orange Pi 5 is equipped with a SPI flash that can be flashed with the bootloader.

Flash the bootloader

The images provided in this repository are made to be booted with U-Boot or EDK2 UEFI firmware.

I provide U-Boot builds for Orange Pi 5 (and variants) in the u-boot-orangepi5 repository. The informations to flash the bootloader are described in the repository README.

You can also flash EDK2 UEFI firmware for Rockchip RK3588 platforms (not tested).

The device tree are included in the image at the paths required by U-Boot and EDK2.

Install Talos Linux

Install on a drive

The Talos image can be flashed on an SD card, a NVMe drive, or a SATA drive.

You can download the latest image from the releases page.

You can choose between the following images:

• talos-orangepi5.raw.zst: the base image for Orange Pi 5 (Plus), flashable on a SD card, eMMC, M.2 NVMe drive, USB drive, or USB-connected SATA drive
• talos-orangepi5-sata.raw.zst: the base image for Orange Pi 5 (Plus) with SATA overlay applied, flashable on a M.2 SATA drive

The image can be flashed using Etcher on Windows, macOS, or Linux or using dd on Linux:

# Extract the image for the variant you want to flash
zstd -d talos-orangepi5[-sata].raw.zst

# Flash the image
# Replace /dev/sdX with the device of the SD card, NVMe drive, or SATA drive
# You can find the device with `lsblk` or `fdisk -l`
dd if=talos-orangepi5[-sata].raw of=/dev/sdX bs=4M status=progress

PXE Boot

This repository does not provide a PXE server, it is up to you to set up the PXE server.

The release page provides the following files needed for PXE boot:

• kernel-arm64 (the kernel)
• initramfs-metal-arm64.xz (the initramfs)
• rk3588s-orangepi-5.dtb and rk3588-orangepi-5-plus.dtb (the device tree blobs)

Machine configuration

Use the ghcr.io/si0ls/talos-orangepi5 images instead of the upstream Talos Linux images. It also available with the SATA overlay with the ghcr.io/si0ls/talos-orangepi5-sata image.

machine:
  install:
    disk: /dev/sda # replace with the device you want to install Talos on
    image: ghcr.io/si0ls/talos-orangepi5[-sata]:v1.1
    wipe: false

To upgrade you machine to the latest version with talosctl, you can use the following command:

talosctl upgrade --nodes <node-ip> \
      --image ghcr.io/si0ls/talos-orangepi5[-sata]:<version>

Build

Clone the repository and build Talos Linux for Orange Pi 5:

git clone https://github.com/si0ls/talos-orangepi5.git
cd talos-orangepi5
make

The image will be available in the out directory.

The detail of all the build steps and parameters can be found in the Makefile.

License

This project is not affiliated with Xunlong, Orange Pi, Armbian, or Sidero Labs.

The code in this repository is licensed under the Mozilla Public License Version 2.0 to respect the Talos project license.

Special thanks

• Sidero Labs for the Talos project
• Armbian for the rk3588 kernel
• @nberlee and @pl4nty for the initial work on other rk3588 devices and their help ❤️

talos-orangepi5's Issues

U-Boot: fail when loading sata DT overlays

When booting the sata variant of the Talos Orange Pi 5 Linux image with U-Boot (and forcing to use the boot.scr), the following error appears:

Boot script loaded from mmc 0:1
201 bytes read in 3 ms (65.4 KiB/s)
155648 bytes read in 17 ms (8.7 MiB/s)
147552 bytes read in 16 ms (8.8 MiB/s)
Working FDT set to 12000000
350 bytes read in 4 ms (85 KiB/s)
Applying kernel provided DT overlay dtb/overlays/rockchip-rk3588-sata1.dtbo
failed on fdt_overlay_apply(): FDT_ERR_NOTFOUND
350 bytes read in 3 ms (113.3 KiB/s)
Applying kernel provided DT overlay dtb/overlays/rockchip-rk3588-sata2.dtbo
failed on fdt_overlay_apply(): FDT_ERR_BADMAGIC
base fdt does not have a /__symbols__ node
make sure you've compiled with -@
Error applying DT overlays, restoring original DT
147552 bytes read in 16 ms (8.8 MiB/s)
�7�[r�[999;999H�[6n�8Failed to load EFI variables
Booting /\EFI\BOOT\BOOTAA64.EFI
�[0;37;40m�[0;37;40m�[0;37;40m�[2J�[1;1H�[0;37;40m�[2;28HGNU GRUB  version 2.12~rc1

Missing images for orange pi 5 Plus

Hi,

As the title says, there doesn't seem to be any Orange Pi 5 Plus images published in the v1.0 release. Is that intended?

If so, is there a way I can specifically build 5 Plus images from source? I saw the makefile and it only seems to be building for the Orange Pi 5. Any help on building them would be appreciated

Request: support for Orange Pi 5 Max

Hi. Could you comment on how much effort it would be to add support for the Orange Pi 5 Max? The board is similar to the Plus (RK3588 & 2.5G ethernet, but uses LPDDR5 RAM). Is this something you'd be interested in working on?

I'm looking for a few SBC boards for a project, and RK3588 seems more interesting than an RPI5. The problem is always software, and projects like this help with filling that gap. Thanks!