RMIPS

RMIPS is a MIPS R3000 virtual machine simulator written in Rust and based on VMIPS.

Install

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 --release

Development

Install 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.

GDB Support

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) c

Note: The ROM file does not contain any debugging information. Use the ELF program with GDB so that it can show source information.

References

• 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

License

See the LICENSE file.