Atmel AVR¶

Upload using Programmer¶

In the case of external programmers, it’s easy to brick a board simply by specifying incorrect upload flags. It’s highly recommended to use the upload_command option that gives the full control over flags used for uploading.

Configuration for the programmers:

• AVRISP

  [env:program_via_AVRISP]
  platform = atmelavr
  framework = arduino
  upload_protocol = custom
  upload_port = SERIAL_PORT_HERE
  upload_speed = 19200
  upload_flags =
      -C
      ; use "tool-avrdude-megaavr" for the atmelmegaavr platform
      ${platformio.packages_dir}/tool-avrdude/avrdude.conf
      -p
      $BOARD_MCU
      -P
      $UPLOAD_PORT
      -b
      $UPLOAD_SPEED
      -c
      stk500v1
  upload_command = avrdude $UPLOAD_FLAGS -U flash:w:$SOURCE:i
  

• AVRISP mkII

  [env:program_via_AVRISP_mkII]
  platform = atmelavr
  framework = arduino
  upload_protocol = custom
  upload_port = usb
  upload_flags =
      -C
      ; use "tool-avrdude-megaavr" for the atmelmegaavr platform
      ${platformio.packages_dir}/tool-avrdude/avrdude.conf
      -p
      $BOARD_MCU
      -P
      $UPLOAD_PORT
      -c
      stk500v2
  upload_command = avrdude $UPLOAD_FLAGS -U flash:w:$SOURCE:i
  

• USBtinyISP

  [env:myenv]
  platform = atmelavr
  framework = arduino
  upload_protocol = usbtiny
  
  [env:program_via_USBtinyISP]
  platform = atmelavr
  framework = arduino
  upload_protocol = custom
  upload_flags =
      -C
      ; use "tool-avrdude-megaavr" for the atmelmegaavr platform
      ${platformio.packages_dir}/tool-avrdude/avrdude.conf
      -p
      $BOARD_MCU
      -c
      usbtiny
  upload_command = avrdude $UPLOAD_FLAGS -U flash:w:$SOURCE:i
  

• DiamexISP

  [env:program_via_DiamexISP]
  platform = atmelavr
  framework = arduino
  upload_protocol = avrispv2
  upload_port = SERIAL_PORT_HERE
  upload_speed = 19200
  upload_flags =
      -C
      ; use "tool-avrdude-megaavr" for the atmelmegaavr platform
      ${platformio.packages_dir}/tool-avrdude/avrdude.conf
      -p
      $BOARD_MCU
      -P
      $UPLOAD_PORT
      -b
      $UPLOAD_SPEED
      -c
      stk500v2
  upload_command = avrdude $UPLOAD_FLAGS -U flash:w:$SOURCE:i
  

• Arduino as ISP

  [env:program_via_ArduinoISP]
  platform = atmelavr
  framework = arduino
  upload_protocol = custom
  upload_port = SERIAL_PORT_HERE
  upload_speed = 19200
  upload_flags =
      -C
      ; use "tool-avrdude-megaavr" for the atmelmegaavr platform
      ${platformio.packages_dir}/tool-avrdude/avrdude.conf
      -p
      $BOARD_MCU
      -P
      $UPLOAD_PORT
      -b
      $UPLOAD_SPEED
      -c
      stk500v1
  upload_command = avrdude $UPLOAD_FLAGS -U flash:w:$SOURCE:i
  

• USBasp

  [env:program_via_USBasp]
  platform = atmelavr
  framework = arduino
  upload_protocol = custom
  upload_port = usb
  upload_flags =
      -C
      ; use "tool-avrdude-megaavr" for the atmelmegaavr platform
      ${platformio.packages_dir}/tool-avrdude/avrdude.conf
      -p
      $BOARD_MCU
      -P
      $UPLOAD_PORT
      -c
      usbasp
  upload_command = avrdude $UPLOAD_FLAGS -U flash:w:$SOURCE:i
  

• Parallel Programmer

  [env:program_via_PP]
  platform = atmelavr
  framework = arduino
  upload_protocol = custom
  upload_flags =
      -C
      ; use "tool-avrdude-megaavr" for the atmelmegaavr platform
      ${platformio.packages_dir}/tool-avrdude/avrdude.conf
      -p
      $BOARD_MCU
      -c
      dapa
      -F
  upload_command = avrdude $UPLOAD_FLAGS -U flash:w:$SOURCE:i
  

• Bus Pirate as ISP

  [env:program_via_BP]
  platform = atmelavr
  framework = arduino
  upload_protocol = custom
  upload_port = SERIAL_PORT_HERE
  upload_speed = 115200
  upload_flags =
      -C
      ; use "tool-avrdude-megaavr" for the atmelmegaavr platform
      ${platformio.packages_dir}/tool-avrdude/avrdude.conf
      -p
      $BOARD_MCU
      -P
      $UPLOAD_PORT
      -b
      $UPLOAD_SPEED
      -c
      buspirate
  upload_command = avrdude $UPLOAD_FLAGS -U flash:w:$SOURCE:i
  

Upload EEPROM data¶

To upload EEPROM data (from EEMEM directive) you need to use uploadeep target instead upload for pio run --target command. For example, pio run -t uploadeep.

