2.1 Atprogram Application Usage

For atprogram application usage, refer to the following description:

Usage: atprogram [options] <command> [arguments] [<command> [arguments] ...]

Options:

  • -t --tool <arg>: Tool name: Atmel-ICE, AVR Dragon, AVR ISP mkII, AVR ONE, JTAG ICE3, JTAG ICE mkII, QT600, STK500, STK600, SAM-ICE™, EDBG, MEDBG, Power Debugger, Mega DFU or FLIP.
  • -s --serialnumber <arg>: The programmer/debugger serial number. Must be specified when more than one debugger is connected.
  • -i --interface <arg>: Physical interface: aWire, DebugWIRE, HVPP, HVSP, ISP, JTAG, PDI, UPDI, TPI, or SWD.
  • -d --device <arg>: Device name. E.g. ATxmega128A1 or AT32UC3A0256.
  • -l --logfile <arg>: Log file for atpbackend output.
  • -f --force: Force command even if the firmware is not up to date.
  • -cl --clock <arg>: The frequency to use for communication with a device (Hz, kHz, MHz, default Hz). E.g. -cl 10 MHz.
  • -mb --max-baudrate <arg>: The maximum baud rate for communication on aWire (bps).
  • -xr --external reset: Apply external reset when starting a session.
  • -tv --target-voltage <arg>: Set the STK600, STK500, or Power debugger target voltage (float value).
  • -a0 --aref0 <arg>: Set the STK600 AREF0 or STK500 AREF generator voltage (float value).
  • -a1 --aref1 <arg>: Set the STK600 Aref1 generator voltage (float value).
  • -cg --clock-generator <arg>: Set the STK600 or STK500 clock generator frequency (Hz, kHz, MHz, default Hz); --timeout <arg>: Set the timeout value in seconds for commands. The default is 180 seconds. Set to 0 for no timeout.
  • -? --help: Display help information.
  • -V --version: Display version information.

Commands:

  • calibrate: Performs the oscillator calibration procedure.
  • chiperase: Full erase of chip.
  • dwdisable: Disable DebugWIRE interface.
  • erase: Erase the specified memory.
  • help: Display help for a specific command.
  • info: Display information about a device.
  • program: Program device with data from <file>.
  • read: Read the contents of the memory on the device.
  • reset: Reset all domains and jump to the reset vector.
  • secure: Set the security bit on UC3 and ARM devices.
  • selftest: Performs the self-test procedure on Atmel-ICE.
  • verify: Verify content of memory based on a file.
  • write: Write to the memory with values entered on the command line.

Arguments or more command specific help:

  • Use atprogram help <command> to get more command usage information.

Example:

  • atprogram -t atmelice -i ISP -d ATmega328PB program -f file.elf

    Program file.elf image to ATmega328PB flash with Atmel-ICE tool, ISP interface.

  • atprogram -t atmelice -i ISP -d ATmega328PB chiperase

    Full erase ATmega328PB chip with Atmel-ICE tool, ISP interface.