milas/rock5-talos repository overview

⁠🍴 Fork of siderolabs/talos⁠ to support Radxa Rock 5 🍴

⁠Why does this exist?

Currently, the Radxa Rock 5B, like all other Rockchip RK3588-based boards, requires a BSP kernel. Additionally, there's no mature EFI bootloader support.

Due to this situation, until/if mainline Linux RK3588 support improves, it's not practical to support the board in its current state in the main Talos codebase. As a result, this is a "friendly fork": it exists to serve a specific niche and will cease to exist as soon as upstream support is practical. (I have no affiliation with Sidero Labs! But this is way too extensive & hacky to be reasonable to open a PR for.)

Please be respectful of upstream if you run into any problems. If there's any doubt about whether an issue is caused by this fork, err on the side of making an issue here first!

⁠Install

Flashable images are available from the releases⁠.

You can write this to your eMMC/SD card using dd, Balena Etcher, etc.

⁠Machine Configuration

Use the docker.io/milas/rock5-talos images instead of the upstream Talos Linux images. These include a modified version of Talos to support the Rock 5B in addition to the vendor U-Boot & kernel.

machine:
  install:
    # for eMMC, use /dev/mmcblk0
    # for SD card, use /dev/mmcblk1
    disk: /dev/mmcblk0
    image: docker.io/milas/rock5-talos:v1.3.5-rock5-rock-5b
    bootloader: true
    wipe: false

⁠Differences from siderolabs/talos⁠

• Support radxa/u-boot⁠ (#1⁠):
  • Adjust partition offset logic
  • Remove BIOS/EFI partitions entirely
  • Change Talos root partition to ext4 from xfs
  • Add rk3588-rock-5b.dtb (& rk3588-uart7-m2.dtbo) directly to Talos root partition (these would normally be in the EFI partition)
  • Add (hardcoded) /extlinux/extlinux.conf directly to Talos root partition

    ⚠️ As U-Boot directly boots the kernel (no GRUB), extlinux.conf contains the kernel args, meaning there's no way to customize them right now since it's not templated/generated by the installer! (#3⁠)

• Support radxa/kernel⁠:
  • Remove proc.sys.kernel.yama.ptrace_scope from KSPP list
  • Disable IMA policy
  • Add new step to systemRequirements phase to forcibly load the r8125 ethernet driver (#2⁠)
  • Increase minimum installer size to account for the BSP kernel being ~1GB (#4⁠)
  • No-op SystemInfoController (no SMBIOS support)

⁠Resources

• milas/rock5-toolchain⁠
• radxa/kernel⁠
• siderolabs/talos⁠

⁠License

⁠

Some software we distribute is under the General Public License family of licenses or other licenses that require we provide you with the source code. If you would like a copy of the source code for this software, please contact us via email: info at SideroLabs.com.