How hghit-harshit/kites works
Kites is a RISC-V assembly editor and simulator, with a headless CLI alongside the Qt application. The primary workflow is to edit or provide assembly, assemble it into a program, load that program into a selected processor, then run or debug it while inspecting execution state and profiling results. The documented processor modes and custom cache policies are also represented. Several UI connections and processor internals were not sampled, so those links are omitted or marked unverified rather than asserted as confirmed calls.
Main entry points: processor_manager.cpp Processor Manager · assembler.h Assembler API · main.cpp CLI Entry · language_service Live Diagnostics
Components 21
Assembly Authoring
- Live Diagnostics
src/language_service - Assembler API
src/assembler/assembler.h - Lexer
src/assembler/lexer.cpp - Parser
src/assembler/parser.cpp - Code Generator
src/assembler/code_generator.cpp - Assembled Program
src/common/assembled_program.h
Simulation and Debugging
- Processor Manager
src/processor/processor_manager.cpp - Processor Factory
src/processor/processor_factory.cpp - RISC-V Processors
src/processor/rv5s - Memory Controller
src/processor/memory_controller.cpp - Cache
src/processor/cache/cache.cpp - Profiler
src/profiler/profiler.cpp
User Interfaces
- Assembly Editor
src/ui/editor_tab - Desktop Window
src/ui/mainwindow/mainwindow.cpp - CLI Entry
cli/main.cpp - Command Handler
src/command_handler/command_handler.cpp
Configuration and Extensions
- Pseudo Manager
src/custom_pseudo_manager/custom_pseudo_manager.cpp - Custom Cache Policy
src/processor/cache/custom_policy_engine.cpp - Application Config
src/config/config.h
Lua Runtime
- Lua Interpreter
external/lua-5.5.0/src
Other components
- Engineer
Connections 23
- Engineer → Assembly Editor: edits assembly
- Assembly Editor → Live Diagnostics: requests diagnostics
- Live Diagnostics → Assembler API: checks source
src/language_service/language_service.cpp - Live Diagnostics → Pseudo Manager: uses expansions
src/language_service/language_service.cpp - Assembler API → Lexer: tokenizes with
src/assembler/assembler.h - Assembler API → Parser: parses with
src/assembler/assembler.h - Parser → Code Generator: generates code
- Assembler API → Assembled Program: produces
src/assembler/assembler.h - Engineer → CLI Entry: runs assembly
cli/main.cpp - CLI Entry → Assembler API: assembles file
cli/main.cpp - CLI Entry → Processor Manager: loads and runs
cli/main.cpp - CLI Entry → Command Handler: starts REPL
cli/main.cpp - Command Handler → Assembler API: loads source
src/command_handler/command_handler.cpp - Command Handler → Processor Manager: executes commands
- Desktop Window → Processor Manager: controls simulation
- Processor Manager → Processor Factory: creates processor
src/processor/processor_manager.cpp - Processor Manager → RISC-V Processors: selects variant
src/processor/processor_manager.cpp - Processor Manager → Profiler: forwards clock events
src/processor/processor_manager.cpp - Processor Manager → Assembled Program: loads program
src/processor/processor_manager.cpp - Memory Controller → Cache: uses cache
- Custom Cache Policy → Lua Interpreter: calls interpreter
src/processor/cache/custom_policy_engine.cpp - Application Config → Memory Controller: configures memory
- Engineer → Custom Cache Policy: provides policy script