embeddedartistry / athena-bootloader

An AVR Arduino bootloader that supports uploads over Ethernet (via TFTP) and Serial.
GNU Lesser General Public License v2.1
12 stars 5 forks source link

README improvements: Notes from old documentation #10

Open phillipjohnston opened 4 years ago

phillipjohnston commented 4 years ago

This behavior is real: document it

Development notes for contributing guide:

Converting "sketches" to the right format (ELF SPECIFIC INSTRUCTIONS)

The bootloader accepts raw binary images, starting at address 0x0000. These can be generated using avr-objcopy, part of WinAVR / AVR-GCC, using the "-O binary" option. Example: avr-objcopy -j .text -j .data -O binary [app].elf [app].bin

Flash codes:

The bootloader waits for 5 seconds to be flashed. If the board is programmed after the 5 seconds the bootloader will timeout and start the user application. Otherwise it will restart the 5 second timeout.

Debugging:

By default the debug interface is disabled. To enable it uncomment the "_DEBUG" defines in debug.h for the subsystem you want. For any of them to work the plain "_DEBUG" should be enabled. After flashing the bootloader, helpful messages will be outputted to the serial port of the Arduino board at 115200 bps speed. If debugging is enabled the binary image validations are disabled because the the test applications do not conform with the validation statements.