Description

An LC4 assembly interpreter in Haskell. For the 240 kids to use hopefully.

Team

Github repo is at: https://github.com/johnpmayer/lc4sim
Trello is used for collaboration amongst current devs at:

https://trello.com/board/lc4sim/4ed3e6e4aebfc0d21d0ee596

Stages

Load

read x.asm
parse
loader
vmstate

Run

Breakpoint? No -> End Yes -> commandline waiting

Step

vmstate step

Print

register file
current stack?
pc
instruction
trace?

Modules

lc4parser

Parses LC4 assembly file into lc4env data structures to be used in rest of program.

lc4vm

The data type definitions of the LC4 environment, as well as associated data structures used to represent state.

The PC is going to be represented with line numbers. Comments are considered as NOPs. As long as the invariant holds internally, the OS will not clobber R7 accidentally.

simulator

Performs the interpretation and altering of state.

lc4PP

The LC4 pretty printer.

main

Parses command line args and executes program components. This is where the REPL lies.

Parser

The parser module that parses generic strings. Works with ParserCombinators.

vmloader

Takes a parsed .asm file and loads the appropriate values into the LC4 virtual machine. Instantiates a new VM for the simulator.

johnpmayer/lc4sim