Repository files navigation

RARS, the RISC-V Assembler, Simulator, and Runtime, will assemble and simulatethe execution of RISC-V assembly language programs. Its primary goal is to bean effective development environment for people getting started with RISC-V.

• RISC-V IMFDN Base (riscv32 and riscv64)
• Several system calls that match behaviour from MARS or SPIKE.
• Support for debugging using breakpoints and/orebreak
• Side by side comparison from pseudo-instruction to machine code withintermediate steps
• Multifile assembly using either files open or a directory

Documentation for supportedinstructions,system calls,assembler directives and more can be found on thewiki. Documentation included in the download can be accessed via the help menu.

RARS is distributed as an executable jar. You will need at least Java 8 to run it.

The latest stable release can be foundhere, a release with the latest developments can be found on thecontinuous release, and thereleases page contains all previous stable releases with patch notes.

Alternatively, if you wish to make your own jar and/or modify the code, youshould clone the repo withgit clone https://github.com/TheThirdOne/rars --recursive.Running the script./build-jar.sh on a Unix system will buildrars.jar.

RARS was built on MARS 4.5 and owes a lot to the development of MARS; itsimportant to note what are new developments and what come straight from MARS.Besides moving from supporting MIPS to RISC-V and the associated small changes,there are several general changes worth noting.

• Instructions can now be hot-loaded like Tools. If you want to support an additional extension to the RISC-V instruction set. the .class files just need to be added to the right folder
• ScreenMagnifier, MARS Bot, Intro to Tools, Scavenger Hunt, and MARS Xray were removed from the included tools. ScreenMagnifier, MARS Bot, Intro to Tools, and Scavenger Hunt were removed because they provide little benefit. And MARS Xray was removed because it is not set up to work with RISC-V, however if someone ports it, it could be merged in.
• Removed delayed branching
• Removed the print feature
• Added a testing framework to verify compatibility with the RISC-V specification
• Significant internal restructuring and refactoring.