4.2 Programmer Definitions

The format of the programmer definition is as follows:

programmer
    parent <id>                              # optional parent
    id       = <id1> [, <id2> ... ];         # <idN> are quoted strings
    desc     = <description>;                # quoted string
    type     = <type>;                       # programmer type, quoted string
                                             # list known types with -c ?type
    prog_modes = PM_<i/f> {| PM_<i/f>}       # interfaces, e.g., PM_SPM|PM_PDI (1)
    is_serialadapter = <yes|no>              # programmer is also a serialadapter
    extra_features = HAS_<fea> {| HAS_<fea>}  # extra features, e.g., HAS_SUFFER (2)
    connection_type = parallel | serial | usb | spi
    baudrate = <num>;                        # baudrate for avr910-programmer
    vcc      = <pin1> [, <pin2> ... ];       # pin number(s) (3)
    buff     = <pin1> [, <pin2> ... ];       # pin number(s)
    reset    = <pin>;                        # pin number
    sck      = <pin>;                        # pin number
    sdo|pico = <pin>;                        # pin number
    sdi|poci = <pin>;                        # pin number
    tck      = <pin>;                        # pin number
    tdi      = <pin>;                        # pin number
    tdo      = <pin>;                        # pin number
    tms      = <pin>;                        # pin number
    errled   = <pin>;                        # pin number
    rdyled   = <pin>;                        # pin number
    pgmled   = <pin>;                        # pin number
    vfyled   = <pin>;                        # pin number
    usbvid   = <hexnum>;                     # USB vendor ID
    usbpid   = <hexnum> [, <hexnum> ...];    # USB product ID (4)
    usbdev   = <interface>;                  # USB interface or other device info
    usbvendor = <vendorname>;                # USB Vendor Name
    usbproduct = <productname>;              # USB Product Name
    usbsn    = <serialno>;                   # USB Serial Number
    hvupdi_support = <num> [, <num>, ... ];  # UPDI HV Variants Support
;

If a parent is specified, all settings of it (except its ids) are used for the new programmer. These values can be changed by new setting them for the new programmer.

Notes

1. Known programming modes are
   • PM_SPM: Bootloaders, self-programming with SPM opcodes or NVM Controllers
   • PM_TPI: Tiny Programming Interface (t4, t5, t9, t10, t20, t40, t102, t104)
   • PM_ISP: SPI programming for In-System Programming (almost all classic parts)
   • PM_PDI: Program and Debug Interface (xmega parts)
   • PM_UPDI: Unified Program and Debug Interface
   • PM_HVSP: High Voltage Serial Programming (some classic parts)
   • PM_HVPP: High Voltage Parallel Programming (most non-HVSP classic parts)
   • PM_debugWIRE: Simpler alternative to JTAG (a subset of HVPP/HVSP parts)
   • PM_JTAG: Joint Test Action Group standard (some classic parts)
   • PM_JTAGmkI: Subset of PM_JTAG, older parts, Atmel ICE mkI
   • PM_XMEGAJTAG: JTAG, some XMEGA parts
   • PM_AVR32JTAG: JTAG for 32-bit AVRs
   • PM_aWire: AVR32 parts
2. The following extra programmer features are known
   • HAS_SUFFER: Only present on Xplained Mini/Nano programmers; the Super User Fantastic Feature Enable Register allows the user to modify the behavior of the mEDBG programmer/debugger chip, see the Xplained Mini/Nano documentation for more information
   • HAS_VTARG_SWITCH: Programer has a programmable target power switch
   • HAS_VTARG_READ: Programmer can read the target voltage
   • HAS_VTARG_ADJ: Programmer has an adjustable target power source that can be controlled with Avrdude
   • HAS_FOSC_ADJ: Programmer has a programable frequency generator that can clock an AVR directly through its XTAL1 pin
   • HAS_VAREF_ADJ: Programmer has an adjustable analog reference voltage that can be controlled with Avrdude
3. To invert the polarity of a pin, use a tilde ~<num>; to invert the polarity of all pins in a list use ~(<num1> [, <num2> ... ])
4. Not all programmer types can handle a list of USB PIDs

The following programmer types are currently implemented:

This document was generated by Stefan Rueger on August 24, 2024 using texi2html 1.82.