Erase chip before programming¶

In some cases erasing chip memory is a mandatory procedure before uploading bootloader or setting fuses. AVRDUDE provides a special flag -e that causes a chip erase to be executed. This will reset the contents of the flash ROM and EEPROM to the value 0xff, and clear all lock bits. The easiest way to use it is to add this flag via the upload_flags option:

[env:uno]
platform = atmelavr
framework = arduino
board = uno
upload_flags =
  -e

Fuses programming¶

PlatformIO has a built-in target called fuses for setting fuse bits. The default fuse bits are predefined in the board manifest file in the fuses section. For example, fuses section for Arduino Uno board. To set fuse bits you need to use target fuses with pio run --target command.

[env:custom_fuses]
platform = atmelavr
framework = arduino
board = uno
upload_protocol = stk500v1
upload_speed = 19200
board_fuses.lfuse = 0xAA
board_fuses.hfuse = 0xBB
board_fuses.efuse = 0xCC
upload_flags =
    -PCOM15
    -b$UPLOAD_SPEED
    -e

[env:custom_fuses]
platform = atmelavr
framework = arduino
board = ATmega32

board_build.f_cpu = 1000000L
board_hardware.uart = uart0
board_hardware.oscillator = internal
board_hardware.bod = 2.7v
board_hardware.eesave = no

upload_protocol = usbasp
upload_flags =
  -Pusb

Import("env")

env.Replace(
    FUSESFLAGS=[
        "-Uhfuse:w:0xAA:m",
        "-Uefuse:w:0xBB:m",
        "-Ulfuse:w:0xCC:m",
        "-Ulock:w:0xDD:m"
    ]
)

Import("env")

env.Append(
    FUSESUPLOADERFLAGS=[
        "-V",
        "-D"
    ]
)

Import("env")

env.Replace(
    FUSESUPLOADERFLAGS=[
        # use "tool-avrdude-megaavr" for the atmelmegaavr platform
        "-C", "$PROJECT_PACKAGES_DIR/tool-avrdude/avrdude.conf",
        "-p", "$BOARD_MCU",
        "-c", "atmelice_isp",
        "-e", "-v"
    ],
    SETFUSESCMD="avrdude $FUSESUPLOADERFLAGS -Ulock:w:0x0F:m",
)

Bootloader programming¶

PlatformIO has a built-in target called bootloader for flashing bootloaders. The default bootloader image and corresponding fuse bits are predefined in the board manifest file in the bootloader section, for example, Arduino Uno. To upload a bootloader image you need to use target bootloader with pio run --target command.

[env:uno]
platform = atmelavr
framework = arduino
board = uno

board_bootloader.file = /path/to/custom/bootloader.hex
board_bootloader.lfuse = 0xFF
board_bootloader.hfuse = 0xDE
board_bootloader.efuse = 0xFD
board_bootloader.lock_bits = 0x0F
board_bootloader.unlock_bits = 0x3F

Import("env")

bootloader_path = "/path/to/custom/bootloader.hex"

env.Replace(
    BOOTFLAGS=[
        "-Uflash:w:%s:i" % bootloader_path,
        "-Ulock:w:0xFF:m"
    ]
)

Import("env")

env.Append(
    BOOTUPLOADERFLAGS=[
        "-e", "-p", "/dev/cu.usbserial-1414302"
    ]
)

Import("env")

env.Replace(
    BOOTUPLOADERFLAGS=[
        # use "tool-avrdude-megaavr" for the atmelmegaavr platform
        "-C", "$PROJECT_PACKAGES_DIR/tool-avrdude/avrdude.conf",
        "-p", "$BOARD_MCU",
        "-c", "atmelice_isp"
    ],
    UPLOADBOOTCMD="avrdude $BOOTUPLOADERFLAGS -Ulock:w:0x0F:m",
)

Tools & Debug Probes¶

Supported debugging tools are listed in “Debug” column. For more detailed information, please scroll table by horizontal. You can switch between debugging Tools & Debug Probes using debug_tool option in “platformio.ini” (Project Configuration File).

Stable¶

; Latest stable version, NOT recommended
; Pin the version as shown below
[env:latest_stable]
platform = atmelavr
board = ...

; Specific version
[env:custom_stable]
platform = atmelavr@x.y.z
board = ...

Upstream¶

[env:upstream_develop]
platform = https://github.com/platformio/platform-atmelavr.git
board = ...

Adafruit¶

Alorium Technology¶

Anarduino¶

Arduboy¶

Arduino¶

Atmel¶

BQ¶

BSFrance¶

BitWizard¶

Controllino¶

Digistump¶

Dwengo¶

Elektor¶

Engduino¶

EnviroDIY¶

FYSETC¶

LightUp¶

Linino¶

LowPowerLab¶

MediaTek Labs¶

Microchip¶

Microduino¶

OpenEnergyMonitor¶

PanStamp¶

Pinoccio¶

Pololu Corporation¶

Prusa 3D¶

Punch Through¶

Quirkbot¶

RedBearLab¶

RepRap¶

SODAQ¶

Sanguino¶

SeeedStudio¶

SparkFun¶

SpellFoundry¶

The Things Network¶

Till Harbaum¶

TinyCircuits¶