Configuration¶

Upload using Programmer¶

To upload firmware using programmer you need to use program target instead of upload for platformio run --target command. For example, platformio run -t program.

Configuration for the programmers:

• AVR ISP

  [env:myenv]
  platform = atmelavr
  framework = arduino
  upload_protocol = stk500v1
  ; each flag in a new line
  upload_flags =
      -P$UPLOAD_PORT
  
  ; edit this line with valid upload port
  upload_port = SERIAL_PORT_HERE
  

• AVRISP mkII

  [env:myenv]
  platform = atmelavr
  framework = arduino
  upload_protocol = stk500v2
  ; each flag in a new line
  upload_flags =
      -Pusb
  

• USBtinyISP

  [env:myenv]
  platform = atmelavr
  framework = arduino
  upload_protocol = usbtiny
  

• ArduinoISP

  [env:myenv]
  platform = atmelavr
  framework = arduino
  upload_protocol = arduinoisp
  

• USBasp

  [env:myenv]
  platform = atmelavr
  framework = arduino
  upload_protocol = usbasp
  ; each flag in a new line
  upload_flags =
      -Pusb
  

• Parallel Programmer

  [env:myenv]
  platform = atmelavr
  framework = arduino
  upload_protocol = dapa
  ; each flag in a new line
  upload_flags =
      -F
  

• Arduino as ISP

  [env:myenv]
  platform = atmelavr
  framework = arduino
  upload_protocol = stk500v1
  ; each flag in a new line
  upload_flags =
      -P$UPLOAD_PORT
      -b$UPLOAD_SPEED
  
  ; edit these lines
  upload_port = SERIAL_PORT_HERE
  upload_speed = 19200
  

• Bus Pirate as ISP

  [env:myenv]
  platform = atmelavr
  framework = arduino
  upload_protocol = buspirate
  ; each flag in a new line
  upload_flags =
      -P$UPLOAD_PORT
      -b$UPLOAD_SPEED
  
  ; edit these lines
  upload_port = SERIAL_PORT_HERE
  upload_speed = 115200
  

Upload EEPROM data¶

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

Fuses programming¶

PlatformIO has a built-in target named fuses for setting fuse bits. The default fuse bits are predefined in board manifest file in fuses section. For example, fuses section for Arduino Uno board. To set fuse bits you need to use target fuses with platformio 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

Bootloader programming¶

PlatformIO has a built-in target named bootloader for flashing bootloaders. The default bootloader image and corresponding fuse bits are predefined in board manifest file in bootloader section, for example, Arduino Uno. To upload bootloader image you need to use target bootloader with platformio 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