Ripes

Ripes is a visual computer architecture simulator and assembly code editor built for the RISC-V instruction set architecture.

For questions, comments, feature requests, or new ideas, don't hesitate to share these at the discussions page.
For bugs or issues, please report these at the issues page.

Usage

Ripes may be used to explore concepts such as:

• How machine code is executed on a variety of microarchitectures
• How different cache designs influence performance
• How assembly code is assembled to executable machine code

If this is your first time using Ripes, please refer to the introduction.
For further information, please refer to the Ripes wiki.

Downloading & Installation

Prebuilt binaries are available for Linux, Windows & Mac through the Releases page.

Linux

Releases for Linux are distributed in the AppImage format. To run an AppImage:

• Run chmod a+x on the AppImage file
• Run the file! The AppImage for Linux should be compatible with most Linux distributions.

Windows

For Windows, the C++ runtime library must be available (if not, a msvcp140.dll error will be produced). You most likely already have this installed, but if this is not the case, you download it here.

Building

Initially, the following dependencies must be made available:

• A recent (5.10+) version of Qt + Qt Charts (not bundled with Qt by default, but can be selected during Qt installation)
• CMake

Then, Ripes can be checked out and built as a standard CMake project:

git clone --recursive https://github.com/mortbopet/Ripes.git
cd Ripes/
cmake .
Unix:               Windows:
make                jom.exe / nmake.exe / ...

Note, that you must have Qt available in your CMAKE_PREFIX_PATH. For further information on building Qt projects with CMake, refer to Qt: Build with CMake.

In papers and reports, please refer to Ripes as follows: 'Morten Borup Petersen. Ripes. https://github.com/mortbopet/Ripes', e.g. using the following BibTeX code:

@MISC{Ripes,
	author = {Morten Borup Petersen},
	title = {Ripes},
	howpublished = "\url{https://github.com/mortbopet/Ripes}"
}

Icons kindly provided by Flaticon authors: Smashicons, Freepik, Vectors Market & Pixel Buddha.