AVR Bootloader and Programmer

Note 15 February 2014: This project is workable but I'm no longer developing very much for AVR. The best alternative option is the Open Programmer Project by A. Maccione (see below) which covers both PIC and AVR extensively, although development has slowed not progressed since April 2014.

Note 14 February 2016: Some additional AVR work for the XBee project has prompted upgrading the project to QT5.

For the AVR microcontrollers, control of program loading to the FLASH memory, and manipulating of the fuse and lock bits for configuring certain features of the microcontroller, can be simply done through a PC parallel port programmer (see the CDK4AVR tools howto and references). Many of the AVRs provide a small section of FLASH memory with capabilities that allow it to modify its own FLASH memory. This is sometimes referred to as the bootblock. It normally resides in the top of FLASH memory and can be set, through fuse bits, to different sizes, typically 256 bytes to 4K bytes. The microcontroller can also be configured through a fuse bit so that after a reset, a jump directly to the bootloader section can be forced, rather than the usual jump to address 0.

For microcontrollers that have a UART, programming can be done through a PC serial port using the bootloader. This makes programming even simpler, particularly for PCs and laptops that do not have a parallel port. For those without a serial port, a commercially available USB to serial adaptor can be used. Beware: there are some very low cost adaptors that just don't work.

Some tools developed for AVR programming are presented here. Similar tools are available in both open source and commercial versions, including bootloaders, PC programming control applications and hardware programmers. The tools described here were constructed to add some specific features.

Code and PCB files for this project can be found on GitHub.

AVR Bootloader

Atmel's application note AVR109 describes a bootloader for microcontrollers that have a separate bootloader section, that uses the UART to communicate FLASH programming instructions. Atmel also provides some sample code in C that allows the programming of FLASH, EEPROM, and lock bits. Note that the AVR109 bootloader does not support the programming of fuses, which for safety cannot be changed by the self programming features of the AVR. The communication protocol used is compatible with the AVRPROG programming software. After loading this into the bootloader section, the device can be configured so that on reset the program counter starts at the bootloader, and programmer software can program the FLASH memory.

The ATMEL example bootloader program proposes the use of a port pin on the microcontroller to signal whether to execute the bootloader program or to jump directly to the application. This allows a user to set a jumper on the microcontroller card that pulls the pin low when programming of the FLASH is needed.

The adaptation of this code described here keeps it almost unchanged in the interests of compatibility. By disabling the port pin test and excluding the EEPROM programming section and the AVRPROG compatibility section, the code will fit neatly into a 1K block of the bootloader FLASH section on ATMega48/ATMega88/ATMega168 AVRs [1]. Disabling the port pin test means that on reset the microcontroller always ends up in the bootloader program (if the appropriate fuse bit has been set), and must be explicitly sent out again with a bootloader exit command. For the moment this is acceptable as the device will normally operate while connected to a PC serial port. For standalone operation a pin will need to be made available to implement the port pin test, or the appropriate fuse bit programmed to start the device on reset at location 0. In the latter case the application firmware will need to manage a jump to the bootloader when firmware update is required.

Although the AVR109 code is freely available, Atmel has not released it under a clear open source licence. As such the modified code will not be provided here. Writing another bootloader is probably not worthwhile as it turns out to be difficult to produce more compact C code than that provided in Atmel's sample. There are assembler versions of the bootloader available (e.g. that by Herbert Dingfelder) that take up less space, however assembler code is less readable and potentially less portable than a higher level lenguage. The changes made to the code AVR109 are quite simple, most being corrections to perceived minor deficiencies:

  1. Modify the block read and block write functions to add a compiler directive REMOVE_FLASH_BYTE_SUPPORT around the FLASH programming section (be careful of if-else clauses).

  2. Modify the block read and block write functions to add a compiler directive REMOVE_EEPROM_BYTE_SUPPORT around the EEPROM programming section (be extra careful of if-else clauses).

  3. Move the 'E' command outside of REMOVE_AVRPROG_SUPPORT so that we can get out of the bootloader into the application.

  4. Add a compiler directive REMOVE_PROGPIN_TEST around the the port pin check section. This must also be added at the end of the "for" loop where the jump to the application is made.

  5. The preprocessor.sh script can be modified to generate an all-encompassing defines.h file covering all microcontroller types, rather than using the suggested cut and paste system. This makes use of the availability of the MMCU variable in avr-gcc to identify the microcontroller type.

