MIPS Assembler and IDE

This is my project for Computer Organization, Shi Qingsong, Zhejiang University.

The MIPS assembler is based on the MIPS 32 specification, with some custom extensions.

The MIPS IDE is built upon SWT, packaged with launch4j for Windows executable.

Screenshot

Specification

This MIPS assembler mainly complies with the specifications from "MIPS Assembly Language Programmer’s Guide" and "MIPS32 Architecture For Programmers Volume II: The MIPS32 Instruction Set".

Instruction set

95 Instrucitons:

ADD
ADDI
ADDIU
ADDU
AND
ANDI
B
BEQ
BEQL
BGEZ
BGEZAL
BGEZALL
BGEZL
BGTZ
BGTZL
BLEZ
BLEZL
BLTZ
BLTZAL
BLTZALL
BLTZL
BNE
BNEL
BREAK
COP2
DERET
DIV
DIVU
ERET
J
JAL
JALR
JR
LA
LB
LBU
LDC1
LDC2
LH
LHU
LI
LL
LUI
LW
LWC1
LWC2
LWL
LWR
MFC0
MFHI
MFLO
MOVE
MOVN
MOVZ
MTC0
MTHI
MTLO
MULT
MULTU
NOR
NOP
OR
ORI
PREF
SB
SC
SDC1
SDC2
SH
SLL
SLLV
SLT
SLTI
SLTIU
SLTU
SRA
SRAV
SRL
SRLV
SUB
SUBU
SW
SWC1
SWC2
SWC3
SWL
SWR
TLBP
TLBR
TLBWI
TLBWR
SYSCALL
WAIT
XOR
XOR

10 directives:

.TEXT
.DATA
.ASCII
.ASCIIZ
.BYTE
.HALF
.WORD
.SPACE
.EVAL
.ECHO

JavaScript expression is supported for operands, while .eval can evaluate a JavaScript expression anywhere and .echo can echo the JavaScript returned string as the source code to assemble in place.

Assemble

Numerous error checks are done during the process of assembly, including illegal operand, immediate overflow, missing or duplicate label, text and data section overlap, etc.

Available output formats include binary, COE and a debug mode.

Disassemble

Disassembling can be done by opening a binary or COE file. All the instructions listed above and labels are supported, and multiple bytes of zero can be compressed into a .space directive.

Graphical user interface

Native GUI on Linux, Windows and Mac OSX.
Drag-and-drop to open a file.
Printing support.
Line number and syntax highlighting.

Command line interface

usage: mipsasm [OPTION]...
 -g,--graphical       Launch graphical user interface
 -h,--help            Display this help and exit
 -i,--input <FILE>    Read input from FILE
 -o,--output <FILE>   Write output to FILE
 -t,--terminal        Launch in terminal mode
 -w,--writer <TYPE>   Use writer of TYPE. TYPE can be 'binary', 'coe',
                      'debug' (the default), or 'hexdebug'

Sample code

# "Hello World" in MIPS assembly
# From: http://labs.cs.upt.ro/labs/so2/html/resources/nachos-doc/mipsf.html

	# All program code is placed after the
	# .text assembler directive
	.text 0x0

# The label 'main' represents the starting point
main:
	# Run the print_string syscall which has code 4
	li	$v0, 4		# Code for syscall: print_string
	la	$a0, msg	# Pointer to string (load the address of msg)
	syscall
	li	$v0, 10		# Code for syscall: exit
	syscall

	# All memory structures are placed after the
	# .data assembler directive
	.data 0x20

	# The .asciiz assembler directive creates
	# an ASCII string in memory terminated by
	# the null character. Note that strings are
	# surrounded by double-quotes

msg:	.asciiz	"Hello World!\n"

zhanghai/mipsasm