Command-line Interface

April 3, 2022 ยท View on GitHub

Ripes v.2.2.5 adds support for a command line interface. Through this, programs can be assembled/compiled and simulated on any of the available processor models.

An example execution could be:

./Ripes 
  --mode cli            \ # Enable command line interface
  --src foo.s           \ # Input file
  -t asm                \ # Input file type
  --proc "RV32_5S"      \ # Processor model
  --isaexts M,C         \ # ISA extensions to enable in the assembler/processor  
  --ipc                 \ # show IPC
  --cycles              \ # show # of cycles executed
  --pipeline              # Show pipeline state during execution

Options

See ./Ripes --help for further information.

FlagDescription
--mode Ripes mode Options: (gui, cli)
--src Source file
-t Source type. Options: (c, asm, bin)
--proc Processor model (see ./Ripes --help for options).
--isaexts ISA extensions to enable (comma separated).
--timeout Simulation timeout in milliseconds. If simulation does not finish within the specified time, it will be aborted.
-vVerbose output and runtime status information.
--output Report output file. If not set, report is printed to stdout.
--jsonJSON-formatted report.
--allEnable all report options.
--cyclesReport cycles
--iretReport instructions retired
--cpiReport cycles per instruction (CPI)
--ipcReport instructions per cycle (IPC)
--pipelineReport pipeline state
--regsReport register values
--runinfoReport simulation information in output (processor configuration, input file, ...)
--reginit <[rid:v]>Comma-separated list of register initialization values. The register value may be specified in signed, hex, or boolean notation. Format: <register idx>=<value>,<register idx>=<value>