To allow the application to execute a jump into the bootloader I used an instruction to enable the Watchdog Timer on a very short timeout to force the MCU to be reset, the fuses being set to send it to the bootloader section. There seemed to be a problem either with the (old) compiler or the AVR that a long jump was not possible. This has the advantage that it does not require the exact address of the bootloader to be set in the code, but of course prevents the Watchdog Timer from being used for other purposes. I then added a call to wdt_disable() (from the wdt library in avr-lib) to disable the Watchdog Timer at the start of the bootloader.

This may depend on the optimization used by the compiler. For some time the CDK4AVR toolset produced more compact code than avr-gcc. This may have now changed. Advanced C coding and optimization techniques may also reduce the code size.

Programmer GUI Application

To support the above bootloader a GUI programmer for Linux was written in QT4/5 and C++ (see the documentation) . This provides basic hex file load and verify, download, and some fuse/lock bit programming for selected devices (do not fiddle with these settings until you have carefully read and understood the datasheets). The programmer opens a serial port (which may need to be changed to match the target system) and synchronizes with the device using no parity, 1 stop bit and 8 bit data. A character 0xDD is sent and the character received back from the device is checked for either a 0xDD or a "?" character [2]. The latter indicates that the bootloader may have been found. If the bootloader is not present the device will probably just reset itself. If neither character is received, the baud rate is cyclically changed through a set of standard rates for a couple of cycles.

When the program has synchronized with the device, it gathers a swag of information and presents the above window. Note that unlike avrdude it assumes that a valid and working AVR device is connected. An Intel hex file can be opened and will be immediately read and uploaded to the application area of the device FLASH.

The default baud rate to start with is 38400 baud. If this does not match that of the device, then the program will cycle through standard baud rates between 1200 and 115200 baud until it finds the correct one. This process can be sped up by changing the default baud rate to match that of the bootloader.

The program allows for turning off block mode, and also allows verification without programming and vice-versa. Autoaddress currently does nothing so it is disabled. There is a chip erase feature provided: normally the E button is invisible until the checkbox has been selected to minimize accidental erasures. An erase may be necessary if the lock bits have been set incorrectly. This requires an external programmer. A bootloader will not reset the lock bits.

The GUI program relies on inserting delays into the serial communications to adapt the speed of the PC to the bootloader or serial programmer. Also when waiting for a response from the programmer, the program will timeout if this takes too long. If problems are experienced while programming or verifying, it may be that these delays need to be increased. This is particularly the case if the clock speed used with the MCU is low. The GUI program was tested with 8MHz MCU clock frequencies and 38400 baud communications.

Additional sections have been added to enable fuse and lock bits to be read and changed for a limited number of devices. The program uses the device signature bytes to identify the device uniquely, and the appropriate window is invoked. This has only been partly tested so use it at your own risk.

The program also supports a limited command line feature to allow a much faster non-GUI usage during intensive AVR development and testing work. The command line options are:


no GUI


initial baudrate (baud) default 19200


port default /dev/ttyUSB0


write hex file to device




debug mode


pass through serial comms on exit


read to a hex file


start address for read (hexadecimal) default 0x0000


end address for read (hexadecimal) default 0xFFFF

Thus the command:

$ avrserialprog -n -b 19200 -P /dev/ttyUSB0 -w ../test/test.hex -v -d -x

will use the non-GUI mode, an initial baudrate of 19200 baud (only the standard rates from 2400 to 115200 are supported), the given serial port (the one shown uses a USB to serial adapter), to write the file shown with verification, to give pages of useless debug information, and to pass through serial communications at the end (so that the PC can communicate without removing the programmer). The -x parameter is only useful if the programmer described below is attached. In the GUI mode, the command line baud rate and port parameters can be used to set those values in the program, but the other parameters will be ignored.

The command:

$ avrserialprog -b 19200 -P /dev/ttyS0

will invoke the GUI using a serial port starting at 19200 baud.

The 0xDD character is an optional feature relating to the packet protocol used in the Acquisition project. If this is received, then a packet is sent to instruct the device to jump to the bootloader. This can be removed if the packet protocol is not needed, but it is not really necessary as the bootloader will just reject anything unknown.


