MARS Assembler

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.

MARS has been jointly developed by Pete Sanderson (programming) and Ken Vollmar (details and paperwork).

Purpose of this repo

This project is a fork of MARS 4.5. Pull requests are very much welcomed.

Documentation (included in the repo)

• Go to the documentation.
• In order to run or compile this project you must have JRE/JDK 10 (or later) installed on your computer.

How to run MARS

• Desktop:

  • Save the jar file on the desktop
  • Run MARS by double-clicking the icon

• Command line:

  • Save the jar file in some folder
  • Rename the jar file to "Mars.jar" for convenience
  • Open a command line shell in that folder
  • Run MARS by executing ./RunMars.sh (If you can't due to permissions, run chmod +x RunMars.sh)

How to compile

• Windows: execute "CreateMarsJar.bat" file to generate an executable.
• GNU/Linux and Mac: execute "CreateMarsJar.sh" to generate a java archive. If you can't due to permissions, run chmod +x CreateMarsJar.sh.

How to release

• Create new folder mkdir myMARS
• Run ./CreateMarsJar.sh
• Copy files cp Mars.jar RunMars.sh
• Create zip zip myMARS.zip myMARS
• Release myMARS.zip with vYYYY-MM-DD as the version tag

License

MIT. Check the LICENSE file. All the credits go to the original developers.