Releases: edk2-porting/edk2-rk3588
v1.1
Usage
Check out the Getting started guide.
Debug builds can be found in the artifacts of the workflow run for this release. Extract before flashing.
What's Changed
Features
- Ext4 file system support
- Improved DTB override functionality:
- All supported file systems (FAT, ext4) on the selected boot device are now scanned for overrides.
- Additional base DTB locations: custom path configurable in the setup menu +
\dtband\dtb\rockchip.
The latter is found in Fedora installations on the second ext4 boot partition, meaning that the OS-provided DTB will be automatically used for those images once this option is enabled. - Firmware fix-ups (e.g. for PCIe/SATA selection) are applied to base DTB overrides as well.
Mainline Linux
- Enable improved HDMI support on all supported boards (audio & secondary port)
Fixes
- PCIe 3.0 bifurcation not working correctly
- M.2 slots getting powered off in Linux when set to SATA mode
BuzzTV PowerStation 6
- HDMI hot-plug detect not working
- WLAN hard-blocked on recent kernels
Misc
- Updated upstream device trees to
v6.15-rc1-dts
Full Changelog: v1.0.1...v1.1
Mainline Linux images
Look for ARM64/AArch64 generic UEFI images from distro vendors. Examples:
- Fedora Rawhide (provides most recent kernels): https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/
- Fedora Workstation: https://fedoraproject.org/workstation/download
- Ubuntu 24.10: https://cdimage.ubuntu.com/releases/24.10/release/
Actual hardware support depends on the platform and kernel version (the newer, the better).
3rd-party images for UEFI
These Linux images come with the RK3588 legacy kernel and are compatible with the vendor firmware-provided DTB.
- Armbian live ISO by amazingfate: https://github.com/amazingfate/rk3588-live-iso/releases
- Arch Linux installer by SputnikRocket: https://github.com/SputnikRocket/ArchLinuxARM-rk3588-installer
v1.0.1
Usage
Check out the Getting started guide.
Debug builds can be found in the artifacts of the workflow run for this release. Extract before flashing.
What's Changed
Fixes
- Incomplete shutdown from UEFI / ACPI
Full Changelog: v1.0...v1.0.1
Mainline Linux images
Look for ARM64/AArch64 generic UEFI images from distro vendors. Examples:
- Ubuntu 24.10: https://cdimage.ubuntu.com/releases/24.10/release/
- Fedora Workstation: https://fedoraproject.org/workstation/download
Actual hardware support depends on the platform and kernel version (the newer, the better).
3rd-party images for UEFI
These Linux images come with the RK3588 legacy kernel and are compatible with the vendor firmware-provided DTB.
- Armbian live ISO by amazingfate: https://github.com/amazingfate/rk3588-live-iso/releases
- Arch Linux installer by SputnikRocket: https://github.com/SputnikRocket/ArchLinuxARM-rk3588-installer
v1.0
Usage
Check out the Getting started guide.
Debug builds can be found in the artifacts of the workflow run for this release. Extract before flashing.
What's Changed
Features
Display
- Proper HDMI support up to 4K 60Hz with auto-detection (EDID)
- Landscape orientation on the Fydetab Duo by default (limited to boot stage)
- Configuration options for resolution, connector priority, force output, duplication and rotation
Networking
- Integrated Gigabit Ethernet (GMAC/EQoS) support
- Enabled iSCSI, TFTP shell command and unsecure HTTP boot
- Configuration options to enable/disable various parts of the UEFI network stack
Fixes
- RTC time not ticking after power loss until manually configured
- Some boot options (particularly for NVME and SATA) getting skipped on uninterrupted boots
- Boot hotkeys (ESC/F2, F1, F4) potentially not working during the countdown after a firmware update
- Graphics console lagging due to slow GOP block transfer performance
Misc
- Boot time optimizations:
- Decreased PCIe link up timeout to 1 second and auto boot timeout to 5 seconds
- Set CPU clocks to maximum on all platforms
- Updated EDK2 to
edk2-stable202502 - Updated upstream device trees to
v6.14-rc4-dts
Full Changelog: v0.12.2...v1.0
Mainline Linux images
Look for ARM64/AArch64 generic UEFI images from distro vendors. Examples:
- Ubuntu 24.10: https://cdimage.ubuntu.com/releases/24.10/release/
- Fedora Workstation: https://fedoraproject.org/workstation/download
Actual hardware support depends on the platform and kernel version (the newer, the better).
3rd-party images for UEFI
These Linux images come with the RK3588 legacy kernel and are compatible with the vendor firmware-provided DTB.
- Armbian live ISO by amazingfate: https://github.com/amazingfate/rk3588-live-iso/releases
- Arch Linux installer by SputnikRocket: https://github.com/SputnikRocket/ArchLinuxARM-rk3588-installer
v0.12.2
Usage
Check out the Getting started guide.
Debug builds can be found in the artifacts of the workflow run for this release. Extract before flashing.
What's Changed
Features
Mainline Linux
- Enable HDMI0 output on Radxa ROCK 5 ITX
- Enable HDMI, USB-C, Bluetooth and analog audio on Khadas Edge2
- Enable front USB-A 3.0 and USB-C ports on Orange Pi 5 Plus
Fixes
- RTC not working on Linux in FDT mode due to a conflict with EFI RTC runtime services
Full Changelog: v0.12.1...v0.12.2
Mainline Linux images
Look for ARM64/AArch64 generic UEFI images from distro vendors. Examples:
- Ubuntu 24.10: https://cdimage.ubuntu.com/releases/24.10/release/
- Fedora Workstation: https://fedoraproject.org/workstation/download
Actual hardware support depends on the platform and kernel version (the newer, the better).
3rd-party images for UEFI
These Linux images come with the RK3588 legacy kernel and are compatible with the vendor firmware-provided DTB.
- Armbian live ISO by amazingfate: https://github.com/amazingfate/rk3588-live-iso/releases
- Arch Linux installer by SputnikRocket: https://github.com/SputnikRocket/ArchLinuxARM-rk3588-installer
v0.12.1
Usage
Check out the Getting started guide.
Debug builds can be found in the artifacts of the workflow run for this release. Extract before flashing.
What's Changed
Fixes
- M.2 M key and SATA ports not functional on Radxa ROCK 5 ITX
- PCIe not routed correctly to all M.2 M key slots on NanoPC-CM3588-NAS (needs validation)
Full Changelog: v0.12...v0.12.1
Mainline Linux images
Look for ARM64/AArch64 generic UEFI images from distro vendors. Examples:
- Ubuntu 24.10: https://cdimage.ubuntu.com/releases/24.10/release/
- Fedora Workstation: https://fedoraproject.org/workstation/download
Actual hardware support depends on the platform and kernel version (the newer, the better).
3rd-party images for UEFI
These Linux images come with the RK3588 legacy kernel and are compatible with the vendor firmware-provided DTB.
- Armbian live ISO by amazingfate: https://github.com/amazingfate/rk3588-live-iso/releases
- Arch Linux installer by SputnikRocket: https://github.com/SputnikRocket/ArchLinuxARM-rk3588-installer
v0.12
Usage
Check out the Getting started guide.
Debug builds can be found in the artifacts of the workflow run for this release. Extract before flashing.
What's Changed
New platforms
New support levels have been introduced: Platinum and Bronze. The most notable feature of Platinum platforms is the ability to boot generic Linux distro images in Device Tree mode with much better functionality compared to ACPI.
Platinum
- BuzzTV PowerStation 6
- FriendlyELEC NanoPC CM3588-NAS
Bronze
- FriendlyELEC NanoPi M6
- Radxa ROCK 5B+
Features
- Out-of-the-box support for booting mainline Linux distros on Platinum-tier platforms.
- Validated on ROCK 5B, Orange Pi 5 Plus, BuzzTV P6 with Fedora Workstation 41 and Ubuntu 24.10 AArch64 images.
- For kernels older than 6.13 which lack native HDMI support, an option to use the UEFI display output is provided.
- Collabora's RK3588 upstreaming status matrix: https://gitlab.collabora.com/hardware-enablement/rockchip-3588/notes-for-rockchip-3588/-/blob/main/mainline-status.md
- Reset to MaskROM option available via the Boot Manager, F4 during the splash screen, or by holding the Recovery / volume up button while powering on.
- PCIe 3 bifurcation (required by some platforms)
Fixes
- No USB power on NanoPC-T6 LTS variant
- Configuration settings not getting saved due to buggy U-Boot SPL (namely Orange Pi's) being present on a higher priority device (SPI NOR / eMMC).
Misc
- Updated EDK2 to
edk2-stable202411 - Updated open TF-A to
v2.12.0 - Updated rkbin:
- ATF (BL31) from
v1.45tov1.47 - OP-TEE (BL32) from
v1.15tov1.17 - ddrbin from
v1.16tov1.18
- ATF (BL31) from
- Switched console output to 100x31
- Switched
Config Table Modedefault toBoth(ACPI + Device Tree) - final choice up to the OS. This works as intended for Windows and Linux boot; other OSes might need adjustment. - EFI Memory Attribute Protocol is now enabled by default and needs to be manually disabled for certain Linux distros with a broken shim (Synchronous Exception).
Full Changelog: v0.11.2...v0.12
3rd-party images for UEFI
These Linux images come with the RK3588 legacy kernel and are compatible with the firmware-provided DTB.
- Armbian live ISO by amazingfate: https://github.com/amazingfate/rk3588-live-iso/releases
- Arch Linux installer by SputnikRocket: https://github.com/SputnikRocket/ArchLinuxARM-rk3588-installer
v0.11.2
Usage
Check out the Getting started guide.
Debug builds can be found in the artifacts of the workflow run for this release. Extract before flashing.
What's Changed
Fixes
- SD card potentially not working in Windows on the Fydetab Duo
Full Changelog: v0.11.1...v0.11.2
3rd-party images for UEFI
These Linux images come with the RK3588 legacy kernel and are compatible with the firmware-provided DTB.
- Armbian live ISO by amazingfate: https://github.com/amazingfate/rk3588-live-iso/releases
- Arch Linux installer by SputnikRocket: https://github.com/SputnikRocket/ArchLinuxARM-rk3588-installer
v0.11.1
Usage
Check out the Getting started guide.
Debug builds can be found in the artifacts of the workflow run for this release. Extract before flashing.
What's Changed
Fixes
- Work around potential SD card issues on Fydetab Duo
Full Changelog: v0.11...v0.11.1
3rd-party images for UEFI
These Linux images come with the RK3588 legacy kernel and are compatible with the firmware-provided DTB.
- Armbian live ISO by amazingfate: https://github.com/amazingfate/rk3588-live-iso/releases
- Arch Linux installer by SputnikRocket: https://github.com/SputnikRocket/ArchLinuxARM-rk3588-installer
v0.11
Usage
Check out the Getting started guide.
Debug builds can be found in the artifacts of the workflow run for this release. Extract before flashing.
What's Changed
New platforms
- Fydetab Duo
Features
- MIPI DSI support
Fixes
- SD card potentially not working when plugged in after boot
Full Changelog: v0.10...v0.11
3rd-party images for UEFI
These Linux images come with the RK3588 legacy kernel and are compatible with the firmware-provided DTB.
- Armbian live ISO by amazingfate: https://github.com/amazingfate/rk3588-live-iso/releases
- Arch Linux installer by SputnikRocket: https://github.com/SputnikRocket/ArchLinuxARM-rk3588-installer
v0.10
Usage
Check out the Getting started guide.
Debug builds can be found in the artifacts of the workflow run for this release. Extract before flashing.
What's Changed
New platforms
- Firefly ITX-3588J
- Firefly AIO-3588Q
- Radxa ROCK 5 ITX
Features
- Improved ACPI:
- New peripherals in Windows: GPIO, I2C, I2S, DMA, SDHC, USB2, GMAC
- Support for PCIe switches in Windows and Linux
- Option to change serial baud rate in the settings
- Random number generator support
Fixes
- USB keyboard not working during first boot
- eMMC boot crashing/freezing due to data corruption
- M.2 SATA cards not getting power
- M.2 Wi-FI cards not getting power on some boards
- Potential lock-up with some PCIe devices
- LPDDR4X/LPDDR5 memory not being identified correctly
Misc
- Updated EDK2 to
edk2-stable202405 - Switched to open-source TF-A
- Updated rkbin:
- OP-TEE (BL32) from
v1.13tov1.15 - ddrbin from
v1.12tov1.16
- OP-TEE (BL32) from
- Updated DTBs to Armbian rk-6.1-rkr1
Full Changelog: v0.9.1...v0.10
3rd-party images for UEFI
These Linux images come with the RK3588 legacy kernel and are compatible with the firmware-provided DTB.
- Armbian live ISO by amazingfate: https://github.com/amazingfate/rk3588-live-iso/releases
- Arch Linux installer by SputnikRocket: https://github.com/SputnikRocket/ArchLinuxARM-rk3588-installer