X-Git-Url: http://git.linex4red.de/pub/USBasp.git/blobdiff_plain/4a8ac5e474741f14492597880e751b3f806cb965..05fa6e0c43e542459000c7ebe0b10cbe24c7f5d9:/LUFA/Drivers/USB/HighLevel/Events.h diff --git a/LUFA/Drivers/USB/HighLevel/Events.h b/LUFA/Drivers/USB/HighLevel/Events.h index 2044a503d..4042d4670 100644 --- a/LUFA/Drivers/USB/HighLevel/Events.h +++ b/LUFA/Drivers/USB/HighLevel/Events.h @@ -38,8 +38,7 @@ * * Events can be hooked by the user application by declaring a handler function with the same name and parameters * listed here. If an event with no user-associated handler is fired within the library, it by default maps to an - * internal empty stub function. This trasparent hook system is achieved through the use of the GCC compiler's - * "alias" attribute. + * internal empty stub function. * * Each event must only have one associated event handler, but can be raised by multiple sources. * @@ -99,7 +98,7 @@ * which is not always accurate (host may suspend the bus while still connected). If the actual connection state * needs to be determined, VBUS should be routed to an external pin, and the auto-detect behaviour turned off by * passing the NO_LIMITED_CONTROLLER_CONNECT token to the compiler via the -D switch at compile time. The connection - * and disconnection events may be manually fired, and the \ref USB_IsConnected global changed manually. + * and disconnection events may be manually fired, and the \ref USB_DeviceState global changed manually. * * \see USBTask.h for more information on the USB management task and reducing CPU usage. */ @@ -117,7 +116,7 @@ * which is not always accurate (host may suspend the bus while still connected). If the actual connection state * needs to be determined, VBUS should be routed to an external pin, and the auto-detect behaviour turned off by * passing the NO_LIMITED_CONTROLLER_CONNECT token to the compiler via the -D switch at compile time. The connection - * and disconnection events may be manually fired, and the \ref USB_IsConnected global changed manually. + * and disconnection events may be manually fired, and the \ref USB_DeviceState global changed manually. * * \see USBTask.h for more information on the USB management task and reducing CPU usage. */ @@ -128,14 +127,14 @@ * * \note This event only exists on USB AVR models which support dual role modes. * - * \param ErrorCode Error code indicating the failure reason, a value in \ref USB_InitErrorCodes_t + * \param[in] ErrorCode Error code indicating the failure reason, a value in \ref USB_InitErrorCodes_t */ void EVENT_USB_InitFailure(const uint8_t ErrorCode); /** Event for USB mode pin level change. This event fires when the USB interface is set to dual role * mode, and the UID pin level has changed to indicate a new mode (device or host). This event fires - * before the mode is switched to the newly indicated mode but after the \ref USB_Disconnect event has - * fired (if connected before the role change). + * before the mode is switched to the newly indicated mode but after the \ref EVENT_USB_Disconnect event + * has fired (if connected before the role change). * * \note This event only exists on USB AVR models which support dual role modes. * @@ -147,7 +146,7 @@ /** Event for USB host error. This event fires when a hardware fault has occurred whilst the USB * interface is in host mode. * - * \param ErrorCode Error code indicating the failure reason, a value in \ref USB_Host_ErrorCodes_t + * \param[in] ErrorCode Error code indicating the failure reason, a value in \ref USB_Host_ErrorCodes_t * * \note This event only exists on USB AVR models which supports host mode. * @@ -166,7 +165,7 @@ * \note This event does not exist if the USB_DEVICE_ONLY token is supplied to the compiler (see * \ref Group_USBManagement documentation). * - * \see \ref TASK(USB_USBTask) for more information on the USB management task and reducing CPU usage. + * \see \ref USB_USBTask() for more information on the USB management task and reducing CPU usage. */ void EVENT_USB_DeviceAttached(void); @@ -179,19 +178,19 @@ * \note This event does not exist if the USB_DEVICE_ONLY token is supplied to the compiler (see * \ref Group_USBManagement documentation). * - * \see \ref TASK(USB_USBTask) for more information on the USB management task and reducing CPU usage. + * \see \ref USB_USBTask() for more information on the USB management task and reducing CPU usage. */ void EVENT_USB_DeviceUnattached(void); /** Event for USB device enumeration failure. This event fires when a the USB interface is * in host mode, and an attached USB device has failed to enumerate completely. * - * \param ErrorCode Error code indicating the failure reason, a value in - * \ref USB_Host_EnumerationErrorCodes_t + * \param[in] ErrorCode Error code indicating the failure reason, a value in + * \ref USB_Host_EnumerationErrorCodes_t * - * \param SubErrorCode Sub error code indicating the reason for failure - for example, if the - * ErrorCode parameter indicates a control error, this will give the error - * code returned by the \ref USB_Host_SendControlRequest() function. + * \param[in] SubErrorCode Sub error code indicating the reason for failure - for example, if the + * ErrorCode parameter indicates a control error, this will give the error + * code returned by the \ref USB_Host_SendControlRequest() function. * * \note This event only exists on USB AVR models which supports host mode. * @@ -268,17 +267,6 @@ * \ref Group_USBManagement documentation). */ void EVENT_USB_Reset(void); - - /** Event for USB device mode error. This event fires when the USB interface is in device mode, - * and an error occurs which prevents it from operating normally. - * - * \param ErrorCode Error code indicating the source of the error, a value in - * \ref USB_Device_ErrorCodes_t - * - * \note This event does not exist if the USB_HOST_ONLY token is supplied to the compiler (see - * \ref Group_USBManagement documentation). - */ - void EVENT_USB_DeviceError(const uint8_t ErrorCode); #endif /* Private Interface - For use in library only: */ @@ -287,7 +275,7 @@ #if defined(INCLUDE_FROM_EVENTS_C) void USB_Event_Stub(void) ATTR_CONST; - #if defined(USB_FULL_CONTROLLER) || defined(USB_MODIFIED_FULL_CONTROLLER) + #if (defined(USB_SERIES_4_AVR) || defined(USB_SERIES_6_AVR) || defined(USB_SERIES_7_AVR)) void EVENT_USB_VBUSChange(void) ATTR_WEAK ATTR_ALIAS(USB_Event_Stub); void EVENT_USB_VBUSConnect(void) ATTR_WEAK ATTR_ALIAS(USB_Event_Stub); void EVENT_USB_VBUSDisconnect(void) ATTR_WEAK ATTR_ALIAS(USB_Event_Stub); @@ -315,7 +303,6 @@ void EVENT_USB_Suspend(void) ATTR_WEAK ATTR_ALIAS(USB_Event_Stub); void EVENT_USB_WakeUp(void) ATTR_WEAK ATTR_ALIAS(USB_Event_Stub); void EVENT_USB_Reset(void) ATTR_WEAK ATTR_ALIAS(USB_Event_Stub); - void EVENT_USB_DeviceError(const uint8_t ErrorCode) ATTR_WEAK ATTR_ALIAS(USB_Event_Stub); #endif #endif