1.3 KiB
mima-tools
File format
All tools share a common file format, which basically just contains
the MiMa's initial memory state. Its file extension is .mima.
A MiMa operates on words of 24 bits, so the file is split up into blocks of 3 bytes, written directly one after the other with nothing in-between. The bytes within one 3-byte block are ordered from most significant to least significant.
The file contains no metadata. Opcodes are the same as specified in the lecture. The first block is at address 0. MiMa's execution starts at address 0 (i. e. the first block).
Programs
These programs are just ideas at this point, but will hopefully be working one day.
mima-run
This program can load and run .mima files at a specified processor
speed (given in instructions per second).
I don't know how IO is going to happen on this machine. Maybe I'll
just print a memory dump once the HALT instruction was encountered,
or maybe I'll use left over instructions to add a brainfuck-like print
command. Or maybe there is already a solution designed into the MiMa?
mima-debug
This program is like mima-run, but also contains a live debugging
TUI.
Conventions
In the source code, the name MiMa is spelled Mima. When displayed,
it is spelled MiMa.
Executable names are all lowercase, and words are separated by a -.