Skip to content
This repository has been archived by the owner on Aug 19, 2018. It is now read-only.
/ rune-image Public archive

Rune - ARM OS Image Post-processing Tool MOVED TO HAIKU

License

Notifications You must be signed in to change notification settings

kallisti5/rune-image

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

36 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Rune

Rune is a tool to post-process Haiku raw ARM images for various target devices.

Build Status MIT License

Features

  • Coordinates with a remote manifest at Github of known target boards.
  • Injects any needed vendor specific boot binaries from remote sources.
  • Writes directly to an SD card, or to a new image file.

Why is this needed?

The ARM ecosystem contains a wide range of technology and boot processes. While this variability has been great for innovation, it also means operating systems need to be custom tailored per device.

Specific boot files on SD cards, secondary loaders at specific offsets, binary vendor blobs tailored just right per SOC specifications and GPL licensed u-boot binaries make the ARM ecosystem a tricky beast to conquer.

Why Rust?

  • Low level enough to directly write to files and make modifications without relying on external tools.
  • Cross-platform. Rune is designed to be used by end-users across multiple operating systems.
  • Easy json parsing and HTTP GET's without requiring a large number of libraries.

Example Usage

  • Listing available boards: rune -l
  • Prepare an SD card for the Raspberry Pi 2: rune -b rpi2 -i haiku-arm.mmc /dev/sdc
  • Write the prepared disk image to a file: rune -b rpi2 -i haiku-arm.mmc /home/alex/haiku-arm-rpi2.mmc
  • Make an SD card bootable which has had Haiku dd'ed to it: rune -b rpi2 /dev/sdc

Credit

  • Thanks to Fedora for creating fedora-arm-installer which was the inspiration for this tool.
  • Thanks to the great Rust folks for helping out!