How openxiangshan/gem5 works
XS-GEM5 is a gem5-based full-system RISC-V simulator calibrated to XiangShan RTL. The principal workflow is to configure a system and workload, run the simulator, and inspect execution results and statistics; checkpoint restore and online Difftest extend that workflow. The README documents major CPU, cache, translation, and checkpoint capabilities, but most XiangShan implementation files were not included in the excerpts. Dashed, uncited edges indicate relationships that are plausible but not verified by the supplied source.
Main entry points: cpu Distributed backend · main.cc Simulation runtime · xiangshan.py System configuration · mem Cache hierarchy
Components 16
Run configuration
- FS workload
- System configuration
configs/common/xiangshan.py - Kunminghu profiles
configs/example/kmhv3.py
XiangShan CPU
- Decoupled frontend
src/cpu - Branch predictors
src/cpu - Distributed backend
src/cpu - Vector execution
src/cpu
Memory system
- Cache hierarchy
src/mem - Prefetchers
src/mem - TLB and PTW
src/arch/riscv
Simulation runtime
- Simulation runtime
src/sim/main.cc - RVGCpt checkpoints
src/sim
Results and validation
- Online Difftest
src/cpu - Topdown counters
src/base/stats/storage.cc - Simulation results
Other components
- Simulator user
Connections 17
- Simulator user → System configuration: configures
README.md - Simulator user → FS workload: provides
README.md - Kunminghu profiles → System configuration: profiles
- System configuration → Simulation runtime: configures
- FS workload → Simulation runtime: runs image
README.md - Simulation runtime → Decoupled frontend: simulates
- Decoupled frontend → Branch predictors: uses
- Decoupled frontend → Distributed backend: dispatches
- Distributed backend → Vector execution: executes vectors
- Distributed backend → Cache hierarchy: accesses
- Cache hierarchy → Prefetchers: coordinates
- Distributed backend → TLB and PTW: translates
- Simulation runtime → RVGCpt checkpoints: restores
- Distributed backend → Online Difftest: checks execution
- Simulation runtime → Topdown counters: records
- Topdown counters → Simulation results: reports
- Online Difftest → Simulation results: validates