qtrvsim_cli1
Risc-v cpu simulator for education
Usage
qtrvsim_cli [options]
FILE
Overview
QtRvSim CLI machine simulator
Options
-
-h, --help -
Displays help on commandline options.
-
--help-all -
Displays help including Qt specific options.
-
-v, --version -
Displays version information.
-
--asm -
Treat provided file argument as assembler source.
-
--pipelined -
Configure CPU to use five stage pipeline.
-
--no-delay-slot -
Disable jump delay slot.
-
--hazard-unit <HUKIND> -
Specify hazard unit implementation [none|stall|forward].
-
--trace-fetch, --tr-fetch -
Trace fetched instruction (for both pipelined and not core).
-
--trace-decode, --tr-decode -
Trace instruction in decode stage. (only for pipelined core)
-
--trace-execute, --tr-execute -
Trace instruction in execute stage. (only for pipelined core)
-
--trace-memory, --tr-memory -
Trace instruction in memory stage. (only for pipelined core)
-
--trace-writeback, --tr-writeback -
Trace instruction in write back stage. (only for pipelined core)
-
--trace-pc, --tr-pc -
Print program counter register changes.
-
--trace-wrmem, --tr-wr -
Trace writes into memory.
-
--trace-rdmem, --tr-rd -
Trace reads from memory.
-
--trace-gp, --tr-gp <REG> -
Print general purpose register changes. You can use * for all registers.
-
--dump-to-json <FNAME> -
Configure reportor dump to json file.
-
--dump-registers, --d-regs -
Dump registers state at program exit.
-
--dump-cache-stats -
Dump cache statistics at program exit.
-
--dump-cycles -
Dump number of CPU cycles till program end.
-
--dump-range <START,LENGTH,FNAME> -
Dump memory range.
-
--load-range <START,FNAME> -
Load memory range.
-
--expect-fail -
Expect that program causes CPU trap and fail if it doesn't.
-
--fail-match <TRAP> -
Program should exit with exactly this CPU TRAP. Possible values are I(unsupported Instruction), A(Unsupported ALU operation), O(Overflow/underflow) and J(Unaligned Jump). You can freely combine them. Using this implies expect-fail option.
-
--d-cache <DCACHE> -
Data cache. Format policy,sets,words_in_blocks,associativity where policy is random/lru/lfu
-
--i-cache <ICACHE> -
Instruction cache. Format policy,sets,words_in_blocks,associativity where policy is random/lru/lfu
-
--l2-cache <L2CACHE> -
L2 cache. Format policy,sets,words_in_blocks,associativity where policy is random/lru/lfu
-
--read-time <RTIME> -
Memory read access time (cycles).
-
--write-time <WTIME> -
Memory read access time (cycles).
-
--burst-time <BTIME> -
Memory read access time (cycles).
-
--serial-in, --serin <FNAME> -
File connected to the serial port input.
-
--serial-out, --serout <FNAME> -
File connected to the serial port output.
-
--os-emulation, --osemu -
Operating system emulation.
-
--std-out, --stdout <FNAME> -
File connected to the syscall standard output.
-
--os-fs-root, --osfsroot <DIR> -
Emulated system root/prefix for opened files
-
--isa-variant, --isavariant <STR> -
Instruction set to emulate (default RV32IMA)
-
--cycle-limit <NUMBER> -
Limit execution to specified maximum clock cycles
Arguments:
- FILE
-
Input ELF executable file or assembler source