Skip to content

Latest commit

 

History

History
113 lines (97 loc) · 3.75 KB

readme.md

File metadata and controls

113 lines (97 loc) · 3.75 KB
Raw

SIMPLE ASSEMBLER && Debugger

Debugger and assembler for SIMPLE MIPS Reduced processor. This is just a personal project (the first) to learn go.

Assembler

Getting Started

This tool is not interactive

usage

> ./assembler -h                 # Show help
> ./assembler -i filename        # Input file to assemble
> ./assembler -o                 # Output file with binary machine code
> ./assembler -a  "instruction"  # ASM one line, [dont use with -i]

Examples

./assembler -a  "LUI $R0, 0"
./assembler -i  fire_jump.asm  
./assembler -i  fire_jump.asm -o fire.mem

Features

Instructions are separated by endlines, semicolon is optional

Supports

  • Multiline comments (style /**multiline comment**/)
  • Inline comments (style //comment)
  • Insensitive instructions
  • Register names like $R1 R1 $1 r01
  • Tags for jump and banch
  • Duplicate tag detection
  • Unused tags
  • Builtin auto halt at end
  • Builtin nop (sll 0 0 0)

Instrucction set

Instruction behavior and format (for SIMPLE MIPS Reduced) is exactly the same as specified in the document “MIPS® Architecture for Programmers Volume II-A: The MIPS32® Instruction Set Manual” (Document Number: MD00086 Revision 6.06 December 15, 2016)

You can find it here https://www.mips.com/products/architectures/mips32-2/

Type instrucction Usage
Type R SLL SLL rd, rt, sa
Type R SRL SRL rd, rt, sa
Type R SRA SRA rd, rt, sa
Type R SLLV SRA rd, rt, rs
Type R SRLV SRLV rd, rt, rs
Type R SRAV SRAV rd, rt, rs
Type R ADDU ADDU rd, rt, rs
Type R SUBU SUBU rd, rs, rt
Type R AND AND rd, rs, rt
Type R OR OR rd, rs, rt
Type R XOR XOR rd, rs, rt
Type R NOR NOR rd, rs, rt
Type R SLT SLT rd, rs, rt
Type I LB LB rt, offset (base)
Type I LH LH rt, offset (base)
Type I LW LW rt, offset (base)
Type I LWU LWU rt, offset (base)
Type I LHU LHU rt, offset (base)
Type I LBU LBU rt, offset (base)
Type I SB LB rt, offset (base)
Type I SH SH rt, offset (base)
Type I SW SW rt, offset (base)
Type I ADDI ADDI rt, rs, inmediate
Type I ANDI ANDI rt, rs, inmediate
Type I ORI ORI rt, rs, inmediate
Type I XORI XORI rt, rs, inmediate
Type I LUI LUI rt, inmediate
Type I SLTI SLTI rt, rs, inmediate
Type I BEQ BEQ rs, rt, offset
Type I BNE BNE rs, rt, offset
Type I J J target
Type I JAL JAL target
Type J JR JR rs
Type J JALR JALR rs (rd=31 default); JALR rd, rs

Debbuger

Getting Started

This tool is interactive

usage

> ./debuger -h                 # Show help
Params and arguments
Flag argument type default description
-d string ttyUSB1 File device in /dev/<dev>
-b number 115200 Baudrate
-l string empty Mem file to be load (Generated by assembler tool)
-v no argument false verbose mode (serial monitor)

Prompt command:

command usage description
exit exit Exit
dumprf dumprf Gets the 32 values of the general-purpose registers (R0 to R31)
step step [NUM] The processor runs NUM clock cycle (default 1)
run run Run the processor in burst mode
pc pc Get the PC register
reset reset Reset pc counter
dumpmem dumpmem START END Dump memory data from START to END
load load Loads the specified program with the '-l' option into the processor's program memory