Golbinex: /* Hardware status */

2026-06-01T21:40:11Z

Hardware status

← Older revision		Revision as of 21:40, 1 June 2026
Line 43:		Line 43:
	=== Hardware status ===		=== Hardware status ===

	* Video output is not supported by mainline kernel 6.12 or older when the device tree is loaded. USB to TTL serial cable is recommended for debugging purposes.		* Video output is not supported by mainline kernel 6.12 or older when the device tree is loaded.
			* USB to TTL serial cable is recommended for debugging purposes. Do not use <code>minicom</code> recommended by Radxa and instead use <code>screen /dev/ttyUSB0 1500000</code> for reliable UART connection.

	== Bootloader Firmware ==		== Bootloader Firmware ==

Pigs: Add category

2025-05-19T05:23:22Z

Add category

← Older revision		Revision as of 05:23, 19 May 2025
Line 150:		Line 150:
	boot.kernelParams = [ "dtb=/${config.hardware.deviceTree.name}" ];		boot.kernelParams = [ "dtb=/${config.hardware.deviceTree.name}" ];
	</syntaxhighlight>		</syntaxhighlight>

			[[Category:NixOS on ARM]]

Golbinex: Rock 5 ITX: initial page

2025-02-27T13:58:07Z

Rock 5 ITX: initial page

New page

