RAM-emu/readme.md

1.3 KiB

What?

This is a simple random-access-machine emulator (not to be confused with random access memory) that I made for university.

Oh, also, it doesn't entirely work yet.

Install?

Depending on your needs, there are two options. You need cargo (and Rust) installed in both cases, so get that.

Cli usage

To use the cli, simply run these commands:

git clone http://git.dekedin.me/raphy/RAM-emu.git
cd RAM-emu/rammodel
cargo run testprograms/program1 1 2

This will run the first example and add the two numbers there. You could install the program "system-wide" with cargo install . but I don't know why you would want to do that.

Webpage, woo!

Besides cargo, you also need npm and wasm-pack.

git clone http://git.dekedin.me/raphy/RAM-emu.git
cd RAM-emu/
npm install
./build.sh

Usage?

Cli usage

The command line program currently takes a single required argument, namely a text file containing a program. Examples can be found in testprograms/. Input can be supplied by writing all the input numbers after the input program.

An informal description of the whole instruction set can be found in ISA.md.

Webpage usage

idk it's a static website lol

use nginx or whatever

This is very unprofessional. I don't get it!

Open a pull request. I'll document everything properly in a bit.