How gstl-itu/ubee works
This repository is a teaching-oriented RV32IMC emulator, assembler, and debugger; the graph focuses on the emulator subtree present in the supplied file tree. The main workflow is to assemble source or load a program, execute it on the emulated hart, then inspect or control execution through the CLI/TUI or GUI. It also includes ISA encoding/decoding, configurable devices, and a visual pipeline. Relationships are limited to those supported by the README or SOURCE INDEX; unsampled subsystem internals are represented at their source-directory path.
Main entry points: session.cpp Debug session · main.cpp CLI dispatcher · assembler.cpp Assembler · main_window.cpp Desktop GUI
Components 22
Application entry
- CLI dispatcher
Emulator/rv32_emulator-main/src/main.cpp
Assembly tools
- Assembler
Emulator/rv32_emulator-main/src/asm/assembler.cpp - Source parser
Emulator/rv32_emulator-main/src/asm/parser.cpp - Editor completion
Emulator/rv32_emulator-main/src/asm/complete.cpp - Diagnostics
Emulator/rv32_emulator-main/src/asm/diag_render.cpp
RISC-V ISA
- Instruction encoding
Emulator/rv32_emulator-main/src/isa/encode.cpp - Instruction decoding
Emulator/rv32_emulator-main/src/isa/decode.cpp - Disassembler
Emulator/rv32_emulator-main/src/isa/disasm.cpp - ISA definitions
Emulator/rv32_emulator-main/src/isa/isa.hpp
Emulated machine
- Hart execution
Emulator/rv32_emulator-main/src/core/hart.cpp - Memory and bus
Emulator/rv32_emulator-main/src/core/bus.cpp - Memory-mapped devices
Emulator/rv32_emulator-main/src/core/devices.cpp - Machine configuration
Emulator/rv32_emulator-main/src/core/device_config.cpp - Memory images
Emulator/rv32_emulator-main/src/core/memfile.cpp
Debugging interfaces
- Debug session
Emulator/rv32_emulator-main/src/dbg/session.cpp - Reverse history
Emulator/rv32_emulator-main/src/dbg/history.cpp - Breakpoints
Emulator/rv32_emulator-main/src/dbg/breakpoints.cpp - Pipeline model
Emulator/rv32_emulator-main/src/dbg/pipeline.cpp - CLI and TUI
Emulator/rv32_emulator-main/src/cmd/repl.cpp - Desktop GUI
Emulator/rv32_emulator-main/src/gui/main_window.cpp - Pipeline panel
Emulator/rv32_emulator-main/src/gui/pipeline_widget.cpp
Other components
- Learner
Connections 29
- Learner → CLI dispatcher: invokes
Emulator/rv32_emulator-main/src/main.cpp - CLI dispatcher → Assembler: assembles
Emulator/rv32_emulator-main/src/main.cpp - Assembler → Source parser: parses source
Emulator/rv32_emulator-main/src/asm/assembler.cpp - Assembler → Instruction encoding: encodes instructions
Emulator/rv32_emulator-main/src/asm/assembler.cpp - Assembler → Diagnostics: renders diagnostics
Emulator/rv32_emulator-main/src/asm/assembler.cpp - CLI dispatcher → Machine configuration: configures machine
Emulator/rv32_emulator-main/src/main.cpp - CLI dispatcher → Memory images: loads images
Emulator/rv32_emulator-main/src/main.cpp - CLI dispatcher → Hart execution: executes program
Emulator/rv32_emulator-main/src/main.cpp - CLI dispatcher → CLI and TUI: starts debugger
Emulator/rv32_emulator-main/src/main.cpp - CLI dispatcher → Instruction decoding: decodes output
Emulator/rv32_emulator-main/src/main.cpp - Hart execution → Instruction decoding: decodes instructions
- Hart execution → Memory and bus: accesses memory
- Memory and bus → Memory-mapped devices: routes device access
- Machine configuration → Hart execution: configures hart
- Debug session → Assembler: loads assembled code
- Debug session → Hart execution: controls execution
- Debug session → Reverse history: records steps
- Debug session → Breakpoints: checks stops
- Pipeline model → Debug session: steps session
- CLI and TUI → Debug session: controls debugger
- Desktop GUI → Debug session: controls debugger
Emulator/rv32_emulator-main/src/gui/main_window.cpp - Desktop GUI → Assembler: assembles editor source
Emulator/rv32_emulator-main/src/gui/main_window.cpp - Desktop GUI → Machine configuration: sets devices
Emulator/rv32_emulator-main/src/gui/main_window.cpp - Desktop GUI → Memory images: loads images
Emulator/rv32_emulator-main/src/gui/main_window.cpp - Desktop GUI → Disassembler: formats instructions
Emulator/rv32_emulator-main/src/gui/main_window.cpp - Pipeline panel → Pipeline model: renders stages
- Pipeline panel → Debug session: reads debugger state
- Editor completion → ISA definitions: uses ISA metadata
Emulator/rv32_emulator-main/src/asm/complete.cpp - Instruction decoding → ISA definitions: matches definitions
Emulator/rv32_emulator-main/src/isa/decode.cpp