MIPSpy - A MIPS Simulator
=========================
* by: brian reily
* url: http://brianreily.com/projects/mips_simulator
status
------
* MIPSpy was written a while ago and just moved to github
recently for safekeeping. There may be a few bugs left
but it is not being actively developed/maintained.
usage
-----
* sample session:
>>> import simulator
>>> # Defaults are verbose=False, mem=1000, pc=0
>>> s = simulator.Simulator()
>>> s.run_line('line of code')
>>> s.run_lines( ['line', 'line', 'line'] )
>>> s.status() # show register, data, and pc status
>>> s.get_register('$t0') # manually retrieve a register value
>>> s.get_register('$8')
>>> s.get_register(9)
>>> s.registers['$v0'] = 4 # manually set a register value
>>> s.data[4] = 42 # manually set a data value
>>> s.rerun() # reruns all previous instructions
>>> s.instructions # shows instructions in memory
>>> s.reset() # reset all registers, data, pc
* verbose mode will basically comment your code, as it shows you
the starting values of operands, the operation, and then the ending
values:
>>> s.run_line('addi $t0, $0, 4')
0: addi $t0, $0, 4 # $t0 = 0 + 4 = 4
>>> s.run_line('addi $t0, $t0, 4')
1: addi $t0, $t0, 4 # $t0 = 4 + 4 = 8
* to read from a file:
>>> s = simulator.Simulator()
>>> s.run_lines( open(file, 'r').readlines() )
supported operations
--------------------
syscall, j, b, jr, beq, bne, lw, sw, slt, slti, add, addi,
sub, subi, and, andi, or, ori, sll, sllv, srl, srlv, div,
mul, xor, xori, move
caveats
-------
* div and mul are three register instructions like add and sub.
* no memory addresses are assigned; memory is instead implemented
as a list - this makes it very easy to test MIPS code but is bad
if you need to use it for class.
* there is no .data section - right now you have to manually input
your .data section using 'Simulator.data[index] = value'
issues
------
* verbose mode seems to be a bit buggy, trying to track it down.
