2i-emulator

Cli emulator for the micro computer 2i used in the computer science hardware course at Leipzig University.

Register:        Eingaberegister:   Letzte Flags, Flag-Register:
  R0: 00000010     FC: 00000101       Carry: 0, 0 | Negativ: 0, 0 | Null: 0, 0
  R1: 00001100     FD: 00001100
  R2: 00100100     FE: 00000000     Nächster Befehl (00110):
  R3: 00000000     FF: 00000000       00 01000 | 00 | 000 1111 01 | 01 0100 | 0
  R4: 00000000                        ~ R0 = R0 + FF; JMP 01000
  R5: 00000000   Ausgaberegister:
  R6: 00000000     FE: 00111100     [FC = 11010]: Eingaberegister setzen
  R7: 00000000     FF: 00000000     [ENTER]: Nächsten Befehl ausführen

Build

The project can be built using cargo. You can also use one of the binaries provided for convenience.

cargo build --release

Usage

You have to run the emulator in a terminal and specify the filename of the program you want to run as a parameter:

target/release/2i-emulator doc/examples/answer.2i

You can also associate 2i-files directly with the emulator.

Example

The following example (answer.2i) calculates the number 42 and writes it to the output register FE.

# The answer to everything: (FE) = 42

00000: 00 00001 | 00 | 000 0101 01 | 01 0001 0
00001: 11 00010 | 00 | 000 0000 01 | 00 0100 0
00010: 00 00001 | 00 | 000 0000 01 | 00 0101 0
00011: 00 00100 | 00 | 000 0000 01 | 00 1000 0
00100: 00 00101 | 00 | 000 0000 01 | 00 1000 0
00101: 00 00110 | 00 | 001 1110 01 | 01 0001 0
00110: 00 00000 | 11 | 001 0000 00 | 00 0001 0

Any character but 0 and 1 is ignored inside commands and can be used for formatting. Every command can optionally be prefixed with its address. Empty lines and ones that start with # are ignored.

Documentation

The doc folder contains a german documentation of the micro computer and its instructions. The api documentation of the emulator can be generated using cargo doc.

Licence

This program by Klemens Schölhorn is licenced under the terms of the GPLv3.