godcrampy / mips-assembler

🏭 Assembler to emulate and execute programs written in MIPS assembly language independent of hardware.

MIPS Assembler

Assembler to emulate and execute programs written in MIPS assembly language. The assembler will emulate a 1KB RAM Space and 32 bit registers without actually using up system registers directly. This allows it to run on any processor maching with a C++14 compiler.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

C++14 compiler preferrably GCC.

Installing

1. Clone this repo to local machine

$ git clone https://github.com/godcrampy/mips-assembler.git

2. cd into the cloned repo $ cd mips-assembler

3. Build the program using make: (Assumes G++ installed, edit the Makefile for other options) $ make

OR

3. Build using compiler $g++ src/main.cpp src/file-io/file-io.cpp src/parser/parser.cpp src/register-module/register-module.cpp src/ram-module/ram-module.cpp src/cpu-module/cpu.cpp -o build/mips

Executing MIPS

The assembler program will be built in the build directory. To run MIPS code, you need 3 files:

• .mips: This is the file in which you'll write the mips program
• .ram: This is the file in which you'll give ram configuration
• .reg: This is the file in which you'll give register configuration

Example MIPS Code

test.mips

lw	$t0, 0($s1)
addi $t1, $zero, 6
while: log loop 0 $t0
addi $t0, $t0, 1
bne $t0, $t1, while

register.reg

$s1: 120

memory.ram

120: 1

Execution: $ ./mips ./test.mips ./register.reg ./memory.ram Output:

loop 1
loop 2
loop 3
loop 4
loop 5

Current Status

Currently the following instructions are supported:

• add
• addi
• sub
• and
• andi
• or
• ori
• srl
• sll
• lw
• sw
• log

Note: log is not a mips instruction. It has been provided to print register data to the teminal. It's syntax is: log message add register. This will print message followed by the data in the register with add value added to it.