A simple program to translate UXN roms into the textual uxntal language.
Disassembled files can be re-assembled into UXN roms using the UXN assembler.
A python version of the disassembler is kept for testing and reference.
$EMU ./disassembler.rom $ROM_TO_DISASSEMBLE > $OUTPUT
./uxn_disassembler.py < $ROM_TO_DISASSEMBLE > $OUTPUT
UXN reads roms as a raw binary blob, unlike ELF or PE, there are no sections to distinguish between code and data, thus all data given to the disassembler is assumed to be code.
Data that isn't a valid op code, is kept as raw data. After each disassembled opcode there is a comment containing the original data that was parsed.
Before each opcode (and raw data) the is absolute padding
(|0100 for example), remember to update/remove them when
patching a disassembled rom.
make EMU=$PATH_TO_UXNEMU ASM=$PATH_TO_UXNASM disassembler.rom
make EMU=$PATH_TO_UXNEMU ASM=$PATH_TO_UXNASM test
|0100 #0000 ( a00000 )
|0103 #00 ( 8000 )
|0105 STZ2 ( 31 )
|0106 #0000 ( a00000 )
|0109 #03f4 ( a003f4 )
|010c STA2 ( 35 )
|010d #0114 ( a00114 )
|0110 #10 ( 8010 )
|0112 DEO2 ( 37 )
|0113 BRK ( 00 )
This repository uses the MIT license. More info in the LICENSE file.