#lc3

bin+lib lc3-rs

A LC-3(Little Computer 3) virtual machine

7 releases

✓ Uses Rust 2018 edition

new 0.3.1 May 22, 2019
0.3.0 May 14, 2019
0.2.0 May 5, 2019
0.1.3 May 5, 2019

#6 in Simulation

33 downloads per month
Used in 1 crate

GPL-2.0-only

34KB
756 lines

lc3-rs

Efficient LC-3 simulator for any platforms, written in pure Rust.
Copyright (C) 2019 Nam Jeonghyun. (ska827@snu.ac.kr)

Usage

Currently there is no useful frontends (e.g. benchmarkers, debuggers) is implemented. You can run simple LC-3 calculator which implements this specification with cargo run --bin calc.

Using as a library

You can use lc3::vm to get your code to handle LC-3 instructions. Please refer to docs.

There are two useful optional features for debugging, register-trace and instruction-trace.

If register-trace feature is enabled, pc, ir, register will be printed into stderr after each steps are executed. Note that pc will represent an actual location of the instruction executed(PC is automatically incremented after fetching instructions, therefore self.pc-1), but register values will be printed after the instruction is executed.

If instruction-trace feature is enabled, contents of ir will be printed into stderr as a parsed Instruction enum before the instruction is executed.

Additionally, on Windows, CRLF line endings will be automatically converted into LF. If you prefer not to do this, enable disable-crlf-compat-windows feature when building.

License

GPLv2, also refer to a copyright notice for embedded lc3os.obj.

No runtime deps