Aira Force

Aira Force is a tool for analysing and reverse engineering classic Amiga 680x0 software. It allows binaries to be disassembled and investigated. The primary goal of this project is to provide a graphical user interface on top of the ira "reassembler" to accelerate the workflow.

Aira Force also features a basic Amiga OCS emulator and debugger, which can be used for dynamic analysis.

Aira Force implements "reassembly" using the ira disassembler and the vasm assembler. Ira transforms the source executable or raw binary into assembly language source code, then vasm assembles the source code. The output binary should be identical (or equivalent) to the input binary.

This process allows the user to analyse and annotate the source code efficiently, before making any required changes to the generated disassembly and building a patched binary. It may be useful for fixing bugs, adding features, optimising the code, or academic software archeology.

The tool is in active development.

Features

• Disassemble Amiga executables (hunk load modules) or raw binaries, e.g. bootblocks, non-DOS programs
• Interactively convert disassembly to code, data or text
• Add and rename labels
  
• Add comments and banners
• Define pointers and equates
  
• Efficient code navigation - menu and keyboard driven UI
• Tools to search for potential pointers, equates and code
  
• Built-in Amiga OCS emulator: 68000 with prefetch, Copper, Blitter, sprites, Paula audio, CIAs and floppy disk controller
• ADF and IPF/SPS disk images, with up to four floppy drives (DF0: to DF3:)
• Runs Kickstart ROMs (including Cloanto Amiga Forever), or runs (some) binaries with no ROM at all
• Debugger: breakpoints, watchpoints, CPU history, memory map, DMA history, Copper disassembly, and source-level debugging of vasm-generated binaries
• Dynamic Analysis - automatically annotate disassembly from executed code with context
• In-built Amiga documentation (custom chipset, OS)
• Runs on Windows, Linux, macOS and Raspberry Pi (sorry, no Amiga version)
• View memory as hex or bitmap
• Reassemble disassembled code and compare against source
• Source level debugging of vasm generated binaries
• Dockable windows and multi-viewports (native OS windows) with Dear ImGui

Emulator limitations

• 68000 only
• OCS only - no ECS or AGA
• Not fully cycle-exact
• No floppy disk write
• No interlaced video
  
• No hard drives
• No audio on Raspberry Pi
• Compatibility is good, but not 100%

Usage

Please see the readme in the package and Help > Getting Started.

Support

The Opcodes Collective Discord server kindly hosts an aira-force channel.

Credits

• ira reassembler by Tim Ruehsen, Frank Wille and Nicolas Bastien
• VASM assembler by Volker Barthelmann and Frank Wille
• Simple DirectMedia Layer (SDL2) by Sam Lantinga and contributors
  
• Dear ImGui by Omar Cornut and contributors
• Amiga NDK Copyright (C) 2019 Hyperion Entertainment CVBA
• Portable File Dialogs by Sam Hocevar
• tinyxml2 by Lee Thomason
• imgui_markdown by Juliette Foucaut & Doug Binks
• cleanCppProject by kracejic
• Hoffman and TTE for inspiration, help and support
• Didier Malenfant for macOS support
• Gerbil for Squizz icon
• Tom Harte and raddad772 for 68000 single step tests

sudo apt install ./aira-force-linux.deb