To install the programmer GUI, unpack into a directory (which by default will be serial-programmer-pc). The default serial device used (/dev/ttyUSB0 in Linux) is specified in the main program and refers to a USB port for use with a USB to serial converter. Make sure that QT5, qt4-designer, qmake-qt5 are installed and also under Ubuntu install libqt5serialport5-dev and libudev-dev. Now go into the serial-programmer-pc directory and execute:

$ make clean
$ qmake
$ make

This will build the application. Copy the binary to a suitable place such as /bin or /usr/bin and test with:

$ avrserialprog

Note that it should not require root privileges if the user has been added to the dialout group. If it fails to run and gives an error message, check that the serial link is working.

Also note that all the QT5 libraries will still be needed during compilation even if the program is never used in GUI mode. For a programmer with no GUI at all, try avrdude or uisp.

AVR Programmer Hardware

An AT90S2313 (obsolete by now but pin replaceable by the ATTiny2313 and ATTiny4313) was used to build a small serial programmer (described here). This was designed to communicate serially with a PC programming application using the AVRPROG protocol as used in the bootloader, and to program the target AVR device using the SPI interface.

A feature of the circuit is that when programming of a target device has completed, an output port pin can be configured to switch the serial communications from the "PC to programmer" over to "PC to target". This allows the programmer to remain connected after programming while the target device program runs normally. To restore to programming mode the programmer must be physically reset. This approach reduces a lot of fiddling with plugs during application development. There are two SPI connectors in the circuit, a 10 pin header compatible with the ET-AVR series of boards sold through Futurlec, and a 6-pin polarised header. The program supports target programming of FLASH, EEPROM, lock and fuse bits. The programmer source code is provided for the ATTiny2313, and ATTiny4313. Note that avr-gcc 4.3.5 or later is needed for support of the ATTiny4313. The  ATTiny2313 version includes the .hex file compiled with a very old version of avr-gcc (cdk4avr of February 2006) as more recent version of avr-gcc produce code just slightly too big for the 1K Flash space. It is also limited in the devices it can program. It could be modified to compile for the AT90S2313 by changing the MCU in the Makefile and at the top of the source file. Also provided is a gEDA schematic of the circuit shown below.

The devices supported at this time are: "ATTiny26", "ATTiny2313", "ATTiny261", "ATMega48", "ATTiny461", "ATMega8535", "ATMega88", "ATTiny861", "ATMega16", "ATMega168", "ATMega32". The ATTiny4313 version adds "ATTiny24", "ATTiny44", "ATTiny84", "ATTiny4313".

Other Open Source AVR Programmers

The OpenProgrammer project originated and supported by Alberto Maccione for the Microchip PIC series also supports programming of AVR devices. The hardware is not oriented to ISP but uses ZIF sockets to program the devices. It can be modified easily enough to support ISP.

A number of different programmers have been made available over time both commercially and in open hardware. The old programming application avrdude supports a majority of these programmers (except mine).


1/11/2010 Added a checkbox to the GUI to allow the program to pass through the serial communications to the target device.

13/11/2010 Updated the AVR code to add more devices and to compile for the ATTiny2313. The MCU needs to be changed in the Makefile and also at the top of the .c file. The code now incorporates the serial link functions and is self contained.

13/11/2010 The old AT90S2313 has been added but so far does not program correctly. It doesn't support FLASH page programming and would require additional code in the AVR for special handling. As code memory is too limited it has been omitted from the AVR code (although it remains in the GUI). The larger device ATTiny4313 would be needed to support the additional code.

14/11/2010 The AVR code now enables the SPI output ports only when programming mode is entered, and reverts them to inputs as soon as programming mode quits. This enables the sharing of the SPI ports for small devices when using in-circuit programming.

13/10/2011  Some refactoring to move GUI specific code away from programmer operations code. Addition of features to provide command line operation.

05/01/2012 Change over to ATTiny4313 and update code.

19/07/2014 Move over to GitHub and test compilation on recent issues of libraries and tools.

14/02/2016 Change over to QT5 and use QSerialPort rather than qextserialport to simplify installation.

Contact: My email address can be constructed from the username "ksarkies" and the ISP DNS address internode.on.net in the usual way.

First created 13 May 2007

Last Modified 14 February 2016