Skip to content

Latest commit

 

History

History
77 lines (53 loc) · 2.82 KB

README.md

File metadata and controls

77 lines (53 loc) · 2.82 KB

Logo

Build Status   codecov   CodeFactor

Graphical emulator for the RISC-V architecture, implementing the Tomasulo algorithm and the Simultaneous Multi-Threading.

Here you can find a brief documentation of the project.

Installation

From within the repository directory:

pip install -e .

Execution

Just type:

riscemv

Features

GUI

  • Code Loader and Inspector: dynamically edit and load assembly code either from .s files or from .o ELF object files, disassembled in place.
  • Syntax Errors notice: check for incorrect or unsupported instructions from the code text-box
  • Instruction Queue and Statistics: inspect the current queue of instructions and their timings (issue time, execution steps and write-result time)
  • Register Inspector: view and edit both integer and floating point registers in different formats (binary, decimal, hexadecimal)
  • Register Status Table: inspect Tomasulo's register status table
  • Reservation Stations Table: inspect the status of every Reservation Station's field: "cycles left to complete", "tag", "busy", "current instruction", and operands fields "Vj", "Vk", "Qj", "Qk", "A", and "Result"
  • Memory Dump: live hexadecimal and ASCII dump of the memory

Architecture

  • Tomasulo Algorithm: a dynamic scheduling that allows the execution of multiple instructions using several execution units.
  • Multithreading: Support for simulated multithreading

Instruction Set Support

  • 32 bits:
    • RV32I: base support for 32 bit integer operations
    • RV32M: 32 bit integer multiplication and division
    • RV32F: 32 bit floating point operations

Other

  • Configurable: a configuration window allows to tune many parameters
  • Sample Programs: the sample_programs folder contains different ready to play with programs
  • Extensible: adding support for more instruction sets is a matter of writing a JSON file

Screenshots

Main window

Image #1

Configuration window

Image #2 Image #3

The hello_word sample program loaded

Image #4

Running emulator

Image #5

The execution has ended and the program has written Hello in memory

Image #6

Authors

Alessandro Sartori

Davide Zanella