Skip to content

About

No description, website, or topics provided.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

26 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Armada

Armada EFI

Graphical UEFI boot manager and Device Tree selector for Armada OS

Build status Documentation Discord community

Armada OS · Supported devices · Documentation · Discord

Overview

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.

Features

  • 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-) and POWER, or standard keyboard arrows and Enter.
  • 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, applying DtFixup protocol fixups dynamically.
  • Clean Chainloading: Loads the adtbloader driver to initialize device trees, then chainloads systemd-boot.

Armada Bootchain

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)
  1. UEFI Firmware launches armada-boot.efi as the default boot executable (\EFI\BOOT\BOOTAA64.EFI).
  2. Armada EFI starts adtbloader to support hardware fixups, displays the splash menu, and allows manual device tree selection if needed.
  3. systemd-boot is chainloaded to evaluate Boot Loader Specification (BLS) entries and boot the active Armada OS ostree deployment.

Building

Requires a Rust toolchain with the aarch64-unknown-uefi target:

$ rustup target add aarch64-unknown-uefi
$ cargo build --release --target aarch64-unknown-uefi

The compiled binary will be placed at target/aarch64-unknown-uefi/release/armada-boot.efi.

About

No description, website, or topics provided.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages