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.