Graphical UEFI boot manager and Device Tree selector for Armada OS
Armada OS · Supported devices · Documentation · Discord
armada-efi (built as armada-boot.efi) is a lightweight no_std Rust UEFI boot application for ARM64 gaming handhelds running Armada OS. It acts as the primary UEFI bootloader (BOOTAA64.EFI), providing a graphical boot splash, handheld button navigation, and optional Device Tree overrides before handing execution over to systemd-boot.
- Graphical Boot Interface: Rendered via UEFI Graphics Output Protocol (GOP) with Armada branding, display rotation detection, and text console fallback.
- Handheld Controls: Navigate the boot menu using device volume buttons (
VOL+/VOL-) andPOWER, or standard keyboard arrows andEnter. - Timed Boot: Displays a 3-second countdown for unattended startup, automatically pausing countdown if user input is received.
- Bootc Rollback: Offers the previous deployment when available and selects it for one boot through
systemd-boot. - Device Tree Selection: Browse and select supported Qualcomm Device Trees (
.dtb) grouped by manufacturer, applyingDtFixupprotocol fixups dynamically. - Clean Chainloading: Loads the
adtbloaderdriver to initialize device trees, then chainloadssystemd-boot.
On UEFI-based ARM64 handhelds, armada-efi sits between the platform firmware and systemd-boot:
Firmware (UEFI)
└─► \EFI\BOOT\BOOTAA64.EFI (armada-boot.efi)
├─► Loads \EFI\BOOT\drivers_aa64\adtbloaderaa64.efi
├─► Renders boot menu / applies DTB overrides
└─► Chainloads \EFI\systemd\systemd-bootaa64.efi
└─► Linux Kernel (with ostree deployment)
- UEFI Firmware launches
armada-boot.efias the default boot executable (\EFI\BOOT\BOOTAA64.EFI). - Armada EFI starts
adtbloaderto support hardware fixups, displays the splash menu, and allows manual device tree selection if needed. - systemd-boot is chainloaded to evaluate Boot Loader Specification (BLS) entries and boot the active Armada OS ostree deployment.
Requires a Rust toolchain with the aarch64-unknown-uefi target:
$ rustup target add aarch64-unknown-uefi
$ cargo build --release --target aarch64-unknown-uefiThe compiled binary will be placed at target/aarch64-unknown-uefi/release/armada-boot.efi.