Removed invalid dfu and flip related targets from the bootloaders - bootloaders can...
[pub/USBasp.git] / LUFA / Drivers / USB / HighLevel / Events.h
index f6d8aac..72c2b7f 100644 (file)
   this software.\r
 */\r
 \r
   this software.\r
 */\r
 \r
+/** \file\r
+ *  \brief USB controller events manager.\r
+ *\r
+ *  This file contains macros and functions relating to the management of library events, which are small\r
+ *  pieces of code similar to ISRs which are run when a given condition is met. Each event can be fired from\r
+ *  multiple places in the user or library code, which may or may not be inside an ISR, thus each handler\r
+ *  should be written to be as small and fast as possible to prevent possible problems.\r
+ *\r
+ *  Events can be hooked by the user application by declaring a handler function with the same name and parameters\r
+ *  listed here. If an event with no user-associated handler is fired within the library, it by default maps to an\r
+ *  internal empty stub function.\r
+ *\r
+ *  Each event must only have one associated event handler, but can be raised by multiple sources by calling the\r
+ *  event handler function (with any required event parameters).\r
+ *\r
+ *  \note This file should not be included directly. It is automatically included as needed by the USB driver\r
+ *        dispatch header located in LUFA/Drivers/USB/USB.h.\r
+ */\r
+\r
 /** \ingroup Group_USB\r
  *  @defgroup Group_Events USB Events\r
  *\r
 /** \ingroup Group_USB\r
  *  @defgroup Group_Events USB Events\r
  *\r
 #define __USBEVENTS_H__\r
 \r
        /* Includes: */\r
 #define __USBEVENTS_H__\r
 \r
        /* Includes: */\r
-               #if defined(__AVR32__)\r
-                       #include <avr32/io.h>\r
-               #elif defined(__AVR__)\r
-                       #include <avr/io.h>\r
-               #endif\r
+               #include <avr/io.h>\r
                \r
                #include "../../../Common/Common.h"\r
                #include "USBMode.h"\r
                \r
                #include "../../../Common/Common.h"\r
                #include "USBMode.h"\r
@@ -66,7 +81,7 @@
 \r
        /* Preprocessor Checks: */\r
                #if !defined(__INCLUDE_FROM_USB_DRIVER)\r
 \r
        /* Preprocessor Checks: */\r
                #if !defined(__INCLUDE_FROM_USB_DRIVER)\r
-                       #error Do not include this file directly. Include LUFA/Drivers/USB.h instead.\r
+                       #error Do not include this file directly. Include LUFA/Drivers/USB/USB.h instead.\r
                #endif\r
                \r
        /* Public Interface - May be used in end-application: */                        \r
                #endif\r
                \r
        /* Public Interface - May be used in end-application: */                        \r