README.md

LC-3 VM

LC-3 VM written in Go. LC-3 or Little Computer 3 is a fictional computer system that is designed to teach students how to code in assembly language. This project is based on an article written by Justin Meiners and Ryan Pendleton.

---

Installation

$ go get github.com/hadialqattan/lc3-vm-golang

Usage

Run a compiled program:

$ lc3-vm-golang programs/bin/rogue.obj

Compile & Run an LC-3 assembly program (Docker is required):

$ ./compiler/runner.sh hello_world # `hello_world.asm` should be placed in `programs/source/`

---

Useful Resources

• LC-3 Online Simulator
• LC-3 Assembly Manual And Examples
• Ryan Pendleton's 2048 game implementation
• Justin Meiners's Rogue game implementation

---

Copyright ©

👤 Hadi Alqattan

• Github: @hadialqattan
• Email: [email protected]

📝 License

Copyright © 2020 Hadi Alqattan.
This project is MIT licensed.

---

Give a ⭐️ if this project helped you!