Atmel megaAVR¶

Upload using pymcuprog serialUPDI¶

pymcuprog is a Python-based CLI tool for programming AVR devices with UPDI interface using either a Microchip debugger (Atmel-ICE, Power Debugger, PICkit4, Snap, PKOB nano / nEDBG / Curiosity Nano debugger) or via a standard serial port. It can be installed directly in the PlatformIO virtual environment using the following command:

pip install pymcuprog

Once pymcuprog is installed it can be used as the uploader via a custom upload_command option, for example:

[env:ATmega3209_pymcuprog_upload]
platform = atmelmegaavr
framework = arduino
board = ATmega3209
upload_speed = 115200
upload_flags =
    --tool
    uart
    --device
    atmega3209
    --uart
    $UPLOAD_PORT
    --clk
    $UPLOAD_SPEED
upload_command = pymcuprog write --erase $UPLOAD_FLAGS --filename $SOURCE

More information and a typical circuit diagram can be found in the official pymcuprog repository.

pymcuprog is maintained by Microchip, and published on GitHub and pypi.org.

Upload using pyupdi¶

pyupdi is a Python-based tool for programming tinyAVR and megaAVR devices with UPDI interface via a standard serial port. It can be installed directly in the PlatformIO virtual environment using the following command:

pip install https://github.com/mraardvark/pyupdi/archive/master.zip

Once pyupdi is installed it can be used as the uploader via a custom upload_command option, for example:

[env:ATmega3209_pyupdi_upload]
platform = atmelmegaavr
framework = arduino
board = ATmega3209
upload_speed = 115200
upload_flags =
    -d
    mega3209
    -c
    $UPLOAD_PORT
    -b
    $UPLOAD_SPEED
upload_command = pyupdi $UPLOAD_FLAGS -f $SOURCE

More information and a typical circuit diagram can be found in the official pyupdi repository repository.

Custom fuses¶

Custom fuse values and upload flags (based on upload protocol) should be specified in “platformio.ini” (Project Configuration File). An example of setting custom fuses for ATmega3209 board:

[env:custom_fuses]
platform = atmelmegaavr
framework = arduino
board = ATmega3209
upload_protocol = xplainedmini_updi
board_fuses.bootend = 0xAA
board_fuses.syscfg0 = 0xBB
board_fuses.osccfg = 0xCC

Overriding default fuses command¶

For more detailed information read Overriding default fuses command.

Custom bootloader¶

Custom bootloader and accompanying fuses should be specified in “platformio.ini” (Project Configuration File). An example of setting custom bootloader for ATmega4808 board:

[env:ATmega4808]
platform = atmelmegaavr
framework = arduino
board = ATmega4808

board_bootloader.file = /path/to/custom/bootloader.hex
board_bootloader.bootend = 0xFF
board_bootloader.syscfg0 = 0xDE
board_bootloader.osccfg = 0xFD
board_bootloader.lock_bits = 0x0F

Overriding default bootloader command¶

For more detailed information read Overriding default bootloader command.