zayadnimrod / mymars Goto Github PK

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

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

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

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

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

• 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

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