Skip to content
Souvlaki42Public

About

MARS MIPS Assembler and Runtime Simulator

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

MARS

MARS (official) MIPS Assembler and Runtime Simulator

MARS is a lightweight interactive development environment (IDE) for programming in MIPS assembly language, intended for educational-level use with Patterson and Hennessy's Computer Organization and Design.

It is available for you to download as an executable JAR file. Click the MARS v.4.5 link at right, under Releases, to access the download.

We have relocated the MARS website to https://dpetersanderson.github.io/ There are still a couple of display issues to work out but all website content is there. This includes all documentation and the JAR download. We are not experienced in github so if you know a way we can host the website in this MARS repository let us know.

This is the original MARS, developed by Pete Sanderson and Ken Vollmar. Developed while Pete was professor at Otterbein University and Ken was professor at Missouri State University. Both are now retired. This is a legacy application but is very stable and continues to be used by universities throughout the world as of 2024. The last release was MARS 4.5 in August 2014.

Until October 2024 the MARS website, including executable JAR file download, was hosted by Missouri State University. That is no longer the case. That's why it is here.

Warning

This is my community maintained fork version that merges useful PRs into the project for my personal use. You can use it if you want, but I'm not gonna maintain it much, so use it at your own risks.

Features

This fork includes Flatlaf to allow for:

  • Partial dark mode support
  • Intellij theme support
  • Native window decorations
  • High DPI displays
  • Automatic theme delection using jSystemThemeDetector

And more...

List of merged upstream PRs and fixed issues

Screenshot

How the app looks like now

How to use

First, Install Java 25 on your system.
Choose a gradle wrapper base on your OS:
On Windows use ./gradlew.bat. Otherwise use ./gradlew.
Run the app with the ./gradlew run command.
Format it with the ./gradlew spotlessApply command.

Look at Mips examples here.

Credits

Obviously, thanks to Pete Sanderson for making the original app.
Thanks to Flatlaf for the legacy Java theming and modern display features support.
Thanks to Steven for contributing most of the PRs mentioned.
Thanks to Daniel Dimitrov for the directory persistence PR.
Thanks to Daniel Gyoerffy for the jSystemThemeDetector library.
Thanks to Google and Spotless for their java formatting tools.

License

This fork is also licensed under the original MIT License. Check LICENSE for details.

About

MARS MIPS Assembler and Runtime Simulator

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages