README.md

lc3-vm-rust

Basic implementation of the LC3 virtual machine in Rust. An educational computer architecture, it has a simplified instruction set compared to x86.

It supports the following instructions:

Instruction	Supported
BR	✅
ADD	✅
LD	✅
ST	✅
JSR	✅
JSRR	✅
AND	✅
LDR	✅
STR	✅
STI	✅
NOT	✅
LDI	✅
JMP	✅
LEA	✅
TRAP	✅

Usage

Clone the repository

  git clone git@github.com:damiramirez/lc3-vm-rust.git && cd lc3-vm-rust

Run with the example program - 2048 Game

  make run

There are other example programs in the examples directory. You can run them with the following command:

  make run FILENAME=./examples/FILE.obj