---
name: "simulavr"
section: "1"
platform: "linux"
package: "simulavr"
version: "0.1.2.2-7+b2"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/simulavr"
---

# simulavr(1)

Atmel AVR simulator

## NAME

simulavr - Atmel AVR simulator

## SYNOPSIS

**simulavr** \[*OPTIONS*\]... -d DEVICE \[*IMAGE*\]

## DESCRIPTION

Simulate an avr device. The optional IMAGE file is loaded into the flash program memory space of the device.

### Options

- **-h**, **--help**

  Show this message

- **-D**, **--debug**

  Debug instruction output

- **-v**, **--version**

  Print out the version number and exit

- **-g**, **--gdbserver**

  Run as a gdbserver process

- **-G**, **--gdb-debug**

  Print out debug messages for gdbserver

- **-p**, **--port** \<port\>

  Listen for gdb connection on TCP port

- **-d**, **--device** \<dev\>

  Specify device type

- **-e**, **--eeprom-image** \<img\>

  Specify an eeprom image file

- **-E**, **--eeprom-type** \<type\>

  Specify the type of the eeprom image file

- **-F**, **--flash-type** \<type\>

  Specify the type of the flash image file

- **-L**, **--list-devices**

  Print supported devices to stdout and exit

- **-P**, **--disp-prog** \<prog\>

  Display register and memory info with prog

- **-X**, **--without-xterm**

  Don't start disp prog in an xterm

- **-C**, **--core-dump**

  Dump a core memory image to file on exit

- **-c**, **--clock-freq** \<freq\>

  Set the simulated mcu clock freqency (in Hz)

- **-B**, **--breakpoint** \<addr\>

  Set a breakpoint (address is a byte address)

If the image file types for eeprom or flash images are not given, the default file type is binary.

If you wish to run the simulator in gdbserver mode, you do not have to specify a flash-image file since the program can be loaded from gdb via the \`load\` command.

If '--port' option is given, and '--gdbserver' is not, port is ignored

If running in gdbserver mode and port is not specified, a default port of 1212 is used.

If using the '--breakpoint' option, note the simulator will terminate when the address is hit if you are not running in gdbserver mode. This feature not intended for use in gdbserver mode. It is really intended for testing the simulator itself, but may be useful for testing avr programs too.

### Currently available device types:

Use the '--list-devices' option to obtain the list your version of simulavr supports.

-

   at90s1200\
    at90s2313\
    at90s4414\
    at90s8515\
    atmega8\
    atmega16\
    atmega103\
    atmega128\
    at43usb351\
    at43usb353\
    at43usb355\
    at43usb320\
    at43usb324\
    at43usb325\
    at43usb326

## AUTHOR

Written by Theodore A. Roth.

## REPORTING BUGS

Report bugs to \<simulavr-devel@nongnu.org\>

## COPYRIGHT

Copyright 2001, 2002, 2003  Theodore A. Roth.

simulavr is free software, covered by the GNU General Public License, and you are welcome to change it and/or distribute copies of it under the conditions of the GNU General Public License.

## SEE ALSO

http://savannah.nongnu.org/projects/simulavr/