spimulator

spimulator is an text-based MIPS32 simulator. Works on Windows, Linux, and MacOS.

Building from source

spimulator is built with Meson and Ninja.

Linux

• Install the toolchain. On Fedora:
  • dnf install meson ninja-build gcc libedit-devel
• On Debian-based systems:
  • apt install meson ninja-build gcc libedit-dev
• Configure and build:
  • meson setup builddir
  • meson compile -C builddir
• Optionally install system-wide:
  • meson install -C builddir
• Run programs:
  • batch:
    • ./builddir/spimulator -f /path/to/01-helloworld.asm
  • interactively:
    • ./builddir/spimulator
      • load "/path/to/01-helloworld.asm"
      • step
      • step
      • run

macOS

• brew install meson ninja gcc libedit
• meson setup builddir && meson compile -C builddir

Container (any host)

• podman build -t spimulator . (or docker build).
• The included Dockerfile builds spim on Fedora 44, runs the regression suite, and fails the build on any test failure.

Copyright

spimulator is Copyright (c) 2021, by William Emerison Six, starting from git commit e10b97408f6d2c405c36ab05cdffbf40828970fd All rights reserved.

spimulator is distributed under a BSD license. See LICENSE

Original work

SPIM is Copyright (c) 1990-2020, by James R. Larus. All rights reserved.

This project is derived from spim, https://sourceforge.net/projects/spimsimulator/.