Next: , Previous: Introduction, Up: Top


2 Invoking

The following options are only valid for the command-line version of simulavr:

-d --device <device name>
tell simulavr, what type of device it has to simulate. The following devices are supported: at90s8515, at90s4433, atmega128, atmega48, atmega88, atmega168, atmega328. To find out, which devices are supported with your current installation, use the help option!
-f --file <name>
load ELF-file <name> for simulation in simulated target.
-F --cpufrequency <value>
set the CPU frequence to <Hz>
-g --gdbserver
running as avr-gdb-server
-G
running as avr-gdb-server and write debug info for avr-gdb-connection
-n --nogdbwait
do not wait for avr-gdb connection
-m <nanoseconds>
maximum run time of <nanoseconds>
-p <port>
change <port> for avr-gdb server to port
-R --readfrompipe <offset>,<file>
add a special pipe register to device at IO-offset and opens <file> for reading
-t --trace <file name>
enable trace outputs into <file name>
-T --terminate <label> or <address>
stops simulation if PC runs on <label> or <address>. If this parameter is omitted, simulavr has to be terminated manually. For <label> you can use any label listed in the map-file of the linker - no matter if it is ever reached or not.
-u
run with user interface for external pin handling at port 7777. This does not open any graphics but activates the interface to communicate with the environment simulation.
-v --version
show the software version of simulavr
-V --verbose
output some hints to console
-W --writetopipe <offset>,<file>
add a special pipe register to device at IO-Offset and opens <file> for writing
-s --irqstatistic
Writes IRQ statistic to stdout at the end of simulation.
-o <filename|->
Writes all available VCD trace sources for a device to <filename> or to stdout, if <-> is given.
-c <trace-params>
Enable a trace dump, for valid <trace-params> see below.
-h --help
show commandline help for simulavr and what devices are supported
-a --writetoabort <offset>
add a special register to device at IO-Offset which aborts simulation
-e --writetoexit <offset>
add a special register to device at IO-Offset which exits simulation (if you write to this IO-Offset, then the written value will be given back as exit value of the simulator!)

The commands -R / -W / -a / -e are not AVR-hardware related. Here you can link an address within the address space of the AVR to an input or output pipe. This is a simple way to create a "printf"- debugger, e.g. after leaving the debugging phase and running the AVR-Software in the simulator or to abort/exit a simulation on a specified situation inside of your program. For more details see the example in the directory simple_ex1.