/jupiter

RISC-V Assembler and Runtime Simulator

Primary LanguageJavaScriptGNU General Public License v3.0GPL-3.0

Jupiter

License: GPL v3 Azure Pipelines Coverage Version issues

Jupiter is an open source and education-oriented RISC-V assembler and runtime simulator. It is written in Java and capable of simulate all the instructions of the base integer ISA (I extension) plus the M and F extensions (RV32IMF), including all the pseudo-instructions described in the user-level instruction set manual1. It was developed taking into account that it could be used in various courses such as: Computer Architecture, Compilers and Assembly Programming.

Features

  • User Friendly: Jupiter was designed focused on education and for all the people that are getting to know the RISC-V architecture. It places for priority the user experience. Jupiter has two modes of operation (Command Line Interface and Graphical User Interface) and both of these were developed to be intuitive and easy to use.

  • Modularity: Jupiter can assemble and simulate several files at once, not everything has to be one file of 1,000 lines of code. Simply indicate by a global label what is the main starting point of the program. This permits modularity and enables the creation of projects and laboratories more easily.

  • Feedback: People using Jupiter gets feedback on what they are doing wrong 💯. The simulator shows different types of errors like: syntax errors, when trying to access reserved memory or when trying to write to a read-only memory.

  • Cross-platform: Jupiter is available for Linux (Ubuntu), macOS and Windows.

Documentation

Please visit the following link for more info and documentation.

Screenshots

Jupiter GUI mode GUI Mode

Jupiter CLI mode CLI Mode

Installation

Download the app image for your operating system and unzip the file:

Running Jupiter on Linux or macOS

./image/bin/jupiter # for GUI mode
./image/bin/jupiter [options] <files> # for CLI mode

Running Jupiter on Windows

image\bin\jupiter # for GUI mode
image\bin\jupiter [options] <files> # for CLI mode

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Other great simulators

  • Venus: Berkeley's Web-based simulator originally developed by @kvakil and then updated and improved by @ThaumicMekanism.

  • RARS: RISC-V Assembler and Runtime Simulator (RARS), based on the originally MARS simulator, but refactored for the RISC-V architecture by @TheThirdOne.

  • Ripes: A graphical 5-stage RISC-V pipeline simulator & assembly editor developed by @mortbopet.

  • Spike: The original RISC-V ISA simulator that implements a functional model of one or more RISC-V harts.

Acknowledgments

A big thank you to all the people working on the RISC-V project.

References

  1. https://github.com/riscv/riscv-isa-manual
  2. http://courses.missouristate.edu/KenVollmar/mars/index.htm
  3. https://github.com/kvakil/venus
  4. https://en.wikipedia.org/wiki/Jupiter
  5. https://en.wikipedia.org/wiki/DLX