From 88051e78a281f5776538558aec113ff2b66e056c Mon Sep 17 00:00:00 2001
From: Dean Camera <dean@fourwalledcubicle.com>
Date: Thu, 19 Mar 2009 14:16:12 +0000
Subject: [PATCH] Combined Mouse, MouseViaInt and MouseFullInt demos into a
single unified demo.
Corrections to Keyboard demo.
Removed AVRISP_Programmer project due to code quality concerns.
---
Bootloaders/CDC/BootloaderCDC.txt | 38 +-
Bootloaders/DFU/BootloaderDFU.txt | 69 +-
Bootloaders/TeensyHID/TeensyHID.h | 4 +-
Bootloaders/TeensyHID/TeensyHID.txt | 36 +-
Demos/AudioInput/AudioInput.c | 4 -
Demos/AudioInput/AudioInput.txt | 52 +-
Demos/AudioOutput/AudioOutput.c | 7 -
Demos/AudioOutput/AudioOutput.txt | 68 +-
Demos/AudioOutput/makefile | 2 +-
Demos/CDC/CDC.txt | 44 +-
Demos/CDCHost/CDCHost.txt | 39 +-
Demos/DualCDC/DualCDC.txt | 60 +-
Demos/Joystick/Joystick.txt | 42 +-
Demos/Keyboard/Keyboard.c | 14 +
Demos/Keyboard/Keyboard.txt | 1 +
Demos/KeyboardHost/KeyboardHost.txt | 48 +-
Demos/KeyboardHostViaInt/KeyboardHostViaInt.h | 2 +-
.../KeyboardHostViaInt/KeyboardHostViaInt.txt | 52 +-
.../KeyboardHostWithParser.txt | 44 +-
Demos/KeyboardMouse/KeyboardMouse.txt | 50 +-
Demos/MIDI/MIDI.txt | 47 +-
Demos/MassStorage/MassStorage.h | 5 +-
Demos/MassStorage/MassStorage.txt | 62 +-
Demos/MassStorageHost/MassStorageHost.txt | 36 +-
Demos/Mouse/Mouse.c | 149 +-
Demos/Mouse/Mouse.h | 5 +-
Demos/Mouse/Mouse.txt | 54 +-
Demos/Mouse/makefile | 1 -
Demos/MouseHost/MouseHost.txt | 50 +-
Demos/MouseHostViaInt/MouseHostViaInt.txt | 54 +-
.../MouseHostWithParser.txt | 44 +-
Demos/RNDISEthernet/RNDISEthernet.txt | 55 +-
Demos/StillImageHost/StillImageHost.txt | 34 +-
Demos/TestApp/TestApp.txt | 54 +-
Demos/USBtoSerial/USBtoSerial.txt | 49 +-
Demos/makefile | 8 -
LUFA.pnproj | 2 +-
LUFA/ChangeLog.txt | 4 +-
.../AVRISP_Firmware_Design.txt | 176 --
.../AVRISP_Programmer/AVRISP_Programmer.aps | 1 -
.../AVRISP_Programmer/AVRISP_Programmer.c | 763 ---------
.../AVRISP_Programmer/AVRISP_Programmer.h | 195 ---
.../AVRISP_Programmer/AVRISP_Programmer.txt | 89 -
.../AVRISP_Programmer_Picture.jpg | Bin 74610 -> 0 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 | 726 --------
Projects/Magstripe/Magstripe.txt | 72 +-
Projects/makefile | 4 -
54 files changed, 1043 insertions(+), 4613 deletions(-)
delete mode 100644 Projects/AVRISP_Programmer/AVRISP_Firmware_Design.txt
delete mode 100644 Projects/AVRISP_Programmer/AVRISP_Programmer.aps
delete mode 100644 Projects/AVRISP_Programmer/AVRISP_Programmer.c
delete mode 100644 Projects/AVRISP_Programmer/AVRISP_Programmer.h
delete mode 100644 Projects/AVRISP_Programmer/AVRISP_Programmer.txt
delete mode 100644 Projects/AVRISP_Programmer/AVRISP_Programmer_Picture.jpg
delete mode 100644 Projects/AVRISP_Programmer/Descriptors.c
delete mode 100644 Projects/AVRISP_Programmer/Descriptors.h
delete mode 100644 Projects/AVRISP_Programmer/Doxygen.conf
delete mode 100644 Projects/AVRISP_Programmer/LUFA AVRISP_Programmer.inf
delete mode 100644 Projects/AVRISP_Programmer/RingBuff.c
delete mode 100644 Projects/AVRISP_Programmer/RingBuff.h
delete mode 100644 Projects/AVRISP_Programmer/Sample_Programming_Session.txt
delete mode 100644 Projects/AVRISP_Programmer/makefile
diff --git a/Bootloaders/CDC/BootloaderCDC.txt b/Bootloaders/CDC/BootloaderCDC.txt
index cb6f9f01f..1f8970d57 100644
--- a/Bootloaders/CDC/BootloaderCDC.txt
+++ b/Bootloaders/CDC/BootloaderCDC.txt
@@ -5,15 +5,10 @@
*/
/** \mainpage CDC Class USB AVR Bootloader
- *
- * This bootloader enumerates to the host as a CDC Class device (virtual serial port), allowing for AVR109
- * protocol compatible programming software to load firmware onto the AVR.
- *
- * Out of the box this bootloader builds for the USB1287, and will fit into 4KB of bootloader space. If
- * you wish to enlarge this space and/or change the AVR model, you will need to edit the BOOT_START and MCU
- * values in the accompanying makefile.
- *
- * This bootloader is compatible with the open source application AVRDUDE, or Atmel's AVRPROG.
+ *
+ * \section SSec_Info USB Information:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
*
* <table>
* <tr>
@@ -37,4 +32,27 @@
* <td>Full Speed Mode</td>
* </tr>
* </table>
- */
+ *
+ * \section SSec_Description Project Description:
+ *
+ * This bootloader enumerates to the host as a CDC Class device (virtual serial port), allowing for AVR109
+ * protocol compatible programming software to load firmware onto the AVR.
+ *
+ * Out of the box this bootloader builds for the USB1287, and will fit into 4KB of bootloader space. If
+ * you wish to enlarge this space and/or change the AVR model, you will need to edit the BOOT_START and MCU
+ * values in the accompanying makefile.
+ *
+ * This bootloader is compatible with the open source application AVRDUDE, or Atmel's AVRPROG.
+ *
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
+ * <table>
+ * <tr>
+ * <td>
+ * None
+ * </td>
+ * </tr>
+ * </table>
+ */
\ No newline at end of file
diff --git a/Bootloaders/DFU/BootloaderDFU.txt b/Bootloaders/DFU/BootloaderDFU.txt
index 091ce4083..7107cc123 100644
--- a/Bootloaders/DFU/BootloaderDFU.txt
+++ b/Bootloaders/DFU/BootloaderDFU.txt
@@ -5,27 +5,10 @@
*/
/** \mainpage DFU Class USB AVR Bootloader
- *
- * This bootloader enumerates to the host as a DFU Class device, allowing for DFU-compatible programming
- * software to load firmware onto the AVR.
- *
- * This bootloader is compatible with Atmel's FLIP application. However, it requires the use of Atmel's
- * DFU drivers. You will need to install Atmel's DFU drivers prior to using this bootloader.
- *
- * As an open-source option, this bootloader is also compatible with the Linux Atmel USB DFU Programmer
- * software, available for download at http://sourceforge.net/projects/dfu-programmer/.
- *
- * If SECURE_MODE is defined as true, upon startup the bootloader will be locked, with only the chip erase
- * function available (similar to Atmel's DFU bootloader). If SECURE_MODE is defined as false, all functions
- * are usable on startup without the prerequisite firmware erase.
- *
- * Out of the box this bootloader builds for the USB1287, and should fit into 4KB of bootloader space. If
- * you wish to enlarge this space and/or change the AVR model, you will need to edit the BOOT_START and MCU
- * values in the accompanying makefile.
- *
- * <b>NOTE:</b> This device spoofs Atmel's DFU Bootloader USB VID and PID so that the Atmel DFU bootloader
- * drivers included with FLIP will work. If you do not wish to use Atmel's ID codes, please
- * manually change them in Descriptors.c and alter your driver's INF file accordingly.
+ *
+ * \section SSec_Info USB Information:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
*
* <table>
* <tr>
@@ -49,4 +32,46 @@
* <td>Full Speed Mode</td>
* </tr>
* </table>
- */
+ *
+ * \section SSec_Description Project Description:
+ *
+ * This bootloader enumerates to the host as a DFU Class device, allowing for DFU-compatible programming
+ * software to load firmware onto the AVR.
+ *
+ * This bootloader is compatible with Atmel's FLIP application. However, it requires the use of Atmel's
+ * DFU drivers. You will need to install Atmel's DFU drivers prior to using this bootloader.
+ *
+ * As an open-source option, this bootloader is also compatible with the Linux Atmel USB DFU Programmer
+ * software, available for download at http://sourceforge.net/projects/dfu-programmer/.
+ *
+ * If SECURE_MODE is defined as true, upon startup the bootloader will be locked, with only the chip erase
+ * function available (similar to Atmel's DFU bootloader). If SECURE_MODE is defined as false, all functions
+ * are usable on startup without the prerequisite firmware erase.
+ *
+ * Out of the box this bootloader builds for the USB1287, and should fit into 4KB of bootloader space. If
+ * you wish to enlarge this space and/or change the AVR model, you will need to edit the BOOT_START and MCU
+ * values in the accompanying makefile.
+ *
+ * <b>NOTE:</b> This device spoofs Atmel's DFU Bootloader USB VID and PID so that the Atmel DFU bootloader
+ * drivers included with FLIP will work. If you do not wish to use Atmel's ID codes, please
+ * manually change them in Descriptors.c and alter your driver's INF file accordingly.
+ *
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
+ * <table>
+ * <tr>
+ * <td><b>Define Name:</b></td>
+ * <td><b>Location:</b></td>
+ * <td><b>Description:</b></td>
+ * </tr>
+ * <tr>
+ * <td>SECURE_MODE</td>
+ * <td>BootloaderDFU.h</td>
+ * <td>If defined to true, the bootloader will not accept any memory commands other than a chip erase on statup, until an
+ * erase has been perfomed. This can be used in conjunction with the AVR's lockbits to prevent the AVRs firmware from
+ * being dumped by unauthorized persons.</td>
+ * </tr>
+ * </table>
+ */
\ No newline at end of file
diff --git a/Bootloaders/TeensyHID/TeensyHID.h b/Bootloaders/TeensyHID/TeensyHID.h
index a4773f8f5..ae180f778 100644
--- a/Bootloaders/TeensyHID/TeensyHID.h
+++ b/Bootloaders/TeensyHID/TeensyHID.h
@@ -57,9 +57,9 @@
/* Macros: */
/** HID Class specific request to send the next HID report to the device. */
- #define REQ_SetReport 0x09
+ #define REQ_SetReport 0x09
- #define TEENSY_STARTAPPLICATION 0xFFFF
+ #define TEENSY_STARTAPPLICATION 0xFFFF
/* Event Handlers: */
/** Indicates that this module will catch the USB_Disconnect event when thrown by the library. */
diff --git a/Bootloaders/TeensyHID/TeensyHID.txt b/Bootloaders/TeensyHID/TeensyHID.txt
index 973819cf8..1d83510d8 100644
--- a/Bootloaders/TeensyHID/TeensyHID.txt
+++ b/Bootloaders/TeensyHID/TeensyHID.txt
@@ -5,15 +5,11 @@
*/
/** \mainpage Teensy HID Class USB AVR Bootloader
- *
- * This bootloader enumerates to the host as a HID Class device, allowing for Teensy compatible programming
- * software to load firmware onto the AVR, such as the official software at http://www.pjrc.com/teensy/.
- *
- * Out of the box this bootloader builds for the USB162, and will fit into 2KB of bootloader space.
*
- * This spoofs (with permission) the offical Teensy bootloader's VID and PID, so that the software remains
- * compatible with no changes.
- *
+ * \section SSec_Info USB Information:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
+ *
* <table>
* <tr>
* <td><b>USB Mode:</b></td>
@@ -38,4 +34,26 @@
* <td>Full Speed Mode</td>
* </tr>
* </table>
- */
+ *
+ * \section SSec_Description Project Description:
+ *
+ * This bootloader enumerates to the host as a HID Class device, allowing for Teensy compatible programming
+ * software to load firmware onto the AVR, such as the official software at http://www.pjrc.com/teensy/.
+ *
+ * Out of the box this bootloader builds for the USB162, and will fit into 2KB of bootloader space.
+ *
+ * This spoofs (with permission) the offical Teensy bootloader's VID and PID, so that the software remains
+ * compatible with no changes.
+ *
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
+ * <table>
+ * <tr>
+ * <td>
+ * None
+ * </td>
+ * </tr>
+ * </table>
+ */
\ No newline at end of file
diff --git a/Demos/AudioInput/AudioInput.c b/Demos/AudioInput/AudioInput.c
index 6ead7a015..f41306f3b 100644
--- a/Demos/AudioInput/AudioInput.c
+++ b/Demos/AudioInput/AudioInput.c
@@ -33,10 +33,6 @@
* Main source file for the Audio Input demo. This file contains the main tasks of the demo and
* is responsible for the initial application hardware configuration.
*/
-
-/* --- Project Configuration --- */
-//#define MICROPHONE_BIASED_TO_HALF_RAIL
-/* --- --- --- --- --- --- --- --- */
#include "AudioInput.h"
diff --git a/Demos/AudioInput/AudioInput.txt b/Demos/AudioInput/AudioInput.txt
index 09b77f7ec..36e71e975 100644
--- a/Demos/AudioInput/AudioInput.txt
+++ b/Demos/AudioInput/AudioInput.txt
@@ -5,21 +5,10 @@
*/
/** \mainpage Audio Input Device Demo
- *
- * Audio demonstration application. This gives a simple reference
- * application for implementing a USB Audio Input device using the
- * basic USB Audio drivers in all modern OSes (i.e. no special drivers
- * required).
- *
- * On startup the system will automatically enumerate and function
- * as a USB microphone. Incomming audio from the ADC channel 1 will
- * be sampled and sent to the host computer.
- *
- * To use, connect a microphone to the ADC channel 2.
- *
- * Under Windows, if a driver request dialogue pops up, select the option
- * to automatically install the appropriate drivers.
- *
+ *
+ * \section SSec_Info USB Information:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
*
* <table>
* <tr>
@@ -45,4 +34,37 @@
* <td>Full Speed Mode</td>
* </tr>
* </table>
+ *
+ * \section SSec_Description Project Description:
+ *
+ * Audio demonstration application. This gives a simple reference
+ * application for implementing a USB Audio Input device using the
+ * basic USB Audio drivers in all modern OSes (i.e. no special drivers
+ * required).
+ *
+ * On startup the system will automatically enumerate and function
+ * as a USB microphone. Incomming audio from the ADC channel 1 will
+ * be sampled and sent to the host computer.
+ *
+ * To use, connect a microphone to the ADC channel 2.
+ *
+ * Under Windows, if a driver request dialogue pops up, select the option
+ * to automatically install the appropriate drivers.
+ *
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
+ * <table>
+ * <tr>
+ * <td><b>Define Name:</b></td>
+ * <td><b>Location:</b></td>
+ * <td><b>Description:</b></td>
+ * </tr>
+ * <tr>
+ * <td>MICROPHONE_BIASED_TO_HALF_RAIL</td>
+ * <td>Makefile CDEFS</td>
+ * <td>When defined, this alters the demo so that the half VCC bias of the microphone input is subtracted.</td>
+ * </tr>
+ * </table>
*/
\ No newline at end of file
diff --git a/Demos/AudioOutput/AudioOutput.c b/Demos/AudioOutput/AudioOutput.c
index 87afd3606..0f390f001 100644
--- a/Demos/AudioOutput/AudioOutput.c
+++ b/Demos/AudioOutput/AudioOutput.c
@@ -34,13 +34,6 @@
* is responsible for the initial application hardware configuration.
*/
-/* --- Project Configuration (Choose ONE) --- */
-//#define AUDIO_OUT_MONO
-#define AUDIO_OUT_STEREO
-//#define AUDIO_OUT_LEDS
-//#define AUDIO_OUT_PORTC
-/* --- --- --- --- --- --- --- --- --- --- --- */
-
#include "AudioOutput.h"
/* Project Tags, for reading out using the ButtLoad project */
diff --git a/Demos/AudioOutput/AudioOutput.txt b/Demos/AudioOutput/AudioOutput.txt
index ce7d4ed94..0638c47f9 100644
--- a/Demos/AudioOutput/AudioOutput.txt
+++ b/Demos/AudioOutput/AudioOutput.txt
@@ -5,7 +5,38 @@
*/
/** \mainpage Audio Output Device Demo
- *
+ *
+ * \section SSec_Info USB Information:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
+ *
+ * <table>
+ * <tr>
+ * <td><b>USB Mode:</b></td>
+ * <td>Device</td>
+ * </tr>
+ * <tr>
+ * <td><b>USB Class:</b></td>
+ * <td>Audio Class</td>
+ * </tr>
+ * <tr>
+ * <td><b>USB Subclass:</b></td>
+ * <td>Standard Audio Device</td>
+ * </tr>
+ * <tr>
+ * <td><b>Relevant Standards:</b></td>
+ * <td>USBIF Audio Class Specification</td>
+ * <td>USBIF Audio Class Terminal Types Specification</td>
+ * <td>USBIF Audio Data Formats Specification</td>
+ * </tr>
+ * <tr>
+ * <td><b>Usable Speeds:</b></td>
+ * <td>Full Speed Mode</td>
+ * </tr>
+ * </table>
+ *
+ * \section SSec_Description Project Description:
+ *
* Audio demonstration application. This gives a simple reference
* application for implementing a USB Audio Output device using the
* basic USB Audio drivers in all modern OSes (i.e. no special drivers
@@ -21,30 +52,37 @@
*
* Under Windows, if a driver request dialogue pops up, select the option
* to automatically install the appropriate drivers.
- *
+ *
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
*
* <table>
* <tr>
- * <td><b>USB Mode:</b></td>
- * <td>Device</td>
+ * <td><b>Define Name:</b></td>
+ * <td><b>Location:</b></td>
+ * <td><b>Description:</b></td>
* </tr>
* <tr>
- * <td><b>USB Class:</b></td>
- * <td>Audio Class</td>
+ * <td>AUDIO_OUT_STEREO</td>
+ * <td>Makefile CDEFS</td>
+ * <td>When defined, this outputs the audio samples in stereo to the timer output pins of the microcontroller.</td>
* </tr>
- * <tr>
- * <td><b>USB Subclass:</b></td>
- * <td>Standard Audio Device</td>
+ * <tr>
+ * <td>AUDIO_OUT_MONO</td>
+ * <td>Makefile CDEFS</td>
+ * <td>When defined, this outputs the audio samples in mono to the timer output pin of the microcontroller.</td>
* </tr>
* <tr>
- * <td><b>Relevant Standards:</b></td>
- * <td>USBIF Audio Class Specification</td>
- * <td>USBIF Audio Class Terminal Types Specification</td>
- * <td>USBIF Audio Data Formats Specification</td>
+ * <td>AUDIO_OUT_LEDS</td>
+ * <td>Makefile CDEFS</td>
+ * <td>When defined, this outputs the audio samples in stereo to the board LEDs.</td>
* </tr>
* <tr>
- * <td><b>Usable Speeds:</b></td>
- * <td>Full Speed Mode</td>
+ * <td>AUDIO_OUT_PORTC</td>
+ * <td>Makefile CDEFS</td>
+ * <td>When defined, this outputs the audio samples in mono to port C of the microcontroller, for connection to an
+ * external DAC.</td>
* </tr>
* </table>
*/
\ No newline at end of file
diff --git a/Demos/AudioOutput/makefile b/Demos/AudioOutput/makefile
index 3584d55f9..af99358f5 100644
--- a/Demos/AudioOutput/makefile
+++ b/Demos/AudioOutput/makefile
@@ -176,7 +176,7 @@ CSTANDARD = -std=gnu99
CDEFS = -DF_CPU=$(F_CPU)UL -DF_CLOCK=$(F_CLOCK)UL -DBOARD=BOARD_$(BOARD)
CDEFS += -DUSE_NONSTANDARD_DESCRIPTOR_NAMES -DNO_STREAM_CALLBACKS -DUSB_DEVICE_ONLY
CDEFS += -DUSE_STATIC_OPTIONS="(USB_DEVICE_OPT_FULLSPEED | USB_OPT_REG_ENABLED | USB_OPT_AUTO_PLL)"
-
+CDEFS += -DAUDIO_OUT_STEREO
# Place -D or -U options here for ASM sources
ADEFS = -DF_CPU=$(F_CPU)
diff --git a/Demos/CDC/CDC.txt b/Demos/CDC/CDC.txt
index 34e1c82a1..8e13b55b4 100644
--- a/Demos/CDC/CDC.txt
+++ b/Demos/CDC/CDC.txt
@@ -6,19 +6,9 @@
/** \mainpage Communications Device Class Device (Virtual Serial Port)
*
- * Communications Device Class demonstration application.
- * This gives a simple reference application for implementing
- * a CDC device acting as a virtual serial port. Joystick
- * actions are transmitted to the host as strings. The device
- * does not respond to serial data sent from the host.
- *
- * After running this demo 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.
+ * \section SSec_Info USB Information:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
*
* <table>
* <tr>
@@ -42,4 +32,32 @@
* <td>Full Speed Mode</td>
* </tr>
* </table>
+ *
+ * \section SSec_Description Project Description:
+ *
+ * Communications Device Class demonstration application.
+ * This gives a simple reference application for implementing
+ * a CDC device acting as a virtual serial port. Joystick
+ * actions are transmitted to the host as strings. The device
+ * does not respond to serial data sent from the host.
+ *
+ * After running this demo 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.
+ *
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
+ * <table>
+ * <tr>
+ * <td>
+ * None
+ * </td>
+ * </tr>
+ * </table>
*/
\ No newline at end of file
diff --git a/Demos/CDCHost/CDCHost.txt b/Demos/CDCHost/CDCHost.txt
index 5f8dc8cc0..39e2357ba 100644
--- a/Demos/CDCHost/CDCHost.txt
+++ b/Demos/CDCHost/CDCHost.txt
@@ -5,17 +5,10 @@
*/
/** \mainpage CDC Host Demo
- *
- * CDC host demonstration application. This gives a simple reference application
- * for implementing a USB CDC host, for CDC devices using the standard ACM profile.
- *
- * This demo prints out received CDC data through the serial port.
- *
- * Not that this demo is only compatible with devices which report the correct CDC
- * and ACM class, subclass and protocol values. Most USB-Serial cables have vendor
- * specific features, thus use vendor-specfic class/subclass/protocol codes to force
- * the user to use specialized drivers. This demo is not compaible with such devices.
- *
+ *
+ * \section SSec_Info USB Information:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
*
* <table>
* <tr>
@@ -39,4 +32,28 @@
* <td>Full Speed Mode</td>
* </tr>
* </table>
+ *
+ * \section SSec_Description Project Description:
+ *
+ * CDC host demonstration application. This gives a simple reference application
+ * for implementing a USB CDC host, for CDC devices using the standard ACM profile.
+ *
+ * This demo prints out received CDC data through the serial port.
+ *
+ * Not that this demo is only compatible with devices which report the correct CDC
+ * and ACM class, subclass and protocol values. Most USB-Serial cables have vendor
+ * specific features, thus use vendor-specfic class/subclass/protocol codes to force
+ * the user to use specialized drivers. This demo is not compaible with such devices.
+ *
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
+ * <table>
+ * <tr>
+ * <td>
+ * None
+ * </td>
+ * </tr>
+ * </table>
*/
\ No newline at end of file
diff --git a/Demos/DualCDC/DualCDC.txt b/Demos/DualCDC/DualCDC.txt
index aebbec353..6e086029b 100644
--- a/Demos/DualCDC/DualCDC.txt
+++ b/Demos/DualCDC/DualCDC.txt
@@ -5,6 +5,38 @@
*/
/** \mainpage Dual Communications Device Class Device (Dual Virtual Serial Port)
+ *
+ * \section SSec_Info USB Information:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
+ *
+ * <table>
+ * <tr>
+ * <td><b>USB Mode:</b></td>
+ * <td>Device</td>
+ * </tr>
+ * <tr>
+ * <td><b>USB Class:</b></td>
+ * <td>Miscellaneous Device Class</td>
+ * <td>( Sub-Interface: Communications Device Class (CDC) )</td>
+ * </tr>
+ * <tr>
+ * <td><b>USB Subclass:</b></td>
+ * <td>Common Class</td>
+ * <td>( Sub-Interface: Abstract Control Model (ACM) )</td>
+ * </tr>
+ * <tr>
+ * <td><b>Relevant Standards:</b></td>
+ * <td>USBIF Interface Association Descriptor ECN</td>
+ * <td>USBIF CDC Class Standard</td>
+ * </tr>
+ * <tr>
+ * <td><b>Usable Speeds:</b></td>
+ * <td>Full Speed Mode</td>
+ * </tr>
+ * </table>
+ *
+ * \section SSec_Description Project Description:
*
* Dual Communications Device Class demonstration application.
* This gives a simple reference application for implementing
@@ -29,29 +61,15 @@
* Operating Systems should automatically use their own inbuilt
* CDC-ACM drivers.
*
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
* <table>
* <tr>
- * <td><b>USB Mode:</b></td>
- * <td>Device</td>
- * </tr>
- * <tr>
- * <td><b>USB Class:</b></td>
- * <td>Miscellaneous Device Class</td>
- * <td>( Sub-Interface: Communications Device Class (CDC) )</td>
- * </tr>
- * <tr>
- * <td><b>USB Subclass:</b></td>
- * <td>Common Class</td>
- * <td>( Sub-Interface: Abstract Control Model (ACM) )</td>
- * </tr>
- * <tr>
- * <td><b>Relevant Standards:</b></td>
- * <td>USBIF Interface Association Descriptor ECN</td>
- * <td>USBIF CDC Class Standard</td>
- * </tr>
- * <tr>
- * <td><b>Usable Speeds:</b></td>
- * <td>Full Speed Mode</td>
+ * <td>
+ * None
+ * </td>
* </tr>
* </table>
*/
\ No newline at end of file
diff --git a/Demos/Joystick/Joystick.txt b/Demos/Joystick/Joystick.txt
index 6229aa042..7d47ae92f 100644
--- a/Demos/Joystick/Joystick.txt
+++ b/Demos/Joystick/Joystick.txt
@@ -6,18 +6,9 @@
/** \mainpage Joystick Device Demo
*
- * Joystick demonstration application. This gives a simple reference
- * application for implementing a USB Keyboard device, for USB Joysticks
- * using the standard Keyboard HID profile.
- *
- * This device will show up as a generic joystick device, with two buttons.
- * Pressing the joystick inwards is the first button, and the HWB button
- * is the second.
- *
- * Moving the joystick on the selected board moves the joystick location on
- * the host computer.
- *
- * Currently only single interface joysticks are supported.
+ * \section SSec_Info USB Information:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
*
* <table>
* <tr>
@@ -41,4 +32,31 @@
* <td>Low Speed Mode, Full Speed Mode</td>
* </tr>
* </table>
+ *
+ * \section SSec_Description Project Description:
+ *
+ * Joystick demonstration application. This gives a simple reference
+ * application for implementing a USB Keyboard device, for USB Joysticks
+ * using the standard Keyboard HID profile.
+ *
+ * This device will show up as a generic joystick device, with two buttons.
+ * Pressing the joystick inwards is the first button, and the HWB button
+ * is the second.
+ *
+ * Moving the joystick on the selected board moves the joystick location on
+ * the host computer.
+ *
+ * Currently only single interface joysticks are supported.
+ *
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
+ * <table>
+ * <tr>
+ * <td>
+ * None
+ * </td>
+ * </tr>
+ * </table>
*/
\ No newline at end of file
diff --git a/Demos/Keyboard/Keyboard.c b/Demos/Keyboard/Keyboard.c
index 3884eeb16..f506070c0 100644
--- a/Demos/Keyboard/Keyboard.c
+++ b/Demos/Keyboard/Keyboard.c
@@ -140,6 +140,15 @@ EVENT_HANDLER(USB_Reset)
*/
EVENT_HANDLER(USB_Disconnect)
{
+ /* Stop running keyboard reporting and USB management tasks */
+ #if !defined(INTERRUPT_DATA_ENDPOINT)
+ Scheduler_SetTaskMode(USB_Keyboard_Report, TASK_STOP);
+ #endif
+
+ #if !defined(INTERRUPT_CONTROL_ENDPOINT)
+ Scheduler_SetTaskMode(USB_USBTask, TASK_STOP);
+ #endif
+
/* Indicate USB not ready */
UpdateStatus(Status_USBNotReady);
}
@@ -171,6 +180,11 @@ EVENT_HANDLER(USB_ConfigurationChanged)
/* Indicate USB connected and ready */
UpdateStatus(Status_USBReady);
+
+ #if !defined(INTERRUPT_DATA_ENDPOINT)
+ /* Start running keyboard reporting task */
+ Scheduler_SetTaskMode(USB_Keyboard_Report, TASK_RUN);
+ #endif
}
/** Event handler for the USB_UnhandledControlPacket event. This is used to catch standard and class specific
diff --git a/Demos/Keyboard/Keyboard.txt b/Demos/Keyboard/Keyboard.txt
index 7939035a0..a09d83507 100644
--- a/Demos/Keyboard/Keyboard.txt
+++ b/Demos/Keyboard/Keyboard.txt
@@ -34,6 +34,7 @@
* </table>
*
* \section SSec_Description Project Description:
+ *
* Keyboard demonstration application. This gives a simple reference application
* for implementing a USB Keyboard using the basic USB HID drivers in all modern
* OSes (i.e. no special drivers required). It is boot protocol compatible, and thus
diff --git a/Demos/KeyboardHost/KeyboardHost.txt b/Demos/KeyboardHost/KeyboardHost.txt
index 92e380789..db0e14ad6 100644
--- a/Demos/KeyboardHost/KeyboardHost.txt
+++ b/Demos/KeyboardHost/KeyboardHost.txt
@@ -5,21 +5,10 @@
*/
/** \mainpage Keyboard Host Demo
- *
- * Keyboard host demonstration application. This gives a simple reference
- * application for implementing a USB Mouse keyboard, for USB keyboards using
- * the standard keyboard HID profile.
- *
- * Pressed alpha-numeric, enter or space key is transmitted through the serial
- * USART at serial settings 9600, 8, N, 1.
- *
- * This uses a naive method where the keyboard is set to Boot Protocol mode, so
- * that the report structure is fixed and known. A better implementation
- * uses the HID report parser for correct report data processing across
- * all compatable mice with advanced characteristics, as shown in the
- * KeyboardHostWithParser demo application.
- *
- * Currently only single interface keyboards are supported.
+ *
+ * \section SSec_Info USB Information:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
*
* <table>
* <tr>
@@ -43,4 +32,33 @@
* <td>Low Speed Mode, Full Speed Mode</td>
* </tr>
* </table>
+ *
+ * \section SSec_Description Project Description:
+ *
+ * Keyboard host demonstration application. This gives a simple reference
+ * application for implementing a USB Mouse keyboard, for USB keyboards using
+ * the standard keyboard HID profile.
+ *
+ * Pressed alpha-numeric, enter or space key is transmitted through the serial
+ * USART at serial settings 9600, 8, N, 1.
+ *
+ * This uses a naive method where the keyboard is set to Boot Protocol mode, so
+ * that the report structure is fixed and known. A better implementation
+ * uses the HID report parser for correct report data processing across
+ * all compatable mice with advanced characteristics, as shown in the
+ * KeyboardHostWithParser demo application.
+ *
+ * Currently only single interface keyboards are supported.
+ *
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
+ * <table>
+ * <tr>
+ * <td>
+ * None
+ * </td>
+ * </tr>
+ * </table>
*/
\ No newline at end of file
diff --git a/Demos/KeyboardHostViaInt/KeyboardHostViaInt.h b/Demos/KeyboardHostViaInt/KeyboardHostViaInt.h
index 7ae54e6ad..06cd02a9f 100644
--- a/Demos/KeyboardHostViaInt/KeyboardHostViaInt.h
+++ b/Demos/KeyboardHostViaInt/KeyboardHostViaInt.h
@@ -59,7 +59,7 @@
#define KEYBOARD_DATAPIPE 1
/** HID Class Specific request to set the report protocol mode */
- #define REQ_SetProtocol 0x0B
+ #define REQ_SetProtocol 0x0B
/* Type Defines: */
/** Type define for a standard Boot Protocol Keyboard report */
diff --git a/Demos/KeyboardHostViaInt/KeyboardHostViaInt.txt b/Demos/KeyboardHostViaInt/KeyboardHostViaInt.txt
index 07c110848..de61d32fe 100644
--- a/Demos/KeyboardHostViaInt/KeyboardHostViaInt.txt
+++ b/Demos/KeyboardHostViaInt/KeyboardHostViaInt.txt
@@ -4,23 +4,11 @@
* documentation pages. It is not a project source file.
*/
-/** \mainpage Keyboard Host Demo
- *
- * Keyboard host demonstration application, using pipe interrupts. This gives
- * a simple reference application for implementing a USB Keyboard host utilizing
- * the LUFA pipe interrupt system, for USB keyboards using the standard Keyboard
- * HID profile.
- *
- * Pressed alpha-numeric, enter or space key is transmitted through the serial
- * USART at serial settings 9600, 8, N, 1.
- *
- * This uses a naive method where the keyboard is set to Boot Protocol mode, so
- * that the report structure is fixed and known. A better implementation
- * uses the HID report parser for correct report data processing across
- * all compatable mice with advanced characteristics, as shown in the
- * KeyboardHostWithParser demo application.
- *
- * Currently only single interface keyboards are supported.
+/** \mainpage Keyboard Host Demo (via interrupts)
+ *
+ * \section SSec_Info USB Information:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
*
* <table>
* <tr>
@@ -44,4 +32,34 @@
* <td>Low Speed Mode, Full Speed Mode</td>
* </tr>
* </table>
+ *
+ * \section SSec_Description Project Description:
+ *
+ * Keyboard host demonstration application, using pipe interrupts. This gives
+ * a simple reference application for implementing a USB Keyboard host utilizing
+ * the LUFA pipe interrupt system, for USB keyboards using the standard Keyboard
+ * HID profile.
+ *
+ * Pressed alpha-numeric, enter or space key is transmitted through the serial
+ * USART at serial settings 9600, 8, N, 1.
+ *
+ * This uses a naive method where the keyboard is set to Boot Protocol mode, so
+ * that the report structure is fixed and known. A better implementation
+ * uses the HID report parser for correct report data processing across
+ * all compatable mice with advanced characteristics, as shown in the
+ * KeyboardHostWithParser demo application.
+ *
+ * Currently only single interface keyboards are supported.
+ *
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
+ * <table>
+ * <tr>
+ * <td>
+ * None
+ * </td>
+ * </tr>
+ * </table>
*/
\ No newline at end of file
diff --git a/Demos/KeyboardHostWithParser/KeyboardHostWithParser.txt b/Demos/KeyboardHostWithParser/KeyboardHostWithParser.txt
index 09a83ca57..cd3670673 100644
--- a/Demos/KeyboardHostWithParser/KeyboardHostWithParser.txt
+++ b/Demos/KeyboardHostWithParser/KeyboardHostWithParser.txt
@@ -5,19 +5,10 @@
*/
/** \mainpage Keyboard Host With HID Descriptor Parser Demo
- *
- * Keyboard host demonstration application. This gives a simple reference
- * application for implementing a USB Keyboard host, for USB keyboards using
- * the standard Keyboard HID profile. It uses a HID parser for the HID reports,
- * allowing for correct operation across all USB keyboards. This demo supports
- * keyboards with a single HID report.
- *
- * Pressed alpha-numeric, enter or space key is transmitted through the serial
- * USART at serial settings 9600, 8, N, 1. On connection to a USB keyboard, the
- * report items will be processed and printed as a formatted list through the
- * USART before the keyboard is fully enumerated.
- *
- * Currently only single interface keyboards are supported.
+ *
+ * \section SSec_Info USB Information:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
*
* <table>
* <tr>
@@ -41,4 +32,31 @@
* <td>Low Speed Mode, Full Speed Mode</td>
* </tr>
* </table>
+ *
+ * \section SSec_Description Project Description:
+ *
+ * Keyboard host demonstration application. This gives a simple reference
+ * application for implementing a USB Keyboard host, for USB keyboards using
+ * the standard Keyboard HID profile. It uses a HID parser for the HID reports,
+ * allowing for correct operation across all USB keyboards. This demo supports
+ * keyboards with a single HID report.
+ *
+ * Pressed alpha-numeric, enter or space key is transmitted through the serial
+ * USART at serial settings 9600, 8, N, 1. On connection to a USB keyboard, the
+ * report items will be processed and printed as a formatted list through the
+ * USART before the keyboard is fully enumerated.
+ *
+ * Currently only single interface keyboards are supported.
+ *
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
+ * <table>
+ * <tr>
+ * <td>
+ * None
+ * </td>
+ * </tr>
+ * </table>
*/
\ No newline at end of file
diff --git a/Demos/KeyboardMouse/KeyboardMouse.txt b/Demos/KeyboardMouse/KeyboardMouse.txt
index 969e2871b..6388e9803 100644
--- a/Demos/KeyboardMouse/KeyboardMouse.txt
+++ b/Demos/KeyboardMouse/KeyboardMouse.txt
@@ -6,22 +6,9 @@
/** \mainpage Dual HID Keyboard and Mouse Device Demo
*
- * Keyboard/Mouse demonstration application. This gives a simple reference
- * application for implementing a composite device containing both USB Keyboard
- * and USB Mouse functionality using the basic USB HID drivers in all modern OSes
- * (i.e. no special drivers required). This example uses two seperate HID
- * interfaces for each function. It is boot protocol compatible, and thus works under
- * compatible BIOS as if it was a native keyboard and mouse (e.g. PS/2).
- *
- * On startup the system will automatically enumerate and function
- * as a keyboard when the USB connection to a host is present and the HWB is not
- * pressed. When enabled, manipulate the joystick to send the letters
- * a, b, c, d and e. See the USB HID documentation for more information
- * on sending keyboard event and keypresses.
- *
- * When the HWB is pressed, the mouse mode is enabled. When enabled, move the
- * joystick to move the pointer, and push the joystick inwards to simulate a
- * left-button click.
+ * \section SSec_Info USB Information:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
*
* <table>
* <tr>
@@ -45,4 +32,35 @@
* <td>Low Speed Mode, Full Speed Mode</td>
* </tr>
* </table>
+ *
+ * \section SSec_Description Project Description:
+ *
+ * Keyboard/Mouse demonstration application. This gives a simple reference
+ * application for implementing a composite device containing both USB Keyboard
+ * and USB Mouse functionality using the basic USB HID drivers in all modern OSes
+ * (i.e. no special drivers required). This example uses two seperate HID
+ * interfaces for each function. It is boot protocol compatible, and thus works under
+ * compatible BIOS as if it was a native keyboard and mouse (e.g. PS/2).
+ *
+ * On startup the system will automatically enumerate and function
+ * as a keyboard when the USB connection to a host is present and the HWB is not
+ * pressed. When enabled, manipulate the joystick to send the letters
+ * a, b, c, d and e. See the USB HID documentation for more information
+ * on sending keyboard event and keypresses.
+ *
+ * When the HWB is pressed, the mouse mode is enabled. When enabled, move the
+ * joystick to move the pointer, and push the joystick inwards to simulate a
+ * left-button click.
+ *
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
+ * <table>
+ * <tr>
+ * <td>
+ * None
+ * </td>
+ * </tr>
+ * </table>
*/
\ No newline at end of file
diff --git a/Demos/MIDI/MIDI.txt b/Demos/MIDI/MIDI.txt
index 0b34ccb66..3eb60cdc6 100644
--- a/Demos/MIDI/MIDI.txt
+++ b/Demos/MIDI/MIDI.txt
@@ -5,21 +5,10 @@
*/
/** \mainpage MIDI Input Device Demo
- *
- * MIDI demonstration application. This gives a simple reference
- * application for implementing the USB-MIDI class in USB devices.
- * It is built upon the USB Audio class.
- *
- * Joystick movements are translated into note on/off messages and
- * are sent to the host PC as MIDI streams which can be read by any
- * MIDI program supporting MIDI IN devices.
- *
- * If the HWB is not pressed, channel 1 (default piano) is used. If
- * the HWB is set, then channel 10 (default percussion) is selected.
- *
- * This device implements MIDI-THRU mode, with the IN MIDI data being
- * generated by the device itself. OUT MIDI data is discarded.
- *
+ *
+ * \section SSec_Info USB Information:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
*
* <table>
* <tr>
@@ -45,4 +34,32 @@
* <td>Full Speed Mode</td>
* </tr>
* </table>
+ *
+ * \section SSec_Description Project Description:
+ *
+ * MIDI demonstration application. This gives a simple reference
+ * application for implementing the USB-MIDI class in USB devices.
+ * It is built upon the USB Audio class.
+ *
+ * Joystick movements are translated into note on/off messages and
+ * are sent to the host PC as MIDI streams which can be read by any
+ * MIDI program supporting MIDI IN devices.
+ *
+ * If the HWB is not pressed, channel 1 (default piano) is used. If
+ * the HWB is set, then channel 10 (default percussion) is selected.
+ *
+ * This device implements MIDI-THRU mode, with the IN MIDI data being
+ * generated by the device itself. OUT MIDI data is discarded.
+ *
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
+ * <table>
+ * <tr>
+ * <td>
+ * None
+ * </td>
+ * </tr>
+ * </table>
*/
\ No newline at end of file
diff --git a/Demos/MassStorage/MassStorage.h b/Demos/MassStorage/MassStorage.h
index 3525340ff..a30e7f746 100644
--- a/Demos/MassStorage/MassStorage.h
+++ b/Demos/MassStorage/MassStorage.h
@@ -62,8 +62,9 @@
/** Maximum length of a SCSI command which can be issued by the device or host in a Mass Storage bulk wrapper. */
#define MAX_SCSI_COMMAND_LENGTH 16
- /** Total number of Logical Units (drives) in the device. By default, the total device capacity is shared equally between
- * each drive - this can be set to any positive non-zero amount. */
+ /** Total number of Logical Units (drives) in the device. The total device capacity is shared equally between
+ * each drive - this can be set to any positive non-zero amount.
+ */
#define TOTAL_LUNS 2
/** Blocks in each LUN, calculated from the total capacity divided by the total number of Logical Units in the device. */
diff --git a/Demos/MassStorage/MassStorage.txt b/Demos/MassStorage/MassStorage.txt
index 428faa8e0..4e8adadbc 100644
--- a/Demos/MassStorage/MassStorage.txt
+++ b/Demos/MassStorage/MassStorage.txt
@@ -6,25 +6,9 @@
/** \mainpage Mass Storage Device Demo
*
- * Dual LUN Mass Storage demonstration application. This gives a simple
- * reference application for implementing a multiple LUN USB Mass Storage
- * device using the basic USB UFI drivers in all modern OSes (i.e. no
- * special drivers required).
- *
- * On startup the system will automatically enumerate and function as an
- * external mass storage device with two LUNs (seperate disks) which may
- * be formatted and used in the same manner as commercial USB Mass Storage
- * devices.
- *
- * You will need to format the mass storage drives upon first run of this
- * demonstration - as the device acts only as a data block transport between
- * the host and the storage media, it does not matter what file system is used,
- * as the data interpretation is performed by the host and not the USB device.
- *
- * This demo is not restricted to only two LUNs; by changing the TOTAL_LUNS
- * value in MassStorageDualLUN.h, any number of LUNs can be used (from 1 to
- * 255), with each LUN being allocated an equal portion of the available
- * Dataflash memory.
+ * \section SSec_Info USB Information:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
*
* <table>
* <tr>
@@ -51,4 +35,44 @@
* <td>Full Speed Mode</td>
* </tr>
* </table>
+ *
+ * \section SSec_Description Project Description:
+ *
+ * Dual LUN Mass Storage demonstration application. This gives a simple
+ * reference application for implementing a multiple LUN USB Mass Storage
+ * device using the basic USB UFI drivers in all modern OSes (i.e. no
+ * special drivers required).
+ *
+ * On startup the system will automatically enumerate and function as an
+ * external mass storage device with two LUNs (seperate disks) which may
+ * be formatted and used in the same manner as commercial USB Mass Storage
+ * devices.
+ *
+ * You will need to format the mass storage drives upon first run of this
+ * demonstration - as the device acts only as a data block transport between
+ * the host and the storage media, it does not matter what file system is used,
+ * as the data interpretation is performed by the host and not the USB device.
+ *
+ * This demo is not restricted to only two LUNs; by changing the TOTAL_LUNS
+ * value in MassStorageDualLUN.h, any number of LUNs can be used (from 1 to
+ * 255), with each LUN being allocated an equal portion of the available
+ * Dataflash memory.
+ *
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
+ * <table>
+ * <tr>
+ * <td><b>Define Name:</b></td>
+ * <td><b>Location:</b></td>
+ * <td><b>Description:</b></td>
+ * </tr>
+ * <tr>
+ * <td>TOTAL_LUNS</td>
+ * <td>MassStorage.h</td>
+ * <td>Total number of Logical Units (drives) in the device. The total device capacity is shared equally between each drive
+ * - this can be set to any positive non-zero amount.</td>
+ * </tr>
+ * </table>
*/
\ No newline at end of file
diff --git a/Demos/MassStorageHost/MassStorageHost.txt b/Demos/MassStorageHost/MassStorageHost.txt
index 2defd7fe8..88b42e937 100644
--- a/Demos/MassStorageHost/MassStorageHost.txt
+++ b/Demos/MassStorageHost/MassStorageHost.txt
@@ -5,15 +5,10 @@
*/
/** \mainpage Mass Storage Host Demo
- *
- * Mass Storage host demonstration application. This gives a simple reference
- * application for implementing a USB Mass Storage host, for USB storage devices
- * using the standard Mass Storage USB profile.
- *
- * The first 512 bytes (boot sector) of an attached disk's memory will be dumped
- * out of the serial port in HEX and ASCII form when it is attached to the AT90USB1287
- * AVR. The device will then wait for HWB to be pressed, whereupon the entire ASCII contents
- * of the disk will be dumped to the serial port.
+ *
+ * \section SSec_Info USB Information:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
*
* <table>
* <tr>
@@ -40,4 +35,27 @@
* <td>Full Speed Mode</td>
* </tr>
* </table>
+ *
+ * \section SSec_Description Project Description:
+ *
+ * Mass Storage host demonstration application. This gives a simple reference
+ * application for implementing a USB Mass Storage host, for USB storage devices
+ * using the standard Mass Storage USB profile.
+ *
+ * The first 512 bytes (boot sector) of an attached disk's memory will be dumped
+ * out of the serial port in HEX and ASCII form when it is attached to the AT90USB1287
+ * AVR. The device will then wait for HWB to be pressed, whereupon the entire ASCII contents
+ * of the disk will be dumped to the serial port.
+ *
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
+ * <table>
+ * <tr>
+ * <td>
+ * None
+ * </td>
+ * </tr>
+ * </table>
*/
\ No newline at end of file
diff --git a/Demos/Mouse/Mouse.c b/Demos/Mouse/Mouse.c
index f8ec0a0f5..b61850abe 100644
--- a/Demos/Mouse/Mouse.c
+++ b/Demos/Mouse/Mouse.c
@@ -45,8 +45,13 @@ BUTTLOADTAG(LUFAVersion, "LUFA V" LUFA_VERSION_STRING);
/* Scheduler Task List */
TASK_LIST
{
+ #if !defined(INTERRUPT_CONTROL_ENDPOINT)
{ Task: USB_USBTask , TaskStatus: TASK_STOP },
+ #endif
+
+ #if !defined(INTERRUPT_DATA_ENDPOINT)
{ Task: USB_Mouse_Report , TaskStatus: TASK_STOP },
+ #endif
};
/* Global Variables */
@@ -118,14 +123,34 @@ EVENT_HANDLER(USB_Connect)
UsingReportProtocol = true;
}
+/** Event handler for the USB_Reset event. This fires when the USB interface is reset by the USB host, before the
+ * enumeration process begins, and enables the control endpoint interrupt so that control requests can be handled
+ * asynchronously when they arrive rather than when the control endpoint is polled manually.
+ */
+EVENT_HANDLER(USB_Reset)
+{
+ #if defined(INTERRUPT_CONTROL_ENDPOINT)
+ /* Select the control endpoint */
+ Endpoint_SelectEndpoint(ENDPOINT_CONTROLEP);
+
+ /* Enable the endpoint SETUP interrupt ISR for the control endpoint */
+ USB_INT_Enable(ENDPOINT_INT_SETUP);
+ #endif
+}
+
/** 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 Mouse reporting tasks.
*/
EVENT_HANDLER(USB_Disconnect)
{
- /* Stop running mouse reporting and USB management tasks */
+ /* Stop running keyboard reporting and USB management tasks */
+ #if !defined(INTERRUPT_DATA_ENDPOINT)
Scheduler_SetTaskMode(USB_Mouse_Report, TASK_STOP);
+ #endif
+
+ #if !defined(INTERRUPT_CONTROL_ENDPOINT)
Scheduler_SetTaskMode(USB_USBTask, TASK_STOP);
+ #endif
/* Indicate USB not ready */
UpdateStatus(Status_USBNotReady);
@@ -141,11 +166,18 @@ EVENT_HANDLER(USB_ConfigurationChanged)
ENDPOINT_DIR_IN, MOUSE_EPSIZE,
ENDPOINT_BANK_SINGLE);
+ #if defined(INTERRUPT_DATA_ENDPOINT)
+ /* Enable the endpoint IN interrupt ISR for the report endpoint */
+ USB_INT_Enable(ENDPOINT_INT_IN);
+ #endif
+
/* Indicate USB connected and ready */
UpdateStatus(Status_USBReady);
+ #if !defined(INTERRUPT_DATA_ENDPOINT)
/* Start running mouse reporting task */
Scheduler_SetTaskMode(USB_Mouse_Report, TASK_RUN);
+ #endif
}
/** Event handler for the USB_UnhandledControlPacket event. This is used to catch standard and class specific
@@ -163,7 +195,7 @@ EVENT_HANDLER(USB_UnhandledControlPacket)
USB_MouseReport_Data_t MouseReportData;
/* Create the next mouse report for transmission to the host */
- GetNextReport(&MouseReportData);
+ CreateMouseReport(&MouseReportData);
/* Ignore report type and ID number value */
Endpoint_Discard_Word();
@@ -278,7 +310,7 @@ ISR(TIMER0_COMPA_vect, ISR_BLOCK)
*
* \return Boolean true if the new report differs from the last report, false otherwise
*/
-bool GetNextReport(USB_MouseReport_Data_t* ReportData)
+bool CreateMouseReport(USB_MouseReport_Data_t* ReportData)
{
static uint8_t PrevJoyStatus = 0;
static bool PrevHWBStatus = false;
@@ -315,6 +347,45 @@ bool GetNextReport(USB_MouseReport_Data_t* ReportData)
return InputChanged;
}
+/** Sends the next HID report to the host, via the keyboard data endpoint. */
+static inline void SendNextReport(void)
+{
+ USB_MouseReport_Data_t MouseReportData;
+ bool SendReport = true;
+
+ /* Create the next mouse report for transmission to the host */
+ CreateMouseReport(&MouseReportData);
+
+ /* Check if the idle period is set*/
+ if (IdleCount)
+ {
+ /* Determine if the idle period has elapsed */
+ if (!(IdleMSRemaining))
+ {
+ /* Reset the idle time remaining counter, must multiply by 4 to get the duration in milliseconds */
+ IdleMSRemaining = (IdleCount << 2);
+ }
+ else
+ {
+ /* Idle period not elapsed, indicate that a report must not be sent */
+ SendReport = false;
+ }
+ }
+
+ /* Select the Mouse Report Endpoint */
+ Endpoint_SelectEndpoint(MOUSE_EPNUM);
+
+ /* Check if Mouse Endpoint Ready for Read/Write and if we should send a new report */
+ if (Endpoint_ReadWriteAllowed() && SendReport)
+ {
+ /* Write Mouse Report Data */
+ Endpoint_Write_Stream_LE(&MouseReportData, sizeof(MouseReportData));
+
+ /* Finalize the stream transfer to send the last packet */
+ 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.
*
@@ -342,45 +413,57 @@ void UpdateStatus(uint8_t CurrentStatus)
LEDs_SetAllLEDs(LEDMask);
}
+#if !defined(INTERRUPT_DATA_ENDPOINT)
/** Task to manage HID report generation and transmission to the host, when in report mode. */
TASK(USB_Mouse_Report)
{
- USB_MouseReport_Data_t MouseReportData;
- bool SendReport = true;
-
- /* Create the next mouse report for transmission to the host */
- GetNextReport(&MouseReportData);
-
- /* Check if the idle period is set*/
- if (IdleCount)
+ /* Check if the USB system is connected to a host */
+ if (USB_IsConnected)
{
- /* Determine if the idle period has elapsed */
- if (!(IdleMSRemaining))
- {
- /* Reset the idle time remaining counter, must multiply by 4 to get the duration in milliseconds */
- IdleMSRemaining = (IdleCount << 2);
- }
- else
- {
- /* Idle period not elapsed, indicate that a report must not be sent */
- SendReport = false;
- }
+ /* Send the next mouse report to the host */
+ SendNextReport();
}
+}
+#endif
+
+/** ISR for the general Pipe/Endpoint interrupt vector. This ISR fires when an endpoint's status changes (such as
+ * a packet has been received) on an endpoint with its corresponding ISR enabling bits set. This is used to send
+ * HID packets to the host each time the HID interrupt endpoints polling period elapses, as managed by the USB
+ * controller. It is also used to respond to standard and class specific requests send to the device on the control
+ * endpoint, by handing them off to the LUFA library when they are received.
+ */
+ISR(ENDPOINT_PIPE_vect, ISR_BLOCK)
+{
+ #if defined(INTERRUPT_CONTROL_ENDPOINT)
+ /* Check if the control endpoint has received a request */
+ if (Endpoint_HasEndpointInterrupted(ENDPOINT_CONTROLEP))
+ {
+ /* Clear the endpoint interrupt */
+ Endpoint_ClearEndpointInterrupt(ENDPOINT_CONTROLEP);
+
+ /* Process the control request */
+ USB_USBTask();
+
+ /* Handshake the endpoint setup interrupt - must be after the call to USB_USBTask() */
+ USB_INT_Clear(ENDPOINT_INT_SETUP);
+ }
+ #endif
- /* Check if the USB system is connected to a host */
- if (USB_IsConnected)
+ #if defined(INTERRUPT_DATA_ENDPOINT)
+ /* Check if mouse endpoint has interrupted */
+ if (Endpoint_HasEndpointInterrupted(MOUSE_EPNUM))
{
/* Select the Mouse Report Endpoint */
Endpoint_SelectEndpoint(MOUSE_EPNUM);
- /* Check if Mouse Endpoint Ready for Read/Write and if we should send a new report */
- if (Endpoint_ReadWriteAllowed() && SendReport)
- {
- /* Write Mouse Report Data */
- Endpoint_Write_Stream_LE(&MouseReportData, sizeof(MouseReportData));
-
- /* Finalize the stream transfer to send the last packet */
- Endpoint_ClearCurrentBank();
- }
+ /* Clear the endpoint IN interrupt flag */
+ USB_INT_Clear(ENDPOINT_INT_IN);
+
+ /* Clear the Mouse Report endpoint interrupt and select the endpoint */
+ Endpoint_ClearEndpointInterrupt(MOUSE_EPNUM);
+
+ /* Send the next mouse report to the host */
+ SendNextReport();
}
+ #endif
}
diff --git a/Demos/Mouse/Mouse.h b/Demos/Mouse/Mouse.h
index 50908129a..8723b7840 100644
--- a/Demos/Mouse/Mouse.h
+++ b/Demos/Mouse/Mouse.h
@@ -103,6 +103,9 @@
/** 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_Reset event when thrown by the library. */
+ HANDLES_EVENT(USB_Reset);
+
/** Indicates that this module will catch the USB_ConfigurationChanged event when thrown by the library. */
HANDLES_EVENT(USB_ConfigurationChanged);
@@ -110,7 +113,7 @@
HANDLES_EVENT(USB_UnhandledControlPacket);
/* Function Prototypes: */
- bool GetNextReport(USB_MouseReport_Data_t* ReportData);
+ bool CreateMouseReport(USB_MouseReport_Data_t* ReportData);
void UpdateStatus(uint8_t CurrentStatus);
#endif
diff --git a/Demos/Mouse/Mouse.txt b/Demos/Mouse/Mouse.txt
index 7b7360f0e..6764275ce 100644
--- a/Demos/Mouse/Mouse.txt
+++ b/Demos/Mouse/Mouse.txt
@@ -6,17 +6,9 @@
/** \mainpage Mouse Device Demo
*
- * Mouse demonstration application. This gives a simple reference
- * application for implementing a USB Mouse using the basic USB HID
- * drivers in all modern OSes (i.e. no special drivers required). It is
- * boot protocol compatible, and thus works under compatible BIOS as if
- * it was a native mouse (e.g. PS/2).
- *
- * On startup the system will automatically enumerate and function
- * as a mouse when the USB connection to a host is present. To use
- * the mouse, move the joystick to move the pointer, and push the
- * joystick inwards to simulate a left-button click. The HWB serves as
- * the right mouse button.
+ * \section SSec_Info USB Information:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
*
* <table>
* <tr>
@@ -40,4 +32,44 @@
* <td>Low Speed Mode, Full Speed Mode</td>
* </tr>
* </table>
+ *
+ * \section SSec_Description Project Description:
+ *
+ * Mouse demonstration application. This gives a simple reference
+ * application for implementing a USB Mouse using the basic USB HID
+ * drivers in all modern OSes (i.e. no special drivers required). It is
+ * boot protocol compatible, and thus works under compatible BIOS as if
+ * it was a native mouse (e.g. PS/2).
+ *
+ * On startup the system will automatically enumerate and function
+ * as a mouse when the USB connection to a host is present. To use
+ * the mouse, move the joystick to move the pointer, and push the
+ * joystick inwards to simulate a left-button click. The HWB serves as
+ * the right mouse button.
+ *
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
+ * <table>
+ * <tr>
+ * <td><b>Define Name:</b></td>
+ * <td><b>Location:</b></td>
+ * <td><b>Description:</b></td>
+ * </tr>
+ * <tr>
+ * <td>INTERRUPT_CONTROL_ENDPOINT</td>
+ * <td>Makefile CDEFS</td>
+ * <td>When defined, this causes the demo to enable interrupts for the control endpoint,
+ * which services control requests from the host. If not defined, the control endpoint
+ * is serviced via polling using the task scheduler.</td>
+ * </tr>
+ * <tr>
+ * <td>INTERRUPT_DATA_ENDPOINT</td>
+ * <td>Makefile CDEFS</td>
+ * <td>When defined, this causes the demo to enable interrupts for the data endpoint,
+ * which services outgoing mouse button and movement reports to the host. If not defined,
+ * the data endpoint is serviced via polling using the task scheduler.</td>
+ * </tr>
+ * </table>
*/
\ No newline at end of file
diff --git a/Demos/Mouse/makefile b/Demos/Mouse/makefile
index a731e205e..27ca1d809 100644
--- a/Demos/Mouse/makefile
+++ b/Demos/Mouse/makefile
@@ -177,7 +177,6 @@ CDEFS = -DF_CPU=$(F_CPU)UL -DF_CLOCK=$(F_CLOCK)UL -DBOARD=BOARD_$(BOARD)
CDEFS += -DUSE_NONSTANDARD_DESCRIPTOR_NAMES -DNO_STREAM_CALLBACKS -DUSB_DEVICE_ONLY
CDEFS += -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)
diff --git a/Demos/MouseHost/MouseHost.txt b/Demos/MouseHost/MouseHost.txt
index 11c434c69..a6d1ba828 100644
--- a/Demos/MouseHost/MouseHost.txt
+++ b/Demos/MouseHost/MouseHost.txt
@@ -5,22 +5,10 @@
*/
/** \mainpage Mouse Host Demo
- *
- * Mouse host demonstration application. This gives a simple reference
- * application for implementing a USB Mouse host, for USB mice using
- * the standard mouse HID profile.
- *
- * Mouse movement and button presses are displayed on the board LEDs,
- * as well as printed out the serial terminal as formatted dY, dY and
- * button status information.
- *
- * This uses a naive method where the mouse is set to Boot Protocol mode, so
- * that the report structure is fixed and known. A better implementation
- * uses the HID report parser for correct report data processing across
- * all compatable mice with advanced characteristics, as shown in the
- * MouseHostWithParser demo application.
- *
- * Currently only single interface mice are supported.
+ *
+ * \section SSec_Info USB Information:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
*
* <table>
* <tr>
@@ -44,4 +32,34 @@
* <td>Low Speed Mode, Full Speed Mode</td>
* </tr>
* </table>
+ *
+ * \section SSec_Description Project Description:
+ *
+ * Mouse host demonstration application. This gives a simple reference
+ * application for implementing a USB Mouse host, for USB mice using
+ * the standard mouse HID profile.
+ *
+ * Mouse movement and button presses are displayed on the board LEDs,
+ * as well as printed out the serial terminal as formatted dY, dY and
+ * button status information.
+ *
+ * This uses a naive method where the mouse is set to Boot Protocol mode, so
+ * that the report structure is fixed and known. A better implementation
+ * uses the HID report parser for correct report data processing across
+ * all compatable mice with advanced characteristics, as shown in the
+ * MouseHostWithParser demo application.
+ *
+ * Currently only single interface mice are supported.
+ *
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
+ * <table>
+ * <tr>
+ * <td>
+ * None
+ * </td>
+ * </tr>
+ * </table>
*/
\ No newline at end of file
diff --git a/Demos/MouseHostViaInt/MouseHostViaInt.txt b/Demos/MouseHostViaInt/MouseHostViaInt.txt
index 72ee1dbee..749865544 100644
--- a/Demos/MouseHostViaInt/MouseHostViaInt.txt
+++ b/Demos/MouseHostViaInt/MouseHostViaInt.txt
@@ -4,24 +4,9 @@
* documentation pages. It is not a project source file.
*/
-/** \mainpage Mouse Host Demo
- *
- * Mouse host demonstration application, using pipe interrupts. This
- * gives a simple reference application for implementing a USB Mouse
- * host utilizing the LUFA pipe interrupt system, for USB mice using
- * the standard mouse HID profile.
- *
- * Mouse movement and button presses are displayed on the board LEDs,
- * as well as printed out the serial terminal as formatted dY, dY and
- * button status information.
- *
- * This uses a naive method where the mouse is set to Boot Protocol mode, so
- * that the report structure is fixed and known. A better implementation
- * uses the HID report parser for correct report data processing across
- * all compatable mice with advanced characteristics, as shown in the
- * MouseHostWithParser demo application.
- *
- * Currently only single interface mice are supported.
+/** \mainpage Mouse Host Demo (via interrupts)
+ *
+ * \section SSec_Info USB Information:
*
* <table>
* <tr>
@@ -45,4 +30,37 @@
* <td>Low Speed Mode, Full Speed Mode</td>
* </tr>
* </table>
+ *
+ * \section SSec_Description Project Description:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
+ *
+ * Mouse host demonstration application, using pipe interrupts. This
+ * gives a simple reference application for implementing a USB Mouse
+ * host utilizing the LUFA pipe interrupt system, for USB mice using
+ * the standard mouse HID profile.
+ *
+ * Mouse movement and button presses are displayed on the board LEDs,
+ * as well as printed out the serial terminal as formatted dY, dY and
+ * button status information.
+ *
+ * This uses a naive method where the mouse is set to Boot Protocol mode, so
+ * that the report structure is fixed and known. A better implementation
+ * uses the HID report parser for correct report data processing across
+ * all compatable mice with advanced characteristics, as shown in the
+ * MouseHostWithParser demo application.
+ *
+ * Currently only single interface mice are supported.
+ *
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
+ * <table>
+ * <tr>
+ * <td>
+ * None
+ * </td>
+ * </tr>
+ * </table>
*/
\ No newline at end of file
diff --git a/Demos/MouseHostWithParser/MouseHostWithParser.txt b/Demos/MouseHostWithParser/MouseHostWithParser.txt
index 97ee8bfb8..3c83341a2 100644
--- a/Demos/MouseHostWithParser/MouseHostWithParser.txt
+++ b/Demos/MouseHostWithParser/MouseHostWithParser.txt
@@ -5,19 +5,10 @@
*/
/** \mainpage Mouse Host With HID Descriptor Parser Demo
- *
- * Mouse host demonstration application. This gives a simple reference
- * application for implementing a USB Mouse host, for USB mice using
- * the standard mouse HID profile. It uses a HID parser for the HID
- * reports, allowing for correct operation across all USB mice. This
- * demo supports mice with a single HID report.
- *
- * Mouse movement and button presses are displayed on the board LEDs.
- * On connection to a USB mouse, the report items will be processed and
- * printed as a formatted list through the USART before the mouse is
- * fully enumerated.
- *
- * Currently only single interface mice are supported.
+ *
+ * \section SSec_Info USB Information:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
*
* <table>
* <tr>
@@ -41,4 +32,31 @@
* <td>Low Speed Mode, Full Speed Mode</td>
* </tr>
* </table>
+ *
+ * \section SSec_Description Project Description:
+ *
+ * Mouse host demonstration application. This gives a simple reference
+ * application for implementing a USB Mouse host, for USB mice using
+ * the standard mouse HID profile. It uses a HID parser for the HID
+ * reports, allowing for correct operation across all USB mice. This
+ * demo supports mice with a single HID report.
+ *
+ * Mouse movement and button presses are displayed on the board LEDs.
+ * On connection to a USB mouse, the report items will be processed and
+ * printed as a formatted list through the USART before the mouse is
+ * fully enumerated.
+ *
+ * Currently only single interface mice are supported.
+ *
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
+ * <table>
+ * <tr>
+ * <td>
+ * None
+ * </td>
+ * </tr>
+ * </table>
*/
\ No newline at end of file
diff --git a/Demos/RNDISEthernet/RNDISEthernet.txt b/Demos/RNDISEthernet/RNDISEthernet.txt
index bd4ff69e8..306cf8526 100644
--- a/Demos/RNDISEthernet/RNDISEthernet.txt
+++ b/Demos/RNDISEthernet/RNDISEthernet.txt
@@ -5,7 +5,11 @@
*/
/** \mainpage RNDIS Class Ethernet Demo (with Webserver/Telnet)
- *
+ *
+ * \section SSec_Info USB Information:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
+ *
* Remote Network Driver Interface demonstration application.
* This gives a simple reference application for implementing
* a CDC RNDIS device acting as a simple network interface for
@@ -37,6 +41,8 @@
* recommended that it be replaced with an external open source TCP/IP
* stack that is feature complete, such as the uIP stack.
*
+ * \section SSec_Description Project Description:
+ *
* <table>
* <tr>
* <td><b>USB Mode:</b></td>
@@ -59,4 +65,51 @@
* <td>Full Speed Mode</td>
* </tr>
* </table>
+ *
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
+ * <table>
+ * <tr>
+ * <td><b>Define Name:</b></td>
+ * <td><b>Location:</b></td>
+ * <td><b>Description:</b></td>
+ * </tr>
+ * <tr>
+ * <td>NO_DECODE_ETHERNET</td>
+ * <td>Makefile CDEFS</td>
+ * <td>When defined, received Ethernet headers will not be decoded and printed to the device serial port.</td>
+ * </tr>
+ * <tr>
+ * <td>NO_DECODE_ARP</td>
+ * <td>Makefile CDEFS</td>
+ * <td>When defined, received ARP headers will not be decoded and printed to the device serial port.</td>
+ * </tr>
+ * <tr>
+ * <td>NO_DECODE_IP</td>
+ * <td>Makefile CDEFS</td>
+ * <td>When defined, received IP headers will not be decoded and printed to the device serial port.</td>
+ * </tr>
+ * <tr>
+ * <td>NO_DECODE_ICMP</td>
+ * <td>Makefile CDEFS</td>
+ * <td>When defined, received ICMP headers will not be decoded and printed to the device serial port.</td>
+ * </tr>
+ * <tr>
+ * <td>NO_DECODE_TCP</td>
+ * <td>Makefile CDEFS</td>
+ * <td>When defined, received TCP headers will not be decoded and printed to the device serial port.</td>
+ * </tr>
+ * <tr>
+ * <td>NO_DECODE_UDP</td>
+ * <td>Makefile CDEFS</td>
+ * <td>When defined, received UDP headers will not be decoded and printed to the device serial port.</td>
+ * </tr>
+ * <tr>
+ * <td>NO_DECODE_DHCP</td>
+ * <td>Makefile CDEFS</td>
+ * <td>When defined, received DHCP headers will not be decoded and printed to the device serial port.</td>
+ * </tr>
+ * </table>
*/
\ No newline at end of file
diff --git a/Demos/StillImageHost/StillImageHost.txt b/Demos/StillImageHost/StillImageHost.txt
index 6e2657be6..4cdfe6346 100644
--- a/Demos/StillImageHost/StillImageHost.txt
+++ b/Demos/StillImageHost/StillImageHost.txt
@@ -5,14 +5,10 @@
*/
/** \mainpage Still Image Host Demo
- *
- * Still Image host demonstration application. This gives a simple reference
- * application for implementing a Still Image host, for USB devices such as
- * digital cameras.
- *
- * This demo will enumerate an attached USB Still Image device, print out its
- * information structure, open a session with the device and finally close the
- * session.
+ *
+ * \section SSec_Info USB Information:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
*
* <table>
* <tr>
@@ -37,4 +33,26 @@
* <td>Full Speed Mode</td>
* </tr>
* </table>
+ *
+ * \section SSec_Description Project Description:
+ *
+ * Still Image host demonstration application. This gives a simple reference
+ * application for implementing a Still Image host, for USB devices such as
+ * digital cameras.
+ *
+ * This demo will enumerate an attached USB Still Image device, print out its
+ * information structure, open a session with the device and finally close the
+ * session.
+ *
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
+ * <table>
+ * <tr>
+ * <td>
+ * None
+ * </td>
+ * </tr>
+ * </table>
*/
\ No newline at end of file
diff --git a/Demos/TestApp/TestApp.txt b/Demos/TestApp/TestApp.txt
index e5b268aa5..aef55b761 100644
--- a/Demos/TestApp/TestApp.txt
+++ b/Demos/TestApp/TestApp.txt
@@ -6,25 +6,9 @@
/** \mainpage Test Application for the LUFA library
*
- * Test application. Demonstrates several aspects of the LUFA
- * Library. On startup the current temperature will be printed
- * through the USART every 10 seconds, and the current joystick
- * position will be indicated via the LEDs on the selected board.
- * Pressing the HWB will initiate the USB subsystem, enumerating
- * the device (which has <b>no actual functionality beyond
- * enumeration as a device or as a host in this demo</b>, and serves
- * only to demonstrate the USB portion of the library). It will
- * also suspend the joystick and temperature monitoring tasks.
- *
- * Pressing the HWB a second time will turn off the USB system
- * and resume the temperature printing task (but not the joystick
- * monitoring task).
- *
- * When activated, the USB events will be printed through the
- * serial USART.
+ * \section SSec_Info USB Information:
*
- * When the USB subsystem is activated, the board LEDs will show
- * the current USB status.
+ * The following table gives a rundown of the USB utilization of this demo.
*
* <table>
* <tr>
@@ -48,4 +32,38 @@
* <td>Low Speed Mode, Full Speed Mode</td>
* </tr>
* </table>
+ *
+ * \section SSec_Description Project Description:
+ *
+ * Test application. Demonstrates several aspects of the LUFA
+ * Library. On startup the current temperature will be printed
+ * through the USART every 10 seconds, and the current joystick
+ * position will be indicated via the LEDs on the selected board.
+ * Pressing the HWB will initiate the USB subsystem, enumerating
+ * the device (which has <b>no actual functionality beyond
+ * enumeration as a device or as a host in this demo</b>, and serves
+ * only to demonstrate the USB portion of the library). It will
+ * also suspend the joystick and temperature monitoring tasks.
+ *
+ * Pressing the HWB a second time will turn off the USB system
+ * and resume the temperature printing task (but not the joystick
+ * monitoring task).
+ *
+ * When activated, the USB events will be printed through the
+ * serial USART.
+ *
+ * When the USB subsystem is activated, the board LEDs will show
+ * the current USB status.
+ *
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
+ * <table>
+ * <tr>
+ * <td>
+ * None
+ * </td>
+ * </tr>
+ * </table>
*/
\ No newline at end of file
diff --git a/Demos/USBtoSerial/USBtoSerial.txt b/Demos/USBtoSerial/USBtoSerial.txt
index 992f00f47..e33467217 100644
--- a/Demos/USBtoSerial/USBtoSerial.txt
+++ b/Demos/USBtoSerial/USBtoSerial.txt
@@ -6,19 +6,9 @@
/** \mainpage USB to Serial Converter Demo (via CDC-ACM class)
*
- * Communications Device Class demonstration application.
- * This gives a simple reference application for implementing
- * a USB to Serial converter using the CDC class. Sent and
- * received data on the serial port is communicated to the USB
- * host.
- *
- * After running this demo 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.
+ * \section SSec_Info USB Information:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
*
* <table>
* <tr>
@@ -42,4 +32,37 @@
* <td>Full Speed Mode</td>
* </tr>
* </table>
+ *
+ * \section SSec_Description Project Description:
+ *
+ * Communications Device Class demonstration application.
+ * This gives a simple reference application for implementing
+ * a USB to Serial converter using the CDC class. Sent and
+ * received data on the serial port is communicated to the USB
+ * host.
+ *
+ * After running this demo 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.
+ *
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
+ * <table>
+ * <tr>
+ * <td><b>Define Name:</b></td>
+ * <td><b>Location:</b></td>
+ * <td><b>Description:</b></td>
+ * </tr>
+ * <tr>
+ * <td>BUFF_STATICSIZE</td>
+ * <td>RingBuff.h</td>
+ * <td>Defines the maximum number of bytes which can be buffered in each Ring Buffer.</td>
+ * </tr>
+ * </table>
*/
\ No newline at end of file
diff --git a/Demos/makefile b/Demos/makefile
index 2fd957a36..8f441461a 100644
--- a/Demos/makefile
+++ b/Demos/makefile
@@ -58,12 +58,6 @@ all:
make -C Mouse clean
make -C Mouse all
-
- make -C MouseFullInt clean
- make -C MouseFullInt all
-
- make -C MouseViaInt clean
- make -C MouseViaInt all
make -C MouseHost clean
make -C MouseHost all
@@ -102,8 +96,6 @@ all:
make -C MassStorageHost $@
make -C MIDI $@
make -C Mouse $@
- make -C MouseFullInt $@
- make -C MouseViaInt $@
make -C MouseHost $@
make -C MouseHostWithParser $@
make -C MouseHostViaInt $@
diff --git a/LUFA.pnproj b/LUFA.pnproj
index 3e21d735c..77cdbe363 100644
--- a/LUFA.pnproj
+++ b/LUFA.pnproj
@@ -1 +1 @@
-<Project name="LUFA"><Folder name="Demos"><Folder name="TestApp"><File path="Demos\TestApp\makefile"></File><File path="Demos\TestApp\TestApp.c"></File><File path="Demos\TestApp\TestApp.h"></File><File path="Demos\TestApp\TestEvents.c"></File><File path="Demos\TestApp\TestEvents.h"></File><File path="Demos\TestApp\Descriptors.c"></File><File path="Demos\TestApp\Descriptors.h"></File><File path="Demos\TestApp\TestApp.txt"></File><File path="Demos\TestApp\Doxygen.conf"></File></Folder><Folder name="Mouse"><File path="Demos\Mouse\makefile"></File><File path="Demos\Mouse\Descriptors.c"></File><File path="Demos\Mouse\Descriptors.h"></File><File path="Demos\Mouse\Mouse.h"></File><File path="Demos\Mouse\Mouse.c"></File><File path="Demos\Mouse\Mouse.txt"></File><File path="Demos\Mouse\Doxygen.conf"></File></Folder><Folder name="Keyboard"><File path="Demos\Keyboard\Descriptors.c"></File><File path="Demos\Keyboard\Keyboard.c"></File><File path="Demos\Keyboard\Descriptors.h"></File><File path="Demos\Keyboard\Keyboard.h"></File><File path="Demos\Keyboard\makefile"></File><File path="Demos\Keyboard\Keyboard.txt"></File><File path="Demos\Keyboard\Doxygen.conf"></File></Folder><Folder name="MouseHost"><File path="Demos\MouseHost\MouseHost.h"></File><File path="Demos\MouseHost\makefile"></File><File path="Demos\MouseHost\MouseHost.c"></File><File path="Demos\MouseHost\ConfigDescriptor.c"></File><File path="Demos\MouseHost\ConfigDescriptor.h"></File><File path="Demos\MouseHost\Doxygen.conf"></File><File path="Demos\MouseHost\MouseHost.txt"></File></Folder><Folder name="KeyboardHost"><File path="Demos\KeyboardHost\makefile"></File><File path="Demos\KeyboardHost\KeyboardHost.c"></File><File path="Demos\KeyboardHost\KeyboardHost.h"></File><File path="Demos\KeyboardHost\ConfigDescriptor.c"></File><File path="Demos\KeyboardHost\ConfigDescriptor.h"></File><File path="Demos\KeyboardHost\Doxygen.conf"></File><File path="Demos\KeyboardHost\KeyboardHost.txt"></File></Folder><Folder name="Joystick"><File path="Demos\Joystick\makefile"></File><File path="Demos\Joystick\Descriptors.c"></File><File path="Demos\Joystick\Descriptors.h"></File><File path="Demos\Joystick\Joystick.c"></File><File path="Demos\Joystick\Joystick.h"></File><File path="Demos\Joystick\Joystick.txt"></File><File path="Demos\Joystick\Doxygen.conf"></File></Folder><Folder name="CDC"><File path="Demos\CDC\makefile"></File><File path="Demos\CDC\CDC.c"></File><File path="Demos\CDC\CDC.h"></File><File path="Demos\CDC\Descriptors.c"></File><File path="Demos\CDC\Descriptors.h"></File><File path="Demos\CDC\CDC.txt"></File><File path="Demos\CDC\LUFA CDC.inf"></File><File path="Demos\CDC\Doxygen.conf"></File></Folder><Folder name="USBtoSerial"><File path="Demos\USBtoSerial\Descriptors.h"></File><File path="Demos\USBtoSerial\RingBuff.c"></File><File path="Demos\USBtoSerial\RingBuff.h"></File><File path="Demos\USBtoSerial\Descriptors.c"></File><File path="Demos\USBtoSerial\makefile"></File><File path="Demos\USBtoSerial\USBtoSerial.h"></File><File path="Demos\USBtoSerial\USBtoSerial.c"></File><File path="Demos\USBtoSerial\USBtoSerial.txt"></File><File path="Demos\USBtoSerial\LUFA USBtoSerial.inf"></File><File path="Demos\USBtoSerial\Doxygen.conf"></File></Folder><Folder name="MassStorage"><File path="Demos\MassStorage\MassStorage.h"></File><File path="Demos\MassStorage\Descriptors.c"></File><File path="Demos\MassStorage\Descriptors.h"></File><File path="Demos\MassStorage\makefile"></File><File path="Demos\MassStorage\MassStorage.c"></File><File path="Demos\MassStorage\SCSI.h"></File><File path="Demos\MassStorage\SCSI.c"></File><File path="Demos\MassStorage\DataflashManager.h"></File><File path="Demos\MassStorage\SCSI_Codes.h"></File><File path="Demos\MassStorage\MassStorage.txt"></File><File path="Demos\MassStorage\DataflashManager.c"></File><File path="Demos\MassStorage\Doxygen.conf"></File></Folder><Folder name="KeyboardHostViaInt"><File path="Demos\KeyboardHostViaInt\makefile"></File><File path="Demos\KeyboardHostViaInt\KeyboardHostViaInt.c"></File><File path="Demos\KeyboardHostViaInt\KeyboardHostViaInt.h"></File><File path="Demos\KeyboardHostViaInt\ConfigDescriptor.c"></File><File path="Demos\KeyboardHostViaInt\ConfigDescriptor.h"></File><File path="Demos\KeyboardHostViaInt\Doxygen.conf"></File><File path="Demos\KeyboardHostViaInt\KeyboardHostViaInt.txt"></File></Folder><Folder name="MouseHostViaInt"><File path="Demos\MouseHostViaInt\MouseHostViaInt.h"></File><File path="Demos\MouseHostViaInt\makefile"></File><File path="Demos\MouseHostViaInt\MouseHostViaInt.c"></File><File path="Demos\MouseHostViaInt\ConfigDescriptor.c"></File><File path="Demos\MouseHostViaInt\ConfigDescriptor.h"></File><File path="Demos\MouseHostViaInt\Doxygen.conf"></File><File path="Demos\MouseHostViaInt\MouseHostViaInt.txt"></File></Folder><Folder name="AudioOutput"><File path="Demos\AudioOutput\makefile"></File><File path="Demos\AudioOutput\AudioOutput.c"></File><File path="Demos\AudioOutput\AudioOutput.h"></File><File path="Demos\AudioOutput\Descriptors.c"></File><File path="Demos\AudioOutput\Descriptors.h"></File><File path="Demos\AudioOutput\Doxygen.conf"></File><File path="Demos\AudioOutput\AudioOutput.txt"></File></Folder><Folder name="MassStorageHost"><File path="Demos\MassStorageHost\MassStorageHost.h"></File><File path="Demos\MassStorageHost\makefile"></File><File path="Demos\MassStorageHost\MassStorageHost.c"></File><File path="Demos\MassStorageHost\MassStoreCommands.c"></File><File path="Demos\MassStorageHost\MassStoreCommands.h"></File><File path="Demos\MassStorageHost\ConfigDescriptor.c"></File><File path="Demos\MassStorageHost\ConfigDescriptor.h"></File><File path="Demos\MassStorageHost\Doxygen.conf"></File><File path="Demos\MassStorageHost\SCSI_Codes.h"></File><File path="Demos\MassStorageHost\MassStorageHost.txt"></File></Folder><Folder name="AudioInput"><File path="Demos\AudioInput\makefile"></File><File path="Demos\AudioInput\AudioInput.h"></File><File path="Demos\AudioInput\Descriptors.h"></File><File path="Demos\AudioInput\Descriptors.c"></File><File path="Demos\AudioInput\AudioInput.c"></File><File path="Demos\AudioInput\Doxygen.conf"></File><File path="Demos\AudioInput\AudioInput.txt"></File></Folder><Folder name="MouseViaInt"><File path="Demos\MouseViaInt\Descriptors.c"></File><File path="Demos\MouseViaInt\Descriptors.h"></File><File path="Demos\MouseViaInt\makefile"></File><File path="Demos\MouseViaInt\MouseViaInt.c"></File><File path="Demos\MouseViaInt\MouseViaInt.h"></File><File path="Demos\MouseViaInt\MouseViaInt.txt"></File><File path="Demos\MouseViaInt\Doxygen.conf"></File></Folder><Folder name="MouseFullInt"><File path="Demos\MouseFullInt\Descriptors.c"></File><File path="Demos\MouseFullInt\Descriptors.h"></File><File path="Demos\MouseFullInt\makefile"></File><File path="Demos\MouseFullInt\MouseFullInt.c"></File><File path="Demos\MouseFullInt\MouseFullInt.h"></File><File path="Demos\MouseFullInt\MouseFullInt.txt"></File><File path="Demos\MouseFullInt\Doxygen.conf"></File></Folder><Folder name="KeyboardHostWithParser"><File path="Demos\KeyboardHostWithParser\makefile"></File><File path="Demos\KeyboardHostWithParser\KeyboardHostWithParser.c"></File><File path="Demos\KeyboardHostWithParser\KeyboardHostWithParser.h"></File><File path="Demos\KeyboardHostWithParser\ConfigDescriptor.c"></File><File path="Demos\KeyboardHostWithParser\ConfigDescriptor.h"></File><File path="Demos\KeyboardHostWithParser\HIDReport.c"></File><File path="Demos\KeyboardHostWithParser\HIDReport.h"></File><File path="Demos\KeyboardHostWithParser\Doxygen.conf"></File><File path="Demos\KeyboardHostWithParser\KeyboardHostWithParser.txt"></File></Folder><Folder name="MouseHostWithParser"><File path="Demos\MouseHostWithParser\makefile"></File><File path="Demos\MouseHostWithParser\MouseHostWithParser.c"></File><File path="Demos\MouseHostWithParser\MouseHostWithParser.h"></File><File path="Demos\MouseHostWithParser\ConfigDescriptor.c"></File><File path="Demos\MouseHostWithParser\ConfigDescriptor.h"></File><File path="Demos\MouseHostWithParser\HIDReport.c"></File><File path="Demos\MouseHostWithParser\HIDReport.h"></File><File path="Demos\MouseHostWithParser\Doxygen.conf"></File><File path="Demos\MouseHostWithParser\MouseHostWithParser.txt"></File></Folder><Folder name="MIDI"><File path="Demos\MIDI\Descriptors.c"></File><File path="Demos\MIDI\Descriptors.h"></File><File path="Demos\MIDI\makefile"></File><File path="Demos\MIDI\MIDI.c"></File><File path="Demos\MIDI\MIDI.h"></File><File path="Demos\MIDI\Doxygen.conf"></File><File path="Demos\MIDI\MIDI.txt"></File></Folder><Folder name="CDCHost"><File path="Demos\CDCHost\CDCHost.c"></File><File path="Demos\CDCHost\CDCHost.h"></File><File path="Demos\CDCHost\makefile"></File><File path="Demos\CDCHost\ConfigDescriptor.c"></File><File path="Demos\CDCHost\ConfigDescriptor.h"></File><File path="Demos\CDCHost\Doxygen.conf"></File><File path="Demos\CDCHost\CDCHost.txt"></File></Folder><Folder name="StillImageHost"><File path="Demos\StillImageHost\makefile"></File><File path="Demos\StillImageHost\PIMACodes.h"></File><File path="Demos\StillImageHost\StillImageCommands.c"></File><File path="Demos\StillImageHost\StillImageCommands.h"></File><File path="Demos\StillImageHost\StillImageHost.c"></File><File path="Demos\StillImageHost\StillImageHost.h"></File><File path="Demos\StillImageHost\ConfigDescriptor.c"></File><File path="Demos\StillImageHost\ConfigDescriptor.h"></File><File path="Demos\StillImageHost\Doxygen.conf"></File></Folder><Folder name="RNDISEthernet"><File path="Demos\RNDISEthernet\RNDIS.c"></File><File path="Demos\RNDISEthernet\Descriptors.c"></File><File path="Demos\RNDISEthernet\Webserver.h"></File><File path="Demos\RNDISEthernet\ARP.c"></File><File path="Demos\RNDISEthernet\ARP.h"></File><File path="Demos\RNDISEthernet\Descriptors.h"></File><File path="Demos\RNDISEthernet\DHCP.c"></File><File path="Demos\RNDISEthernet\DHCP.h"></File><File path="Demos\RNDISEthernet\Ethernet.c"></File><File path="Demos\RNDISEthernet\Ethernet.h"></File><File path="Demos\RNDISEthernet\EthernetProtocols.h"></File><File path="Demos\RNDISEthernet\ICMP.c"></File><File path="Demos\RNDISEthernet\ICMP.h"></File><File path="Demos\RNDISEthernet\IP.c"></File><File path="Demos\RNDISEthernet\IP.h"></File><File path="Demos\RNDISEthernet\makefile"></File><File path="Demos\RNDISEthernet\ProtocolDecoders.c"></File><File path="Demos\RNDISEthernet\ProtocolDecoders.h"></File><File path="Demos\RNDISEthernet\RNDIS.h"></File><File path="Demos\RNDISEthernet\RNDISEthernet.aps"></File><File path="Demos\RNDISEthernet\RNDISEthernet.c"></File><File path="Demos\RNDISEthernet\RNDISEthernet.h"></File><File path="Demos\RNDISEthernet\TCP.c"></File><File path="Demos\RNDISEthernet\TCP.h"></File><File path="Demos\RNDISEthernet\UDP.c"></File><File path="Demos\RNDISEthernet\UDP.h"></File><File path="Demos\RNDISEthernet\Webserver.c"></File><File path="Demos\RNDISEthernet\LUFA RNDIS.inf"></File><File path="Demos\RNDISEthernet\Doxygen.conf"></File><File path="Demos\RNDISEthernet\RNDISEthernet.txt"></File><File path="Demos\RNDISEthernet\RNDISConstants.h"></File></Folder><Folder name="KeyboardMouse"><File path="Demos\KeyboardMouse\Descriptors.c"></File><File path="Demos\KeyboardMouse\Descriptors.h"></File><File path="Demos\KeyboardMouse\KeyboardMouse.c"></File><File path="Demos\KeyboardMouse\KeyboardMouse.h"></File><File path="Demos\KeyboardMouse\makefile"></File><File path="Demos\KeyboardMouse\KeyboardMouse.txt"></File><File path="Demos\KeyboardMouse\Doxygen.conf"></File></Folder><Folder name="DualCDC"><File path="Demos\DualCDC\Descriptors.c"></File><File path="Demos\DualCDC\Descriptors.h"></File><File path="Demos\DualCDC\makefile"></File><File path="Demos\DualCDC\DualCDC.c"></File><File path="Demos\DualCDC\DualCDC.h"></File><File path="Demos\DualCDC\DualCDC.txt"></File><File path="Demos\DualCDC\LUFA DualCDC.inf"></File><File path="Demos\DualCDC\Doxygen.conf"></File></Folder><File path="Demos\makefile"></File></Folder><Folder name="LUFA"><Folder name="Common"><File path="LUFA\Common\Common.h"></File><File path="LUFA\Common\FunctionAttributes.h"></File><File path="LUFA\Common\ButtLoadTag.h"></File><File path="LUFA\Common\BoardTypes.h"></File></Folder><Folder name="Drivers"><Folder name="USB"><Folder name="LowLevel"><File path="LUFA\Drivers\USB\LowLevel\HostChapter9.h"></File><File path="LUFA\Drivers\USB\LowLevel\LowLevel.c"></File><File path="LUFA\Drivers\USB\LowLevel\LowLevel.h"></File><File path="LUFA\Drivers\USB\LowLevel\Pipe.c"></File><File path="LUFA\Drivers\USB\LowLevel\Pipe.h"></File><File path="LUFA\Drivers\USB\LowLevel\StdRequestType.h"></File><File path="LUFA\Drivers\USB\LowLevel\DevChapter9.c"></File><File path="LUFA\Drivers\USB\LowLevel\DevChapter9.h"></File><File path="LUFA\Drivers\USB\LowLevel\Device.h"></File><File path="LUFA\Drivers\USB\LowLevel\Endpoint.c"></File><File path="LUFA\Drivers\USB\LowLevel\Endpoint.h"></File><File path="LUFA\Drivers\USB\LowLevel\Host.c"></File><File path="LUFA\Drivers\USB\LowLevel\Host.h"></File><File path="LUFA\Drivers\USB\LowLevel\HostChapter9.c"></File><File path="LUFA\Drivers\USB\LowLevel\OTG.h"></File><File path="LUFA\Drivers\USB\LowLevel\USBMode.h"></File><File path="LUFA\Drivers\USB\LowLevel\StreamCallbacks.h"></File></Folder><Folder name="HighLevel"><File path="LUFA\Drivers\USB\HighLevel\USBTask.h"></File><File path="LUFA\Drivers\USB\HighLevel\Events.c"></File><File path="LUFA\Drivers\USB\HighLevel\Events.h"></File><File path="LUFA\Drivers\USB\HighLevel\USBInterrupt.c"></File><File path="LUFA\Drivers\USB\HighLevel\USBInterrupt.h"></File><File path="LUFA\Drivers\USB\HighLevel\USBTask.c"></File><File path="LUFA\Drivers\USB\HighLevel\StdDescriptors.c"></File><File path="LUFA\Drivers\USB\HighLevel\StdDescriptors.h"></File></Folder><Folder name="Class"><File path="LUFA\Drivers\USB\Class\HIDParser.c"></File><File path="LUFA\Drivers\USB\Class\HIDParser.h"></File><File path="LUFA\Drivers\USB\Class\HIDReportData.h"></File><File path="LUFA\Drivers\USB\Class\ConfigDescriptor.c"></File><File path="LUFA\Drivers\USB\Class\ConfigDescriptor.h"></File></Folder><File path="LUFA\Drivers\USB\USB.h"></File></Folder><Folder name="Misc"><File path="LUFA\Drivers\Misc\TerminalCodes.h"></File></Folder><Folder name="AT90USBXXX"><Folder name="AT90USBXXX67"><File path="LUFA\Drivers\AT90USBXXX\AT90USBXXX67\ADC.h"></File></Folder><File path="LUFA\Drivers\AT90USBXXX\Serial_Stream.h"></File><File path="LUFA\Drivers\AT90USBXXX\ADC.h"></File><File path="LUFA\Drivers\AT90USBXXX\Serial.c"></File><File path="LUFA\Drivers\AT90USBXXX\Serial.h"></File><File path="LUFA\Drivers\AT90USBXXX\Serial_Stream.c"></File><File path="LUFA\Drivers\AT90USBXXX\SPI.h"></File></Folder><Folder name="Board"><Folder name="USBKEY"><File path="LUFA\Drivers\Board\USBKEY\Dataflash.h"></File><File path="LUFA\Drivers\Board\USBKEY\Joystick.h"></File><File path="LUFA\Drivers\Board\USBKEY\HWB.h"></File><File path="LUFA\Drivers\Board\USBKEY\AT45DB642D.h"></File><File path="LUFA\Drivers\Board\USBKEY\LEDs.h"></File></Folder><Folder name="STK526"><File path="LUFA\Drivers\Board\STK526\Dataflash.h"></File><File path="LUFA\Drivers\Board\STK526\Joystick.h"></File><File path="LUFA\Drivers\Board\STK526\HWB.h"></File><File path="LUFA\Drivers\Board\STK526\AT45DB642D.h"></File><File path="LUFA\Drivers\Board\STK526\LEDs.h"></File></Folder><Folder name="STK525"><File path="LUFA\Drivers\Board\STK525\Dataflash.h"></File><File path="LUFA\Drivers\Board\STK525\Joystick.h"></File><File path="LUFA\Drivers\Board\STK525\HWB.h"></File><File path="LUFA\Drivers\Board\STK525\AT45DB321C.h"></File><File path="LUFA\Drivers\Board\STK525\LEDs.h"></File></Folder><Folder name="RZUSBSTICK"><File path="LUFA\Drivers\Board\RZUSBSTICK\LEDs.h"></File></Folder><Folder name="ATAVRUSBRF01"><File path="LUFA\Drivers\Board\ATAVRUSBRF01\LEDs.h"></File><File path="LUFA\Drivers\Board\ATAVRUSBRF01\HWB.h"></File></Folder><File path="LUFA\Drivers\Board\Temperature.h"></File><File path="LUFA\Drivers\Board\Dataflash.h"></File><File path="LUFA\Drivers\Board\HWB.h"></File><File path="LUFA\Drivers\Board\Joystick.h"></File><File path="LUFA\Drivers\Board\Temperature.c"></File><File path="LUFA\Drivers\Board\LEDs.h"></File></Folder></Folder><Folder name="Scheduler"><File path="LUFA\Scheduler\Scheduler.h"></File><File path="LUFA\Scheduler\Scheduler.c"></File></Folder><Folder name="MemoryAllocator"><File path="LUFA\MemoryAllocator\DynAlloc.h"></File><File path="LUFA\MemoryAllocator\DynAlloc.c"></File></Folder><Folder name="DriverStubs"><File path="LUFA\DriverStubs\Dataflash.h"></File><File path="LUFA\DriverStubs\HWB.h"></File><File path="LUFA\DriverStubs\Joystick.h"></File><File path="LUFA\DriverStubs\LEDs.h"></File></Folder><File path="LUFA\makefile"></File><File path="LUFA\Version.h"></File><File path="LUFA\BuildingLinkableLibraries.txt"></File><File path="LUFA\GettingStarted.txt"></File><File path="LUFA\MainPage.txt"></File><File path="LUFA\SchedulerOverview.txt"></File><File path="LUFA\VIDAndPIDValues.txt"></File><File path="LUFA\ChangeLog.txt"></File><File path="LUFA\CompileTimeTokens.txt"></File><File path="LUFA\MigrationInformation.txt"></File><File path="LUFA\DirectorySummaries.txt"></File><File path="LUFA\Doxygen.conf"></File><File path="LUFA\WritingBoardDrivers.txt"></File></Folder><Folder name="Projects"><Folder name="MagStripe"><File path="Projects\Magstripe\Descriptors.c"></File><File path="Projects\Magstripe\Descriptors.h"></File><File path="Projects\Magstripe\Magstripe.c"></File><File path="Projects\Magstripe\Magstripe.h"></File><File path="Projects\Magstripe\MagstripeHW.h"></File><File path="Projects\Magstripe\makefile"></File><File path="Projects\Magstripe\Magstripe.txt"></File><File path="Projects\Magstripe\Doxygen.conf"></File><File path="Projects\Magstripe\CircularBitBuffer.c"></File><File path="Projects\Magstripe\CircularBitBuffer.h"></File></Folder><Folder name="AVRISP_Programmer"><File path="Projects\AVRISP_Programmer\AVRISP_Firmware_Design.txt"></File><File path="Projects\AVRISP_Programmer\AVRISP_Programmer.c"></File><File path="Projects\AVRISP_Programmer\AVRISP_Programmer.h"></File><File path="Projects\AVRISP_Programmer\AVRISP_Programmer.txt"></File><File path="Projects\AVRISP_Programmer\Descriptors.c"></File><File path="Projects\AVRISP_Programmer\makefile"></File><File path="Projects\AVRISP_Programmer\Sample_Programming_Session.txt"></File><File path="Projects\AVRISP_Programmer\RingBuff.c"></File><File path="Projects\AVRISP_Programmer\RingBuff.h"></File><File path="Projects\AVRISP_Programmer\Descriptors.h"></File></Folder><File path="Projects\makefile"></File></Folder><Folder name="Bootloaders"><Folder name="DFU"><File path="Bootloaders\DFU\BootloaderDFU.c"></File><File path="Bootloaders\DFU\BootloaderDFU.h"></File><File path="Bootloaders\DFU\Descriptors.c"></File><File path="Bootloaders\DFU\Descriptors.h"></File><File path="Bootloaders\DFU\makefile"></File><File path="Bootloaders\DFU\BootloaderDFU.txt"></File><File path="Bootloaders\DFU\Doxygen.conf"></File></Folder><Folder name="CDC"><File path="Bootloaders\CDC\BootloaderCDC.c"></File><File path="Bootloaders\CDC\BootloaderCDC.h"></File><File path="Bootloaders\CDC\Descriptors.c"></File><File path="Bootloaders\CDC\Descriptors.h"></File><File path="Bootloaders\CDC\makefile"></File><File path="Bootloaders\CDC\LUFA CDC Bootloader.inf"></File><File path="Bootloaders\CDC\Doxygen.conf"></File><File path="Bootloaders\CDC\BootloaderCDC.txt"></File></Folder><Folder name="TeensyHID"><File path="Bootloaders\TeensyHID\Descriptors.c"></File><File path="Bootloaders\TeensyHID\Descriptors.h"></File><File path="Bootloaders\TeensyHID\makefile"></File><File path="Bootloaders\TeensyHID\TeensyHID.c"></File><File path="Bootloaders\TeensyHID\TeensyHID.h"></File><File path="Bootloaders\TeensyHID\TeensyHID.txt"></File></Folder><File path="Bootloaders\makefile"></File></Folder><File path="makefile"></File></Project>
\ No newline at end of file
+<Project name="LUFA"><Folder name="Demos"><Folder name="TestApp"><File path="Demos\TestApp\makefile"></File><File path="Demos\TestApp\TestApp.c"></File><File path="Demos\TestApp\TestApp.h"></File><File path="Demos\TestApp\TestEvents.c"></File><File path="Demos\TestApp\TestEvents.h"></File><File path="Demos\TestApp\Descriptors.c"></File><File path="Demos\TestApp\Descriptors.h"></File><File path="Demos\TestApp\TestApp.txt"></File><File path="Demos\TestApp\Doxygen.conf"></File></Folder><Folder name="Mouse"><File path="Demos\Mouse\makefile"></File><File path="Demos\Mouse\Descriptors.c"></File><File path="Demos\Mouse\Descriptors.h"></File><File path="Demos\Mouse\Mouse.h"></File><File path="Demos\Mouse\Mouse.c"></File><File path="Demos\Mouse\Mouse.txt"></File><File path="Demos\Mouse\Doxygen.conf"></File></Folder><Folder name="Keyboard"><File path="Demos\Keyboard\Descriptors.c"></File><File path="Demos\Keyboard\Keyboard.c"></File><File path="Demos\Keyboard\Descriptors.h"></File><File path="Demos\Keyboard\Keyboard.h"></File><File path="Demos\Keyboard\makefile"></File><File path="Demos\Keyboard\Keyboard.txt"></File><File path="Demos\Keyboard\Doxygen.conf"></File></Folder><Folder name="MouseHost"><File path="Demos\MouseHost\MouseHost.h"></File><File path="Demos\MouseHost\makefile"></File><File path="Demos\MouseHost\MouseHost.c"></File><File path="Demos\MouseHost\ConfigDescriptor.c"></File><File path="Demos\MouseHost\ConfigDescriptor.h"></File><File path="Demos\MouseHost\Doxygen.conf"></File><File path="Demos\MouseHost\MouseHost.txt"></File></Folder><Folder name="KeyboardHost"><File path="Demos\KeyboardHost\makefile"></File><File path="Demos\KeyboardHost\KeyboardHost.c"></File><File path="Demos\KeyboardHost\KeyboardHost.h"></File><File path="Demos\KeyboardHost\ConfigDescriptor.c"></File><File path="Demos\KeyboardHost\ConfigDescriptor.h"></File><File path="Demos\KeyboardHost\Doxygen.conf"></File><File path="Demos\KeyboardHost\KeyboardHost.txt"></File></Folder><Folder name="Joystick"><File path="Demos\Joystick\makefile"></File><File path="Demos\Joystick\Descriptors.c"></File><File path="Demos\Joystick\Descriptors.h"></File><File path="Demos\Joystick\Joystick.c"></File><File path="Demos\Joystick\Joystick.h"></File><File path="Demos\Joystick\Joystick.txt"></File><File path="Demos\Joystick\Doxygen.conf"></File></Folder><Folder name="CDC"><File path="Demos\CDC\makefile"></File><File path="Demos\CDC\CDC.c"></File><File path="Demos\CDC\CDC.h"></File><File path="Demos\CDC\Descriptors.c"></File><File path="Demos\CDC\Descriptors.h"></File><File path="Demos\CDC\CDC.txt"></File><File path="Demos\CDC\LUFA CDC.inf"></File><File path="Demos\CDC\Doxygen.conf"></File></Folder><Folder name="USBtoSerial"><File path="Demos\USBtoSerial\Descriptors.h"></File><File path="Demos\USBtoSerial\RingBuff.c"></File><File path="Demos\USBtoSerial\RingBuff.h"></File><File path="Demos\USBtoSerial\Descriptors.c"></File><File path="Demos\USBtoSerial\makefile"></File><File path="Demos\USBtoSerial\USBtoSerial.h"></File><File path="Demos\USBtoSerial\USBtoSerial.c"></File><File path="Demos\USBtoSerial\USBtoSerial.txt"></File><File path="Demos\USBtoSerial\LUFA USBtoSerial.inf"></File><File path="Demos\USBtoSerial\Doxygen.conf"></File></Folder><Folder name="MassStorage"><File path="Demos\MassStorage\MassStorage.h"></File><File path="Demos\MassStorage\Descriptors.c"></File><File path="Demos\MassStorage\Descriptors.h"></File><File path="Demos\MassStorage\makefile"></File><File path="Demos\MassStorage\MassStorage.c"></File><File path="Demos\MassStorage\SCSI.h"></File><File path="Demos\MassStorage\SCSI.c"></File><File path="Demos\MassStorage\DataflashManager.h"></File><File path="Demos\MassStorage\SCSI_Codes.h"></File><File path="Demos\MassStorage\MassStorage.txt"></File><File path="Demos\MassStorage\DataflashManager.c"></File><File path="Demos\MassStorage\Doxygen.conf"></File></Folder><Folder name="KeyboardHostViaInt"><File path="Demos\KeyboardHostViaInt\makefile"></File><File path="Demos\KeyboardHostViaInt\KeyboardHostViaInt.c"></File><File path="Demos\KeyboardHostViaInt\KeyboardHostViaInt.h"></File><File path="Demos\KeyboardHostViaInt\ConfigDescriptor.c"></File><File path="Demos\KeyboardHostViaInt\ConfigDescriptor.h"></File><File path="Demos\KeyboardHostViaInt\Doxygen.conf"></File><File path="Demos\KeyboardHostViaInt\KeyboardHostViaInt.txt"></File></Folder><Folder name="MouseHostViaInt"><File path="Demos\MouseHostViaInt\MouseHostViaInt.h"></File><File path="Demos\MouseHostViaInt\makefile"></File><File path="Demos\MouseHostViaInt\MouseHostViaInt.c"></File><File path="Demos\MouseHostViaInt\ConfigDescriptor.c"></File><File path="Demos\MouseHostViaInt\ConfigDescriptor.h"></File><File path="Demos\MouseHostViaInt\Doxygen.conf"></File><File path="Demos\MouseHostViaInt\MouseHostViaInt.txt"></File></Folder><Folder name="AudioOutput"><File path="Demos\AudioOutput\makefile"></File><File path="Demos\AudioOutput\AudioOutput.c"></File><File path="Demos\AudioOutput\AudioOutput.h"></File><File path="Demos\AudioOutput\Descriptors.c"></File><File path="Demos\AudioOutput\Descriptors.h"></File><File path="Demos\AudioOutput\Doxygen.conf"></File><File path="Demos\AudioOutput\AudioOutput.txt"></File></Folder><Folder name="MassStorageHost"><File path="Demos\MassStorageHost\MassStorageHost.h"></File><File path="Demos\MassStorageHost\makefile"></File><File path="Demos\MassStorageHost\MassStorageHost.c"></File><File path="Demos\MassStorageHost\MassStoreCommands.c"></File><File path="Demos\MassStorageHost\MassStoreCommands.h"></File><File path="Demos\MassStorageHost\ConfigDescriptor.c"></File><File path="Demos\MassStorageHost\ConfigDescriptor.h"></File><File path="Demos\MassStorageHost\Doxygen.conf"></File><File path="Demos\MassStorageHost\SCSI_Codes.h"></File><File path="Demos\MassStorageHost\MassStorageHost.txt"></File></Folder><Folder name="AudioInput"><File path="Demos\AudioInput\makefile"></File><File path="Demos\AudioInput\AudioInput.h"></File><File path="Demos\AudioInput\Descriptors.h"></File><File path="Demos\AudioInput\Descriptors.c"></File><File path="Demos\AudioInput\AudioInput.c"></File><File path="Demos\AudioInput\Doxygen.conf"></File><File path="Demos\AudioInput\AudioInput.txt"></File></Folder><Folder name="KeyboardHostWithParser"><File path="Demos\KeyboardHostWithParser\makefile"></File><File path="Demos\KeyboardHostWithParser\KeyboardHostWithParser.c"></File><File path="Demos\KeyboardHostWithParser\KeyboardHostWithParser.h"></File><File path="Demos\KeyboardHostWithParser\ConfigDescriptor.c"></File><File path="Demos\KeyboardHostWithParser\ConfigDescriptor.h"></File><File path="Demos\KeyboardHostWithParser\HIDReport.c"></File><File path="Demos\KeyboardHostWithParser\HIDReport.h"></File><File path="Demos\KeyboardHostWithParser\Doxygen.conf"></File><File path="Demos\KeyboardHostWithParser\KeyboardHostWithParser.txt"></File></Folder><Folder name="MouseHostWithParser"><File path="Demos\MouseHostWithParser\makefile"></File><File path="Demos\MouseHostWithParser\MouseHostWithParser.c"></File><File path="Demos\MouseHostWithParser\MouseHostWithParser.h"></File><File path="Demos\MouseHostWithParser\ConfigDescriptor.c"></File><File path="Demos\MouseHostWithParser\ConfigDescriptor.h"></File><File path="Demos\MouseHostWithParser\HIDReport.c"></File><File path="Demos\MouseHostWithParser\HIDReport.h"></File><File path="Demos\MouseHostWithParser\Doxygen.conf"></File><File path="Demos\MouseHostWithParser\MouseHostWithParser.txt"></File></Folder><Folder name="MIDI"><File path="Demos\MIDI\Descriptors.c"></File><File path="Demos\MIDI\Descriptors.h"></File><File path="Demos\MIDI\makefile"></File><File path="Demos\MIDI\MIDI.c"></File><File path="Demos\MIDI\MIDI.h"></File><File path="Demos\MIDI\Doxygen.conf"></File><File path="Demos\MIDI\MIDI.txt"></File></Folder><Folder name="CDCHost"><File path="Demos\CDCHost\CDCHost.c"></File><File path="Demos\CDCHost\CDCHost.h"></File><File path="Demos\CDCHost\makefile"></File><File path="Demos\CDCHost\ConfigDescriptor.c"></File><File path="Demos\CDCHost\ConfigDescriptor.h"></File><File path="Demos\CDCHost\Doxygen.conf"></File><File path="Demos\CDCHost\CDCHost.txt"></File></Folder><Folder name="StillImageHost"><File path="Demos\StillImageHost\makefile"></File><File path="Demos\StillImageHost\PIMACodes.h"></File><File path="Demos\StillImageHost\StillImageCommands.c"></File><File path="Demos\StillImageHost\StillImageCommands.h"></File><File path="Demos\StillImageHost\StillImageHost.c"></File><File path="Demos\StillImageHost\StillImageHost.h"></File><File path="Demos\StillImageHost\ConfigDescriptor.c"></File><File path="Demos\StillImageHost\ConfigDescriptor.h"></File><File path="Demos\StillImageHost\Doxygen.conf"></File><File path="Demos\StillImageHost\StillImageHost.txt"></File></Folder><Folder name="RNDISEthernet"><File path="Demos\RNDISEthernet\RNDIS.c"></File><File path="Demos\RNDISEthernet\Descriptors.c"></File><File path="Demos\RNDISEthernet\Webserver.h"></File><File path="Demos\RNDISEthernet\ARP.c"></File><File path="Demos\RNDISEthernet\ARP.h"></File><File path="Demos\RNDISEthernet\Descriptors.h"></File><File path="Demos\RNDISEthernet\DHCP.c"></File><File path="Demos\RNDISEthernet\DHCP.h"></File><File path="Demos\RNDISEthernet\Ethernet.c"></File><File path="Demos\RNDISEthernet\Ethernet.h"></File><File path="Demos\RNDISEthernet\EthernetProtocols.h"></File><File path="Demos\RNDISEthernet\ICMP.c"></File><File path="Demos\RNDISEthernet\ICMP.h"></File><File path="Demos\RNDISEthernet\IP.c"></File><File path="Demos\RNDISEthernet\IP.h"></File><File path="Demos\RNDISEthernet\makefile"></File><File path="Demos\RNDISEthernet\ProtocolDecoders.c"></File><File path="Demos\RNDISEthernet\ProtocolDecoders.h"></File><File path="Demos\RNDISEthernet\RNDIS.h"></File><File path="Demos\RNDISEthernet\RNDISEthernet.aps"></File><File path="Demos\RNDISEthernet\RNDISEthernet.c"></File><File path="Demos\RNDISEthernet\RNDISEthernet.h"></File><File path="Demos\RNDISEthernet\TCP.c"></File><File path="Demos\RNDISEthernet\TCP.h"></File><File path="Demos\RNDISEthernet\UDP.c"></File><File path="Demos\RNDISEthernet\UDP.h"></File><File path="Demos\RNDISEthernet\Webserver.c"></File><File path="Demos\RNDISEthernet\LUFA RNDIS.inf"></File><File path="Demos\RNDISEthernet\Doxygen.conf"></File><File path="Demos\RNDISEthernet\RNDISEthernet.txt"></File><File path="Demos\RNDISEthernet\RNDISConstants.h"></File></Folder><Folder name="KeyboardMouse"><File path="Demos\KeyboardMouse\Descriptors.c"></File><File path="Demos\KeyboardMouse\Descriptors.h"></File><File path="Demos\KeyboardMouse\KeyboardMouse.c"></File><File path="Demos\KeyboardMouse\KeyboardMouse.h"></File><File path="Demos\KeyboardMouse\makefile"></File><File path="Demos\KeyboardMouse\KeyboardMouse.txt"></File><File path="Demos\KeyboardMouse\Doxygen.conf"></File></Folder><Folder name="DualCDC"><File path="Demos\DualCDC\Descriptors.c"></File><File path="Demos\DualCDC\Descriptors.h"></File><File path="Demos\DualCDC\makefile"></File><File path="Demos\DualCDC\DualCDC.c"></File><File path="Demos\DualCDC\DualCDC.h"></File><File path="Demos\DualCDC\DualCDC.txt"></File><File path="Demos\DualCDC\LUFA DualCDC.inf"></File><File path="Demos\DualCDC\Doxygen.conf"></File></Folder><File path="Demos\makefile"></File></Folder><Folder name="LUFA"><Folder name="Common"><File path="LUFA\Common\Common.h"></File><File path="LUFA\Common\FunctionAttributes.h"></File><File path="LUFA\Common\ButtLoadTag.h"></File><File path="LUFA\Common\BoardTypes.h"></File></Folder><Folder name="Drivers"><Folder name="USB"><Folder name="LowLevel"><File path="LUFA\Drivers\USB\LowLevel\HostChapter9.h"></File><File path="LUFA\Drivers\USB\LowLevel\LowLevel.c"></File><File path="LUFA\Drivers\USB\LowLevel\LowLevel.h"></File><File path="LUFA\Drivers\USB\LowLevel\Pipe.c"></File><File path="LUFA\Drivers\USB\LowLevel\Pipe.h"></File><File path="LUFA\Drivers\USB\LowLevel\StdRequestType.h"></File><File path="LUFA\Drivers\USB\LowLevel\DevChapter9.c"></File><File path="LUFA\Drivers\USB\LowLevel\DevChapter9.h"></File><File path="LUFA\Drivers\USB\LowLevel\Device.h"></File><File path="LUFA\Drivers\USB\LowLevel\Endpoint.c"></File><File path="LUFA\Drivers\USB\LowLevel\Endpoint.h"></File><File path="LUFA\Drivers\USB\LowLevel\Host.c"></File><File path="LUFA\Drivers\USB\LowLevel\Host.h"></File><File path="LUFA\Drivers\USB\LowLevel\HostChapter9.c"></File><File path="LUFA\Drivers\USB\LowLevel\OTG.h"></File><File path="LUFA\Drivers\USB\LowLevel\USBMode.h"></File><File path="LUFA\Drivers\USB\LowLevel\StreamCallbacks.h"></File></Folder><Folder name="HighLevel"><File path="LUFA\Drivers\USB\HighLevel\USBTask.h"></File><File path="LUFA\Drivers\USB\HighLevel\Events.c"></File><File path="LUFA\Drivers\USB\HighLevel\Events.h"></File><File path="LUFA\Drivers\USB\HighLevel\USBInterrupt.c"></File><File path="LUFA\Drivers\USB\HighLevel\USBInterrupt.h"></File><File path="LUFA\Drivers\USB\HighLevel\USBTask.c"></File><File path="LUFA\Drivers\USB\HighLevel\StdDescriptors.c"></File><File path="LUFA\Drivers\USB\HighLevel\StdDescriptors.h"></File></Folder><Folder name="Class"><File path="LUFA\Drivers\USB\Class\HIDParser.c"></File><File path="LUFA\Drivers\USB\Class\HIDParser.h"></File><File path="LUFA\Drivers\USB\Class\HIDReportData.h"></File><File path="LUFA\Drivers\USB\Class\ConfigDescriptor.c"></File><File path="LUFA\Drivers\USB\Class\ConfigDescriptor.h"></File></Folder><File path="LUFA\Drivers\USB\USB.h"></File></Folder><Folder name="Misc"><File path="LUFA\Drivers\Misc\TerminalCodes.h"></File></Folder><Folder name="AT90USBXXX"><Folder name="AT90USBXXX67"><File path="LUFA\Drivers\AT90USBXXX\AT90USBXXX67\ADC.h"></File></Folder><File path="LUFA\Drivers\AT90USBXXX\Serial_Stream.h"></File><File path="LUFA\Drivers\AT90USBXXX\ADC.h"></File><File path="LUFA\Drivers\AT90USBXXX\Serial.c"></File><File path="LUFA\Drivers\AT90USBXXX\Serial.h"></File><File path="LUFA\Drivers\AT90USBXXX\Serial_Stream.c"></File><File path="LUFA\Drivers\AT90USBXXX\SPI.h"></File></Folder><Folder name="Board"><Folder name="USBKEY"><File path="LUFA\Drivers\Board\USBKEY\Dataflash.h"></File><File path="LUFA\Drivers\Board\USBKEY\Joystick.h"></File><File path="LUFA\Drivers\Board\USBKEY\HWB.h"></File><File path="LUFA\Drivers\Board\USBKEY\AT45DB642D.h"></File><File path="LUFA\Drivers\Board\USBKEY\LEDs.h"></File></Folder><Folder name="STK526"><File path="LUFA\Drivers\Board\STK526\Dataflash.h"></File><File path="LUFA\Drivers\Board\STK526\Joystick.h"></File><File path="LUFA\Drivers\Board\STK526\HWB.h"></File><File path="LUFA\Drivers\Board\STK526\AT45DB642D.h"></File><File path="LUFA\Drivers\Board\STK526\LEDs.h"></File></Folder><Folder name="STK525"><File path="LUFA\Drivers\Board\STK525\Dataflash.h"></File><File path="LUFA\Drivers\Board\STK525\Joystick.h"></File><File path="LUFA\Drivers\Board\STK525\HWB.h"></File><File path="LUFA\Drivers\Board\STK525\AT45DB321C.h"></File><File path="LUFA\Drivers\Board\STK525\LEDs.h"></File></Folder><Folder name="RZUSBSTICK"><File path="LUFA\Drivers\Board\RZUSBSTICK\LEDs.h"></File></Folder><Folder name="ATAVRUSBRF01"><File path="LUFA\Drivers\Board\ATAVRUSBRF01\LEDs.h"></File><File path="LUFA\Drivers\Board\ATAVRUSBRF01\HWB.h"></File></Folder><File path="LUFA\Drivers\Board\Temperature.h"></File><File path="LUFA\Drivers\Board\Dataflash.h"></File><File path="LUFA\Drivers\Board\HWB.h"></File><File path="LUFA\Drivers\Board\Joystick.h"></File><File path="LUFA\Drivers\Board\Temperature.c"></File><File path="LUFA\Drivers\Board\LEDs.h"></File></Folder></Folder><Folder name="Scheduler"><File path="LUFA\Scheduler\Scheduler.h"></File><File path="LUFA\Scheduler\Scheduler.c"></File></Folder><Folder name="MemoryAllocator"><File path="LUFA\MemoryAllocator\DynAlloc.h"></File><File path="LUFA\MemoryAllocator\DynAlloc.c"></File></Folder><Folder name="DriverStubs"><File path="LUFA\DriverStubs\Dataflash.h"></File><File path="LUFA\DriverStubs\HWB.h"></File><File path="LUFA\DriverStubs\Joystick.h"></File><File path="LUFA\DriverStubs\LEDs.h"></File></Folder><File path="LUFA\makefile"></File><File path="LUFA\Version.h"></File><File path="LUFA\BuildingLinkableLibraries.txt"></File><File path="LUFA\GettingStarted.txt"></File><File path="LUFA\MainPage.txt"></File><File path="LUFA\SchedulerOverview.txt"></File><File path="LUFA\VIDAndPIDValues.txt"></File><File path="LUFA\ChangeLog.txt"></File><File path="LUFA\CompileTimeTokens.txt"></File><File path="LUFA\MigrationInformation.txt"></File><File path="LUFA\DirectorySummaries.txt"></File><File path="LUFA\Doxygen.conf"></File><File path="LUFA\WritingBoardDrivers.txt"></File></Folder><Folder name="Projects"><Folder name="MagStripe"><File path="Projects\Magstripe\Descriptors.c"></File><File path="Projects\Magstripe\Descriptors.h"></File><File path="Projects\Magstripe\Magstripe.c"></File><File path="Projects\Magstripe\Magstripe.h"></File><File path="Projects\Magstripe\MagstripeHW.h"></File><File path="Projects\Magstripe\makefile"></File><File path="Projects\Magstripe\Magstripe.txt"></File><File path="Projects\Magstripe\Doxygen.conf"></File><File path="Projects\Magstripe\CircularBitBuffer.c"></File><File path="Projects\Magstripe\CircularBitBuffer.h"></File></Folder><File path="Projects\makefile"></File></Folder><Folder name="Bootloaders"><Folder name="DFU"><File path="Bootloaders\DFU\BootloaderDFU.c"></File><File path="Bootloaders\DFU\BootloaderDFU.h"></File><File path="Bootloaders\DFU\Descriptors.c"></File><File path="Bootloaders\DFU\Descriptors.h"></File><File path="Bootloaders\DFU\makefile"></File><File path="Bootloaders\DFU\BootloaderDFU.txt"></File><File path="Bootloaders\DFU\Doxygen.conf"></File></Folder><Folder name="CDC"><File path="Bootloaders\CDC\BootloaderCDC.c"></File><File path="Bootloaders\CDC\BootloaderCDC.h"></File><File path="Bootloaders\CDC\Descriptors.c"></File><File path="Bootloaders\CDC\Descriptors.h"></File><File path="Bootloaders\CDC\makefile"></File><File path="Bootloaders\CDC\LUFA CDC Bootloader.inf"></File><File path="Bootloaders\CDC\Doxygen.conf"></File><File path="Bootloaders\CDC\BootloaderCDC.txt"></File></Folder><Folder name="TeensyHID"><File path="Bootloaders\TeensyHID\Descriptors.c"></File><File path="Bootloaders\TeensyHID\Descriptors.h"></File><File path="Bootloaders\TeensyHID\makefile"></File><File path="Bootloaders\TeensyHID\TeensyHID.c"></File><File path="Bootloaders\TeensyHID\TeensyHID.h"></File><File path="Bootloaders\TeensyHID\TeensyHID.txt"></File></Folder><File path="Bootloaders\makefile"></File></Folder><File path="makefile"></File></Project>
\ No newline at end of file
diff --git a/LUFA/ChangeLog.txt b/LUFA/ChangeLog.txt
index c1de86f1b..ad7f7bb5e 100644
--- a/LUFA/ChangeLog.txt
+++ b/LUFA/ChangeLog.txt
@@ -8,7 +8,6 @@
*
* \section Sec_ChangeLogXXXXXX Version XXXXXX
*
- * - Added new incomplete BluetoothHost demo
* - Changed AVRISP Programmer descriptors to use a newly allocated 0x204F PID value
* - Fixed MagStripe project configuration descriptor containing an unused (blank) endpoint descriptor
* - Incorporated makefile changes by Denver Gingerich to retain compatibility with stock (non-WinAVR) AVR-GCC installations
@@ -37,9 +36,10 @@
* to Kenneth Clubb)
* - Added DataflashManager_WriteBlocks_RAM() and DataflashManager_ReadBlocks_RAM() functions to the MassStorage demo, to allow for easy
* interfacing with a FAT library for dataflash file level access
- * - Incomplete non-functional BluetoothHost demo removed until it has reached a stable state to prevent confusion
* - Corrected CDC class bootloader to fix a few bugs, changed address counter to store x2 addresses for convenience
* - Fixed typos in the SPI driver SPI_SPEED_FCPU_DIV_64 and SPI_SPEED_FCPU_DIV_128 masks (thanks to Markus Zocholl)
+ * - Keyboard and Mouse demos (normal, data interrupt and fully interrupt driven) combined into unified keyboard and mouse demos
+ * - Removed AVRISP_Programmer project due to code quality concerns
*
* \section Sec_ChangeLog090209 Version 090209
*
diff --git a/Projects/AVRISP_Programmer/AVRISP_Firmware_Design.txt b/Projects/AVRISP_Programmer/AVRISP_Firmware_Design.txt
deleted file mode 100644
index 643454d48..000000000
--- a/Projects/AVRISP_Programmer/AVRISP_Firmware_Design.txt
+++ /dev/null
@@ -1,176 +0,0 @@
-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
deleted file mode 100644
index 748002317..000000000
--- a/Projects/AVRISP_Programmer/AVRISP_Programmer.aps
+++ /dev/null
@@ -1 +0,0 @@
-<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
deleted file mode 100644
index 58593670e..000000000
--- a/Projects/AVRISP_Programmer/AVRISP_Programmer.c
+++ /dev/null
@@ -1,763 +0,0 @@
-/*
- 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 */
-uint16_t currAddress = 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 */
- clock_prescale_set(clock_div_1);
-
- /* Hardware Initialization */
- LEDs_Init();
- ReconfigureSPI();
-
- 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;
-
- /* 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))
- {
- /* Acknowledge 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))
- {
- /* Acknowledge 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))
- {
- /* Acknowledge the SETUP packet, ready for data transfer */
- Endpoint_ClearSetupReceived();
-
- /* Acknowledge status stage */
- while (!(Endpoint_IsSetupINReady()));
- 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)
- {
- /* 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());
-
- /* Run the given command once enough data is available. */
- if (Rx_Buffer.Elements)
- {
- const uint8_t ZeroDataByteCommands[] = {'P', 'a', 'm', 'R', 'd', 'e', 'L', 's', 't', 'S', 'V', 'v', 'p', 'F'};
- const uint8_t OneDataByteCommands[] = {'T', 'c', 'C', 'D', 'l', 'f', 'x', 'y'};
- const uint8_t TwoDataByteCommands[] = {'A', 'Z'};
- const uint8_t ThreeDataByteCommands[] = {':'};
- const uint8_t FourDataByteCommands[] = {'.'};
-
- const struct
- {
- const uint8_t TotalCommands;
- const uint8_t* CommandBytes;
- } AVR910Commands[] = {{sizeof(ZeroDataByteCommands), ZeroDataByteCommands},
- {sizeof(OneDataByteCommands), OneDataByteCommands},
- {sizeof(TwoDataByteCommands), TwoDataByteCommands},
- {sizeof(ThreeDataByteCommands), ThreeDataByteCommands},
- {sizeof(FourDataByteCommands), FourDataByteCommands}};
-
- /* Determine the data length of the issued command */
- uint8_t CommandDataLength = (Rx_Buffer.Elements - 1);
-
- /* Loop through each of the possible command bytes allowable from the given command data length */
- for (uint8_t CurrentCommand = 0; CurrentCommand < AVR910Commands[CommandDataLength].TotalCommands; CurrentCommand++)
- {
- /* If issues command matches an allowable command, process it */
- if (Buffer_PeekElement(&Rx_Buffer) == AVR910Commands[CommandDataLength].CommandBytes[CurrentCommand])
- processHostSPIRequest();
- }
- }
- }
-
- /* Clear the endpoint buffer */
- Endpoint_ClearCurrentBank();
- }
-
- /* 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 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;
-}
-
-
-/* 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
- 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
- }
-}
-
diff --git a/Projects/AVRISP_Programmer/AVRISP_Programmer.h b/Projects/AVRISP_Programmer/AVRISP_Programmer.h
deleted file mode 100644
index c6ac13fe7..000000000
--- a/Projects/AVRISP_Programmer/AVRISP_Programmer.h
+++ /dev/null
@@ -1,195 +0,0 @@
-/*
- 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 <avr/power.h>
- #include <util/delay.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);
-
-#endif
diff --git a/Projects/AVRISP_Programmer/AVRISP_Programmer.txt b/Projects/AVRISP_Programmer/AVRISP_Programmer.txt
deleted file mode 100644
index 1872cfb5e..000000000
--- a/Projects/AVRISP_Programmer/AVRISP_Programmer.txt
+++ /dev/null
@@ -1,89 +0,0 @@
-/** \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
deleted file mode 100644
index 87ec3d43ee0df3937060894b2773b04fb36aa91e..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001
literal 74610
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
NvT{0>@fpVdHvvW^NhkmS
diff --git a/Projects/AVRISP_Programmer/Descriptors.c b/Projects/AVRISP_Programmer/Descriptors.c
deleted file mode 100644
index 5f3ffca08..000000000
--- a/Projects/AVRISP_Programmer/Descriptors.c
+++ /dev/null
@@ -1,263 +0,0 @@
-/*
- 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
deleted file mode 100644
index bec5e40d4..000000000
--- a/Projects/AVRISP_Programmer/Descriptors.h
+++ /dev/null
@@ -1,98 +0,0 @@
-/*
- 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
deleted file mode 100644
index 1eb8c5432..000000000
--- a/Projects/AVRISP_Programmer/Doxygen.conf
+++ /dev/null
@@ -1,1485 +0,0 @@
-# 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
deleted file mode 100644
index bd9c8bf14..000000000
--- a/Projects/AVRISP_Programmer/LUFA AVRISP_Programmer.inf
+++ /dev/null
@@ -1,55 +0,0 @@
-; 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
deleted file mode 100644
index 1f477f17a..000000000
--- a/Projects/AVRISP_Programmer/RingBuff.c
+++ /dev/null
@@ -1,120 +0,0 @@
-/*
- 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
deleted file mode 100644
index 68e4a6e75..000000000
--- a/Projects/AVRISP_Programmer/RingBuff.h
+++ /dev/null
@@ -1,116 +0,0 @@
-/*
- 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
deleted file mode 100644
index b5af76ebb..000000000
--- a/Projects/AVRISP_Programmer/Sample_Programming_Session.txt
+++ /dev/null
@@ -1,104 +0,0 @@
-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
deleted file mode 100644
index 0938f0518..000000000
--- a/Projects/AVRISP_Programmer/makefile
+++ /dev/null
@@ -1,726 +0,0 @@
-# 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
-
-
-# Input clock frequency.
-# This will define a symbol, F_CLOCK, in all source code files equal to the
-# input clock frequency (before any prescaling is performed). This value may
-# differ from F_CPU if prescaling is used on the latter, and is required as the
-# raw input clock is fed directly to the PLL sections of the AVR for high speed
-# clock generation for the USB and other AVR subsections. Do NOT tack on a 'UL'
-# at the end, this will be done automatically to create a 32-bit value in your
-# source code.
-#
-# If no clock division is performed on the input clock inside the AVR (via the
-# CPU clock adjust registers or the clock division fuses), this will be equal to F_CPU.
-F_CLOCK = 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 -DF_CLOCK=$(F_CLOCK)UL -DBOARD=BOARD_$(BOARD)
-CDEFS += -DUSE_NONSTANDARD_DESCRIPTOR_NAMES -DNO_STREAM_CALLBACKS -DUSB_DEVICE_ONLY
-CDEFS += -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 checkboard 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 ------------------------------------
-
-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 ------------------------------------
-
-checkboard:
- @echo
- @echo ---------- Selected Board ----------
- @echo Selected board model is $(BOARD).
- @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) flash-eeprom --debug 1 --suppress-bootloader-mem $(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)eep.hex
- $(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 checkboard \
-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 flip-ee dfu-ee
\ No newline at end of file
diff --git a/Projects/Magstripe/Magstripe.txt b/Projects/Magstripe/Magstripe.txt
index d91fddde7..af9565059 100644
--- a/Projects/Magstripe/Magstripe.txt
+++ b/Projects/Magstripe/Magstripe.txt
@@ -5,7 +5,36 @@
*/
/** \mainpage Denver Gingerich's USBSnoop Magnetic Card Reader Project
- *
+ *
+ * \section SSec_Info USB Information:
+ *
+ * The following table gives a rundown of the USB utilization of this demo.
+ *
+ * <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>
+ *
+ * \section SSec_Description Project Description:
+ *
* 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/.
@@ -51,7 +80,6 @@
* </tr>
* </table>
*
- *
* This project is based on the LUFA Keyboard demonstration application,
* written by Denver Gingerich.
*
@@ -60,26 +88,20 @@
* 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>
- */
+ * \section SSec_Options Project Options
+ *
+ * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
+ *
+ * <table>
+ * <tr>
+ * <td><b>Define Name:</b></td>
+ * <td><b>Location:</b></td>
+ * <td><b>Description:</b></td>
+ * </tr>
+ * <tr>
+ * <td>MAX_BITS</td>
+ * <td>CircularBitBuffer.h</td>
+ * <td>Gives the maximum number of bits per track which can be buffered by the device for later transmission to a host.</td>
+ * </tr>
+ * </table>
+ */
\ No newline at end of file
diff --git a/Projects/makefile b/Projects/makefile
index 50851a3ef..59de892bf 100644
--- a/Projects/makefile
+++ b/Projects/makefile
@@ -16,10 +16,6 @@
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