Releases: edk2-porting/edk2-rk3588
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
v0.9.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
- Some PCIe devices (multi-function and a few NVMEs) not getting detected in ACPI mode
Full Changelog: v0.9...v0.9.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.9
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
- Device Tree support
- firmware-provided DTBs for Rockchip SDK Linux 5.10 legacy kernel
- DTB override and overlays support on the OS boot drive
- Basic Secure Boot support
These features can be enabled in the UEFI setup menu.
Fixes
- Workaround for distros using old versions of rhboot shim that lead to a Synchronous Exception
- PWM fan sometimes not following the configured speed
Misc
- Updated rkbin:
- ATF (BL31) to
v1.40 - ddrbin to
v1.12
- ATF (BL31) to
Full Changelog: v0.8...v0.9
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.8
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.
Note
CPU clocks have been lowered to boot default (1200 MHz) due to possible overheating on most platforms.
If you have adequate cooling (active recommended), you can set the clocks back to maximum by spamming ESC while UEFI is loading, then go to Device Manager -> Rockchip Platform Configuration -> CPU Performance and set all Cluster Presets to Maximum.
What's Changed
New platforms
- Orange Pi 5 Plus
- Mixtile Blade 3
- Hinlink H88K
- FriendlyElec NanoPi R6S
- FriendlyElec NanoPi R6C
Features
- Proper PCIe 3x4 / 2.1 support (including NVME, onboard Realtek NIC, switches)
- Early DisplayPort (USB-C) output support at 1080p 60Hz. Available in only one orientation of the connector.
- USB 3.0 SuperSpeed support on all USB-A ports and USB-C (only one orientation).
- (HYM)8563 Real-time clock support
- Improved SD/eMMC support + proper boot device descriptions
- Improved ACPI:
- basic PCIe support (tested working in Linux and NetBSD with NVME and PCIe Ethernet)
- USB 2.0 / 1.1 support: 2.0 needs to be enabled in the setup menu for non-Windows OSes, 1.1 is enabled by default.
- CPU topology description (PPTT)
- GMAC Ethernet support (tested working in NetBSD; Linux and VMware ESXi need driver changes)
- Networking support (PXE, TFTP, HTTP boot) with Realtek PCIe and USB NICs
- RAM Disk support
- Basic PWM fan control for Ameridroid, Firefly / StationPC, Khadas, Mixtile, OrangePi and Radxa platforms.
Available at fan connector where present, or GPIO header for:- Orange Pi 5: GPIO4_B2
- Indiedroid Nova: GPIO4_B4
- Status LED indicator support
Fixes
- RK3588S being detected as full RK3588
- HDMI not working properly on ROCK 5A
- Keyboard connected to USB 2.0 ports not working until after BDS timeout
- Rare USB 3.0 controller crash under high load
- SD/eMMC not being able to properly load some images (Grub, Windows)
- SPI NOR not working on Orange Pi 5
- 128 MB RAM wasted for 1920x1080 framebuffer, reduced to almost 8 MB.
- Flash image: last LBA of GPT too large, removed unneeded idblock
Misc
- Updated EDK2 base to
edk2-stable202308 - Updated rkbin:
- ATF (BL31) to
v1.38 - OP-TEE (BL32) to
v1.13 - ddrbin to
v1.11 - U-Boot SPL to
v1.12
- ATF (BL31) to
- Increased verbosity of debug builds
Full Changelog: v0.7.1...v0.8
3rd-party images for UEFI
These Linux images come with platform device trees out-of-the-box and provide almost full hardware support.
- 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