Disassembling RISC OS ARM code on other systems

by gerph 8 months ago

macOS ◆ xterm-256color ◆ fish 210 views

Disassembling ARM code on RISC OS is easy enough, but doing so on other systems is a little harder. The riscos-disassemble-python repository provides a disassembler which decodes in a similar style to RISC OS, and knows about RISC OS SWI naming. The repository was created out of the RISC OS Pyromaniac work, and is available for installation anywhere there is a Python. To install, use pip3 install riscos-disassemble. The command riscos-dumpi can be used to display the contents of binaries.

This recording shows the disassembly of two small test utilities - one which prints ‘hello world’ and one which reports the OS version. These demonstrate the decoding of some constants, strings and the SWI names.

The final disassembly is of the Hexen game binary, using the filtering to limit to only a single function. This also demonstrates the function name decoding for entry points and branches, constant values and bit decoding, and the recognition of a branch table.

More by gerph

Creating a changelog entry with changelog-management 01:14

by gerph 11 months ago

65Tube running on Pyromaniac on Darwin 01:18

by gerph 3 years ago

CObey module, running in debug mode 00:13

by gerph 4 years ago

Initialising Pyromaniac with lots of modules in ROM 00:45

by gerph 5 years ago

See all

You can download this recording in asciicast v2 format, as a .cast file.

Download

Replay in terminal

You can replay the downloaded recording in your terminal using the asciinema play command:

asciinema play 656346.cast

If you don't have asciinema CLI installed then see installation instructions.

Use with stand-alone player on your website

Download asciinema player from the releases page (you only need .js and .css file), then use it like this:

<!DOCTYPE html>
<html>
<head>
  <link rel="stylesheet" type="text/css" href="asciinema-player.css" />
</head>
<body>
  <div id="player"></div>
  <script src="asciinema-player.min.js"></script>
  <script>
    AsciinemaPlayer.create(
      '/assets/656346.cast',
      document.getElementById('player'),
      { cols: 116, rows: 48 }
    );
  </script>
</body>
</html>

See asciinema player quick-start guide for full usage instructions.

While this site doesn't provide GIF conversion at the moment, you can still do it yourself with the help of asciinema GIF generator utility - agg.

Once you have it installed, generate a GIF with the following command:

agg https://asciinema.org/a/656346 demo.gif

Or, if you already downloaded the recording file:

agg demo.cast demo.gif

Check agg --help for all available options. You can change font family and size, select color theme, adjust speed and more.

See agg manual for full usage instructions.