{{ARM/breadcrumb}}<div class="infobox">
{| class="table"
! colspan="2" class="title" |[https://radxa.com/products/rock5/5itx Radxa ROCK 5 ITX]
|-
| colspan="2" |[[File:Radxa Rock 5 ITX.webp|frameless|280x280px|Radxa R SBC]]
|-
!Manufacturer
|[https://radxa.com/ Radxa]
|-
!Architecture
|AArch64
|-
!Bootloader
|Vendor BSP
|-
!Boot order
|SPI NOR Flash, eMMC, SD
|}
</div>The [https://docs.radxa.com/en/rock5/rock5itx Radxa ROCK 5 ITX] is a Single-Board Computer with a Rockchip RK3588 SoC.

* '''CPU''': ARM Cortex-A76 and Cortex-A55
* '''GPU''': Mali-G610MC4
* '''RAM''': 4GB/8GB/16GB/32GB LPDDR5
* '''MMC''': eMMC Connector
* '''Storage''': 4x SATA Ports with Power Header
* '''NET''': 2x 2.5 Gigabit Ethernet
* '''USB''': 1x USB3.0 Type-C, 4x USB 3.0 Type-A, 2x USB 2.0 Type-A, 2x USB 2.0 Interface via Front USB header
* '''PCIe''': M.2 Key M connector with PCIe 3.0 x2

== Status ==
Support of this system is YMMV (your mileage may vary), and depends on vendor-provided BSP (Board Support Package) based components.

Two kinds of bootloaders are available in different variants:

* U-Boot
** [https://github.com/u-boot/u-boot/ Mainline]
** [https://dl.radxa.com/rock5/5itx/images/ Vendor]
* EDK2/TianoCore
** [https://github.com/edk2-porting/edk2-rk3588 EDK2 UEFI Firmware] - Recommended. Supports all storage boot options, including NVMe.

The official hardware documentation can be found [https://docs.radxa.com/en/rock5/rock5itx on the Radxa website].

=== Hardware status ===

* Video output is not supported by mainline kernel 6.12 or older when the device tree is loaded. USB to TTL serial cable is recommended for debugging purposes.

== Bootloader Firmware ==

=== Community UEFI Firmware ===
The best available bootloader is [https://github.com/edk2-porting/edk2-rk3588 EDK2 UEFI firmware for Rockchip RK3588 platforms]. The [https://github.com/edk2-porting/edk2-rk3588/releases/tag/v0.11.2 v0.11.2] release is confirmed working.

In order to flash this bootloader we'll need to download two files:

* [https://dl.radxa.com/rock5/sw/images/loader/rk3588_spl_loader_v1.15.113.bin <code>rk3588_spl_loader_v1.15.113.bin</code>] - SPI bootloader image.
* [https://github.com/edk2-porting/edk2-rk3588/releases/download/v0.11.2/rock-5-itx_UEFI_Release_v0.11.2.img <code>rock-5itx_UEFI_Release_v0.11.2.img</code>] - UEFI bootloader image.

Then use the <code>rkdeveloptool</code> tool in as described in [https://docs.radxa.com/en/rock5/rock5itx/low-level-dev/maskrom/linux SPI flashing documentation]:<syntaxhighlight lang="bash">
> nix-shell -p rkdeveloptool

[nix-shell:~/rk3588]$ sudo rkdeveloptool db rk3588_spl_loader_v1.15.113.bin
Downloading bootloader succeeded.

[nix-shell:~/rk3588]$ sudo rkdeveloptool wl 0 rock-5itx_UEFI_Release_v0.11.2.img
Write LBA from file (100%)

[nix-shell:~/rk3588]$ sudo rkdeveloptool rd
</syntaxhighlight>Now the device has a graphical bootloader available when pressing <code>Escape</code> at boot time:

== System configuration ==

=== Installer ISO ===
A custom installer ISO is required to get video output for installation.

configuration.nix on x86 system:

<code>boot.binfmt.emulatedSystems = [ "aarch64-linux" ];</code>

iso.nix:<syntaxhighlight lang="nix">
{ pkgs, modulesPath, lib, ... }: {
imports = [
"${modulesPath}/installer/cd-dvd/installation-cd-minimal.nix"
];

# use the latest Linux kernel
boot.kernelPackages = pkgs.linuxPackages_latest;

boot.initrd.kernelModules = [
# Rockchip modules
"rockchip_rga"
"rockchip_saradc"
"rockchip_thermal"
"rockchipdrm"

# GPU/Display modules
"analogix_dp"
"cec"
"drm"
"drm_kms_helper"
"dw_hdmi"
"dw_mipi_dsi"
"gpu_sched"
"panel_edp"
"panel_simple"
"panfrost"
"pwm_bl"

# USB / Type-C related modules
"fusb302"
"tcpm"
"typec"

# Misc. modules
"cw2015_battery"
"gpio_charger"
"rtc_rk808"
];

# kernelParams copy from Armbian's /boot/armbianEnv.txt & /boot/boot.cmd
boot.kernelParams = [
"rootwait"

"earlycon" # enable early console, so we can see the boot messages via serial port / HDMI
"consoleblank=0" # disable console blanking(screen saver)
"console=ttyS2,1500000" # serial port
"console=tty1" # HDMI
];

# Needed for https://github.com/NixOS/nixpkgs/issues/58959
boot.supportedFilesystems = lib.mkForce [ "btrfs" "reiserfs" "vfat" "f2fs" "xfs" "ntfs" "cifs" ];
}

</syntaxhighlight>Generate ISO:<syntaxhighlight lang="bash">
nix-shell -p nixos-generators --run "nixos-generate --format iso --system aarch64-linux --configuration ./iso.nix -o result"
</syntaxhighlight>

=== EDK2 settings ===
Enable Custom Device Tree mode by going to the configuration menu -> <code>ACPI / Device Tree</code> and setting <code>Support DTB override & overlays</code> to <code>Enabled</code>.

=== configuration.nix ===
<syntaxhighlight lang="nix">
# Rock 5 ITX requires 6.12 or newer kernel
boot.kernelPackages = pkgs.linuxPackages_latest;
# Generate device tree into EFI partition
boot.loader.systemd-boot.extraFiles.${config.hardware.deviceTree.name} = "${config.hardware.deviceTree.package}/${config.hardware.deviceTree.name}";
hardware.deviceTree.enable = true;
hardware.deviceTree.name = "rockchip/rk3588-rock-5-itx.dtb";
hardware.deviceTree.filter = "*-rock-5-itx*.dtb";
boot.kernelParams = [ "dtb=/${config.hardware.deviceTree.name}" ];
</syntaxhighlight>

NixOS on ARM/Radxa ROCK 5 ITX - Revision history

Golbinex: /* Hardware status */

Pigs: Add category

Golbinex: Rock 5 ITX: initial page