From 032a83e9e1bda3b4724870ad65310414a8020351 Mon Sep 17 00:00:00 2001
From: Dean Camera <dean@fourwalledcubicle.com>
Date: Mon, 23 Feb 2009 07:08:24 +0000
Subject: [PATCH] Moved all source to the trunk directory.
---
.../AVRISP_Firmware_Design.txt | 176 ++
.../AVRISP_Programmer/AVRISP_Programmer.aps | 1 +
.../AVRISP_Programmer/AVRISP_Programmer.c | 886 ++++++++++
.../AVRISP_Programmer/AVRISP_Programmer.h | 194 +++
.../AVRISP_Programmer/AVRISP_Programmer.txt | 89 +
.../AVRISP_Programmer_Picture.jpg | Bin 0 -> 74610 bytes
Projects/AVRISP_Programmer/Descriptors.c | 263 +++
Projects/AVRISP_Programmer/Descriptors.h | 98 ++
Projects/AVRISP_Programmer/Doxygen.conf | 1485 +++++++++++++++++
.../LUFA AVRISP_Programmer.inf | 55 +
Projects/AVRISP_Programmer/RingBuff.c | 120 ++
Projects/AVRISP_Programmer/RingBuff.h | 116 ++
.../Sample_Programming_Session.txt | 104 ++
Projects/AVRISP_Programmer/makefile | 704 ++++++++
Projects/Magstripe/CircularBitBuffer.c | 113 ++
Projects/Magstripe/CircularBitBuffer.h | 95 ++
Projects/Magstripe/Descriptors.c | 247 +++
Projects/Magstripe/Descriptors.h | 98 ++
Projects/Magstripe/Doxygen.conf | 1485 +++++++++++++++++
Projects/Magstripe/Magstripe.aps | 1 +
Projects/Magstripe/Magstripe.c | 436 +++++
Projects/Magstripe/Magstripe.h | 121 ++
Projects/Magstripe/Magstripe.txt | 85 +
Projects/Magstripe/MagstripeHW.h | 100 ++
Projects/Magstripe/makefile | 712 ++++++++
Projects/makefile | 25 +
26 files changed, 7809 insertions(+)
create mode 100644 Projects/AVRISP_Programmer/AVRISP_Firmware_Design.txt
create mode 100644 Projects/AVRISP_Programmer/AVRISP_Programmer.aps
create mode 100644 Projects/AVRISP_Programmer/AVRISP_Programmer.c
create mode 100644 Projects/AVRISP_Programmer/AVRISP_Programmer.h
create mode 100644 Projects/AVRISP_Programmer/AVRISP_Programmer.txt
create mode 100644 Projects/AVRISP_Programmer/AVRISP_Programmer_Picture.jpg
create mode 100644 Projects/AVRISP_Programmer/Descriptors.c
create mode 100644 Projects/AVRISP_Programmer/Descriptors.h
create mode 100644 Projects/AVRISP_Programmer/Doxygen.conf
create mode 100644 Projects/AVRISP_Programmer/LUFA AVRISP_Programmer.inf
create mode 100644 Projects/AVRISP_Programmer/RingBuff.c
create mode 100644 Projects/AVRISP_Programmer/RingBuff.h
create mode 100644 Projects/AVRISP_Programmer/Sample_Programming_Session.txt
create mode 100644 Projects/AVRISP_Programmer/makefile
create mode 100644 Projects/Magstripe/CircularBitBuffer.c
create mode 100644 Projects/Magstripe/CircularBitBuffer.h
create mode 100644 Projects/Magstripe/Descriptors.c
create mode 100644 Projects/Magstripe/Descriptors.h
create mode 100644 Projects/Magstripe/Doxygen.conf
create mode 100644 Projects/Magstripe/Magstripe.aps
create mode 100644 Projects/Magstripe/Magstripe.c
create mode 100644 Projects/Magstripe/Magstripe.h
create mode 100644 Projects/Magstripe/Magstripe.txt
create mode 100644 Projects/Magstripe/MagstripeHW.h
create mode 100644 Projects/Magstripe/makefile
create mode 100644 Projects/makefile
diff --git a/Projects/AVRISP_Programmer/AVRISP_Firmware_Design.txt b/Projects/AVRISP_Programmer/AVRISP_Firmware_Design.txt
new file mode 100644
index 000000000..643454d48
--- /dev/null
+++ b/Projects/AVRISP_Programmer/AVRISP_Firmware_Design.txt
@@ -0,0 +1,176 @@
+Instructions for converting the LUFA USBtoSerial Demo to an AVR ISP Programmer.
+By Opendous Inc., Copyright under the Creative Commons Attribution License:
+http://creativecommons.org/licenses/by/3.0/
+
+1) Start with the LUFA/Demos/USBtoSerial firmware.
+ - rename USBtoSerial.c, USBtoSerial.h, and USBtoSerial.aps to
+ AVRISP_Programmer.*
+ - edit AVRISP_Programmer.aps and rename all instances of "USBtoSerial" to
+ "AVRISP_Programmer"
+ - copy AVRISP_Programmer.txt from an older version of AVRISP_Programmer
+
+2) Edit makefile by changing TARGET from "USBtoSerial" to "AVRISP_Programmer"
+
+3) Edit AVRISP_Programmer.h:
+ - change ifdef _USB_TO_SERIAL_H to _AVRISP_PROGRAMMER_H_
+ - rename ReconfigureUSART(void) to ReconfigureSPI(void)
+ - add void processHostSPIRequest(void); & void delay_ms(uint8_t dly);
+ - replace the define for Serial.h with one for SPI.h:
+ #include <libs/LUFA/Drivers/AT90USBXXX/SPI.h>
+
+4) Make alterations to Descriptors.c
+ - change manufacturer string to "www.AVRopendous.org", length=19
+ - change product string to "LUFA-Based AVR ISP Programmer", length=29
+
+5) Edit Ringbuff.h to enable the Peek Command: #define BUFF_USEPEEK
+
+6) Edit AVRISP_Programmer.c:
+ - change #include "USBtoSerial.h" to #include "AVRISP_Programmer.h"
+ - change BUTTLOADTAG(ProjName to "LUFA AVR910 ISP Programmer"
+ - in main(), rename ReconfigureUSART() to Reconfigure();
+ - in EVENT_HANDLER(USB_UnhandledControlPacket), rename ReconfigureUSART
+ - delete the ISRs: ISR(USART1_RX_vect) & ISR(USART1_TX_vect)
+ - delete ReconfigureUSART(void)
+ - add void ReconfigureSPI(void), void processHostSPIRequest(void),
+ and void delay_ms(uint8_t dly) from a previous version
+ - add Timer1 and SPI initialization code to main():
+ /* Hardware Initialization */
+ //LEDs_Init();
+ DDRB = 0;
+ PORTB = 0;
+ DDRC |= ((1 << PC2) | (1 << PC4) | (1 << PC5) | (1 << PC6) | (1 << PC7)); //AT90USBxx2
+ // PC2 is also used for RESET, so set it HIGH initially - note 'P' command sets it to LOW (Active)
+ PORTC |= ((1 << PC2) | (1 << PC4) | (1 << PC5) | (1 << PC6) | (1 << PC7)); //AT90USBxx2
+ DDRD = 0;
+ PORTD = (1 << PB7); // only PB7(HWB) should be High as this is the bootloader pin
+ // Prepare PortB for SPI - set PB0(^SS), PB1(SCK), PB2(MOSI) as output as well as all other pins except PB3(MISO)
+ DDRB = (1 << PB0) | (1 << PB1) | (1 << PB2) | (0 << PB3) | (1 << PB4) | (1 << PB5) | (1 << PB6) | (1 << PB7);
+ PORTB |= (1 << PB0);
+
+ // initialize Timer1 for use in delay function
+ TCCR1A = 0;
+ //TCCR1B = (1 << CS10); // no prescaling, use CLK
+ TCCR1B = ((1 << CS12) | (1 << CS10)); // prescale by CLK/1024
+ // 8MHz/1024 = 7813 ticks per second --> ~8 ticks per millisecond (ms)
+ timerval = TCNT1; // start timer1
+
+ - In TASK(CDC_Task) in the
+ if (USB_IsConnected) {
+ if (Endpoint_ReadWriteAllowed()) {
+ while (Endpoint_BytesInEndpoint()) {
+ ...
+ structure, after Buffer_StoreElement(&Rx_Buffer, Endpoint_Read_Byte()):
+
+ /* Each time there is an element, check which comand should be
+ run and if enough data is available to run that command.
+ There are 1-byte, 2-byte, 3-byte, 4-byte commands, and 5-byte commands
+ Remember that the "which command" byte counts as 1 */
+ if (Rx_Buffer.Elements == 0) {
+ // do nothing, wait for data
+ } else {
+ tempByte = Buffer_PeekElement(&Rx_Buffer); // peek at first element
+
+ /* make sure the issued command and associated data are all ready */
+ if (Rx_Buffer.Elements == 1) { // zero data byte command
+ if ((tempByte == 'P') | (tempByte == 'a') | (tempByte == 'm') |
+ (tempByte == 'R') | (tempByte == 'd') | (tempByte == 'e') |
+ (tempByte == 'L') | (tempByte == 's') | (tempByte == 't') |
+ (tempByte == 'S') | (tempByte == 'V') | (tempByte == 'v') |
+ (tempByte == 'p') | (tempByte == 'F')) {
+ processHostSPIRequest(); // command has enough data, process it
+ }
+ } else if (Rx_Buffer.Elements == 2) { // one data byte command
+ if ((tempByte == 'T') | (tempByte == 'c') | (tempByte == 'C') |
+ (tempByte == 'D') | (tempByte == 'l') | (tempByte == 'f') |
+ (tempByte == 'x') | (tempByte == 'y')) {
+ processHostSPIRequest(); // command has enough data, process it
+ }
+ } else if (Rx_Buffer.Elements == 3) { // two data byte command
+ if ((tempByte == 'A') | (tempByte == 'Z')) {
+ processHostSPIRequest(); // command has enough data, process it
+ }
+ } else if (Rx_Buffer.Elements == 4) { // three data byte command
+ if ((tempByte == ':')) {
+ processHostSPIRequest(); // command has enough data, process it
+ }
+ } else if (Rx_Buffer.Elements == 5) { // four data byte command
+ if ((tempByte == '.')) {
+ processHostSPIRequest(); // command has enough data, process it
+ }
+ } else {
+ // do nothing
+ }
+ }
+
+ - need to add code to flush the buffer. Change:
+ /* Check if Rx buffer contains data */
+ if (Rx_Buffer.Elements)
+ {
+ /* Initiate the transmission of the buffer contents if USART idle*/
+ if (!(Transmitting))
+ {
+ Transmitting = true;
+ Serial_TxByte(Buffer_GetElement(&Rx_Buffer));
+ }
+ }
+ To:
+ /* Check if Rx buffer contains data */
+ if (Rx_Buffer.Elements)
+ {
+ /* Initiate the transmission of the buffer contents if USART idle*/
+ if (!(Transmitting))
+ {
+ Transmitting = true;
+ /* The following flushes the receive buffer to prepare for new
+ data and commands. Need to flush the buffer as the command
+ byte which is peeked above needs to be dealt with, otherwise
+ the command bytes will overflow the buffer eventually */
+ //Buffer_GetElement(&Rx_Buffer); // also works
+ Buffer_Initialize(&Rx_Buffer);
+ }
+ }
+
+ - need to add the following defines and globals:
+ #define RESETPORT PORTB
+ #define RESETPIN PB0
+ #define RESETPORT2 PORTC
+ #define RESETPIN2 PC2
+ #define CR_HEX '\r'
+
+ #define DELAY_VERYSHORT 0x01
+ #define DELAY_SHORT 0x02
+ #define DELAY_MEDIUM 0x03
+ #define DELAY_LONG 0x05
+ #define DELAY_MULTIPLE 0x04
+
+ /* AVR Device Codes - Can have a maximum of 14 but can be any you want.
+ Note that these are completely irrelevent. If AVRdude supports a
+ device, then that device is programmable. Use -F switch to ignore
+ device codes. */
+ #define AVRDEVCODE01 0x55 /* ATtiny12 */
+ #define AVRDEVCODE02 0x56 /* ATtiny15 */
+ #define AVRDEVCODE03 0x5E /* ATtiny261 */
+ #define AVRDEVCODE04 0x76 /* ATmega8 */
+ #define AVRDEVCODE05 0x74 /* ATmega16 */
+ #define AVRDEVCODE06 0x72 /* ATmega32 */
+ #define AVRDEVCODE07 0x45 /* ATmega64 */
+ #define AVRDEVCODE08 0x74 /* ATmega644 */
+ #define AVRDEVCODE09 0x43 /* ATmega128 */
+ #define AVRDEVCODE10 0x63 /* ATmega162 */
+ #define AVRDEVCODE11 0x78 /* ATmega169 */
+ #define AVRDEVCODE12 0x6C /* AT90S4434 */
+ #define AVRDEVCODE13 0x38 /* AT90S8515A */
+ #define AVRDEVCODE14 0x65 /* AT90S8555 */
+
+ /* some global variables used throughout */
+ uint8_t tempIOreg = 0;
+ uint8_t tempIOreg2 = 0;
+ uint8_t tempIOreg3 = 0;
+ uint8_t tempIOreg4 = 0;
+ uint8_t dataWidth = 0;
+ uint8_t firstRun = 1;
+ uint8_t deviceCode = 0;
+ uint8_t tempByte = 0;
+ uint16_t currAddress = 0;
+ uint16_t timerval = 0;
+
diff --git a/Projects/AVRISP_Programmer/AVRISP_Programmer.aps b/Projects/AVRISP_Programmer/AVRISP_Programmer.aps
new file mode 100644
index 000000000..748002317
--- /dev/null
+++ b/Projects/AVRISP_Programmer/AVRISP_Programmer.aps
@@ -0,0 +1 @@
+<AVRStudio><MANAGEMENT><ProjectName>AVRISP_Programmer</ProjectName><Created>30-Sep-2008 14:18:39</Created><LastEdit>30-Sep-2008 14:18:52</LastEdit><ICON>241</ICON><ProjectType>0</ProjectType><Created>30-Sep-2008 14:18:39</Created><Version>4</Version><Build>4, 14, 0, 589</Build><ProjectTypeName>AVR GCC</ProjectTypeName></MANAGEMENT><CODE_CREATION><ObjectFile></ObjectFile><EntryFile></EntryFile><SaveFolder>C:\Users\Dean\Documents\Electronics\Projects\WORK\MyUSBWORK\Demos\AVRISP_Programmer\</SaveFolder></CODE_CREATION><DEBUG_TARGET><CURRENT_TARGET></CURRENT_TARGET><CURRENT_PART></CURRENT_PART><BREAKPOINTS></BREAKPOINTS><IO_EXPAND><HIDE>false</HIDE></IO_EXPAND><REGISTERNAMES><Register>R00</Register><Register>R01</Register><Register>R02</Register><Register>R03</Register><Register>R04</Register><Register>R05</Register><Register>R06</Register><Register>R07</Register><Register>R08</Register><Register>R09</Register><Register>R10</Register><Register>R11</Register><Register>R12</Register><Register>R13</Register><Register>R14</Register><Register>R15</Register><Register>R16</Register><Register>R17</Register><Register>R18</Register><Register>R19</Register><Register>R20</Register><Register>R21</Register><Register>R22</Register><Register>R23</Register><Register>R24</Register><Register>R25</Register><Register>R26</Register><Register>R27</Register><Register>R28</Register><Register>R29</Register><Register>R30</Register><Register>R31</Register></REGISTERNAMES><COM>Auto</COM><COMType>0</COMType><WATCHNUM>0</WATCHNUM><WATCHNAMES><Pane0></Pane0><Pane1></Pane1><Pane2></Pane2><Pane3></Pane3></WATCHNAMES><BreakOnTrcaeFull>0</BreakOnTrcaeFull></DEBUG_TARGET><Debugger><Triggers></Triggers></Debugger><AVRGCCPLUGIN><FILES><SOURCEFILE>Descriptors.c</SOURCEFILE><SOURCEFILE>RingBuff.c</SOURCEFILE><SOURCEFILE>AVRISP_Programmer.c</SOURCEFILE><HEADERFILE>Descriptors.h</HEADERFILE><HEADERFILE>RingBuff.h</HEADERFILE><HEADERFILE>AVRISP_Programmer.h</HEADERFILE><OTHERFILE>makefile</OTHERFILE></FILES><CONFIGS><CONFIG><NAME>default</NAME><USESEXTERNALMAKEFILE>YES</USESEXTERNALMAKEFILE><EXTERNALMAKEFILE>makefile</EXTERNALMAKEFILE><PART>atmega128</PART><HEX>1</HEX><LIST>1</LIST><MAP>1</MAP><OUTPUTFILENAME>AVRISP_Programmer.elf</OUTPUTFILENAME><OUTPUTDIR>default\</OUTPUTDIR><ISDIRTY>1</ISDIRTY><OPTIONS/><INCDIRS/><LIBDIRS/><LIBS/><LINKOBJECTS/><OPTIONSFORALL>-Wall -gdwarf-2 -std=gnu99 -Os -funsigned-char -funsigned-bitfields -fpack-struct -fshort-enums</OPTIONSFORALL><LINKEROPTIONS></LINKEROPTIONS><SEGMENTS/></CONFIG></CONFIGS><LASTCONFIG>default</LASTCONFIG><USES_WINAVR>1</USES_WINAVR><GCC_LOC>C:\WinAVR-20080512\bin\avr-gcc.exe</GCC_LOC><MAKE_LOC>C:\WinAVR-20080512\utils\bin\make.exe</MAKE_LOC></AVRGCCPLUGIN><IOView><usergroups/><sort sorted="0" column="0" ordername="0" orderaddress="0" ordergroup="0"/></IOView><Files></Files><Events><Bookmarks></Bookmarks></Events><Trace><Filters></Filters></Trace></AVRStudio>
diff --git a/Projects/AVRISP_Programmer/AVRISP_Programmer.c b/Projects/AVRISP_Programmer/AVRISP_Programmer.c
new file mode 100644
index 000000000..4dc18cd62
--- /dev/null
+++ b/Projects/AVRISP_Programmer/AVRISP_Programmer.c
@@ -0,0 +1,886 @@
+/*
+ LUFA Library
+ Copyright (C) Dean Camera, 2009.
+
+ dean [at] fourwalledcubicle [dot] com
+ www.fourwalledcubicle.com
+*/
+
+/*
+ Copyright 2009 Dean Camera (dean [at] fourwalledcubicle [dot] com)
+ AVR ISP Programmer code Copyright 2009 Opendous Inc. (www.opendous.org)
+ For more info and usage instructions for this firmware, visit:
+ http://code.google.com/p/avropendous/wiki/AVR_ISP_Programmer
+
+ Note that this firmware is designed to work with AVRdude:
+ http://savannah.nongnu.org/projects/avrdude
+ But should work with other software that supports the AVR910 ISP
+ programmer or STK200 hardware.
+
+ Permission to use, copy, modify, and distribute this software
+ and its documentation for any purpose and without fee is hereby
+ granted, provided that the above copyright notice appear in all
+ copies and that both that the copyright notice and this
+ permission notice and warranty disclaimer appear in supporting
+ documentation, and that the name of the author not be used in
+ advertising or publicity pertaining to distribution of the
+ software without specific, written prior permission.
+
+ The author disclaim all warranties with regard to this
+ software, including all implied warranties of merchantability
+ and fitness. In no event shall the author be liable for any
+ special, indirect or consequential damages or any damages
+ whatsoever resulting from loss of use, data or profits, whether
+ in an action of contract, negligence or other tortious action,
+ arising out of or in connection with the use or performance of
+ this software.
+*/
+
+/*
+ Usage:
+ avrdude -vv -F -P COM7 -c avr910 -p t261
+ Note -F flag which overrides signature check and enables programming
+ of any "In-System Programmable via SPI Port" AVR MCU. Part number,
+ t261, should be set to your target device.
+ avrdude -vv -F -P COM7 -c avr910 -p t261 -U flash:w:PROG.hex
+ PROG.hex is the hex file to program your t261 AVR with
+ avrdude -vv -F -P COM7 -b 115200 -c avr910 -p t261 -U flash:w:test.hex
+ The -b 115200 sets the SPI clock to 62.5kHz from the default 125kHz and may
+ work when the default programming speed fails.
+ AVROSP.exe -dATtiny261 -cCOM7 -rf
+ AVRosp is the Open Source AVR ISP Programming Software available from Atmel.com
+
+ Note: on Linux systems, COM7 should be replaced with someting like /dev/ttyACM0
+ You can determine this value by running dmesg after plugging in the device
+ Note: you must RESET the programmer after each use (AVRdude session).
+
+ Note: If you experience errors with older devices, try changing the DELAY defines
+
+ MISO, MOSI, and SCK are connected directly from the AVRopendous board
+ to the pin of the same functionality on the target. RESET pin on the target
+ can be connected either to SS (PB0), or PC2. Do not have any other pins
+ connected - especially HWB pin, to avoid unintentional behaviour.
+
+ AVR910 functionality was overlayed on USBtoSerial functionality.
+ Keep this in mind when looking over the code.
+ Default target speed is 125kHz and corresponds to 19200 baud, which
+ is the default setting for AVRdude.
+
+ Changing "Baud-Rate" will change the SPI speed. Defualt SPI clock speed
+ is 8Mhz / 4 = 2MHz. 8Mhz is the device clock speed. This is the setting at
+ 9600 baud. The following is a table of baud-rate vs. SPI Speed that will result
+ 9600 = 2Mhz
+ 14400 = 1MHz
+ 19200 = 125kHz (AVRdude Default)
+ 38400 = 250kHz
+ 57600 = 500kHz
+ 115200 = 62.5kHz
+
+ Before running, you will need to install the INF file that
+ is located in the project directory. This will enable
+ Windows to use its inbuilt CDC drivers, negating the need
+ for special Windows drivers for the device. To install,
+ right-click the .INF file and choose the Install option.
+*/
+
+/* TODO: - fix the requirement that a RESET must be performed after each session, which
+ is only an issue under Windows. Everything works fine under Linux
+*/
+
+#include "AVRISP_Programmer.h"
+
+/* Project Tags, for reading out using the ButtLoad project */
+BUTTLOADTAG(ProjName, "LUFA AVR910 ISP Programmer");
+BUTTLOADTAG(BuildTime, __TIME__);
+BUTTLOADTAG(BuildDate, __DATE__);
+BUTTLOADTAG(LUFAVersion, "LUFA V" LUFA_VERSION_STRING);
+
+
+#define RESETPORT PORTB
+#define RESETPIN PB0
+#define RESETPORT2 PORTC
+#define RESETPIN2 PC2
+#define CR_HEX '\r'
+
+#define DELAY_VERYSHORT 0x01
+#define DELAY_SHORT 0x02
+#define DELAY_MEDIUM 0x03
+#define DELAY_LONG 0x05
+#define DELAY_MULTIPLE 0x02
+
+
+/* AVR Device Codes - Can have a maximum of 14 but can be any you want.
+ Note that these are completely irrelevent. If AVRdude supports a device,
+ then that device is programmable. Use -F switch to ignore device codes. */
+#define AVRDEVCODE01 0x55 /* ATtiny12 */
+#define AVRDEVCODE02 0x56 /* ATtiny15 */
+#define AVRDEVCODE03 0x5E /* ATtiny261 */
+#define AVRDEVCODE04 0x76 /* ATmega8 */
+#define AVRDEVCODE05 0x74 /*ATmega16 */
+#define AVRDEVCODE06 0x72 /* ATmega32 */
+#define AVRDEVCODE07 0x45 /* ATmega64 */
+#define AVRDEVCODE08 0x74 /* ATmega644 */
+#define AVRDEVCODE09 0x43 /* ATmega128 */
+#define AVRDEVCODE10 0x63 /* ATmega162 */
+#define AVRDEVCODE11 0x78 /* ATmega169 */
+#define AVRDEVCODE12 0x6C /* AT90S4434 */
+#define AVRDEVCODE13 0x38 /* AT90S8515A */
+#define AVRDEVCODE14 0x65 /* AT90S8555 */
+
+
+/* Scheduler Task List */
+TASK_LIST
+{
+ { Task: USB_USBTask , TaskStatus: TASK_STOP },
+ { Task: CDC_Task , TaskStatus: TASK_STOP },
+};
+
+/* Globals: */
+/** Contains the current baud rate and other settings of the virtual serial port.
+ *
+ These values are set by the host via a class-specific request, and the physical USART should be reconfigured to match the
+ new settings each time they are changed by the host.
+ */
+CDC_Line_Coding_t LineCoding = { BaudRateBPS: 9600,
+ CharFormat: OneStopBit,
+ ParityType: Parity_None,
+ DataBits: 8 };
+
+/** Ring (circular) buffer to hold the RX data - data from the host to the attached device on the serial port. */
+RingBuff_t Rx_Buffer;
+
+/** Ring (circular) buffer to hold the TX data - data from the attached device on the serial port to the host. */
+RingBuff_t Tx_Buffer;
+
+/** Flag to indicate if the USART is currently transmitting data from the Rx_Buffer circular buffer. */
+volatile bool Transmitting = false;
+
+
+/* some global variables used throughout */
+uint8_t tempIOreg = 0;
+uint8_t tempIOreg2 = 0;
+uint8_t tempIOreg3 = 0;
+uint8_t tempIOreg4 = 0;
+uint8_t dataWidth = 0;
+uint8_t firstRun = 1;
+uint8_t deviceCode = 0;
+uint8_t tempByte = 0;
+uint16_t currAddress = 0;
+uint16_t timerval = 0;
+
+
+
+/** Main program entry point. This routine configures the hardware required by the application, then
+ starts the scheduler to run the application tasks.
+ */
+int main(void)
+{
+ /* Disable watchdog if enabled by bootloader/fuses */
+ MCUSR &= ~(1 << WDRF);
+ wdt_disable();
+
+ /* Disable Clock Division */
+ SetSystemClockPrescaler(0);
+
+ /* Hardware Initialization */
+ LEDs_Init();
+ ReconfigureSPI();
+ // prepare PortB
+ DDRB = 0;
+ PORTB = 0;
+ DDRC |= ((1 << PC2) | (1 << PC4) | (1 << PC5) | (1 << PC6) | (1 << PC7)); //AT90USBxx2
+ // PC2 is also used for RESET, so set it HIGH initially - note 'P' command sets it to LOW (Active)
+ PORTC |= ((1 << PC2) | (1 << PC4) | (1 << PC5) | (1 << PC6) | (1 << PC7)); //AT90USBxx2
+ DDRD = 0;
+ PORTD = (1 << PB7); // only PB7(HWB) should be High as this is the bootloader pin
+ // Prepare PortB for SPI - set PB0(^SS), PB1(SCK), PB2(MOSI) as output as well as all other pins except PB3(MISO)
+ DDRB = (1 << PB0) | (1 << PB1) | (1 << PB2) | (0 << PB3) | (1 << PB4) | (1 << PB5) | (1 << PB6) | (1 << PB7);
+ PORTB |= (1 << PB0);
+ // make sure DataFlash devices to not interfere - deselect them by setting PE0 and PE1 HIGH:
+ PORTE = 0xFF;
+ DDRE = 0xFF;
+
+ // initialize Timer1 for use in delay function
+ TCCR1A = 0;
+ //TCCR1B = (1 << CS10); // no prescaling, use CLK
+ TCCR1B = ((1 << CS12) | (1 << CS10)); // prescale by CLK/1024
+ // 8MHz/1024 = 7813 ticks per second --> ~8 ticks per millisecond (ms)
+ timerval = TCNT1; // start timer1
+
+
+ /* Ringbuffer Initialization */
+ Buffer_Initialize(&Rx_Buffer);
+ Buffer_Initialize(&Tx_Buffer);
+
+ /* Indicate USB not ready */
+ UpdateStatus(Status_USBNotReady);
+
+ /* Initialize Scheduler so that it can be used */
+ Scheduler_Init();
+
+ /* Initialize USB Subsystem */
+ USB_Init();
+
+ /* Scheduling - routine never returns, so put this last in the main function */
+ Scheduler_Start();
+}
+
+/** Event handler for the USB_Connect event. This indicates that the device is enumerating via the status LEDs and
+ starts the library USB task to begin the enumeration and USB management process.
+ */
+EVENT_HANDLER(USB_Connect)
+{
+ /* Start USB management task */
+ Scheduler_SetTaskMode(USB_USBTask, TASK_RUN);
+
+ /* Indicate USB enumerating */
+ UpdateStatus(Status_USBEnumerating);
+}
+
+/** Event handler for the USB_Disconnect event. This indicates that the device is no longer connected to a host via
+ the status LEDs and stops the USB management and CDC management tasks.
+ */
+EVENT_HANDLER(USB_Disconnect)
+{
+ /* Stop running CDC and USB management tasks */
+ Scheduler_SetTaskMode(CDC_Task, TASK_STOP);
+ Scheduler_SetTaskMode(USB_USBTask, TASK_STOP);
+
+ /* Indicate USB not ready */
+ UpdateStatus(Status_USBNotReady);
+}
+
+/** Event handler for the USB_ConfigurationChanged event. This is fired when the host set the current configuration
+ of the USB device after enumeration - the device endpoints are configured and the CDC management task started.
+ */
+EVENT_HANDLER(USB_ConfigurationChanged)
+{
+ /* Setup CDC Notification, Rx and Tx Endpoints */
+ Endpoint_ConfigureEndpoint(CDC_NOTIFICATION_EPNUM, EP_TYPE_INTERRUPT,
+ ENDPOINT_DIR_IN, CDC_NOTIFICATION_EPSIZE,
+ ENDPOINT_BANK_SINGLE);
+
+ Endpoint_ConfigureEndpoint(CDC_TX_EPNUM, EP_TYPE_BULK,
+ ENDPOINT_DIR_IN, CDC_TXRX_EPSIZE,
+ ENDPOINT_BANK_SINGLE);
+
+ Endpoint_ConfigureEndpoint(CDC_RX_EPNUM, EP_TYPE_BULK,
+ ENDPOINT_DIR_OUT, CDC_TXRX_EPSIZE,
+ ENDPOINT_BANK_SINGLE);
+
+ /* Indicate USB connected and ready */
+ UpdateStatus(Status_USBReady);
+
+ /* Start CDC task */
+ Scheduler_SetTaskMode(CDC_Task, TASK_RUN);
+}
+
+/** Event handler for the USB_UnhandledControlPacket event. This is used to catch standard and class specific
+ control requests that are not handled internally by the USB library (including the CDC control commands,
+ which are all issued via the control endpoint), so that they can be handled appropriately for the application.
+ */
+EVENT_HANDLER(USB_UnhandledControlPacket)
+{
+ uint8_t* LineCodingData = (uint8_t*)&LineCoding;
+
+ /* Process CDC specific control requests */
+ switch (bRequest)
+ {
+ case REQ_GetLineEncoding:
+ if (bmRequestType == (REQDIR_DEVICETOHOST | REQTYPE_CLASS | REQREC_INTERFACE))
+ {
+ /* Acknowedge the SETUP packet, ready for data transfer */
+ Endpoint_ClearSetupReceived();
+
+ /* Write the line coding data to the control endpoint */
+ Endpoint_Write_Control_Stream_LE(LineCodingData, sizeof(LineCoding));
+
+ /* Finalize the stream transfer to send the last packet or clear the host abort */
+ Endpoint_ClearSetupOUT();
+ }
+
+ break;
+ case REQ_SetLineEncoding:
+ if (bmRequestType == (REQDIR_HOSTTODEVICE | REQTYPE_CLASS | REQREC_INTERFACE))
+ {
+ /* Acknowedge the SETUP packet, ready for data transfer */
+ Endpoint_ClearSetupReceived();
+
+ /* Read the line coding data in from the host into the global struct */
+ Endpoint_Read_Control_Stream_LE(LineCodingData, sizeof(LineCoding));
+
+ /* Finalize the stream transfer to clear the last packet from the host */
+ Endpoint_ClearSetupIN();
+
+ /* Reconfigure the USART with the new settings */
+ ReconfigureSPI();
+ }
+
+ break;
+ case REQ_SetControlLineState:
+ if (bmRequestType == (REQDIR_HOSTTODEVICE | REQTYPE_CLASS | REQREC_INTERFACE))
+ {
+#if 0
+ /* NOTE: Here you can read in the line state mask from the host, to get the current state of the output handshake
+ lines. The mask is read in from the wValue parameter, and can be masked against the CONTROL_LINE_OUT_* masks
+ to determine the RTS and DTR line states using the following code:
+ */
+
+ uint16_t wIndex = Endpoint_Read_Word_LE();
+
+ // Do something with the given line states in wIndex
+#endif
+
+ /* Acknowedge the SETUP packet, ready for data transfer */
+ Endpoint_ClearSetupReceived();
+
+ /* Send an empty packet to acknowedge the command */
+ Endpoint_ClearSetupIN();
+ }
+
+ break;
+ }
+}
+
+/** Task to manage CDC data transmission and reception to and from the host, from and to the physical USART. */
+TASK(CDC_Task)
+{
+ if (USB_IsConnected)
+ {
+#if 0
+ /* NOTE: Here you can use the notification endpoint to send back line state changes to the host, for the special RS-232
+ handshake signal lines (and some error states), via the CONTROL_LINE_IN_* masks and the following code:
+ */
+
+ USB_Notification_Header_t Notification = (USB_Notification_Header_t)
+ {
+ NotificationType: (REQDIR_DEVICETOHOST | REQTYPE_CLASS | REQREC_INTERFACE),
+ Notification: NOTIF_SerialState,
+ wValue: 0,
+ wIndex: 0,
+ wLength: sizeof(uint16_t),
+ };
+
+ uint16_t LineStateMask;
+
+ // Set LineStateMask here to a mask of CONTROL_LINE_IN_* masks to set the input handshake line states to send to the host
+
+ Endpoint_SelectEndpoint(CDC_NOTIFICATION_EPNUM);
+ Endpoint_Write_Stream_LE(&Notification, sizeof(Notification));
+ Endpoint_Write_Stream_LE(&LineStateMask, sizeof(LineStateMask));
+ Endpoint_ClearCurrentBank();
+#endif
+
+ /* Select the Serial Rx Endpoint */
+ Endpoint_SelectEndpoint(CDC_RX_EPNUM);
+
+ if (Endpoint_ReadWriteAllowed())
+ {
+ /* Read the received data endpoint into the transmission buffer */
+ while (Endpoint_BytesInEndpoint())
+ {
+ /* Wait until the buffer has space for a new character */
+ while (!((BUFF_STATICSIZE - Rx_Buffer.Elements)));
+
+ /* Store each character from the endpoint */
+ Buffer_StoreElement(&Rx_Buffer, Endpoint_Read_Byte());
+
+
+
+
+ /* Each time there is an element, check which comand should be
+ run and if enough data is available to run that command.
+ There are 1-byte, 2-byte, 3-byte, 4-byte commands, and 5-byte commands
+ Remember that the "which command" byte counts as 1 */
+ if (Rx_Buffer.Elements == 0) {
+ // do nothing, wait for data
+ } else {
+ tempByte = Buffer_PeekElement(&Rx_Buffer); // peek at first element
+
+ /* make sure the issued command and associated data are all ready */
+ if (Rx_Buffer.Elements == 1) { // zero data byte command
+ if ((tempByte == 'P') | (tempByte == 'a') | (tempByte == 'm') |
+ (tempByte == 'R') | (tempByte == 'd') | (tempByte == 'e') |
+ (tempByte == 'L') | (tempByte == 's') | (tempByte == 't') |
+ (tempByte == 'S') | (tempByte == 'V') | (tempByte == 'v') |
+ (tempByte == 'p') | (tempByte == 'F')) {
+ processHostSPIRequest(); // command has enough data, process it
+ }
+ } else if (Rx_Buffer.Elements == 2) { // one data byte command
+ if ((tempByte == 'T') | (tempByte == 'c') | (tempByte == 'C') |
+ (tempByte == 'D') | (tempByte == 'l') | (tempByte == 'f') |
+ (tempByte == 'x') | (tempByte == 'y')) {
+ processHostSPIRequest(); // command has enough data, process it
+ }
+ } else if (Rx_Buffer.Elements == 3) { // two data byte command
+ if ((tempByte == 'A') | (tempByte == 'Z')) {
+ processHostSPIRequest(); // command has enough data, process it
+ }
+ } else if (Rx_Buffer.Elements == 4) { // three data byte command
+ if ((tempByte == ':')) {
+ processHostSPIRequest(); // command has enough data, process it
+ }
+ } else if (Rx_Buffer.Elements == 5) { // four data byte command
+ if ((tempByte == '.')) {
+ processHostSPIRequest(); // command has enough data, process it
+ }
+ } else {
+ // do nothing
+ }
+ }
+
+
+
+ }
+
+ /* Clear the endpoint buffer */
+ Endpoint_ClearCurrentBank();
+ }
+
+ /* Check if Rx buffer contains data */
+ if (Rx_Buffer.Elements)
+ {
+ /* Initiate the transmission of the buffer contents if USART idle */
+ if (!(Transmitting))
+ {
+ Transmitting = true;
+ /* The following flushes the receive buffer to prepare for new data and commands */
+ /* Need to flush the buffer as the command byte which is peeked above needs to be */
+ /* dealt with, otherwise the command bytes will overflow the buffer eventually */
+ //Buffer_GetElement(&Rx_Buffer); // works also
+ Buffer_Initialize(&Rx_Buffer);
+ }
+ }
+
+ /* Select the Serial Tx Endpoint */
+ Endpoint_SelectEndpoint(CDC_TX_EPNUM);
+
+ /* Check if the Tx buffer contains anything to be sent to the host */
+ if (Tx_Buffer.Elements)
+ {
+ /* Wait until Serial Tx Endpoint Ready for Read/Write */
+ while (!(Endpoint_ReadWriteAllowed()));
+
+ /* Check before sending the data if the endpoint is completely full */
+ bool IsFull = (Endpoint_BytesInEndpoint() == CDC_TXRX_EPSIZE);
+
+ /* Write the transmission buffer contents to the received data endpoint */
+ while (Tx_Buffer.Elements && (Endpoint_BytesInEndpoint() < CDC_TXRX_EPSIZE))
+ Endpoint_Write_Byte(Buffer_GetElement(&Tx_Buffer));
+
+ /* Send the data */
+ Endpoint_ClearCurrentBank();
+
+ /* If a full endpoint was sent, we need to send an empty packet afterwards to terminate the transfer */
+ if (IsFull)
+ {
+ /* Wait until Serial Tx Endpoint Ready for Read/Write */
+ while (!(Endpoint_ReadWriteAllowed()));
+
+ /* Send an empty packet to terminate the transfer */
+ Endpoint_ClearCurrentBank();
+ }
+ }
+ }
+}
+
+
+
+/** Function to manage status updates to the user. This is done via LEDs on the given board, if available, but may be changed to
+ log to a serial port, or anything else that is suitable for status updates.
+ *
+ \param CurrentStatus Current status of the system, from the USBtoSerial_StatusCodes_t enum
+ */
+void UpdateStatus(uint8_t CurrentStatus)
+{
+ uint8_t LEDMask = LEDS_NO_LEDS;
+
+ /* Set the LED mask to the appropriate LED mask based on the given status code */
+ switch (CurrentStatus)
+ {
+ case Status_USBNotReady:
+ LEDMask = (LEDS_LED1);
+ break;
+ case Status_USBEnumerating:
+ LEDMask = (LEDS_LED1 | LEDS_LED2);
+ break;
+ case Status_USBReady:
+ LEDMask = (LEDS_LED2 | LEDS_LED4);
+ break;
+ }
+
+ /* Set the board LEDs to the new LED mask */
+ LEDs_SetAllLEDs(LEDMask);
+}
+
+
+/** Reconfigures SPI to match the current serial port settings issued by the host. */
+void ReconfigureSPI(void)
+{
+ uint8_t SPCRmask = (1 << SPE) | (1 << MSTR); // always enable SPI as Master
+ uint8_t SPSRmask = 0;
+
+ /* Determine data width */
+ if (LineCoding.ParityType == Parity_Odd) {
+ dataWidth = 16;
+ } else if (LineCoding.ParityType == Parity_Even) {
+ dataWidth = 32;
+ } else if (LineCoding.ParityType == Parity_None) {
+ dataWidth = 8;
+ }
+
+ /* Determine stop bits - 1.5 stop bits is set as 1 stop bit due to hardware limitations */
+ /* For SPI, determine whether format is LSB or MSB */
+ if (LineCoding.CharFormat == TwoStopBits) {
+ SPCRmask |= (1 << DORD);
+ } else if (LineCoding.CharFormat == OneStopBit) {
+ SPCRmask |= (0 << DORD);
+ }
+
+ /* Determine data size - 5, 6, 7, or 8 bits are supported */
+ /* Changing line coding changes SPI Mode
+ CPOL=0, CPHA=0 Sample (Rising) Setup (Falling) SPI-Mode0 == 8 bits line coding
+ CPOL=0, CPHA=1 Setup (Rising) Sample (Falling) SPI-Mode1 == 7 bits line coding
+ CPOL=1, CPHA=0 Sample (Falling) Setup (Rising) SPI-Mode2 == 6 bits line coding
+ CPOL=1, CPHA=1 Setup (Falling) Sample (Rising) SPI-Mode3 == 5 bits line coding
+ */
+ if (LineCoding.DataBits == 5) {
+ SPCRmask |= ((1 << CPOL) | (1 << CPHA));
+ } else if (LineCoding.DataBits == 6) {
+ SPCRmask |= ((1 << CPOL) | (0 << CPHA));
+ } else if (LineCoding.DataBits == 7) {
+ SPCRmask |= ((0 << CPOL) | (1 << CPHA));
+ } else if (LineCoding.DataBits == 8) {
+ SPCRmask |= ((0 << CPOL) | (0 << CPHA));
+ }
+
+
+ /* Set the USART baud rate register to the desired baud rate value */
+ /* also alter the SPI speed via value of baud rate */
+ if (LineCoding.BaudRateBPS == 9600) { // 2Mhz SPI (Fosc / 4)
+ SPCRmask |= ((0 << SPR1) | (0 << SPR0));
+ SPSRmask |= (0 << SPI2X);
+ } else if (LineCoding.BaudRateBPS == 14400) { // 1Mhz SPI (Fosc / 8)
+ SPCRmask |= ((0 << SPR1) | (1 << SPR0));
+ SPSRmask |= (1 << SPI2X);
+ } else if (LineCoding.BaudRateBPS == 57600) { // 500kHz SPI (Fosc / 16)
+ SPCRmask |= ((0 << SPR1) | (1 << SPR0));
+ SPSRmask |= (0 << SPI2X);
+ } else if (LineCoding.BaudRateBPS == 38400) { // 250kHz SPI (Fosc / 32)
+ SPCRmask |= ((1 << SPR1) | (0 << SPR0));
+ SPSRmask |= (1 << SPI2X);
+ } else if (LineCoding.BaudRateBPS == 19200) { // 125kHz SPI (Fosc / 64)
+ SPCRmask |= ((1 << SPR1) | (0 << SPR0));
+ SPSRmask |= (0 << SPI2X);
+ } else if (LineCoding.BaudRateBPS == 115200) { // 62.5kHz SPI (Fosc / 128)
+ SPCRmask |= ((1 << SPR1) | (1 << SPR0));
+ SPSRmask |= (0 << SPI2X);
+ }
+
+ SPCR = SPCRmask;
+ SPSR = SPSRmask;
+
+ // only read if first run
+ if (firstRun) {
+ tempIOreg = SPSR; //need to read to initiliaze
+ tempIOreg = SPDR; //need to read to initiliaze
+ firstRun = 0;
+ }
+
+}
+
+
+/* process data according to AVR910 protocol */
+void processHostSPIRequest(void) {
+
+ uint8_t readByte1 = 0;
+ uint8_t readByte2 = 0;
+ uint8_t readByte3 = 0;
+ uint8_t readByte4 = 0;
+ uint8_t firstByte = 0;
+
+ /* Taken from a90isp_ver23.asm:
+ +-------------+------------+------+
+ ;* Commands | Host writes | Host reads | |
+ ;* -------- +-----+-------+------+-----+ |
+ ;* | ID | data | data | | Note |
+ ;* +-----------------------------------+-----+-------+------+-----+------+
+ ;* | Enter programming mode | 'P' | | | 13d | 1 |
+ ;* | Report autoincrement address | 'a' | | | 'Y' | |
+ ;* | Set address | 'A' | ah al | | 13d | 2 |
+ ;* | Write program memory, low byte | 'c' | dd | | 13d | 3 |
+ ;* | Write program memory, high byte | 'C' | dd | | 13d | 3 |
+ ;* | Issue Page Write | 'm' | | | 13d | |
+ ;* | Read program memory | 'R' | |dd(dd)| | 4 |
+ ;* | Write data memory | 'D' | dd | | 13d | |
+ ;* | Read data memory | 'd' | | dd | | |
+ ;* | Chip erase | 'e' | | | 13d | |
+ ;* | Write lock bits | 'l' | dd | | 13d | |
+ ;* | Write fuse bits | 'f' | dd | | 13d | 11 |
+ ;* | Read fuse and lock bits | 'F' | | dd | | 11 |
+ ;* | Leave programming mode | 'L' | | | 13d | 5 |
+ ;* | Select device type | 'T' | dd | | 13d | 6 |
+ ;* | Read signature bytes | 's' | | 3*dd | | |
+ ;* | Return supported device codes | 't' | | n*dd | 00d | 7 |
+ ;* | Return software identifier | 'S' | | s[7] | | 8 |
+ ;* | Return sofware version | 'V' | |dd dd | | 9 |
+ ;* | Return hardware version | 'v' | |dd dd | | 9 |
+ ;* | Return programmer type | 'p' | | dd | | 10 |
+ ;* | Set LED | 'x' | dd | | 13d | 12 |
+ ;* | Clear LED | 'y' | dd | | 13d | 12 |
+ ;* | Universial command | ':' | 3*dd | dd | 13d | |
+ ;* | New universal command | '.' | 4*dd | dd | 13d | |
+ ;* | Special test command | 'Z' | 2*dd | dd | | |
+ */
+
+ firstByte = Buffer_GetElement(&Rx_Buffer);
+ Buffer_Initialize(&Tx_Buffer); // make sure the buffer is clear before proceeding
+
+ if (firstByte == 'P') { // enter Programming mode
+ // enable SPI -- already done
+ // enter programming mode on target:
+ //PORTB = 0; // set clock to zero
+ RESETPORT = (1 << RESETPIN); // set RESET pin on target to 1
+ RESETPORT2 = (1 << RESETPIN2);
+ delay_ms(DELAY_SHORT);
+ //RESETPORT = (RESETPORT & ~(1 << RESETPIN)); // set RESET pin on target to 0 - Active
+ RESETPORT = 0x00;
+ RESETPORT2 = 0;
+ delay_ms(DELAY_SHORT);
+ SPI_SendByte(0xAC);
+ SPI_SendByte(0x53);
+ SPI_SendByte(0x00);
+ SPI_SendByte(0x00);
+ delay_ms(DELAY_VERYSHORT);
+ Buffer_StoreElement(&Tx_Buffer, CR_HEX); // return carriage return (CR_HEX) if successful
+
+ } else if (firstByte == 'T') { // Select device type
+ deviceCode = Buffer_GetElement(&Rx_Buffer); // set device type
+ Buffer_StoreElement(&Tx_Buffer, CR_HEX); // return carriage return (CR_HEX) if successful
+
+ } else if (firstByte == 'a') { // Report autoincrement address
+ Buffer_StoreElement(&Tx_Buffer, 'Y'); // return 'Y' - Auto-increment enabled
+
+ } else if (firstByte == 'A') { //Load Address
+ // get two bytes over serial and set currAddress to them
+ readByte1 = Buffer_GetElement(&Rx_Buffer); // high byte
+ readByte2 = Buffer_GetElement(&Rx_Buffer); // low byte
+ currAddress = (readByte1 << 8) | (readByte2);
+ Buffer_StoreElement(&Tx_Buffer, CR_HEX); // return carriage return (CR_HEX) if successful
+
+ } else if (firstByte == 'c') { // Write program memory, low byte
+ // send 4 bytes over SPI; 0x40, then Address High Byte, then Low, then data
+ readByte1 = Buffer_GetElement(&Rx_Buffer);
+ SPI_SendByte(0x40);
+ SPI_SendByte((currAddress >> 8)); // high byte
+ SPI_SendByte((currAddress)); // low byte
+ SPI_SendByte(readByte1); // data
+ delay_ms(DELAY_MEDIUM); // certain MCUs require a delay of about 24585 cycles
+ Buffer_StoreElement(&Tx_Buffer, CR_HEX); // return carriage return (CR_HEX) if successful
+
+ } else if (firstByte == 'C') { // Write program memory, high byte
+ // send 4 bytes over SPI; 0x48, then Address High Byte, then Low, then data
+ readByte1 = Buffer_GetElement(&Rx_Buffer);
+ SPI_SendByte(0x48);
+ SPI_SendByte((currAddress >> 8)); // high byte
+ SPI_SendByte((currAddress)); // low byte
+ SPI_SendByte(readByte1); // data
+ currAddress++; // increment currAddress
+ Buffer_StoreElement(&Tx_Buffer, CR_HEX); // return carriage return (CR_HEX) if successful
+
+ } else if (firstByte == 'm') { // Write Program Memory Page
+ // send 4 bytes over SPI; 0x4c, then Address High Byte, then Low, then 0x00
+ SPI_SendByte(0x4C);
+ SPI_SendByte((currAddress >> 8)); // high byte
+ SPI_SendByte((currAddress)); // low byte
+ SPI_SendByte(0x00);
+ delay_ms(DELAY_LONG);
+ Buffer_StoreElement(&Tx_Buffer, CR_HEX); // return carriage return (CR_HEX) if successful
+
+ } else if (firstByte == 'R') { // Read Program Memory
+ // send 4 bytes over SPI; 0x28, then Address High Byte, then Low, then send back read data from 4th byte over serial
+ SPI_SendByte(0x28);
+ SPI_SendByte((currAddress >> 8)); // high byte
+ SPI_SendByte((currAddress)); // low byte
+ readByte1 = SPI_TransferByte(0x00); // read in data
+ Buffer_StoreElement(&Tx_Buffer, readByte1);
+ // send 4 bytes over SPI; 0x20, then Address High Byte, then Low, then send back read data from 4th byte over serial
+ SPI_SendByte(0x20);
+ SPI_SendByte((currAddress >> 8)); // high byte
+ SPI_SendByte((currAddress)); // low byte
+ readByte2 = SPI_TransferByte(0x00); // read in data
+ Buffer_StoreElement(&Tx_Buffer, readByte2);
+ currAddress++; // increment currAddress
+
+ } else if (firstByte == 'D') { // Write Data Memory
+ // send 4 bytes over SPI; 0xc0, then Address High Byte, then Low, then data
+ readByte1 = Buffer_GetElement(&Rx_Buffer);
+ SPI_SendByte(0xC0);
+ SPI_SendByte((currAddress >> 8)); // high byte
+ SPI_SendByte((currAddress)); // low byte
+ SPI_SendByte(readByte1); // data
+ delay_ms(DELAY_MEDIUM);
+ currAddress++; // increment currAddress
+ Buffer_StoreElement(&Tx_Buffer, CR_HEX); // return carriage return (CR_HEX) if successful
+
+ } else if (firstByte == 'd') { // Read Data Memory
+ // send 4 bytes over SPI; 0xa0, then Address High Byte, then Low, then send back read data from 4th byte over serial
+ SPI_SendByte(0xA0);
+ SPI_SendByte((currAddress >> 8)); // high byte
+ SPI_SendByte((currAddress)); // low byte
+ readByte1 = SPI_TransferByte(0x00); // read in data
+ Buffer_StoreElement(&Tx_Buffer, readByte1);
+ currAddress++; // increment currAddress
+
+ } else if (firstByte == 'e') { // erase the target device
+ // send 4 bytes over SPI; 0xac, 0x80, 0x04, 0x00
+ SPI_SendByte(0xAC);
+ SPI_SendByte(0x80);
+ SPI_SendByte(0x04);
+ SPI_SendByte(0x00);
+ delay_ms(DELAY_LONG);
+ Buffer_StoreElement(&Tx_Buffer, CR_HEX); // return carriage return (CR_HEX) if successful
+
+ } else if (firstByte == 'l') { // write lock bits
+ // send 4 bytes over SPI; 0xac, [andi s_data 0x06], 0xe0, 0x00
+ readByte1 = Buffer_GetElement(&Rx_Buffer); // read in lock bits data
+ SPI_SendByte(0xAC);
+ SPI_SendByte(((0x06 & readByte1) | 0xE0)); // TODO - is this correct???
+ SPI_SendByte(0x00);
+ SPI_SendByte(0x00);
+ delay_ms(DELAY_MEDIUM);
+ Buffer_StoreElement(&Tx_Buffer, CR_HEX); // return carriage return (CR_HEX) if successful
+
+ } else if (firstByte == 'f') { // write fuse bits
+ // ignore this command, but need to remove data from the receive buffer
+ readByte1 = Buffer_GetElement(&Rx_Buffer);
+ Buffer_StoreElement(&Tx_Buffer, CR_HEX); // return carriage return (CR_HEX) if successful
+
+ } else if (firstByte == 'L') { // leave programming mode
+ RESETPORT |= (1 << RESETPIN); // set RESET pin on target to 1
+ RESETPORT2 |= (1 << RESETPIN2); // set RESET pin on target to 1
+ Buffer_StoreElement(&Tx_Buffer, CR_HEX); // return carriage return (CR_HEX) if successful
+
+ } else if (firstByte == 's') { // Read signature bytes
+ // send 4 bytes over SPI; 0x30, 0x00, 0x02, read and send last byte over serial
+ SPI_SendByte(0x30);
+ SPI_SendByte(0x00);
+ SPI_SendByte(0x02);
+ readByte1 = SPI_TransferByte(0x00); // read in data
+ Buffer_StoreElement(&Tx_Buffer, readByte1);
+ SPI_SendByte(0x30);
+ SPI_SendByte(0x00);
+ SPI_SendByte(0x01);
+ readByte1 = SPI_TransferByte(0x00); // read in data
+ Buffer_StoreElement(&Tx_Buffer, readByte1);
+ SPI_SendByte(0x30);
+ SPI_SendByte(0x00);
+ SPI_SendByte(0x00);
+ readByte1 = SPI_TransferByte(0x00); // read in data
+ Buffer_StoreElement(&Tx_Buffer, readByte1);
+
+ } else if (firstByte == 't') { // Return supported device codes
+ Buffer_StoreElement(&Tx_Buffer, AVRDEVCODE01);
+ Buffer_StoreElement(&Tx_Buffer, AVRDEVCODE02);
+ Buffer_StoreElement(&Tx_Buffer, AVRDEVCODE03);
+ Buffer_StoreElement(&Tx_Buffer, AVRDEVCODE04);
+ Buffer_StoreElement(&Tx_Buffer, AVRDEVCODE05);
+ Buffer_StoreElement(&Tx_Buffer, AVRDEVCODE06);
+ Buffer_StoreElement(&Tx_Buffer, AVRDEVCODE07);
+ Buffer_StoreElement(&Tx_Buffer, AVRDEVCODE08);
+ Buffer_StoreElement(&Tx_Buffer, AVRDEVCODE09);
+ Buffer_StoreElement(&Tx_Buffer, AVRDEVCODE10);
+ Buffer_StoreElement(&Tx_Buffer, AVRDEVCODE11);
+ Buffer_StoreElement(&Tx_Buffer, AVRDEVCODE12);
+ Buffer_StoreElement(&Tx_Buffer, AVRDEVCODE13);
+ Buffer_StoreElement(&Tx_Buffer, AVRDEVCODE14);
+ Buffer_StoreElement(&Tx_Buffer, 0x00);
+
+ } else if (firstByte == 'S') { // Return software identifier
+ // return string[7] with "AVR ISP"
+ Buffer_StoreElement(&Tx_Buffer, 'A');
+ Buffer_StoreElement(&Tx_Buffer, 'V');
+ Buffer_StoreElement(&Tx_Buffer, 'R');
+ Buffer_StoreElement(&Tx_Buffer, 0x20);
+ Buffer_StoreElement(&Tx_Buffer, 'I');
+ Buffer_StoreElement(&Tx_Buffer, 'S');
+ Buffer_StoreElement(&Tx_Buffer, 'P');
+
+ } else if (firstByte == 'V') { // Return sofware version
+ //return two bytes, software Major then Minor
+ Buffer_StoreElement(&Tx_Buffer, '2');
+ Buffer_StoreElement(&Tx_Buffer, '3');
+
+ } else if (firstByte == 'v') { // Return hardware version
+ //return two bytes, hardware Major then Minor
+ Buffer_StoreElement(&Tx_Buffer, ('1'));
+ Buffer_StoreElement(&Tx_Buffer, ('0'));
+
+ } else if (firstByte == 'p') { // Return programmer type
+ // return 'S' for Serial Programmer
+ Buffer_StoreElement(&Tx_Buffer, 'S');
+
+ } else if (firstByte == 'x') { // set LED
+ // ignore this command, but need to remove data from the receive buffer
+ readByte1 = Buffer_GetElement(&Rx_Buffer);
+ Buffer_StoreElement(&Tx_Buffer, CR_HEX); // return carriage return (CR_HEX) if successful
+
+ } else if (firstByte == 'y') { // clear LED
+ // ignore this command, but need to remove data from the receive buffer
+ readByte1 = Buffer_GetElement(&Rx_Buffer);
+ Buffer_StoreElement(&Tx_Buffer, CR_HEX); // return carriage return (CR_HEX) if successful
+
+ } else if (firstByte == ':') { // Universal Command
+ // get 3 bytes over serial
+ readByte1 = Buffer_GetElement(&Rx_Buffer);
+ readByte2 = Buffer_GetElement(&Rx_Buffer);
+ readByte3 = Buffer_GetElement(&Rx_Buffer);
+ SPI_SendByte(readByte1);
+ SPI_SendByte(readByte2);
+ SPI_SendByte(readByte3);
+ readByte1 = SPI_TransferByte(0x00);
+ Buffer_StoreElement(&Tx_Buffer, readByte1);
+ delay_ms(DELAY_MEDIUM);
+ Buffer_StoreElement(&Tx_Buffer, CR_HEX); // return carriage return (CR_HEX) if successful
+
+ } else if (firstByte == '.') { // New Universal Command
+ // get 4 bytes over serial
+ readByte1 = Buffer_GetElement(&Rx_Buffer);
+ readByte2 = Buffer_GetElement(&Rx_Buffer);
+ readByte3 = Buffer_GetElement(&Rx_Buffer);
+ readByte4 = Buffer_GetElement(&Rx_Buffer);
+ SPI_SendByte(readByte1);
+ SPI_SendByte(readByte2);
+ SPI_SendByte(readByte3);
+ readByte1 = SPI_TransferByte(readByte4);
+ Buffer_StoreElement(&Tx_Buffer, readByte1);
+ delay_ms(DELAY_MEDIUM);
+ Buffer_StoreElement(&Tx_Buffer, CR_HEX); // return carriage return (CR_HEX) if successful
+
+ } else if (firstByte == 'Z') { // Special test command
+ // do nothing, but need to remove data from the receive buffer
+ readByte1 = Buffer_GetElement(&Rx_Buffer);
+ readByte2 = Buffer_GetElement(&Rx_Buffer);
+
+ } else {
+ // do nothing, but need to return with a carriage return
+ Buffer_StoreElement(&Tx_Buffer, CR_HEX); // return carriage return (CR_HEX) if successful
+ }
+}
+
+
+void delay_ms(uint8_t dly) {
+ uint16_t endtime = 0;
+
+ endtime = TCNT1;
+ if (endtime > 63486) {
+ endtime = (dly * DELAY_MULTIPLE);
+ } else {
+ endtime += (dly * DELAY_MULTIPLE);
+ }
+
+ timerval = TCNT1;
+ while (timerval < endtime) {
+ timerval = TCNT1;
+ }
+}
diff --git a/Projects/AVRISP_Programmer/AVRISP_Programmer.h b/Projects/AVRISP_Programmer/AVRISP_Programmer.h
new file mode 100644
index 000000000..e78ba2935
--- /dev/null
+++ b/Projects/AVRISP_Programmer/AVRISP_Programmer.h
@@ -0,0 +1,194 @@
+/*
+ LUFA Library
+ Copyright (C) Dean Camera, 2009.
+
+ dean [at] fourwalledcubicle [dot] com
+ www.fourwalledcubicle.com
+*/
+
+/*
+ Copyright 2009 Dean Camera (dean [at] fourwalledcubicle [dot] com)
+
+ Permission to use, copy, modify, and distribute this software
+ and its documentation for any purpose and without fee is hereby
+ granted, provided that the above copyright notice appear in all
+ copies and that both that the copyright notice and this
+ permission notice and warranty disclaimer appear in supporting
+ documentation, and that the name of the author not be used in
+ advertising or publicity pertaining to distribution of the
+ software without specific, written prior permission.
+
+ The author disclaim all warranties with regard to this
+ software, including all implied warranties of merchantability
+ and fitness. In no event shall the author be liable for any
+ special, indirect or consequential damages or any damages
+ whatsoever resulting from loss of use, data or profits, whether
+ in an action of contract, negligence or other tortious action,
+ arising out of or in connection with the use or performance of
+ this software.
+*/
+
+/** \file
+ *
+ * Header file for USBtoSerial.c.
+ */
+
+#ifndef _AVRISP_PROGRAMMER_H_
+#define _AVRISP_PROGRAMMER_H_
+
+ /* Includes: */
+ #include <avr/io.h>
+ #include <avr/wdt.h>
+ #include <avr/interrupt.h>
+
+ #include "Descriptors.h"
+ #include "RingBuff.h"
+
+ #include <LUFA/Version.h> // Library Version Information
+ #include <LUFA/Common/ButtLoadTag.h> // PROGMEM tags readable by the ButtLoad project
+ #include <LUFA/Drivers/USB/USB.h> // USB Functionality
+ #include <LUFA/Drivers/AT90USBXXX/SPI.h> // SPI driver
+ #include <LUFA/Drivers/Board/LEDs.h> // LEDs driver
+ #include <LUFA/Scheduler/Scheduler.h> // Simple scheduler for task management
+
+ /* Macros: */
+ /** CDC Class specific request to get the current virtual serial port configuration settings. */
+ #define REQ_GetLineEncoding 0x21
+
+ /** CDC Class specific request to set the current virtual serial port configuration settings. */
+ #define REQ_SetLineEncoding 0x20
+
+ /** CDC Class specific request to set the current virtual serial port handshake line states. */
+ #define REQ_SetControlLineState 0x22
+
+ /** Notification type constant for a change in the virtual serial port handshake line states, for
+ * use with a USB_Notification_Header_t notification structure when sent to the host via the CDC
+ * notification endpoint.
+ */
+ #define NOTIF_SerialState 0x20
+
+ /** Mask for the DTR handshake line for use with the REQ_SetControlLineState class specific request
+ * from the host, to indicate that the DTR line state should be high.
+ */
+ #define CONTROL_LINE_OUT_DTR (1 << 0)
+
+ /** Mask for the RTS handshake line for use with the REQ_SetControlLineState class specific request
+ * from the host, to indicate that theRTS line state should be high.
+ */
+ #define CONTROL_LINE_OUT_RTS (1 << 1)
+
+ /** Mask for the DCD handshake line for use with the a NOTIF_SerialState class specific notification
+ * from the device to the host, to indicate that the DCD line state is currently high.
+ */
+ #define CONTROL_LINE_IN_DCD (1 << 0)
+
+ /** Mask for the DSR handshake line for use with the a NOTIF_SerialState class specific notification
+ * from the device to the host, to indicate that the DSR line state is currently high.
+ */
+ #define CONTROL_LINE_IN_DSR (1 << 1)
+
+ /** Mask for the BREAK handshake line for use with the a NOTIF_SerialState class specific notification
+ * from the device to the host, to indicate that the BREAK line state is currently high.
+ */
+ #define CONTROL_LINE_IN_BREAK (1 << 2)
+
+ /** Mask for the RING handshake line for use with the a NOTIF_SerialState class specific notification
+ * from the device to the host, to indicate that the RING line state is currently high.
+ */
+ #define CONTROL_LINE_IN_RING (1 << 3)
+
+ /** Mask for use with the a NOTIF_SerialState class specific notification from the device to the host,
+ * to indicate that a framing error has ocurred on the virtual serial port.
+ */
+ #define CONTROL_LINE_IN_FRAMEERROR (1 << 4)
+
+ /** Mask for use with the a NOTIF_SerialState class specific notification from the device to the host,
+ * to indicate that a parity error has ocurred on the virtual serial port.
+ */
+ #define CONTROL_LINE_IN_PARITYERROR (1 << 5)
+
+ /** Mask for use with the a NOTIF_SerialState class specific notification from the device to the host,
+ * to indicate that a data overrun error has ocurred on the virtual serial port.
+ */
+ #define CONTROL_LINE_IN_OVERRUNERROR (1 << 6)
+
+ /* Event Handlers: */
+ /** Indicates that this module will catch the USB_Connect event when thrown by the library. */
+ HANDLES_EVENT(USB_Connect);
+
+ /** Indicates that this module will catch the USB_Disconnect event when thrown by the library. */
+ HANDLES_EVENT(USB_Disconnect);
+
+ /** Indicates that this module will catch the USB_ConfigurationChanged event when thrown by the library. */
+ HANDLES_EVENT(USB_ConfigurationChanged);
+
+ /** Indicates that this module will catch the USB_UnhandledControlPacket event when thrown by the library. */
+ HANDLES_EVENT(USB_UnhandledControlPacket);
+
+ /* Type Defines: */
+ /** Type define for the virtual serial port line encoding settings, for storing the current USART configuration
+ * as set by the host via a class specific request.
+ */
+ typedef struct
+ {
+ uint32_t BaudRateBPS; /**< Baud rate of the virtual serial port, in bits per second */
+ uint8_t CharFormat; /**< Character format of the virtual serial port, a value from the
+ * CDCDevice_CDC_LineCodingFormats_t enum
+ */
+ uint8_t ParityType; /**< Parity setting of the virtual serial port, a value from the
+ * CDCDevice_LineCodingParity_t enum
+ */
+ uint8_t DataBits; /**< Bits of data per charater of the virtual serial port */
+ } CDC_Line_Coding_t;
+
+ /** Type define for a CDC notification, sent to the host via the CDC notification endpoint to indicate a
+ * change in the device state asynchronously.
+ */
+ typedef struct
+ {
+ uint8_t NotificationType; /**< Notification type, a mask of REQDIR_*, REQTYPE_* and REQREC_* constants
+ * from the library StdRequestType.h header
+ */
+ uint8_t Notification; /**< Notification value, a NOTIF_* constant */
+ uint16_t wValue; /**< Notification wValue, notification-specific */
+ uint16_t wIndex; /**< Notification wIndex, notification-specific */
+ uint16_t wLength; /**< Notification wLength, notification-specific */
+ } USB_Notification_Header_t;
+
+ /* Enums: */
+ /** Enum for the possible line encoding formats of a virtual serial port. */
+ enum CDCDevice_CDC_LineCodingFormats_t
+ {
+ OneStopBit = 0, /**< Each frame contains one stop bit */
+ OneAndAHalfStopBits = 1, /**< Each frame contains one and a half stop bits */
+ TwoStopBits = 2, /**< Each frame contains two stop bits */
+ };
+
+ /** Enum for the possible line encoding parity settings of a virtual serial port. */
+ enum CDCDevice_LineCodingParity_t
+ {
+ Parity_None = 0, /**< No parity bit mode on each frame */
+ Parity_Odd = 1, /**< Odd parity bit mode on each frame */
+ Parity_Even = 2, /**< Even parity bit mode on each frame */
+ Parity_Mark = 3, /**< Mark parity bit mode on each frame */
+ Parity_Space = 4, /**< Space parity bit mode on each frame */
+ };
+
+ /** Enum for the possible status codes for passing to the UpdateStatus() function. */
+ enum USBtoSerial_StatusCodes_t
+ {
+ Status_USBNotReady = 0, /**< USB is not ready (disconnected from a USB host) */
+ Status_USBEnumerating = 1, /**< USB interface is enumerating */
+ Status_USBReady = 2, /**< USB interface is connected and ready */
+ };
+
+ /* Tasks: */
+ TASK(CDC_Task);
+
+ /* Function Prototypes: */
+ void ReconfigureSPI(void);
+ void UpdateStatus(uint8_t CurrentStatus);
+ void processHostSPIRequest(void);
+ void delay_ms(uint8_t dly);
+
+#endif
diff --git a/Projects/AVRISP_Programmer/AVRISP_Programmer.txt b/Projects/AVRISP_Programmer/AVRISP_Programmer.txt
new file mode 100644
index 000000000..1872cfb5e
--- /dev/null
+++ b/Projects/AVRISP_Programmer/AVRISP_Programmer.txt
@@ -0,0 +1,89 @@
+/** \file
+ *
+ * This file contains special DoxyGen information for the generation of the main page and other special
+ * documentation pages. It is not a project source file.
+ */
+
+/** \mainpage AVRISP_Programmer
+ *
+ * Communications Device Class demonstration application.
+ * This gives a simple reference application for implementing
+ * a USB to Serial converter using the CDC class. Data communicated
+ * over the USB Virtual Serial Port according to Atmel's AVR910
+ * protocol is used to program AVR MCUs that are
+ * "In-System Programmable via SPI Port".
+ *
+ * After running this firmware for the first time on a new computer,
+ * you will need to supply the .INF file located in this demo
+ * project's directory as the device's driver when running under
+ * Windows. This will enable Windows to use its inbuilt CDC drivers,
+ * negating the need for custom drivers for the device. Other
+ * Operating Systems should automatically use their own inbuilt
+ * CDC-ACM drivers.
+ *
+ * Usage:
+ * avrdude -vv -F -P COM7 -c avr910 -p t261
+ * Note -F flag which overrides signature check and enables programming
+ * of any "In-System Programmable via SPI Port" AVR MCU. Part number,
+ * t261, should be set to your target device.
+ * avrdude -vv -F -P COM7 -c avr910 -p t261 -U flash:w:PROG.hex
+ * PROG.hex is the hex file to program your t261 AVR with
+ * avrdude -vv -F -P COM7 -b 115200 -c avr910 -p t261 -U flash:w:test.hex
+ * The -b 115200 sets the SPI clock to 62.5kHz from the default 125kHz and may
+ * work when the default programming speed fails.
+ * AVROSP.exe -dATtiny261 -cCOM7 -rf
+ * AVRosp is the Open Source AVR ISP Programming Software available from Atmel.com
+ *
+ * Note: on Linux systems, COM7 should be replaced with someting like /dev/ttyACM0
+ * You can determine this value by running dmesg after plugging in the device
+ * Note: you must RESET the programmer after each use (AVRdude session).
+ *
+ * Note: If you experience errors with older devices, try changing DELAY_LONG
+ * to a larger value, such as 0xFF in AVRISP_Programmer.c
+ *
+ * MISO, MOSI, and SCK are connected directly from the AVRopendous board
+ * to the pin of the same functionality on the target. RESET pin on the target
+ * can be connected either to SS (PB0), or PC2. Do not have any other pins
+ * connected - especially HWB pin, to avoid unintentional behaviour.
+ *
+ * AVR910 functionality was overlayed on USBtoSerial functionality.
+ * Keep this in mind when looking over the code.
+ * Default target speed is 125kHz and corresponds to 19200 baud, which
+ * is the default setting for AVRdude.
+ *
+ * Changing "Baud-Rate" will change the SPI speed. Defualt SPI clock speed
+ * is 8Mhz / 4 = 2MHz. 8Mhz is the device clock speed. This is the setting at
+ * 9600 baud. The following is a table of baud-rate vs. SPI Speed that will result
+ * 9600 = 2Mhz
+ * 14400 = 1MHz
+ * 19200 = 125kHz (AVRdude Default)
+ * 38400 = 250kHz
+ * 57600 = 500kHz
+ * 115200 = 62.5kHz
+ *
+ *
+ *
+ *
+ * <table>
+ * <tr>
+ * <td><b>USB Mode:</b></td>
+ * <td>Device</td>
+ * </tr>
+ * <tr>
+ * <td><b>USB Class:</b></td>
+ * <td>Communications Device Class (CDC)</td>
+ * </tr>
+ * <tr>
+ * <td><b>USB Subclass:</b></td>
+ * <td>Abstract Control Model (ACM)</td>
+ * </tr>
+ * <tr>
+ * <td><b>Relevant Standards:</b></td>
+ * <td>USBIF CDC Class Standard</td>
+ * </tr>
+ * <tr>
+ * <td><b>Usable Speeds:</b></td>
+ * <td>Full Speed Mode</td>
+ * </tr>
+ * </table>
+ */
diff --git a/Projects/AVRISP_Programmer/AVRISP_Programmer_Picture.jpg b/Projects/AVRISP_Programmer/AVRISP_Programmer_Picture.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..87ec3d43ee0df3937060894b2773b04fb36aa91e
GIT binary patch
literal 74610
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
NvT{0>@fpVdHvvW^NhkmS
literal 0
HcmV?d00001
diff --git a/Projects/AVRISP_Programmer/Descriptors.c b/Projects/AVRISP_Programmer/Descriptors.c
new file mode 100644
index 000000000..5f3ffca08
--- /dev/null
+++ b/Projects/AVRISP_Programmer/Descriptors.c
@@ -0,0 +1,263 @@
+/*
+ LUFA Library
+ Copyright (C) Dean Camera, 2009.
+
+ dean [at] fourwalledcubicle [dot] com
+ www.fourwalledcubicle.com
+*/
+
+/*
+ Copyright 2009 Dean Camera (dean [at] fourwalledcubicle [dot] com)
+
+ Permission to use, copy, modify, and distribute this software
+ and its documentation for any purpose and without fee is hereby
+ granted, provided that the above copyright notice appear in all
+ copies and that both that the copyright notice and this
+ permission notice and warranty disclaimer appear in supporting
+ documentation, and that the name of the author not be used in
+ advertising or publicity pertaining to distribution of the
+ software without specific, written prior permission.
+
+ The author disclaim all warranties with regard to this
+ software, including all implied warranties of merchantability
+ and fitness. In no event shall the author be liable for any
+ special, indirect or consequential damages or any damages
+ whatsoever resulting from loss of use, data or profits, whether
+ in an action of contract, negligence or other tortious action,
+ arising out of or in connection with the use or performance of
+ this software.
+*/
+
+/** \file
+ *
+ * USB Device Descriptors, for library use when in USB device mode. Descriptors are special
+ * computer-readable structures which the host requests upon device enumeration, to determine
+ * the device's capabilities and functions.
+ */
+
+#include "Descriptors.h"
+
+/** Device descriptor structure. This descriptor, located in FLASH memory, describes the overall
+ * device characteristics, including the supported USB version, control endpoint size and the
+ * number of device configurations. The descriptor is read out by the USB host when the enumeration
+ * process begins.
+ */
+USB_Descriptor_Device_t PROGMEM DeviceDescriptor =
+{
+ Header: {Size: sizeof(USB_Descriptor_Device_t), Type: DTYPE_Device},
+
+ USBSpecification: VERSION_BCD(01.10),
+ Class: 0x02,
+ SubClass: 0x00,
+ Protocol: 0x00,
+
+ Endpoint0Size: 8,
+
+ VendorID: 0x03EB,
+ ProductID: 0x204F,
+ ReleaseNumber: 0x0000,
+
+ ManufacturerStrIndex: 0x01,
+ ProductStrIndex: 0x02,
+ SerialNumStrIndex: NO_DESCRIPTOR,
+
+ NumberOfConfigurations: 1
+};
+
+/** Configuration descriptor structure. This descriptor, located in FLASH memory, describes the usage
+ * of the device in one of its supported configurations, including information about any device interfaces
+ * and endpoints. The descriptor is read out by the USB host during the enumeration process when selecting
+ * a configuration so that the host may correctly communicate with the USB device.
+ */
+USB_Descriptor_Configuration_t PROGMEM ConfigurationDescriptor =
+{
+ Config:
+ {
+ Header: {Size: sizeof(USB_Descriptor_Configuration_Header_t), Type: DTYPE_Configuration},
+
+ TotalConfigurationSize: sizeof(USB_Descriptor_Configuration_t),
+ TotalInterfaces: 2,
+
+ ConfigurationNumber: 1,
+ ConfigurationStrIndex: NO_DESCRIPTOR,
+
+ ConfigAttributes: (USB_CONFIG_ATTR_BUSPOWERED | USB_CONFIG_ATTR_SELFPOWERED),
+
+ MaxPowerConsumption: USB_CONFIG_POWER_MA(100)
+ },
+
+ CCI_Interface:
+ {
+ Header: {Size: sizeof(USB_Descriptor_Interface_t), Type: DTYPE_Interface},
+
+ InterfaceNumber: 0,
+ AlternateSetting: 0,
+
+ TotalEndpoints: 1,
+
+ Class: 0x02,
+ SubClass: 0x02,
+ Protocol: 0x01,
+
+ InterfaceStrIndex: NO_DESCRIPTOR
+ },
+
+ CDC_Functional_IntHeader:
+ {
+ Header: {Size: sizeof(CDC_FUNCTIONAL_DESCRIPTOR(2)), Type: 0x24},
+ SubType: 0x00,
+
+ Data: {0x01, 0x10}
+ },
+
+ CDC_Functional_CallManagement:
+ {
+ Header: {Size: sizeof(CDC_FUNCTIONAL_DESCRIPTOR(2)), Type: 0x24},
+ SubType: 0x01,
+
+ Data: {0x03, 0x01}
+ },
+
+ CDC_Functional_AbstractControlManagement:
+ {
+ Header: {Size: sizeof(CDC_FUNCTIONAL_DESCRIPTOR(1)), Type: 0x24},
+ SubType: 0x02,
+
+ Data: {0x06}
+ },
+
+ CDC_Functional_Union:
+ {
+ Header: {Size: sizeof(CDC_FUNCTIONAL_DESCRIPTOR(2)), Type: 0x24},
+ SubType: 0x06,
+
+ Data: {0x00, 0x01}
+ },
+
+ ManagementEndpoint:
+ {
+ Header: {Size: sizeof(USB_Descriptor_Endpoint_t), Type: DTYPE_Endpoint},
+
+ EndpointAddress: (ENDPOINT_DESCRIPTOR_DIR_IN | CDC_NOTIFICATION_EPNUM),
+ Attributes: EP_TYPE_INTERRUPT,
+ EndpointSize: CDC_NOTIFICATION_EPSIZE,
+ PollingIntervalMS: 0xFF
+ },
+
+ DCI_Interface:
+ {
+ Header: {Size: sizeof(USB_Descriptor_Interface_t), Type: DTYPE_Interface},
+
+ InterfaceNumber: 1,
+ AlternateSetting: 0,
+
+ TotalEndpoints: 2,
+
+ Class: 0x0A,
+ SubClass: 0x00,
+ Protocol: 0x00,
+
+ InterfaceStrIndex: NO_DESCRIPTOR
+ },
+
+ DataOutEndpoint:
+ {
+ Header: {Size: sizeof(USB_Descriptor_Endpoint_t), Type: DTYPE_Endpoint},
+
+ EndpointAddress: (ENDPOINT_DESCRIPTOR_DIR_OUT | CDC_RX_EPNUM),
+ Attributes: EP_TYPE_BULK,
+ EndpointSize: CDC_TXRX_EPSIZE,
+ PollingIntervalMS: 0x00
+ },
+
+ DataInEndpoint:
+ {
+ Header: {Size: sizeof(USB_Descriptor_Endpoint_t), Type: DTYPE_Endpoint},
+
+ EndpointAddress: (ENDPOINT_DESCRIPTOR_DIR_IN | CDC_TX_EPNUM),
+ Attributes: EP_TYPE_BULK,
+ EndpointSize: CDC_TXRX_EPSIZE,
+ PollingIntervalMS: 0x00
+ }
+};
+
+/** Language descriptor structure. This descriptor, located in FLASH memory, is returned when the host requests
+ * the string descriptor with index 0 (the first index). It is actually an array of 16-bit integers, which indicate
+ * via the language ID table available at USB.org what languages the device supports for its string descriptors.
+ */
+USB_Descriptor_String_t PROGMEM LanguageString =
+{
+ Header: {Size: USB_STRING_LEN(1), Type: DTYPE_String},
+
+ UnicodeString: {LANGUAGE_ID_ENG}
+};
+
+/** Manufacturer descriptor string. This is a Unicode string containing the manufacturer's details in human readable
+ * form, and is read out upon request by the host when the appropriate string ID is requested, listed in the Device
+ * Descriptor.
+ */
+USB_Descriptor_String_t PROGMEM ManufacturerString =
+{
+ Header: {Size: USB_STRING_LEN(19), Type: DTYPE_String},
+
+ UnicodeString: L"www.AVRopendous.org"
+};
+
+/** Product descriptor string. This is a Unicode string containing the product's details in human readable form,
+ * and is read out upon request by the host when the appropriate string ID is requested, listed in the Device
+ * Descriptor.
+ */
+USB_Descriptor_String_t PROGMEM ProductString =
+{
+ Header: {Size: USB_STRING_LEN(29), Type: DTYPE_String},
+
+ UnicodeString: L"LUFA-Based AVR ISP Programmer"
+};
+
+/** This function is called by the library when in device mode, and must be overridden (see StdDescriptors.h
+ * documentation) by the application code so that the address and size of a requested descriptor can be given
+ * to the USB library. When the device recieves a Get Descriptor request on the control endpoint, this function
+ * is called so that the descriptor details can be passed back and the appropriate descriptor sent back to the
+ * USB host.
+ */
+uint16_t USB_GetDescriptor(const uint16_t wValue, const uint8_t wIndex, void** const DescriptorAddress)
+{
+ const uint8_t DescriptorType = (wValue >> 8);
+ const uint8_t DescriptorNumber = (wValue & 0xFF);
+
+ void* Address = NULL;
+ uint16_t Size = NO_DESCRIPTOR;
+
+ switch (DescriptorType)
+ {
+ case DTYPE_Device:
+ Address = DESCRIPTOR_ADDRESS(DeviceDescriptor);
+ Size = sizeof(USB_Descriptor_Device_t);
+ break;
+ case DTYPE_Configuration:
+ Address = DESCRIPTOR_ADDRESS(ConfigurationDescriptor);
+ Size = sizeof(USB_Descriptor_Configuration_t);
+ break;
+ case DTYPE_String:
+ switch (DescriptorNumber)
+ {
+ case 0x00:
+ Address = DESCRIPTOR_ADDRESS(LanguageString);
+ Size = pgm_read_byte(&LanguageString.Header.Size);
+ break;
+ case 0x01:
+ Address = DESCRIPTOR_ADDRESS(ManufacturerString);
+ Size = pgm_read_byte(&ManufacturerString.Header.Size);
+ break;
+ case 0x02:
+ Address = DESCRIPTOR_ADDRESS(ProductString);
+ Size = pgm_read_byte(&ProductString.Header.Size);
+ break;
+ }
+
+ break;
+ }
+
+ *DescriptorAddress = Address;
+ return Size;
+}
diff --git a/Projects/AVRISP_Programmer/Descriptors.h b/Projects/AVRISP_Programmer/Descriptors.h
new file mode 100644
index 000000000..bec5e40d4
--- /dev/null
+++ b/Projects/AVRISP_Programmer/Descriptors.h
@@ -0,0 +1,98 @@
+/*
+ LUFA Library
+ Copyright (C) Dean Camera, 2009.
+
+ dean [at] fourwalledcubicle [dot] com
+ www.fourwalledcubicle.com
+*/
+
+/*
+ Copyright 2009 Dean Camera (dean [at] fourwalledcubicle [dot] com)
+
+ Permission to use, copy, modify, and distribute this software
+ and its documentation for any purpose and without fee is hereby
+ granted, provided that the above copyright notice appear in all
+ copies and that both that the copyright notice and this
+ permission notice and warranty disclaimer appear in supporting
+ documentation, and that the name of the author not be used in
+ advertising or publicity pertaining to distribution of the
+ software without specific, written prior permission.
+
+ The author disclaim all warranties with regard to this
+ software, including all implied warranties of merchantability
+ and fitness. In no event shall the author be liable for any
+ special, indirect or consequential damages or any damages
+ whatsoever resulting from loss of use, data or profits, whether
+ in an action of contract, negligence or other tortious action,
+ arising out of or in connection with the use or performance of
+ this software.
+*/
+
+/** \file
+ *
+ * Header file for Descriptors.c.
+ */
+
+#ifndef _DESCRIPTORS_H_
+#define _DESCRIPTORS_H_
+
+ /* Includes: */
+ #include <LUFA/Drivers/USB/USB.h>
+
+ #include <avr/pgmspace.h>
+
+ /* Macros: */
+ /** Macro to define a CDC class-specific functional descriptor. CDC functional descriptors have a
+ * uniform structure but variable sized data payloads, thus cannot be represented accurately by
+ * a single typedef struct. A macro is used instead so that functional descriptors can be created
+ * easily by specifying the size of the payload. This allows sizeof() to work correctly.
+ *
+ * \param DataSize Size in bytes of the CDC functional descriptor's data payload
+ */
+ #define CDC_FUNCTIONAL_DESCRIPTOR(DataSize) \
+ struct \
+ { \
+ USB_Descriptor_Header_t Header; \
+ uint8_t SubType; \
+ uint8_t Data[DataSize]; \
+ }
+
+ /** Endpoint number of the CDC device-to-host notification IN endpoint. */
+ #define CDC_NOTIFICATION_EPNUM 2
+
+ /** Endpoint number of the CDC device-to-host data IN endpoint. */
+ #define CDC_TX_EPNUM 3
+
+ /** Endpoint number of the CDC host-to-device data OUT endpoint. */
+ #define CDC_RX_EPNUM 4
+
+ /** Size in bytes of the CDC device-to-host notification IN endpoint. */
+ #define CDC_NOTIFICATION_EPSIZE 8
+
+ /** Size in bytes of the CDC data IN and OUT endpoints. */
+ #define CDC_TXRX_EPSIZE 16
+
+ /* Type Defines: */
+ /** Type define for the device configuration descriptor structure. This must be defined in the
+ * application code, as the configuration descriptor contains several sub-descriptors which
+ * vary between devices, and which describe the device's usage to the host.
+ */
+ typedef struct
+ {
+ USB_Descriptor_Configuration_Header_t Config;
+ USB_Descriptor_Interface_t CCI_Interface;
+ CDC_FUNCTIONAL_DESCRIPTOR(2) CDC_Functional_IntHeader;
+ CDC_FUNCTIONAL_DESCRIPTOR(2) CDC_Functional_CallManagement;
+ CDC_FUNCTIONAL_DESCRIPTOR(1) CDC_Functional_AbstractControlManagement;
+ CDC_FUNCTIONAL_DESCRIPTOR(2) CDC_Functional_Union;
+ USB_Descriptor_Endpoint_t ManagementEndpoint;
+ USB_Descriptor_Interface_t DCI_Interface;
+ USB_Descriptor_Endpoint_t DataOutEndpoint;
+ USB_Descriptor_Endpoint_t DataInEndpoint;
+ } USB_Descriptor_Configuration_t;
+
+ /* Function Prototypes: */
+ uint16_t USB_GetDescriptor(const uint16_t wValue, const uint8_t wIndex, void** const DescriptorAddress)
+ ATTR_WARN_UNUSED_RESULT ATTR_NON_NULL_PTR_ARG(3);
+
+#endif
diff --git a/Projects/AVRISP_Programmer/Doxygen.conf b/Projects/AVRISP_Programmer/Doxygen.conf
new file mode 100644
index 000000000..1eb8c5432
--- /dev/null
+++ b/Projects/AVRISP_Programmer/Doxygen.conf
@@ -0,0 +1,1485 @@
+# Doxyfile 1.5.7.1
+
+# This file describes the settings to be used by the documentation system
+# doxygen (www.doxygen.org) for a project
+#
+# All text after a hash (#) is considered a comment and will be ignored
+# The format is:
+# TAG = value [value, ...]
+# For lists items can also be appended using:
+# TAG += value [value, ...]
+# Values that contain spaces should be placed between quotes (" ")
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+
+# This tag specifies the encoding used for all characters in the config file
+# that follow. The default is UTF-8 which is also the encoding used for all
+# text before the first occurrence of this tag. Doxygen uses libiconv (or the
+# iconv built into libc) for the transcoding. See
+# http://www.gnu.org/software/libiconv for the list of possible encodings.
+
+DOXYFILE_ENCODING = UTF-8
+
+# The PROJECT_NAME tag is a single word (or a sequence of words surrounded
+# by quotes) that should identify the project.
+
+PROJECT_NAME = "LUFA Library - USB to Serial Device Demo"
+
+# The PROJECT_NUMBER tag can be used to enter a project or revision number.
+# This could be handy for archiving the generated documentation or
+# if some version control system is used.
+
+PROJECT_NUMBER = 0.0.0
+
+# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute)
+# base path where the generated documentation will be put.
+# If a relative path is entered, it will be relative to the location
+# where doxygen was started. If left blank the current directory will be used.
+
+OUTPUT_DIRECTORY = ./Documentation/
+
+# If the CREATE_SUBDIRS tag is set to YES, then doxygen will create
+# 4096 sub-directories (in 2 levels) under the output directory of each output
+# format and will distribute the generated files over these directories.
+# Enabling this option can be useful when feeding doxygen a huge amount of
+# source files, where putting all generated files in the same directory would
+# otherwise cause performance problems for the file system.
+
+CREATE_SUBDIRS = YES
+
+# The OUTPUT_LANGUAGE tag is used to specify the language in which all
+# documentation generated by doxygen is written. Doxygen will use this
+# information to generate all constant output in the proper language.
+# The default language is English, other supported languages are:
+# Afrikaans, Arabic, Brazilian, Catalan, Chinese, Chinese-Traditional,
+# Croatian, Czech, Danish, Dutch, Farsi, Finnish, French, German, Greek,
+# Hungarian, Italian, Japanese, Japanese-en (Japanese with English messages),
+# Korean, Korean-en, Lithuanian, Norwegian, Macedonian, Persian, Polish,
+# Portuguese, Romanian, Russian, Serbian, Serbian-Cyrilic, Slovak, Slovene,
+# Spanish, Swedish, and Ukrainian.
+
+OUTPUT_LANGUAGE = English
+
+# If the BRIEF_MEMBER_DESC tag is set to YES (the default) Doxygen will
+# include brief member descriptions after the members that are listed in
+# the file and class documentation (similar to JavaDoc).
+# Set to NO to disable this.
+
+BRIEF_MEMBER_DESC = YES
+
+# If the REPEAT_BRIEF tag is set to YES (the default) Doxygen will prepend
+# the brief description of a member or function before the detailed description.
+# Note: if both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the
+# brief descriptions will be completely suppressed.
+
+REPEAT_BRIEF = YES
+
+# This tag implements a quasi-intelligent brief description abbreviator
+# that is used to form the text in various listings. Each string
+# in this list, if found as the leading text of the brief description, will be
+# stripped from the text and the result after processing the whole list, is
+# used as the annotated text. Otherwise, the brief description is used as-is.
+# If left blank, the following values are used ("$name" is automatically
+# replaced with the name of the entity): "The $name class" "The $name widget"
+# "The $name file" "is" "provides" "specifies" "contains"
+# "represents" "a" "an" "the"
+
+ABBREVIATE_BRIEF = "The $name class" \
+ "The $name widget" \
+ "The $name file" \
+ is \
+ provides \
+ specifies \
+ contains \
+ represents \
+ a \
+ an \
+ the
+
+# If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then
+# Doxygen will generate a detailed section even if there is only a brief
+# description.
+
+ALWAYS_DETAILED_SEC = NO
+
+# If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all
+# inherited members of a class in the documentation of that class as if those
+# members were ordinary class members. Constructors, destructors and assignment
+# operators of the base classes will not be shown.
+
+INLINE_INHERITED_MEMB = NO
+
+# If the FULL_PATH_NAMES tag is set to YES then Doxygen will prepend the full
+# path before files name in the file list and in the header files. If set
+# to NO the shortest path that makes the file name unique will be used.
+
+FULL_PATH_NAMES = YES
+
+# If the FULL_PATH_NAMES tag is set to YES then the STRIP_FROM_PATH tag
+# can be used to strip a user-defined part of the path. Stripping is
+# only done if one of the specified strings matches the left-hand part of
+# the path. The tag can be used to show relative paths in the file list.
+# If left blank the directory from which doxygen is run is used as the
+# path to strip.
+
+STRIP_FROM_PATH =
+
+# The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of
+# the path mentioned in the documentation of a class, which tells
+# the reader which header file to include in order to use a class.
+# If left blank only the name of the header file containing the class
+# definition is used. Otherwise one should specify the include paths that
+# are normally passed to the compiler using the -I flag.
+
+STRIP_FROM_INC_PATH =
+
+# If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter
+# (but less readable) file names. This can be useful is your file systems
+# doesn't support long names like on DOS, Mac, or CD-ROM.
+
+SHORT_NAMES = YES
+
+# If the JAVADOC_AUTOBRIEF tag is set to YES then Doxygen
+# will interpret the first line (until the first dot) of a JavaDoc-style
+# comment as the brief description. If set to NO, the JavaDoc
+# comments will behave just like regular Qt-style comments
+# (thus requiring an explicit @brief command for a brief description.)
+
+JAVADOC_AUTOBRIEF = NO
+
+# If the QT_AUTOBRIEF tag is set to YES then Doxygen will
+# interpret the first line (until the first dot) of a Qt-style
+# comment as the brief description. If set to NO, the comments
+# will behave just like regular Qt-style comments (thus requiring
+# an explicit \brief command for a brief description.)
+
+QT_AUTOBRIEF = NO
+
+# The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make Doxygen
+# treat a multi-line C++ special comment block (i.e. a block of //! or ///
+# comments) as a brief description. This used to be the default behaviour.
+# The new default is to treat a multi-line C++ comment block as a detailed
+# description. Set this tag to YES if you prefer the old behaviour instead.
+
+MULTILINE_CPP_IS_BRIEF = NO
+
+# If the INHERIT_DOCS tag is set to YES (the default) then an undocumented
+# member inherits the documentation from any documented member that it
+# re-implements.
+
+INHERIT_DOCS = YES
+
+# If the SEPARATE_MEMBER_PAGES tag is set to YES, then doxygen will produce
+# a new page for each member. If set to NO, the documentation of a member will
+# be part of the file/class/namespace that contains it.
+
+SEPARATE_MEMBER_PAGES = NO
+
+# The TAB_SIZE tag can be used to set the number of spaces in a tab.
+# Doxygen uses this value to replace tabs by spaces in code fragments.
+
+TAB_SIZE = 4
+
+# This tag can be used to specify a number of aliases that acts
+# as commands in the documentation. An alias has the form "name=value".
+# For example adding "sideeffect=\par Side Effects:\n" will allow you to
+# put the command \sideeffect (or @sideeffect) in the documentation, which
+# will result in a user-defined paragraph with heading "Side Effects:".
+# You can put \n's in the value part of an alias to insert newlines.
+
+ALIASES =
+
+# Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C
+# sources only. Doxygen will then generate output that is more tailored for C.
+# For instance, some of the names that are used will be different. The list
+# of all members will be omitted, etc.
+
+OPTIMIZE_OUTPUT_FOR_C = YES
+
+# Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java
+# sources only. Doxygen will then generate output that is more tailored for
+# Java. For instance, namespaces will be presented as packages, qualified
+# scopes will look different, etc.
+
+OPTIMIZE_OUTPUT_JAVA = NO
+
+# Set the OPTIMIZE_FOR_FORTRAN tag to YES if your project consists of Fortran
+# sources only. Doxygen will then generate output that is more tailored for
+# Fortran.
+
+OPTIMIZE_FOR_FORTRAN = NO
+
+# Set the OPTIMIZE_OUTPUT_VHDL tag to YES if your project consists of VHDL
+# sources. Doxygen will then generate output that is tailored for
+# VHDL.
+
+OPTIMIZE_OUTPUT_VHDL = NO
+
+# If you use STL classes (i.e. std::string, std::vector, etc.) but do not want
+# to include (a tag file for) the STL sources as input, then you should
+# set this tag to YES in order to let doxygen match functions declarations and
+# definitions whose arguments contain STL classes (e.g. func(std::string); v.s.
+# func(std::string) {}). This also make the inheritance and collaboration
+# diagrams that involve STL classes more complete and accurate.
+
+BUILTIN_STL_SUPPORT = NO
+
+# If you use Microsoft's C++/CLI language, you should set this option to YES to
+# enable parsing support.
+
+CPP_CLI_SUPPORT = NO
+
+# Set the SIP_SUPPORT tag to YES if your project consists of sip sources only.
+# Doxygen will parse them like normal C++ but will assume all classes use public
+# instead of private inheritance when no explicit protection keyword is present.
+
+SIP_SUPPORT = NO
+
+# For Microsoft's IDL there are propget and propput attributes to indicate getter
+# and setter methods for a property. Setting this option to YES (the default)
+# will make doxygen to replace the get and set methods by a property in the
+# documentation. This will only work if the methods are indeed getting or
+# setting a simple type. If this is not the case, or you want to show the
+# methods anyway, you should set this option to NO.
+
+IDL_PROPERTY_SUPPORT = YES
+
+# If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC
+# tag is set to YES, then doxygen will reuse the documentation of the first
+# member in the group (if any) for the other members of the group. By default
+# all members of a group must be documented explicitly.
+
+DISTRIBUTE_GROUP_DOC = NO
+
+# Set the SUBGROUPING tag to YES (the default) to allow class member groups of
+# the same type (for instance a group of public functions) to be put as a
+# subgroup of that type (e.g. under the Public Functions section). Set it to
+# NO to prevent subgrouping. Alternatively, this can be done per class using
+# the \nosubgrouping command.
+
+SUBGROUPING = YES
+
+# When TYPEDEF_HIDES_STRUCT is enabled, a typedef of a struct, union, or enum
+# is documented as struct, union, or enum with the name of the typedef. So
+# typedef struct TypeS {} TypeT, will appear in the documentation as a struct
+# with name TypeT. When disabled the typedef will appear as a member of a file,
+# namespace, or class. And the struct will be named TypeS. This can typically
+# be useful for C code in case the coding convention dictates that all compound
+# types are typedef'ed and only the typedef is referenced, never the tag name.
+
+TYPEDEF_HIDES_STRUCT = NO
+
+# The SYMBOL_CACHE_SIZE determines the size of the internal cache use to
+# determine which symbols to keep in memory and which to flush to disk.
+# When the cache is full, less often used symbols will be written to disk.
+# For small to medium size projects (<1000 input files) the default value is
+# probably good enough. For larger projects a too small cache size can cause
+# doxygen to be busy swapping symbols to and from disk most of the time
+# causing a significant performance penality.
+# If the system has enough physical memory increasing the cache will improve the
+# performance by keeping more symbols in memory. Note that the value works on
+# a logarithmic scale so increasing the size by one will rougly double the
+# memory usage. The cache size is given by this formula:
+# 2^(16+SYMBOL_CACHE_SIZE). The valid range is 0..9, the default is 0,
+# corresponding to a cache size of 2^16 = 65536 symbols
+
+SYMBOL_CACHE_SIZE = 0
+
+#---------------------------------------------------------------------------
+# Build related configuration options
+#---------------------------------------------------------------------------
+
+# If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in
+# documentation are documented, even if no documentation was available.
+# Private class members and static file members will be hidden unless
+# the EXTRACT_PRIVATE and EXTRACT_STATIC tags are set to YES
+
+EXTRACT_ALL = YES
+
+# If the EXTRACT_PRIVATE tag is set to YES all private members of a class
+# will be included in the documentation.
+
+EXTRACT_PRIVATE = YES
+
+# If the EXTRACT_STATIC tag is set to YES all static members of a file
+# will be included in the documentation.
+
+EXTRACT_STATIC = YES
+
+# If the EXTRACT_LOCAL_CLASSES tag is set to YES classes (and structs)
+# defined locally in source files will be included in the documentation.
+# If set to NO only classes defined in header files are included.
+
+EXTRACT_LOCAL_CLASSES = YES
+
+# This flag is only useful for Objective-C code. When set to YES local
+# methods, which are defined in the implementation section but not in
+# the interface are included in the documentation.
+# If set to NO (the default) only methods in the interface are included.
+
+EXTRACT_LOCAL_METHODS = NO
+
+# If this flag is set to YES, the members of anonymous namespaces will be
+# extracted and appear in the documentation as a namespace called
+# 'anonymous_namespace{file}', where file will be replaced with the base
+# name of the file that contains the anonymous namespace. By default
+# anonymous namespace are hidden.
+
+EXTRACT_ANON_NSPACES = NO
+
+# If the HIDE_UNDOC_MEMBERS tag is set to YES, Doxygen will hide all
+# undocumented members of documented classes, files or namespaces.
+# If set to NO (the default) these members will be included in the
+# various overviews, but no documentation section is generated.
+# This option has no effect if EXTRACT_ALL is enabled.
+
+HIDE_UNDOC_MEMBERS = NO
+
+# If the HIDE_UNDOC_CLASSES tag is set to YES, Doxygen will hide all
+# undocumented classes that are normally visible in the class hierarchy.
+# If set to NO (the default) these classes will be included in the various
+# overviews. This option has no effect if EXTRACT_ALL is enabled.
+
+HIDE_UNDOC_CLASSES = NO
+
+# If the HIDE_FRIEND_COMPOUNDS tag is set to YES, Doxygen will hide all
+# friend (class|struct|union) declarations.
+# If set to NO (the default) these declarations will be included in the
+# documentation.
+
+HIDE_FRIEND_COMPOUNDS = NO
+
+# If the HIDE_IN_BODY_DOCS tag is set to YES, Doxygen will hide any
+# documentation blocks found inside the body of a function.
+# If set to NO (the default) these blocks will be appended to the
+# function's detailed documentation block.
+
+HIDE_IN_BODY_DOCS = NO
+
+# The INTERNAL_DOCS tag determines if documentation
+# that is typed after a \internal command is included. If the tag is set
+# to NO (the default) then the documentation will be excluded.
+# Set it to YES to include the internal documentation.
+
+INTERNAL_DOCS = NO
+
+# If the CASE_SENSE_NAMES tag is set to NO then Doxygen will only generate
+# file names in lower-case letters. If set to YES upper-case letters are also
+# allowed. This is useful if you have classes or files whose names only differ
+# in case and if your file system supports case sensitive file names. Windows
+# and Mac users are advised to set this option to NO.
+
+CASE_SENSE_NAMES = NO
+
+# If the HIDE_SCOPE_NAMES tag is set to NO (the default) then Doxygen
+# will show members with their full class and namespace scopes in the
+# documentation. If set to YES the scope will be hidden.
+
+HIDE_SCOPE_NAMES = NO
+
+# If the SHOW_INCLUDE_FILES tag is set to YES (the default) then Doxygen
+# will put a list of the files that are included by a file in the documentation
+# of that file.
+
+SHOW_INCLUDE_FILES = YES
+
+# If the INLINE_INFO tag is set to YES (the default) then a tag [inline]
+# is inserted in the documentation for inline members.
+
+INLINE_INFO = YES
+
+# If the SORT_MEMBER_DOCS tag is set to YES (the default) then doxygen
+# will sort the (detailed) documentation of file and class members
+# alphabetically by member name. If set to NO the members will appear in
+# declaration order.
+
+SORT_MEMBER_DOCS = YES
+
+# If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the
+# brief documentation of file, namespace and class members alphabetically
+# by member name. If set to NO (the default) the members will appear in
+# declaration order.
+
+SORT_BRIEF_DOCS = NO
+
+# If the SORT_GROUP_NAMES tag is set to YES then doxygen will sort the
+# hierarchy of group names into alphabetical order. If set to NO (the default)
+# the group names will appear in their defined order.
+
+SORT_GROUP_NAMES = NO
+
+# If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be
+# sorted by fully-qualified names, including namespaces. If set to
+# NO (the default), the class list will be sorted only by class name,
+# not including the namespace part.
+# Note: This option is not very useful if HIDE_SCOPE_NAMES is set to YES.
+# Note: This option applies only to the class list, not to the
+# alphabetical list.
+
+SORT_BY_SCOPE_NAME = NO
+
+# The GENERATE_TODOLIST tag can be used to enable (YES) or
+# disable (NO) the todo list. This list is created by putting \todo
+# commands in the documentation.
+
+GENERATE_TODOLIST = NO
+
+# The GENERATE_TESTLIST tag can be used to enable (YES) or
+# disable (NO) the test list. This list is created by putting \test
+# commands in the documentation.
+
+GENERATE_TESTLIST = NO
+
+# The GENERATE_BUGLIST tag can be used to enable (YES) or
+# disable (NO) the bug list. This list is created by putting \bug
+# commands in the documentation.
+
+GENERATE_BUGLIST = NO
+
+# The GENERATE_DEPRECATEDLIST tag can be used to enable (YES) or
+# disable (NO) the deprecated list. This list is created by putting
+# \deprecated commands in the documentation.
+
+GENERATE_DEPRECATEDLIST= YES
+
+# The ENABLED_SECTIONS tag can be used to enable conditional
+# documentation sections, marked by \if sectionname ... \endif.
+
+ENABLED_SECTIONS =
+
+# The MAX_INITIALIZER_LINES tag determines the maximum number of lines
+# the initial value of a variable or define consists of for it to appear in
+# the documentation. If the initializer consists of more lines than specified
+# here it will be hidden. Use a value of 0 to hide initializers completely.
+# The appearance of the initializer of individual variables and defines in the
+# documentation can be controlled using \showinitializer or \hideinitializer
+# command in the documentation regardless of this setting.
+
+MAX_INITIALIZER_LINES = 30
+
+# Set the SHOW_USED_FILES tag to NO to disable the list of files generated
+# at the bottom of the documentation of classes and structs. If set to YES the
+# list will mention the files that were used to generate the documentation.
+
+SHOW_USED_FILES = YES
+
+# If the sources in your project are distributed over multiple directories
+# then setting the SHOW_DIRECTORIES tag to YES will show the directory hierarchy
+# in the documentation. The default is NO.
+
+SHOW_DIRECTORIES = YES
+
+# Set the SHOW_FILES tag to NO to disable the generation of the Files page.
+# This will remove the Files entry from the Quick Index and from the
+# Folder Tree View (if specified). The default is YES.
+
+SHOW_FILES = YES
+
+# Set the SHOW_NAMESPACES tag to NO to disable the generation of the
+# Namespaces page. This will remove the Namespaces entry from the Quick Index
+# and from the Folder Tree View (if specified). The default is YES.
+
+SHOW_NAMESPACES = YES
+
+# The FILE_VERSION_FILTER tag can be used to specify a program or script that
+# doxygen should invoke to get the current version for each file (typically from
+# the version control system). Doxygen will invoke the program by executing (via
+# popen()) the command <command> <input-file>, where <command> is the value of
+# the FILE_VERSION_FILTER tag, and <input-file> is the name of an input file
+# provided by doxygen. Whatever the program writes to standard output
+# is used as the file version. See the manual for examples.
+
+FILE_VERSION_FILTER =
+
+# The LAYOUT_FILE tag can be used to specify a layout file which will be parsed by
+# doxygen. The layout file controls the global structure of the generated output files
+# in an output format independent way. The create the layout file that represents
+# doxygen's defaults, run doxygen with the -l option. You can optionally specify a
+# file name after the option, if omitted DoxygenLayout.xml will be used as the name
+# of the layout file.
+
+LAYOUT_FILE =
+
+#---------------------------------------------------------------------------
+# configuration options related to warning and progress messages
+#---------------------------------------------------------------------------
+
+# The QUIET tag can be used to turn on/off the messages that are generated
+# by doxygen. Possible values are YES and NO. If left blank NO is used.
+
+QUIET = YES
+
+# The WARNINGS tag can be used to turn on/off the warning messages that are
+# generated by doxygen. Possible values are YES and NO. If left blank
+# NO is used.
+
+WARNINGS = YES
+
+# If WARN_IF_UNDOCUMENTED is set to YES, then doxygen will generate warnings
+# for undocumented members. If EXTRACT_ALL is set to YES then this flag will
+# automatically be disabled.
+
+WARN_IF_UNDOCUMENTED = YES
+
+# If WARN_IF_DOC_ERROR is set to YES, doxygen will generate warnings for
+# potential errors in the documentation, such as not documenting some
+# parameters in a documented function, or documenting parameters that
+# don't exist or using markup commands wrongly.
+
+WARN_IF_DOC_ERROR = YES
+
+# This WARN_NO_PARAMDOC option can be abled to get warnings for
+# functions that are documented, but have no documentation for their parameters
+# or return value. If set to NO (the default) doxygen will only warn about
+# wrong or incomplete parameter documentation, but not about the absence of
+# documentation.
+
+WARN_NO_PARAMDOC = YES
+
+# The WARN_FORMAT tag determines the format of the warning messages that
+# doxygen can produce. The string should contain the $file, $line, and $text
+# tags, which will be replaced by the file and line number from which the
+# warning originated and the warning text. Optionally the format may contain
+# $version, which will be replaced by the version of the file (if it could
+# be obtained via FILE_VERSION_FILTER)
+
+WARN_FORMAT = "$file:$line: $text"
+
+# The WARN_LOGFILE tag can be used to specify a file to which warning
+# and error messages should be written. If left blank the output is written
+# to stderr.
+
+WARN_LOGFILE =
+
+#---------------------------------------------------------------------------
+# configuration options related to the input files
+#---------------------------------------------------------------------------
+
+# The INPUT tag can be used to specify the files and/or directories that contain
+# documented source files. You may enter file names like "myfile.cpp" or
+# directories like "/usr/src/myproject". Separate the files or directories
+# with spaces.
+
+INPUT = ./
+
+# This tag can be used to specify the character encoding of the source files
+# that doxygen parses. Internally doxygen uses the UTF-8 encoding, which is
+# also the default input encoding. Doxygen uses libiconv (or the iconv built
+# into libc) for the transcoding. See http://www.gnu.org/software/libiconv for
+# the list of possible encodings.
+
+INPUT_ENCODING = UTF-8
+
+# If the value of the INPUT tag contains directories, you can use the
+# FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp
+# and *.h) to filter out the source-files in the directories. If left
+# blank the following patterns are tested:
+# *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx
+# *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm *.py *.f90
+
+FILE_PATTERNS = *.h \
+ *.c \
+ *.txt
+
+# The RECURSIVE tag can be used to turn specify whether or not subdirectories
+# should be searched for input files as well. Possible values are YES and NO.
+# If left blank NO is used.
+
+RECURSIVE = YES
+
+# The EXCLUDE tag can be used to specify files and/or directories that should
+# excluded from the INPUT source files. This way you can easily exclude a
+# subdirectory from a directory tree whose root is specified with the INPUT tag.
+
+EXCLUDE =
+
+# The EXCLUDE_SYMLINKS tag can be used select whether or not files or
+# directories that are symbolic links (a Unix filesystem feature) are excluded
+# from the input.
+
+EXCLUDE_SYMLINKS = NO
+
+# If the value of the INPUT tag contains directories, you can use the
+# EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude
+# certain files from those directories. Note that the wildcards are matched
+# against the file with absolute path, so to exclude all test directories
+# for example use the pattern */test/*
+
+EXCLUDE_PATTERNS = */LowLevel/USBMode.h
+
+# The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names
+# (namespaces, classes, functions, etc.) that should be excluded from the
+# output. The symbol name can be a fully qualified name, a word, or if the
+# wildcard * is used, a substring. Examples: ANamespace, AClass,
+# AClass::ANamespace, ANamespace::*Test
+
+EXCLUDE_SYMBOLS = __*
+
+# The EXAMPLE_PATH tag can be used to specify one or more files or
+# directories that contain example code fragments that are included (see
+# the \include command).
+
+EXAMPLE_PATH =
+
+# If the value of the EXAMPLE_PATH tag contains directories, you can use the
+# EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp
+# and *.h) to filter out the source-files in the directories. If left
+# blank all files are included.
+
+EXAMPLE_PATTERNS = *
+
+# If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be
+# searched for input files to be used with the \include or \dontinclude
+# commands irrespective of the value of the RECURSIVE tag.
+# Possible values are YES and NO. If left blank NO is used.
+
+EXAMPLE_RECURSIVE = NO
+
+# The IMAGE_PATH tag can be used to specify one or more files or
+# directories that contain image that are included in the documentation (see
+# the \image command).
+
+IMAGE_PATH =
+
+# The INPUT_FILTER tag can be used to specify a program that doxygen should
+# invoke to filter for each input file. Doxygen will invoke the filter program
+# by executing (via popen()) the command <filter> <input-file>, where <filter>
+# is the value of the INPUT_FILTER tag, and <input-file> is the name of an
+# input file. Doxygen will then use the output that the filter program writes
+# to standard output. If FILTER_PATTERNS is specified, this tag will be
+# ignored.
+
+INPUT_FILTER =
+
+# The FILTER_PATTERNS tag can be used to specify filters on a per file pattern
+# basis. Doxygen will compare the file name with each pattern and apply the
+# filter if there is a match. The filters are a list of the form:
+# pattern=filter (like *.cpp=my_cpp_filter). See INPUT_FILTER for further
+# info on how filters are used. If FILTER_PATTERNS is empty, INPUT_FILTER
+# is applied to all files.
+
+FILTER_PATTERNS =
+
+# If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using
+# INPUT_FILTER) will be used to filter the input files when producing source
+# files to browse (i.e. when SOURCE_BROWSER is set to YES).
+
+FILTER_SOURCE_FILES = NO
+
+#---------------------------------------------------------------------------
+# configuration options related to source browsing
+#---------------------------------------------------------------------------
+
+# If the SOURCE_BROWSER tag is set to YES then a list of source files will
+# be generated. Documented entities will be cross-referenced with these sources.
+# Note: To get rid of all source code in the generated output, make sure also
+# VERBATIM_HEADERS is set to NO.
+
+SOURCE_BROWSER = NO
+
+# Setting the INLINE_SOURCES tag to YES will include the body
+# of functions and classes directly in the documentation.
+
+INLINE_SOURCES = NO
+
+# Setting the STRIP_CODE_COMMENTS tag to YES (the default) will instruct
+# doxygen to hide any special comment blocks from generated source code
+# fragments. Normal C and C++ comments will always remain visible.
+
+STRIP_CODE_COMMENTS = YES
+
+# If the REFERENCED_BY_RELATION tag is set to YES
+# then for each documented function all documented
+# functions referencing it will be listed.
+
+REFERENCED_BY_RELATION = NO
+
+# If the REFERENCES_RELATION tag is set to YES
+# then for each documented function all documented entities
+# called/used by that function will be listed.
+
+REFERENCES_RELATION = NO
+
+# If the REFERENCES_LINK_SOURCE tag is set to YES (the default)
+# and SOURCE_BROWSER tag is set to YES, then the hyperlinks from
+# functions in REFERENCES_RELATION and REFERENCED_BY_RELATION lists will
+# link to the source code. Otherwise they will link to the documentstion.
+
+REFERENCES_LINK_SOURCE = NO
+
+# If the USE_HTAGS tag is set to YES then the references to source code
+# will point to the HTML generated by the htags(1) tool instead of doxygen
+# built-in source browser. The htags tool is part of GNU's global source
+# tagging system (see http://www.gnu.org/software/global/global.html). You
+# will need version 4.8.6 or higher.
+
+USE_HTAGS = NO
+
+# If the VERBATIM_HEADERS tag is set to YES (the default) then Doxygen
+# will generate a verbatim copy of the header file for each class for
+# which an include is specified. Set to NO to disable this.
+
+VERBATIM_HEADERS = NO
+
+#---------------------------------------------------------------------------
+# configuration options related to the alphabetical class index
+#---------------------------------------------------------------------------
+
+# If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index
+# of all compounds will be generated. Enable this if the project
+# contains a lot of classes, structs, unions or interfaces.
+
+ALPHABETICAL_INDEX = YES
+
+# If the alphabetical index is enabled (see ALPHABETICAL_INDEX) then
+# the COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns
+# in which this list will be split (can be a number in the range [1..20])
+
+COLS_IN_ALPHA_INDEX = 5
+
+# In case all classes in a project start with a common prefix, all
+# classes will be put under the same header in the alphabetical index.
+# The IGNORE_PREFIX tag can be used to specify one or more prefixes that
+# should be ignored while generating the index headers.
+
+IGNORE_PREFIX =
+
+#---------------------------------------------------------------------------
+# configuration options related to the HTML output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_HTML tag is set to YES (the default) Doxygen will
+# generate HTML output.
+
+GENERATE_HTML = YES
+
+# The HTML_OUTPUT tag is used to specify where the HTML docs will be put.
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be
+# put in front of it. If left blank `html' will be used as the default path.
+
+HTML_OUTPUT = html
+
+# The HTML_FILE_EXTENSION tag can be used to specify the file extension for
+# each generated HTML page (for example: .htm,.php,.asp). If it is left blank
+# doxygen will generate files with .html extension.
+
+HTML_FILE_EXTENSION = .html
+
+# The HTML_HEADER tag can be used to specify a personal HTML header for
+# each generated HTML page. If it is left blank doxygen will generate a
+# standard header.
+
+HTML_HEADER =
+
+# The HTML_FOOTER tag can be used to specify a personal HTML footer for
+# each generated HTML page. If it is left blank doxygen will generate a
+# standard footer.
+
+HTML_FOOTER =
+
+# The HTML_STYLESHEET tag can be used to specify a user-defined cascading
+# style sheet that is used by each HTML page. It can be used to
+# fine-tune the look of the HTML output. If the tag is left blank doxygen
+# will generate a default style sheet. Note that doxygen will try to copy
+# the style sheet file to the HTML output directory, so don't put your own
+# stylesheet in the HTML output directory as well, or it will be erased!
+
+HTML_STYLESHEET =
+
+# If the HTML_ALIGN_MEMBERS tag is set to YES, the members of classes,
+# files or namespaces will be aligned in HTML using tables. If set to
+# NO a bullet list will be used.
+
+HTML_ALIGN_MEMBERS = YES
+
+# If the HTML_DYNAMIC_SECTIONS tag is set to YES then the generated HTML
+# documentation will contain sections that can be hidden and shown after the
+# page has loaded. For this to work a browser that supports
+# JavaScript and DHTML is required (for instance Mozilla 1.0+, Firefox
+# Netscape 6.0+, Internet explorer 5.0+, Konqueror, or Safari).
+
+HTML_DYNAMIC_SECTIONS = YES
+
+# If the GENERATE_DOCSET tag is set to YES, additional index files
+# will be generated that can be used as input for Apple's Xcode 3
+# integrated development environment, introduced with OSX 10.5 (Leopard).
+# To create a documentation set, doxygen will generate a Makefile in the
+# HTML output directory. Running make will produce the docset in that
+# directory and running "make install" will install the docset in
+# ~/Library/Developer/Shared/Documentation/DocSets so that Xcode will find
+# it at startup.
+# See http://developer.apple.com/tools/creatingdocsetswithdoxygen.html for more information.
+
+GENERATE_DOCSET = NO
+
+# When GENERATE_DOCSET tag is set to YES, this tag determines the name of the
+# feed. A documentation feed provides an umbrella under which multiple
+# documentation sets from a single provider (such as a company or product suite)
+# can be grouped.
+
+DOCSET_FEEDNAME = "Doxygen generated docs"
+
+# When GENERATE_DOCSET tag is set to YES, this tag specifies a string that
+# should uniquely identify the documentation set bundle. This should be a
+# reverse domain-name style string, e.g. com.mycompany.MyDocSet. Doxygen
+# will append .docset to the name.
+
+DOCSET_BUNDLE_ID = org.doxygen.Project
+
+# If the GENERATE_HTMLHELP tag is set to YES, additional index files
+# will be generated that can be used as input for tools like the
+# Microsoft HTML help workshop to generate a compiled HTML help file (.chm)
+# of the generated HTML documentation.
+
+GENERATE_HTMLHELP = NO
+
+# If the GENERATE_HTMLHELP tag is set to YES, the CHM_FILE tag can
+# be used to specify the file name of the resulting .chm file. You
+# can add a path in front of the file if the result should not be
+# written to the html output directory.
+
+CHM_FILE =
+
+# If the GENERATE_HTMLHELP tag is set to YES, the HHC_LOCATION tag can
+# be used to specify the location (absolute path including file name) of
+# the HTML help compiler (hhc.exe). If non-empty doxygen will try to run
+# the HTML help compiler on the generated index.hhp.
+
+HHC_LOCATION =
+
+# If the GENERATE_HTMLHELP tag is set to YES, the GENERATE_CHI flag
+# controls if a separate .chi index file is generated (YES) or that
+# it should be included in the master .chm file (NO).
+
+GENERATE_CHI = NO
+
+# If the GENERATE_HTMLHELP tag is set to YES, the CHM_INDEX_ENCODING
+# is used to encode HtmlHelp index (hhk), content (hhc) and project file
+# content.
+
+CHM_INDEX_ENCODING =
+
+# If the GENERATE_HTMLHELP tag is set to YES, the BINARY_TOC flag
+# controls whether a binary table of contents is generated (YES) or a
+# normal table of contents (NO) in the .chm file.
+
+BINARY_TOC = NO
+
+# The TOC_EXPAND flag can be set to YES to add extra items for group members
+# to the contents of the HTML help documentation and to the tree view.
+
+TOC_EXPAND = YES
+
+# If the GENERATE_QHP tag is set to YES and both QHP_NAMESPACE and QHP_VIRTUAL_FOLDER
+# are set, an additional index file will be generated that can be used as input for
+# Qt's qhelpgenerator to generate a Qt Compressed Help (.qch) of the generated
+# HTML documentation.
+
+GENERATE_QHP = NO
+
+# If the QHG_LOCATION tag is specified, the QCH_FILE tag can
+# be used to specify the file name of the resulting .qch file.
+# The path specified is relative to the HTML output folder.
+
+QCH_FILE =
+
+# The QHP_NAMESPACE tag specifies the namespace to use when generating
+# Qt Help Project output. For more information please see
+# <a href="http://doc.trolltech.com/qthelpproject.html#namespace">Qt Help Project / Namespace</a>.
+
+QHP_NAMESPACE = org.doxygen.Project
+
+# The QHP_VIRTUAL_FOLDER tag specifies the namespace to use when generating
+# Qt Help Project output. For more information please see
+# <a href="http://doc.trolltech.com/qthelpproject.html#virtual-folders">Qt Help Project / Virtual Folders</a>.
+
+QHP_VIRTUAL_FOLDER = doc
+
+# If the GENERATE_QHP tag is set to YES, the QHG_LOCATION tag can
+# be used to specify the location of Qt's qhelpgenerator.
+# If non-empty doxygen will try to run qhelpgenerator on the generated
+# .qhp file .
+
+QHG_LOCATION =
+
+# The DISABLE_INDEX tag can be used to turn on/off the condensed index at
+# top of each HTML page. The value NO (the default) enables the index and
+# the value YES disables it.
+
+DISABLE_INDEX = NO
+
+# This tag can be used to set the number of enum values (range [1..20])
+# that doxygen will group on one line in the generated HTML documentation.
+
+ENUM_VALUES_PER_LINE = 1
+
+# The GENERATE_TREEVIEW tag is used to specify whether a tree-like index
+# structure should be generated to display hierarchical information.
+# If the tag value is set to FRAME, a side panel will be generated
+# containing a tree-like index structure (just like the one that
+# is generated for HTML Help). For this to work a browser that supports
+# JavaScript, DHTML, CSS and frames is required (for instance Mozilla 1.0+,
+# Netscape 6.0+, Internet explorer 5.0+, or Konqueror). Windows users are
+# probably better off using the HTML help feature. Other possible values
+# for this tag are: HIERARCHIES, which will generate the Groups, Directories,
+# and Class Hierarchy pages using a tree view instead of an ordered list;
+# ALL, which combines the behavior of FRAME and HIERARCHIES; and NONE, which
+# disables this behavior completely. For backwards compatibility with previous
+# releases of Doxygen, the values YES and NO are equivalent to FRAME and NONE
+# respectively.
+
+GENERATE_TREEVIEW = YES
+
+# If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be
+# used to set the initial width (in pixels) of the frame in which the tree
+# is shown.
+
+TREEVIEW_WIDTH = 250
+
+# Use this tag to change the font size of Latex formulas included
+# as images in the HTML documentation. The default is 10. Note that
+# when you change the font size after a successful doxygen run you need
+# to manually remove any form_*.png images from the HTML output directory
+# to force them to be regenerated.
+
+FORMULA_FONTSIZE = 10
+
+#---------------------------------------------------------------------------
+# configuration options related to the LaTeX output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_LATEX tag is set to YES (the default) Doxygen will
+# generate Latex output.
+
+GENERATE_LATEX = NO
+
+# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put.
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be
+# put in front of it. If left blank `latex' will be used as the default path.
+
+LATEX_OUTPUT = latex
+
+# The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be
+# invoked. If left blank `latex' will be used as the default command name.
+
+LATEX_CMD_NAME = latex
+
+# The MAKEINDEX_CMD_NAME tag can be used to specify the command name to
+# generate index for LaTeX. If left blank `makeindex' will be used as the
+# default command name.
+
+MAKEINDEX_CMD_NAME = makeindex
+
+# If the COMPACT_LATEX tag is set to YES Doxygen generates more compact
+# LaTeX documents. This may be useful for small projects and may help to
+# save some trees in general.
+
+COMPACT_LATEX = NO
+
+# The PAPER_TYPE tag can be used to set the paper type that is used
+# by the printer. Possible values are: a4, a4wide, letter, legal and
+# executive. If left blank a4wide will be used.
+
+PAPER_TYPE = a4wide
+
+# The EXTRA_PACKAGES tag can be to specify one or more names of LaTeX
+# packages that should be included in the LaTeX output.
+
+EXTRA_PACKAGES =
+
+# The LATEX_HEADER tag can be used to specify a personal LaTeX header for
+# the generated latex document. The header should contain everything until
+# the first chapter. If it is left blank doxygen will generate a
+# standard header. Notice: only use this tag if you know what you are doing!
+
+LATEX_HEADER =
+
+# If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated
+# is prepared for conversion to pdf (using ps2pdf). The pdf file will
+# contain links (just like the HTML output) instead of page references
+# This makes the output suitable for online browsing using a pdf viewer.
+
+PDF_HYPERLINKS = YES
+
+# If the USE_PDFLATEX tag is set to YES, pdflatex will be used instead of
+# plain latex in the generated Makefile. Set this option to YES to get a
+# higher quality PDF documentation.
+
+USE_PDFLATEX = YES
+
+# If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \\batchmode.
+# command to the generated LaTeX files. This will instruct LaTeX to keep
+# running if errors occur, instead of asking the user for help.
+# This option is also used when generating formulas in HTML.
+
+LATEX_BATCHMODE = NO
+
+# If LATEX_HIDE_INDICES is set to YES then doxygen will not
+# include the index chapters (such as File Index, Compound Index, etc.)
+# in the output.
+
+LATEX_HIDE_INDICES = NO
+
+#---------------------------------------------------------------------------
+# configuration options related to the RTF output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_RTF tag is set to YES Doxygen will generate RTF output
+# The RTF output is optimized for Word 97 and may not look very pretty with
+# other RTF readers or editors.
+
+GENERATE_RTF = NO
+
+# The RTF_OUTPUT tag is used to specify where the RTF docs will be put.
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be
+# put in front of it. If left blank `rtf' will be used as the default path.
+
+RTF_OUTPUT = rtf
+
+# If the COMPACT_RTF tag is set to YES Doxygen generates more compact
+# RTF documents. This may be useful for small projects and may help to
+# save some trees in general.
+
+COMPACT_RTF = NO
+
+# If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated
+# will contain hyperlink fields. The RTF file will
+# contain links (just like the HTML output) instead of page references.
+# This makes the output suitable for online browsing using WORD or other
+# programs which support those fields.
+# Note: wordpad (write) and others do not support links.
+
+RTF_HYPERLINKS = NO
+
+# Load stylesheet definitions from file. Syntax is similar to doxygen's
+# config file, i.e. a series of assignments. You only have to provide
+# replacements, missing definitions are set to their default value.
+
+RTF_STYLESHEET_FILE =
+
+# Set optional variables used in the generation of an rtf document.
+# Syntax is similar to doxygen's config file.
+
+RTF_EXTENSIONS_FILE =
+
+#---------------------------------------------------------------------------
+# configuration options related to the man page output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_MAN tag is set to YES (the default) Doxygen will
+# generate man pages
+
+GENERATE_MAN = NO
+
+# The MAN_OUTPUT tag is used to specify where the man pages will be put.
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be
+# put in front of it. If left blank `man' will be used as the default path.
+
+MAN_OUTPUT = man
+
+# The MAN_EXTENSION tag determines the extension that is added to
+# the generated man pages (default is the subroutine's section .3)
+
+MAN_EXTENSION = .3
+
+# If the MAN_LINKS tag is set to YES and Doxygen generates man output,
+# then it will generate one additional man file for each entity
+# documented in the real man page(s). These additional files
+# only source the real man page, but without them the man command
+# would be unable to find the correct page. The default is NO.
+
+MAN_LINKS = NO
+
+#---------------------------------------------------------------------------
+# configuration options related to the XML output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_XML tag is set to YES Doxygen will
+# generate an XML file that captures the structure of
+# the code including all documentation.
+
+GENERATE_XML = NO
+
+# The XML_OUTPUT tag is used to specify where the XML pages will be put.
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be
+# put in front of it. If left blank `xml' will be used as the default path.
+
+XML_OUTPUT = xml
+
+# The XML_SCHEMA tag can be used to specify an XML schema,
+# which can be used by a validating XML parser to check the
+# syntax of the XML files.
+
+XML_SCHEMA =
+
+# The XML_DTD tag can be used to specify an XML DTD,
+# which can be used by a validating XML parser to check the
+# syntax of the XML files.
+
+XML_DTD =
+
+# If the XML_PROGRAMLISTING tag is set to YES Doxygen will
+# dump the program listings (including syntax highlighting
+# and cross-referencing information) to the XML output. Note that
+# enabling this will significantly increase the size of the XML output.
+
+XML_PROGRAMLISTING = YES
+
+#---------------------------------------------------------------------------
+# configuration options for the AutoGen Definitions output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_AUTOGEN_DEF tag is set to YES Doxygen will
+# generate an AutoGen Definitions (see autogen.sf.net) file
+# that captures the structure of the code including all
+# documentation. Note that this feature is still experimental
+# and incomplete at the moment.
+
+GENERATE_AUTOGEN_DEF = NO
+
+#---------------------------------------------------------------------------
+# configuration options related to the Perl module output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_PERLMOD tag is set to YES Doxygen will
+# generate a Perl module file that captures the structure of
+# the code including all documentation. Note that this
+# feature is still experimental and incomplete at the
+# moment.
+
+GENERATE_PERLMOD = NO
+
+# If the PERLMOD_LATEX tag is set to YES Doxygen will generate
+# the necessary Makefile rules, Perl scripts and LaTeX code to be able
+# to generate PDF and DVI output from the Perl module output.
+
+PERLMOD_LATEX = NO
+
+# If the PERLMOD_PRETTY tag is set to YES the Perl module output will be
+# nicely formatted so it can be parsed by a human reader. This is useful
+# if you want to understand what is going on. On the other hand, if this
+# tag is set to NO the size of the Perl module output will be much smaller
+# and Perl will parse it just the same.
+
+PERLMOD_PRETTY = YES
+
+# The names of the make variables in the generated doxyrules.make file
+# are prefixed with the string contained in PERLMOD_MAKEVAR_PREFIX.
+# This is useful so different doxyrules.make files included by the same
+# Makefile don't overwrite each other's variables.
+
+PERLMOD_MAKEVAR_PREFIX =
+
+#---------------------------------------------------------------------------
+# Configuration options related to the preprocessor
+#---------------------------------------------------------------------------
+
+# If the ENABLE_PREPROCESSING tag is set to YES (the default) Doxygen will
+# evaluate all C-preprocessor directives found in the sources and include
+# files.
+
+ENABLE_PREPROCESSING = YES
+
+# If the MACRO_EXPANSION tag is set to YES Doxygen will expand all macro
+# names in the source code. If set to NO (the default) only conditional
+# compilation will be performed. Macro expansion can be done in a controlled
+# way by setting EXPAND_ONLY_PREDEF to YES.
+
+MACRO_EXPANSION = YES
+
+# If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES
+# then the macro expansion is limited to the macros specified with the
+# PREDEFINED and EXPAND_AS_DEFINED tags.
+
+EXPAND_ONLY_PREDEF = YES
+
+# If the SEARCH_INCLUDES tag is set to YES (the default) the includes files
+# in the INCLUDE_PATH (see below) will be search if a #include is found.
+
+SEARCH_INCLUDES = YES
+
+# The INCLUDE_PATH tag can be used to specify one or more directories that
+# contain include files that are not input files but should be processed by
+# the preprocessor.
+
+INCLUDE_PATH =
+
+# You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard
+# patterns (like *.h and *.hpp) to filter out the header-files in the
+# directories. If left blank, the patterns specified with FILE_PATTERNS will
+# be used.
+
+INCLUDE_FILE_PATTERNS =
+
+# The PREDEFINED tag can be used to specify one or more macro names that
+# are defined before the preprocessor is started (similar to the -D option of
+# gcc). The argument of the tag is a list of macros of the form: name
+# or name=definition (no spaces). If the definition and the = are
+# omitted =1 is assumed. To prevent a macro definition from being
+# undefined via #undef or recursively expanded use the := operator
+# instead of the = operator.
+
+PREDEFINED = __DOXYGEN__
+
+# If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then
+# this tag can be used to specify a list of macro names that should be expanded.
+# The macro definition that is found in the sources will be used.
+# Use the PREDEFINED tag if you want to use a different macro definition.
+
+EXPAND_AS_DEFINED = BUTTLOADTAG
+
+# If the SKIP_FUNCTION_MACROS tag is set to YES (the default) then
+# doxygen's preprocessor will remove all function-like macros that are alone
+# on a line, have an all uppercase name, and do not end with a semicolon. Such
+# function macros are typically used for boiler-plate code, and will confuse
+# the parser if not removed.
+
+SKIP_FUNCTION_MACROS = YES
+
+#---------------------------------------------------------------------------
+# Configuration::additions related to external references
+#---------------------------------------------------------------------------
+
+# The TAGFILES option can be used to specify one or more tagfiles.
+# Optionally an initial location of the external documentation
+# can be added for each tagfile. The format of a tag file without
+# this location is as follows:
+# TAGFILES = file1 file2 ...
+# Adding location for the tag files is done as follows:
+# TAGFILES = file1=loc1 "file2 = loc2" ...
+# where "loc1" and "loc2" can be relative or absolute paths or
+# URLs. If a location is present for each tag, the installdox tool
+# does not have to be run to correct the links.
+# Note that each tag file must have a unique name
+# (where the name does NOT include the path)
+# If a tag file is not located in the directory in which doxygen
+# is run, you must also specify the path to the tagfile here.
+
+TAGFILES =
+
+# When a file name is specified after GENERATE_TAGFILE, doxygen will create
+# a tag file that is based on the input files it reads.
+
+GENERATE_TAGFILE =
+
+# If the ALLEXTERNALS tag is set to YES all external classes will be listed
+# in the class index. If set to NO only the inherited external classes
+# will be listed.
+
+ALLEXTERNALS = NO
+
+# If the EXTERNAL_GROUPS tag is set to YES all external groups will be listed
+# in the modules index. If set to NO, only the current project's groups will
+# be listed.
+
+EXTERNAL_GROUPS = YES
+
+# The PERL_PATH should be the absolute path and name of the perl script
+# interpreter (i.e. the result of `which perl').
+
+PERL_PATH = /usr/bin/perl
+
+#---------------------------------------------------------------------------
+# Configuration options related to the dot tool
+#---------------------------------------------------------------------------
+
+# If the CLASS_DIAGRAMS tag is set to YES (the default) Doxygen will
+# generate a inheritance diagram (in HTML, RTF and LaTeX) for classes with base
+# or super classes. Setting the tag to NO turns the diagrams off. Note that
+# this option is superseded by the HAVE_DOT option below. This is only a
+# fallback. It is recommended to install and use dot, since it yields more
+# powerful graphs.
+
+CLASS_DIAGRAMS = NO
+
+# You can define message sequence charts within doxygen comments using the \msc
+# command. Doxygen will then run the mscgen tool (see
+# http://www.mcternan.me.uk/mscgen/) to produce the chart and insert it in the
+# documentation. The MSCGEN_PATH tag allows you to specify the directory where
+# the mscgen tool resides. If left empty the tool is assumed to be found in the
+# default search path.
+
+MSCGEN_PATH =
+
+# If set to YES, the inheritance and collaboration graphs will hide
+# inheritance and usage relations if the target is undocumented
+# or is not a class.
+
+HIDE_UNDOC_RELATIONS = YES
+
+# If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is
+# available from the path. This tool is part of Graphviz, a graph visualization
+# toolkit from AT&T and Lucent Bell Labs. The other options in this section
+# have no effect if this option is set to NO (the default)
+
+HAVE_DOT = NO
+
+# By default doxygen will write a font called FreeSans.ttf to the output
+# directory and reference it in all dot files that doxygen generates. This
+# font does not include all possible unicode characters however, so when you need
+# these (or just want a differently looking font) you can specify the font name
+# using DOT_FONTNAME. You need need to make sure dot is able to find the font,
+# which can be done by putting it in a standard location or by setting the
+# DOTFONTPATH environment variable or by setting DOT_FONTPATH to the directory
+# containing the font.
+
+DOT_FONTNAME = FreeSans
+
+# The DOT_FONTSIZE tag can be used to set the size of the font of dot graphs.
+# The default size is 10pt.
+
+DOT_FONTSIZE = 10
+
+# By default doxygen will tell dot to use the output directory to look for the
+# FreeSans.ttf font (which doxygen will put there itself). If you specify a
+# different font using DOT_FONTNAME you can set the path where dot
+# can find it using this tag.
+
+DOT_FONTPATH =
+
+# If the CLASS_GRAPH and HAVE_DOT tags are set to YES then doxygen
+# will generate a graph for each documented class showing the direct and
+# indirect inheritance relations. Setting this tag to YES will force the
+# the CLASS_DIAGRAMS tag to NO.
+
+CLASS_GRAPH = NO
+
+# If the COLLABORATION_GRAPH and HAVE_DOT tags are set to YES then doxygen
+# will generate a graph for each documented class showing the direct and
+# indirect implementation dependencies (inheritance, containment, and
+# class references variables) of the class with other documented classes.
+
+COLLABORATION_GRAPH = NO
+
+# If the GROUP_GRAPHS and HAVE_DOT tags are set to YES then doxygen
+# will generate a graph for groups, showing the direct groups dependencies
+
+GROUP_GRAPHS = NO
+
+# If the UML_LOOK tag is set to YES doxygen will generate inheritance and
+# collaboration diagrams in a style similar to the OMG's Unified Modeling
+# Language.
+
+UML_LOOK = NO
+
+# If set to YES, the inheritance and collaboration graphs will show the
+# relations between templates and their instances.
+
+TEMPLATE_RELATIONS = NO
+
+# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDE_GRAPH, and HAVE_DOT
+# tags are set to YES then doxygen will generate a graph for each documented
+# file showing the direct and indirect include dependencies of the file with
+# other documented files.
+
+INCLUDE_GRAPH = NO
+
+# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDED_BY_GRAPH, and
+# HAVE_DOT tags are set to YES then doxygen will generate a graph for each
+# documented header file showing the documented files that directly or
+# indirectly include this file.
+
+INCLUDED_BY_GRAPH = NO
+
+# If the CALL_GRAPH and HAVE_DOT options are set to YES then
+# doxygen will generate a call dependency graph for every global function
+# or class method. Note that enabling this option will significantly increase
+# the time of a run. So in most cases it will be better to enable call graphs
+# for selected functions only using the \callgraph command.
+
+CALL_GRAPH = NO
+
+# If the CALLER_GRAPH and HAVE_DOT tags are set to YES then
+# doxygen will generate a caller dependency graph for every global function
+# or class method. Note that enabling this option will significantly increase
+# the time of a run. So in most cases it will be better to enable caller
+# graphs for selected functions only using the \callergraph command.
+
+CALLER_GRAPH = NO
+
+# If the GRAPHICAL_HIERARCHY and HAVE_DOT tags are set to YES then doxygen
+# will graphical hierarchy of all classes instead of a textual one.
+
+GRAPHICAL_HIERARCHY = NO
+
+# If the DIRECTORY_GRAPH, SHOW_DIRECTORIES and HAVE_DOT tags are set to YES
+# then doxygen will show the dependencies a directory has on other directories
+# in a graphical way. The dependency relations are determined by the #include
+# relations between the files in the directories.
+
+DIRECTORY_GRAPH = NO
+
+# The DOT_IMAGE_FORMAT tag can be used to set the image format of the images
+# generated by dot. Possible values are png, jpg, or gif
+# If left blank png will be used.
+
+DOT_IMAGE_FORMAT = png
+
+# The tag DOT_PATH can be used to specify the path where the dot tool can be
+# found. If left blank, it is assumed the dot tool can be found in the path.
+
+DOT_PATH = "C:/Program Files/Graphviz2.18/bin"
+
+# The DOTFILE_DIRS tag can be used to specify one or more directories that
+# contain dot files that are included in the documentation (see the
+# \dotfile command).
+
+DOTFILE_DIRS =
+
+# The DOT_GRAPH_MAX_NODES tag can be used to set the maximum number of
+# nodes that will be shown in the graph. If the number of nodes in a graph
+# becomes larger than this value, doxygen will truncate the graph, which is
+# visualized by representing a node as a red box. Note that doxygen if the
+# number of direct children of the root node in a graph is already larger than
+# DOT_GRAPH_MAX_NODES then the graph will not be shown at all. Also note
+# that the size of a graph can be further restricted by MAX_DOT_GRAPH_DEPTH.
+
+DOT_GRAPH_MAX_NODES = 15
+
+# The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the
+# graphs generated by dot. A depth value of 3 means that only nodes reachable
+# from the root by following a path via at most 3 edges will be shown. Nodes
+# that lay further from the root node will be omitted. Note that setting this
+# option to 1 or 2 may greatly reduce the computation time needed for large
+# code bases. Also note that the size of a graph can be further restricted by
+# DOT_GRAPH_MAX_NODES. Using a depth of 0 means no depth restriction.
+
+MAX_DOT_GRAPH_DEPTH = 2
+
+# Set the DOT_TRANSPARENT tag to YES to generate images with a transparent
+# background. This is disabled by default, because dot on Windows does not
+# seem to support this out of the box. Warning: Depending on the platform used,
+# enabling this option may lead to badly anti-aliased labels on the edges of
+# a graph (i.e. they become hard to read).
+
+DOT_TRANSPARENT = YES
+
+# Set the DOT_MULTI_TARGETS tag to YES allow dot to generate multiple output
+# files in one run (i.e. multiple -o and -T options on the command line). This
+# makes dot run faster, but since only newer versions of dot (>1.8.10)
+# support this, this feature is disabled by default.
+
+DOT_MULTI_TARGETS = NO
+
+# If the GENERATE_LEGEND tag is set to YES (the default) Doxygen will
+# generate a legend page explaining the meaning of the various boxes and
+# arrows in the dot generated graphs.
+
+GENERATE_LEGEND = YES
+
+# If the DOT_CLEANUP tag is set to YES (the default) Doxygen will
+# remove the intermediate dot files that are used to generate
+# the various graphs.
+
+DOT_CLEANUP = YES
+
+#---------------------------------------------------------------------------
+# Configuration::additions related to the search engine
+#---------------------------------------------------------------------------
+
+# The SEARCHENGINE tag specifies whether or not a search engine should be
+# used. If set to NO the values of all tags below this one will be ignored.
+
+SEARCHENGINE = NO
diff --git a/Projects/AVRISP_Programmer/LUFA AVRISP_Programmer.inf b/Projects/AVRISP_Programmer/LUFA AVRISP_Programmer.inf
new file mode 100644
index 000000000..bd9c8bf14
--- /dev/null
+++ b/Projects/AVRISP_Programmer/LUFA AVRISP_Programmer.inf
@@ -0,0 +1,55 @@
+; Windows LUFA USB to Serial Setup File
+; Copyright (c) 2000 Microsoft Corporation
+
+[Version]
+Signature="$Windows NT$"
+Class=Ports
+ClassGuid={4D36E978-E325-11CE-BFC1-08002BE10318}
+Provider=%COMPANY%
+LayoutFile=layout.inf
+DriverVer=06/06/2006,1.0.0.0
+
+[Manufacturer]
+%MFGNAME% = ManufName
+
+[DestinationDirs]
+DefaultDestDir=12
+
+[ManufName]
+%Modem3% = Modem3, USB\VID_03EB&PID_204B
+
+;------------------------------------------------------------------------------
+; Windows 2000/XP Sections
+;------------------------------------------------------------------------------
+
+[Modem3.nt]
+CopyFiles=USBModemCopyFileSection
+AddReg=Modem3.nt.AddReg
+
+[USBModemCopyFileSection]
+usbser.sys,,,0x20
+
+[Modem3.nt.AddReg]
+HKR,,DevLoader,,*ntkern
+HKR,,NTMPDriver,,usbser.sys
+HKR,,EnumPropPages32,,"MsPorts.dll,SerialPortPropPageProvider"
+
+[Modem3.nt.Services]
+AddService=usbser, 0x00000002, DriverService
+
+[DriverService]
+DisplayName=%SERVICE%
+ServiceType=1
+StartType=3
+ErrorControl=1
+ServiceBinary=%12%\usbser.sys
+
+;------------------------------------------------------------------------------
+; String Definitions
+;------------------------------------------------------------------------------
+
+[Strings]
+COMPANY="LUFA Library"
+MFGNAME="Dean Camera"
+Modem3="USB Virtual Serial Port"
+SERVICE="USB Virtual Serial Port CDC Driver"
\ No newline at end of file
diff --git a/Projects/AVRISP_Programmer/RingBuff.c b/Projects/AVRISP_Programmer/RingBuff.c
new file mode 100644
index 000000000..1f477f17a
--- /dev/null
+++ b/Projects/AVRISP_Programmer/RingBuff.c
@@ -0,0 +1,120 @@
+/*
+ LUFA Library
+ Copyright (C) Dean Camera, 2009.
+
+ dean [at] fourwalledcubicle [dot] com
+ www.fourwalledcubicle.com
+*/
+
+/*
+ Copyright 2009 Dean Camera (dean [at] fourwalledcubicle [dot] com)
+
+ Permission to use, copy, modify, and distribute this software
+ and its documentation for any purpose and without fee is hereby
+ granted, provided that the above copyright notice appear in all
+ copies and that both that the copyright notice and this
+ permission notice and warranty disclaimer appear in supporting
+ documentation, and that the name of the author not be used in
+ advertising or publicity pertaining to distribution of the
+ software without specific, written prior permission.
+
+ The author disclaim all warranties with regard to this
+ software, including all implied warranties of merchantability
+ and fitness. In no event shall the author be liable for any
+ special, indirect or consequential damages or any damages
+ whatsoever resulting from loss of use, data or profits, whether
+ in an action of contract, negligence or other tortious action,
+ arising out of or in connection with the use or performance of
+ this software.
+*/
+
+#include "RingBuff.h"
+
+void Buffer_Initialize(RingBuff_t* Buffer)
+{
+ BUFF_ATOMIC_BLOCK
+ {
+ Buffer->InPtr = (RingBuff_Data_t*)&Buffer->Buffer;
+ Buffer->OutPtr = (RingBuff_Data_t*)&Buffer->Buffer;
+ Buffer->Elements = 0;
+ }
+}
+
+void Buffer_StoreElement(RingBuff_t* Buffer, RingBuff_Data_t Data)
+{
+ BUFF_ATOMIC_BLOCK
+ {
+ #if defined(BUFF_DROPOLD)
+ if (Buffer->Elements == BUFF_LENGTH)
+ {
+ Buffer->OutPtr++;
+
+ if (Buffer->OutPtr == &Buffer->Buffer[BUFF_LENGTH])
+ Buffer->OutPtr = (RingBuff_Data_t*)&Buffer->Buffer;
+ }
+ else
+ {
+ Buffer->Elements++;
+ }
+ #elif defined(BUFF_DROPNEW)
+ if (Buffer->Elements == BUFF_LENGTH)
+ return;
+
+ Buffer->Elements++;
+ #elif defined(BUFF_NODROPCHECK)
+ Buffer->Elements++;
+ #endif
+
+ *(Buffer->InPtr) = Data;
+ Buffer->InPtr++;
+
+ if (Buffer->InPtr == &Buffer->Buffer[BUFF_LENGTH])
+ Buffer->InPtr = (RingBuff_Data_t*)&Buffer->Buffer;
+ }
+}
+
+RingBuff_Data_t Buffer_GetElement(RingBuff_t* Buffer)
+{
+ RingBuff_Data_t BuffData;
+
+ BUFF_ATOMIC_BLOCK
+ {
+#if defined(BUFF_EMPTYRETURNSZERO)
+ if (!(Buffer->Elements))
+ return 0;
+#elif !defined(BUFF_NOEMPTYCHECK)
+ #error No empty buffer check behaviour specified.
+#endif
+
+ BuffData = *(Buffer->OutPtr);
+
+ Buffer->OutPtr++;
+ Buffer->Elements--;
+
+ if (Buffer->OutPtr == &Buffer->Buffer[BUFF_LENGTH])
+ Buffer->OutPtr = (RingBuff_Data_t*)&Buffer->Buffer;
+ }
+
+ return BuffData;
+}
+
+#if defined(BUFF_USEPEEK)
+RingBuff_Data_t Buffer_PeekElement(const RingBuff_t* Buffer)
+{
+ RingBuff_Data_t BuffData;
+
+ BUFF_ATOMIC_BLOCK
+ {
+#if defined(BUFF_EMPTYRETURNSZERO)
+ if (!(Buffer->Elements))
+ return 0;
+#elif !defined(BUFF_NOEMPTYCHECK)
+ #error No empty buffer check behaviour specified.
+#endif
+
+ BuffData = *(Buffer->OutPtr);
+ }
+
+ return BuffData;
+}
+#endif
diff --git a/Projects/AVRISP_Programmer/RingBuff.h b/Projects/AVRISP_Programmer/RingBuff.h
new file mode 100644
index 000000000..68e4a6e75
--- /dev/null
+++ b/Projects/AVRISP_Programmer/RingBuff.h
@@ -0,0 +1,116 @@
+/*
+ LUFA Library
+ Copyright (C) Dean Camera, 2009.
+
+ dean [at] fourwalledcubicle [dot] com
+ www.fourwalledcubicle.com
+*/
+
+/*
+ Copyright 2009 Dean Camera (dean [at] fourwalledcubicle [dot] com)
+
+ Permission to use, copy, modify, and distribute this software
+ and its documentation for any purpose and without fee is hereby
+ granted, provided that the above copyright notice appear in all
+ copies and that both that the copyright notice and this
+ permission notice and warranty disclaimer appear in supporting
+ documentation, and that the name of the author not be used in
+ advertising or publicity pertaining to distribution of the
+ software without specific, written prior permission.
+
+ The author disclaim all warranties with regard to this
+ software, including all implied warranties of merchantability
+ and fitness. In no event shall the author be liable for any
+ special, indirect or consequential damages or any damages
+ whatsoever resulting from loss of use, data or profits, whether
+ in an action of contract, negligence or other tortious action,
+ arising out of or in connection with the use or performance of
+ this software.
+*/
+
+/* Buffer Configuration: */
+ /* Buffer length - select static size of created ringbuffers: */
+ #define BUFF_STATICSIZE 128 // Set to the static ringbuffer size for all ringbuffers (place size after define)
+
+ /* Volatile mode - uncomment to make buffers volatile, for use in ISRs, etc: */
+ #define BUFF_VOLATILE // Uncomment to cause all ring buffers to become volatile (and atomic if multi-byte) in access
+
+ /* Drop mode - select behaviour when Buffer_StoreElement called on a full buffer: */
+ #define BUFF_DROPOLD // Uncomment to cause full ring buffers to drop the oldest character to make space when full
+ // #define BUFF_DROPNEW // Uncomment to cause full ring buffers to drop the new character when full
+ // #define BUFF_NODROPCHECK // Uncomment to ignore full ring buffer checks - checking left to user!
+
+ /* Underflow behaviour - select behaviour when Buffer_GetElement is called with an empty ringbuffer: */
+ //#define BUFF_EMPTYRETURNSZERO // Uncomment to return 0 when an empty ringbuffer is read
+ #define BUFF_NOEMPTYCHECK // Uncomment to disable checking of empty ringbuffers - checking left to user!
+
+ /* Buffer storage type - set the datatype for the stored data */
+ #define BUFF_DATATYPE uint8_t // Change to the data type that is going to be stored into the buffer
+
+ /* Peek routine - uncomment to include the peek routine (fetches next byte without removing it from the buffer */
+ #define BUFF_USEPEEK
+
+#ifndef _RINGBUFF_H_
+#define _RINGBUFF_H_
+
+ /* Includes: */
+ #include <avr/io.h>
+ #include <avr/interrupt.h>
+ #include <util/atomic.h>
+ #include <limits.h>
+
+ #include <LUFA/Common/Common.h>
+
+ /* Defines and checks: */
+ #if defined(BUFF_STATICSIZE)
+ #define BUFF_LENGTH BUFF_STATICSIZE
+ #else
+ #error No buffer length specified!
+ #endif
+
+ #if !(defined(BUFF_DROPOLD) || defined(BUFF_DROPNEW) || defined(BUFF_NODROPCHECK))
+ #error No buffer drop mode specified.
+ #endif
+
+ #if !defined(BUFF_DATATYPE)
+ #error Ringbuffer storage data type not specified.
+ #endif
+
+ #if defined(BUFF_VOLATILE)
+ #define BUFF_MODE volatile
+ #define BUFF_ATOMIC_BLOCK ATOMIC_BLOCK(ATOMIC_RESTORESTATE)
+ #else
+ #define BUFF_MODE
+ #define BUFF_ATOMIC_BLOCK
+ #endif
+
+ #if (BUFF_STATICSIZE > LONG_MAX)
+ #define RingBuff_Elements_t uint64_t
+ #elif (BUFF_STATICSIZE > INT_MAX)
+ #define RingBuff_Elements_t uint32_t
+ #elif (BUFF_STATICSIZE > CHAR_MAX)
+ #define RingBuff_Elements_t uint16_t
+ #else
+ #define RingBuff_Elements_t uint8_t
+ #endif
+
+ /* Type Defines: */
+ typedef BUFF_DATATYPE RingBuff_Data_t;
+
+ typedef BUFF_MODE struct
+ {
+ RingBuff_Data_t Buffer[BUFF_LENGTH];
+ RingBuff_Data_t* InPtr;
+ RingBuff_Data_t* OutPtr;
+ RingBuff_Elements_t Elements;
+ } RingBuff_t;
+
+ /* Function Prototypes: */
+ void Buffer_Initialize(RingBuff_t* Buff);
+ void Buffer_StoreElement(RingBuff_t* Buffer, RingBuff_Data_t Data);
+ RingBuff_Data_t Buffer_GetElement(RingBuff_t* Buffer);
+ #if defined(BUFF_USEPEEK)
+ RingBuff_Data_t Buffer_PeekElement(const RingBuff_t* Buffer);
+ #endif
+
+#endif
diff --git a/Projects/AVRISP_Programmer/Sample_Programming_Session.txt b/Projects/AVRISP_Programmer/Sample_Programming_Session.txt
new file mode 100644
index 000000000..b5af76ebb
--- /dev/null
+++ b/Projects/AVRISP_Programmer/Sample_Programming_Session.txt
@@ -0,0 +1,104 @@
+ubuntu@ubuntu:~/LUFA/Bootloaders/LUFA_DFU_Bootloader_AT90USB162$ sudo avrdude -vv -F -P /dev/ttyACM0 -c avr910 -p usb162 -U flash:w:BootloaderDFU.hex
+
+avrdude: Version 5.5, compiled on May 9 2008 at 13:04:46
+ Copyright (c) 2000-2005 Brian Dean, http://www.bdmicro.com/
+
+ System wide configuration file is "/etc/avrdude.conf"
+ User configuration file is "/home/ubuntu/.avrduderc"
+ User configuration file does not exist or is not a regular file, skipping
+
+ Using Port : /dev/ttyACM0
+ Using Programmer : avr910
+ AVR Part : AT90USB162
+ Chip Erase delay : 9000 us
+ PAGEL : PD7
+ BS2 : PA0
+ RESET disposition : dedicated
+ RETRY pulse : SCK
+ serial program mode : yes
+ parallel program mode : yes
+ Timeout : 200
+ StabDelay : 100
+ CmdexeDelay : 25
+ SyncLoops : 32
+ ByteDelay : 0
+ PollIndex : 3
+ PollValue : 0x53
+ Memory Detail :
+
+ Block Poll Page Polled
+ Memory Type Mode Delay Size Indx Paged Size Size #Pages MinW MaxW ReadBack
+ ----------- ---- ----- ----- ---- ------ ------ ---- ------ ----- ----- ---------
+ eeprom 65 10 8 0 no 512 4 0 9000 9000 0x00 0x00
+ flash 65 6 128 0 yes 16384 128 128 4500 4500 0x00 0x00
+ lfuse 0 0 0 0 no 1 0 0 9000 9000 0x00 0x00
+ hfuse 0 0 0 0 no 1 0 0 9000 9000 0x00 0x00
+ efuse 0 0 0 0 no 1 0 0 9000 9000 0x00 0x00
+ lock 0 0 0 0 no 1 0 0 9000 9000 0x00 0x00
+ calibration 0 0 0 0 no 1 0 0 0 0 0x00 0x00
+ signature 0 0 0 0 no 3 0 0 0 0 0x00 0x00
+
+ Programmer Type : avr910
+ Description : Atmel Low Cost Serial Programmer
+
+Found programmer: Id = "AVR ISP"; type = S
+ Software Version = 2.3; Hardware Version = 1.0
+Programmer supports auto addr increment.
+
+Programmer supports the following devices:
+ Device code: 0x55 = ATtiny12
+ Device code: 0x56 = ATtiny15
+ Device code: 0x5e = ATtiny2313
+ Device code: 0x76 = ATMEGA8
+ Device code: 0x74 = ATMEGA6450
+ Device code: 0x72 = ATMEGA32
+ Device code: 0x45 = ATMEGA64
+ Device code: 0x74 = ATMEGA6450
+ Device code: 0x43 = ATMEGA128
+ Device code: 0x63 = ATMEGA162
+ Device code: 0x78 = ATMEGA169
+ Device code: 0x6c = AT90S4434
+ Device code: 0x38 = AT90S8515
+ Device code: 0x65 = (unknown)
+
+avrdude: warning: selected device is not supported by programmer: usb162
+avrdude: AVR device initialized and ready to accept instructions
+
+Reading | ################################################## | 100% 0.00s
+
+avrdude: Device signature = 0x1e9482
+avrdude: safemode: lfuse reads as 5E
+avrdude: safemode: hfuse reads as D9
+avrdude: safemode: efuse reads as F4
+avrdude: NOTE: FLASH memory has been specified, an erase cycle will be performed
+ To disable this feature, specify the -D option.
+avrdude: erasing chip
+avrdude: reading input file "BootloaderDFU.hex"
+avrdude: input file BootloaderDFU.hex auto detected as Intel Hex
+avrdude: writing flash (16066 bytes):
+
+Writing | ################################################## | 100% 33.39s
+
+
+
+avrdude: 16066 bytes of flash written
+avrdude: verifying flash memory against BootloaderDFU.hex:
+avrdude: load data flash data from input file BootloaderDFU.hex:
+avrdude: input file BootloaderDFU.hex auto detected as Intel Hex
+avrdude: input file BootloaderDFU.hex contains 16066 bytes
+avrdude: reading on-chip flash data:
+
+Reading | ################################################## | 100% 16.07s
+
+
+
+avrdude: verifying ...
+avrdude: 16066 bytes of flash verified
+
+avrdude: safemode: lfuse reads as 5E
+avrdude: safemode: hfuse reads as D9
+avrdude: safemode: efuse reads as F4
+avrdude: safemode: Fuses OK
+
+avrdude done. Thank you.
+
diff --git a/Projects/AVRISP_Programmer/makefile b/Projects/AVRISP_Programmer/makefile
new file mode 100644
index 000000000..d6617dc7e
--- /dev/null
+++ b/Projects/AVRISP_Programmer/makefile
@@ -0,0 +1,704 @@
+# Hey Emacs, this is a -*- makefile -*-
+#----------------------------------------------------------------------------
+# WinAVR Makefile Template written by Eric B. Weddington, J�rg Wunsch, et al.
+# >> Modified for use with the LUFA project. <<
+#
+# Released to the Public Domain
+#
+# Additional material for this makefile was written by:
+# Peter Fleury
+# Tim Henigan
+# Colin O'Flynn
+# Reiner Patommel
+# Markus Pfaff
+# Sander Pool
+# Frederik Rouleau
+# Carlos Lamas
+# Dean Camera
+# Opendous Inc.
+# Denver Gingerich
+#
+#----------------------------------------------------------------------------
+# On command line:
+#
+# make all = Make software.
+#
+# make clean = Clean out built project files.
+#
+# make coff = Convert ELF to AVR COFF.
+#
+# make extcoff = Convert ELF to AVR Extended COFF.
+#
+# make program = Download the hex file to the device, using avrdude.
+# Please customize the avrdude settings below first!
+#
+# make dfu = Download the hex file to the device, using dfu-programmer (must
+# have dfu-programmer installed).
+#
+# make flip = Download the hex file to the device, using Atmel FLIP (must
+# have Atmel FLIP installed).
+#
+# make dfu-ee = Download the eeprom file to the device, using dfu-programmer
+# (must have dfu-programmer installed).
+#
+# make flip-ee = Download the eeprom file to the device, using Atmel FLIP
+# (must have Atmel FLIP installed).
+#
+# make doxygen = Generate DoxyGen documentation for the project (must have
+# DoxyGen installed)
+#
+# make debug = Start either simulavr or avarice as specified for debugging,
+# with avr-gdb or avr-insight as the front end for debugging.
+#
+# make filename.s = Just compile filename.c into the assembler code only.
+#
+# make filename.i = Create a preprocessed source file for use in submitting
+# bug reports to the GCC project.
+#
+# To rebuild project do "make clean" then "make all".
+#----------------------------------------------------------------------------
+
+
+# MCU name
+MCU = at90usb1287
+
+
+# Target board (USBKEY, STK525, STK526, RZUSBSTICK, USER or blank for projects not requiring
+# LUFA board drivers). If USER is selected, put custom board drivers in a directory called
+# "Board" inside the application directory.
+BOARD = USBKEY
+
+
+# Processor frequency.
+# This will define a symbol, F_CPU, in all source code files equal to the
+# processor frequency. You can then use this symbol in your source code to
+# calculate timings. Do NOT tack on a 'UL' at the end, this will be done
+# automatically to create a 32-bit value in your source code.
+# Typical values are:
+# F_CPU = 1000000
+# F_CPU = 1843200
+# F_CPU = 2000000
+# F_CPU = 3686400
+# F_CPU = 4000000
+# F_CPU = 7372800
+# F_CPU = 8000000
+# F_CPU = 11059200
+# F_CPU = 14745600
+# F_CPU = 16000000
+# F_CPU = 18432000
+# F_CPU = 20000000
+F_CPU = 8000000
+
+
+# Output format. (can be srec, ihex, binary)
+FORMAT = ihex
+
+
+# Target file name (without extension).
+TARGET = AVRISP_Programmer
+
+
+# Object files directory
+# To put object files in current directory, use a dot (.), do NOT make
+# this an empty or blank macro!
+OBJDIR = .
+
+
+# List C source files here. (C dependencies are automatically generated.)
+SRC = $(TARGET).c \
+ Descriptors.c \
+ RingBuff.c \
+ ../../LUFA/Scheduler/Scheduler.c \
+ ../../LUFA/Drivers/AT90USBXXX/Serial.c \
+ ../../LUFA/Drivers/USB/LowLevel/LowLevel.c \
+ ../../LUFA/Drivers/USB/LowLevel/Endpoint.c \
+ ../../LUFA/Drivers/USB/LowLevel/DevChapter9.c \
+ ../../LUFA/Drivers/USB/HighLevel/USBTask.c \
+ ../../LUFA/Drivers/USB/HighLevel/USBInterrupt.c \
+ ../../LUFA/Drivers/USB/HighLevel/Events.c \
+ ../../LUFA/Drivers/USB/HighLevel/StdDescriptors.c \
+
+# List C++ source files here. (C dependencies are automatically generated.)
+CPPSRC =
+
+
+# List Assembler source files here.
+# Make them always end in a capital .S. Files ending in a lowercase .s
+# will not be considered source files but generated files (assembler
+# output from the compiler), and will be deleted upon "make clean"!
+# Even though the DOS/Win* filesystem matches both .s and .S the same,
+# it will preserve the spelling of the filenames, and gcc itself does
+# care about how the name is spelled on its command-line.
+ASRC =
+
+
+# Optimization level, can be [0, 1, 2, 3, s].
+# 0 = turn off optimization. s = optimize for size.
+# (Note: 3 is not always the best optimization level. See avr-libc FAQ.)
+OPT = s
+
+
+# Debugging format.
+# Native formats for AVR-GCC's -g are dwarf-2 [default] or stabs.
+# AVR Studio 4.10 requires dwarf-2.
+# AVR [Extended] COFF format requires stabs, plus an avr-objcopy run.
+DEBUG = dwarf-2
+
+
+# List any extra directories to look for include files here.
+# Each directory must be seperated by a space.
+# Use forward slashes for directory separators.
+# For a directory that has spaces, enclose it in quotes.
+EXTRAINCDIRS = ../../
+
+
+# Compiler flag to set the C Standard level.
+# c89 = "ANSI" C
+# gnu89 = c89 plus GCC extensions
+# c99 = ISO C99 standard (not yet fully implemented)
+# gnu99 = c99 plus GCC extensions
+CSTANDARD = -std=gnu99
+
+
+# Place -D or -U options here for C sources
+CDEFS = -DF_CPU=$(F_CPU)UL -DBOARD=BOARD_$(BOARD) -DUSE_NONSTANDARD_DESCRIPTOR_NAMES -DNO_STREAM_CALLBACKS
+CDEFS += -DUSB_DEVICE_ONLY -DUSE_STATIC_OPTIONS="(USB_DEVICE_OPT_FULLSPEED | USB_OPT_REG_ENABLED | USB_OPT_AUTO_PLL)"
+
+
+# Place -D or -U options here for ASM sources
+ADEFS = -DF_CPU=$(F_CPU)
+
+
+# Place -D or -U options here for C++ sources
+CPPDEFS = -DF_CPU=$(F_CPU)UL
+#CPPDEFS += -D__STDC_LIMIT_MACROS
+#CPPDEFS += -D__STDC_CONSTANT_MACROS
+
+
+
+#---------------- Compiler Options C ----------------
+# -g*: generate debugging information
+# -O*: optimization level
+# -f...: tuning, see GCC manual and avr-libc documentation
+# -Wall...: warning level
+# -Wa,...: tell GCC to pass this to the assembler.
+# -adhlns...: create assembler listing
+CFLAGS = -g$(DEBUG)
+CFLAGS += $(CDEFS)
+CFLAGS += -O$(OPT)
+CFLAGS += -funsigned-char
+CFLAGS += -funsigned-bitfields
+CFLAGS += -ffunction-sections
+CFLAGS += -fpack-struct
+CFLAGS += -fshort-enums
+CFLAGS += -finline-limit=20
+CFLAGS += -Wall
+CFLAGS += -Wstrict-prototypes
+CFLAGS += -Wundef
+#CFLAGS += -fno-unit-at-a-time
+#CFLAGS += -Wunreachable-code
+#CFLAGS += -Wsign-compare
+CFLAGS += -Wa,-adhlns=$(<:%.c=$(OBJDIR)/%.lst)
+CFLAGS += $(patsubst %,-I%,$(EXTRAINCDIRS))
+CFLAGS += $(CSTANDARD)
+
+
+#---------------- Compiler Options C++ ----------------
+# -g*: generate debugging information
+# -O*: optimization level
+# -f...: tuning, see GCC manual and avr-libc documentation
+# -Wall...: warning level
+# -Wa,...: tell GCC to pass this to the assembler.
+# -adhlns...: create assembler listing
+CPPFLAGS = -g$(DEBUG)
+CPPFLAGS += $(CPPDEFS)
+CPPFLAGS += -O$(OPT)
+CPPFLAGS += -funsigned-char
+CPPFLAGS += -funsigned-bitfields
+CPPFLAGS += -fpack-struct
+CPPFLAGS += -fshort-enums
+CPPFLAGS += -fno-exceptions
+CPPFLAGS += -Wall
+CFLAGS += -Wundef
+#CPPFLAGS += -mshort-calls
+#CPPFLAGS += -fno-unit-at-a-time
+#CPPFLAGS += -Wstrict-prototypes
+#CPPFLAGS += -Wunreachable-code
+#CPPFLAGS += -Wsign-compare
+CPPFLAGS += -Wa,-adhlns=$(<:%.cpp=$(OBJDIR)/%.lst)
+CPPFLAGS += $(patsubst %,-I%,$(EXTRAINCDIRS))
+#CPPFLAGS += $(CSTANDARD)
+
+
+#---------------- Assembler Options ----------------
+# -Wa,...: tell GCC to pass this to the assembler.
+# -adhlns: create listing
+# -gstabs: have the assembler create line number information; note that
+# for use in COFF files, additional information about filenames
+# and function names needs to be present in the assembler source
+# files -- see avr-libc docs [FIXME: not yet described there]
+# -listing-cont-lines: Sets the maximum number of continuation lines of hex
+# dump that will be displayed for a given single line of source input.
+ASFLAGS = $(ADEFS) -Wa,-adhlns=$(<:%.S=$(OBJDIR)/%.lst),-gstabs,--listing-cont-lines=100
+
+
+#---------------- Library Options ----------------
+# Minimalistic printf version
+PRINTF_LIB_MIN = -Wl,-u,vfprintf -lprintf_min
+
+# Floating point printf version (requires MATH_LIB = -lm below)
+PRINTF_LIB_FLOAT = -Wl,-u,vfprintf -lprintf_flt
+
+# If this is left blank, then it will use the Standard printf version.
+PRINTF_LIB =
+#PRINTF_LIB = $(PRINTF_LIB_MIN)
+#PRINTF_LIB = $(PRINTF_LIB_FLOAT)
+
+
+# Minimalistic scanf version
+SCANF_LIB_MIN = -Wl,-u,vfscanf -lscanf_min
+
+# Floating point + %[ scanf version (requires MATH_LIB = -lm below)
+SCANF_LIB_FLOAT = -Wl,-u,vfscanf -lscanf_flt
+
+# If this is left blank, then it will use the Standard scanf version.
+SCANF_LIB =
+#SCANF_LIB = $(SCANF_LIB_MIN)
+#SCANF_LIB = $(SCANF_LIB_FLOAT)
+
+
+MATH_LIB = -lm
+
+
+# List any extra directories to look for libraries here.
+# Each directory must be seperated by a space.
+# Use forward slashes for directory separators.
+# For a directory that has spaces, enclose it in quotes.
+EXTRALIBDIRS =
+
+
+
+#---------------- External Memory Options ----------------
+
+# 64 KB of external RAM, starting after internal RAM (ATmega128!),
+# used for variables (.data/.bss) and heap (malloc()).
+#EXTMEMOPTS = -Wl,-Tdata=0x801100,--defsym=__heap_end=0x80ffff
+
+# 64 KB of external RAM, starting after internal RAM (ATmega128!),
+# only used for heap (malloc()).
+#EXTMEMOPTS = -Wl,--section-start,.data=0x801100,--defsym=__heap_end=0x80ffff
+
+EXTMEMOPTS =
+
+
+
+#---------------- Linker Options ----------------
+# -Wl,...: tell GCC to pass this to linker.
+# -Map: create map file
+# --cref: add cross reference to map file
+LDFLAGS = -Wl,-Map=$(TARGET).map,--cref
+LDFLAGS += -Wl,--relax
+LDFLAGS += -Wl,--gc-sections
+LDFLAGS += $(EXTMEMOPTS)
+LDFLAGS += $(patsubst %,-L%,$(EXTRALIBDIRS))
+LDFLAGS += $(PRINTF_LIB) $(SCANF_LIB) $(MATH_LIB)
+#LDFLAGS += -T linker_script.x
+
+
+
+#---------------- Programming Options (avrdude) ----------------
+
+# Programming hardware: alf avr910 avrisp bascom bsd
+# dt006 pavr picoweb pony-stk200 sp12 stk200 stk500
+#
+# Type: avrdude -c ?
+# to get a full listing.
+#
+AVRDUDE_PROGRAMMER = jtagmkII
+
+# com1 = serial port. Use lpt1 to connect to parallel port.
+AVRDUDE_PORT = usb
+
+AVRDUDE_WRITE_FLASH = -U flash:w:$(TARGET).hex
+#AVRDUDE_WRITE_EEPROM = -U eeprom:w:$(TARGET).eep
+
+
+# Uncomment the following if you want avrdude's erase cycle counter.
+# Note that this counter needs to be initialized first using -Yn,
+# see avrdude manual.
+#AVRDUDE_ERASE_COUNTER = -y
+
+# Uncomment the following if you do /not/ wish a verification to be
+# performed after programming the device.
+#AVRDUDE_NO_VERIFY = -V
+
+# Increase verbosity level. Please use this when submitting bug
+# reports about avrdude. See <http://savannah.nongnu.org/projects/avrdude>
+# to submit bug reports.
+#AVRDUDE_VERBOSE = -v -v
+
+AVRDUDE_FLAGS = -p $(MCU) -P $(AVRDUDE_PORT) -c $(AVRDUDE_PROGRAMMER)
+AVRDUDE_FLAGS += $(AVRDUDE_NO_VERIFY)
+AVRDUDE_FLAGS += $(AVRDUDE_VERBOSE)
+AVRDUDE_FLAGS += $(AVRDUDE_ERASE_COUNTER)
+
+
+
+#---------------- Debugging Options ----------------
+
+# For simulavr only - target MCU frequency.
+DEBUG_MFREQ = $(F_CPU)
+
+# Set the DEBUG_UI to either gdb or insight.
+# DEBUG_UI = gdb
+DEBUG_UI = insight
+
+# Set the debugging back-end to either avarice, simulavr.
+DEBUG_BACKEND = avarice
+#DEBUG_BACKEND = simulavr
+
+# GDB Init Filename.
+GDBINIT_FILE = __avr_gdbinit
+
+# When using avarice settings for the JTAG
+JTAG_DEV = /dev/com1
+
+# Debugging port used to communicate between GDB / avarice / simulavr.
+DEBUG_PORT = 4242
+
+# Debugging host used to communicate between GDB / avarice / simulavr, normally
+# just set to localhost unless doing some sort of crazy debugging when
+# avarice is running on a different computer.
+DEBUG_HOST = localhost
+
+
+
+#============================================================================
+
+
+# Define programs and commands.
+SHELL = sh
+CC = avr-gcc
+OBJCOPY = avr-objcopy
+OBJDUMP = avr-objdump
+SIZE = avr-size
+AR = avr-ar rcs
+NM = avr-nm
+AVRDUDE = avrdude
+REMOVE = rm -f
+REMOVEDIR = rm -rf
+COPY = cp
+WINSHELL = cmd
+
+# Define Messages
+# English
+MSG_ERRORS_NONE = Errors: none
+MSG_BEGIN = -------- begin --------
+MSG_END = -------- end --------
+MSG_SIZE_BEFORE = Size before:
+MSG_SIZE_AFTER = Size after:
+MSG_COFF = Converting to AVR COFF:
+MSG_EXTENDED_COFF = Converting to AVR Extended COFF:
+MSG_FLASH = Creating load file for Flash:
+MSG_EEPROM = Creating load file for EEPROM:
+MSG_EXTENDED_LISTING = Creating Extended Listing:
+MSG_SYMBOL_TABLE = Creating Symbol Table:
+MSG_LINKING = Linking:
+MSG_COMPILING = Compiling C:
+MSG_COMPILING_CPP = Compiling C++:
+MSG_ASSEMBLING = Assembling:
+MSG_CLEANING = Cleaning project:
+MSG_CREATING_LIBRARY = Creating library:
+
+
+
+
+# Define all object files.
+OBJ = $(SRC:%.c=$(OBJDIR)/%.o) $(CPPSRC:%.cpp=$(OBJDIR)/%.o) $(ASRC:%.S=$(OBJDIR)/%.o)
+
+# Define all listing files.
+LST = $(SRC:%.c=$(OBJDIR)/%.lst) $(CPPSRC:%.cpp=$(OBJDIR)/%.lst) $(ASRC:%.S=$(OBJDIR)/%.lst)
+
+
+# Compiler flags to generate dependency files.
+GENDEPFLAGS = -MMD -MP -MF .dep/$(@F).d
+
+
+# Combine all necessary flags and optional flags.
+# Add target processor to flags.
+ALL_CFLAGS = -mmcu=$(MCU) -I. $(CFLAGS) $(GENDEPFLAGS)
+ALL_CPPFLAGS = -mmcu=$(MCU) -I. -x c++ $(CPPFLAGS) $(GENDEPFLAGS)
+ALL_ASFLAGS = -mmcu=$(MCU) -I. -x assembler-with-cpp $(ASFLAGS)
+
+
+
+
+
+# Default target.
+all: begin gccversion sizebefore build checkhooks checklibmode sizeafter end
+
+# Change the build target to build a HEX file or a library.
+build: elf hex eep lss sym
+#build: lib
+
+
+elf: $(TARGET).elf
+hex: $(TARGET).hex
+eep: $(TARGET).eep
+lss: $(TARGET).lss
+sym: $(TARGET).sym
+LIBNAME=lib$(TARGET).a
+lib: $(LIBNAME)
+
+
+
+# Eye candy.
+# AVR Studio 3.x does not check make's exit code but relies on
+# the following magic strings to be generated by the compile job.
+begin:
+ @echo
+ @echo $(MSG_BEGIN)
+
+end:
+ @echo $(MSG_END)
+ @echo
+
+
+# Display size of file.
+HEXSIZE = $(SIZE) --target=$(FORMAT) $(TARGET).hex
+ELFSIZE = $(SIZE) $(MCU_FLAG) $(FORMAT_FLAG) $(TARGET).elf
+MCU_FLAG = $(shell $(SIZE) --help | grep -- --mcu > /dev/null && echo --mcu=$(MCU) )
+FORMAT_FLAG = $(shell $(SIZE) --help | grep -- --format=.*avr > /dev/null && echo --format=avr )
+
+sizebefore:
+ @if test -f $(TARGET).elf; then echo; echo $(MSG_SIZE_BEFORE); $(ELFSIZE); \
+ 2>/dev/null; echo; fi
+
+sizeafter:
+ @if test -f $(TARGET).elf; then echo; echo $(MSG_SIZE_AFTER); $(ELFSIZE); \
+ 2>/dev/null; echo; fi
+
+checkhooks: build
+ @echo
+ @echo ------- Unhooked LUFA Events -------
+ @$(shell) (grep -s '^Event.*LUFA/.*\\.o' $(TARGET).map | \
+ cut -d' ' -f1 | cut -d'_' -f2- | grep ".*") || \
+ echo "(None)"
+ @echo ----- End Unhooked LUFA Events -----
+
+checklibmode:
+ @echo
+ @echo ----------- Library Mode -----------
+ @$(shell) ($(CC) $(ALL_CFLAGS) -E -dM - < /dev/null \
+ | grep 'USB_\(DEVICE\|HOST\)_ONLY' | cut -d' ' -f2 | grep ".*") \
+ || echo "No specific mode (both device and host mode allowable)."
+ @echo ------------------------------------
+
+# Display compiler version information.
+gccversion :
+ @$(CC) --version
+
+
+
+# Program the device.
+program: $(TARGET).hex $(TARGET).eep
+ $(AVRDUDE) $(AVRDUDE_FLAGS) $(AVRDUDE_WRITE_FLASH) $(AVRDUDE_WRITE_EEPROM)
+
+flip: $(TARGET).hex
+ batchisp -hardware usb -device $(MCU) -operation erase f
+ batchisp -hardware usb -device $(MCU) -operation loadbuffer $(TARGET).hex program
+ batchisp -hardware usb -device $(MCU) -operation start reset 0
+
+dfu: $(TARGET).hex
+ dfu-programmer $(MCU) erase
+ dfu-programmer $(MCU) flash --debug 1 $(TARGET).hex
+ dfu-programmer $(MCU) reset
+
+flip-ee: $(TARGET).hex $(TARGET).eep
+ copy $(TARGET).eep $(TARGET)eep.hex
+ batchisp -hardware usb -device $(MCU) -operation memory EEPROM erase
+ batchisp -hardware usb -device $(MCU) -operation memory EEPROM loadbuffer $(TARGET)eep.hex program
+ batchisp -hardware usb -device $(MCU) -operation start reset 0
+
+dfu-ee: $(TARGET).hex $(TARGET).eep
+ dfu-programmer $(MCU) erase
+ dfu-programmer $(MCU) eeprom --debug 1 $(TARGET).eep
+ dfu-programmer $(MCU) reset
+
+# Generate avr-gdb config/init file which does the following:
+# define the reset signal, load the target file, connect to target, and set
+# a breakpoint at main().
+gdb-config:
+ @$(REMOVE) $(GDBINIT_FILE)
+ @echo define reset >> $(GDBINIT_FILE)
+ @echo SIGNAL SIGHUP >> $(GDBINIT_FILE)
+ @echo end >> $(GDBINIT_FILE)
+ @echo file $(TARGET).elf >> $(GDBINIT_FILE)
+ @echo target remote $(DEBUG_HOST):$(DEBUG_PORT) >> $(GDBINIT_FILE)
+ifeq ($(DEBUG_BACKEND),simulavr)
+ @echo load >> $(GDBINIT_FILE)
+endif
+ @echo break main >> $(GDBINIT_FILE)
+
+debug: gdb-config $(TARGET).elf
+ifeq ($(DEBUG_BACKEND), avarice)
+ @echo Starting AVaRICE - Press enter when "waiting to connect" message displays.
+ @$(WINSHELL) /c start avarice --jtag $(JTAG_DEV) --erase --program --file \
+ $(TARGET).elf $(DEBUG_HOST):$(DEBUG_PORT)
+ @$(WINSHELL) /c pause
+
+else
+ @$(WINSHELL) /c start simulavr --gdbserver --device $(MCU) --clock-freq \
+ $(DEBUG_MFREQ) --port $(DEBUG_PORT)
+endif
+ @$(WINSHELL) /c start avr-$(DEBUG_UI) --command=$(GDBINIT_FILE)
+
+
+
+
+# Convert ELF to COFF for use in debugging / simulating in AVR Studio or VMLAB.
+COFFCONVERT = $(OBJCOPY) --debugging
+COFFCONVERT += --change-section-address .data-0x800000
+COFFCONVERT += --change-section-address .bss-0x800000
+COFFCONVERT += --change-section-address .noinit-0x800000
+COFFCONVERT += --change-section-address .eeprom-0x810000
+
+
+
+coff: $(TARGET).elf
+ @echo
+ @echo $(MSG_COFF) $(TARGET).cof
+ $(COFFCONVERT) -O coff-avr $< $(TARGET).cof
+
+
+extcoff: $(TARGET).elf
+ @echo
+ @echo $(MSG_EXTENDED_COFF) $(TARGET).cof
+ $(COFFCONVERT) -O coff-ext-avr $< $(TARGET).cof
+
+
+
+# Create final output files (.hex, .eep) from ELF output file.
+%.hex: %.elf
+ @echo
+ @echo $(MSG_FLASH) $@
+ $(OBJCOPY) -O $(FORMAT) -R .eeprom $< $@
+
+%.eep: %.elf
+ @echo
+ @echo $(MSG_EEPROM) $@
+ -$(OBJCOPY) -j .eeprom --set-section-flags=.eeprom="alloc,load" \
+ --change-section-lma .eeprom=0 --no-change-warnings -O $(FORMAT) $< $@ || exit 0
+
+# Create extended listing file from ELF output file.
+%.lss: %.elf
+ @echo
+ @echo $(MSG_EXTENDED_LISTING) $@
+ $(OBJDUMP) -h -z -S $< > $@
+
+# Create a symbol table from ELF output file.
+%.sym: %.elf
+ @echo
+ @echo $(MSG_SYMBOL_TABLE) $@
+ $(NM) -n $< > $@
+
+
+
+# Create library from object files.
+.SECONDARY : $(TARGET).a
+.PRECIOUS : $(OBJ)
+%.a: $(OBJ)
+ @echo
+ @echo $(MSG_CREATING_LIBRARY) $@
+ $(AR) $@ $(OBJ)
+
+
+# Link: create ELF output file from object files.
+.SECONDARY : $(TARGET).elf
+.PRECIOUS : $(OBJ)
+%.elf: $(OBJ)
+ @echo
+ @echo $(MSG_LINKING) $@
+ $(CC) $(ALL_CFLAGS) $^ --output $@ $(LDFLAGS)
+
+
+# Compile: create object files from C source files.
+$(OBJDIR)/%.o : %.c
+ @echo
+ @echo $(MSG_COMPILING) $<
+ $(CC) -c $(ALL_CFLAGS) $< -o $@
+
+
+# Compile: create object files from C++ source files.
+$(OBJDIR)/%.o : %.cpp
+ @echo
+ @echo $(MSG_COMPILING_CPP) $<
+ $(CC) -c $(ALL_CPPFLAGS) $< -o $@
+
+
+# Compile: create assembler files from C source files.
+%.s : %.c
+ $(CC) -S $(ALL_CFLAGS) $< -o $@
+
+
+# Compile: create assembler files from C++ source files.
+%.s : %.cpp
+ $(CC) -S $(ALL_CPPFLAGS) $< -o $@
+
+
+# Assemble: create object files from assembler source files.
+$(OBJDIR)/%.o : %.S
+ @echo
+ @echo $(MSG_ASSEMBLING) $<
+ $(CC) -c $(ALL_ASFLAGS) $< -o $@
+
+
+# Create preprocessed source for use in sending a bug report.
+%.i : %.c
+ $(CC) -E -mmcu=$(MCU) -I. $(CFLAGS) $< -o $@
+
+
+# Target: clean project.
+clean: begin clean_list clean_binary end
+
+clean_binary:
+ $(REMOVE) $(TARGET).hex
+
+clean_list:
+ @echo $(MSG_CLEANING)
+ $(REMOVE) $(TARGET).eep
+ $(REMOVE) $(TARGET).cof
+ $(REMOVE) $(TARGET).elf
+ $(REMOVE) $(TARGET).map
+ $(REMOVE) $(TARGET).sym
+ $(REMOVE) $(TARGET).lss
+ $(REMOVE) $(SRC:%.c=$(OBJDIR)/%.o)
+ $(REMOVE) $(SRC:%.c=$(OBJDIR)/%.lst)
+ $(REMOVE) $(SRC:.c=.s)
+ $(REMOVE) $(SRC:.c=.d)
+ $(REMOVE) $(SRC:.c=.i)
+ $(REMOVEDIR) .dep
+
+
+doxygen:
+ @echo Generating Project Documentation...
+ @doxygen Doxygen.conf
+ @echo Documentation Generation Complete.
+
+clean_doxygen:
+ rm -rf Documentation
+
+# Create object files directory
+$(shell mkdir $(OBJDIR) 2>/dev/null)
+
+
+# Include the dependency files.
+-include $(shell mkdir .dep 2>/dev/null) $(wildcard .dep/*)
+
+
+# Listing of phony targets.
+.PHONY : all checkhooks checklibmode begin \
+finish end sizebefore sizeafter gccversion \
+build elf hex eep lss sym coff extcoff \
+clean clean_list clean_binary program debug \
+gdb-config doxygen dfu flip
diff --git a/Projects/Magstripe/CircularBitBuffer.c b/Projects/Magstripe/CircularBitBuffer.c
new file mode 100644
index 000000000..5d23762ec
--- /dev/null
+++ b/Projects/Magstripe/CircularBitBuffer.c
@@ -0,0 +1,113 @@
+/*
+ LUFA Library
+ Copyright (C) Dean Camera, 2009.
+
+ dean [at] fourwalledcubicle [dot] com
+ www.fourwalledcubicle.com
+*/
+
+/*
+ Copyright 2009 Denver Gingerich (denver [at] ossguy [dot] com)
+ Copyright 2009 Dean Camera (dean [at] fourwalledcubicle [dot] com)
+
+ Permission to use, copy, modify, and distribute this software
+ and its documentation for any purpose and without fee is hereby
+ granted, provided that the above copyright notice appear in all
+ copies and that both that the copyright notice and this
+ permission notice and warranty disclaimer appear in supporting
+ documentation, and that the name of the author not be used in
+ advertising or publicity pertaining to distribution of the
+ software without specific, written prior permission.
+
+ The author disclaim all warranties with regard to this
+ software, including all implied warranties of merchantability
+ and fitness. In no event shall the author be liable for any
+ special, indirect or consequential damages or any damages
+ whatsoever resulting from loss of use, data or profits, whether
+ in an action of contract, negligence or other tortious action,
+ arising out of or in connection with the use or performance of
+ this software.
+*/
+
+/** Circular bit buffer library. This will allow for individual bits
+ * to be stored in packed form inside circular buffers, to reduce
+ * overall RAM usage.
+ */
+
+#include "CircularBitBuffer.h"
+
+/** Function to initialize or reset a bit buffer, ready for data to be stored into it. */
+void BitBuffer_Init(BitBuffer_t* Buffer)
+{
+ /* Reset the number of stored bits in the buffer */
+ Buffer->Elements = 0;
+
+ /* Reset the data in and out pointer structures in the buffer to the first buffer bit */
+ Buffer->In.CurrentByte = Buffer->Data;
+ Buffer->In.ByteMask = (1 << 0);
+ Buffer->Out.CurrentByte = Buffer->Data;
+ Buffer->Out.ByteMask = (1 << 0);
+}
+
+/** Function to store the given bit into the given bit buffer. */
+void BitBuffer_StoreNextBit(BitBuffer_t* Buffer, bool Bit)
+{
+ /* If the bit to store is true, set the next bit in the buffer */
+ if (Bit)
+ *Buffer->In.CurrentByte |= Buffer->In.ByteMask;
+
+ /* Increment the number of stored bits in the buffer counter */
+ Buffer->Elements++;
+
+ /* Check if the current buffer byte is full of stored bits */
+ if (Buffer->In.ByteMask == (1 << 7))
+ {
+ /* Check if the end of the buffer has been reached, if so reset to start of buffer, otherwise advance to next bit */
+ if (Buffer->In.CurrentByte != &Buffer->Data[sizeof(Buffer->Data) - 1])
+ Buffer->In.CurrentByte++;
+ else
+ Buffer->In.CurrentByte = Buffer->Data;
+
+ /* Reset the storage bit mask in the current buffer byte to the first bit */
+ Buffer->In.ByteMask = (1 << 0);
+ }
+ else
+ {
+ /* Shift the current storage bit mask to the next bit in the current byte */
+ Buffer->In.ByteMask <<= 1;
+ }
+}
+
+/** Function to retrieve the next bit stored in the given bit buffer. */
+bool BitBuffer_GetNextBit(BitBuffer_t* Buffer)
+{
+ /* Retrieve the value of the next bit stored in the buffer */
+ bool Bit = ((*Buffer->Out.CurrentByte & Buffer->Out.ByteMask) != 0);
+
+ /* Clear the buffer bit */
+ *Buffer->Out.CurrentByte &= ~Buffer->Out.ByteMask;
+
+ /* Decrement the number of stored bits in the buffer counter */
+ Buffer->Elements--;
+
+ /* Check if the current buffer byte is empty of stored bits */
+ if (Buffer->Out.ByteMask == (1 << 7))
+ {
+ /* Check if the end of the buffer has been reached, if so reset to start of buffer, otherwise advance to next bit */
+ if (Buffer->Out.CurrentByte != &Buffer->Data[sizeof(Buffer->Data) - 1])
+ Buffer->Out.CurrentByte++;
+ else
+ Buffer->Out.CurrentByte = Buffer->Data;
+
+ /* Reset the retrieval bit mask in the current buffer byte to the first bit */
+ Buffer->Out.ByteMask = (1 << 0);
+ }
+ else
+ {
+ /* Shift the current retrieval bit mask to the next bit in the current byte */
+ Buffer->Out.ByteMask <<= 1;
+ }
+
+ /* Return the retrieved bit from the buffer */
+ return Bit;
+}
diff --git a/Projects/Magstripe/CircularBitBuffer.h b/Projects/Magstripe/CircularBitBuffer.h
new file mode 100644
index 000000000..52410f649
--- /dev/null
+++ b/Projects/Magstripe/CircularBitBuffer.h
@@ -0,0 +1,95 @@
+/*
+ LUFA Library
+ Copyright (C) Dean Camera, 2009.
+
+ dean [at] fourwalledcubicle [dot] com
+ www.fourwalledcubicle.com
+*/
+
+/*
+ Copyright 2009 Denver Gingerich (denver [at] ossguy [dot] com)
+ Copyright 2009 Dean Camera (dean [at] fourwalledcubicle [dot] com)
+
+ Permission to use, copy, modify, and distribute this software
+ and its documentation for any purpose and without fee is hereby
+ granted, provided that the above copyright notice appear in all
+ copies and that both that the copyright notice and this
+ permission notice and warranty disclaimer appear in supporting
+ documentation, and that the name of the author not be used in
+ advertising or publicity pertaining to distribution of the
+ software without specific, written prior permission.
+
+ The author disclaim all warranties with regard to this
+ software, including all implied warranties of merchantability
+ and fitness. In no event shall the author be liable for any
+ special, indirect or consequential damages or any damages
+ whatsoever resulting from loss of use, data or profits, whether
+ in an action of contract, negligence or other tortious action,
+ arising out of or in connection with the use or performance of
+ this software.
+*/
+
+/** \file
+ *
+ * Header file for CircularBitBuffer.c.
+ */
+
+#ifndef _CIRCULARBITBUFFER_H_
+#define _CIRCULARBITBUFFER_H_
+
+ /* Includes: */
+ #include <avr/io.h>
+ #include <stdbool.h>
+
+ #include <LUFA/Common/Common.h>
+
+ /* Macros: */
+ #if (defined(__AVR_AT90USB1287__) || defined(__AVR_AT90USB647__) || \
+ defined(__AVR_AT90USB1286__) || defined(__AVR_AT90USB646__)) || defined(__DOXYGEN__)
+ /** Maximum number of bits which can be stored into a bit buffer. The memory usage is one eigth of this value per buffer. */
+ #define MAX_BITS 20480
+ #else
+ #define MAX_BITS 1024
+ #endif
+
+ /* Type Defines: */
+ /* Type define for a pointer to a bit in a bit buffer. */
+ typedef struct
+ {
+ uint8_t* CurrentByte; /**< Pointer to the current byte in the buffer */
+ uint8_t ByteMask; /**< Mask of the current bit in the buffer */
+ } BitBufferPointer_t;
+
+ /** Type define for a circular packet bit buffer. */
+ typedef struct
+ {
+ uint8_t Data[MAX_BITS / 8]; /**< Buffer to hold the stored bits in packed form */
+ uint16_t Elements; /**< Number of stored bits in the bit buffer */
+
+ BitBufferPointer_t In; /**< Bit pointer to the next storage location in the buffer */
+ BitBufferPointer_t Out; /**< Bit pointer to the next retrieval location in the buffer */
+ } BitBuffer_t;
+
+ /* Function Prototypes: */
+ /** Initializes or resets a given bit buffer, ready to store new bits.
+ *
+ * \param Buffer Bit buffer to initialize
+ */
+ void BitBuffer_Init(BitBuffer_t* Buffer) ATTR_NON_NULL_PTR_ARG(1);
+
+ /** Stores a bit into the next location inside a given bit buffer.
+ *
+ * \param Buffer Bit buffer to store a bit into
+ * \param Bit Bit to store into the buffer
+ */
+ void BitBuffer_StoreNextBit(BitBuffer_t* Buffer, bool Bit) ATTR_NON_NULL_PTR_ARG(1);
+
+ /** Retrieves a bit from the next location inside a given bit buffer.
+ *
+ * \param Buffer Bit buffer to store a bit into
+ *
+ * \return Next bit from the buffer
+ */
+ bool BitBuffer_GetNextBit(BitBuffer_t* Buffer) ATTR_NON_NULL_PTR_ARG(1);
+
+#endif
diff --git a/Projects/Magstripe/Descriptors.c b/Projects/Magstripe/Descriptors.c
new file mode 100644
index 000000000..6811f5266
--- /dev/null
+++ b/Projects/Magstripe/Descriptors.c
@@ -0,0 +1,247 @@
+/*
+ LUFA Library
+ Copyright (C) Dean Camera, 2009.
+
+ dean [at] fourwalledcubicle [dot] com
+ www.fourwalledcubicle.com
+*/
+
+/*
+ Copyright 2009 Denver Gingerich (denver [at] ossguy [dot] com)
+ Copyright 2009 Dean Camera (dean [at] fourwalledcubicle [dot] com)
+
+ Permission to use, copy, modify, and distribute this software
+ and its documentation for any purpose and without fee is hereby
+ granted, provided that the above copyright notice appear in all
+ copies and that both that the copyright notice and this
+ permission notice and warranty disclaimer appear in supporting
+ documentation, and that the name of the author not be used in
+ advertising or publicity pertaining to distribution of the
+ software without specific, written prior permission.
+
+ The author disclaim all warranties with regard to this
+ software, including all implied warranties of merchantability
+ and fitness. In no event shall the author be liable for any
+ special, indirect or consequential damages or any damages
+ whatsoever resulting from loss of use, data or profits, whether
+ in an action of contract, negligence or other tortious action,
+ arising out of or in connection with the use or performance of
+ this software.
+*/
+
+/** \file
+ *
+ * USB Device Descriptors, for library use when in USB device mode. Descriptors are special
+ * computer-readable structures which the host requests upon device enumeration, to determine
+ * the device's capabilities and functions.
+ */
+
+#include "Descriptors.h"
+
+/** HID report descriptor. This is a HID class specific descriptor, which defines the structure of the
+ * reports sent and received by the HID device to and from the USB host. It indicates what data is sent,
+ * where in the report each element is located and exactly how the data should be interpreted and used.
+ *
+ * See the HID class specification for more information on HID report descriptors.
+ */
+USB_Descriptor_HIDReport_Datatype_t PROGMEM KeyboardReport[] =
+{
+ 0x05, 0x01, /* Usage Page (Generic Desktop) */
+ 0x09, 0x06, /* Usage (Keyboard) */
+ 0xa1, 0x01, /* Collection (Application) */
+ 0x05, 0x07, /* Usage Page (Key Codes) */
+ 0x19, 0xe0, /* Usage Minimum (Keyboard LeftControl) */
+ 0x29, 0xe7, /* Usage Maximum (Keyboard Right GUI) */
+ 0x15, 0x00, /* Logical Minimum (0) */
+ 0x25, 0x01, /* Logical Maximum (1) */
+ 0x75, 0x01, /* Report Size (1) */
+ 0x95, 0x08, /* Report Count (8) */
+ 0x81, 0x02, /* Input (Data, Variable, Absolute) */
+ 0x95, 0x01, /* Report Count (1) */
+ 0x75, 0x08, /* Report Size (8) */
+ 0x81, 0x03, /* Input (Const, Variable, Absolute) */
+ 0x95, 0x01, /* Report Count (1) */
+ 0x75, 0x08, /* Report Size (8) */
+ 0x15, 0x00, /* Logical Minimum (0) */
+ 0x25, 0x65, /* Logical Maximum (101) */
+ 0x05, 0x07, /* Usage Page (Keyboard) */
+ 0x19, 0x00, /* Usage Minimum (Reserved (no event indicated)) */
+ 0x29, 0x65, /* Usage Maximum (Keyboard Application) */
+ 0x81, 0x00, /* Input (Data, Array, Absolute) */
+ 0xc0 /* End Collection */
+};
+
+/** Device descriptor structure. This descriptor, located in FLASH memory, describes the overall
+ * device characteristics, including the supported USB version, control endpoint size and the
+ * number of device configurations. The descriptor is read out by the USB host when the enumeration
+ * process begins.
+ */
+USB_Descriptor_Device_t PROGMEM DeviceDescriptor =
+{
+ Header: {Size: sizeof(USB_Descriptor_Device_t), Type: DTYPE_Device},
+
+ USBSpecification: VERSION_BCD(01.10),
+ Class: 0x00,
+ SubClass: 0x00,
+ Protocol: 0x00,
+
+ Endpoint0Size: 8,
+
+ VendorID: 0x03EB,
+ ProductID: 0x2042,
+ ReleaseNumber: 0x0000,
+
+ ManufacturerStrIndex: 0x01,
+ ProductStrIndex: 0x02,
+ SerialNumStrIndex: NO_DESCRIPTOR,
+
+ NumberOfConfigurations: 1
+};
+
+/** Configuration descriptor structure. This descriptor, located in FLASH memory, describes the usage
+ * of the device in one of its supported configurations, including information about any device interfaces
+ * and endpoints. The descriptor is read out by the USB host during the enumeration process when selecting
+ * a configuration so that the host may correctly communicate with the USB device.
+ */
+USB_Descriptor_Configuration_t PROGMEM ConfigurationDescriptor =
+{
+ Config:
+ {
+ Header: {Size: sizeof(USB_Descriptor_Configuration_Header_t), Type: DTYPE_Configuration},
+
+ TotalConfigurationSize: sizeof(USB_Descriptor_Configuration_t),
+ TotalInterfaces: 1,
+
+ ConfigurationNumber: 1,
+ ConfigurationStrIndex: NO_DESCRIPTOR,
+
+ ConfigAttributes: (USB_CONFIG_ATTR_BUSPOWERED | USB_CONFIG_ATTR_SELFPOWERED),
+
+ MaxPowerConsumption: USB_CONFIG_POWER_MA(100)
+ },
+
+ Interface:
+ {
+ Header: {Size: sizeof(USB_Descriptor_Interface_t), Type: DTYPE_Interface},
+
+ InterfaceNumber: 0x00,
+ AlternateSetting: 0x00,
+
+ TotalEndpoints: 1,
+
+ Class: 0x03,
+ SubClass: 0x01,
+ Protocol: 0x01,
+
+ InterfaceStrIndex: NO_DESCRIPTOR
+ },
+
+ KeyboardHID:
+ {
+ Header: {Size: sizeof(USB_Descriptor_HID_t), Type: DTYPE_HID},
+
+ HIDSpec: VERSION_BCD(01.11),
+ CountryCode: 0x00,
+ TotalHIDReports: 0x01,
+ HIDReportType: DTYPE_Report,
+ HIDReportLength: sizeof(KeyboardReport)
+ },
+
+ KeyboardEndpoint:
+ {
+ Header: {Size: sizeof(USB_Descriptor_Endpoint_t), Type: DTYPE_Endpoint},
+
+ EndpointAddress: (ENDPOINT_DESCRIPTOR_DIR_IN | KEYBOARD_EPNUM),
+ Attributes: EP_TYPE_INTERRUPT,
+ EndpointSize: KEYBOARD_EPSIZE,
+ PollingIntervalMS: 0x02
+ },
+};
+
+/** Language descriptor structure. This descriptor, located in FLASH memory, is returned when the host requests
+ * the string descriptor with index 0 (the first index). It is actually an array of 16-bit integers, which indicate
+ * via the language ID table available at USB.org what languages the device supports for its string descriptors. */
+USB_Descriptor_String_t PROGMEM LanguageString =
+{
+ Header: {Size: USB_STRING_LEN(1), Type: DTYPE_String},
+
+ UnicodeString: {LANGUAGE_ID_ENG}
+};
+
+/** Manufacturer descriptor string. This is a Unicode string containing the manufacturer's details in human readable
+ * form, and is read out upon request by the host when the appropriate string ID is requested, listed in the Device
+ * Descriptor.
+ */
+USB_Descriptor_String_t PROGMEM ManufacturerString =
+{
+ Header: {Size: USB_STRING_LEN(32), Type: DTYPE_String},
+
+ UnicodeString: L"Dean Camera and Denver Gingerich"
+};
+
+/** Product descriptor string. This is a Unicode string containing the product's details in human readable form,
+ * and is read out upon request by the host when the appropriate string ID is requested, listed in the Device
+ * Descriptor.
+ */
+USB_Descriptor_String_t PROGMEM ProductString =
+{
+ Header: {Size: USB_STRING_LEN(20), Type: DTYPE_String},
+
+ UnicodeString: L"Magnetic Card Reader"
+};
+
+/** This function is called by the library when in device mode, and must be overridden (see StdDescriptors.h
+ * documentation) by the application code so that the address and size of a requested descriptor can be given
+ * to the USB library. When the device recieves a Get Descriptor request on the control endpoint, this function
+ * is called so that the descriptor details can be passed back and the appropriate descriptor sent back to the
+ * USB host.
+ */
+uint16_t USB_GetDescriptor(const uint16_t wValue, const uint8_t wIndex, void** const DescriptorAddress)
+{
+ const uint8_t DescriptorType = (wValue >> 8);
+ const uint8_t DescriptorNumber = (wValue & 0xFF);
+
+ void* Address = NULL;
+ uint16_t Size = NO_DESCRIPTOR;
+
+ switch (DescriptorType)
+ {
+ case DTYPE_Device:
+ Address = DESCRIPTOR_ADDRESS(DeviceDescriptor);
+ Size = sizeof(USB_Descriptor_Device_t);
+ break;
+ case DTYPE_Configuration:
+ Address = DESCRIPTOR_ADDRESS(ConfigurationDescriptor);
+ Size = sizeof(USB_Descriptor_Configuration_t);
+ break;
+ case DTYPE_String:
+ switch (DescriptorNumber)
+ {
+ case 0x00:
+ Address = DESCRIPTOR_ADDRESS(LanguageString);
+ Size = pgm_read_byte(&LanguageString.Header.Size);
+ break;
+ case 0x01:
+ Address = DESCRIPTOR_ADDRESS(ManufacturerString);
+ Size = pgm_read_byte(&ManufacturerString.Header.Size);
+ break;
+ case 0x02:
+ Address = DESCRIPTOR_ADDRESS(ProductString);
+ Size = pgm_read_byte(&ProductString.Header.Size);
+ break;
+ }
+
+ break;
+ case DTYPE_HID:
+ Address = DESCRIPTOR_ADDRESS(ConfigurationDescriptor.KeyboardHID);
+ Size = sizeof(USB_Descriptor_HID_t);
+ break;
+ case DTYPE_Report:
+ Address = DESCRIPTOR_ADDRESS(KeyboardReport);
+ Size = sizeof(KeyboardReport);
+ break;
+ }
+
+ *DescriptorAddress = Address;
+ return Size;
+}
diff --git a/Projects/Magstripe/Descriptors.h b/Projects/Magstripe/Descriptors.h
new file mode 100644
index 000000000..2f5854523
--- /dev/null
+++ b/Projects/Magstripe/Descriptors.h
@@ -0,0 +1,98 @@
+/*
+ LUFA Library
+ Copyright (C) Dean Camera, 2009.
+
+ dean [at] fourwalledcubicle [dot] com
+ www.fourwalledcubicle.com
+*/
+
+/*
+ Copyright 2009 Denver Gingerich (denver [at] ossguy [dot] com)
+ Copyright 2009 Dean Camera (dean [at] fourwalledcubicle [dot] com)
+
+ Permission to use, copy, modify, and distribute this software
+ and its documentation for any purpose and without fee is hereby
+ granted, provided that the above copyright notice appear in all
+ copies and that both that the copyright notice and this
+ permission notice and warranty disclaimer appear in supporting
+ documentation, and that the name of the author not be used in
+ advertising or publicity pertaining to distribution of the
+ software without specific, written prior permission.
+
+ The author disclaim all warranties with regard to this
+ software, including all implied warranties of merchantability
+ and fitness. In no event shall the author be liable for any
+ special, indirect or consequential damages or any damages
+ whatsoever resulting from loss of use, data or profits, whether
+ in an action of contract, negligence or other tortious action,
+ arising out of or in connection with the use or performance of
+ this software.
+*/
+
+/** \file
+ *
+ * Header file for Descriptors.c.
+ */
+
+#ifndef _DESCRIPTORS_H_
+#define _DESCRIPTORS_H_
+
+ /* Includes: */
+ #include <LUFA/Drivers/USB/USB.h>
+
+ #include <avr/pgmspace.h>
+
+ /* Type Defines: */
+ /** Type define for the HID class specific HID descriptor. A HID descriptor is used in HID class devices
+ * to give information about the HID device, including the HID specification used, and the report descriptors
+ * the device contains to describe how the HID device should be controlled.
+ */
+ typedef struct
+ {
+ USB_Descriptor_Header_t Header; /**< Standard USB descriptor header */
+
+ uint16_t HIDSpec; /**< HID specification implemented by the device, in BCD form */
+ uint8_t CountryCode; /**< Country code for the country the HID device is localised for */
+
+ uint8_t TotalHIDReports; /**< Total number of HID reports linked to this HID interface */
+
+ uint8_t HIDReportType; /**< Type of the first HID report descriptor */
+ uint16_t HIDReportLength; /**< Length of the first HID report descriptor */
+ } USB_Descriptor_HID_t;
+
+ /** Type define for the data type used for the HID Report descriptor data elements. A HID report
+ * descriptor contains an array of this data type, indicating how the reports from and to the
+ * device are formatted and how the report data is to be used by the host.
+ */
+ typedef uint8_t USB_Descriptor_HIDReport_Datatype_t;
+
+ /** Type define for the device configuration descriptor structure. This must be defined in the
+ * application code, as the configuration descriptor contains several sub-descriptors which
+ * vary between devices, and which describe the device's usage to the host.
+ */
+ typedef struct
+ {
+ USB_Descriptor_Configuration_Header_t Config; /**< Configuration descriptor header structure */
+ USB_Descriptor_Interface_t Interface; /**< Keyboard interface descriptor */
+ USB_Descriptor_HID_t KeyboardHID; /**< Keyboard HID descriptor */
+ USB_Descriptor_Endpoint_t KeyboardEndpoint; /**< Keyboard key report endpoint descriptor */
+ } USB_Descriptor_Configuration_t;
+
+ /* Macros: */
+ /** Endpoint number of the keyboard key press reporting endpoint. */
+ #define KEYBOARD_EPNUM 1
+
+ /** Size of the keyboard report endpoints, in bytes. */
+ #define KEYBOARD_EPSIZE 8
+
+ /** Descriptor type value for a HID descriptor. */
+ #define DTYPE_HID 0x21
+
+ /** Descriptor type value for a HID report. */
+ #define DTYPE_Report 0x22
+
+ /* Function Prototypes: */
+ uint16_t USB_GetDescriptor(const uint16_t wValue, const uint8_t wIndex, void** const DescriptorAddress)
+ ATTR_WARN_UNUSED_RESULT ATTR_NON_NULL_PTR_ARG(3);
+
+#endif
diff --git a/Projects/Magstripe/Doxygen.conf b/Projects/Magstripe/Doxygen.conf
new file mode 100644
index 000000000..4d0abf9b5
--- /dev/null
+++ b/Projects/Magstripe/Doxygen.conf
@@ -0,0 +1,1485 @@
+# Doxyfile 1.5.7.1
+
+# This file describes the settings to be used by the documentation system
+# doxygen (www.doxygen.org) for a project
+#
+# All text after a hash (#) is considered a comment and will be ignored
+# The format is:
+# TAG = value [value, ...]
+# For lists items can also be appended using:
+# TAG += value [value, ...]
+# Values that contain spaces should be placed between quotes (" ")
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+
+# This tag specifies the encoding used for all characters in the config file
+# that follow. The default is UTF-8 which is also the encoding used for all
+# text before the first occurrence of this tag. Doxygen uses libiconv (or the
+# iconv built into libc) for the transcoding. See
+# http://www.gnu.org/software/libiconv for the list of possible encodings.
+
+DOXYFILE_ENCODING = UTF-8
+
+# The PROJECT_NAME tag is a single word (or a sequence of words surrounded
+# by quotes) that should identify the project.
+
+PROJECT_NAME = "Denver Gingerich's Stripe Snoop Project"
+
+# The PROJECT_NUMBER tag can be used to enter a project or revision number.
+# This could be handy for archiving the generated documentation or
+# if some version control system is used.
+
+PROJECT_NUMBER = 0.0.0
+
+# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute)
+# base path where the generated documentation will be put.
+# If a relative path is entered, it will be relative to the location
+# where doxygen was started. If left blank the current directory will be used.
+
+OUTPUT_DIRECTORY = ./Documentation/
+
+# If the CREATE_SUBDIRS tag is set to YES, then doxygen will create
+# 4096 sub-directories (in 2 levels) under the output directory of each output
+# format and will distribute the generated files over these directories.
+# Enabling this option can be useful when feeding doxygen a huge amount of
+# source files, where putting all generated files in the same directory would
+# otherwise cause performance problems for the file system.
+
+CREATE_SUBDIRS = YES
+
+# The OUTPUT_LANGUAGE tag is used to specify the language in which all
+# documentation generated by doxygen is written. Doxygen will use this
+# information to generate all constant output in the proper language.
+# The default language is English, other supported languages are:
+# Afrikaans, Arabic, Brazilian, Catalan, Chinese, Chinese-Traditional,
+# Croatian, Czech, Danish, Dutch, Farsi, Finnish, French, German, Greek,
+# Hungarian, Italian, Japanese, Japanese-en (Japanese with English messages),
+# Korean, Korean-en, Lithuanian, Norwegian, Macedonian, Persian, Polish,
+# Portuguese, Romanian, Russian, Serbian, Serbian-Cyrilic, Slovak, Slovene,
+# Spanish, Swedish, and Ukrainian.
+
+OUTPUT_LANGUAGE = English
+
+# If the BRIEF_MEMBER_DESC tag is set to YES (the default) Doxygen will
+# include brief member descriptions after the members that are listed in
+# the file and class documentation (similar to JavaDoc).
+# Set to NO to disable this.
+
+BRIEF_MEMBER_DESC = YES
+
+# If the REPEAT_BRIEF tag is set to YES (the default) Doxygen will prepend
+# the brief description of a member or function before the detailed description.
+# Note: if both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the
+# brief descriptions will be completely suppressed.
+
+REPEAT_BRIEF = YES
+
+# This tag implements a quasi-intelligent brief description abbreviator
+# that is used to form the text in various listings. Each string
+# in this list, if found as the leading text of the brief description, will be
+# stripped from the text and the result after processing the whole list, is
+# used as the annotated text. Otherwise, the brief description is used as-is.
+# If left blank, the following values are used ("$name" is automatically
+# replaced with the name of the entity): "The $name class" "The $name widget"
+# "The $name file" "is" "provides" "specifies" "contains"
+# "represents" "a" "an" "the"
+
+ABBREVIATE_BRIEF = "The $name class" \
+ "The $name widget" \
+ "The $name file" \
+ is \
+ provides \
+ specifies \
+ contains \
+ represents \
+ a \
+ an \
+ the
+
+# If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then
+# Doxygen will generate a detailed section even if there is only a brief
+# description.
+
+ALWAYS_DETAILED_SEC = NO
+
+# If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all
+# inherited members of a class in the documentation of that class as if those
+# members were ordinary class members. Constructors, destructors and assignment
+# operators of the base classes will not be shown.
+
+INLINE_INHERITED_MEMB = NO
+
+# If the FULL_PATH_NAMES tag is set to YES then Doxygen will prepend the full
+# path before files name in the file list and in the header files. If set
+# to NO the shortest path that makes the file name unique will be used.
+
+FULL_PATH_NAMES = YES
+
+# If the FULL_PATH_NAMES tag is set to YES then the STRIP_FROM_PATH tag
+# can be used to strip a user-defined part of the path. Stripping is
+# only done if one of the specified strings matches the left-hand part of
+# the path. The tag can be used to show relative paths in the file list.
+# If left blank the directory from which doxygen is run is used as the
+# path to strip.
+
+STRIP_FROM_PATH =
+
+# The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of
+# the path mentioned in the documentation of a class, which tells
+# the reader which header file to include in order to use a class.
+# If left blank only the name of the header file containing the class
+# definition is used. Otherwise one should specify the include paths that
+# are normally passed to the compiler using the -I flag.
+
+STRIP_FROM_INC_PATH =
+
+# If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter
+# (but less readable) file names. This can be useful is your file systems
+# doesn't support long names like on DOS, Mac, or CD-ROM.
+
+SHORT_NAMES = YES
+
+# If the JAVADOC_AUTOBRIEF tag is set to YES then Doxygen
+# will interpret the first line (until the first dot) of a JavaDoc-style
+# comment as the brief description. If set to NO, the JavaDoc
+# comments will behave just like regular Qt-style comments
+# (thus requiring an explicit @brief command for a brief description.)
+
+JAVADOC_AUTOBRIEF = NO
+
+# If the QT_AUTOBRIEF tag is set to YES then Doxygen will
+# interpret the first line (until the first dot) of a Qt-style
+# comment as the brief description. If set to NO, the comments
+# will behave just like regular Qt-style comments (thus requiring
+# an explicit \brief command for a brief description.)
+
+QT_AUTOBRIEF = NO
+
+# The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make Doxygen
+# treat a multi-line C++ special comment block (i.e. a block of //! or ///
+# comments) as a brief description. This used to be the default behaviour.
+# The new default is to treat a multi-line C++ comment block as a detailed
+# description. Set this tag to YES if you prefer the old behaviour instead.
+
+MULTILINE_CPP_IS_BRIEF = NO
+
+# If the INHERIT_DOCS tag is set to YES (the default) then an undocumented
+# member inherits the documentation from any documented member that it
+# re-implements.
+
+INHERIT_DOCS = YES
+
+# If the SEPARATE_MEMBER_PAGES tag is set to YES, then doxygen will produce
+# a new page for each member. If set to NO, the documentation of a member will
+# be part of the file/class/namespace that contains it.
+
+SEPARATE_MEMBER_PAGES = NO
+
+# The TAB_SIZE tag can be used to set the number of spaces in a tab.
+# Doxygen uses this value to replace tabs by spaces in code fragments.
+
+TAB_SIZE = 4
+
+# This tag can be used to specify a number of aliases that acts
+# as commands in the documentation. An alias has the form "name=value".
+# For example adding "sideeffect=\par Side Effects:\n" will allow you to
+# put the command \sideeffect (or @sideeffect) in the documentation, which
+# will result in a user-defined paragraph with heading "Side Effects:".
+# You can put \n's in the value part of an alias to insert newlines.
+
+ALIASES =
+
+# Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C
+# sources only. Doxygen will then generate output that is more tailored for C.
+# For instance, some of the names that are used will be different. The list
+# of all members will be omitted, etc.
+
+OPTIMIZE_OUTPUT_FOR_C = YES
+
+# Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java
+# sources only. Doxygen will then generate output that is more tailored for
+# Java. For instance, namespaces will be presented as packages, qualified
+# scopes will look different, etc.
+
+OPTIMIZE_OUTPUT_JAVA = NO
+
+# Set the OPTIMIZE_FOR_FORTRAN tag to YES if your project consists of Fortran
+# sources only. Doxygen will then generate output that is more tailored for
+# Fortran.
+
+OPTIMIZE_FOR_FORTRAN = NO
+
+# Set the OPTIMIZE_OUTPUT_VHDL tag to YES if your project consists of VHDL
+# sources. Doxygen will then generate output that is tailored for
+# VHDL.
+
+OPTIMIZE_OUTPUT_VHDL = NO
+
+# If you use STL classes (i.e. std::string, std::vector, etc.) but do not want
+# to include (a tag file for) the STL sources as input, then you should
+# set this tag to YES in order to let doxygen match functions declarations and
+# definitions whose arguments contain STL classes (e.g. func(std::string); v.s.
+# func(std::string) {}). This also make the inheritance and collaboration
+# diagrams that involve STL classes more complete and accurate.
+
+BUILTIN_STL_SUPPORT = NO
+
+# If you use Microsoft's C++/CLI language, you should set this option to YES to
+# enable parsing support.
+
+CPP_CLI_SUPPORT = NO
+
+# Set the SIP_SUPPORT tag to YES if your project consists of sip sources only.
+# Doxygen will parse them like normal C++ but will assume all classes use public
+# instead of private inheritance when no explicit protection keyword is present.
+
+SIP_SUPPORT = NO
+
+# For Microsoft's IDL there are propget and propput attributes to indicate getter
+# and setter methods for a property. Setting this option to YES (the default)
+# will make doxygen to replace the get and set methods by a property in the
+# documentation. This will only work if the methods are indeed getting or
+# setting a simple type. If this is not the case, or you want to show the
+# methods anyway, you should set this option to NO.
+
+IDL_PROPERTY_SUPPORT = YES
+
+# If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC
+# tag is set to YES, then doxygen will reuse the documentation of the first
+# member in the group (if any) for the other members of the group. By default
+# all members of a group must be documented explicitly.
+
+DISTRIBUTE_GROUP_DOC = NO
+
+# Set the SUBGROUPING tag to YES (the default) to allow class member groups of
+# the same type (for instance a group of public functions) to be put as a
+# subgroup of that type (e.g. under the Public Functions section). Set it to
+# NO to prevent subgrouping. Alternatively, this can be done per class using
+# the \nosubgrouping command.
+
+SUBGROUPING = YES
+
+# When TYPEDEF_HIDES_STRUCT is enabled, a typedef of a struct, union, or enum
+# is documented as struct, union, or enum with the name of the typedef. So
+# typedef struct TypeS {} TypeT, will appear in the documentation as a struct
+# with name TypeT. When disabled the typedef will appear as a member of a file,
+# namespace, or class. And the struct will be named TypeS. This can typically
+# be useful for C code in case the coding convention dictates that all compound
+# types are typedef'ed and only the typedef is referenced, never the tag name.
+
+TYPEDEF_HIDES_STRUCT = NO
+
+# The SYMBOL_CACHE_SIZE determines the size of the internal cache use to
+# determine which symbols to keep in memory and which to flush to disk.
+# When the cache is full, less often used symbols will be written to disk.
+# For small to medium size projects (<1000 input files) the default value is
+# probably good enough. For larger projects a too small cache size can cause
+# doxygen to be busy swapping symbols to and from disk most of the time
+# causing a significant performance penality.
+# If the system has enough physical memory increasing the cache will improve the
+# performance by keeping more symbols in memory. Note that the value works on
+# a logarithmic scale so increasing the size by one will rougly double the
+# memory usage. The cache size is given by this formula:
+# 2^(16+SYMBOL_CACHE_SIZE). The valid range is 0..9, the default is 0,
+# corresponding to a cache size of 2^16 = 65536 symbols
+
+SYMBOL_CACHE_SIZE = 0
+
+#---------------------------------------------------------------------------
+# Build related configuration options
+#---------------------------------------------------------------------------
+
+# If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in
+# documentation are documented, even if no documentation was available.
+# Private class members and static file members will be hidden unless
+# the EXTRACT_PRIVATE and EXTRACT_STATIC tags are set to YES
+
+EXTRACT_ALL = YES
+
+# If the EXTRACT_PRIVATE tag is set to YES all private members of a class
+# will be included in the documentation.
+
+EXTRACT_PRIVATE = YES
+
+# If the EXTRACT_STATIC tag is set to YES all static members of a file
+# will be included in the documentation.
+
+EXTRACT_STATIC = YES
+
+# If the EXTRACT_LOCAL_CLASSES tag is set to YES classes (and structs)
+# defined locally in source files will be included in the documentation.
+# If set to NO only classes defined in header files are included.
+
+EXTRACT_LOCAL_CLASSES = YES
+
+# This flag is only useful for Objective-C code. When set to YES local
+# methods, which are defined in the implementation section but not in
+# the interface are included in the documentation.
+# If set to NO (the default) only methods in the interface are included.
+
+EXTRACT_LOCAL_METHODS = NO
+
+# If this flag is set to YES, the members of anonymous namespaces will be
+# extracted and appear in the documentation as a namespace called
+# 'anonymous_namespace{file}', where file will be replaced with the base
+# name of the file that contains the anonymous namespace. By default
+# anonymous namespace are hidden.
+
+EXTRACT_ANON_NSPACES = NO
+
+# If the HIDE_UNDOC_MEMBERS tag is set to YES, Doxygen will hide all
+# undocumented members of documented classes, files or namespaces.
+# If set to NO (the default) these members will be included in the
+# various overviews, but no documentation section is generated.
+# This option has no effect if EXTRACT_ALL is enabled.
+
+HIDE_UNDOC_MEMBERS = NO
+
+# If the HIDE_UNDOC_CLASSES tag is set to YES, Doxygen will hide all
+# undocumented classes that are normally visible in the class hierarchy.
+# If set to NO (the default) these classes will be included in the various
+# overviews. This option has no effect if EXTRACT_ALL is enabled.
+
+HIDE_UNDOC_CLASSES = NO
+
+# If the HIDE_FRIEND_COMPOUNDS tag is set to YES, Doxygen will hide all
+# friend (class|struct|union) declarations.
+# If set to NO (the default) these declarations will be included in the
+# documentation.
+
+HIDE_FRIEND_COMPOUNDS = NO
+
+# If the HIDE_IN_BODY_DOCS tag is set to YES, Doxygen will hide any
+# documentation blocks found inside the body of a function.
+# If set to NO (the default) these blocks will be appended to the
+# function's detailed documentation block.
+
+HIDE_IN_BODY_DOCS = NO
+
+# The INTERNAL_DOCS tag determines if documentation
+# that is typed after a \internal command is included. If the tag is set
+# to NO (the default) then the documentation will be excluded.
+# Set it to YES to include the internal documentation.
+
+INTERNAL_DOCS = NO
+
+# If the CASE_SENSE_NAMES tag is set to NO then Doxygen will only generate
+# file names in lower-case letters. If set to YES upper-case letters are also
+# allowed. This is useful if you have classes or files whose names only differ
+# in case and if your file system supports case sensitive file names. Windows
+# and Mac users are advised to set this option to NO.
+
+CASE_SENSE_NAMES = NO
+
+# If the HIDE_SCOPE_NAMES tag is set to NO (the default) then Doxygen
+# will show members with their full class and namespace scopes in the
+# documentation. If set to YES the scope will be hidden.
+
+HIDE_SCOPE_NAMES = NO
+
+# If the SHOW_INCLUDE_FILES tag is set to YES (the default) then Doxygen
+# will put a list of the files that are included by a file in the documentation
+# of that file.
+
+SHOW_INCLUDE_FILES = YES
+
+# If the INLINE_INFO tag is set to YES (the default) then a tag [inline]
+# is inserted in the documentation for inline members.
+
+INLINE_INFO = YES
+
+# If the SORT_MEMBER_DOCS tag is set to YES (the default) then doxygen
+# will sort the (detailed) documentation of file and class members
+# alphabetically by member name. If set to NO the members will appear in
+# declaration order.
+
+SORT_MEMBER_DOCS = YES
+
+# If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the
+# brief documentation of file, namespace and class members alphabetically
+# by member name. If set to NO (the default) the members will appear in
+# declaration order.
+
+SORT_BRIEF_DOCS = NO
+
+# If the SORT_GROUP_NAMES tag is set to YES then doxygen will sort the
+# hierarchy of group names into alphabetical order. If set to NO (the default)
+# the group names will appear in their defined order.
+
+SORT_GROUP_NAMES = NO
+
+# If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be
+# sorted by fully-qualified names, including namespaces. If set to
+# NO (the default), the class list will be sorted only by class name,
+# not including the namespace part.
+# Note: This option is not very useful if HIDE_SCOPE_NAMES is set to YES.
+# Note: This option applies only to the class list, not to the
+# alphabetical list.
+
+SORT_BY_SCOPE_NAME = NO
+
+# The GENERATE_TODOLIST tag can be used to enable (YES) or
+# disable (NO) the todo list. This list is created by putting \todo
+# commands in the documentation.
+
+GENERATE_TODOLIST = NO
+
+# The GENERATE_TESTLIST tag can be used to enable (YES) or
+# disable (NO) the test list. This list is created by putting \test
+# commands in the documentation.
+
+GENERATE_TESTLIST = NO
+
+# The GENERATE_BUGLIST tag can be used to enable (YES) or
+# disable (NO) the bug list. This list is created by putting \bug
+# commands in the documentation.
+
+GENERATE_BUGLIST = NO
+
+# The GENERATE_DEPRECATEDLIST tag can be used to enable (YES) or
+# disable (NO) the deprecated list. This list is created by putting
+# \deprecated commands in the documentation.
+
+GENERATE_DEPRECATEDLIST= YES
+
+# The ENABLED_SECTIONS tag can be used to enable conditional
+# documentation sections, marked by \if sectionname ... \endif.
+
+ENABLED_SECTIONS =
+
+# The MAX_INITIALIZER_LINES tag determines the maximum number of lines
+# the initial value of a variable or define consists of for it to appear in
+# the documentation. If the initializer consists of more lines than specified
+# here it will be hidden. Use a value of 0 to hide initializers completely.
+# The appearance of the initializer of individual variables and defines in the
+# documentation can be controlled using \showinitializer or \hideinitializer
+# command in the documentation regardless of this setting.
+
+MAX_INITIALIZER_LINES = 30
+
+# Set the SHOW_USED_FILES tag to NO to disable the list of files generated
+# at the bottom of the documentation of classes and structs. If set to YES the
+# list will mention the files that were used to generate the documentation.
+
+SHOW_USED_FILES = YES
+
+# If the sources in your project are distributed over multiple directories
+# then setting the SHOW_DIRECTORIES tag to YES will show the directory hierarchy
+# in the documentation. The default is NO.
+
+SHOW_DIRECTORIES = YES
+
+# Set the SHOW_FILES tag to NO to disable the generation of the Files page.
+# This will remove the Files entry from the Quick Index and from the
+# Folder Tree View (if specified). The default is YES.
+
+SHOW_FILES = YES
+
+# Set the SHOW_NAMESPACES tag to NO to disable the generation of the
+# Namespaces page. This will remove the Namespaces entry from the Quick Index
+# and from the Folder Tree View (if specified). The default is YES.
+
+SHOW_NAMESPACES = YES
+
+# The FILE_VERSION_FILTER tag can be used to specify a program or script that
+# doxygen should invoke to get the current version for each file (typically from
+# the version control system). Doxygen will invoke the program by executing (via
+# popen()) the command <command> <input-file>, where <command> is the value of
+# the FILE_VERSION_FILTER tag, and <input-file> is the name of an input file
+# provided by doxygen. Whatever the program writes to standard output
+# is used as the file version. See the manual for examples.
+
+FILE_VERSION_FILTER =
+
+# The LAYOUT_FILE tag can be used to specify a layout file which will be parsed by
+# doxygen. The layout file controls the global structure of the generated output files
+# in an output format independent way. The create the layout file that represents
+# doxygen's defaults, run doxygen with the -l option. You can optionally specify a
+# file name after the option, if omitted DoxygenLayout.xml will be used as the name
+# of the layout file.
+
+LAYOUT_FILE =
+
+#---------------------------------------------------------------------------
+# configuration options related to warning and progress messages
+#---------------------------------------------------------------------------
+
+# The QUIET tag can be used to turn on/off the messages that are generated
+# by doxygen. Possible values are YES and NO. If left blank NO is used.
+
+QUIET = YES
+
+# The WARNINGS tag can be used to turn on/off the warning messages that are
+# generated by doxygen. Possible values are YES and NO. If left blank
+# NO is used.
+
+WARNINGS = YES
+
+# If WARN_IF_UNDOCUMENTED is set to YES, then doxygen will generate warnings
+# for undocumented members. If EXTRACT_ALL is set to YES then this flag will
+# automatically be disabled.
+
+WARN_IF_UNDOCUMENTED = YES
+
+# If WARN_IF_DOC_ERROR is set to YES, doxygen will generate warnings for
+# potential errors in the documentation, such as not documenting some
+# parameters in a documented function, or documenting parameters that
+# don't exist or using markup commands wrongly.
+
+WARN_IF_DOC_ERROR = YES
+
+# This WARN_NO_PARAMDOC option can be abled to get warnings for
+# functions that are documented, but have no documentation for their parameters
+# or return value. If set to NO (the default) doxygen will only warn about
+# wrong or incomplete parameter documentation, but not about the absence of
+# documentation.
+
+WARN_NO_PARAMDOC = YES
+
+# The WARN_FORMAT tag determines the format of the warning messages that
+# doxygen can produce. The string should contain the $file, $line, and $text
+# tags, which will be replaced by the file and line number from which the
+# warning originated and the warning text. Optionally the format may contain
+# $version, which will be replaced by the version of the file (if it could
+# be obtained via FILE_VERSION_FILTER)
+
+WARN_FORMAT = "$file:$line: $text"
+
+# The WARN_LOGFILE tag can be used to specify a file to which warning
+# and error messages should be written. If left blank the output is written
+# to stderr.
+
+WARN_LOGFILE =
+
+#---------------------------------------------------------------------------
+# configuration options related to the input files
+#---------------------------------------------------------------------------
+
+# The INPUT tag can be used to specify the files and/or directories that contain
+# documented source files. You may enter file names like "myfile.cpp" or
+# directories like "/usr/src/myproject". Separate the files or directories
+# with spaces.
+
+INPUT = ./
+
+# This tag can be used to specify the character encoding of the source files
+# that doxygen parses. Internally doxygen uses the UTF-8 encoding, which is
+# also the default input encoding. Doxygen uses libiconv (or the iconv built
+# into libc) for the transcoding. See http://www.gnu.org/software/libiconv for
+# the list of possible encodings.
+
+INPUT_ENCODING = UTF-8
+
+# If the value of the INPUT tag contains directories, you can use the
+# FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp
+# and *.h) to filter out the source-files in the directories. If left
+# blank the following patterns are tested:
+# *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx
+# *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm *.py *.f90
+
+FILE_PATTERNS = *.h \
+ *.c \
+ *.txt
+
+# The RECURSIVE tag can be used to turn specify whether or not subdirectories
+# should be searched for input files as well. Possible values are YES and NO.
+# If left blank NO is used.
+
+RECURSIVE = YES
+
+# The EXCLUDE tag can be used to specify files and/or directories that should
+# excluded from the INPUT source files. This way you can easily exclude a
+# subdirectory from a directory tree whose root is specified with the INPUT tag.
+
+EXCLUDE =
+
+# The EXCLUDE_SYMLINKS tag can be used select whether or not files or
+# directories that are symbolic links (a Unix filesystem feature) are excluded
+# from the input.
+
+EXCLUDE_SYMLINKS = NO
+
+# If the value of the INPUT tag contains directories, you can use the
+# EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude
+# certain files from those directories. Note that the wildcards are matched
+# against the file with absolute path, so to exclude all test directories
+# for example use the pattern */test/*
+
+EXCLUDE_PATTERNS = */LowLevel/USBMode.h
+
+# The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names
+# (namespaces, classes, functions, etc.) that should be excluded from the
+# output. The symbol name can be a fully qualified name, a word, or if the
+# wildcard * is used, a substring. Examples: ANamespace, AClass,
+# AClass::ANamespace, ANamespace::*Test
+
+EXCLUDE_SYMBOLS = __*
+
+# The EXAMPLE_PATH tag can be used to specify one or more files or
+# directories that contain example code fragments that are included (see
+# the \include command).
+
+EXAMPLE_PATH =
+
+# If the value of the EXAMPLE_PATH tag contains directories, you can use the
+# EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp
+# and *.h) to filter out the source-files in the directories. If left
+# blank all files are included.
+
+EXAMPLE_PATTERNS = *
+
+# If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be
+# searched for input files to be used with the \include or \dontinclude
+# commands irrespective of the value of the RECURSIVE tag.
+# Possible values are YES and NO. If left blank NO is used.
+
+EXAMPLE_RECURSIVE = NO
+
+# The IMAGE_PATH tag can be used to specify one or more files or
+# directories that contain image that are included in the documentation (see
+# the \image command).
+
+IMAGE_PATH =
+
+# The INPUT_FILTER tag can be used to specify a program that doxygen should
+# invoke to filter for each input file. Doxygen will invoke the filter program
+# by executing (via popen()) the command <filter> <input-file>, where <filter>
+# is the value of the INPUT_FILTER tag, and <input-file> is the name of an
+# input file. Doxygen will then use the output that the filter program writes
+# to standard output. If FILTER_PATTERNS is specified, this tag will be
+# ignored.
+
+INPUT_FILTER =
+
+# The FILTER_PATTERNS tag can be used to specify filters on a per file pattern
+# basis. Doxygen will compare the file name with each pattern and apply the
+# filter if there is a match. The filters are a list of the form:
+# pattern=filter (like *.cpp=my_cpp_filter). See INPUT_FILTER for further
+# info on how filters are used. If FILTER_PATTERNS is empty, INPUT_FILTER
+# is applied to all files.
+
+FILTER_PATTERNS =
+
+# If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using
+# INPUT_FILTER) will be used to filter the input files when producing source
+# files to browse (i.e. when SOURCE_BROWSER is set to YES).
+
+FILTER_SOURCE_FILES = NO
+
+#---------------------------------------------------------------------------
+# configuration options related to source browsing
+#---------------------------------------------------------------------------
+
+# If the SOURCE_BROWSER tag is set to YES then a list of source files will
+# be generated. Documented entities will be cross-referenced with these sources.
+# Note: To get rid of all source code in the generated output, make sure also
+# VERBATIM_HEADERS is set to NO.
+
+SOURCE_BROWSER = NO
+
+# Setting the INLINE_SOURCES tag to YES will include the body
+# of functions and classes directly in the documentation.
+
+INLINE_SOURCES = NO
+
+# Setting the STRIP_CODE_COMMENTS tag to YES (the default) will instruct
+# doxygen to hide any special comment blocks from generated source code
+# fragments. Normal C and C++ comments will always remain visible.
+
+STRIP_CODE_COMMENTS = YES
+
+# If the REFERENCED_BY_RELATION tag is set to YES
+# then for each documented function all documented
+# functions referencing it will be listed.
+
+REFERENCED_BY_RELATION = NO
+
+# If the REFERENCES_RELATION tag is set to YES
+# then for each documented function all documented entities
+# called/used by that function will be listed.
+
+REFERENCES_RELATION = NO
+
+# If the REFERENCES_LINK_SOURCE tag is set to YES (the default)
+# and SOURCE_BROWSER tag is set to YES, then the hyperlinks from
+# functions in REFERENCES_RELATION and REFERENCED_BY_RELATION lists will
+# link to the source code. Otherwise they will link to the documentstion.
+
+REFERENCES_LINK_SOURCE = NO
+
+# If the USE_HTAGS tag is set to YES then the references to source code
+# will point to the HTML generated by the htags(1) tool instead of doxygen
+# built-in source browser. The htags tool is part of GNU's global source
+# tagging system (see http://www.gnu.org/software/global/global.html). You
+# will need version 4.8.6 or higher.
+
+USE_HTAGS = NO
+
+# If the VERBATIM_HEADERS tag is set to YES (the default) then Doxygen
+# will generate a verbatim copy of the header file for each class for
+# which an include is specified. Set to NO to disable this.
+
+VERBATIM_HEADERS = NO
+
+#---------------------------------------------------------------------------
+# configuration options related to the alphabetical class index
+#---------------------------------------------------------------------------
+
+# If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index
+# of all compounds will be generated. Enable this if the project
+# contains a lot of classes, structs, unions or interfaces.
+
+ALPHABETICAL_INDEX = YES
+
+# If the alphabetical index is enabled (see ALPHABETICAL_INDEX) then
+# the COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns
+# in which this list will be split (can be a number in the range [1..20])
+
+COLS_IN_ALPHA_INDEX = 5
+
+# In case all classes in a project start with a common prefix, all
+# classes will be put under the same header in the alphabetical index.
+# The IGNORE_PREFIX tag can be used to specify one or more prefixes that
+# should be ignored while generating the index headers.
+
+IGNORE_PREFIX =
+
+#---------------------------------------------------------------------------
+# configuration options related to the HTML output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_HTML tag is set to YES (the default) Doxygen will
+# generate HTML output.
+
+GENERATE_HTML = YES
+
+# The HTML_OUTPUT tag is used to specify where the HTML docs will be put.
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be
+# put in front of it. If left blank `html' will be used as the default path.
+
+HTML_OUTPUT = html
+
+# The HTML_FILE_EXTENSION tag can be used to specify the file extension for
+# each generated HTML page (for example: .htm,.php,.asp). If it is left blank
+# doxygen will generate files with .html extension.
+
+HTML_FILE_EXTENSION = .html
+
+# The HTML_HEADER tag can be used to specify a personal HTML header for
+# each generated HTML page. If it is left blank doxygen will generate a
+# standard header.
+
+HTML_HEADER =
+
+# The HTML_FOOTER tag can be used to specify a personal HTML footer for
+# each generated HTML page. If it is left blank doxygen will generate a
+# standard footer.
+
+HTML_FOOTER =
+
+# The HTML_STYLESHEET tag can be used to specify a user-defined cascading
+# style sheet that is used by each HTML page. It can be used to
+# fine-tune the look of the HTML output. If the tag is left blank doxygen
+# will generate a default style sheet. Note that doxygen will try to copy
+# the style sheet file to the HTML output directory, so don't put your own
+# stylesheet in the HTML output directory as well, or it will be erased!
+
+HTML_STYLESHEET =
+
+# If the HTML_ALIGN_MEMBERS tag is set to YES, the members of classes,
+# files or namespaces will be aligned in HTML using tables. If set to
+# NO a bullet list will be used.
+
+HTML_ALIGN_MEMBERS = YES
+
+# If the HTML_DYNAMIC_SECTIONS tag is set to YES then the generated HTML
+# documentation will contain sections that can be hidden and shown after the
+# page has loaded. For this to work a browser that supports
+# JavaScript and DHTML is required (for instance Mozilla 1.0+, Firefox
+# Netscape 6.0+, Internet explorer 5.0+, Konqueror, or Safari).
+
+HTML_DYNAMIC_SECTIONS = YES
+
+# If the GENERATE_DOCSET tag is set to YES, additional index files
+# will be generated that can be used as input for Apple's Xcode 3
+# integrated development environment, introduced with OSX 10.5 (Leopard).
+# To create a documentation set, doxygen will generate a Makefile in the
+# HTML output directory. Running make will produce the docset in that
+# directory and running "make install" will install the docset in
+# ~/Library/Developer/Shared/Documentation/DocSets so that Xcode will find
+# it at startup.
+# See http://developer.apple.com/tools/creatingdocsetswithdoxygen.html for more information.
+
+GENERATE_DOCSET = NO
+
+# When GENERATE_DOCSET tag is set to YES, this tag determines the name of the
+# feed. A documentation feed provides an umbrella under which multiple
+# documentation sets from a single provider (such as a company or product suite)
+# can be grouped.
+
+DOCSET_FEEDNAME = "Doxygen generated docs"
+
+# When GENERATE_DOCSET tag is set to YES, this tag specifies a string that
+# should uniquely identify the documentation set bundle. This should be a
+# reverse domain-name style string, e.g. com.mycompany.MyDocSet. Doxygen
+# will append .docset to the name.
+
+DOCSET_BUNDLE_ID = org.doxygen.Project
+
+# If the GENERATE_HTMLHELP tag is set to YES, additional index files
+# will be generated that can be used as input for tools like the
+# Microsoft HTML help workshop to generate a compiled HTML help file (.chm)
+# of the generated HTML documentation.
+
+GENERATE_HTMLHELP = NO
+
+# If the GENERATE_HTMLHELP tag is set to YES, the CHM_FILE tag can
+# be used to specify the file name of the resulting .chm file. You
+# can add a path in front of the file if the result should not be
+# written to the html output directory.
+
+CHM_FILE =
+
+# If the GENERATE_HTMLHELP tag is set to YES, the HHC_LOCATION tag can
+# be used to specify the location (absolute path including file name) of
+# the HTML help compiler (hhc.exe). If non-empty doxygen will try to run
+# the HTML help compiler on the generated index.hhp.
+
+HHC_LOCATION =
+
+# If the GENERATE_HTMLHELP tag is set to YES, the GENERATE_CHI flag
+# controls if a separate .chi index file is generated (YES) or that
+# it should be included in the master .chm file (NO).
+
+GENERATE_CHI = NO
+
+# If the GENERATE_HTMLHELP tag is set to YES, the CHM_INDEX_ENCODING
+# is used to encode HtmlHelp index (hhk), content (hhc) and project file
+# content.
+
+CHM_INDEX_ENCODING =
+
+# If the GENERATE_HTMLHELP tag is set to YES, the BINARY_TOC flag
+# controls whether a binary table of contents is generated (YES) or a
+# normal table of contents (NO) in the .chm file.
+
+BINARY_TOC = NO
+
+# The TOC_EXPAND flag can be set to YES to add extra items for group members
+# to the contents of the HTML help documentation and to the tree view.
+
+TOC_EXPAND = YES
+
+# If the GENERATE_QHP tag is set to YES and both QHP_NAMESPACE and QHP_VIRTUAL_FOLDER
+# are set, an additional index file will be generated that can be used as input for
+# Qt's qhelpgenerator to generate a Qt Compressed Help (.qch) of the generated
+# HTML documentation.
+
+GENERATE_QHP = NO
+
+# If the QHG_LOCATION tag is specified, the QCH_FILE tag can
+# be used to specify the file name of the resulting .qch file.
+# The path specified is relative to the HTML output folder.
+
+QCH_FILE =
+
+# The QHP_NAMESPACE tag specifies the namespace to use when generating
+# Qt Help Project output. For more information please see
+# <a href="http://doc.trolltech.com/qthelpproject.html#namespace">Qt Help Project / Namespace</a>.
+
+QHP_NAMESPACE = org.doxygen.Project
+
+# The QHP_VIRTUAL_FOLDER tag specifies the namespace to use when generating
+# Qt Help Project output. For more information please see
+# <a href="http://doc.trolltech.com/qthelpproject.html#virtual-folders">Qt Help Project / Virtual Folders</a>.
+
+QHP_VIRTUAL_FOLDER = doc
+
+# If the GENERATE_QHP tag is set to YES, the QHG_LOCATION tag can
+# be used to specify the location of Qt's qhelpgenerator.
+# If non-empty doxygen will try to run qhelpgenerator on the generated
+# .qhp file .
+
+QHG_LOCATION =
+
+# The DISABLE_INDEX tag can be used to turn on/off the condensed index at
+# top of each HTML page. The value NO (the default) enables the index and
+# the value YES disables it.
+
+DISABLE_INDEX = NO
+
+# This tag can be used to set the number of enum values (range [1..20])
+# that doxygen will group on one line in the generated HTML documentation.
+
+ENUM_VALUES_PER_LINE = 1
+
+# The GENERATE_TREEVIEW tag is used to specify whether a tree-like index
+# structure should be generated to display hierarchical information.
+# If the tag value is set to FRAME, a side panel will be generated
+# containing a tree-like index structure (just like the one that
+# is generated for HTML Help). For this to work a browser that supports
+# JavaScript, DHTML, CSS and frames is required (for instance Mozilla 1.0+,
+# Netscape 6.0+, Internet explorer 5.0+, or Konqueror). Windows users are
+# probably better off using the HTML help feature. Other possible values
+# for this tag are: HIERARCHIES, which will generate the Groups, Directories,
+# and Class Hierarchy pages using a tree view instead of an ordered list;
+# ALL, which combines the behavior of FRAME and HIERARCHIES; and NONE, which
+# disables this behavior completely. For backwards compatibility with previous
+# releases of Doxygen, the values YES and NO are equivalent to FRAME and NONE
+# respectively.
+
+GENERATE_TREEVIEW = YES
+
+# If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be
+# used to set the initial width (in pixels) of the frame in which the tree
+# is shown.
+
+TREEVIEW_WIDTH = 250
+
+# Use this tag to change the font size of Latex formulas included
+# as images in the HTML documentation. The default is 10. Note that
+# when you change the font size after a successful doxygen run you need
+# to manually remove any form_*.png images from the HTML output directory
+# to force them to be regenerated.
+
+FORMULA_FONTSIZE = 10
+
+#---------------------------------------------------------------------------
+# configuration options related to the LaTeX output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_LATEX tag is set to YES (the default) Doxygen will
+# generate Latex output.
+
+GENERATE_LATEX = NO
+
+# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put.
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be
+# put in front of it. If left blank `latex' will be used as the default path.
+
+LATEX_OUTPUT = latex
+
+# The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be
+# invoked. If left blank `latex' will be used as the default command name.
+
+LATEX_CMD_NAME = latex
+
+# The MAKEINDEX_CMD_NAME tag can be used to specify the command name to
+# generate index for LaTeX. If left blank `makeindex' will be used as the
+# default command name.
+
+MAKEINDEX_CMD_NAME = makeindex
+
+# If the COMPACT_LATEX tag is set to YES Doxygen generates more compact
+# LaTeX documents. This may be useful for small projects and may help to
+# save some trees in general.
+
+COMPACT_LATEX = NO
+
+# The PAPER_TYPE tag can be used to set the paper type that is used
+# by the printer. Possible values are: a4, a4wide, letter, legal and
+# executive. If left blank a4wide will be used.
+
+PAPER_TYPE = a4wide
+
+# The EXTRA_PACKAGES tag can be to specify one or more names of LaTeX
+# packages that should be included in the LaTeX output.
+
+EXTRA_PACKAGES =
+
+# The LATEX_HEADER tag can be used to specify a personal LaTeX header for
+# the generated latex document. The header should contain everything until
+# the first chapter. If it is left blank doxygen will generate a
+# standard header. Notice: only use this tag if you know what you are doing!
+
+LATEX_HEADER =
+
+# If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated
+# is prepared for conversion to pdf (using ps2pdf). The pdf file will
+# contain links (just like the HTML output) instead of page references
+# This makes the output suitable for online browsing using a pdf viewer.
+
+PDF_HYPERLINKS = YES
+
+# If the USE_PDFLATEX tag is set to YES, pdflatex will be used instead of
+# plain latex in the generated Makefile. Set this option to YES to get a
+# higher quality PDF documentation.
+
+USE_PDFLATEX = YES
+
+# If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \\batchmode.
+# command to the generated LaTeX files. This will instruct LaTeX to keep
+# running if errors occur, instead of asking the user for help.
+# This option is also used when generating formulas in HTML.
+
+LATEX_BATCHMODE = NO
+
+# If LATEX_HIDE_INDICES is set to YES then doxygen will not
+# include the index chapters (such as File Index, Compound Index, etc.)
+# in the output.
+
+LATEX_HIDE_INDICES = NO
+
+#---------------------------------------------------------------------------
+# configuration options related to the RTF output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_RTF tag is set to YES Doxygen will generate RTF output
+# The RTF output is optimized for Word 97 and may not look very pretty with
+# other RTF readers or editors.
+
+GENERATE_RTF = NO
+
+# The RTF_OUTPUT tag is used to specify where the RTF docs will be put.
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be
+# put in front of it. If left blank `rtf' will be used as the default path.
+
+RTF_OUTPUT = rtf
+
+# If the COMPACT_RTF tag is set to YES Doxygen generates more compact
+# RTF documents. This may be useful for small projects and may help to
+# save some trees in general.
+
+COMPACT_RTF = NO
+
+# If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated
+# will contain hyperlink fields. The RTF file will
+# contain links (just like the HTML output) instead of page references.
+# This makes the output suitable for online browsing using WORD or other
+# programs which support those fields.
+# Note: wordpad (write) and others do not support links.
+
+RTF_HYPERLINKS = NO
+
+# Load stylesheet definitions from file. Syntax is similar to doxygen's
+# config file, i.e. a series of assignments. You only have to provide
+# replacements, missing definitions are set to their default value.
+
+RTF_STYLESHEET_FILE =
+
+# Set optional variables used in the generation of an rtf document.
+# Syntax is similar to doxygen's config file.
+
+RTF_EXTENSIONS_FILE =
+
+#---------------------------------------------------------------------------
+# configuration options related to the man page output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_MAN tag is set to YES (the default) Doxygen will
+# generate man pages
+
+GENERATE_MAN = NO
+
+# The MAN_OUTPUT tag is used to specify where the man pages will be put.
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be
+# put in front of it. If left blank `man' will be used as the default path.
+
+MAN_OUTPUT = man
+
+# The MAN_EXTENSION tag determines the extension that is added to
+# the generated man pages (default is the subroutine's section .3)
+
+MAN_EXTENSION = .3
+
+# If the MAN_LINKS tag is set to YES and Doxygen generates man output,
+# then it will generate one additional man file for each entity
+# documented in the real man page(s). These additional files
+# only source the real man page, but without them the man command
+# would be unable to find the correct page. The default is NO.
+
+MAN_LINKS = NO
+
+#---------------------------------------------------------------------------
+# configuration options related to the XML output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_XML tag is set to YES Doxygen will
+# generate an XML file that captures the structure of
+# the code including all documentation.
+
+GENERATE_XML = NO
+
+# The XML_OUTPUT tag is used to specify where the XML pages will be put.
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be
+# put in front of it. If left blank `xml' will be used as the default path.
+
+XML_OUTPUT = xml
+
+# The XML_SCHEMA tag can be used to specify an XML schema,
+# which can be used by a validating XML parser to check the
+# syntax of the XML files.
+
+XML_SCHEMA =
+
+# The XML_DTD tag can be used to specify an XML DTD,
+# which can be used by a validating XML parser to check the
+# syntax of the XML files.
+
+XML_DTD =
+
+# If the XML_PROGRAMLISTING tag is set to YES Doxygen will
+# dump the program listings (including syntax highlighting
+# and cross-referencing information) to the XML output. Note that
+# enabling this will significantly increase the size of the XML output.
+
+XML_PROGRAMLISTING = YES
+
+#---------------------------------------------------------------------------
+# configuration options for the AutoGen Definitions output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_AUTOGEN_DEF tag is set to YES Doxygen will
+# generate an AutoGen Definitions (see autogen.sf.net) file
+# that captures the structure of the code including all
+# documentation. Note that this feature is still experimental
+# and incomplete at the moment.
+
+GENERATE_AUTOGEN_DEF = NO
+
+#---------------------------------------------------------------------------
+# configuration options related to the Perl module output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_PERLMOD tag is set to YES Doxygen will
+# generate a Perl module file that captures the structure of
+# the code including all documentation. Note that this
+# feature is still experimental and incomplete at the
+# moment.
+
+GENERATE_PERLMOD = NO
+
+# If the PERLMOD_LATEX tag is set to YES Doxygen will generate
+# the necessary Makefile rules, Perl scripts and LaTeX code to be able
+# to generate PDF and DVI output from the Perl module output.
+
+PERLMOD_LATEX = NO
+
+# If the PERLMOD_PRETTY tag is set to YES the Perl module output will be
+# nicely formatted so it can be parsed by a human reader. This is useful
+# if you want to understand what is going on. On the other hand, if this
+# tag is set to NO the size of the Perl module output will be much smaller
+# and Perl will parse it just the same.
+
+PERLMOD_PRETTY = YES
+
+# The names of the make variables in the generated doxyrules.make file
+# are prefixed with the string contained in PERLMOD_MAKEVAR_PREFIX.
+# This is useful so different doxyrules.make files included by the same
+# Makefile don't overwrite each other's variables.
+
+PERLMOD_MAKEVAR_PREFIX =
+
+#---------------------------------------------------------------------------
+# Configuration options related to the preprocessor
+#---------------------------------------------------------------------------
+
+# If the ENABLE_PREPROCESSING tag is set to YES (the default) Doxygen will
+# evaluate all C-preprocessor directives found in the sources and include
+# files.
+
+ENABLE_PREPROCESSING = YES
+
+# If the MACRO_EXPANSION tag is set to YES Doxygen will expand all macro
+# names in the source code. If set to NO (the default) only conditional
+# compilation will be performed. Macro expansion can be done in a controlled
+# way by setting EXPAND_ONLY_PREDEF to YES.
+
+MACRO_EXPANSION = YES
+
+# If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES
+# then the macro expansion is limited to the macros specified with the
+# PREDEFINED and EXPAND_AS_DEFINED tags.
+
+EXPAND_ONLY_PREDEF = YES
+
+# If the SEARCH_INCLUDES tag is set to YES (the default) the includes files
+# in the INCLUDE_PATH (see below) will be search if a #include is found.
+
+SEARCH_INCLUDES = YES
+
+# The INCLUDE_PATH tag can be used to specify one or more directories that
+# contain include files that are not input files but should be processed by
+# the preprocessor.
+
+INCLUDE_PATH =
+
+# You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard
+# patterns (like *.h and *.hpp) to filter out the header-files in the
+# directories. If left blank, the patterns specified with FILE_PATTERNS will
+# be used.
+
+INCLUDE_FILE_PATTERNS =
+
+# The PREDEFINED tag can be used to specify one or more macro names that
+# are defined before the preprocessor is started (similar to the -D option of
+# gcc). The argument of the tag is a list of macros of the form: name
+# or name=definition (no spaces). If the definition and the = are
+# omitted =1 is assumed. To prevent a macro definition from being
+# undefined via #undef or recursively expanded use the := operator
+# instead of the = operator.
+
+PREDEFINED = __DOXYGEN__
+
+# If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then
+# this tag can be used to specify a list of macro names that should be expanded.
+# The macro definition that is found in the sources will be used.
+# Use the PREDEFINED tag if you want to use a different macro definition.
+
+EXPAND_AS_DEFINED = BUTTLOADTAG
+
+# If the SKIP_FUNCTION_MACROS tag is set to YES (the default) then
+# doxygen's preprocessor will remove all function-like macros that are alone
+# on a line, have an all uppercase name, and do not end with a semicolon. Such
+# function macros are typically used for boiler-plate code, and will confuse
+# the parser if not removed.
+
+SKIP_FUNCTION_MACROS = YES
+
+#---------------------------------------------------------------------------
+# Configuration::additions related to external references
+#---------------------------------------------------------------------------
+
+# The TAGFILES option can be used to specify one or more tagfiles.
+# Optionally an initial location of the external documentation
+# can be added for each tagfile. The format of a tag file without
+# this location is as follows:
+# TAGFILES = file1 file2 ...
+# Adding location for the tag files is done as follows:
+# TAGFILES = file1=loc1 "file2 = loc2" ...
+# where "loc1" and "loc2" can be relative or absolute paths or
+# URLs. If a location is present for each tag, the installdox tool
+# does not have to be run to correct the links.
+# Note that each tag file must have a unique name
+# (where the name does NOT include the path)
+# If a tag file is not located in the directory in which doxygen
+# is run, you must also specify the path to the tagfile here.
+
+TAGFILES =
+
+# When a file name is specified after GENERATE_TAGFILE, doxygen will create
+# a tag file that is based on the input files it reads.
+
+GENERATE_TAGFILE =
+
+# If the ALLEXTERNALS tag is set to YES all external classes will be listed
+# in the class index. If set to NO only the inherited external classes
+# will be listed.
+
+ALLEXTERNALS = NO
+
+# If the EXTERNAL_GROUPS tag is set to YES all external groups will be listed
+# in the modules index. If set to NO, only the current project's groups will
+# be listed.
+
+EXTERNAL_GROUPS = YES
+
+# The PERL_PATH should be the absolute path and name of the perl script
+# interpreter (i.e. the result of `which perl').
+
+PERL_PATH = /usr/bin/perl
+
+#---------------------------------------------------------------------------
+# Configuration options related to the dot tool
+#---------------------------------------------------------------------------
+
+# If the CLASS_DIAGRAMS tag is set to YES (the default) Doxygen will
+# generate a inheritance diagram (in HTML, RTF and LaTeX) for classes with base
+# or super classes. Setting the tag to NO turns the diagrams off. Note that
+# this option is superseded by the HAVE_DOT option below. This is only a
+# fallback. It is recommended to install and use dot, since it yields more
+# powerful graphs.
+
+CLASS_DIAGRAMS = NO
+
+# You can define message sequence charts within doxygen comments using the \msc
+# command. Doxygen will then run the mscgen tool (see
+# http://www.mcternan.me.uk/mscgen/) to produce the chart and insert it in the
+# documentation. The MSCGEN_PATH tag allows you to specify the directory where
+# the mscgen tool resides. If left empty the tool is assumed to be found in the
+# default search path.
+
+MSCGEN_PATH =
+
+# If set to YES, the inheritance and collaboration graphs will hide
+# inheritance and usage relations if the target is undocumented
+# or is not a class.
+
+HIDE_UNDOC_RELATIONS = YES
+
+# If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is
+# available from the path. This tool is part of Graphviz, a graph visualization
+# toolkit from AT&T and Lucent Bell Labs. The other options in this section
+# have no effect if this option is set to NO (the default)
+
+HAVE_DOT = NO
+
+# By default doxygen will write a font called FreeSans.ttf to the output
+# directory and reference it in all dot files that doxygen generates. This
+# font does not include all possible unicode characters however, so when you need
+# these (or just want a differently looking font) you can specify the font name
+# using DOT_FONTNAME. You need need to make sure dot is able to find the font,
+# which can be done by putting it in a standard location or by setting the
+# DOTFONTPATH environment variable or by setting DOT_FONTPATH to the directory
+# containing the font.
+
+DOT_FONTNAME = FreeSans
+
+# The DOT_FONTSIZE tag can be used to set the size of the font of dot graphs.
+# The default size is 10pt.
+
+DOT_FONTSIZE = 10
+
+# By default doxygen will tell dot to use the output directory to look for the
+# FreeSans.ttf font (which doxygen will put there itself). If you specify a
+# different font using DOT_FONTNAME you can set the path where dot
+# can find it using this tag.
+
+DOT_FONTPATH =
+
+# If the CLASS_GRAPH and HAVE_DOT tags are set to YES then doxygen
+# will generate a graph for each documented class showing the direct and
+# indirect inheritance relations. Setting this tag to YES will force the
+# the CLASS_DIAGRAMS tag to NO.
+
+CLASS_GRAPH = NO
+
+# If the COLLABORATION_GRAPH and HAVE_DOT tags are set to YES then doxygen
+# will generate a graph for each documented class showing the direct and
+# indirect implementation dependencies (inheritance, containment, and
+# class references variables) of the class with other documented classes.
+
+COLLABORATION_GRAPH = NO
+
+# If the GROUP_GRAPHS and HAVE_DOT tags are set to YES then doxygen
+# will generate a graph for groups, showing the direct groups dependencies
+
+GROUP_GRAPHS = NO
+
+# If the UML_LOOK tag is set to YES doxygen will generate inheritance and
+# collaboration diagrams in a style similar to the OMG's Unified Modeling
+# Language.
+
+UML_LOOK = NO
+
+# If set to YES, the inheritance and collaboration graphs will show the
+# relations between templates and their instances.
+
+TEMPLATE_RELATIONS = NO
+
+# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDE_GRAPH, and HAVE_DOT
+# tags are set to YES then doxygen will generate a graph for each documented
+# file showing the direct and indirect include dependencies of the file with
+# other documented files.
+
+INCLUDE_GRAPH = NO
+
+# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDED_BY_GRAPH, and
+# HAVE_DOT tags are set to YES then doxygen will generate a graph for each
+# documented header file showing the documented files that directly or
+# indirectly include this file.
+
+INCLUDED_BY_GRAPH = NO
+
+# If the CALL_GRAPH and HAVE_DOT options are set to YES then
+# doxygen will generate a call dependency graph for every global function
+# or class method. Note that enabling this option will significantly increase
+# the time of a run. So in most cases it will be better to enable call graphs
+# for selected functions only using the \callgraph command.
+
+CALL_GRAPH = NO
+
+# If the CALLER_GRAPH and HAVE_DOT tags are set to YES then
+# doxygen will generate a caller dependency graph for every global function
+# or class method. Note that enabling this option will significantly increase
+# the time of a run. So in most cases it will be better to enable caller
+# graphs for selected functions only using the \callergraph command.
+
+CALLER_GRAPH = NO
+
+# If the GRAPHICAL_HIERARCHY and HAVE_DOT tags are set to YES then doxygen
+# will graphical hierarchy of all classes instead of a textual one.
+
+GRAPHICAL_HIERARCHY = NO
+
+# If the DIRECTORY_GRAPH, SHOW_DIRECTORIES and HAVE_DOT tags are set to YES
+# then doxygen will show the dependencies a directory has on other directories
+# in a graphical way. The dependency relations are determined by the #include
+# relations between the files in the directories.
+
+DIRECTORY_GRAPH = NO
+
+# The DOT_IMAGE_FORMAT tag can be used to set the image format of the images
+# generated by dot. Possible values are png, jpg, or gif
+# If left blank png will be used.
+
+DOT_IMAGE_FORMAT = png
+
+# The tag DOT_PATH can be used to specify the path where the dot tool can be
+# found. If left blank, it is assumed the dot tool can be found in the path.
+
+DOT_PATH = "C:/Program Files/Graphviz2.18/bin"
+
+# The DOTFILE_DIRS tag can be used to specify one or more directories that
+# contain dot files that are included in the documentation (see the
+# \dotfile command).
+
+DOTFILE_DIRS =
+
+# The DOT_GRAPH_MAX_NODES tag can be used to set the maximum number of
+# nodes that will be shown in the graph. If the number of nodes in a graph
+# becomes larger than this value, doxygen will truncate the graph, which is
+# visualized by representing a node as a red box. Note that doxygen if the
+# number of direct children of the root node in a graph is already larger than
+# DOT_GRAPH_MAX_NODES then the graph will not be shown at all. Also note
+# that the size of a graph can be further restricted by MAX_DOT_GRAPH_DEPTH.
+
+DOT_GRAPH_MAX_NODES = 15
+
+# The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the
+# graphs generated by dot. A depth value of 3 means that only nodes reachable
+# from the root by following a path via at most 3 edges will be shown. Nodes
+# that lay further from the root node will be omitted. Note that setting this
+# option to 1 or 2 may greatly reduce the computation time needed for large
+# code bases. Also note that the size of a graph can be further restricted by
+# DOT_GRAPH_MAX_NODES. Using a depth of 0 means no depth restriction.
+
+MAX_DOT_GRAPH_DEPTH = 2
+
+# Set the DOT_TRANSPARENT tag to YES to generate images with a transparent
+# background. This is disabled by default, because dot on Windows does not
+# seem to support this out of the box. Warning: Depending on the platform used,
+# enabling this option may lead to badly anti-aliased labels on the edges of
+# a graph (i.e. they become hard to read).
+
+DOT_TRANSPARENT = YES
+
+# Set the DOT_MULTI_TARGETS tag to YES allow dot to generate multiple output
+# files in one run (i.e. multiple -o and -T options on the command line). This
+# makes dot run faster, but since only newer versions of dot (>1.8.10)
+# support this, this feature is disabled by default.
+
+DOT_MULTI_TARGETS = NO
+
+# If the GENERATE_LEGEND tag is set to YES (the default) Doxygen will
+# generate a legend page explaining the meaning of the various boxes and
+# arrows in the dot generated graphs.
+
+GENERATE_LEGEND = YES
+
+# If the DOT_CLEANUP tag is set to YES (the default) Doxygen will
+# remove the intermediate dot files that are used to generate
+# the various graphs.
+
+DOT_CLEANUP = YES
+
+#---------------------------------------------------------------------------
+# Configuration::additions related to the search engine
+#---------------------------------------------------------------------------
+
+# The SEARCHENGINE tag specifies whether or not a search engine should be
+# used. If set to NO the values of all tags below this one will be ignored.
+
+SEARCHENGINE = NO
diff --git a/Projects/Magstripe/Magstripe.aps b/Projects/Magstripe/Magstripe.aps
new file mode 100644
index 000000000..86d011abb
--- /dev/null
+++ b/Projects/Magstripe/Magstripe.aps
@@ -0,0 +1 @@
+<AVRStudio><MANAGEMENT><ProjectName>Magstripe</ProjectName><Created>30-Sep-2008 14:19:14</Created><LastEdit>30-Sep-2008 14:19:28</LastEdit><ICON>241</ICON><ProjectType>0</ProjectType><Created>30-Sep-2008 14:19:14</Created><Version>4</Version><Build>4, 14, 0, 589</Build><ProjectTypeName>AVR GCC</ProjectTypeName></MANAGEMENT><CODE_CREATION><ObjectFile></ObjectFile><EntryFile></EntryFile><SaveFolder>C:\Users\Dean\Documents\Electronics\Projects\WORK\MyUSBWORK\Projects\Magstripe\</SaveFolder></CODE_CREATION><DEBUG_TARGET><CURRENT_TARGET></CURRENT_TARGET><CURRENT_PART></CURRENT_PART><BREAKPOINTS></BREAKPOINTS><IO_EXPAND><HIDE>false</HIDE></IO_EXPAND><REGISTERNAMES><Register>R00</Register><Register>R01</Register><Register>R02</Register><Register>R03</Register><Register>R04</Register><Register>R05</Register><Register>R06</Register><Register>R07</Register><Register>R08</Register><Register>R09</Register><Register>R10</Register><Register>R11</Register><Register>R12</Register><Register>R13</Register><Register>R14</Register><Register>R15</Register><Register>R16</Register><Register>R17</Register><Register>R18</Register><Register>R19</Register><Register>R20</Register><Register>R21</Register><Register>R22</Register><Register>R23</Register><Register>R24</Register><Register>R25</Register><Register>R26</Register><Register>R27</Register><Register>R28</Register><Register>R29</Register><Register>R30</Register><Register>R31</Register></REGISTERNAMES><COM>Auto</COM><COMType>0</COMType><WATCHNUM>0</WATCHNUM><WATCHNAMES><Pane0></Pane0><Pane1></Pane1><Pane2></Pane2><Pane3></Pane3></WATCHNAMES><BreakOnTrcaeFull>0</BreakOnTrcaeFull></DEBUG_TARGET><Debugger><Triggers></Triggers></Debugger><AVRGCCPLUGIN><FILES><SOURCEFILE>Descriptors.c</SOURCEFILE><SOURCEFILE>Magstripe.c</SOURCEFILE><HEADERFILE>Descriptors.h</HEADERFILE><HEADERFILE>Magstripe.h</HEADERFILE><HEADERFILE>MagstripeHW.h</HEADERFILE><OTHERFILE>makefile</OTHERFILE></FILES><CONFIGS><CONFIG><NAME>default</NAME><USESEXTERNALMAKEFILE>YES</USESEXTERNALMAKEFILE><EXTERNALMAKEFILE>makefile</EXTERNALMAKEFILE><PART>atmega128</PART><HEX>1</HEX><LIST>1</LIST><MAP>1</MAP><OUTPUTFILENAME>Magstripe.elf</OUTPUTFILENAME><OUTPUTDIR>default\</OUTPUTDIR><ISDIRTY>1</ISDIRTY><OPTIONS/><INCDIRS/><LIBDIRS/><LIBS/><LINKOBJECTS/><OPTIONSFORALL>-Wall -gdwarf-2 -std=gnu99 -Os -funsigned-char -funsigned-bitfields -fpack-struct -fshort-enums</OPTIONSFORALL><LINKEROPTIONS></LINKEROPTIONS><SEGMENTS/></CONFIG></CONFIGS><LASTCONFIG>default</LASTCONFIG><USES_WINAVR>1</USES_WINAVR><GCC_LOC>C:\WinAVR-20080512\bin\avr-gcc.exe</GCC_LOC><MAKE_LOC>C:\WinAVR-20080512\utils\bin\make.exe</MAKE_LOC></AVRGCCPLUGIN><IOView><usergroups/><sort sorted="0" column="0" ordername="0" orderaddress="0" ordergroup="0"/></IOView><Files></Files><Events><Bookmarks></Bookmarks></Events><Trace><Filters></Filters></Trace></AVRStudio>
diff --git a/Projects/Magstripe/Magstripe.c b/Projects/Magstripe/Magstripe.c
new file mode 100644
index 000000000..3696c1249
--- /dev/null
+++ b/Projects/Magstripe/Magstripe.c
@@ -0,0 +1,436 @@
+/*
+ LUFA Library
+ Copyright (C) Dean Camera, 2009.
+
+ dean [at] fourwalledcubicle [dot] com
+ www.fourwalledcubicle.com
+*/
+
+/*
+ Copyright 2009 Denver Gingerich (denver [at] ossguy [dot] com)
+ Copyright 2009 Dean Camera (dean [at] fourwalledcubicle [dot] com)
+
+ Permission to use, copy, modify, and distribute this software
+ and its documentation for any purpose and without fee is hereby
+ granted, provided that the above copyright notice appear in all
+ copies and that both that the copyright notice and this
+ permission notice and warranty disclaimer appear in supporting
+ documentation, and that the name of the author not be used in
+ advertising or publicity pertaining to distribution of the
+ software without specific, written prior permission.
+
+ The author disclaim all warranties with regard to this
+ software, including all implied warranties of merchantability
+ and fitness. In no event shall the author be liable for any
+ special, indirect or consequential damages or any damages
+ whatsoever resulting from loss of use, data or profits, whether
+ in an action of contract, negligence or other tortious action,
+ arising out of or in connection with the use or performance of
+ this software.
+*/
+
+/** \file
+ *
+ * Main source file for the MagStripe application. This file contains the code which drives
+ * the USB keyboard interface from the magnetic card stripe reader device.
+ */
+
+#include "Magstripe.h"
+
+/* Project Tags, for reading out using the ButtLoad project */
+BUTTLOADTAG(ProjName, "Magstripe Reader");
+BUTTLOADTAG(BuildTime, __TIME__);
+BUTTLOADTAG(BuildDate, __DATE__);
+BUTTLOADTAG(LUFAVersion, "LUFA V" LUFA_VERSION_STRING);
+
+/* Scheduler Task List */
+TASK_LIST
+{
+ { Task: USB_USBTask , TaskStatus: TASK_STOP },
+ { Task: USB_Keyboard_Report , TaskStatus: TASK_STOP },
+ { Task: Magstripe_Read , TaskStatus: TASK_STOP },
+};
+
+/* Global Variables */
+/** Indicates if the device is using Report Protocol mode, instead of Boot Protocol mode. Boot Protocol mode
+ * is a special reporting mode used by compatible PC BIOS to support USB keyboards before a full OS and USB
+ * driver has been loaded, by using predefined report structures indicated in the USB HID standard.
+ */
+bool UsingReportProtocol = true;
+
+/** Total idle period in milliseconds set by the host via a SetIdle request, used to silence the report endpoint
+ * until the report data changes or the idle period elapsed. Generally used to implement hardware key repeats, or
+ * by some BIOS to reduce the number of reports when in Boot Protocol mode.
+ */
+uint8_t IdleCount = 0;
+
+/** Milliseconds remaining counter for the HID class SetIdle and GetIdle requests, used to silence the report
+ * endpoint for an amount of time indicated by the host or until the report changes.
+ */
+uint16_t IdleMSRemaining = 0;
+
+/** Circular buffer to hold the read bits from track 1 of the inserted magnetic card. */
+BitBuffer_t Track1Data;
+
+/** Circular buffer to hold the read bits from track 2 of the inserted magnetic card. */
+BitBuffer_t Track2Data;
+
+/** Circular buffer to hold the read bits from track 3 of the inserted magnetic card. */
+BitBuffer_t Track3Data;
+
+/** Delay counter between sucessive key strokes. This is to prevent the OS from ignoring multiple keys in a short
+ * period of time due to key repeats. Two milliseconds works for most OSes.
+ */
+uint8_t KeyDelayRemaining;
+
+
+/** Main program entry point. This routine configures the hardware required by the application, then
+ * starts the scheduler to run the application tasks.
+ */
+int main(void)
+{
+ /* Disable watchdog if enabled by bootloader/fuses */
+ MCUSR &= ~(1 << WDRF);
+ wdt_disable();
+
+ /* Disable Clock Division */
+ SetSystemClockPrescaler(0);
+
+ /* Hardware Initialization */
+ Magstripe_Init();
+
+ /* Buffer Initialization */
+ BitBuffer_Init(&Track1Data);
+ BitBuffer_Init(&Track2Data);
+ BitBuffer_Init(&Track3Data);
+
+ /* Millisecond timer initialization, with output compare interrupt enabled for the idle timing */
+ OCR0A = 0xFA;
+ TCCR0A = (1 << WGM01);
+ TCCR0B = ((1 << CS01) | (1 << CS00));
+ TIMSK0 = (1 << OCIE0A);
+
+ /* Initialize Scheduler so that it can be used */
+ Scheduler_Init();
+
+ /* Initialize USB Subsystem */
+ USB_Init();
+
+ /* Scheduling - routine never returns, so put this last in the main function */
+ Scheduler_Start();
+}
+
+/** Event handler for the USB_Connect event. This starts the USB task. */
+EVENT_HANDLER(USB_Connect)
+{
+ /* Start USB management task */
+ Scheduler_SetTaskMode(USB_USBTask, TASK_RUN);
+}
+
+/** Event handler for the USB_Disconnect event. This stops the USB and keyboard report tasks. */
+EVENT_HANDLER(USB_Disconnect)
+{
+ /* Stop running keyboard reporting, card reading and USB management tasks */
+ Scheduler_SetTaskMode(USB_Keyboard_Report, TASK_STOP);
+ Scheduler_SetTaskMode(USB_USBTask, TASK_STOP);
+ Scheduler_SetTaskMode(Magstripe_Read, TASK_STOP);
+}
+
+/** Event handler for the USB_ConfigurationChanged event. This configures the device's endpoints ready
+ * to relay reports to the host, and starts the keyboard report task.
+ */
+EVENT_HANDLER(USB_ConfigurationChanged)
+{
+ /* Setup Keyboard Keycode Report Endpoint */
+ Endpoint_ConfigureEndpoint(KEYBOARD_EPNUM, EP_TYPE_INTERRUPT,
+ ENDPOINT_DIR_IN, KEYBOARD_EPSIZE,
+ ENDPOINT_BANK_SINGLE);
+
+ /* Default to report protocol on connect */
+ UsingReportProtocol = true;
+
+ /* Start Keyboard reporting and card reading tasks */
+ Scheduler_SetTaskMode(USB_Keyboard_Report, TASK_RUN);
+ Scheduler_SetTaskMode(Magstripe_Read, TASK_RUN);
+}
+
+/** Event handler for the USB_UnhandledControlPacket event. This is used to catch standard and class specific
+ * control requests that are not handled internally by the USB library, so that they can be handled appropriately
+ * for the application.
+ */
+EVENT_HANDLER(USB_UnhandledControlPacket)
+{
+ /* Handle HID Class specific requests */
+ switch (bRequest)
+ {
+ case REQ_GetReport:
+ if (bmRequestType == (REQDIR_DEVICETOHOST | REQTYPE_CLASS | REQREC_INTERFACE))
+ {
+ USB_KeyboardReport_Data_t KeyboardReportData;
+
+ /* Create the next keyboard report for transmission to the host */
+ GetNextReport(&KeyboardReportData);
+
+ /* Ignore report type and ID number value */
+ Endpoint_Discard_Word();
+
+ /* Ignore unused Interface number value */
+ Endpoint_Discard_Word();
+
+ /* Read in the number of bytes in the report to send to the host */
+ uint16_t wLength = Endpoint_Read_Word_LE();
+
+ /* If trying to send more bytes than exist to the host, clamp the value at the report size */
+ if (wLength > sizeof(KeyboardReportData))
+ wLength = sizeof(KeyboardReportData);
+
+ Endpoint_ClearSetupReceived();
+
+ /* Write the report data to the control endpoint */
+ Endpoint_Write_Control_Stream_LE(&KeyboardReportData, wLength);
+
+ /* Finalize the stream transfer to send the last packet or clear the host abort */
+ Endpoint_ClearSetupOUT();
+ }
+
+ break;
+ case REQ_GetProtocol:
+ if (bmRequestType == (REQDIR_DEVICETOHOST | REQTYPE_CLASS | REQREC_INTERFACE))
+ {
+ Endpoint_ClearSetupReceived();
+
+ /* Write the current protocol flag to the host */
+ Endpoint_Write_Byte(UsingReportProtocol);
+
+ /* Send the flag to the host */
+ Endpoint_ClearSetupIN();
+ }
+
+ break;
+ case REQ_SetProtocol:
+ if (bmRequestType == (REQDIR_HOSTTODEVICE | REQTYPE_CLASS | REQREC_INTERFACE))
+ {
+ /* Read in the wValue parameter containing the new protocol mode */
+ uint16_t wValue = Endpoint_Read_Word_LE();
+
+ Endpoint_ClearSetupReceived();
+
+ /* Set or clear the flag depending on what the host indicates that the current Protocol should be */
+ UsingReportProtocol = (wValue != 0x0000);
+
+ /* Send an empty packet to acknowedge the command */
+ Endpoint_ClearSetupIN();
+ }
+
+ break;
+ case REQ_SetIdle:
+ if (bmRequestType == (REQDIR_HOSTTODEVICE | REQTYPE_CLASS | REQREC_INTERFACE))
+ {
+ /* Read in the wValue parameter containing the idle period */
+ uint16_t wValue = Endpoint_Read_Word_LE();
+
+ Endpoint_ClearSetupReceived();
+
+ /* Get idle period in MSB */
+ IdleCount = (wValue >> 8);
+
+ /* Send an empty packet to acknowedge the command */
+ Endpoint_ClearSetupIN();
+ }
+
+ break;
+ case REQ_GetIdle:
+ if (bmRequestType == (REQDIR_DEVICETOHOST | REQTYPE_CLASS | REQREC_INTERFACE))
+ {
+ Endpoint_ClearSetupReceived();
+
+ /* Write the current idle duration to the host */
+ Endpoint_Write_Byte(IdleCount);
+
+ /* Send the flag to the host */
+ Endpoint_ClearSetupIN();
+ }
+
+ break;
+ }
+}
+
+/** ISR for the timer 0 compare vector. This ISR fires once each millisecond, and decrements the counter indicating
+ * the number of milliseconds left to idle (not send the host reports) if the device has been instructed to idle
+ * by the host via a SetIdle class specific request.
+ */
+ISR(TIMER0_COMPA_vect, ISR_BLOCK)
+{
+ /* One millisecond has elapsed, decrement the idle time remaining counter if it has not already elapsed */
+ if (IdleMSRemaining)
+ IdleMSRemaining--;
+
+ if (KeyDelayRemaining)
+ KeyDelayRemaining--;
+}
+
+/** Constructs a keyboard report indicating the currently pressed keyboard keys to the host.
+ *
+ * \param ReportData Pointer to a USB_KeyboardReport_Data_t report structure where the resulting report should
+ * be stored
+ *
+ * \return Boolean true if the current report is different to the previous report, false otherwise
+ */
+bool GetNextReport(USB_KeyboardReport_Data_t* ReportData)
+{
+ static bool OddReport = false;
+ static bool MustRelease = false;
+
+ BitBuffer_t* Buffer = NULL;
+
+ /* Clear the report contents */
+ memset(ReportData, 0, sizeof(USB_KeyboardReport_Data_t));
+
+ /* Get the next non-empty track data buffer */
+ if (Track1Data.Elements)
+ Buffer = &Track1Data;
+ else if (Track2Data.Elements)
+ Buffer = &Track2Data;
+ else if (Track3Data.Elements)
+ Buffer = &Track3Data;
+
+ if (Buffer != NULL)
+ {
+ /* Toggle the odd report number indicator */
+ OddReport = !OddReport;
+
+ /* Set the flag indicating that a null report must eventually be sent to release all pressed keys */
+ MustRelease = true;
+
+ /* Only send the next key on odd reports, so that they are interpersed with null reports to release keys */
+ if (OddReport)
+ {
+ /* Set the report key code to the key code for the next data bit */
+ ReportData->KeyCode[0] = BitBuffer_GetNextBit(Buffer) ? KEY_1 : KEY_0;
+
+ /* If buffer is now empty, a new line must be sent instead of the terminating bit */
+ if (!(Buffer->Elements))
+ {
+ /* Set the keycode to the code for an enter key press */
+ ReportData->KeyCode[0] = KEY_ENTER;
+ }
+ }
+
+ return true;
+ }
+ else if (MustRelease)
+ {
+ /* Leave key code to null (0), to release all pressed keys */
+ return true;
+ }
+
+ return false;
+}
+
+/** Task to read out data from inserted magnetic cards and place the seperate track data into their respective
+ * data buffers for later sending to the host as keyboard key presses.
+ */
+TASK(Magstripe_Read)
+{
+ /* Arrays to hold the buffer pointers, clock and data bit masks for the seperate card tracks */
+ const struct
+ {
+ BitBuffer_t* Buffer;
+ uint8_t ClockMask;
+ uint8_t DataMask;
+ } TrackInfo[] = {{&Track1Data, MAG_T1_CLOCK, MAG_T1_DATA},
+ {&Track2Data, MAG_T2_CLOCK, MAG_T2_DATA},
+ {&Track3Data, MAG_T3_CLOCK, MAG_T3_DATA}};
+
+ /* Previous magnetic card control line' status, for later comparison */
+ uint8_t Magstripe_Prev = 0;
+
+ /* Buffered current card reader control line' status */
+ uint8_t Magstripe_LCL = Magstripe_GetStatus();
+
+ /* Exit the task early if no card is present in the reader */
+ if (!(Magstripe_LCL & MAG_CARDPRESENT))
+ return;
+
+ /* Read out card data while a card is present */
+ while (Magstripe_LCL & MAG_CARDPRESENT)
+ {
+ /* Read out the next bit for each track of the card */
+ for (uint8_t Track = 0; Track < 3; Track++)
+ {
+ /* Current data line status for the current card track */
+ bool DataLevel = ((Magstripe_LCL & TrackInfo[Track].DataMask) != 0);
+
+ /* Current clock line status for the current card track */
+ bool ClockLevel = ((Magstripe_LCL & TrackInfo[Track].ClockMask) != 0);
+
+ /* Current track clock transition check */
+ bool ClockChanged = (((Magstripe_LCL ^ Magstripe_Prev) & TrackInfo[Track].ClockMask) != 0);
+
+ /* Sample the next bit on the falling edge of the track's clock line, store key code into the track's buffer */
+ if (ClockLevel && ClockChanged)
+ BitBuffer_StoreNextBit(TrackInfo[Track].Buffer, DataLevel);
+ }
+
+ /* Retain the current card reader control line states for later edge detection */
+ Magstripe_Prev = Magstripe_LCL;
+
+ /* Retrieve the new card reader control line states */
+ Magstripe_LCL = Magstripe_GetStatus();
+ }
+
+ /* Add terminators to the end of each track buffer */
+ BitBuffer_StoreNextBit(&Track1Data, 0);
+ BitBuffer_StoreNextBit(&Track2Data, 0);
+ BitBuffer_StoreNextBit(&Track3Data, 0);
+}
+
+/** Task for the magnetic card reading and keyboard report generation. This task waits until a card is inserted,
+ * then reads off the card data and sends it to the host as a series of keyboard keypresses via keyboard reports.
+ */
+TASK(USB_Keyboard_Report)
+{
+ USB_KeyboardReport_Data_t KeyboardReportData;
+ bool SendReport = false;
+
+ /* Check if the USB system is connected to a host */
+ if (USB_IsConnected)
+ {
+ /* Select the Keyboard Report Endpoint */
+ Endpoint_SelectEndpoint(KEYBOARD_EPNUM);
+
+ /* Check if Keyboard Endpoint Ready for Read/Write */
+ if (Endpoint_ReadWriteAllowed())
+ {
+ /* Only fetch the next key to send once the period between key presses has elapsed */
+ if (!(KeyDelayRemaining))
+ {
+ /* Create the next keyboard report for transmission to the host */
+ SendReport = GetNextReport(&KeyboardReportData);
+ }
+
+ /* Check if the idle period is set and has elapsed */
+ if (IdleCount && !(IdleMSRemaining))
+ {
+ /* Idle period elapsed, indicate that a report must be sent */
+ SendReport = true;
+
+ /* Reset the idle time remaining counter, must multiply by 4 to get the duration in milliseconds */
+ IdleMSRemaining = (IdleCount << 2);
+ }
+
+ /* Write the keyboard report if a report is to be sent to the host */
+ if (SendReport)
+ {
+ /* Write Keyboard Report Data */
+ Endpoint_Write_Stream_LE(&KeyboardReportData, sizeof(USB_KeyboardReport_Data_t));
+
+ /* Finalize the stream transfer to send the last packet */
+ Endpoint_ClearCurrentBank();
+
+ /* Reset the key delay period counter */
+ KeyDelayRemaining = 2;
+ }
+ }
+ }
+}
diff --git a/Projects/Magstripe/Magstripe.h b/Projects/Magstripe/Magstripe.h
new file mode 100644
index 000000000..cde2fcdc6
--- /dev/null
+++ b/Projects/Magstripe/Magstripe.h
@@ -0,0 +1,121 @@
+/*
+ LUFA Library
+ Copyright (C) Dean Camera, 2009.
+
+ dean [at] fourwalledcubicle [dot] com
+ www.fourwalledcubicle.com
+*/
+
+/*
+ Copyright 2009 Denver Gingerich (denver [at] ossguy [dot] com)
+ Copyright 2009 Dean Camera (dean [at] fourwalledcubicle [dot] com)
+
+ Permission to use, copy, modify, and distribute this software
+ and its documentation for any purpose and without fee is hereby
+ granted, provided that the above copyright notice appear in all
+ copies and that both that the copyright notice and this
+ permission notice and warranty disclaimer appear in supporting
+ documentation, and that the name of the author not be used in
+ advertising or publicity pertaining to distribution of the
+ software without specific, written prior permission.
+
+ The author disclaim all warranties with regard to this
+ software, including all implied warranties of merchantability
+ and fitness. In no event shall the author be liable for any
+ special, indirect or consequential damages or any damages
+ whatsoever resulting from loss of use, data or profits, whether
+ in an action of contract, negligence or other tortious action,
+ arising out of or in connection with the use or performance of
+ this software.
+*/
+
+/** \file
+ *
+ * Header file for Magstripe.c.
+ */
+
+#ifndef _MAGSTRIPE_H_
+#define _MAGSTRIPE_H_
+
+ /* Includes: */
+ #include <avr/io.h>
+ #include <avr/wdt.h>
+ #include <avr/interrupt.h>
+ #include <stdbool.h>
+ #include <string.h>
+
+ #include "Descriptors.h"
+ #include "MagstripeHW.h"
+ #include "CircularBitBuffer.h"
+
+ #include <LUFA/Version.h> // Library Version Information
+ #include <LUFA/Common/ButtLoadTag.h> // PROGMEM tags readable by the ButtLoad project
+ #include <LUFA/Drivers/USB/USB.h> // USB Functionality
+ #include <LUFA/Scheduler/Scheduler.h> // Simple scheduler for task management
+
+
+ /* Task Definitions: */
+ /** Task definition for the keyboard and magnetic card reading task. */
+ TASK(USB_Keyboard_Report);
+
+ TASK(Magstripe_Read);
+
+ /* Macros: */
+ /** HID Class Specific Request to get the current HID report from the device. */
+ #define REQ_GetReport 0x01
+
+ /** HID Class Specific Request to get the current device idle count. */
+ #define REQ_GetIdle 0x02
+
+ /** HID Class Specific Request to set the current HID report to the device. */
+ #define REQ_SetReport 0x09
+
+ /** HID Class Specific Request to set the device's idle count. */
+ #define REQ_SetIdle 0x0A
+
+ /** HID Class Specific Request to get the current HID report protocol mode. */
+ #define REQ_GetProtocol 0x03
+
+ /** HID Class Specific Request to set the current HID report protocol mode. */
+ #define REQ_SetProtocol 0x0B
+
+ /** HID keyboard keycode to indicate that the "1" key is currently pressed. */
+ #define KEY_1 30
+
+ /** HID keyboard keycode to indicate that the "0" key is currently pressed. */
+ #define KEY_0 39
+
+ /** HID keyboard keycode to indicate that the enter key is currently pressed. */
+ #define KEY_ENTER 40
+
+ /* Type Defines: */
+ /** Type define for the keyboard report structure. This structure matches the report layout
+ * given to the host in the HID Report descriptor, as well as matches the boot protocol report
+ * structure. This means that this one report structure can be used in both Report and Boot Protocol
+ * modes. */
+ typedef struct
+ {
+ uint8_t Modifier; /**< Modifier byte, indicating pressed modifier keys such as CTRL or ALT */
+ uint8_t Reserved; /**< Reserved for OEM use, always set to 0 */
+ uint8_t KeyCode[6]; /**< Key code array for pressed keys - up to six can be given simultaneously */
+ } USB_KeyboardReport_Data_t;
+
+ /* Event Handlers: */
+ /** Indicates that this module will catch the USB_Connect event when thrown by the library. */
+ HANDLES_EVENT(USB_Connect);
+
+ /** Indicates that this module will catch the USB_Disconnect event when thrown by the library. */
+ HANDLES_EVENT(USB_Disconnect);
+
+ /** Indicates that this module will catch the USB_ConfigurationChanged event when thrown by the library. */
+ HANDLES_EVENT(USB_ConfigurationChanged);
+
+ /** Indicates that this module will catch the USB_UnhandledControlPacket event when thrown by the library. */
+ HANDLES_EVENT(USB_UnhandledControlPacket);
+
+ /* Function Prototypes: */
+ bool GetNextReport(USB_KeyboardReport_Data_t* ReportData);
+ void SendKey(USB_KeyboardReport_Data_t* KeyboardReportData, uint8_t Key);
+ void Send(USB_KeyboardReport_Data_t* KeyboardReportData, bool SendReport);
+
+#endif
diff --git a/Projects/Magstripe/Magstripe.txt b/Projects/Magstripe/Magstripe.txt
new file mode 100644
index 000000000..d91fddde7
--- /dev/null
+++ b/Projects/Magstripe/Magstripe.txt
@@ -0,0 +1,85 @@
+/** \file
+ *
+ * This file contains special DoxyGen information for the generation of the main page and other special
+ * documentation pages. It is not a project source file.
+ */
+
+/** \mainpage Denver Gingerich's USBSnoop Magnetic Card Reader Project
+ *
+ * Firmware for a USB AVR powered USB TTL magnetic stripe reader (using a card
+ * reader such as the Omron V3B-4K) by Denver Gingerich. This project is designed
+ * to be used with the open source Stripe Snoop project at http://stripesnoop.sourceforge.net/.
+ *
+ * See http://ossguy.com/ss_usb/ for the USB reader hardware project website,
+ * including construction and support details.
+ *
+ * To use, connect your magentic card reader device to the USB AVR as follows (pin and port mapping may be adjusted
+ * from the project makefile):
+ *
+ * <table>
+ * <tr>
+ * <td><b>Signal:</b></td>
+ * <td><b>AVR Port:</b></td>
+ * </tr>
+ * <tr>
+ * <td>Track 1 Data</td>
+ * <td>PORTC, Pin 1</td>
+ * </tr>
+ * <tr>
+ * <td>Track 1 Clock</td>
+ * <td>PORTC, Pin 2</td>
+ * </tr>
+ * <tr>
+ * <td>Track 2 Data</td>
+ * <td>PORTC, Pin 3</td>
+ * </tr>
+ * <tr>
+ * <td>Track 2 Clock</td>
+ * <td>PORTC, Pin 0</td>
+ * </tr>
+ * <tr>
+ * <td>Track 3 Data</td>
+ * <td>PORTC, Pin 5</td>
+ * </tr>
+ * <tr>
+ * <td>Track 3 Clock</td>
+ * <td>PORTC, Pin 6</td>
+ * </tr>
+ * <tr>
+ * <td>Card Detect</td>
+ * <td>PORTC, Pin 4</td>
+ * </tr>
+ * </table>
+ *
+ *
+ * This project is based on the LUFA Keyboard demonstration application,
+ * written by Denver Gingerich.
+ *
+ * This application uses a keyboard HID driver to communicate the data collected
+ * a TTL magnetic stripe reader to the connected computer. The raw bitstream
+ * obtained from the magnetic stripe reader is "typed" through the keyboard
+ * driver as 0's and 1's. After every card swipe, the demo will send a return key.
+ *
+ * <table>
+ * <tr>
+ * <td><b>USB Mode:</b></td>
+ * <td>Device</td>
+ * </tr>
+ * <tr>
+ * <td><b>USB Class:</b></td>
+ * <td>Human Interface Device (HID)</td>
+ * </tr>
+ * <tr>
+ * <td><b>USB Subclass:</b></td>
+ * <td>Keyboard</td>
+ * </tr>
+ * <tr>
+ * <td><b>Relevant Standards:</b></td>
+ * <td>USBIF HID Standard, USBIF HID Usage Tables</td>
+ * </tr>
+ * <tr>
+ * <td><b>Usable Speeds:</b></td>
+ * <td>Low Speed Mode, Full Speed Mode</td>
+ * </tr>
+ * </table>
+ */
diff --git a/Projects/Magstripe/MagstripeHW.h b/Projects/Magstripe/MagstripeHW.h
new file mode 100644
index 000000000..c4681188a
--- /dev/null
+++ b/Projects/Magstripe/MagstripeHW.h
@@ -0,0 +1,100 @@
+/*
+ Copyright 2009 Denver Gingerich (denver [at] ossguy [dot] com)
+ Copyright 2009 Dean Camera (dean [at] fourwalledcubicle [dot] com)
+
+ Permission to use, copy, modify, and distribute this software
+ and its documentation for any purpose and without fee is hereby
+ granted, provided that the above copyright notice appear in all
+ copies and that both that the copyright notice and this
+ permission notice and warranty disclaimer appear in supporting
+ documentation, and that the name of the author not be used in
+ advertising or publicity pertaining to distribution of the
+ software without specific, written prior permission.
+
+ The author disclaim all warranties with regard to this
+ software, including all implied warranties of merchantability
+ and fitness. In no event shall the author be liable for any
+ special, indirect or consequential damages or any damages
+ whatsoever resulting from loss of use, data or profits, whether
+ in an action of contract, negligence or other tortious action,
+ arising out of or in connection with the use or performance of
+ this software.
+*/
+
+/*
+ NOTE: The user of this include file MUST define the following macros
+ prior to including the file:
+
+ MAG_T1_CLOCK_PIN Pin connected to Track 1 clock wire (ie. PORTC1)
+ MAG_T1_DATA_PIN Pin connected to Track 1 data wire (ie. PORTC2)
+ MAG_T2_CLOCK_PIN Pin connected to Track 2 clock wire (ie. PORTC3)
+ MAG_T2_DATA_PIN Pin connected to Track 2 data wire (ie. PORTC0)
+ MAG_T3_CLOCK_PIN Pin connected to Track 3 clock wire (ie. PORTC5)
+ MAG_T3_DATA_PIN Pin connected to Track 3 data wire (ie. PORTC6)
+ MAG_CLS_PIN Pin connected to card loaded wire (ie. PORTC4)
+ MAG_PIN PIN macro for the reader's port (ie. PINC)
+ MAG_DDR DDR macro for the reader's port (ie. DDRC)
+ MAG_PORT PORT macro for the reader's port (ie. PORTC)
+
+ The example macros listed above assume that the Track 2 data wire is
+ connected to pin 0 on port C, the Track 2 clock wire is connected to
+ pin 3 on port C (similarly for Tracks 1 and 3), and the card loaded
+ wire is connected to pin 4 on port C.
+
+ If the magstripe reader you are using only reads one or two tracks,
+ then set the clock and data pins for the tracks it doesn't read to a
+ pin that is unused. For example, on the AT90USBKey, any of the pins on
+ port C that do not have wires attached will be unused since they are
+ not connected to any onboard devices (such as the joystick or
+ temperature sensor).
+
+ Connecting wires to pins on different ports (ie. a data wire to pin 0
+ on port C and a clock wire to pin 0 on port D) is currently
+ unsupported. All pins specified above must be on the same port.
+*/
+
+/** \file
+ *
+ * Driver header for a TTL Magnetic Card reader device (such as the Omron V3B-4K).
+ */
+
+#ifndef _MAGSTRIPEHW_H_
+#define _MAGSTRIPEHW_H_
+
+ /* Includes: */
+ #include <avr/io.h>
+
+ #include <LUFA/Common/Common.h>
+
+ /* Private Interface - For use in library only: */
+ /* Macros: */
+ /** Mask of the track data, clock and card detection pins. */
+ #define MAG_MASK (MAG_T1_DATA | MAG_T1_CLOCK | \
+ MAG_T2_DATA | MAG_T2_CLOCK | \
+ MAG_T3_DATA | MAG_T3_CLOCK | \
+ MAG_CARDPRESENT)
+
+ /* Public Interface - May be used in end-application: */
+ /* Inline Functions: */
+ /** Initializes the magnetic stripe card reader ports and pins so that the card reader
+ * device can be controlled and read by the card reader driver. This must be called before
+ * trying to read any of the card reader's status lines.
+ */
+ static inline void Magstripe_Init(void)
+ {
+ MAG_DDR &= ~MAG_MASK;
+ MAG_PORT |= MAG_MASK;
+ };
+
+ /** Returns the status of all the magnetic card reader's outputs.
+ *
+ * \return A mask indicating which card lines are high or low
+ */
+ static inline uint8_t Magstripe_GetStatus(void) ATTR_WARN_UNUSED_RESULT;
+ static inline uint8_t Magstripe_GetStatus(void)
+ {
+ /* Magstripe IOs are active low and must be inverted when read */
+ return ((uint8_t)~MAG_PIN & MAG_MASK);
+ }
+
+#endif
diff --git a/Projects/Magstripe/makefile b/Projects/Magstripe/makefile
new file mode 100644
index 000000000..2ea5536fb
--- /dev/null
+++ b/Projects/Magstripe/makefile
@@ -0,0 +1,712 @@
+# Hey Emacs, this is a -*- makefile -*-
+#----------------------------------------------------------------------------
+# WinAVR Makefile Template written by Eric B. Weddington, J�rg Wunsch, et al.
+# >> Modified for use with the LUFA project. <<
+#
+# Released to the Public Domain
+#
+# Additional material for this makefile was written by:
+# Peter Fleury
+# Tim Henigan
+# Colin O'Flynn
+# Reiner Patommel
+# Markus Pfaff
+# Sander Pool
+# Frederik Rouleau
+# Carlos Lamas
+# Dean Camera
+# Opendous Inc.
+# Denver Gingerich
+#
+#----------------------------------------------------------------------------
+# On command line:
+#
+# make all = Make software.
+#
+# make clean = Clean out built project files.
+#
+# make coff = Convert ELF to AVR COFF.
+#
+# make extcoff = Convert ELF to AVR Extended COFF.
+#
+# make program = Download the hex file to the device, using avrdude.
+# Please customize the avrdude settings below first!
+#
+# make dfu = Download the hex file to the device, using dfu-programmer (must
+# have dfu-programmer installed).
+#
+# make flip = Download the hex file to the device, using Atmel FLIP (must
+# have Atmel FLIP installed).
+#
+# make dfu-ee = Download the eeprom file to the device, using dfu-programmer
+# (must have dfu-programmer installed).
+#
+# make flip-ee = Download the eeprom file to the device, using Atmel FLIP
+# (must have Atmel FLIP installed).
+#
+# make doxygen = Generate DoxyGen documentation for the project (must have
+# DoxyGen installed)
+#
+# make debug = Start either simulavr or avarice as specified for debugging,
+# with avr-gdb or avr-insight as the front end for debugging.
+#
+# make filename.s = Just compile filename.c into the assembler code only.
+#
+# make filename.i = Create a preprocessed source file for use in submitting
+# bug reports to the GCC project.
+#
+# To rebuild project do "make clean" then "make all".
+#----------------------------------------------------------------------------
+
+
+# MCU name
+MCU = at90usb1287
+
+
+# Target board (see library BoardTypes.h documentation, USER or blank for projects not requiring
+# LUFA board drivers). If USER is selected, put custom board drivers in a directory called
+# "Board" inside the application directory.
+BOARD = USBKEY
+
+
+# Processor frequency.
+# This will define a symbol, F_CPU, in all source code files equal to the
+# processor frequency. You can then use this symbol in your source code to
+# calculate timings. Do NOT tack on a 'UL' at the end, this will be done
+# automatically to create a 32-bit value in your source code.
+# Typical values are:
+# F_CPU = 1000000
+# F_CPU = 1843200
+# F_CPU = 2000000
+# F_CPU = 3686400
+# F_CPU = 4000000
+# F_CPU = 7372800
+# F_CPU = 8000000
+# F_CPU = 11059200
+# F_CPU = 14745600
+# F_CPU = 16000000
+# F_CPU = 18432000
+# F_CPU = 20000000
+F_CPU = 16000000
+
+
+# Output format. (can be srec, ihex, binary)
+FORMAT = ihex
+
+
+# Target file name (without extension).
+TARGET = Magstripe
+
+
+# Object files directory
+# To put object files in current directory, use a dot (.), do NOT make
+# this an empty or blank macro!
+OBJDIR = .
+
+
+# List C source files here. (C dependencies are automatically generated.)
+SRC = $(TARGET).c \
+ Descriptors.c \
+ CircularBitBuffer.c \
+ ../../LUFA/Scheduler/Scheduler.c \
+ ../../LUFA/Drivers/USB/LowLevel/LowLevel.c \
+ ../../LUFA/Drivers/USB/LowLevel/Endpoint.c \
+ ../../LUFA/Drivers/USB/LowLevel/DevChapter9.c \
+ ../../LUFA/Drivers/USB/HighLevel/USBTask.c \
+ ../../LUFA/Drivers/USB/HighLevel/USBInterrupt.c \
+ ../../LUFA/Drivers/USB/HighLevel/Events.c \
+ ../../LUFA/Drivers/USB/HighLevel/StdDescriptors.c \
+
+# List C++ source files here. (C dependencies are automatically generated.)
+CPPSRC =
+
+
+# List Assembler source files here.
+# Make them always end in a capital .S. Files ending in a lowercase .s
+# will not be considered source files but generated files (assembler
+# output from the compiler), and will be deleted upon "make clean"!
+# Even though the DOS/Win* filesystem matches both .s and .S the same,
+# it will preserve the spelling of the filenames, and gcc itself does
+# care about how the name is spelled on its command-line.
+ASRC =
+
+
+# Optimization level, can be [0, 1, 2, 3, s].
+# 0 = turn off optimization. s = optimize for size.
+# (Note: 3 is not always the best optimization level. See avr-libc FAQ.)
+OPT = s
+
+
+# Debugging format.
+# Native formats for AVR-GCC's -g are dwarf-2 [default] or stabs.
+# AVR Studio 4.10 requires dwarf-2.
+# AVR [Extended] COFF format requires stabs, plus an avr-objcopy run.
+DEBUG = dwarf-2
+
+
+# List any extra directories to look for include files here.
+# Each directory must be seperated by a space.
+# Use forward slashes for directory separators.
+# For a directory that has spaces, enclose it in quotes.
+EXTRAINCDIRS = ../../
+
+
+# Compiler flag to set the C Standard level.
+# c89 = "ANSI" C
+# gnu89 = c89 plus GCC extensions
+# c99 = ISO C99 standard (not yet fully implemented)
+# gnu99 = c99 plus GCC extensions
+CSTANDARD = -std=gnu99
+
+
+# Place -D or -U options here for C sources
+CDEFS = -DF_CPU=$(F_CPU)UL -DBOARD=BOARD_$(BOARD) -DUSE_NONSTANDARD_DESCRIPTOR_NAMES -DNO_STREAM_CALLBACKS
+CDEFS += -DUSB_DEVICE_ONLY -DUSE_STATIC_OPTIONS="(USB_DEVICE_OPT_FULLSPEED | USB_OPT_REG_ENABLED | USB_OPT_AUTO_PLL)"
+
+CDEFS += -DMAG_T1_CLOCK="(1 << 0)"
+CDEFS += -DMAG_T1_DATA="(1 << 1)"
+CDEFS += -DMAG_T2_CLOCK="(1 << 2)"
+CDEFS += -DMAG_T2_DATA="(1 << 3)"
+CDEFS += -DMAG_T3_CLOCK="(1 << 4)"
+CDEFS += -DMAG_T3_DATA="(1 << 5)"
+CDEFS += -DMAG_CARDPRESENT="(1 << 6)"
+CDEFS += -DMAG_PIN=PINB
+CDEFS += -DMAG_DDR=DDRB
+CDEFS += -DMAG_PORT=PORTB
+
+# Place -D or -U options here for ASM sources
+ADEFS = -DF_CPU=$(F_CPU)
+
+
+# Place -D or -U options here for C++ sources
+CPPDEFS = -DF_CPU=$(F_CPU)UL
+#CPPDEFS += -D__STDC_LIMIT_MACROS
+#CPPDEFS += -D__STDC_CONSTANT_MACROS
+
+
+
+#---------------- Compiler Options C ----------------
+# -g*: generate debugging information
+# -O*: optimization level
+# -f...: tuning, see GCC manual and avr-libc documentation
+# -Wall...: warning level
+# -Wa,...: tell GCC to pass this to the assembler.
+# -adhlns...: create assembler listing
+CFLAGS = -g$(DEBUG)
+CFLAGS += $(CDEFS)
+CFLAGS += -O$(OPT)
+CFLAGS += -funsigned-char
+CFLAGS += -funsigned-bitfields
+CFLAGS += -fpack-struct
+CFLAGS += -fshort-enums
+CFLAGS += -ffunction-sections
+CFLAGS += -finline-limit=20
+CFLAGS += -Wall
+CFLAGS += -Wstrict-prototypes
+CFLAGS += -Wundef
+#CFLAGS += -fno-unit-at-a-time
+#CFLAGS += -Wunreachable-code
+#CFLAGS += -Wsign-compare
+CFLAGS += -Wa,-adhlns=$(<:%.c=$(OBJDIR)/%.lst)
+CFLAGS += $(patsubst %,-I%,$(EXTRAINCDIRS))
+CFLAGS += $(CSTANDARD)
+
+
+#---------------- Compiler Options C++ ----------------
+# -g*: generate debugging information
+# -O*: optimization level
+# -f...: tuning, see GCC manual and avr-libc documentation
+# -Wall...: warning level
+# -Wa,...: tell GCC to pass this to the assembler.
+# -adhlns...: create assembler listing
+CPPFLAGS = -g$(DEBUG)
+CPPFLAGS += $(CPPDEFS)
+CPPFLAGS += -O$(OPT)
+CPPFLAGS += -funsigned-char
+CPPFLAGS += -funsigned-bitfields
+CPPFLAGS += -fpack-struct
+CPPFLAGS += -fshort-enums
+CPPFLAGS += -fno-exceptions
+CPPFLAGS += -Wall
+CFLAGS += -Wundef
+#CPPFLAGS += -fno-unit-at-a-time
+#CPPFLAGS += -Wstrict-prototypes
+#CPPFLAGS += -Wunreachable-code
+#CPPFLAGS += -Wsign-compare
+CPPFLAGS += -Wa,-adhlns=$(<:%.cpp=$(OBJDIR)/%.lst)
+CPPFLAGS += $(patsubst %,-I%,$(EXTRAINCDIRS))
+#CPPFLAGS += $(CSTANDARD)
+
+
+#---------------- Assembler Options ----------------
+# -Wa,...: tell GCC to pass this to the assembler.
+# -adhlns: create listing
+# -gstabs: have the assembler create line number information; note that
+# for use in COFF files, additional information about filenames
+# and function names needs to be present in the assembler source
+# files -- see avr-libc docs [FIXME: not yet described there]
+# -listing-cont-lines: Sets the maximum number of continuation lines of hex
+# dump that will be displayed for a given single line of source input.
+ASFLAGS = $(ADEFS) -Wa,-adhlns=$(<:%.S=$(OBJDIR)/%.lst),-gstabs,--listing-cont-lines=100
+
+
+#---------------- Library Options ----------------
+# Minimalistic printf version
+PRINTF_LIB_MIN = -Wl,-u,vfprintf -lprintf_min
+
+# Floating point printf version (requires MATH_LIB = -lm below)
+PRINTF_LIB_FLOAT = -Wl,-u,vfprintf -lprintf_flt
+
+# If this is left blank, then it will use the Standard printf version.
+PRINTF_LIB =
+#PRINTF_LIB = $(PRINTF_LIB_MIN)
+#PRINTF_LIB = $(PRINTF_LIB_FLOAT)
+
+
+# Minimalistic scanf version
+SCANF_LIB_MIN = -Wl,-u,vfscanf -lscanf_min
+
+# Floating point + %[ scanf version (requires MATH_LIB = -lm below)
+SCANF_LIB_FLOAT = -Wl,-u,vfscanf -lscanf_flt
+
+# If this is left blank, then it will use the Standard scanf version.
+SCANF_LIB =
+#SCANF_LIB = $(SCANF_LIB_MIN)
+#SCANF_LIB = $(SCANF_LIB_FLOAT)
+
+
+MATH_LIB = -lm
+
+
+# List any extra directories to look for libraries here.
+# Each directory must be seperated by a space.
+# Use forward slashes for directory separators.
+# For a directory that has spaces, enclose it in quotes.
+EXTRALIBDIRS =
+
+
+
+#---------------- External Memory Options ----------------
+
+# 64 KB of external RAM, starting after internal RAM (ATmega128!),
+# used for variables (.data/.bss) and heap (malloc()).
+#EXTMEMOPTS = -Wl,-Tdata=0x801100,--defsym=__heap_end=0x80ffff
+
+# 64 KB of external RAM, starting after internal RAM (ATmega128!),
+# only used for heap (malloc()).
+#EXTMEMOPTS = -Wl,--section-start,.data=0x801100,--defsym=__heap_end=0x80ffff
+
+EXTMEMOPTS =
+
+
+
+#---------------- Linker Options ----------------
+# -Wl,...: tell GCC to pass this to linker.
+# -Map: create map file
+# --cref: add cross reference to map file
+LDFLAGS = -Wl,-Map=$(TARGET).map,--cref
+LDFLAGS += -Wl,--relax
+LDFLAGS += -Wl,--gc-sections
+LDFLAGS += $(EXTMEMOPTS)
+LDFLAGS += $(patsubst %,-L%,$(EXTRALIBDIRS))
+LDFLAGS += $(PRINTF_LIB) $(SCANF_LIB) $(MATH_LIB)
+#LDFLAGS += -T linker_script.x
+
+
+
+#---------------- Programming Options (avrdude) ----------------
+
+# Programming hardware: alf avr910 avrisp bascom bsd
+# dt006 pavr picoweb pony-stk200 sp12 stk200 stk500
+#
+# Type: avrdude -c ?
+# to get a full listing.
+#
+AVRDUDE_PROGRAMMER = jtagmkII
+
+# com1 = serial port. Use lpt1 to connect to parallel port.
+AVRDUDE_PORT = usb
+
+AVRDUDE_WRITE_FLASH = -U flash:w:$(TARGET).hex
+#AVRDUDE_WRITE_EEPROM = -U eeprom:w:$(TARGET).eep
+
+
+# Uncomment the following if you want avrdude's erase cycle counter.
+# Note that this counter needs to be initialized first using -Yn,
+# see avrdude manual.
+#AVRDUDE_ERASE_COUNTER = -y
+
+# Uncomment the following if you do /not/ wish a verification to be
+# performed after programming the device.
+#AVRDUDE_NO_VERIFY = -V
+
+# Increase verbosity level. Please use this when submitting bug
+# reports about avrdude. See <http://savannah.nongnu.org/projects/avrdude>
+# to submit bug reports.
+#AVRDUDE_VERBOSE = -v -v
+
+AVRDUDE_FLAGS = -p $(MCU) -P $(AVRDUDE_PORT) -c $(AVRDUDE_PROGRAMMER)
+AVRDUDE_FLAGS += $(AVRDUDE_NO_VERIFY)
+AVRDUDE_FLAGS += $(AVRDUDE_VERBOSE)
+AVRDUDE_FLAGS += $(AVRDUDE_ERASE_COUNTER)
+
+
+
+#---------------- Debugging Options ----------------
+
+# For simulavr only - target MCU frequency.
+DEBUG_MFREQ = $(F_CPU)
+
+# Set the DEBUG_UI to either gdb or insight.
+# DEBUG_UI = gdb
+DEBUG_UI = insight
+
+# Set the debugging back-end to either avarice, simulavr.
+DEBUG_BACKEND = avarice
+#DEBUG_BACKEND = simulavr
+
+# GDB Init Filename.
+GDBINIT_FILE = __avr_gdbinit
+
+# When using avarice settings for the JTAG
+JTAG_DEV = /dev/com1
+
+# Debugging port used to communicate between GDB / avarice / simulavr.
+DEBUG_PORT = 4242
+
+# Debugging host used to communicate between GDB / avarice / simulavr, normally
+# just set to localhost unless doing some sort of crazy debugging when
+# avarice is running on a different computer.
+DEBUG_HOST = localhost
+
+
+
+#============================================================================
+
+
+# Define programs and commands.
+SHELL = sh
+CC = avr-gcc
+OBJCOPY = avr-objcopy
+OBJDUMP = avr-objdump
+SIZE = avr-size
+AR = avr-ar rcs
+NM = avr-nm
+AVRDUDE = avrdude
+REMOVE = rm -f
+REMOVEDIR = rm -rf
+COPY = cp
+WINSHELL = cmd
+
+# Define Messages
+# English
+MSG_ERRORS_NONE = Errors: none
+MSG_BEGIN = -------- begin --------
+MSG_END = -------- end --------
+MSG_SIZE_BEFORE = Size before:
+MSG_SIZE_AFTER = Size after:
+MSG_COFF = Converting to AVR COFF:
+MSG_EXTENDED_COFF = Converting to AVR Extended COFF:
+MSG_FLASH = Creating load file for Flash:
+MSG_EEPROM = Creating load file for EEPROM:
+MSG_EXTENDED_LISTING = Creating Extended Listing:
+MSG_SYMBOL_TABLE = Creating Symbol Table:
+MSG_LINKING = Linking:
+MSG_COMPILING = Compiling C:
+MSG_COMPILING_CPP = Compiling C++:
+MSG_ASSEMBLING = Assembling:
+MSG_CLEANING = Cleaning project:
+MSG_CREATING_LIBRARY = Creating library:
+
+
+
+
+# Define all object files.
+OBJ = $(SRC:%.c=$(OBJDIR)/%.o) $(CPPSRC:%.cpp=$(OBJDIR)/%.o) $(ASRC:%.S=$(OBJDIR)/%.o)
+
+# Define all listing files.
+LST = $(SRC:%.c=$(OBJDIR)/%.lst) $(CPPSRC:%.cpp=$(OBJDIR)/%.lst) $(ASRC:%.S=$(OBJDIR)/%.lst)
+
+
+# Compiler flags to generate dependency files.
+GENDEPFLAGS = -MMD -MP -MF .dep/$(@F).d
+
+
+# Combine all necessary flags and optional flags.
+# Add target processor to flags.
+ALL_CFLAGS = -mmcu=$(MCU) -I. $(CFLAGS) $(GENDEPFLAGS)
+ALL_CPPFLAGS = -mmcu=$(MCU) -I. -x c++ $(CPPFLAGS) $(GENDEPFLAGS)
+ALL_ASFLAGS = -mmcu=$(MCU) -I. -x assembler-with-cpp $(ASFLAGS)
+
+
+
+
+
+# Default target.
+all: begin gccversion sizebefore build checkhooks checklibmode sizeafter end
+
+# Change the build target to build a HEX file or a library.
+build: elf hex eep lss sym
+#build: lib
+
+
+elf: $(TARGET).elf
+hex: $(TARGET).hex
+eep: $(TARGET).eep
+lss: $(TARGET).lss
+sym: $(TARGET).sym
+LIBNAME=lib$(TARGET).a
+lib: $(LIBNAME)
+
+
+
+# Eye candy.
+# AVR Studio 3.x does not check make's exit code but relies on
+# the following magic strings to be generated by the compile job.
+begin:
+ @echo
+ @echo $(MSG_BEGIN)
+
+end:
+ @echo $(MSG_END)
+ @echo
+
+
+# Display size of file.
+HEXSIZE = $(SIZE) --target=$(FORMAT) $(TARGET).hex
+ELFSIZE = $(SIZE) $(MCU_FLAG) $(FORMAT_FLAG) $(TARGET).elf
+MCU_FLAG = $(shell $(SIZE) --help | grep -- --mcu > /dev/null && echo --mcu=$(MCU) )
+FORMAT_FLAG = $(shell $(SIZE) --help | grep -- --format=.*avr > /dev/null && echo --format=avr )
+
+sizebefore:
+ @if test -f $(TARGET).elf; then echo; echo $(MSG_SIZE_BEFORE); $(ELFSIZE); \
+ 2>/dev/null; echo; fi
+
+sizeafter:
+ @if test -f $(TARGET).elf; then echo; echo $(MSG_SIZE_AFTER); $(ELFSIZE); \
+ 2>/dev/null; echo; fi
+
+checkhooks: build
+ @echo
+ @echo ------- Unhooked LUFA Events -------
+ @$(shell) (grep -s '^Event.*LUFA/.*\\.o' $(TARGET).map | \
+ cut -d' ' -f1 | cut -d'_' -f2- | grep ".*") || \
+ echo "(None)"
+ @echo ----- End Unhooked LUFA Events -----
+
+checklibmode:
+ @echo
+ @echo ----------- Library Mode -----------
+ @$(shell) ($(CC) $(ALL_CFLAGS) -E -dM - < /dev/null \
+ | grep 'USB_\(DEVICE\|HOST\)_ONLY' | cut -d' ' -f2 | grep ".*") \
+ || echo "No specific mode (both device and host mode allowable)."
+ @echo ------------------------------------
+
+# Display compiler version information.
+gccversion :
+ @$(CC) --version
+
+
+
+# Program the device.
+program: $(TARGET).hex $(TARGET).eep
+ $(AVRDUDE) $(AVRDUDE_FLAGS) $(AVRDUDE_WRITE_FLASH) $(AVRDUDE_WRITE_EEPROM)
+
+flip: $(TARGET).hex
+ batchisp -hardware usb -device $(MCU) -operation erase f
+ batchisp -hardware usb -device $(MCU) -operation loadbuffer $(TARGET).hex program
+ batchisp -hardware usb -device $(MCU) -operation start reset 0
+
+dfu: $(TARGET).hex
+ dfu-programmer $(MCU) erase
+ dfu-programmer $(MCU) flash --debug 1 $(TARGET).hex
+ dfu-programmer $(MCU) reset
+
+flip-ee: $(TARGET).hex $(TARGET).eep
+ copy $(TARGET).eep $(TARGET)eep.hex
+ batchisp -hardware usb -device $(MCU) -operation memory EEPROM erase
+ batchisp -hardware usb -device $(MCU) -operation memory EEPROM loadbuffer $(TARGET)eep.hex program
+ batchisp -hardware usb -device $(MCU) -operation start reset 0
+
+dfu-ee: $(TARGET).hex $(TARGET).eep
+ dfu-programmer $(MCU) erase
+ dfu-programmer $(MCU) eeprom --debug 1 $(TARGET).eep
+ dfu-programmer $(MCU) reset
+
+# Generate avr-gdb config/init file which does the following:
+# define the reset signal, load the target file, connect to target, and set
+# a breakpoint at main().
+gdb-config:
+ @$(REMOVE) $(GDBINIT_FILE)
+ @echo define reset >> $(GDBINIT_FILE)
+ @echo SIGNAL SIGHUP >> $(GDBINIT_FILE)
+ @echo end >> $(GDBINIT_FILE)
+ @echo file $(TARGET).elf >> $(GDBINIT_FILE)
+ @echo target remote $(DEBUG_HOST):$(DEBUG_PORT) >> $(GDBINIT_FILE)
+ifeq ($(DEBUG_BACKEND),simulavr)
+ @echo load >> $(GDBINIT_FILE)
+endif
+ @echo break main >> $(GDBINIT_FILE)
+
+debug: gdb-config $(TARGET).elf
+ifeq ($(DEBUG_BACKEND), avarice)
+ @echo Starting AVaRICE - Press enter when "waiting to connect" message displays.
+ @$(WINSHELL) /c start avarice --jtag $(JTAG_DEV) --erase --program --file \
+ $(TARGET).elf $(DEBUG_HOST):$(DEBUG_PORT)
+ @$(WINSHELL) /c pause
+
+else
+ @$(WINSHELL) /c start simulavr --gdbserver --device $(MCU) --clock-freq \
+ $(DEBUG_MFREQ) --port $(DEBUG_PORT)
+endif
+ @$(WINSHELL) /c start avr-$(DEBUG_UI) --command=$(GDBINIT_FILE)
+
+
+
+
+# Convert ELF to COFF for use in debugging / simulating in AVR Studio or VMLAB.
+COFFCONVERT = $(OBJCOPY) --debugging
+COFFCONVERT += --change-section-address .data-0x800000
+COFFCONVERT += --change-section-address .bss-0x800000
+COFFCONVERT += --change-section-address .noinit-0x800000
+COFFCONVERT += --change-section-address .eeprom-0x810000
+
+
+
+coff: $(TARGET).elf
+ @echo
+ @echo $(MSG_COFF) $(TARGET).cof
+ $(COFFCONVERT) -O coff-avr $< $(TARGET).cof
+
+
+extcoff: $(TARGET).elf
+ @echo
+ @echo $(MSG_EXTENDED_COFF) $(TARGET).cof
+ $(COFFCONVERT) -O coff-ext-avr $< $(TARGET).cof
+
+
+
+# Create final output files (.hex, .eep) from ELF output file.
+%.hex: %.elf
+ @echo
+ @echo $(MSG_FLASH) $@
+ $(OBJCOPY) -O $(FORMAT) -R .eeprom $< $@
+
+%.eep: %.elf
+ @echo
+ @echo $(MSG_EEPROM) $@
+ -$(OBJCOPY) -j .eeprom --set-section-flags=.eeprom="alloc,load" \
+ --change-section-lma .eeprom=0 --no-change-warnings -O $(FORMAT) $< $@ || exit 0
+
+# Create extended listing file from ELF output file.
+%.lss: %.elf
+ @echo
+ @echo $(MSG_EXTENDED_LISTING) $@
+ $(OBJDUMP) -h -z -S $< > $@
+
+# Create a symbol table from ELF output file.
+%.sym: %.elf
+ @echo
+ @echo $(MSG_SYMBOL_TABLE) $@
+ $(NM) -n $< > $@
+
+
+
+# Create library from object files.
+.SECONDARY : $(TARGET).a
+.PRECIOUS : $(OBJ)
+%.a: $(OBJ)
+ @echo
+ @echo $(MSG_CREATING_LIBRARY) $@
+ $(AR) $@ $(OBJ)
+
+
+# Link: create ELF output file from object files.
+.SECONDARY : $(TARGET).elf
+.PRECIOUS : $(OBJ)
+%.elf: $(OBJ)
+ @echo
+ @echo $(MSG_LINKING) $@
+ $(CC) $(ALL_CFLAGS) $^ --output $@ $(LDFLAGS)
+
+
+# Compile: create object files from C source files.
+$(OBJDIR)/%.o : %.c
+ @echo
+ @echo $(MSG_COMPILING) $<
+ $(CC) -c $(ALL_CFLAGS) $< -o $@
+
+
+# Compile: create object files from C++ source files.
+$(OBJDIR)/%.o : %.cpp
+ @echo
+ @echo $(MSG_COMPILING_CPP) $<
+ $(CC) -c $(ALL_CPPFLAGS) $< -o $@
+
+
+# Compile: create assembler files from C source files.
+%.s : %.c
+ $(CC) -S $(ALL_CFLAGS) $< -o $@
+
+
+# Compile: create assembler files from C++ source files.
+%.s : %.cpp
+ $(CC) -S $(ALL_CPPFLAGS) $< -o $@
+
+
+# Assemble: create object files from assembler source files.
+$(OBJDIR)/%.o : %.S
+ @echo
+ @echo $(MSG_ASSEMBLING) $<
+ $(CC) -c $(ALL_ASFLAGS) $< -o $@
+
+
+# Create preprocessed source for use in sending a bug report.
+%.i : %.c
+ $(CC) -E -mmcu=$(MCU) -I. $(CFLAGS) $< -o $@
+
+
+# Target: clean project.
+clean: begin clean_list clean_binary end
+
+clean_binary:
+ $(REMOVE) $(TARGET).hex
+
+clean_list:
+ @echo $(MSG_CLEANING)
+ $(REMOVE) $(TARGET).eep
+ $(REMOVE) $(TARGET).cof
+ $(REMOVE) $(TARGET).elf
+ $(REMOVE) $(TARGET).map
+ $(REMOVE) $(TARGET).sym
+ $(REMOVE) $(TARGET).lss
+ $(REMOVE) $(SRC:%.c=$(OBJDIR)/%.o)
+ $(REMOVE) $(SRC:%.c=$(OBJDIR)/%.lst)
+ $(REMOVE) $(SRC:.c=.s)
+ $(REMOVE) $(SRC:.c=.d)
+ $(REMOVE) $(SRC:.c=.i)
+ $(REMOVEDIR) .dep
+
+
+doxygen:
+ @echo Generating Project Documentation...
+ @doxygen Doxygen.conf
+ @echo Documentation Generation Complete.
+
+clean_doxygen:
+ rm -rf Documentation
+
+# Create object files directory
+$(shell mkdir $(OBJDIR) 2>/dev/null)
+
+
+# Include the dependency files.
+-include $(shell mkdir .dep 2>/dev/null) $(wildcard .dep/*)
+
+
+# Listing of phony targets.
+.PHONY : all checkhooks checklibmode begin \
+finish end sizebefore sizeafter gccversion \
+build elf hex eep lss sym coff extcoff \
+clean clean_list clean_binary program debug \
+gdb-config doxygen dfu flip
diff --git a/Projects/makefile b/Projects/makefile
new file mode 100644
index 000000000..50851a3ef
--- /dev/null
+++ b/Projects/makefile
@@ -0,0 +1,25 @@
+#
+# LUFA Library
+# Copyright (C) Dean Camera, 2009.
+#
+# dean [at] fourwalledcubicle [dot] com
+# www.fourwalledcubicle.com
+#
+
+# Makefile to build all the LUFA Projects. Call with "make all" to
+# rebuild all projects.
+
+# Projects are pre-cleaned before each one is built, to ensure any
+# custom LUFA library build options are reflected in the compiled
+# code.
+
+all:
+ make -C Magstripe clean
+ make -C Magstripe all
+
+ make -C AVRISP_Programmer clean
+ make -C AVRISP_Programmer all
+
+%:
+ make -C Magstripe $@
+ make -C AVRISP_Programmer $@
--
GitLab