This was originally developed by Kevin Cahalan, Jerrett Longworth, Huy Nguyen, Evan Raiford, and Jimmie Smith at UCF as a senior design project.
A web-based emulator for MIPS64 made for educational purposes. Its emulation core supports over 60 real instructions and 20 pseudo-instuctions and an user interface that provides the following features:
- Step execute and execute code down to the individual stages
- Upload files to SWIM and Copy code to the user's clipboard to be saved locally
- Note: For Chromium-based browsers on Mac, the user will have to manually copy-paste the code onto a text editor. This is done as followed:
- Click on the Editor window.
- Press
Cmd + Ato select all text. - Press
Cmd + Cto copy the text on your clipboard. - Press
Cmd + Vto paste the text in your text editor to save the code.
- Note: For Chromium-based browsers on Mac, the user will have to manually copy-paste the code onto a text editor. This is done as followed:
- A register viewer that displays General Purpose and Floating Point registers with toggling to different views (decimal, binary, hexadecimal, float, double)
- A console viewer to display errors and suggestions on fixing them
- A memory viewer to see the code compiled and updated as it executes
- A visualization of the datapath to see the individual parts that make up the general and floating-point coprocessors and the values inside each wire
- Utilizes the Monaco Editor code library to provide:
- Syntax highlighting of our custom language
- Highlighting the previously executed line
- Providing mouse hover information on instructions and errors
- Expands the pseudo-instructions into their hardware equivalent upon assembling code
Supported Instructions:
-
Conventional Instructions:
- add
- addi
- addiu
- addu
- and
- andi
- aui
- b
- beq
- bne
- dadd
- daddi
- daddiu
- daddu
- dahi
- dati
- ddiv
- ddivu
- div
- dmul
- dmulu
- dsub
- dsubu
- j
- jal
- jalr
- jr
- lui
- lw
- mul
- nop
- or
- ori
- sll
- slt
- sltu
- sub
- sw
- syscall
Note: This is currently a stubbed instruction to halt emulation.
-
Floating-Point Instructions:
- add.d
- add.s
- bc1f
- bc1t
- c.eq.d
- c.eq.s
- c.le.d
- c.le.s
- c.lt.d
- c.lt.s
- c.nge.d
- c.nge.s
- c.ngt.d
- c.ngt.s
- div.d
- div.s
- dmfc1
- dmtc1
- lwc1
- mfc1
- mtc1
- mul.d
- mul.s
- sub.d
- sub.s
- swc1
-
Pseudo-instructions:
- ddivi
- ddiviu
- divi
- dmuli
- dmuliu
- dsubi
- dsubiu
- li
- lw
(followed by a label) - move
- muli
- seq
- sge
- sgeu
- sgt
- sgtu
- sle
- sleu
- sne
- subi
- sw
(followed by a label)
Supported .data directives:
- .ascii
- .asciiz
- .byte
- .double
- .float
- .half
- .space
- .word
All of this wholly developed with the Rust language with the interface built with the Yew framework which uses WebAssembly and JavaScript to house the emulation core and parser/assembler.
While SWIM is currently being hosted here, you can compile and run it locally on your browser as long as it supports WebAssembly.
- Install the latest stable rust toolchain with
rustupat https://www.rust-lang.org/tools/install- If you plan on compiling the source yourself, make sure to add WebAssembly as a compile target by typing
rustup target add wasm32-unknown-unknownin your terminal
- If you plan on compiling the source yourself, make sure to add WebAssembly as a compile target by typing
- Install trunk
git clonethe repository or download the source here- When you are in the root directory of the project, type
trunk serve --openin your terminal to load it locally
SWIM is licensed under GNU's GPL-3.0 as shown here