feat: add support for orange pi 5 max

alardev · frezbo · commit 00c63de5ff67 · 2025-11-06T13:49:53.000+05:30
added support for Orange Pi 5 Max
updated uboot_rk1 version to 2025.07 -- needed for Orange Pi 5 Max
updated Orange Pi 5 Plus patches and Turing rk1 patches due to the newer uboot_rk1

Signed-off-by: alardev &lt;14848618+alardev@users.noreply.github.com&gt;
Signed-off-by: Noel Georgi &lt;git@frezbo.dev&gt;
Signed-off-by: Paul Robertson &lt;me@perobertson.com&gt;
Signed-off-by: Noel Georgi &lt;git@frezbo.dev&gt;
diff --git a/MAINTAINERS.md b/MAINTAINERS.md
@@ -14,6 +14,7 @@ This document contains a list of maintainers in this repo. For now, you become a
 | nanopi-r5s           | NanoPi R5S            | [#16](https://github.com/siderolabs/sbc-rockchip/pull/16) | RK3568  | Nicklas Frahm                    | [nicklasfrahm](https://github.com/nicklasfrahm) |
 | odroid-m1            | Hardkernel Odroid M1  | [#67](https://github.com/siderolabs/sbc-rockchip/pull/67) | RK3568  | Albert Lloveras Carbonell        | [alloveras](https://github.com/alloveras)       |
 | orangepi-5           | Orange Pi 5           | [#47](https://github.com/siderolabs/sbc-rockchip/pull/47) | RK3588s | Laurin Streng                    | [laurinstreng](https://github.com/LaurinStreng) |
+| orangepi-5-max       | Orange Pi 5 Max       | [#77](https://github.com/siderolabs/sbc-rockchip/pull/77) | RK3588  | Alar Okas                        | [alardev](https://github.com/alardev)           |
 | orangepi-5-plus      | Orange Pi 5 Plus      | [#52](https://github.com/siderolabs/sbc-rockchip/pull/52) | RK3588  | Ryan Persée                      | [rpersee](https://github.com/rpersee)           |
 | orangepi-r1-plus-lts | Orange Pi R1 Plus LTS | [#9](https://github.com/siderolabs/sbc-rockchip/pull/9)   | RK3328  | Giau. Tran Minh                  | [giautm](https://github.com/giautm)             |
 | radxa-zero-3e        | Radxa ZERO 3E         | [#71](https://github.com/siderolabs/sbc-rockchip/pull/71) | RK3566  | Noah Craig                       | [tyraeis](https://github.com/tyraeis)           |
diff --git a/README.md b/README.md
@@ -11,6 +11,7 @@ This repo provides the overlay for RockChip based Talos image.
 | nanopi-r5s           | NanoPi R5S            | RK3568  | Overlay for NanoPi R5S (only WAN, no NVMe)    |
 | odroid-m1            | Hardkernel Odroid M1  | RK3568  | Overlay for Hardkernel's Odroid M1            |
 | orangepi-5           | Orange Pi 5           | RK3588s | Overlay for Orange Pi 5                       |
+| orangepi-5-max       | Orange Pi 5 Max       | RK3588  | Overlay for Orange Pi 5 Max                   |
 | orangepi-5-plus      | Orange Pi 5 Plus      | RK3588  | Overlay for Orange Pi 5 Plus                  |
 | orangepi-r1-plus-lts | Orange Pi R1 Plus LTS | RK3328  | Overlay for Orange Pi R1 Plus LTS             |
 | radxa-zero-3e        | Radxa ZERO 3E         | RK3566  | Overlay for Radxa ZERO 3E                     |
diff --git a/artifacts/orangepi-5-max/u-boot/patches/uboot-byteorder.patch b/artifacts/orangepi-5-max/u-boot/patches/uboot-byteorder.patch
@@ -0,0 +1,15 @@
+diff --git a/include/linux/byteorder/little_endian.h b/include/linux/byteorder/little_endian.h
+index a4cb3bfde52..0ecd088f4a2 100644
+--- a/include/linux/byteorder/little_endian.h
++++ b/include/linux/byteorder/little_endian.h
+@@ -7,7 +7,10 @@
+ #ifndef __LITTLE_ENDIAN_BITFIELD
+ #define __LITTLE_ENDIAN_BITFIELD
+ #endif
++
++#ifndef __BYTE_ORDER
+ #define       __BYTE_ORDER    __LITTLE_ENDIAN
++#endif
+
+ #include <linux/compiler.h>
+ #include <linux/types.h>
diff --git a/artifacts/orangepi-5-max/u-boot/patches/uboot-pcienum.patch b/artifacts/orangepi-5-max/u-boot/patches/uboot-pcienum.patch
@@ -0,0 +1,12 @@
+diff --git a/configs/orangepi-5-max-rk3588_defconfig b/configs/orangepi-5-max-rk3588_defconfig
+index 4a99c06cde1..4e23ab8f44e 100644
+--- a/configs/orangepi-5-max-rk3588_defconfig
++++ b/configs/orangepi-5-max-rk3588_defconfig
+@@ -27,6 +27,7 @@ CONFIG_LEGACY_IMAGE_FORMAT=y
+ CONFIG_DEFAULT_FDT_FILE="rockchip/rk3588-orangepi-5-max.dtb"
+ # CONFIG_DISPLAY_CPUINFO is not set
+ CONFIG_DISPLAY_BOARDINFO_LATE=y
++CONFIG_PCI_INIT_R=y
+ CONFIG_SPL_MAX_SIZE=0x40000
+ # CONFIG_SPL_RAW_IMAGE_SUPPORT is not set
+ CONFIG_SPL_SPI_LOAD=y
diff --git a/artifacts/orangepi-5-max/u-boot/pkg.yaml b/artifacts/orangepi-5-max/u-boot/pkg.yaml
@@ -0,0 +1,41 @@
+# References:
+#   U-Boot:
+#     - https://u-boot.readthedocs.io/en/latest
+name: u-boot-orangepi-5-max
+variant: scratch
+shell: /bin/bash
+dependencies:
+  - stage: base
+  - stage: arm-trusted-firmware-rk3588
+  - stage: rkbin-rk3588
+    platform: linux/amd64
+
+steps:
+  - sources:
+      - url: https://ftp.denx.de/pub/u-boot/u-boot-{{ .uboot_rk1_version }}.tar.bz2
+        destination: u-boot.tar.bz2
+        sha256: "{{ .uboot_rk1_sha256 }}"
+        sha512: "{{ .uboot_rk1_sha512 }}"
+    env:
+      SOURCE_DATE_EPOCH: {{ .BUILD_ARG_SOURCE_DATE_EPOCH }}
+    prepare:
+      # orangepi-5-max-rk3588
+      - |
+        tar xf u-boot.tar.bz2 --strip-components=1
+
+        for patch in $(find /pkg/patches -type f -name "*.patch" | sort); do
+          echo "Applying $patch"
+          patch -p1 < $patch || (echo "Failed to apply patch $patch" && exit 1)
+        done
+      - |
+        make orangepi-5-max-rk3588_defconfig
+    build:
+      - |
+        make -j $(nproc) HOSTLDLIBS_mkimage="-lssl -lcrypto" BL31=/libs/arm-trusted-firmware/rk3588/bl31.elf ROCKCHIP_TPL=/libs/rkbin/rk3588_ddr_lp4_2112MHz_lp5_2400MHz_v1.19.bin
+    install:
+      - |
+        mkdir -p /rootfs/artifacts/arm64/u-boot/orangepi-5-max
+        cp -v -t /rootfs/artifacts/arm64/u-boot/orangepi-5-max u-boot-rockchip.bin u-boot-rockchip-spi.bin
+finalize:
+  - from: /rootfs
+    to: /rootfs
diff --git a/artifacts/orangepi-5-max/vars.yaml b/artifacts/orangepi-5-max/vars.yaml
@@ -0,0 +1,2 @@
+# renovate: datasource=docker versioning=docker depName=cgr.dev/chainguard/wolfi-base
+WOLFI_BASE_REF: sha256:8dd9ceace8b1574e550374e9c07c2baafa60cc96223c1314fac61bd2edb48c70
diff --git a/artifacts/orangepi-5-plus/u-boot/patches/uboot-pcienum.patch b/artifacts/orangepi-5-plus/u-boot/patches/uboot-pcienum.patch
@@ -1,5 +1,5 @@
 diff --git a/configs/orangepi-5-plus-rk3588_defconfig b/configs/orangepi-5-plus-rk3588_defconfig
-index 9050fceda4..d2c4a6e607 100644
+index 739ce732292..be64f19dd15 100644
 --- a/configs/orangepi-5-plus-rk3588_defconfig
 +++ b/configs/orangepi-5-plus-rk3588_defconfig
 @@ -27,6 +27,7 @@ CONFIG_LEGACY_IMAGE_FORMAT=y
@@ -8,5 +8,5 @@ index 9050fceda4..d2c4a6e607 100644
  CONFIG_DISPLAY_BOARDINFO_LATE=y
 +CONFIG_PCI_INIT_R=y
  CONFIG_SPL_MAX_SIZE=0x40000
- CONFIG_SPL_PAD_TO=0x7f8000
  # CONFIG_SPL_RAW_IMAGE_SUPPORT is not set
+ CONFIG_SPL_SPI_LOAD=y
diff --git a/artifacts/orangepi-5-plus/u-boot/pkg.yaml b/artifacts/orangepi-5-plus/u-boot/pkg.yaml
@@ -8,7 +8,6 @@ dependencies:
   - stage: base
   - stage: arm-trusted-firmware-rk3588
   - stage: rkbin-rk3588
-    platform: linux/amd64
 
 steps:
   - sources:
diff --git a/artifacts/orangepi-5/u-boot/pkg.yaml b/artifacts/orangepi-5/u-boot/pkg.yaml
@@ -8,7 +8,6 @@ dependencies:
   - stage: base
   - stage: arm-trusted-firmware-rk3588
   - stage: rkbin-rk3588
-    platform: linux/amd64
 
 steps:
   - sources:
diff --git a/artifacts/rock5a/u-boot/pkg.yaml b/artifacts/rock5a/u-boot/pkg.yaml
@@ -8,7 +8,6 @@ dependencies:
   - stage: base
   - stage: arm-trusted-firmware-rk3588
   - stage: rkbin-rk3588
-    platform: linux/amd64
 steps:
   - sources:
       - url: https://ftp.denx.de/pub/u-boot/u-boot-{{ .uboot_version }}.tar.bz2
diff --git a/artifacts/rock5b/u-boot/pkg.yaml b/artifacts/rock5b/u-boot/pkg.yaml
@@ -8,7 +8,6 @@ dependencies:
   - stage: base
   - stage: arm-trusted-firmware-rk3588
   - stage: rkbin-rk3588
-    platform: linux/amd64
 
 steps:
   - sources:
diff --git a/artifacts/rock5t/u-boot/pkg.yaml b/artifacts/rock5t/u-boot/pkg.yaml
@@ -8,7 +8,6 @@ dependencies:
   - stage: base
   - stage: arm-trusted-firmware-rk3588
   - stage: rkbin-rk3588
-    platform: linux/amd64
 
 steps:
   - sources:
diff --git a/artifacts/turingrk1/u-boot/patches/0001-spi-for-mmc-so-nvme-can-boot.patch b/artifacts/turingrk1/u-boot/patches/0001-spi-for-mmc-so-nvme-can-boot.patch
@@ -9,7 +9,7 @@ looked up on the NVMe.
 Signed-off-by: Nico Berlee <nico.berlee@on2it.net>
 
 diff --git a/configs/turing-rk1-rk3588_defconfig b/configs/turing-rk1-rk3588_defconfig
-index 0eddf15833..9413b5ae6a 100644
+index 999d9088bf8..4b40b58fb48 100644
 --- a/configs/turing-rk1-rk3588_defconfig
 +++ b/configs/turing-rk1-rk3588_defconfig
 @@ -3,13 +3,18 @@ CONFIG_SKIP_LOWLEVEL_INIT=y
@@ -31,16 +31,16 @@ index 0eddf15833..9413b5ae6a 100644
  CONFIG_PCI=y
  CONFIG_DEBUG_UART=y
  CONFIG_AHCI=y
-@@ -24,6 +29,8 @@ CONFIG_DISPLAY_BOARDINFO_LATE=y
+@@ -23,6 +28,8 @@ CONFIG_DEFAULT_FDT_FILE="rockchip/rk3588-turing-rk1.dtb"
+ CONFIG_DISPLAY_BOARDINFO_LATE=y
  CONFIG_SPL_MAX_SIZE=0x40000
- CONFIG_SPL_PAD_TO=0x7f8000
  # CONFIG_SPL_RAW_IMAGE_SUPPORT is not set
 +CONFIG_SPL_SPI_LOAD=y
 +CONFIG_SYS_SPI_U_BOOT_OFFS=0x60000
  CONFIG_SPL_ATF=y
  CONFIG_CMD_GPIO=y
  CONFIG_CMD_GPT=y
-@@ -57,7 +64,11 @@ CONFIG_MMC_DW_ROCKCHIP=y
+@@ -56,7 +63,11 @@ CONFIG_MMC_DW_ROCKCHIP=y
  CONFIG_MMC_SDHCI=y
  CONFIG_MMC_SDHCI_SDMA=y
  CONFIG_MMC_SDHCI_ROCKCHIP=y
@@ -53,7 +53,7 @@ index 0eddf15833..9413b5ae6a 100644
  CONFIG_PHY_REALTEK=y
  CONFIG_DWC_ETH_QOS=y
  CONFIG_DWC_ETH_QOS_ROCKCHIP=y
-@@ -73,6 +84,7 @@ CONFIG_SPL_RAM=y
+@@ -72,6 +83,7 @@ CONFIG_SPL_RAM=y
  CONFIG_SCSI=y
  CONFIG_DEBUG_UART_SHIFT=2
  CONFIG_SYS_NS16550_MEM32=y
diff --git a/artifacts/turingrk1/u-boot/pkg.yaml b/artifacts/turingrk1/u-boot/pkg.yaml
@@ -8,7 +8,6 @@ dependencies:
   - stage: base
   - stage: arm-trusted-firmware-rk3588
   - stage: rkbin-rk3588
-    platform: linux/amd64
 
 steps:
   - sources:
diff --git a/go.work b/go.work
@@ -6,6 +6,7 @@ use (
 	./installers/nanopi-r4s/src
 	./installers/odroid-m1/src
 	./installers/orangepi-5/src
+	./installers/orangepi-5-max/src
 	./installers/orangepi-5-plus/src
 	./installers/orangepi-r1-plus-lts/src
 	./installers/radxa-zero-3e/src
diff --git a/installers/orangepi-5-max/pkg.yaml b/installers/orangepi-5-max/pkg.yaml
@@ -0,0 +1,33 @@
+name: orangepi-5-max
+variant: scratch
+shell: /bin/bash
+dependencies:
+  - stage: base
+steps:
+  - env:
+      GOPATH: /tmp/go
+    network: default
+    cachePaths:
+      - /.cache/go-build
+      - /tmp/go/pkg
+    prepare:
+      - |
+        cd /pkg/src
+        go mod download
+  - env:
+      GOPATH: /tmp/go
+    cachePaths:
+      - /.cache/go-build
+      - /tmp/go/pkg
+    build:
+      - |
+        cd /pkg/src
+        CGO_ENABLED=0 go build -o ./orangepi-5-max .
+    install:
+      - |
+        mkdir -p /rootfs/installers/
+
+        cp -p /pkg/src/orangepi-5-max /rootfs/installers/orangepi-5-max
+finalize:
+  - from: /rootfs
+    to: /rootfs
diff --git a/installers/orangepi-5-max/src/go.mod b/installers/orangepi-5-max/src/go.mod
@@ -0,0 +1,11 @@
+module orangepi-5-max
+
+go 1.24.0
+
+require (
+	github.com/siderolabs/go-copy v0.1.0
+	github.com/siderolabs/talos/pkg/machinery v1.9.5
+	golang.org/x/sys v0.32.0
+)
+
+require gopkg.in/yaml.v3 v3.0.1 // indirect
diff --git a/installers/orangepi-5-max/src/go.sum b/installers/orangepi-5-max/src/go.sum
@@ -0,0 +1,10 @@
+github.com/siderolabs/go-copy v0.1.0 h1:OIWCtSg+rhOtnIZTpT31Gfpn17rv5kwJqQHG+QUEgC8=
+github.com/siderolabs/go-copy v0.1.0/go.mod h1:4bF2rZOZAR/ags/U4AVSpjFE5RPGdEeSkOq6yR9YOkU=
+github.com/siderolabs/talos/pkg/machinery v1.9.5 h1:hH+f48MLNoDUeyny1zR/i2fLqReK64Fq9WmIizL8GEs=
+github.com/siderolabs/talos/pkg/machinery v1.9.5/go.mod h1:yLkJ5ZvIpshDRhUVWjuSyTN6YAQiusSJF4/zj2/XfpY=
+golang.org/x/sys v0.32.0 h1:s77OFDvIQeibCmezSnk/q6iAfkdiQaJi4VzroCFrN20=
+golang.org/x/sys v0.32.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
diff --git a/installers/orangepi-5-max/src/main.go b/installers/orangepi-5-max/src/main.go
@@ -0,0 +1,98 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+package main
+
+import (
+	_ "embed"
+	"fmt"
+	"os"
+	"path/filepath"
+
+	"github.com/siderolabs/go-copy/copy"
+	"github.com/siderolabs/talos/pkg/machinery/overlay"
+	"github.com/siderolabs/talos/pkg/machinery/overlay/adapter"
+	"golang.org/x/sys/unix"
+)
+
+const (
+	off int64 = 512 * 64
+	dtb       = "rockchip/rk3588-orangepi-5-max.dtb"
+)
+
+func main() {
+	adapter.Execute(&opi5MaxInstaller{})
+}
+
+type opi5MaxInstaller struct{}
+
+type opi5MaxExtraOptions struct {
+	SPIBoot bool `yaml:"spi_boot,omitempty"`
+}
+
+func (i *opi5MaxInstaller) GetOptions(extra opi5MaxExtraOptions) (overlay.Options, error) {
+	kernelArgs := []string{
+		"console=tty1",
+		"console=ttyS2,1500000",
+		"sysctl.kernel.kexec_load_disabled=1",
+		"talos.dashboard.disabled=1",
+	}
+	return overlay.Options{
+		Name:       "orangepi-5-max",
+		KernelArgs: kernelArgs,
+		PartitionOptions: overlay.PartitionOptions{
+			Offset: 2048 * 10,
+		},
+	}, nil
+}
+
+func (i *opi5MaxInstaller) Install(options overlay.InstallOptions[opi5MaxExtraOptions]) error {
+	if !options.ExtraOptions.SPIBoot {
+		uBootBin := filepath.Join(options.ArtifactsPath, "arm64/u-boot/orangepi-5-max/u-boot-rockchip.bin")
+
+		if err := uBootLoaderInstall(uBootBin, options.InstallDisk); err != nil {
+			return err
+		}
+	}
+
+	src := filepath.Join(options.ArtifactsPath, "arm64/dtb", dtb)
+	dst := filepath.Join(options.MountPrefix, "boot/EFI/dtb", dtb)
+
+	if err := copyFileAndCreateDir(src, dst); err != nil {
+		return err
+	}
+
+	return nil
+}
+
+func copyFileAndCreateDir(src, dst string) error {
+	if err := os.MkdirAll(filepath.Dir(dst), 0o600); err != nil {
+		return err
+	}
+
+	return copy.File(src, dst)
+}
+
+func uBootLoaderInstall(uBootBin, installDisk string) error {
+	f, err := os.OpenFile(installDisk, os.O_RDWR|unix.O_CLOEXEC, 0o666)
+	if err != nil {
+		return fmt.Errorf("failed to open %s: %w", installDisk, err)
+	}
+
+	defer f.Close() //nolint:errcheck
+
+	uboot, err := os.ReadFile(uBootBin)
+	if err != nil {
+		return err
+	}
+
+	if _, err = f.WriteAt(uboot, off); err != nil {
+		return err
+	}
+
+	// NB: In the case that the block device is a loopback device, we sync here
+	// to ensure that the file is written before the loopback device is
+	// unmounted.
+	return f.Sync()
+}
diff --git a/installers/pkg.yaml b/installers/pkg.yaml
@@ -7,6 +7,7 @@ dependencies:
   - stage: nanopi-r4s
   - stage: odroid-m1
   - stage: orangepi-5
+  - stage: orangepi-5-max
   - stage: orangepi-5-plus
   - stage: orangepi-r1-plus-lts
   - stage: radxa-zero-3e
@@ -32,6 +33,8 @@ dependencies:
     platform: linux/arm64
   - stage: u-boot-orangepi-5
     platform: linux/arm64
+  - stage: u-boot-orangepi-5-max
+    platform: linux/arm64
   - stage: u-boot-orangepi-5-plus
     platform: linux/arm64
   - stage: u-boot-orangepi-r1-plus-lts
@@ -80,6 +83,10 @@ dependencies:
     platform: linux/arm64
     from: /dtb/rockchip/rk3588s-orangepi-5.dtb
     to: /rootfs/artifacts/arm64/dtb/rockchip/rk3588s-orangepi-5.dtb
+  - image: "{{ .BUILD_ARG_PKGS_PREFIX }}/kernel:{{ .BUILD_ARG_PKGS }}"
+    platform: linux/arm64
+    from: /dtb/rockchip/rk3588-orangepi-5-max.dtb
+    to: /rootfs/artifacts/arm64/dtb/rockchip/rk3588-orangepi-5-max.dtb
   - image: "{{ .BUILD_ARG_PKGS_PREFIX }}/kernel:{{ .BUILD_ARG_PKGS }}"
     platform: linux/arm64
     from: /dtb/rockchip/rk3588-orangepi-5-plus.dtb
diff --git a/profiles/orangepi-5-max/orangepi-5-max.yaml b/profiles/orangepi-5-max/orangepi-5-max.yaml
@@ -0,0 +1,10 @@
+arch: arm64
+platform: metal
+secureboot: false
+output:
+  kind: image
+  outFormat: .xz
+  imageOptions:
+    diskSize: 1306525696
+    diskFormat: raw
+    bootloader: grub
diff --git a/profiles/pkg.yaml b/profiles/pkg.yaml

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+# renovate: datasource=docker versioning=docker depName=cgr.dev/chainguard/wolfi-base`
	`2`	`+WOLFI_BASE_REF: sha256:8dd9ceace8b1574e550374e9c07c2baafa60cc96223c1314fac61bd2edb48c70`