AtomSim CLI Argument Reference

Following are the arguments that may be passed to the AtomSim executable.

Option

Long Option

Function

Default value

General Options

-h

–help

Show this message

–version

Show version information

–soctarget

Show current AtomSim SoC target

–no-color

Don’t show colored output

–no-banner

Don’t show banner

-i

–input arg

Specify an input file

Debugging Options

-v

–verbose

Turn on verbose output

-d

–debug

Start in debug mode

-t

–trace

Enable VCD tracing

–trace-file arg

Specify trace file

trace.vcd

–dump-file arg

Specify dump file

dump.txt

–ebreak-dump

Enable processor state dump at hault

–signature arg

Enable signature dump at hault (Used for riscv compliance tests)

“”

Sim Config Options

–maxitr arg

Specify maximum simulation iterations

1000000

Backend Config Options (Common)

-u

–enable-uart-dump

Enable dumping UART data (from soc) to stdout

-p

–vuart-port arg

serial port for virtual UART

“”

-b

–vuart-baud arg

serial baud rate for virtual UART

115200

Backend Config Options (AtomBones)

–bootrom-size arg

Specify size of bootrom to simulate (in KB)

8

–bootrom-image arg

Specify bootrom hex image

${RVATOM}/sw/bootloader/bootloader.hex

–ram-size arg

Specify size of RAM memory to simulate (in KB)

81920

Backend Config Options (HydrogenSoC)

–bootmode arg

Specify bootmode signal

1

Note

For most up-to-date information, run atomsim --help command.