gitwtfhub

wtf is risc-v-simulator?

qedady/risc-v-simulator — explained in plain English

Analysis updated 2026-07-17 · repo last pushed 2022-09-28

★ 1C++Audience · researcherComplexity · 3/5DormantSetup · moderate

TL;DR

An educational RISC-V assembly simulator that steps through code one instruction at a time, showing register and memory changes as they happen.

Mindmap

mindmap
  root((repo))
    What it does
      Simulates RISC-V
      Steps instruction by instruction
      Shows register state
    Tech stack
      C++
      RISC-V assembly
    Use cases
      Learn computer organization
      Debug assembly code
      Verify C to assembly translation
    Audience
      Students
      Researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Step through RISC-V assembly instructions to see register and memory changes.

REASON 2

Debug hand-written or compiler-generated assembly code.

REASON 3

Verify that C code translated to assembly behaves correctly.

REASON 4

Learn computer organization concepts by watching execution in slow motion.

What's in the stack?

C++RISC-V

How it stacks up

qedady/risc-v-simulatorallentdan/shape_based_matchingbenagastov/bindweb-nim-wasm-compiler
Stars111
LanguageC++C++C++
Last pushed2022-09-282019-03-01—
MaintenanceDormantDormant—
Setup difficultymoderatemoderateeasy
Complexity3/53/55/5
Audienceresearcherdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 1h+

Course project from Spring 2022, built for learning, not production use.

Yoink these prompts

Prompt 1
Explain how this RISC-V simulator shows register and memory changes after each instruction.
Prompt 2
Show me how to write a test assembly file and initial memory values for this simulator.
Prompt 3
Help me use this tool to debug a piece of RISC-V assembly I wrote.
Prompt 4
What special instructions does this simulator use to stop execution, and why?
Prompt 5
Walk me through the project report to understand the simulator's design decisions.

Frequently asked questions

wtf is risc-v-simulator?

An educational RISC-V assembly simulator that steps through code one instruction at a time, showing register and memory changes as they happen.

What language is risc-v-simulator written in?

Mainly C++. The stack also includes C++, RISC-V.

Is risc-v-simulator actively maintained?

Dormant — no commits in 2+ years (last push 2022-09-28).

How hard is risc-v-simulator to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is risc-v-simulator for?

Mainly researcher.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.

Other repos in this lane