Home

Awesome

RMIPS

Lines of Code

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

License

See the LICENSE file.