]> git.donarmstrong.com Git - qmk_firmware.git/blob - protocol/lufa/LUFA-120730/LUFA/DoxygenPages/ChangeLog.txt
Squashed 'tmk_core/' content from commit 05caacc
[qmk_firmware.git] / protocol / lufa / LUFA-120730 / LUFA / DoxygenPages / ChangeLog.txt
1 /** \file\r
2  *\r
3  *  This file contains special DoxyGen information for the generation of the main page and other special\r
4  *  documentation pages. It is not a project source file.\r
5  */\r
6 \r
7  /** \page Page_ChangeLog Project Changelog\r
8   *\r
9   *  \section Sec_ChangeLog120730 Version 120730\r
10   *  <b>New:</b>\r
11   *  - Core:\r
12   *   - Added new, revamped modular build system with new makefile templates\r
13   *   - Added support for the BitWizard Multio and Big-Multio boards\r
14   *   - Added support for the DorkbotPDX Duce board\r
15   *   - Added support for the Olimex AVR-USB-32U4 board\r
16   *   - Added support for the Olimex AVR-USB-T32U4 board\r
17   *   - Added support for the Olimex AVR-ISP-MK2 board\r
18   *   - Added new Endpoint_ConfigureEndpointTable() function\r
19   *   - Added new Pipe_ConfigurePipeTable() function\r
20   *   - Added build test to verify correct compilation of all board drivers using all driver APIs\r
21   *   - Added build test to verify correct compilation of all bootloaders using all supported devices  \r
22   *   - Added build test to verify that there are no detectable errors in the codebase via static analysis\r
23   *   - Added new JTAG_ENABLE() macro for the AVR8 architecture\r
24   *  - Library Applications:\r
25   *   - Modified the CDC Host demos to set a default CDC Line Encoding on enumerated devices\r
26   *   - Added Dataflash operational checks and aborts to all projects using the Dataflash to ensure it is working correctly before use\r
27   *   - Added new SerialToLCD user project contributed by Simon Foster\r
28   *   - Added new RESET_TOGGLES_LIBUSB_COMPAT compile time option to the AVRISP-MKII clone programmer project (thanks to Robert Spitzenpfeil)\r
29   *\r
30   *  <b>Changed:</b>\r
31   *  - Core:\r
32   *   - Android Accessory Host property strings changed from a struct of pointer to an array to prevent unaligned access on greater than 8-bit architectures\r
33   *   - Audio Device Class driver changed to also require the index of the Audio Control interface within the device, for SET/GET/CUR/MIN/MAX/RES property adjustments\r
34   *   - Removed variable axis support from the HID_DESCRIPTOR_JOYSTICK() macro due to OS incompatibilities, replaced with fixed 3-axis joystick report structure\r
35   *   - Removed the old pseudo-scheduler from the library as it was unused and deprecated since the 090810 release\r
36   *   - Endpoint indexes are now specified as full endpoint addresses within the device in device mode, rather than a logical index\r
37   *   - The Endpoint_ConfigureEndpoint() function no longer takes an endpoint direction as a parameter, as this is now deduced from the specified full endpoint\r
38   *     address and type\r
39   *   - The Endpoint_ConfigureEndpoint() function no longer takes a number of banks as a special mask; the number of banks is now specified as an integer parameter\r
40   *   - Endpoints are now configured via instances of a new struct USB_Endpoint_Table_t in all device mode class drivers, rather than a list of endpoint parameters\r
41   *   - Pipe indexes are now specified as full pipe addresses within the host in host mode, rather than a logical index\r
42   *   - The Pipe_ConfigurePipe() function no longer takes an pipe token as a parameter, as this is now deduced from the specified full pipe address and type\r
43   *   - The Pipe_ConfigurePipe() function no longer takes a number of banks as a special mask; the number of banks is now specified as an integer parameter\r
44   *   - Pipes are now configured via instances of a new struct USB_Pipe_Table_t in all host mode class drivers, rather than a list of pipe parameters\r
45   *   - Added support for various assert and debugging macros for the UC3 devices\r
46   *   - Changed MIDI event structure MIDI_EventPacket_t to use a single field for the combined virtual cable index and command ID, to prevent bitfield packing issues\r
47   *     on some architectures (thanks to Darren Gibbs)\r
48   *   - Changed board LED driver implementations of LEDs_ToggleLEDs() for the AVR8 architecture to use the fast PIN register toggle alternative function for speed\r
49   *  - Library Applications:\r
50   *   - Raised the guard bits in the AVRISP-MKII clone project when in PDI and TPI to 32, to prevent communication errors on low quality connections to a target\r
51   *   - Added additional bootloader API data to expose the bootloader start address and class to the DFU and CDC class bootloaders\r
52   *   - Reverted AVRISP-MKII clone project watchdog based command timeout patch in favour of a hardware timer, to allow for use in devices with WDTRST fuse programmed\r
53   *   - The library bootloaders will now correctly start the user application after a watchdog-based application start, even if the /HWB line is held low externally\r
54   *     during the reset phase\r
55   *   - Increased endpoint polling interval for all demos and projects to 5ms, as 1ms was causing some enumeration issues on some machines (thanks to Riku Salminen)\r
56   *\r
57   *  <b>Fixed:</b>\r
58   *  - Core:\r
59   *   - Fixed possible enumeration error if the user application selects a pipe other than the default Control pipe between the Powered and Default states of\r
60   *     the host state machine\r
61   *   - Fixed incorrect call to the user callback CALLBACK_Audio_Device_GetSetInterfaceProperty() in the Audio Class device driver (thanks to Tiit Ratsep)\r
62   *   - Fixed compile error for the UC3 architecture when INTERRUPT_CONTROL_ENDPOINT is specified (thanks to Andrus Aaslaid)\r
63   *   - Fixed compile error if LEDs_Disable() is called and BOARD=NONE is set (thanks to Sam Lin)\r
64   *   - Fixed inverted LED logic in the OLIMEX162 board LED driver\r
65   *   - Fixed incorrect reponse to GET STATUS requests in device mode if NO_DEVICE_SELF_POWER or NO_DEVICE_REMOTE_WAKEUP tokens are defined (thanks to Georg Glock)\r
66   *   - Fixed inverted LED logic in the USB2AX board LED driver\r
67   *   - Fixed possible deadlock in the CDC device driver if the USB connection is dropped while the CDC_REQ_SetLineEncoding control request is being processed by\r
68   *     the stack (thanks to Jonathan Hudgins)\r
69   *   - Fixed broken MIDI host driver MIDI_Host_ReceiveEventPacket() function due to not unfreezing the MIDI data IN pipe before use (thanks to Michael Brown)\r
70   *   - Fixed swapped Little Endian/Big Endian endpoint and pipe write code for the UC3 devices (thanks to Andrew Chu)\r
71   *   - Fixed the JTAG_DISABLE() macro clearing all other bits in MCUSR when called\r
72   *   - Fixed incorrect Micropendous board LED driver LEDs_SetAllLEDs() and LEDs_ChangeLEDs() function implementations (thanks to MitchJS)\r
73   *   - Fixed endianess issues in the RNDIS host class driver for UC3 devices (thanks to Andrew Chu)  \r
74   *  - Library Applications:\r
75   *   - Fixed error in the AVRISP-MKII programmer when ISP mode is used at 64KHz (thanks to Ben R. Porter)\r
76   *   - Fixed AVRISP-MKII programmer project failing to compile for the U4 chips when VTARGET_ADC_CHANNEL is defined to an invalid channel and NO_VTARGET_DETECT is\r
77   *     defined (thanks to Steven Morehouse)\r
78   *   - Fixed AVRISP-MKII programmer project reset line polarity inverted when the generated EEP file is loaded into the USB AVR's EEPROM and avr-dude is used\r
79   *   - Fixed CDC and DFU bootloaders failing to compile when the bootloader section size is 8KB or more (thanks to Georg Glock)\r
80   *   - Fixed CDC and DFU bootloaders API function offsets incorrect on some devices (thanks to Rod DeMay)\r
81   *   - Fixed incorrect DFU version number reported to the host in the  DFU bootloader descriptors (thanks to Georg Glock)\r
82   *   - Fixed incorrect version hundredths value encoding in VERSION_BCD() macro (thanks to Georg Glock)\r
83   *   - Fixed invalid configuration descriptor in the low level KeyboardMouse device demo (thanks to Jun Wako)\r
84   *   - Fixed CDC and DFU bootloaders API page erase and write function failures (thanks to Martin Lambert)\r
85   *\r
86   *  \section Sec_ChangeLog120219 Version 120219\r
87   *  <b>New:</b>\r
88   *  - Core:\r
89   *   - Added support for the XMEGA A3BU Xplained board\r
90   *   - Added support for the new B series XMEGA devices\r
91   *   - Added support for version 2 of the Teensy boards (thanks to Christoph Redecker)\r
92   *   - Added support for the USB2AX boards, hardware revision 1-3\r
93   *   - Added new Android Accessory Host class driver\r
94   *   - Added new USB_Host_GetDescriptor(), USB_Host_GetDeviceConfiguration() and USB_Host_GetInterfaceAltSetting() functions\r
95   *   - Added new CALLBACK_Audio_Device_GetSetInterfaceProperty() callback to the Audio Device Class driver\r
96   *   - Added new LEDs_Disable(), Buttons_Disable() and Joystick_Disable() functions to the board hardware drivers\r
97   *   - Added support for the Micropendous family of boards (Arduino-like revisions 1 and 2, DIP, 32U2, A, 1, 2, 3 and 4)\r
98   *   - Added INVERTED_VBUS_ENABLE_LINE and NO_AUTO_VBUS_MANAGEMENT compile time options (thanks to Opendous Inc.)\r
99   *   - Added support for the Atmel XMEGA B1 Xplained board\r
100   *   - Added Serial USART peripheral driver for the XMEGA architecture\r
101   *   - Added Master Mode SPI USART peripheral driver for the XMEGA and AVR8 architectures\r
102   *   - Added build test to verify correct compilation of as many modules as possible under as many architectures as possible under the C and C++ languages\r
103   *   - Added build test to verify correct compilation of the USB driver when forced into single USB mode under as many architectures as possible\r
104   *  - Library Applications:\r
105   *   - Added User Application APIs to the CDC and DFU class bootloaders\r
106   *   - Added INVERTED_ISP_MISO compile time option to the AVRISP-MKII clone project (thanks to Chuck Rohs)\r
107   *   - Added new Android Accessory Host demo (thanks to Opendous Inc.)\r
108   *\r
109   *  <b>Changed:</b>\r
110   *  - Core:\r
111   *   - When automatic PLL management mode is enabled on the U4 series AVR8 chips, the PLL is now configured for 48MHz and not\r
112   *     a divided 96MHz, to lower power consumption and to keep the system within the datasheet specs for 3.3V operation (thanks to Scott Vitale)\r
113   *   - Added Class, ClassDevice, ClassHost and ClassCommon to the internal class driver source filenames to prevent ambiguities\r
114   *   - Altered the Mass Storage Host class driver so that SCSI data STALLs from the attached device can be recovered from automatically without\r
115   *     having to reset the Mass Storage interface\r
116   *   - USB_CONFIG_ATTR_BUSPOWERED constant renamed to USB_CONFIG_ATTR_RESERVED, as this was misnamed (thanks to NXP Semiconductors)\r
117   *   - Reordered board name definition indexes so that a mispelled BOARD compile option will default to BOARD_USER rather than BOARD_USBKEY\r
118   *   - Altered the HID class driver to only try to construct at maximum one packet per USB frame, to reduce CPU usage\r
119   *   - All USB Class Driver configuration struct values are now non-const, to allow for run-time modifications if required before configuring an instance\r
120   *  - Library Applications:\r
121   *   - Altered the Mass Storage Host LowLevel demo so that SCSI data STALLs from the attached device can be recovered from automatically without\r
122   *     having to reset the Mass Storage interface\r
123   *   - Updated the AVRISP-MKII Clone programmer project to be compatible with the latest version of AVR Studio (version 5.1)\r
124   *   - Changed the AVRISP-MKII Clone programmer project to report a fixed 3.3V VTARGET voltage on USB AVRs lacking an ADC instead of 5V to prevent\r
125   *     warnings in AVR Studio 5.1 when programming XMEGA devices\r
126   *   - Allow serial strings to be generated on the older AVR8 devices which do not explicitly state they contain unique values in the datasheet,\r
127   *     as this appears to be implemented in hardware\r
128   *\r
129   *  <b>Fixed:</b>\r
130   *  - Core:\r
131   *   - Fixed ring buffer size limited to 255 elements, instead of the intended 65535 elements.\r
132   *   - Fixed CDC class drivers not saving and sending all 16-bits of the control line states (thanks to Matthew Swabey)\r
133   *   - Fixed race conditions in the CDC, HID and Mass Storage class drivers when processing some control requests\r
134   *   - Fixed misspelled HID_KEYBOARD_MODIFIER_* macros in the HID class driver (thanks to Laszlo Monda)\r
135   *   - Fixed broken AVR32 endpoint/pipe communications when ORDERED_EP_CONFIG compile time option is not enabled (thanks to Matthias Jahr)\r
136   *   - Fixed broken compilation for the AVR32 devices if the NO_SOF_EVENTS compile time option was not enabled (thanks to Matthias Jahr)\r
137   *   - Fixed compiler warning on GCC with \c -wundef compile flag is used (thanks to Georg Glock)\r
138   *   - Fixed incorrect implementation of LEDs_ToggleLEDs() for the Adafruit-U4 board (thanks to Caroline Saliman)\r
139   *   - Fixed broken compilation of LUFA under C++ compilers when the Serial peripheral module header file is included in a C++ source file\r
140   *   - Fixed missing semicolon in the UC3 architecture host pipe functions\r
141   *   - Fixed failed compilation for the XMEGA architecture if USB_DEVICE_ONLY us not specified\r
142   *   - Fixed UC3 architecture ignoring the pipe size when Pipe_ConfigurePipe() is called\r
143   *  - Library Applications:\r
144   *   - Added reliability patches to the AVRISP-MKII Clone project's PDI/TPI protocols (thanks to Justin Mattair)\r
145   *   - Fixed AVRISP-MKII Clone compile warning on AVR8 U4 targets even when NO_VTARGET_DETECT is enabled\r
146   *   - Fixed AVRISP-MKII Clone failing to start application firmware once a TPI programming session is exited\r
147   *   - Fixed DFU class bootloader not resetting the LED pins as high impedance inputs when a software jump to the user applications is requested\r
148   *   - Fixed AVRISP-MKII Clone timing out on long programming commands such as programming the EEPROM on an ATMEGA8 (thanks to Martin Kelling)\r
149   *   - Fixed invalid PID value used in the TempDataLogger project host application (thanks to Anupam Pathak)\r
150   *\r
151   *  \section Sec_ChangeLog111009 Version 111009\r
152   *  <b>New:</b>\r
153   *  - Core:\r
154   *   - Added USE_LUFA_CONFIG_HEADER compile time option to include a LUFAConfig.h header in the user director for LUFA configuration\r
155   *     tokens as an alternative to tokens defined in the project makefile\r
156   *   - Added new USB_Host_SetInterfaceAltSetting() convenience function for the selection of an interface's alternative setting\r
157   *   - Added Audio class control request definitions\r
158   *   - Added new CALLBACK_Audio_Device_GetSetEndpointProperty() callback to the Audio Device Class driver to allow for endpoint control manipulations\r
159   *     such as data sample rates\r
160   *   - Added support for the Audio class GET STATUS request in the Audio Device Class driver so that it is correctly ACKed when sent by the host\r
161   *   - Added new EVENT_Audio_Device_StreamStartStop() event to the Audio Device Class driver to detect stream start/stop events\r
162   *   - Added board driver support for the Busware TUL board\r
163   *   - Added board hardware driver support for the EVK1100 board\r
164   *   - Added board hardware driver support for the EVK1104 board\r
165   *   - Added new Host mode Audio Class driver\r
166   *   - Added new SPI_GetCurrentMode() function to the SPI peripheral driver\r
167   *   - Added RingBuffer_GetFreeCount() function to the Ring Buffer driver\r
168   *   - Added new HID_Host_SetIdlePeriod() function to the HID Host Class driver\r
169   *   - Added new USB_Host_ConfigurationNumber global variable to indicate the selected configuration in an attached device\r
170   *   - Added new USB_Host_GetDeviceStatus() function to the host standard request function set\r
171   *   - Added AVR USB XMEGA architecture port (currently incomplete/experimental)\r
172   *   - Added new STRINGIFY() and STRINGIFY_EXPANDED() convenience macros\r
173   *   - Added new JTAG_DISABLE() macro for the AVR8 architecture\r
174   *   - Added Device Qualifier standard descriptor structure definitions USB_StdDescriptor_DeviceQualifier_t and USB_Descriptor_DeviceQualifier_t\r
175   *  - Library Applications:\r
176   *   - Added RNDIS device mode to the Webserver project\r
177   *   - Added new incomplete AndroidAccessoryHost Host LowLevel demo\r
178   *   - Added new HIDReportViewer project\r
179   *   - Added new MediaControl project\r
180   *   - Added new AudioInputHost Host ClassDriver demo\r
181   *   - Added new AudioOutputHost Host ClassDriver demo\r
182   *   - Added new AudioInputHost Host LowLevel demo\r
183   *   - Added new AudioOutputHost Host LowLevel demo\r
184   *   - Added new "checksource" target to all library project makefiles\r
185   *   - Added new VTARGET_USE_INTERNAL_REF configuration option to the AVRISP-MKII clone project (thanks to Volker Bosch)\r
186   *\r
187   *  <b>Changed:</b>\r
188   *  - Core:\r
189   *   - Altered the definition of the USB_Audio_Descriptor_Format_t descriptor so that the user is now responsible for supplying\r
190   *     the supported audio sampling rates, to allow for multiple audio interfaces with different numbers of supported rates and/or\r
191   *     continuous sample rates\r
192   *   - Pipe_BoundEndpointNumber() has been renamed to Pipe_GetBoundEndpointAddress(), and now returns the correct endpoint direction\r
193   *     as part of the endpoint address\r
194   *   - Renamed global state variables that are specific to a certain USB mode to clearly indicate which mode the variable relates to,\r
195   *     by changing the USB_* prefix to USB_Device_* or USB_Host_*\r
196   *   - Removed the HOST_STATE_WaitForDeviceRemoval and HOST_STATE_Suspended host state machine states, as these are no longer required\r
197   *   - Altered the USB_Host_SetDeviceConfiguration() function to update the global Host state machine state and the new\r
198   *     USB_Host_ConfigurationNumber global as required\r
199   *   - Added endian correcting code to the library USB class drivers for multiple architecture support\r
200   *   - Removed the ENDPOINT_DESCRIPTOR_DIR_* macros, replaced by ENDPOINT_DIR_* instead\r
201   *   - Renamed the JTAG_DEBUG_ASSERT() macro to JTAG_ASSERT()\r
202   *   - Added variable number of axis to HID_DESCRIPTOR_JOYSTICK() for multi-axis joysticks above just X and Y\r
203   *   - Renamed USB_Host_ClearPipeStall() to USB_Host_ClearEndpointStall() as the function works on an endpoint address within the attached device,\r
204   *     and not a Pipe within the host\r
205   *   - The MS_Host_ResetMSInterface() now performs a full Mass Storage reset sequence to prevent data corruption in the event of a device\r
206   *     lock up or timeout (thanks to David Lyons)\r
207   *   - Added endian-correction to the CDC driver's Line Encoding control request handlers.\r
208   *  - Library Applications:\r
209   *   - Modified the Low Level and Class Driver AudioInput and AudioOutput demos to support multiple audio sample rates\r
210   *   - Updated all host mode demos and projects to use the EVENT_USB_Host_DeviceEnumerationComplete() event callback for device configuration\r
211   *     instead of manual host state machine manipulations in the main application task\r
212   *   - Changed the reports in the GenericHID device demos to control the board LEDs, to reduce user confusion over the callback routines\r
213   *   - Added reliability patches to the AVRISP-MKII Clone project's ISP and PDI/TPI protocols (thanks to Justin Mattair)\r
214   *\r
215   *  <b>Fixed:</b>\r
216   *  - Core:\r
217   *   - Large number of documentation and code comment corrections (thanks to Andrey from Microsin.ru)\r
218   *   - Fixed possibility of the AVR's SPI interface being pulled out of master mode if the /SS pin is a input and pulled low (thanks\r
219   *     to Andrey from Microsin.ru)\r
220   *   - Fixed compile error when FIXED_CONTROL_ENDPOINT_SIZE compile time option was disabled, and a USE_*_DESCRIPTORS compile time\r
221   *     option was not enabled on the AVR8s\r
222   *   - Fixed lack of C++ compatibility in some internal header files causing compile errors when using LUFA in C++ projects\r
223   *   - Fixed error in the pipe unordered allocation algorithm for the AVR8 devices breaking compatibility with some devices\r
224   *   - Fixed USB_USBTask not being called internally in stream transfers between packets when Partial Stream Transfers are used\r
225   *   - Fixed swapped TWI_ADDRESS_READ and TWI_ADDRESS_WRITE values\r
226   *   - Fixed TWI_ReadPacket() not releasing the TWI bus on read completion\r
227   *   - Fixed optimization error in the HID Parser item value USB_SetHIDReportItemInfo() and USB_GetHIDReportItemInfo() routines if the report item was\r
228   *     \c NULL (which should be allowable according to the API)\r
229   *   - Fixed HID Parser CALLBACK_HIDParser_FilterHIDReportItem() callback function not being passed a cacheable report item pointer\r
230   *   - Fixed HID Parser's largest report size bit count not including the size of the last parsed report item\r
231   *   - Fixed HID host driver's largest HID report size count corrupt when the number of report bits exceeds 255\r
232   *  - Library Applications:\r
233   *   - Fixed incorrect signature in the CDC and DFU class bootloaders for the ATMEGA8U2\r
234   *   - Fixed KeyboardHost and KeyboardHostWithParser demos displaying incorrect values when numerical keys were pressed\r
235   *   - Fixed compile errors in the incomplete BluetoothHost demo application (thanks to Timo Lindfors)\r
236   *   - Fixed incorrect Dataflash buffer use in the DataflashManager_WriteBlocks_RAM() function of several demos/projects (thanks to Jeremy Willden)\r
237   *   - Fixed incorrect logging interval (always 500ms longer than requested) in the TempDataLogger project\r
238   *   - Fixed incorrect buffer size check in the USBtoSerial project (thanks to Yuri A Nikiforov)\r
239   *   - Fixed port state table corruption in the TCP layer of the RNDIS Ethernet device demos\r
240   *\r
241   *  \section Sec_ChangeLog110528 Version 110528\r
242   *  <b>New:</b>\r
243   *  - Core:\r
244   *   - Added new ORDERED_EP_CONFIG compile time option to restrict endpoint/pipe configuration to ascending order\r
245   *     in exchange for a smaller compiled program binary size\r
246   *   - Added a new general RingBuff.h miscellaneous ring buffer library driver header\r
247   *   - Added new GCC_FORCE_POINTER_ACCESS() macro to correct GCC's mishandling of struct pointer accesses\r
248   *   - Added new GCC_MEMORY_BARRIER() macro to prevent instruction reordering across boundaries\r
249   *   - Added basic driver example use code to the library documentation\r
250   *   - Added new Endpoint_Null_Stream() and Pipe_Null_Stream() functions\r
251   *   - Added new ADC_GET_CHANNEL_MASK() convenience macro\r
252   *   - Added new HID report item macros (with HID_RI_ prefix) to allow for easy creation and editing of HID report descriptors\r
253   *   - Added new HID_DESCRIPTOR_MOUSE(), HID_DESCRIPTOR_KEYBOARD(), HID_DESCRIPTOR_JOYSTICK() and HID_DESCRIPTOR_VENDOR() macros\r
254   *     for easy automatic creation of basic USB HID device reports\r
255   *   - Added new MAX() and MIN() convenience macros\r
256   *   - Added new Serial_SendData() function to the Serial driver\r
257   *   - Added board driver support for the Sparkfun ATMEGA8U2 breakout board\r
258   *   - Added TWI baud rate prescaler and bit length parameters to the TWI_Init() function (thanks to Thomas Herlinghaus)\r
259   *   - Internal restructuring for eventual multiple architecture ports\r
260   *   - Added AVR32 UC3 architecture port (currently incomplete/experimental)\r
261   *   - Added new architecture independent functions to enable, disable, save and restore the Global Interrupt Enable flags\r
262   *   - Added new RNDIS Device Class Driver packet send and receive functions\r
263   *  - Library Applications:\r
264   *   - Added ability to write protect Mass Storage disk write operations from the host OS\r
265   *   - Added new MIDIToneGenerator project\r
266   *   - Added new KeyboardMouseMultiReport Device ClassDriver demo\r
267   *   - Added new VirtualSerialMassStorage Device ClassDriver demo\r
268   *   - Added HID class bootloader, compatible with a modified version of the command line Teensy loader from PJRC.com\r
269   *   - Added LED flashing to the CDC and DFU class bootloaders to indicate when they are running\r
270   *\r
271   *  <b>Changed:</b>\r
272   *  - Core:\r
273   *   - Unordered Endpoint/Pipe configuration is now allowed once again by default via the previous reconfig workaround\r
274   *   - Refactored Host mode Class Driver *_Host_ConfigurePipes() routines to be more space efficient when compiled\r
275   *   - Added new *_ENUMERROR_PipeConfigurationFailed error codes for the *_Host_ConfigurePipes() routines\r
276   *   - The USARTStream global is now public and documented in the SerialStream module, allowing for the serial USART\r
277   *     stream to be accessed via its handle rather than via the implicit stdout and stdin streams\r
278   *   - The FAST_STREAM_TRANSFERS compile time option has been removed due to lack of use and low cost/benefit ratio\r
279   *   - Altered all endpoint/pipe stream transfers so that the new BytesProcessed parameter now points to a location\r
280   *     where the number of bytes in the transfer that have been completed can be stored (or NULL if entire transaction\r
281   *     should be performed in one chunk)\r
282   *   - The NO_STREAM_CALLBACKS compile time option has now been removed due to the new partial stream transfer feature\r
283   *   - Changed over all project and demo HID report descriptors to use the new HID report item macros\r
284   *   - Moved the HIDParser.c source file to the LUFA/Drivers/USB/Class/Common/ directory from the LUFA/Drivers/USB/Class/Host/\r
285   *   - Added support to the HID parser for extended USAGE items that contain the usage page as well as the usage index\r
286   *   - Removed the SerialStream driver, rolled functionality into the regular Serial peripheral driver via the new\r
287   *     Serial_CreateStream() and Serial_CreateBlockingStream() functions\r
288   *   - Renamed the low level Serial byte send/receive functions, to be consistent with the CDC class driver byte functions\r
289   *   - Altered the behaviour of the serial byte reception function so that is is non-blocking, and now returns a negative\r
290   *     value if no character is received (to remain consistent with the CDC class driver byte reception routines)\r
291   *   - Renamed the PRNT_Host_SendString(), CDC_Host_SendString() and CDC_Device_SendString() functions to *_SendData(), and\r
292   *     added new versions of the *_SendString() routines that expect a null terminated string instead\r
293   *   - Renamed all driver termination *_ShutDown() functions to the more logical name *_Disable()\r
294   *   - Reduced latency for executing the Start-Of-Frame events (if enabled in the user application)\r
295   *   - Removed Pipe_ClearErrorFlags(), pipe error flags are now automatically cleared when Pipe_ClearError() is called\r
296   *   - Endpoint_ResetFIFO() renamed to Endpoint_ResetEndpoint(), to be consistent with the Pipe_ResetPipe() function name\r
297   *   - Implemented on-demand PLL clock generation for the U4, U6 and U7 series USB AVRs when automatic PLL mode is specified\r
298   *   - F_CLOCK changed to F_USB to be more descriptive, and applicable on future architecture ports\r
299   *   - Renamed all low level Endpoint_Read_*, Endpoint_Write_* and Endpoint_Discard_* functions to use the number of bits instead of\r
300   *     a symbolic size (Byte, Word, DWord) so that the function names are applicable and correct across all architectures\r
301   *   - Renamed all low level Pipe_Read_*, Pipe_Write_* and Pipe_Discard_* functions to use the number of bits instead of\r
302   *     a symbolic size (Byte, Word, DWord) so that the function names are applicable and correct across all architectures\r
303   *   - Separated out board drivers by architecture in the library internals for better organisation\r
304   *  - Library Applications:\r
305   *   - Changed the XPLAINBridge software UART to use the regular timer CTC mode instead of the alternative CTC mode\r
306   *     via the Input Capture register, to reduce user confusion\r
307   *   - Combined page and word ISP programming mode code in the AVRISP-MKII clone project to reduce compiled size and\r
308   *     increase maintainability of the code\r
309   *   - Changed over library projects to use the new general ring buffer library driver module\r
310   *   - Added new high level TWI packet read/write commands, altered behaviour of the TWI_StartTransmission() function\r
311   *   - Changed TempDataLogger project's DS1307 driver to simplify the function interface and prevent a possible race condition\r
312   *   - Changed AVRISP-MKII project to use the Watchdog interrupt for command timeouts, to reduce CPU usage and free timer 0\r
313   *     for other uses\r
314   *   - Updated the software USART code in the XPLAIN Bridge application so that the incoming bits are sampled at their mid-point\r
315   *     instead of starting point, to give maximum reliability (thanks to Anton Staaf)\r
316   *\r
317   *  <b>Fixed:</b>\r
318   *  - Core:\r
319   *   - Fixed broken USBFOO board drivers due to missing BOARD_USBFOO define\r
320   *   - Fixed HID host class driver incorrectly binding to HID devices that do not have an OUT endpoint\r
321   *   - Fixed incorrect definition of the HID_KEYBOARD_SC_D constant in the HID class driver (thanks to Opendous Inc.)\r
322   *   - Fixed incorrect definition of the HID_KEYBOARD_SC_RIGHT_ARROW constant in the HID class driver (thanks to Joby Taffey)\r
323   *   - Fixed incorrect endpoint initialisation order in the several device demos (thanks to Rick Drolet)\r
324   *   - Fixed inverted Minimus board LEDs\r
325   *   - Fixed incorrect byte ordering in the Audio_Device_WriteSample24 function (thanks to WZab)\r
326   *   - Fixed several functions in the Host mode Still Image Class driver returning an error code from the incorrect\r
327   *     error code enum (thanks to Daniel Seibert)\r
328   *   - Fixed ReportID not being removed from the feature/out report data array in the HID class driver when Report IDs are used\r
329   *   - Fixed incorrect BUTTONS_BUTTON1 definition for the Minimus board\r
330   *   - Fixed Still Image Host class driver exiting the descriptor search routine prematurely if the data pipes (but not event pipe)\r
331   *     is found\r
332   *   - Fixed missing call to Pipe_SetInfiniteINRequests() in the Pipe_ConfigurePipe() routine\r
333   *   - Fixed Remote Wakeup broken on the AVRs due to the mechanism only operating when the SUSPI bit is set (thanks to Holger Steinhaus)\r
334   *   - Fixed possible invalid program execution when in host mode if corrupt descriptor lengths are supplied by the attached device\r
335   *  - Library Applications:\r
336   *   - Fixed Benito project discarding incoming data from the USB virtual serial port when the USART is busy\r
337   *   - Fixed broken DFU bootloader, added XPLAIN support for bootloader start when XCK jumpered to ground\r
338   *   - Fixed broken HID_REQ_GetReport request handler in the Low Level GenericHID demo\r
339   *   - Fixed possible lost data in the XPLAINBridge, USBtoSerial and Benito projects when the host exceeds the packet\r
340   *     timeout period on received packets as set by USB_STREAM_TIMEOUT_MS (thanks to Justin Rajewski)\r
341   *   - Fixed possible programming problem in the AVRISP-MKII clone project when programming specific patterns into a target\r
342   *     memory space that is only byte (not page) addressable\r
343   *   - Fixed errors in the incomplete Test and Measurement device demo preventing proper operation (thanks to Pavel Plotnikov)\r
344   *   - Fixed programming errors in the AVRISP-MKII project when the programming packet is a round multiple of the endpoint bank\r
345   *     size under avrdude (thanks to Steffan Woltjer)\r
346   *\r
347   *\r
348   *  \section Sec_ChangeLog101122 Version 101122\r
349   *  <b>New:</b>\r
350   *  - Core:\r
351   *    - Added new SCSI_ASENSE_NOT_READY_TO_READY_CHANGE constant to the Mass Storage class driver, to indicate when a previously\r
352   *      not ready removable medium has now become ready for the host's use (thanks to Martin Degelsegger)\r
353   *    - Moved the Pipe and Endpoint stream related code to two new USB library core source files EndpointStream.c and PipeStream.c\r
354   *    - Added new USB_Device_GetFrameNumber() and USB_Host_GetFrameNumber() functions to retrieve the current USB frame number\r
355   *    - Added new USB_Host_EnableSOFEvents(), USB_Host_DisableSOFEvents() and EVENT_USB_Host_StartOfFrame() for the user application\r
356   *      handling of USB Start of Frame events while in USB Host mode\r
357   *    - Added new PRNT_Host_BytesReceived(), PRNT_Host_ReceiveByte(), PRNT_Host_SendByte() and PRNT_Host_Flush() functions to the\r
358   *      Print Host Class driver\r
359   *    - Added class specific descriptor alternative struct type defines with standard USB-IF element naming\r
360   *    - Added new project makefile template to the library and moved board driver stub files into in a new "CodeTemplates" directory\r
361   *    - Added board hardware driver support for the Adafruit U4 breakout board\r
362   *    - Added board hardware driver support for the Arduino Uno development board\r
363   *    - Added board hardware driver support for the Blackcat USB JTAG board (thanks to the PSGroove team)\r
364   *    - Added board hardware driver support for the Busware BUI development board\r
365   *    - Added board hardware driver support for the Busware CUL V3 868MHZ radio board (thanks to Dirk Tostmann)\r
366   *    - Added board hardware driver support for the Kernel Concepts USBFOO development board\r
367   *    - Added board hardware driver support for the Linnix UDIP development board\r
368   *    - Added board hardware driver support for the Olimex AVR-USB-162 development board (thanks to Steve Fawcett)\r
369   *    - Added board hardware driver support for the Maximus board (thanks to the PSGroove team)\r
370   *    - Added board hardware driver support for the Microsin AVR-USB162 breakout board\r
371   *    - Added board hardware driver support for the Minimus board (thanks to the PSGroove team)\r
372   *    - Added new NO_CLASS_DRIVER_AUTOFLUSH compile time option to disable automatic flushing of interfaces when the USB management\r
373   *      tasks for each driver is called\r
374   *    - Added standard keyboard HID report scan-code defines (thanks to Laszlo Monda)\r
375   *    - Added new Pipe_GetBusyBanks(), Endpoint_GetBusyBanks() and Endpoint_AbortPendingIN() functions\r
376   *  - Library Applications:\r
377   *    - Added default test tone generation mode to the Device mode AudioInput demos\r
378   *    - Added new NO_BLOCK_SUPPORT, NO_EEPROM_BYTE_SUPPORT, NO_FLASH_BYTE_SUPPORT and NO_LOCK_BYTE_WRITE_SUPPORT compile time options to the\r
379   *      CDC class bootloader\r
380   *    - Added new XCK_RESCUE_CLOCK_ENABLE compile time option to the AVRISP-MKII clone programmer project (thanks to Tom Light)\r
381   *\r
382   *  <b>Changed:</b>\r
383   *  - Core:\r
384   *    - Removed complicated logic for the Endpoint_ConfigureEndpoint() function to use inlined or function called versions\r
385   *      depending of if the given bank size is a compile time constant, as the compiler does a better job of optimizing\r
386   *      with basic code\r
387   *    - Changed the signature of the CALLBACK_USB_GetDescriptor() callback function so that the descriptor pointer is const, to remove\r
388   *      the need for extra casting inside the callback (thanks to Jonathan Kollasch)\r
389   *    - Reduced HOST_DEVICE_SETTLE_DELAY_MS to 1000ms down from 1500ms to improve device compatibility while in USB Host mode\r
390   *    - Removed the EVENT_USB_InitFailure() event, not specifying a USB mode correctly now defaults to UID selection mode\r
391   *    - Renamed and moved class driver common constant definitions to make the naming scheme more uniform\r
392   *    - Moved the USB mode specifier constants into a new enum, so that they are semantically related to one another\r
393   *    - Renamed ENDPOINT_DOUBLEBANK_SUPPORTED() to ENDPOINT_BANKS_SUPPORTED() and changed it to return the maximum number of supported banks for\r
394   *      the given endpoint\r
395   *    - Better algorithm to extract and convert the internal device serial number into a string descriptor (if present)\r
396   *    - All USB class drivers are now automatically included when LUFA/Drivers/USB.h is included, and no longer need to be separately included\r
397   *    - The MIDI class drivers now automatically flushes the MIDI interface when the MIDI class driver's USBTask() function is called\r
398   *    - Renamed the EVENT_USB_Device_UnhandledControlRequest() event to EVENT_USB_Device_ControlRequest() as it is now fired before the library\r
399   *      request handlers, not afterwards\r
400   *  - Library Applications:\r
401   *    - Changed over all device demos to use a clearer algorithm for the configuring of the application's endpoints\r
402   *    - Added missing DataflashManager_CheckDataflashOperation() function to the MassStorageKeyboard demo, removed redundant\r
403   *      SCSI_Codes.h file as these values are part of the MassStorage Class Driver\r
404   *    - Added compile time error to the AVRISP-MKII project when built for the U4 chips, as the default VTARGET detection ADC channel\r
405   *      does not exist on these chips (thanks to Marco)\r
406   *    - Changed all Device mode LowLevel demos and Device Class drivers so that the control request is acknowledged and any data\r
407   *      transferred as quickly as possible without any processing in between sections, so that long callbacks or event handlers will\r
408   *      not break communications with the host by exceeding the maximum control request stage timeout period\r
409   *    - Changed over all demos, drivers and internal functions to use the current frame number over the Start of Frame flag where possible\r
410   *      to free up the Start of Frame flag for interrupt use in the user application\r
411   *    - All project makefiles now correctly clean intermediate build files from assembly and C++ sources (thanks to Daniel Czigany)\r
412   *    - Changed default value for the reset polarity parameter in the AVRISP-MKII project so that it defaults to active low drive\r
413   *    - Changed configuration descriptor parser for all host mode projects and class drivers to ensure better compatibility with devices\r
414   *    - All LowLevel demos changed to use the constants and types defined in the USB class drivers\r
415   *    - Changed AudioInput and AudioOutput demos to reload the next sample via an interrupt rather than polling the sample timer\r
416   *    - Rescue clock of the AVRISP-MKII moved to the AVR's OCR1A pin, so that the clock can be generated at all times\r
417   *    - Changed ClassDriver MIDI demos to process all incoming events in a loop until the bank becomes empty rather than one at a time\r
418   *    - Changed LowLevel MIDI demos to only clear the incoming event bank once it has become empty to support packed event packets\r
419   *\r
420   *  <b>Fixed:</b>\r
421   *  - Core:\r
422   *    - Fixed USB_GetHIDReportItemInfo() function modifying the given report item's data when the report item does not exist\r
423   *      within the supplied report of a multiple report HID device\r
424   *    - Fixed critical pipe/endpoint memory allocation issue where the bank memory address space could be silently overlapped\r
425   *      in the USB controller if the endpoints or pipes were allocated in anything other than ascending order (thanks to Martin Degelsegger)\r
426   *    - Added LEDs_ToggleLEDs() function to several board LED drivers which were missing it (thanks to Andrei Krainev)\r
427   *    - Fixed SET FEATURE and CLEAR FEATURE control requests directed at an unconfigured endpoint causing request timeouts\r
428   *    - Fixed USB_Host_ClearPipeStall() incorrectly determining the endpoint direction from the currently selected pipe\r
429   *    - Fixed JTAG_DEBUG_POINT() and JTAG_DEBUG_BREAK() macros not compiling under pure C99 standards mode\r
430   *    - Fixed endpoint selection within the CALLBACK_HID_Device_CreateHIDReport() callback function causing broken GET REPORT requests\r
431   *    - Fixed incorrect command name for EEPROM memory programming in the makefile dfu-ee target\r
432   *    - Fixed incorrect LEDs_ChangeLEDs() function in the Benito board LED driver\r
433   *    - Fixed incorrect USB_DeviceState value when unconfiguring the device without an address set\r
434   *    - Fixed SPI driver not explicitly setting /SS and MISO pins as inputs when SPI_Init() is called\r
435   *    - Fixed random enumeration failure while in device mode due to interrupts causing the Set Address request to exceed maximum timings\r
436   *    - Fixed MIDI_Host_Flush() not aborting early when the specified MIDI host interface was not configured\r
437   *    - Fixed MIDI class driver send routines silently discarding packets if the endpoint or pipe is busy (thanks to Robin Green)\r
438   *  - Library Applications:\r
439   *    - Fixed MassStorage based demos and projects resetting the SCSI sense values before the command is executed, leading to\r
440   *      missed SCSI sense values when the host retrieves the sense key (thanks to Martin Degelsegger)\r
441   *    - Fixed USBtoSerial and Benito project SetLineEncoding calls failing if the USART is busy, due to the RX ISR delaying the control\r
442   *      request handler\r
443   *    - Fixed LowLevel PrinterHost demo not sending control requests to the attached printer with the correct printer interface wIndex value\r
444   *    - Fixed incorrect signature reported in the CDC class bootloader for the ATMEGA32U2\r
445   *    - Fixed BootloaderCDC project failing on some operating systems due to removed Line Encoding options (thanks to Alexey Belyaev)\r
446   *    - Fixed broken FLASH/EEPROM programming in the AVRISP-MKII clone project when writing in non-paged mode and the polling byte cannot be used\r
447   *    - Fixed ISR definition conflict in the XPLAIN bridge between the software UART and the AVRISP-MKII ISP modules\r
448   *    - Fixed USBtoSerial and XPLAINBridge demos discarding data from the PC if the send buffer becomes full\r
449   *    - Fixed broken input in the MagStripe reader project due to an incorrect HID report descriptor\r
450   *    - Fixed incorrect PollingIntervalMS values in the demo/project/bootloader endpoint descriptors (thanks to MCS Electronics)\r
451   *    - Fixed AVRISP-MKII clone project not starting the target's program automatically after exiting TPI programming mode\r
452   *\r
453   *\r
454   *  \section Sec_ChangeLog100807 Version 100807\r
455   *  <b>New:</b>\r
456   *  - Added new ADC_DisableChannel() function (thanks to Mich Davis)\r
457   *  - Added new VTARGET_REF_VOLTS and VTARGET_SCALE_FACTOR compile time defines to the AVRISP-MKII programmer project to set\r
458   *    the VTARGET reference voltage and scale factor\r
459   *  - Added new pgm_read_ptr() macro to Common.h for reading of pointers out of flash memory space\r
460   *  - Added new SWAPENDIAN_16() and SWAPENDIAN_32() macros to Common.h for statically initialized variables at compile time\r
461   *  - Added new Drivers/USB/LowLevel/Device.c file to house Device mode specific functions that are more complicated than simple macros\r
462   *  - Added new AVRStudio 4 project files for all library demos, projects and bootloaders\r
463   *  - Added ability to set the serial baud rate via the user's terminal in the XPLAINBridge project\r
464   *  - Added new LUFA module variables for the different source modules in the core library makefile to simplify project makefiles\r
465   *  - Added start of a new Test and Measurement class demo (thanks to Peter Lawrence)\r
466   *  - Added new SPI_ORDER_* data order masks to the SPI peripheral driver\r
467   *  - Added support to the AVRISP-MKII project for ISP speeds slower than 125KHz via a new software SPI driver\r
468   *  - Added support for the new button/LED on the latest model USBTINY-MKII\r
469   *\r
470   *  <b>Changed:</b>\r
471   *  - The RingBuff library code has been replaced in the XPLAINBridge, Benito and USBtoSerial projects with an ultra lightweight\r
472   *    ring buffer to help improve the reliability of the projects\r
473   *  - The EEPROM stream read/write functions now use eeprom_update_byte() instead of eeprom_write_byte(), so that only\r
474   *    changed bytes are written to EEPROM to preserve its lifespan\r
475   *  - Changed over the AVRISP-MKII and TemperatureDataLogger projects to use eeprom_update_byte() when writing non-volatile\r
476   *    parameters to EEPROM to preserve its lifespan\r
477   *  - Removed unused line encoding data and control requests from the CDC Bootloader code, to save space\r
478   *  - Renamed SERIAL_STREAM_ASSERT() macro to STDOUT_ASSERT()\r
479   *  - The USB_Device_IsRemoteWakeupSent() and USB_Device_IsUSBSuspended() macros have been deleted, as they are now obsolete\r
480   *  - Rewrote the implementation of the SwapEndian_16() and SwapEndian_32() functions so that they compile down in most instances to\r
481   *    minimal loads and stores rather than complicated shifts\r
482   *  - The software UART in the XPLAINBridge has been largely altered to try to improve upon its performance and reliability\r
483   *  - The USBtoSerial and Benito projects now flushes received data via a flush timer, so that several bytes can be transmitted at once\r
484   *  - Removed the automated checking of event names in the demo, project and bootloader makefiles due to inconsistencies between the\r
485   *    behaviour of the command line tools used to perform the check on each platform\r
486   *  - Internal USB driver source files renamed and moved to ease future possible architecture ports\r
487   *  - All internal pseudo-function macros have been converted to true inline functions for type-safety and readability\r
488   *  - Changed LED indicator masks for the AVRISP-MKII project, so that there are defined roles for each LED\r
489   *  - Altered the CDC Device and Host Class drivers' receive byte routines, so that no data is indicated by the function returning a\r
490   *    negative value (thanks to Andreas Paulin)\r
491   *  - Added auto flushing of OUT data to the CDC Host Class driver's USBTask function to automatically flush the send pipe buffer\r
492   *\r
493   *  <b>Fixed:</b>\r
494   *  - Fixed AVRISP project sending a LOAD EXTENDED ADDRESS command to 128KB AVRs after programming or reading from\r
495   *    the last page of FLASH (thanks to Gerard Sexton)\r
496   *  - Fixed AVRISP project not sending a full erase-and-write EEPROM command to XMEGA targets when writing to the EEPROM\r
497   *    instead of the split write-only command (thanks to Tim Margush)\r
498   *  - Fixed RNDISEthernet demos crashing when calculating checksums for Ethernet/TCP packets of more than ~500 bytes due to\r
499   *    an overflow in the checksum calculation loop (thanks to Kevin Malec)\r
500   *  - Fixed XPLAINBridge project not correctly reading the XMEGA's supply voltage when reporting back to the host\r
501   *  - Fixed incorrect signature for the ATMEGA32U2 in the DFU bootloader (thanks to Axel Rohde)\r
502   *  - Fixed internal device serial not being accessible on the ATMEGAXXU2 AVRs (thanks to Axel Rohde)\r
503   *  - Fixed void pointer arithmetic in ConfigDescriptor.h breaking C++ compatibility (thanks to Michael Hennebry)\r
504   *  - Fixed broken PDI EEPROM Section Erase functionality in the AVRISP-MKII project\r
505   *  - Fixed USB_Device_SendRemoteWakeup() not working when the USB clock was frozen during USB bus suspend (thanks to Brian Dickman)\r
506   *  - Fixed occasional lockup of the AVRISP project due to the timeout extension code incorrectly extending the timeout in\r
507   *    PDI and TPI programming modes infinitely\r
508   *  - Fixed HID device class driver still using PrevReportINBuffer for GetReport control requests even when it has been\r
509   *    set to NULL by the user application (thanks to Axel Rohde)\r
510   *  - Fixed MIDI_Device_SendEventPacket() not correctly waiting for the endpoint to become ready (thanks to Robin Green)\r
511   *  - Fixed Benito and USBtoSerial projects not turning off the USART before reconfiguring it, which could cause incorrect\r
512   *    operation to occur (thanks to Bob Paddock)\r
513   *  - Fixed Serial peripheral driver not turning off the USART before reconfiguring it, which would cause incorrect operation\r
514   *    to occur (thanks to Bob Paddock)\r
515   *  - Fixed software application start command broken in the DFU class bootloader when dfu-programmer is used due to application\r
516   *    start address corruption\r
517   *\r
518   *\r
519   *  \section Sec_ChangeLog100513 Version 100513\r
520   *  <b>New:</b>\r
521   *  - Added incomplete MIDIToneGenerator project\r
522   *  - Added new Relay Controller Board project (thanks to OBinou)\r
523   *  - Added board hardware driver support for the Teensy, USBTINY MKII, Benito and JM-DB-U2 lines of third party USB AVR boards\r
524   *  - Added new ATTR_NO_INIT variable attribute for global variables that should not be automatically cleared on startup\r
525   *  - Added new ENDPOINT_*_BusSuspended error code to the Endpoint function, so that the stream functions early-abort if the bus\r
526   *    is suspended before or during a transfer\r
527   *  - Added new EVENT_CDC_Device_BreakSent() event and CDC_Host_SendBreak() function to the Device and Host CDC Class drivers\r
528   *  - Added ReportType parameter to the HID device class driver CALLBACK_HID_Device_ProcessHIDReport() function so that FEATURE\r
529   *    reports from the host to the device can be correctly processed\r
530   *  - Added ReportType parameter to the HID host class driver HID_Host_SendReportByID() function so that FEATURE reports can be\r
531   *    issued to the attached device\r
532   *\r
533   *  <b>Changed:</b>\r
534   *  - AVRISP programmer project now has a more robust timeout system\r
535   *  - Added a timeout value to the TWI_StartTransmission() function, within which the addressed device must respond\r
536   *  - Webserver project now uses the board LEDs to indicate the current IP configuration state\r
537   *  - Added ENABLE_TELNET_SERVER compile time option to the Webserver project to disable the TELNET server if desired\r
538   *  - Increased throughput of the USBtoSerial demo on systems that send multiple bytes per packet (thanks to Opendous Inc.)\r
539   *  - Double bank CDC endpoints in the XPLAIN Bridge project, re-enable JTAG once the mode selection pin has been sampled.\r
540   *  - Standardized the naming scheme given to configuration descriptor sub-elements in the Device mode demos, bootloaders\r
541   *    and projects\r
542   *  - All Class Driver Host mode demos now correctly set the board LEDs to READY once the enumeration process has completed\r
543   *  - Added LIBUSB_FILTERDRV_COMPAT compile time option to the AVRISP programmer project to make the code compatible with Windows\r
544   *    builds of avrdude at the expense of AVRStudio compatibility\r
545   *  - Removed two-step endpoint/pipe bank clear and switch sequence for smaller, faster endpoint/pipe code\r
546   *  - The USB_Init() function no longer calls sei() - the user is now responsible for enabling interrupts when they are ready\r
547   *    for them to be enabled (thanks to Andrei Krainev)\r
548   *  - The Audio_Device_IsSampleReceived() and Audio_Device_IsReadyForNextSample() functions are now inline, to reduce overhead\r
549   *  - Removed the cast to uint16_t on the set baud rate in the USBtoSerial project, so that the higher >1M baud rates can be\r
550   *    selected (thanks to Steffan Woltjer)\r
551   *  - Removed software PDI and TPI emulation from the AVRISP-MKII clone project as it was very buggy and slow - PDI and TPI must\r
552   *    now be implemented via separate programming headers\r
553   *  - The CDC class bootloader now uses a watchdog reset rather than a soft-reset when exited to ensure that all hardware is\r
554   *    properly reset to their defaults\r
555   *  - Device mode class driver callbacks are now fired before the control request status stage is sent to prevent the host from\r
556   *    timing out if another request is immediately fired and the device has a lengthy callback routine\r
557   *  - The TeensyHID bootloader has been removed, per request from Paul at PJRC\r
558   *  - The LIBUSB_FILTERDRV_COMPAT compile time option in the XPLAINBridge and AVRISP-MKII projects has been renamed\r
559   *    LIBUSB_DRIVER_COMPAT, as it applies to all software on all platforms using the libUSB driver\r
560   *\r
561   *  <b>Fixed:</b>\r
562   *  - Fixed possible device lockup when INTERRUPT_CONTROL_ENDPOINT is enabled and the control endpoint is not properly\r
563   *    selected when the ISR completes\r
564   *  - Fixed AVRISP-MKII clone project not correctly issuing LOAD EXTENDED ADDRESS commands when the extended address\r
565   *    boundary is crossed during programming or read back (thanks to Gerard Sexton)\r
566   *  - Fixed warnings when building the AVRISP-MKII clone project with the ENABLE_XPROG_PROTOCOL compile time option disabled\r
567   *  - Fixed software PDI/TPI programming mode in the AVRISP project not correctly toggling just the clock pin\r
568   *  - Fixed TWI_StartTransmission() corrupting the contents of the GPIOR0 register\r
569   *  - Fixed TWI driver not aborting when faced with no response after attempting to address a device on the bus\r
570   *  - Fixed ADC routines not correctly returning the last result when multiple channels were read\r
571   *  - Fixed ADC routines failing to read the extended channels (Channels 8 to 13, Internal Temperature Sensor) on the\r
572   *    U4 series USB AVR parts\r
573   *  - Fixed LowLevel MassStorage demo broken on the U2 series USB AVRs due to unsupported double-banked endpoint modes used\r
574   *  - Fixed compilation error in the AudioInput demos when MICROPHONE_BIASED_TO_HALF_RAIL is defined (thanks to C. Scott Ananian)\r
575   *  - Fixed incorrect definition of HID_ALIGN_DATA() causing incorrect HID report item data alignment\r
576   *  - Fixed Still Image Host class driver not resetting the transaction ID when a new session is opened, fixed driver not sending\r
577   *    a valid session ID to the device\r
578   *  - Removed invalid dfu and flip related targets from the bootloaders - bootloaders can only be replaced with an external programmer\r
579   *  - Fixed Set/Clear Feature requests directed to a non-configured endpoint not returning a stall to the host\r
580   *  - Fixed HID Device Class Driver not allocating a temporary buffer when the host requests a report via the control endpoint and the\r
581   *    user has set the PrevReportINBuffer driver configuration element to NULL (thanks to Lars Noschinski)\r
582   *  - Fixed device state not being reset to DEVICE_STATE_Default if the host sets a 0x00 device address\r
583   *  - Fixed device not stalling configuration requests before the device's address has been set\r
584   *  - Fixed possibility of internal signature retrieval being corrupted if an interrupt occurs during a signature byte\r
585   *    read (thanks to Andrei Krainev)\r
586   *  - Fixed device state not being reset back to the default state if the host sets the address to 0\r
587   *  - Fixed Set Configuration requests not being stalled until the host has set the device's address\r
588   *  - Fixed Host mode HID class driver not sending the correct report type when HID_Host_SendReportByID() was called and the\r
589   *    HID_HOST_BOOT_PROTOCOL_ONLY compile time option is set\r
590   *  - Fixed INTERRUPT_CONTROL_ENDPOINT compile time option preventing other interrupts from occurring while the control endpoint\r
591   *    request is being processed, causing possible lockups if a USB interrupt occurs during a transfer\r
592   *  - Remove incorrect Abstract Call Management class specific descriptor from the CDC demos, bootloaders and projects\r
593   *\r
594   *\r
595   *  \section Sec_ChangeLog100219 Version 100219\r
596   *\r
597   *  <b>New:</b>\r
598   *  - Added TPI programming support for 6-pin ATTINY devices to the AVRISP programmer project (thanks to Tom Light)\r
599   *  - Added command timeout counter to the AVRISP project so that the device no longer freezes when incorrectly connected\r
600   *    to a target\r
601   *  - Added new TemperatureDataLogger application, a USB data logger which writes to the device's dataflash and appears to\r
602   *    the host as a standard Mass Storage device when inserted\r
603   *  - Added MIDI event packing support to the MIDI Device and Host mode Class drivers, allowing for multiple MIDI events to\r
604   *    sent or received in packed form in a single USB packet\r
605   *  - Added new MIDI send buffer flush routines to the MIDI Device and Host mode Class drivers, to flush packed events\r
606   *  - Added master mode hardware TWI driver for easy TWI peripheral control\r
607   *  - Added ADC MUX masks for the standard ADC input channels on all AVR models with an ADC, altered demos to use these masks\r
608   *    as on some models, the channel number is not identical to its single-ended ADC MUX mask\r
609   *  - New Webserver project, a RNDIS host USB webserver using the open source uIP TCP/IP network stack and FatFS library\r
610   *  - New BOARD value option BOARD_NONE (equivalent to not specifying BOARD) which will remove all board hardware drivers which\r
611   *    do not adversely affect the code operation (currently only the LEDs driver)\r
612   *  - Added keyboard modifier masks (HID_KEYBOARD_MODIFER_*) and LED report masks (KEYBOARD_LED_*) to the HID class driver and\r
613   *    Keyboard demos\r
614   *  - Added .5MHz recovery clock to the AVRISP programmer project when in ISP programming mode to correct mis-set fuses\r
615   *\r
616   *  <b>Changed:</b>\r
617   *  - Slowed down software USART carried PDI programming in the AVRISP project to prevent transmission errors\r
618   *  - Renamed the AVRISP project folder to AVRISP-MKII to reduce confusion\r
619   *  - Renamed the RESET_LINE_* makefile tokens in the AVRISP MKII Project to AUX_LINE_*, as they are not always used for target\r
620   *    reset\r
621   *  - Changed over the MassStorageKeyboard Class driver device demo to use Start of Frame events rather than a timer to keep track\r
622   *    of elapsed milliseconds\r
623   *  - Inlined currently unused (but standardized) maintenance functions in the Device and Host Class drivers to save space\r
624   *  - The XPLAINBridge project now selects between a USB to Serial bridge and a PDI programmer on startup, reading the JTAG port's\r
625   *    TDI pin to determine which mode to use\r
626   *  - Removed the stream example code from the Low Level VirtualSerial demos, as they were buggy and only served to add clutter\r
627   *\r
628   *  <b>Fixed:</b>\r
629   *  - Fixed AVRISP project not able to enter programming mode when ISP protocol is used\r
630   *  - Fixed AVRISP PDI race condition where the guard time between direction changes could be interpreted as a start bit\r
631   *  - Fixed ADC_IsReadingComplete() returning an inverted result\r
632   *  - Fixed blocking CDC streams not aborting when the host is disconnected\r
633   *  - Fixed XPLAIN board Dataflash driver broken due to incorrect preprocessor commands\r
634   *  - Fixed inverted XPLAIN LED driver output (LED turned on when it was supposed to be turned off, and vice-versa)\r
635   *  - Fixed Class Driver struct interface numbers in the KeyboardMouse and VirtualSerialMouse demos (thanks to Renaud Cerrato)\r
636   *  - Fixed invalid USB controller PLL prescaler values for the ATMEGAxxU2 controllers\r
637   *  - Fixed lack of support for the ATMEGA32U2 in the DFU and CDC class bootloaders\r
638   *  - Fixed Benito project not resetting the target AVR automatically when programming has completed\r
639   *  - Fixed DFU bootloader programming not discarding the correct number of filler bytes from the host when non-aligned programming\r
640   *    ranges are specified (thanks to Thomas Bleeker)\r
641   *  - Fixed CDC and RNDIS host demos and class drivers - bidirectional endpoints should use two separate pipes, not one half-duplex pipe\r
642   *  - Fixed Pipe_IsEndpointBound() not taking the endpoint's direction into account\r
643   *  - Fixed EEPROM and FLASH ISP programming in the AVRISP project\r
644   *  - Fixed incorrect values of USB_CONFIG_ATTR_SELFPOWERED and USB_CONFIG_ATTR_REMOTEWAKEUP tokens (thanks to Claus Christensen)\r
645   *  - Fixed SerialStream driver blocking while waiting for characters to be received instead of returning EOF\r
646   *  - Fixed SerialStream driver not setting stdin to the created serial stream (thanks to Mike Alexander)\r
647   *  - Fixed USB_GetHIDReportSize() returning the number of bits in the specified report instead of bytes\r
648   *  - Fixed AVRISP project not extending the command delay after each successful page/word/byte program\r
649   *  - Fixed accuracy of the SERIAL_UBBRVAL() and SERIAL_2X_UBBRVAL() macros for higher baud rates (thanks to Renaud Cerrato)\r
650   *\r
651   *\r
652   *  \section Sec_ChangeLog091223 Version 091223\r
653   *\r
654   *  <b>New:</b>\r
655   *  - Added activity LED indicators to the AVRISP project to indicate when the device is busy processing a command\r
656   *  - The USB target family and allowable USB mode tokens are now public and documented (USB_CAN_BE_*, USB_SERIES_*_AVR)\r
657   *  - Added new XPLAIN USB to Serial Bridge project (thanks to John Steggall for initial proof-of-concept, David Prentice\r
658   *    and Peter Danneger for revised software USART code)\r
659   *  - Added new RNDIS Ethernet Host LowLevel demo\r
660   *  - Added new RNDIS Ethernet Host Class Driver\r
661   *  - Added new RNDIS Ethernet Host ClassDriver demo\r
662   *  - Added CDC_Host_Flush() function to the CDC Host Class driver to flush sent data to the attached device\r
663   *  - Added PDI programming support for XMEGA devices to the AVRISP programmer project (thanks to Justin Mattair)\r
664   *  - Added support for the XPLAIN board Dataflash, with new XPLAIN_REV1 board target for the different dataflash used\r
665   *    on the first revision boards compared to the one mounted on later revisions\r
666   *  - Added new HID_ALIGN_DATA() macro to return the pre-retrieved value of a HID report item, left-aligned to a given datatype\r
667   *  - Added new PreviousValue to the HID Report Parser report item structure, for easy monitoring of previous report item values\r
668   *  - Added new EVK527 board target\r
669   *  - Added new USB_Host_GetDeviceStringDescriptor() convenience function\r
670   *  - Added new LEDNotification project to the library, to give a visual LED notification on new events from the host\r
671   *  - Added new NO_DEVICE_REMOTE_WAKEUP and NO_DEVICE_SELF_POWER compile time options\r
672   *\r
673   *  <b>Changed:</b>\r
674   *  - Removed code in the Keyboard demos to send zeroed reports between two reports with differing numbers of key codes\r
675   *    as this relied on non-standard OS driver behaviour to repeat key groups\r
676   *  - The SCSI_Request_Sense_Response_t and SCSI_Inquiry_Response_t type defines are now part of the Mass Storage Class\r
677   *    driver common defines, rather than being defined in the Host mode Class driver section only\r
678   *  - The USB_MODE_HOST token is now defined even when host mode is not available\r
679   *  - The CALLBACK_HID_Device_CreateHIDReport() HID Device Class driver callback now has a new ReportType parameter to\r
680   *    indicate the report type to generate\r
681   *  - All Class Drivers now return false or the "DeviceDisconnected" error code of their respective error enums when a function\r
682   *    is called when no host/device is connected where possible\r
683   *  - The HOST_SENDCONTROL_DeviceDisconnect enum value has been renamed to HOST_SENDCONTROL_DeviceDisconnected to be in line\r
684   *    with the rest of the library error codes\r
685   *  - Make MIDI device demos also turn off the on board LEDs if MIDI Note On messages are sent with a velocity of zero,\r
686   *    which some devices use instead of Note Off messages (thanks to Robin Green)\r
687   *  - The CDC demos are now named "VirtualSerial" instead to indicate the demos' function rather than its implemented USB class,\r
688   *    to reduce confusion and to be in line with the rest of the LUFA demos\r
689   *  - The SImage_Host_SendBlockHeader() and SImage_Host_ReceiveBlockHeader() Still Image Host Class driver functions are now public\r
690   *\r
691   *  <b>Fixed:</b>\r
692   *  - Added missing CDC_Host_CreateBlockingStream() function code to the CDC Host Class driver\r
693   *  - Fixed incorrect values for REPORT_ITEM_TYPE_* enum values causing corrupt data in the HID Host Parser\r
694   *  - Fixed misnamed SI_Host_USBTask() and SI_Host_ConfigurePipes() functions\r
695   *  - Fixed broken USB_GetNextDescriptor() function causing the descriptor to jump ahead double the expected amount\r
696   *  - Fixed Pipe_IsEndpointBound() not masking the given Endpoint Address against PIPE_EPNUM_MASK\r
697   *  - Fixed host state machine not enabling Auto VBUS mode when HOST_DEVICE_SETTLE_DELAY_MS is set to zero\r
698   *  - Fixed misnamed Pipe_SetPipeToken() macro for setting a pipe's direction\r
699   *  - Fixed CDCHost failing on devices with bidirectional endpoints\r
700   *  - Fixed USB driver failing to define the PLL prescaler mask for the ATMEGA8U2 and ATMEGA16U2\r
701   *  - Fixed HID Parser not distributing the Usage Min and Usage Max values across an array of report items\r
702   *  - Fixed Mass Storage Host Class driver and Low Level demo not clearing the error condition if an attached device returns a\r
703   *    STALL to a GET MAX LUN request (thanks to Martin Luxen)\r
704   *  - Fixed TeensyHID bootloader not properly shutting down the USB interface to trigger a disconnection on the host before resetting\r
705   *  - Fixed MassStorageHost Class driver demo not having USB_STREAM_TIMEOUT_MS compile time option set properly to prevent slow\r
706   *    devices from timing out the data pipes\r
707   *  - Fixed the definition of the Endpoint_BytesInEndpoint() macro for the U4 series AVR parts\r
708   *  - Fixed MIDI host Class driver MIDI_Host_SendEventPacket() routine not properly checking for Pipe ready before writing\r
709   *  - Fixed use of deprecated struct initializers, removed library unused parameter warnings when compiled with -Wextra enabled\r
710   *  - Fixed Still Image Host Class driver truncating the PIMA response code (thanks to Daniel Seibert)\r
711   *  - Fixed USB_CurrentMode not being reset to USB_MODE_NONE when the USB interface is shut down and both Host and Device modes can be\r
712   *    used (thanks to Daniel Levy)\r
713   *  - Fixed TeensyHID bootloader not enumerating to the host correctly (thanks to Clint Fisher)\r
714   *  - Fixed AVRISP project timeouts not checking for the correct timeout period (thanks to Carl Ott)\r
715   *  - Fixed STK525 Dataflash driver using incorrect bit-shifting for Dataflash addresses (thanks to Tim Mitchell)\r
716   *\r
717   *\r
718   *  \section Sec_ChangeLog091122 Version 091122\r
719   *\r
720   *  <b>New:</b>\r
721   *  - Added new Dual Role Keyboard/Mouse demo\r
722   *  - Added new HID_HOST_BOOT_PROTOCOL_ONLY compile time token to reduce the size of the HID Host Class driver when\r
723   *    Report protocol is not needed\r
724   *  - Added new MIDI LowLevel and ClassDriver Host demo, add new MIDI Host Class driver\r
725   *  - Added new CDC/Mouse ClassDriver device demo\r
726   *  - Added new Joystick Host ClassDriver and LowLevel demos\r
727   *  - Added new Printer Host mode Class driver\r
728   *  - Added new Printer Host mode ClassDriver demo\r
729   *  - Added optional support for double banked endpoints and pipes in the Device and Host mode Class drivers\r
730   *  - Added new stream creation function to the CDC Class drivers, to easily make standard I/O streams from CDC Class driver instances\r
731   *\r
732   *  <b>Changed:</b>\r
733   *  - Removed mostly useless "TestApp" demo, as it was mainly useful only for checking for syntax errors in the library\r
734   *  - MIDI device demos now receive MIDI events from the host and display note ON messages via the board LEDs\r
735   *  - Cleanups to the Device mode Mass Storage demo application SCSI routines\r
736   *  - Changed Audio Class driver sample read/write functions to be inline, to reduce the number of cycles needed to transfer\r
737   *    samples to and from the device (allowing more time for sample processing and output)\r
738   *  - Audio class Device mode demos now work at both 16MHz and 8MHz, rather than just at 8MHz\r
739   *  - The previous USBtoSerial demo has been moved into the projects directory, as it was just a modified CDC demo\r
740   *  - The Endpoint/Pipe functions now use the const qualifier on the input buffer\r
741   *  - Changed the CALLBACK_HIDParser_FilterHIDReportItem() callback to pass a HID_ReportItem_t rather than just the current\r
742   *    item's attributes, to expose more information on the item (including it's type, collection path, etc.)\r
743   *  - Changed MouseHostWithParser demos to check that the report items have a Mouse usage collection as a parent at some point,\r
744   *    to prevent Joysticks from enumerating with the demo\r
745   *  - Corrected the name of the misnamed USB_GetDeviceConfigDescriptor() function to USB_Host_GetDeviceConfigDescriptor().\r
746   *  - Keyboard LowLevel/ClassDriver demos now support multiple simultaneous key presses (up to 6) per report\r
747   *\r
748   *  <b>Fixed:</b>\r
749   *  - Fixed PrinterHost demo returning invalid Device ID data when the attached device does not have a\r
750   *    device ID (thanks to Andrei Krainev)\r
751   *  - Changed LUFA_VERSION_INTEGER define to use BCD values, to make comparisons easier\r
752   *  - Fixed issue in the HID Host class driver's HID_Host_SendReportByID() routine using the incorrect mode (control/pipe)\r
753   *    to send report to the attached device\r
754   *  - Fixed ClassDriver AudioOutput device demo not selecting an audio output mode\r
755   *  - Fixed incorrect SampleFrequencyType value in the AudioInput and AudioOutput ClassDriver demos' descriptors\r
756   *  - Fixed incorrect event name rule in demo/project/bootloader makefiles\r
757   *  - Fixed HID device class driver not reselecting the correct endpoint once the user callback routines have been called\r
758   *  - Corrected HID descriptor in the Joystick Device demos - buttons should be placed outside the pointer collection\r
759   *  - Fixed HID report parser collection paths invalid due to misplaced semicolon in the free path item search loop\r
760   *  - Fixed HID host Class driver report send/receive report broken when issued through the control pipe\r
761   *  - Fixed HOST_STATE_AS_GPIOR compile time option being ignored when in host mode (thanks to David Lyons)\r
762   *  - Fixed LowLevel Keyboard demo not saving the issues report only after it has been sent to the host\r
763   *  - Fixed Endpoint_Write_Control_Stream_* functions not sending a terminating IN when given data Length is zero\r
764   *\r
765   *\r
766   *  \section Sec_ChangeLog090924 Version 090924\r
767   *\r
768   *  <b>New:</b>\r
769   *  - Added new host mode class drivers and matching demos to the library for rapid application development\r
770   *  - Added flag to the HID report parser to indicate if a device has multiple reports\r
771   *  - Added new EVENT_USB_Device_StartOfFrame() event, controlled by the new USB_Device_EnableSOFEvents() and\r
772   *    USB_Device_DisableSOFEvents() macros to give bus-synchronized millisecond interrupts when in USB device mode\r
773   *  - Added new Endpoint_SetEndpointDirection() macro for bidirectional endpoints\r
774   *  - Added new AVRISP project, a LUFA powered clone of the Atmel AVRISP-MKII programmer\r
775   *  - Added ShutDown() functions for all hardware peripheral drivers, so that peripherals can be turned off after use\r
776   *  - Added new CDC_Device_Flush() command to the device mode CDC Class driver to flush Device->Host data\r
777   *  - Added extra masks to the SPI driver, changed SPI_Init() so that the clock polarity and sample modes can be set\r
778   *  - Added new callback to the HID report parser, so that the user application can filter only the items it is interested\r
779   *    in to be stored into the HIDReportInfo structure to save RAM\r
780   *  - Added support for the officially recommended external peripheral layout for the BUMBLEB board (thanks to Dave Fletcher)\r
781   *  - Added new Pipe_IsFrozen() macro to determine if the currently selected pipe is frozen\r
782   *  - Added new USB_GetHIDReportSize() function to the HID report parser to retrieve the size of a given report by its ID\r
783   *  - Added new combined Mass Storage and Keyboard demo (thanks to Matthias Hullin)\r
784   *\r
785   *  <b>Changed:</b>\r
786   *  - SetIdle requests to the HID device driver with a 0 idle period (send changes only) now only affect the requested\r
787   *    HID interface within the device, not all HID interfaces\r
788   *  - Added explicit attribute masks to the device mode demos' descriptors\r
789   *  - Added return values to the CDC and MIDI class driver transmit functions\r
790   *  - Optimized Endpoint_Read_Word_* and Pipe_Read_Word_* macros to reduce compiled size\r
791   *  - Added non-null function parameter pointer restrictions to USB Class drivers to improve user code reliability\r
792   *  - Added new "Common" section to the class drivers, to hold all mode-independent definitions for clarity\r
793   *  - Moved SCSI command/sense constants into the Mass Storage Class driver, instead of the user-code\r
794   *  - Altered the SCSI commands in the LowLevel Mass Storage Host to save on FLASH space by reducing function calls\r
795   *  - Changed the parameters and behaviour of the USB_GetDeviceConfigDescriptor() function so that it now performs size checks\r
796   *    and data validations internally, to simplify user code\r
797   *  - Changed HIDParser to only zero out important values in the Parsed HID Report Item Information structure to save cycles\r
798   *  - The HID report parser now always processed FEATURE items - HID_ENABLE_FEATURE_PROCESSING token now has no effect\r
799   *  - The HID report parser now always ignores constant-data items, HID_INCLUDE_CONSTANT_DATA_ITEMS token now has no effect\r
800   *  - The Benito Programmer project now has its own unique VID/PID pair allocated from the Atmel donated LUFA VID/PID pool\r
801   *  - Add in new invalid event hook check targets to project makefiles to produce compilation errors when invalid event names\r
802   *    are used in a project\r
803   *  - The HID Report Parser now gives information on the total length of each report within a HID interface\r
804   *  - The USE_NONSTANDARD_DESCRIPTOR_NAMES compile time token has been removed - there are now separate USB_Descriptor_* and\r
805   *    USB_StdDescriptor_* structures for both the LUFA and standardized element naming conventions so both may be used\r
806   *\r
807   *  <b>Fixed:</b>\r
808   *  - Fixed possible lockup in the CDC device class driver, when the host sends data that is a multiple of the\r
809   *    endpoint's bank\r
810   *  - Fixed swapped parameters in the HID state memory copy call while processing a HID PUSH item in the HID report parser\r
811   *  - Fixed memory corruption HID report parser when too many COLLECTION or PUSH items were processed\r
812   *  - Fixed HID report parser not resetting the FEATURE item count when a REPORT ID item is encountered\r
813   *  - Fixed USBtoSerial demos not reading in UDR1 when the USART receives data but the USB interface is not enumerated,\r
814   *    causing continuous USART receive interrupts\r
815   *  - Fixed misspelled event name in the Class driver USBtoSerial demo, preventing correct operation\r
816   *  - Fixed invalid data being returned when a GetStatus request is issued in Device mode with an unhandled data recipient\r
817   *  - Added hardware USART receive interrupt and software buffering to the Benito project to ensure received data is not\r
818   *    missed or corrupted\r
819   *  - Fixed Device mode HID Class driver always sending IN packets, even when nothing to report\r
820   *  - Fixed Device mode HID Class driver not explicitly initializing the ReportSize parameter to zero before calling callback\r
821   *    routine, so that ignored callbacks don't cause incorrect data to be sent\r
822   *  - Fixed StillImageHost not correctly freezing and unfreezing data pipes while waiting for a response block header\r
823   *  - Fixed error in the PrinterHost demo preventing the full page data from being sent to the attached device (thanks to John Andrews)\r
824   *  - Fixed CDC based demos and projects' INF driver files under 64 bit versions of Windows (thanks to Ronny Hanson, Thomas Bleeker)\r
825   *  - Re-add in missing flip, flip-ee, dfu and dfu-ee targets to project makefiles (thanks to Opendous Inc.)\r
826   *  - Fix allowable F_CPU values comment in project makefiles to more accurately reflect the allowable values on the USB AVRs\r
827   *  - Fixed DFU and CDC class bootloaders on the series 2 USB AVRs, corrected invalid signatures, added support for the new\r
828   *    ATMEGAxx2 series 2 variant AVRs to the DFU bootloader\r
829   *  - Fixed Low Level USBtoSerial demo not storing received characters (thanks to Michael Cooper)\r
830   *  - Fixed MIDI Device Class driver not sending/receiving MIDI packets of the correct size (thanks to Thomas Bleeker)\r
831   *\r
832   *\r
833   *  \section Sec_ChangeLog090810 Version 090810\r
834   *\r
835   *  <b>New:</b>\r
836   *  - Added new device class drivers and matching demos to the library for rapid application development\r
837   *  - Added new PrinterHost demo (thanks to John Andrews)\r
838   *  - Added USB Missile Launcher project, submitted by Dave Fletcher\r
839   *  - Added new Benito Arduino Programmer project\r
840   *  - Added incomplete device and host mode demos for later enhancement\r
841   *  - Updated MassStorage device block write routines to use ping-pong Dataflash buffering to increase throughput by around 30%\r
842   *  - Error status LEDs shown when device endpoint configuration fails to complete in all demos and projects\r
843   *  - Added new USB_Host_SetDeviceConfiguration() convenience function for easy configuration selection of devices while in USB\r
844   *    host mode\r
845   *  - Added new USB_Host_ClearPipeStall() convenience function to clear a stall condition on an attached device's endpoint\r
846   *  - Added new USB_Host_GetDeviceDescriptor() convenience function to retrieve the attached device's Device descriptor\r
847   *  - Added new Endpoint_ClearStatusStage() convenience function to assist with the status stages of control transfers\r
848   *  - Added new USE_INTERNAL_SERIAL define for using the unique serial numbers in some AVR models as the USB device's serial number,\r
849   *    added NO_INTERNAL_SERIAL compile time option to turn off new serial number reading code\r
850   *  - Added new DATAFLASH_CHIP_MASK() macro to the Dataflash driver, which returns the Dataflash select mask for the given chip index\r
851   *  - Added new HOST_STATE_WaitForDeviceRemoval host state machine state for non-blocking disabling of device communications until the\r
852   *    device has been removed (for use when an error occurs or communications with the device have completed)\r
853   *  - Added new FAST_STREAM_TRANSFERS compile time option for faster stream transfers via multiple bytes copied per stream loop\r
854   *  - Added stdio stream demo code to the CDC device demos, to show how to create standard streams out of the virtual serial ports\r
855   *  - Added new EEPROM and FLASH buffer versions of the Endpoint and Pipe stream functions\r
856   *  - Added new USE_FLASH_DESCRIPTORS and FIXED_NUM_CONFIGURATIONS compile time options\r
857   *  - Added support for the new ATMEGA32U2, ATMEGA16U2 and ATMEGA8U2 AVR models\r
858   *  - Added new USB_DeviceState variable to keep track of the current Device mode USB state\r
859   *  - Added new LEDs_ToggleLEDs() function to the LEDs driver\r
860   *  - Added new Pipe_BoundEndpointNumber() and Pipe_IsEndpointBound() functions\r
861   *  - Added new DEVICE_STATE_AS_GPIOR and HOST_STATE_AS_GPIOR compile time options\r
862   *  - Added 404 Not Found errors to the webserver in the RNDIS demos to indicate invalid URLs\r
863   *\r
864   *  <b>Changed:</b>\r
865   *  - Deprecated pseudo-scheduler and removed dynamic memory allocator from the library (first no longer needed and second unused)\r
866   *  - The device-mode CALLBACK_USB_GetDescriptor() function now has an extra parameter so that the memory space in which the requested\r
867   *    descriptor is located can be specified. This means that descriptors can now be located in multiple memory spaces within a device.\r
868   *  - Removed vague USB_IsConnected global - test USB_DeviceState or USB_HostState explicitly to gain previous functionality\r
869   *  - Removed USB_IsSuspended global - test USB_DeviceState against DEVICE_STATE_Suspended instead\r
870   *  - Extended USB_GetDeviceConfigDescriptor() routine to require the configuration number within the device to fetch\r
871   *  - Dataflash_WaitWhileBusy() now always ensures that the dataflash is ready for the next command immediately after returning,\r
872   *    no need to call Dataflash_ToggleSelectedChipCS() afterwards\r
873   *  - Low level API MIDI device demo no longer blocks if a note change event is sent while the endpoint is not ready\r
874   *  - Pipe_GetErrorFlags() now returns additional error flags for overflow and underflow errors\r
875   *  - Pipe stream functions now automatically set the correct pipe token, so that bidirectional pipes can be used\r
876   *  - Pipe_ConfigurePipe() now automatically defaults IN pipes to accepting infinite IN requests, this can still be changed by calling\r
877   *    the existing Pipe_SetFiniteINRequests() function\r
878   *  - Changed F_USB entries in project makefiles to alias to F_CPU by default, as this is the most common case\r
879   *  - Host mode demos now use sane terminal escape codes, so that text is always readable and events/program output is visually distinguished\r
880   *    from one another using foreground colours\r
881   *  - Internal per-device preprocessing conditions changed to per-device series rather than per-controller group for finer-grain\r
882   *    internal control\r
883   *  - Interrupts are no longer disabled during the processing of Control Requests on the default endpoint while in device mode\r
884   *  - AudioOutput demos now always output to board LEDs, regardless of output mode (removed AUDIO_OUT_LEDS project option)\r
885   *  - Removed SINGLE_DEVICE_CONFIGURATION compile time option in favor of the new FIXED_NUM_CONFIGURATIONS option so that the exact number\r
886   *    of device configurations can be defined statically\r
887   *  - Removed VBUS events, as they are already exposed to the user application via the regular device connection and disconnection events\r
888   *  - Renamed and altered existing events to properly separate out Host and Device mode events\r
889   *  - All demos switched over from GNU99 standards mode to C99 standards mode, to reduce the dependencies on GCC-only language extensions\r
890   *\r
891   *  <b>Fixed:</b>\r
892   *  - Changed bootloaders to use FLASHEND rather than the existence of RAMPZ to determine if far FLASH pointers are needed to fix\r
893   *    bootloaders on some of the USB AVR devices where avr-libc erroneously defines RAMPZ\r
894   *  - Fixes to MassStorageHost for better device compatibility (increase command timeout, change MassStore_WaitForDataReceived()\r
895   *    to only unfreeze and check one data pipe at a time) to prevent incorrect device enumerations and freezes while transferring data\r
896   *  - Make Pipe_ConfigurePipe() mask the given endpoint number against PIPE_EPNUM_MASK to ensure the endpoint IN direction bit is\r
897   *    cleared to prevent endpoint type corruption\r
898   *  - Fixed issue opening CDC-ACM ports on hosts when the CDC device tries to send data before the host has set the line encoding\r
899   *  - Fixed USB_OPT_MANUAL_PLL option being ignored during device disconnects on some models (thanks to Brian Dickman)\r
900   *  - Fixed documentation mentioning Pipe_GetCurrentToken() function when correct function name is Pipe_GetPipeToken()\r
901   *  - Fixed ADC driver for the ATMEGA32U4 and ATMEGA16U4 (thanks to Opendous Inc.)\r
902   *  - Fixed CDCHost demo unfreezing the pipes at the point of configuration, rather than use\r
903   *  - Fixed MassStorage demo not clearing the reset flag when a Mass Storage Reset is issued while not processing a command\r
904   *  - Fixed USB_Host_SendControlRequest() not re-suspending the USB bus when initial device ready-wait fails\r
905   *  - Fixed USB Pad regulator not being disabled on some AVR models when the USB_OPT_REG_DISABLED option is used\r
906   *  - Fixed Host mode to Device mode UID change not causing a USB Disconnect event when a device was connected\r
907   *  - Fixed Mouse/Keyboard demos not performing the correct arithmetic on the Idle period at the right times (thanks to Brian Dickman)\r
908   *  - Fixed GenericHID failing HID class tests due to incorrect Logical Minimum and Logical Maximum values (thanks to Soren Greiner)\r
909   *  - Fixed incorrect PIPE_EPNUM_MASK mask causing pipe failures on devices with endpoint addresses of 8 and above (thanks to John Andrews)\r
910   *  - Fixed report data alignment issues in the MouseHostWithParser demo when X and Y movement data size is not a multiple of 8 bits\r
911   *  - Fixed HID Report Descriptor Parser not correctly resetting internal states when a REPORT ID element is encountered\r
912   *  - Fixed incorrect BUTTONS_BUTTON1 for the STK526 target\r
913   *  - Fixed RNDIS demos freezing when more than one connection was attempted simultaneously, causing memory corruption\r
914   *  - Fixed USBtoSerial demo receiving noise from the USART due to pull-up not being enabled\r
915   *\r
916   *\r
917   *  \section Sec_ChangeLog090605 Version 090605\r
918   *\r
919   *  - Fixed bug in RNDISEthernet and DualCDC demos not using the correct USB_ControlRequest structure for control request data\r
920   *  - Fixed documentation showing incorrect USB mode support on the supported AVRs list\r
921   *  - Fixed RNDISEthernet not working under Linux due to Linux requiring an "optional" RNDIS request which was unhandled\r
922   *  - Fixed Mouse and Keyboard device demos not acting in accordance with the HID specification for idle periods (thanks to Brian Dickman)\r
923   *  - Removed support for endpoint/pipe non-control interrupts; these did not act in the way users expected, and had many subtle issues\r
924   *  - Fixed Device Mode not handling Set Feature and Clear Feature Chapter 9 requests that are addressed to the device (thanks to Brian Dickman)\r
925   *  - Moved control endpoint interrupt handling into the library itself, enable via the new INTERRUPT_CONTROL_ENDPOINT token\r
926   *  - Fixed CDCHost not clearing configured pipes and resetting configured pipes mask when a partially enumerated invalid CDC\r
927   *    interface is skipped\r
928   *  - Clarified the size of library tokens which accept integer values in the Compile Time Tokens page, values now use the smallest datatype\r
929   *    inside the library that is able to hold their defined value to save space\r
930   *  - Removed DESCRIPTOR_ADDRESS() macro as it was largely superfluous and only served to obfuscate code\r
931   *  - Rewritten event system to remove all macros, to make user code clearer\r
932   *  - Fixed incorrect ENDPOINT_EPNUM_MASK mask preventing endpoints above EP3 from being selected (thanks to Jonathan Oakley)\r
933   *  - Removed STREAM_CALLBACK() macro - callbacks now use regular function definitions to clarify user code\r
934   *  - Removed DESCRIPTOR_COMPARATOR() macro - comparators should now use regular function definitions to clarify user code\r
935   *  - USB_IsConnected is now cleared before the USB_Disconnect() event is fired in response to VBUS being removed\r
936   *  - Fixed incorrect PID value being used in the USBtoSerial project (thanks to Phill)\r
937   *  - Deleted StdDescriptors.c, renamed USB_GetDescriptor() to CALLBACK_USB_GetDescriptor, moved ConfigDescriptor.c/.h from the\r
938   *    LUFA/Drivers/USB/Class/ directory to LUFA/Drivers/USB/HighLevel/ in preparation for the new USB class APIs\r
939   *  - Moved out each demos' functionality library files (e.g. Ring Buffer library) to /Lib directories for a better directory structure\r
940   *  - Removed Tx interrupt from the USBtoSerial demo; now sends characters via polling to ensure more time for the Rx interrupt\r
941   *  - Fixed possible enumeration errors from spin-loops which may fail to exit if the USB connection is severed before the exit condition\r
942   *    becomes true\r
943   *\r
944   *\r
945   *  \section Sec_ChangeLog090510 Version 090510\r
946   *\r
947   *  - Added new GenericHIDHost demo\r
948   *  - Corrections to the KeyboardHost and MouseHost demos' pipe handling to freeze and unfreeze the data pipes at the point of use\r
949   *  - KeyboardHost, MouseHost and GenericHIDHost demos now save and restore the currently selected pipe inside the pipe ISR\r
950   *  - Changed GenericHID device demo to use the LUFA scheduler, added INTERRUPT_DATA_ENDPOINT and INTERRUPT_CONTROL_ENDPOINT compile\r
951   *    time options\r
952   *  - All comments in the library, bootloaders, demos and projects have now been spell-checked and spelling mistakes/typos corrected\r
953   *  - Added new PIMA_DATA_SIZE() define to the Still Image Host demo\r
954   *  - Add call to MassStore_WaitForDataReceived() in MassStore_GetReturnedStatus() to ensure that the CSW has been received in the\r
955   *    extended MSC timeout period before continuing, to prevent long processing delays from causing the MassStore_GetReturnedStatus()\r
956   *    to early-abort (thanks to Dmitry Maksimov)\r
957   *  - Move StdRequestType.h, StreamCallbacks.h, USBMode.h from the LowLevel USB driver directory to the HighLevel USB driver directory,\r
958   *    where they are more suited\r
959   *  - Removed all binary constants and replaced with decimal or hexadecimal constants so that unpatched GCC compilers can still build the\r
960   *    code without having to be itself patched and recompiled first\r
961   *  - Added preprocessor checks and documentation to the bootloaders giving information about missing SIGNATURE_x defines due to\r
962   *    outdated avr-libc versions.\r
963   *  - Added support to the CDCHost demo for devices with multiple CDC interfaces which are not the correct ACM type preceding the desired\r
964   *    ACM CDC interface\r
965   *  - Fixed GenericHID demo not starting USB and HID management tasks when not using interrupt driven modes (thanks to Carl Kjeldsen)\r
966   *  - Fixed RNDISEthenet demo checking the incorrect message field for packet size constraints (thanks to Jonathan Oakley)\r
967   *  - Fixed WriteNextReport code in the GenericHIDHost demo using incorrect parameter types and not selecting the correct endpoint\r
968   *  - Adjusted sample CTC timer calculations in the AudioOutput and AudioInput demos to match the CTC calculations in the AVR datasheet,\r
969   *    and to fix instances where rounding caused the endpoint to underflow (thanks to Robin Theunis)\r
970   *  - The USB_Host_SendControlRequest() function no longer automatically selects the Control pipe (pipe 0), so that other control type\r
971   *    pipes can be used with the function\r
972   *  - The USB Host management task now saves and restores the currently selected pipe before and after the task completes\r
973   *  - Fixed GenericHIDHost demo report write routine incorrect for control type requests (thanks to Andrei Krainev)\r
974   *  - Removed Endpoint_ClearCurrentBank() and Pipe_ClearCurrentBank() in favor of new Endpoint_ClearIN(), Endpoint_ClearOUT(),\r
975   *    Pipe_ClearIN() and Pipe_ClearOUT() macros (done to allow for the detection of packets of zero length)\r
976   *  - Renamed *_ReadWriteAllowed() macros to *_IsReadWriteAllowed() to remain consistent with the rest of the LUFA API\r
977   *  - Endpoint_IsSetupReceived() macro has been renamed to Endpoint_IsSETUPReceived(), Endpoint_ClearSetupReceived() macro has been\r
978   *    renamed to Endpoint_ClearSETUP(), the Pipe_IsSetupSent() macro has been renamed to Pipe_IsSETUPSent() and the\r
979   *    Pipe_ClearSetupSent() macro is no longer applicable and should be removed - changes made to compliment the new endpoint and pipe\r
980   *    bank management API\r
981   *  - Updated all demos, bootloaders and projects to use the new endpoint and pipe management APIs (thanks to Roman Thiel from Curetis AG)\r
982   *  - Updated library doxygen documentation, added groups, changed documentation macro functions to real functions for clarity\r
983   *  - Removed old endpoint and pipe aliased read/write/discard routines which did not have an explicit endian specifier for clarity\r
984   *  - Removed the ButtLoadTag.h header file, as no one used for its intended purpose anyway\r
985   *  - Renamed the main Drivers/AT90USBXXX directory to Drivers/Peripheral, renamed the Serial_Stream driver to SerialStream\r
986   *  - Fixed CDC and USBtoSerial demos freezing where buffers were full while still transmitting or receiving (thanks to Peter Hand)\r
987   *  - Removed "Host_" section of the function names in ConfigDescriptor.h, as most of the routines can now be used in device mode on the\r
988   *    device descriptor\r
989   *  - Renamed functions in the HID parser to have a "USB_" prefix and the acronym "HID" in the name\r
990   *  - Fixed incorrect HID interface class and subclass values in the Mouse and KeyboardMouse demos (thanks to Brian Dickman)\r
991   *  - Capitalized the "Descriptor_Search" and "Descriptor_Search_Comp" prefixes of the values in the DSearch_Return_ErrorCodes_t and\r
992   *    DSearch_Comp_Return_ErrorCodes_t enums\r
993   *  - Removed "ERROR" from the enum names in the endpoint and pipe stream error code enums\r
994   *  - Renamed the USB_PowerOnErrorCodes_t enum to USB_InitErrorCodes_t, renamed the POWERON_ERROR_NoUSBModeSpecified enum value to\r
995   *    USB_INITERROR_NoUSBModeSpecified\r
996   *  - Renamed USB_PowerOnFail event to USB_InitFailure\r
997   *  - Renamed OTG.h header functions to be more consistent with the rest of the library API\r
998   *  - Changed over all deprecated GCC structure tag initializers to the standardized C99 format (thanks to Mike Alexander)\r
999   *  - USB_HostRequest renamed to USB_ControlRequest, entire control request header is now read into USB_ControlRequest in Device mode\r
1000   *    rather than having the library pass only partially read header data to the application\r
1001   *  - The USB_UnhandledControlPacket event has had its parameters removed, in favor of accessing the new USB_ControlRequest structure\r
1002   *  - The Endpoint control stream functions now correctly send a ZLP to the host when less data than requested is sent\r
1003   *  - Fixed USB_RemoteWakeupEnabled flag never being set (the REMOTE WAKEUP Set Feature request was not being handled)\r
1004   *  - Renamed the FEATURELESS_CONTROL_ONLY_DEVICE compile-time token to CONTROL_ONLY_DEVICE\r
1005   *  - Endpoint configuration is now refined to give better output when all configurations have static inputs - removed the now useless\r
1006   *    STATIC_ENDPOINT_CONFIGURATION compile time token\r
1007   *  - Fixed SPI driver init function not clearing SPI2X bit when not needed\r
1008   *  - Fixed PREVENT ALLOW MEDIUM REMOVAL command issuing in the MassStorageHost demo using incorrect parameters (thanks to Mike Alex)\r
1009   *  - Fixed MassStorageHost demo broken due to an incorrect if statement test in MassStore_GetReturnedStatus()\r
1010   *  - Fixed reversed signature byte ordering in the CDC bootloader (thanks to Johannes Raschke)\r
1011   *  - Changed PIPE_CONTROLPIPE_DEFAULT_SIZE from 8 to 64 to try to prevent problems with faulty devices which do not respect the given\r
1012   *    wLength value when reading in the device descriptor\r
1013   *  - Fixed missing semicolon in the ATAVRUSBRF01 LED board driver code (thanks to Morten Lund)\r
1014   *  - Changed LED board driver code to define dummy LED masks for the first four board LEDs, so that user code can be compiled for boards\r
1015   *    with less than four LEDs without code modifications (thanks to Morten Lund)\r
1016   *  - Changed HWB board driver to Buttons driver, to allow for the support of future boards with more than one mounted GPIO button\r
1017   *  - Serial driver now correctly calculates the baud register value when in double speed mode\r
1018   *  - Init function of the Serial driver is now static inline to product smaller code for the common-case of static init values\r
1019   *\r
1020   *\r
1021   *  \section Sec_ChangeLog090401 Version 090401\r
1022   *\r
1023   *  - Fixed MagStripe project configuration descriptor containing an unused (blank) endpoint descriptor\r
1024   *  - Incorporated makefile changes by Denver Gingerich to retain compatibility with stock (non-WinAVR) AVR-GCC installations\r
1025   *  - Fixed makefile EEPROM programming targets programming FLASH data in addition to EEPROM data\r
1026   *  - LUFA devices now enumerate correctly with LUFA hosts\r
1027   *  - Fixed Configuration Descriptor search routine freezing when a comparator returned a failure\r
1028   *  - Removed HID report item serial dump in the MouseHostWithParser and KeyboardHostWithParser - useful only for debugging, and\r
1029   *    slowed down the enumeration of HID devices too much\r
1030   *  - Increased the number of bits per track which can be read in the MagStripe project to 8192 when compiled for the AT90USBXXX6/7\r
1031   *  - Fixed KeyboardMouse demo discarding the wIndex value in the REQ_GetReport request\r
1032   *  - USBtoSerial demo now discards all Rx data when not connected to a USB host, rather than buffering characters for transmission\r
1033   *    next time the device is attached to a host.\r
1034   *  - Added new F_USB compile time constant to the library and makefiles, to give the raw input clock (used to feed the PLL before any\r
1035   *    clock prescaling is performed) frequency, so that the PLL prescale mask can be determined\r
1036   *  - Changed stream wait timeout counter to be 16-bit, so that very long timeout periods can be set for correct communications with\r
1037   *    badly designed hosts or devices which greatly exceed the USB specification limits\r
1038   *  - Mass Storage Host demo now uses a USB_STREAM_TIMEOUT_MS of two seconds to maintain compatibility with poorly designed devices\r
1039   *  - Function attribute ATTR_ALWAYSINLINE renamed to ATTR_ALWAYS_INLINE to match other function attribute macro naming conventions\r
1040   *  - Added ATTR_ALWAYS_INLINE attribute to several key inlined library components, to ensure they are inlined in all circumstances\r
1041   *  - Removed SetSystemClockPrescaler() macro, the clock_prescale_set() avr-libc macro has been corrected in recent avr-libc versions\r
1042   *  - Fixed incorrect/missing control status stage transfers on demos, bootloaders and applications (thanks to Nate Lawson)\r
1043   *  - The NO_CLEARSET_FEATURE_REQUEST compile time token has been renamed to FEATURELESS_CONTROL_ONLY_DEVICE, and its function expanded\r
1044   *    to also remove parts of the Get Status chapter 9 request to further reduce code usage\r
1045   *  - Makefile updated to include output giving the currently selected BOARD parameter value\r
1046   *  - Board Dataflash driver now allows for dataflash ICs which use different shifts for setting the current page/byte address (thanks\r
1047   *    to Kenneth Clubb)\r
1048   *  - Added DataflashManager_WriteBlocks_RAM() and DataflashManager_ReadBlocks_RAM() functions to the MassStorage demo, to allow for easy\r
1049   *    interfacing with a FAT library for dataflash file level access\r
1050   *  - Corrected CDC class bootloader to fix a few bugs, changed address counter to store x2 addresses for convenience\r
1051   *  - Fixed typos in the SPI driver SPI_SPEED_FCPU_DIV_64 and SPI_SPEED_FCPU_DIV_128 masks (thanks to Markus Zocholl)\r
1052   *  - Keyboard and Mouse device demos (normal, data interrupt and fully interrupt driven) combined into unified keyboard and mouse demos\r
1053   *  - Keyboard and Mouse host demos (normal and data interrupt driven) combined into unified keyboard and mouse demos\r
1054   *  - Removed AVRISP_Programmer project due to code quality concerns\r
1055   *  - Fixed CDC demo not sending an empty packet after each transfer to prevent the host from buffering incoming data\r
1056   *  - Fixed documentation typos and preprocessor checks relating to misspellings of the USE_RAM_DESCRIPTORS token (thanks to Ian Gregg)\r
1057   *  - Fixed USBTask.h not conditionally including HostChapter9.h only when USB_CAN_BE_HOST is defined (thanks to Ian Gregg)\r
1058   *  - Fixed incorrect ADC driver init register manipulation (thanks to Tobias)\r
1059   *  - Added new GenericHID device demo application\r
1060   *  - Fixed Still Image Host SImage_SendData() function not clearing the pipe bank after sending data\r
1061   *\r
1062   *\r
1063   *  \section Sec_ChangeLog090209 Version 090209\r
1064   *\r
1065   *  - PWM timer mode in AudioOut demo changed to Fast PWM for speed\r
1066   *  - Updated Magstripe project to work with the latest hardware revision\r
1067   *  - Fixed library not responding to the BCERRI flag correctly in host mode, leading to device lockups\r
1068   *  - Fixed library handling Get Descriptor requests when not addressed as standard requests to the device or interface (thanks to\r
1069   *    Nate Lawson)\r
1070   *  - Fixed serious data corruption issue in MassStorage demo dataflash write routine\r
1071   *  - Added new NO_CLEARSET_FEATURE_REQUEST compile time token\r
1072   *  - USB task now restores previous global interrupt state after execution, rather than forcing global interrupts to be enabled\r
1073   *  - Fixed USB_DeviceEnumerationComplete event firing after each configuration change, rather than once after the initial configuration\r
1074   *  - Added ENDPOINT_DOUBLEBANK_SUPPORTED() macros to Endpoint.h, altered ENDPOINT_MAX_SIZE() to allow user to specify endpoint\r
1075   *  - ENDPOINT_MAX_ENDPOINTS changed to ENDPOINT_TOTAL_ENDPOINTS, PIPE_MAX_PIPES changed to PIPE_TOTAL_PIPES\r
1076   *  - Endpoint and Pipe non-control stream functions now ensure endpoint or pipe is ready before reading or writing\r
1077   *  - Changed Teensy bootloader to use a watchdog reset when exiting rather than a software jump\r
1078   *  - Fixed integer promotion error in MassStorage and MassStorageHost demos, corrupting read/write transfers\r
1079   *  - SPI_SendByte is now SPI_TransferByte, added new SPI_SendByte and SPI_ReceiveByte functions for fast one-way transfer\r
1080   *  - MassStorage demo changed to use new fast one-way SPI transfers to increase throughput\r
1081   *  - MassStorage handling of Mass Storage Reset class request improved\r
1082   *  - Altered MassStorage demo dataflash block read code for speed\r
1083   *  - Added USB_IsSuspended global flag\r
1084   *  - Simplified internal Dual Mode (OTG) USB library code to reduce code size\r
1085   *  - Extended stream timeout period to 100ms from 50ms\r
1086   *  - Mass Storage Host demo commands now all return an error code from the Pipe_Stream_RW_ErrorCodes_t enum\r
1087   *  - Added SubErrorCode parameter to the USB_DeviceEnumerationFailed event\r
1088   *  - VBUS drop interrupt now disabled during the manual-to-auto VBUS delivery handoff\r
1089   *  - Simplified low level backend so that device/host mode initialization uses the same code paths\r
1090   *  - Added workaround for faulty Mass Storage devices which do not implement the required GET_MAX_LUN request\r
1091   *  - Removed buggy Telnet application from the RNDIS demo\r
1092   *  - Moved Mass Storage class requests in the Mass Storage Host demo to wrapper functions in MassStoreCommands.c\r
1093   *  - Fixed incorrect SCSI command size value in the Request Sense command in MassStoreCommands.c\r
1094   *  - Added SetProtocol request to HID class non-parser Mouse and Keyboard demos to force devices to use the correct Boot Protocol\r
1095   *  - Added new "dfu" and "flip" programming targets to project makefiles\r
1096   *  - HID_PARSE_Sucessful enum member typo corrected to HID_PARSE_Successful\r
1097   *  - Changed COLLECTION item structures in the HID descriptor parser to include the collection's Usage Page value\r
1098   *  - Serial driver now sets Tx line as output, enables pull-up on Rx line\r
1099   *  - Fixed smaller USB AVRs raising multiple connection and disconnection events when NO_LIMITED_CONTROLLER_CONNECT is disabled\r
1100   *  - Added HOST_DEVICE_SETTLE_DELAY_MS to give the host delay after a device is connected before it is enumerated\r
1101   *  - Fixed KeyboardHostWithParser demo linking against the wrong global variables\r
1102   *  - Completed doxygen documentation of remaining library bootloaders, demos and projects\r
1103   *  - Fixed incorrect bootloader start address in the TeensyHID bootloader\r
1104   *  - Added HWB button whole-disk ASCII dump functionality to MassStoreHost demo\r
1105   *  - Replaced printf_P(PSTR("%c"), {Variable}) calls with putchar(<Variable>) for speed and size savings\r
1106   *  - Serial driver now accepts baud rates over 16-bits in size, added double speed flag option\r
1107   *  - Fixed incorrect callback abort return value in Pipe.c\r
1108   *  - Added new flip-ee and dfu-ee makefile targets (courtesy of Opendous Inc.)\r
1109   *  - Removed reboot-on-disconnect code from the TeensyHID bootloader, caused problems on some systems\r
1110   *  - Fixed AudioOutput and AudioInput demos looping on the endpoint data, rather than processing a sample at a time and returning\r
1111   *    each time the task runs to allow for other tasks to execute\r
1112   *  - Added support for the Atmel ATAVRUSBRF01 board\r
1113   *  - Added AVRISP Programmer Project, courtesy of Opendous Inc.\r
1114   *  - Fixed CDC Host demo not searching through both CDC interfaces for endpoints\r
1115   *  - Fixed incorrect Product String descriptor length in the DFU class bootloader\r
1116   *\r
1117   *\r
1118   *  \section Sec_ChangeLog081224 Version 081224\r
1119   *\r
1120   *  - MyUSB name changed to LUFA, the Lightweight USB Framework for AVRs\r
1121   *  - Fixed Mass Storage Host demo's MassStore_SendCommand() delay in the incorrect place\r
1122   *  - Fixed USBtoSerial demo not calling ReconfigureUSART() after a change in the line encoding\r
1123   *  - Fixed infinite loop in host mode Host-to-Device control transfers with data stages\r
1124   *  - HID report parser now supports devices with multiple reports in one interface via Report IDs\r
1125   *  - Fixed RZUSBSTICK board LED driver header incorrect macro definition order causing compile errors\r
1126   *  - Calling USB_Init() when the USB interface is already configured now forces a complete interface reset\r
1127   *    and re-enumeration - fixes MyUSB DFU bootloader not switching to app code correctly when soft reset used\r
1128   *  - Fixed "No newline at end of file" warning when stream callbacks are enabled\r
1129   *  - DFU bootloader now uses fixed signature bytes per device, rather than reading them out dynamically for size\r
1130   *  - Added new FIXED_CONTROL_ENDPOINT_SIZE and USE_SINGLE_DEVICE_CONFIGURATION switches to statically define certain values to\r
1131   *    reduce compiled binary size\r
1132   *  - Added new NO_LIMITED_CONTROLLER_CONNECT switch to prevent the library from trying to determine bus connection\r
1133   *    state from the suspension and wake up events on the smaller USB AVRs\r
1134   *  - Added summary of all library compile time tokens to the documentation\r
1135   *  - Added overview of the LUFA scheduler to the documentation\r
1136   *  - Removed MANUAL_PLL_CONTROL compile time token, replaced with a mask for the USB_Init() Options parameter\r
1137   *  - CDC bootloader now uses the correct non-far or far versions of the pgm_* functions depending on if RAMPZ is defined\r
1138   *  - Doxygen documentation now contains documentation on all the projects, bootloaders and most demos included with the library\r
1139   *  - CDC bootloader now runs user application when USB disconnected rather than waiting for a hard reset\r
1140   *  - MouseHostWithParser and KeyboardHostWithParser now support multiple-report devices\r
1141   *  - RNDIS demo can now close connections correctly using the new TCP_APP_CLOSECONNECTION() macro - used in Webserver\r
1142   *  - Fixed the DFU bootloader, no longer freezes up when certain files are programmed into an AVR, made reading/writing faster\r
1143   *  - Fixed mouse/joystick up/down movements reversed - HID mouse X/Y coordinates use a left-handed coordinate system, not a normal\r
1144   *    right-handed system\r
1145   *  - Added stub code to the CDC and USBtoSerial demos showing how to read and set the RS-232 handshake lines - not currently used in\r
1146   *    the demos, but the example code and supporting defines are now in place\r
1147   *  - Interrupts are now disabled when processing a control request in device mode, to avoid exceeding the strict control request\r
1148   *    timing requirements.\r
1149   *  - All demos now use a central StatusUpdate() function rather than direct calls to the board LED functions, so that the demos can\r
1150   *    easily be altered to show different LED combinations (or do something else entirely) as the demo's status changes\r
1151   *  - Removed LED commands from the CDC bootloader, unused by most AVR910 programming software\r
1152   *  - Fixed RNDIS demo ICMP ping requests echoing back incorrect data\r
1153   *  - Added DHCP server code to RNDIS demo, allowing for hands-free auto configuration on any PC\r
1154   *  - Fixed DFU bootloader PID value for the ATMEGA16U4 AVR\r
1155   *  - Endpoint and Pipe configuration functions now return an error code indicating success or failure\r
1156   *  - USB Reset in device mode now resets and disables all device endpoints\r
1157   *  - Added intermediate states to the host mode state machine, reducing the USB task blocking time to no more than 1ms explicitly per\r
1158   *    invocation when in host mode\r
1159   *  - Added support for the ATMEGA32U6 microcontroller\r
1160   *  - Added STATIC_ENDPOINT_CONFIGURATION compile time option, enabled in the bootloaders to minimize space usage\r
1161   *  - Removed redundant code from the USB device GetStatus() chapter 9 processing routine\r
1162   *  - Added new TeensyHID bootloader, compatible with the Teensy HID protocol (http://www.pjrc.com/teensy/)\r
1163   *  - Versions are now numbered by release dates, rather than arbitrary major/minor revision numbers\r
1164   *  - USB_RemoteWakeupEnabled is now correctly set and cleared by SetFeature and ClearFeature requests from the host\r
1165   *  - Changed prototype of GetDescriptor, so that it now returns the descriptor size (or zero if the descriptor doesn't exist)\r
1166   *    rather than passing the size back to the caller through a parameter and returning a boolean\r
1167   *\r
1168   *\r
1169   *  \section Sec_ChangeLog153 Version 1.5.3 (081002)\r
1170   *\r
1171   *  - Fixed CDC bootloader using pgmspace macros for some descriptors inappropriately\r
1172   *  - Updated all Mouse and Keyboard device demos to include boot protocol support (now works in BIOS)\r
1173   *  - Renamed bootloader directories to remove spaces, which were causing build problems on several OSes\r
1174   *  - Removed serial number strings from all but the MassStore demo where it is required - users were not\r
1175   *    modifying the code to either omit the descriptor or use a unique serial per device causing problems\r
1176   *    when multiple units of the same device were plugged in at the same time\r
1177   *  - AudioOutput and AudioInput demos now correctly silence endpoints when not enabled by the host\r
1178   *  - Added KeyboardMouse demo (Keyboard and Mouse functionality combined into a single demo)\r
1179   *  - Added DriverStubs directory to house board level driver templates, to make MyUSB compatible custom board\r
1180   *    driver creation easier\r
1181   *  - Extended MassStorage demo to support multiple LUNs, 2 by default\r
1182   *  - Fixed incorrect device address mask, preventing the device from enumerating with addresses larger than 63\r
1183   *  - Fixed incorrect data direction mask in the GetStatus standard request, preventing it from being handled\r
1184   *  - Fixed incorrect GetStatus standard request for endpoints, now returns the endpoint STALL status correctly\r
1185   *  - Added in new USB_RemoteWakeupEnabled and USB_CurrentlySelfPowered flags rather than using fixed values\r
1186   *  - Added DualCDC demo to demonstrate the use of Interface Association Descriptors\r
1187   *  - Added pipe NAK detection and clearing API\r
1188   *  - Added pipe status change (NAK, STALL, etc.) interrupt API\r
1189   *  - Fixed MassStorageHost demo so that it no longer freezes randomly when issuing several commands in a row\r
1190   *  - Host demos configuration descriptor routines now return a unique error code when the returned data does\r
1191   *    not have a valid configuration descriptor header\r
1192   *  - Added Endpoint_WaitUntilReady() and Pipe_WaitUntilReady() functions\r
1193   *  - Stream functions now have software timeouts, timeout period can be set by the USB_STREAM_TIMEOUT_MS token\r
1194   *  - All demos now pass the USB.org automated Chapter 9 device compliance tests\r
1195   *  - All HID demos now pass the USB.org automated HID compliance tests\r
1196   *  - Polling interval of the interrupt endpoint in the CDC based demos changed to 0xFF to fix problems on Linux systems\r
1197   *  - Changed stream functions to accept a new callback function, with NO_STREAM_CALLBACKS used to disable all callbacks\r
1198   *  - Mass Storage demo dataflash management routines changed to use the endpoint stream functions\r
1199   *  - Added AVRStudio project files for each demo in addition to the existing Programmer's Notepad master project file\r
1200   *  - Re-added call to ReconfigureUSART() in USBtoSerial SetLineCoding request, so that baud rate changes\r
1201   *    are reflected in the hardware (change was previously lost)\r
1202   *\r
1203   *\r
1204   *  \section Sec_ChangeLog152 Version 1.5.2 (080731)\r
1205   *\r
1206   *  - Fixed SwapEndian_32() function in Common.h so that it now works correctly (wrong parameter types)\r
1207   *  - Updated RNDIS demo - notification endpoint is no longer blocking so that it works with faulty Linux RNDIS\r
1208   *    implementations (where the notification endpoint is ignored in favor of polling the control endpoint)\r
1209   *  - Fixed incorrect Vendor Description string return size in RNDIS demo for the OID_GEN_VENDOR_DESCRIPTION OID token\r
1210   *  - Added very basic TCP/IP stack and HTTP/TELNET servers to RNDIS demo\r
1211   *  - Fixed DFU bootloader exit causing programming software to complain about failed writes\r
1212   *  - Fixed DFU bootloader EEPROM programming mode wiping first flash page\r
1213   *  - Fixed Clear/Set Feature device standard request processing code (fixing MassStorage demo in the process)\r
1214   *  - Added support for the ATMEGA16U4 AVR microcontroller\r
1215   *  - Library license changed from LGPLv3 to MIT license\r
1216   *\r
1217   *\r
1218   *  \section Sec_ChangeLog151 Version 1.5.1 (080707)\r
1219   *\r
1220   *  - Changed host demos to enable the host function task on the firing of the USB_DeviceEnumerationComplete event\r
1221   *    rather than the USB_DeviceAttached event\r
1222   *  - HID Usage Stack now forcefully cleared after an IN/OUT/FEATURE item has been completely processed to remove\r
1223   *    any referenced but not created usages\r
1224   *  - Changed USB_INT_DisableAllInterrupts() and USB_INT_ClearAllInterrupts(), USB_Host_GetNextDescriptorOfType(),\r
1225   *    USB_Host_GetNextDescriptorOfTypeBefore(), USB_Host_GetNextDescriptorOfTypeAfter() to normal functions (from inline)\r
1226   *  - Fixed USBtoSerial demo not sending data, only receiving\r
1227   *  - Fixed main makefile to make all by default, fixed MagStripe directory case to prevent case-sensitive path problems\r
1228   *  - ConfigDescriptor functions made normal, instead of static inline\r
1229   *  - Pipe/Endpoint *_Ignore_* functions changed to *_Discard_*, old names still present as aliases\r
1230   *  - Fixed ENDPOINT_MAX_SIZE define to be correct on limited USB controller AVRs\r
1231   *  - Changed endpoint and pipe size translation routines to use previous IF/ELSE IF cascade code, new algorithmic\r
1232   *    approach was buggy and caused problems\r
1233   *  - Bootloaders now compile with -fno-inline-small-functions option to reduce code size\r
1234   *  - Audio demos now use correct endpoint sizes for full and limited controller USB AVRs, double banking in all cases\r
1235   *    to be in line with the specification (isochronous endpoints MUST be double banked)\r
1236   *  - Added Interface Association descriptor to StdDescriptors.h, based on the relevant USB2.0 ECN\r
1237   *  - Fixed MIDI demo, corrected Audio Streaming descriptor to follow the MIDI-specific AS structure\r
1238   *  - Fixed HID class demo descriptors so that the HID interface's protocol is 0x00 (required for non-boot protocol HID\r
1239   *    devices) to prevent problems on hosts expecting the boot protocol functions to be supported\r
1240   *  - Added read/write control stream functions to Endpoint.h\r
1241   *  - Fixed AudioOut demo not setting port pins to inputs on USB disconnect properly\r
1242   *  - Added RNDISEthernet demo application\r
1243   *\r
1244   *\r
1245   *  \section Sec_ChangeLog150 Version 1.5.0 (080610)\r
1246   *\r
1247   *  - Fixed MIDI demo, now correctly waits for the endpoint to be ready between multiple note messages\r
1248   *  - Added CDC Host demo application\r
1249   *  - Added KeyboardFullInt demo application\r
1250   *  - Endpoint and Pipe creation routines now mask endpoint/pipe size with the size mask, to remove transaction\r
1251   *    size bits not required for the routines (improves compatibility with devices)\r
1252   *  - Fixed AudioInput demo - now correctly sends sampled audio to the host PC\r
1253   *  - Fixed AudioOutput demo once more -- apparently Windows requires endpoint packets to be >=192 bytes\r
1254   *  - Shrunk round-robbin scheduler code slightly via the use of struct pointers rather than array indexes\r
1255   *  - Fixed off-by-one error when determining if the Usage Stack is full inside the HID Report parser\r
1256   *  - Renamed Magstripe.h to MagstripeHW.h and moved driver out of the library and into the MagStripe demo folder\r
1257   *  - Added preprocessor checks to enable C linkage on the library components when used with a C++ compiler\r
1258   *  - Added Still Image Host demo application\r
1259   *  - The USB device task now restores the previously selected endpoint, allowing control requests to be transparently\r
1260   *    handled via interrupts while other endpoints are serviced through polling\r
1261   *  - Fixed device signature being sent in reverse order in the CDC bootloader\r
1262   *  - Host demos now have a separate ConfigDescriptor.c/.h file for configuration descriptor processing\r
1263   *  - HostWithParser demos now have a separate HIDReport.c/.h file for HID report processing and dumping\r
1264   *  - Removed non-mandatory commands from MassStorage demo to save space, fixed SENSE ResponseCode value\r
1265   *  - CDC demos now send empty packets after sending a full one to prevent buffering issues on the host\r
1266   *  - Updated demo descriptors to use VID/PID values donated by Atmel\r
1267   *  - Added DoxyGen documentation to the source files\r
1268   *  - Fixed Serial_IsCharReceived() definition, was previously reversed\r
1269   *  - Removed separate USB_Descriptor_Language_t descriptor, USB_Descriptor_String_t is used instead\r
1270   *  - Removed unused Device Qualifier descriptor structure\r
1271   *  - Renamed the USB_CreateEndpoints event to the more appropriate USB_ConfigurationChanged\r
1272   *  - Fixed MassStorageHost demo reading in the block data in reverse\r
1273   *  - Removed outdated typedefs in StdRequestType.h, superseded by the macro masks\r
1274   *  - Corrected OTG.h is now included when the AVR supports both Host and Device modes, for creating OTG products\r
1275   *  - USB_DeviceEnumerationComplete event is now also fired when in device mode and the host has finished its enumeration\r
1276   *  - Interrupt driven demos now properly restore previously selected endpoint when ISR is complete\r
1277   *  - The value of USB_HOST_TIMEOUT_MS can now be overridden in the user project makefile to a custom fixed timeout value\r
1278   *  - Renamed USB_Host_SOFGeneration_* macros to more friendly USB_Host_SuspendBus(), USB_Host_ResumeBus()\r
1279   *    and USB_Host_IsBusSuspended()\r
1280   *  - Renamed *_*_Is* macros to *_Is* to make all flag checking macros consistent, Pipe_SetInterruptFreq() is now\r
1281   *    Pipe_SetInterruptPeriod() to use the correct terminology\r
1282   *  - UnicodeString member of USB_Descriptor_String_t struct changed to an ordinary int array type, so that the GCC\r
1283   *    Unicode strings (prefixed with an L before the opening quotation mark) can be used instead of explicit arrays\r
1284   *    of ASCII characters\r
1285   *  - Fixed Endpoint/Pipes being configured incorrectly if the maximum endpoint/pipe size for the selected USB AVR\r
1286   *    model was given as the bank size\r
1287   *  - HID device demos now use a true raw array for the HID report descriptor rather than a struct wrapped array\r
1288   *  - Added VERSION_BCD() macro, fixed reported HID and USB version numbers in demo descriptors\r
1289   *  - Cleaned up GetDescriptor device chapter 9 handler function\r
1290   *  - Added GET_REPORT class specific request to HID demos to make them complaint to the HID class\r
1291   *  - Cleaned up setting of USB_IsInitialized and USB_IsConnected values to only when needed\r
1292   *  - Removed Atomic.c and ISRMacro.h; the library was already only compatible with recent avr-lib-c for other reasons\r
1293   *  - All demos and library functions now use USB standardized names for the USB data (bRequest, wLength, etc.)\r
1294   *  - Added USE_NONSTANDARD_DESCRIPTOR_NAMES token to switch back to the non-standard descriptor element names\r
1295   *\r
1296   *\r
1297   *  \section Sec_ChangeLog141 Version 1.4.1 (090519)\r
1298   *\r
1299   *  - Enhanced KeyboardWithParser demo, now prints out pressed alphanumeric characters like the standard demo\r
1300   *  - Fixed MassStorage demo, read/writes using non mode-10 commands now work correctly\r
1301   *  - Corrected version number in Version.h\r
1302   *\r
1303   *\r
1304   *  \section Sec_ChangeLog140 Version 1.4.0 (090505)\r
1305   *\r
1306   *  - Added HID Report Parser API to the library\r
1307   *  - Added Mouse and Keyboard host demo applications, using the new HID report parser engine\r
1308   *  - Added MouseFullInt demo, which demonstrates a fully interrupt (including control requests) mouse device\r
1309   *  - Fixed incorrect length value in the audio control descriptor of the AudioOutput and AudioInput demos\r
1310   *  - Added MIDI device demo application to the library\r
1311   *  - Fixed problem preventing USB devices from being resumed from a suspended state\r
1312   *  - Added new CDC class bootloader to the library, based on the AVR109 bootloader protocol\r
1313   *  - Added header to each demo application indicating the mode, class, subclass, standards used and supported speed\r
1314   *  - Functions expecting endpoint/pipe numbers are no longer automatically masked against ENDPOINT_EPNUM_MASK or\r
1315   *    PIPE_PIPENUM_MASK - this should be manually added to code which requires it\r
1316   *  - Fixed DFU class bootloader - corrected frequency of flash page writes, greatly reducing programming time\r
1317   *  - Renamed AVR_HOST_GetDeviceConfigDescriptor() to USB_Host_GetDeviceConfigDescriptor() and AVR_HOST_GetNextDescriptor()\r
1318   *    to USB_Host_GetNextDescriptor()\r
1319   *  - Added new USB_Host_GetNextDescriptorOfTypeBefore() and USB_Host_GetNextDescriptorOfTypeAfter() routines\r
1320   *  - Moved configuration descriptor routines to MyUSB/Drivers/USB/Class/, new accompanying ConfigDescriptors.c file\r
1321   *  - Added new configuration descriptor comparator API for more powerful descriptor parsing, updated host demos to use the\r
1322   *    new comparator API\r
1323   *  - Fixed MassStorageHost demo capacity printout, and changed data read/write mode from little-endian to the correct\r
1324   *    big-endian for SCSI devices\r
1325   *  - Fixed macro/function naming consistency; USB_HOST is now USB_Host, USB_DEV is now USB_Device\r
1326   *  - Added better error reporting to host demos\r
1327   *  - Added 10 microsecond delay after addressing devices in host mode, to prevent control stalls\r
1328   *\r
1329   *\r
1330   *  \section Sec_ChangeLog132 Version 1.3.2 (080401)\r
1331   *\r
1332   *  - Added call to ReconfigureUSART() in USBtoSerial SetLineCoding request, so that baud rate changes\r
1333   *    are reflected in the hardware\r
1334   *  - Fixed CDC and USBtoSerial demos - Stream commands do not work for control endpoints, and the\r
1335   *    GetLineCoding request had an incorrect RequestType mask preventing it from being processed\r
1336   *  - Improved reliability of the USBtoSerial demo, adding a busy wait while the buffer is full\r
1337   *  - Device control endpoint size is now determined from the device's descriptors rather than being fixed\r
1338   *  - Separated out SPI code into new SPI driver in AT90USBXXX driver directory\r
1339   *  - Bootloader now returns correct PID for the selected USB AVR model, not just the AT90USB128X PID\r
1340   *  - Added support for the RZUSBSTICK board\r
1341   *  - Bicolour driver removed in favor of generic LEDs driver\r
1342   *  - Added support for the ATMEGA32U4 AVR\r
1343   *  - Added MANUAL_PLL_CONTROL compile time option to prevent the USB library from manipulating the PLL\r
1344   *\r
1345   *\r
1346   *  \section Sec_ChangeLog131 Version 1.3.1 (080319)\r
1347   *\r
1348   *  - Fixed USB to Serial demo - class value in the descriptors was incorrect\r
1349   *  - Control endpoint size changed from 64 bytes to 8 bytes to save on USB FIFO RAM and to allow low\r
1350   *    speed mode devices to enumerate properly\r
1351   *  - USB to Serial demo data endpoints changed to dual-banked 16 byte to allow the demo to work\r
1352   *    on USB AVRs with limited USB FIFO RAM\r
1353   *  - Changed demo endpoint numbers to use endpoints 3 and 4 for double banking, to allow limited\r
1354   *    USB device controller AVRs (AT90USB162, AT90USB82) to function correctly\r
1355   *  - Updated Audio Out demo to use timer 1 for AVRs lacking a timer 3 for the PWM output\r
1356   *  - Fixed incorrect USB_DEV_OPT_HIGHSPEED entry in the Mass Storage device demo makefile\r
1357   *  - Optimized Mass Storage demo for a little extra transfer speed\r
1358   *  - Added LED indicators to the Keyboard demo for Caps Lock, Num Lock and Scroll Lock\r
1359   *  - Added Endpoint_Read_Stream, Endpoint_Write_Stream, Pipe_Read_Stream and Pipe_Write_Stream functions\r
1360   *    (including Big and Little Endian variants)\r
1361   *  - Made Dataflash functions inline for speed, removed now empty Dataflash.c driver file\r
1362   *  - Added new SetSystemClockPrescaler() macro (thanks to Joerg Wunsch)\r
1363   *  - Fixed Endpoint_ClearStall() to function correctly on full USB controller AVRs (AT90USBXXX6/7)\r
1364   *  - Endpoint_Setup_In_Clear() and Endpoint_Setup_Out_Clear() no longer set FIFOCON, in line with the\r
1365   *    directives in the datasheet\r
1366   *  - Fixed PLL prescaler defines for all AVR models and frequencies\r
1367   *  - Fixed ENDPOINT_INT_IN and ENDPOINT_INT_OUT definitions\r
1368   *  - Added interrupt driven keyboard and mouse device demos\r
1369   *  - Combined USB_Device_ClearFeature and USB_Device_SetFeature requests into a single routine for code\r
1370   *    size savings\r
1371   *  - Added missing Pipe_GetCurrentPipe() macro to Pipe.h\r
1372   *\r
1373   *\r
1374   *  \section Sec_ChangeLog130 Version 1.3.0 (080307)\r
1375   *\r
1376   *  - Unnecessary control endpoint config removed from device mode\r
1377   *  - Fixed device standard request interpreter accidentally processing some class-specific requests\r
1378   *  - Added USE_RAM_DESCRIPTORS and USE_EEPROM_DESCRIPTORS compile time options to instruct the library\r
1379   *    to use descriptors stored in RAM or EEPROM rather than flash memory\r
1380   *  - All demos now disable watchdog on startup, in case it has been enabled by fuses or the bootloader\r
1381   *  - USB_DEV_OPT_LOWSPEED option now works correctly\r
1382   *  - Added ability to set the USB options statically for a binary size reduction via the USE_STATIC_OPTIONS\r
1383   *    compile time define\r
1384   *  - USB_Init no longer takes a Mode parameter if compiled for a USB device with no host mode option, or\r
1385   *    if forced to a particular mode via the USB_HOST_ONLY or USB_DEVICE_ONLY compile time options\r
1386   *  - USB_Init no longer takes an Options parameter if options statically configured by USE_STATIC_OPTIONS\r
1387   *  - Endpoint_Ignore_* and Pipe_Ignore_* made smaller by making the dummy variable non-volatile so that the\r
1388   *    compiler can throw away the result more efficiently\r
1389   *  - Added in an optional GroupID value to each scheduler entry, so that groups of tasks can once again be\r
1390   *    controlled by the new Scheduler_SetGroupTaskMode() routine\r
1391   *  - Added support for AT90USB162 and AT90USB82 AVR models\r
1392   *  - Added support for the STK525 and STK526 boards\r
1393   *  - Added support for custom board drivers to be supplied by selecting the board type as BOARD_USER, and\r
1394   *    placing board drivers in {Application Directory}/Board/\r
1395   *  - PLL is now stopped and USB clock is frozen when detached from host in device mode, to save power\r
1396   *  - Joystick defines are now in synch with the schematics - orientation will be rotated for the USBKEY\r
1397   *  - Fixed USB_DEV_IsUSBSuspended() - now checks the correct register\r
1398   *  - Fixed data transfers to devices when in host mode\r
1399   *  - Renamed USB_DEV_OPT_HIGHSPEED to USB_DEV_OPT_FULLSPEED and USB_HOST_IsDeviceHighSpeed() to\r
1400   *    USB_HOST_IsDeviceFullSpeed() to be in line with the official USB speed names (to avoid confusion with\r
1401   *    the real high speed mode, which is unavailable on the USB AVRs)\r
1402   *\r
1403   *\r
1404   *  \section Sec_ChangeLog120 Version 1.2.0 (080204)\r
1405   *\r
1406   *  - Added USB_DeviceEnumerationComplete event for host mode\r
1407   *  - Added new Scheduler_Init routine to prepare the scheduler, so that tasks can be started and\r
1408   *    stopped before the scheduler has been started (via Scheduler_Start)\r
1409   *  - Connection events in both Device and Host mode are now interrupt-driven, allowing the USB management\r
1410   *    task to be stopped when the USB is not connected to a host or device\r
1411   *  - All demos updated to stop the USB task when not in use via the appropriate USB events\r
1412   *  - Mass Storage Host demo application updated to function correctly with all USB flash disks\r
1413   *  - Mass Storage Host demo application now prints out the capacity and number of LUNs in the attached\r
1414   *    device, and prints the first block as hexadecimal numbers rather than ASCII characters\r
1415   *  - Endpoint and Pipe clearing routines now clear the Endpoint/Pipe interrupt and status flags\r
1416   *  - Shifted error handling code in the host enum state machine to a single block, to reduce code complexity\r
1417   *  - Added in DESCRIPTOR_TYPE, DESCRIPTOR_SIZE and DESCRIPTOR_CAST macros to make config descriptor processing\r
1418   *    clearer in USB hosts and DESCRIPTOR_ADDRESS for convenience in USB devices\r
1419   *  - Added in alloca macro to common.h, in case the user is using an old version of avr-lib-c missing the macro\r
1420   *\r
1421   *\r
1422   *  \section Sec_ChangeLog110 Version 1.1.0 (080125)\r
1423   *\r
1424   *  - Fixed DCONNI interrupt being enabled accidentally after a USB reset\r
1425   *  - Fixed DDISCI interrupt not being disabled when a device is not connected\r
1426   *  - Added workaround for powerless pull-up devices causing false disconnect interrupts\r
1427   *  - Added USB_DeviceEnumerationFailed event for Host mode\r
1428   *  - AVR_HOST_GetDeviceConfigDescriptor routine no longer modifies ConfigSizePtr if a valid buffer\r
1429   *    pointer is passed\r
1430   *  - Added ALLOCABLE_BYTES to DynAlloc, and added code to make the size of key storage variables\r
1431   *    dependant on size of memory parameters passed in via the user project's makefile\r
1432   *  - Fixed incorrect device reset routine being called in USBTask\r
1433   *  - Devices which do not connect within the standard 300mS are now supported\r
1434   *  - Removed incorrect ATTR_PURE from Scheduler_SetTaskMode(), which was preventing tasks from being\r
1435   *    started/stopped, as well as USB_InitTaskPointer(), which was breaking dual device/host USB projects\r
1436   *  - Changed scheduler to use the task name rather than IDs for setting the task mode, eliminating the\r
1437   *    need to have a task ID list\r
1438   *  - ID transition interrupt now raises the appropriate device/host disconnect event if device attached\r
1439   *  - Fixed double VBUS change (and VBUS -) event when detaching in device mode\r
1440   *  - Added ability to disable ANSI terminal codes by the defining of DISABLE_TERMINAL_CODES in makefile\r
1441   *  - Removed return from ConfigurePipe and ConfigureEndpoint functions - use Pipe_IsConfigured() and\r
1442   *    Endpoint_IsConfigured() after calling the config functions to determine success\r
1443   */\r
1444 \r