Releases: edk2-porting/edk2-rk3588
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
v0.7.1
Usage
Flash the board-specific image to SPINOR with rkdevtool / rkdeveloptool or to an EMMC / SD card.
If your board is not yet supported, using a similar image may work but beware of potential issues.
Debug builds can be found in the artifacts of the workflow run for this release.
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
Features
- ROCK 5A: Enable ACPI eMMC support
Fixes
- Fix Synchronous Exception if the NV region on boot device has random/invalid previous data
- NanoPC T6: Configure Combo PHY defaults correctly
Full Changelog: v0.7...v0.7.1
v0.7
Usage
Flash the board-specific image to SPINOR with rkdevtool / rkdeveloptool or to an EMMC / SD card.
If your board is not yet supported, using a similar image may work but beware of potential issues.
Debug builds can be found in the artifacts of the workflow run for this release.
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
- ameriDroid Indiedroid Nova
- Firefly ROC-RK3588S-PC and Station M3
- Mekotronics R58X and R58 Mini
- Khadas Edge2
- FriendlyElec NanoPC T6
- Radxa ROCK 5 Model A
Features
- Support maximum CPU clocks and voltages
- Add config options for CPU Performance (including overclock by voltage) and Combo PHY (for M.2 slots, PCIe, SATA, etc.)
- Support eMMC boot
- Support persistent UEFI (config) variables on SD and eMMC
- Support SATA boot
Fixes
- Fix random boot stall on OhciDxe
Full Changelog: v0.6...v0.7
v0.6
Usage
Flash the board-specific image to SPINOR with rkdevtool / rkdeveloptool or to an EMMC / SD card.
If your board is not yet supported, using a similar image may work but beware of potential issues.
Debug builds can be found in the artifacts of the workflow run for this release.
What's Changed
-
Platform/OrangePi5: Support SD card boot and expose microSD socket via ACPI.
-
Silicon/Rockchip: Remove stale boot options in PlatformBootManagerLib
-
Update SMBIOS: unique serial number, detect CPU model, report CPU cluster #0 speed from SCMI.
-
Silicon/Rockchip: Set ARM clocks to maximum
Note
While the UEFI does set all clusters to their max clock (1.8 GHz for little cores, 2.4 GHz for big cores), Windows ignores SMBIOS and does its own thing, reporting a base clock that slightly varies across boards (around 1.8 GHz) and there also appears to be some sort of frequency scaling going on. We're investigating this.
Full Changelog: v0.5...v0.6
v0.5
Usage
Flash the board-specific image to SPINOR with rkdevtool / rkdeveloptool or to an EMMC / SD card.
If your board is not yet supported, using a similar image may work but beware of potential issues.
Debug builds can be found in the artifacts of the workflow run for this release.
What's Changed
- Platform/Radxa: Add LogoDxe
- Platform/OrangePi5: Initial support for OPi5
- Rock 5B: Support SD card boot
- Expose microSD socket via ACPI
- Rock 5B: Autodetect memory size
- Platform/OrangePi5: Add memory detection
- Enable USB PHYs a bit earlier and re-enable OhciDxe
Full Changelog: v0.4...v0.5
Version 0.4
Usage
- Flash the image to SPINOR or EMMC/SD
Features
- HDMI port next to the type-c port
- Non-volatile variable support
- simple-init GUI boot manager
- Basic ACPI for booting Windows or mainline Linux