Grouter / ram

Random Access Machine Simulator

Random Access Machine

TODO

• HALT
• JGZERO
• Simulate register access times
• Grammars (current syntax error checking is very bad)
• TUI and editor
• Complexity calculation (logarithmic)

Before Use (Dependencies)

• Download Rust

Use

Instructions file

Currently file loading is hardcoded to load the instructions.ram file.
The current instructions.ram program calculates n! from the input tape.

Input tape

The input tape is hardcoded for now:

let mut state = ProgramState {
    ic: 0,
    input: vec![4; 1],          // <==== The input tape (currently consist of one number 4)
    input_pointer: 0,
    output: Vec::new(),
    registers: [0; REGISTER_COUNT],
    exit_state: false
};

Writing code

1. To write code either:

   • modify the instructions.ram file
   • rewrite the hardcoded value in main.rs to load other file.

2. Run the program:

cargo run

Outputs

To get more verbose outputs modify these values in main.rs

pub const   VERBOSE_MODE: bool =            true;
pub const   DUMP_REGISTERS: bool =          false;
const       DUMP_TOKENS: bool =             false;
const       DUMP_INSTRUCTION_LINE: bool =   false;
pub const   STEP_DEBUG: bool =              false;

Commands

Instruction	Operand	Description
LOAD	reg	Load value from register to ACC
STORE	reg	Store value from ACC to register
STORE	*reg	Store value from ACC to register (indirectly)
ADD	=const	Adds value to ACC
SUB	=const	Subtracts value from ACC
MUL	=const	Multiply ACC by a value
DIV	=const	Divide ACC by a value
READ	reg	Read value from input tape to register
READ	*reg	Read value from input tape to register (indirectly)
WRITE	reg	Writes a value from register to the output tape
JUMP	label	Jumps to a label
JZERO	label	Jumps to a label (if ACC == 0)

Explanations

1. reg = Index of a register

    For example to multiple ACC by a value stored in the register 1 use MUL 1
    
    ACC is refering to a register 0

2. *reg = Indirect linking. That means the value stored in a register with a index reg will be used as a index.

    For example:
   
   | Register | Value |
   |----------|-------|
   | 0 (ACC)  | 0     |
   | 1        | 10    |
   | 2        | 1     |
   
    The instruction LOAD *2 will look into the register 2
    The register 2 has a value of 1, so the register 1 (value of 10) will be loaded to ACC

3. const = Working with pure constants.

    For example to multiply ACC by 42 use MUL =42

4. label = Label name

    For example:
    
    AWESOME_LABEL:      <=== Define label
    ... some code ...
    JUMP AWESOME_LABEL  <=== Jump to the label
    
    You can also jump to the label before it is defined