RMIPS is a MIPS R3000 virtual machine simulator written in Rust and based on VMIPS.
Check the releases page for precompiled binaries.
To build from source, first install Rust then run the following:
git clone https://github.com/starfleetcadet75/rmips.git
cd rmips
cargo build --releaseInstall the gcc-mips-linux-gnu package in order to cross-compile for MIPS targets.
Use the examples directory as a starting point for creating ROMs.
RMIPS exposes a GDB stub that can be used for debugging emulated programs.
Start RMIPS with the --debug flag to enable the GDB server:
$ cargo run ./examples/build/emptymain_le.rom --debug
Interpreting ROM file as Little-Endian
Mapping ROM image (./examples/build/emptymain_le.rom, 223 words) to physical address 0x1fc00000
Mapping RAM module (1024KB) to physical address 0x00000000
Mapping Halt Device to physical address 0x01010024
Mapping Test Device to physical address 0x02010000
*************[ RESET ]*************
Waiting for a GDB connection on "127.0.0.1:9001"...You can then connect to it from another shell with gdb-multiarch:
$ gdb-multiarch emptymain_le.elf
(gdb) target remote 127.0.0.1:9001
(gdb) break begin
(gdb) cNote: The ROM file does not contain any debugging information. Use the ELF program with GDB so that it can show source information.
- VMIPS
- MIPS R3000 Manual
- MIPS32 Architecture For Programmers Volume I: Introduction to the MIPS32 Architecture
- MIPS32 Architecture For Programmers Volume II: The MIPS32 Instruction Set
- MIPS32 Architecture For Programmers Volume III: The MIPS32 Privileged Resource Architecture
- Software Solutions for Single Instruction Issue, in Order Processors
- GNU AS MIPS Dependent Features
- Detecting MIPS Emulation
See the LICENSE file.