/** Suspends the USB bus, preventing any communications from occurring between the host and attached\r
* device until the bus has been resumed. This stops the transmission of the 1MS Start Of Frame\r
* messages to the device.\r
+ *\r
+ * \note While the USB bus is suspended, all USB interrupt sources are also disabled; this means that\r
+ * some events (such as device disconnections) will not fire until the bus is resumed.\r
*/\r
static inline void USB_Host_SuspendBus(void) ATTR_ALWAYS_INLINE;\r
static inline void USB_Host_SuspendBus(void)\r
return AVR32_USBB.UHCON.resume;\r
}\r
\r
- /* Function Prototypes: */\r
- /** Convenience function. This routine sends a SET CONFIGURATION standard request to the attached\r
- * device, with the given configuration index. This can be used to easily set the device\r
- * configuration without creating and sending the request manually.\r
- *\r
- * \note After this routine returns, the control pipe will be selected.\r
- *\r
- * \param[in] ConfigNumber Configuration index to send to the device.\r
- *\r
- * \return A value from the \ref USB_Host_SendControlErrorCodes_t enum to indicate the result.\r
- */\r
- uint8_t USB_Host_SetDeviceConfiguration(const uint8_t ConfigNumber);\r
-\r
- /** Convenience function. This routine sends a GET DESCRIPTOR standard request to the attached\r
- * device, requesting the device descriptor. This can be used to easily retrieve information\r
- * about the device such as its VID, PID and power requirements.\r
- *\r
- * \note After this routine returns, the control pipe will be selected.\r
- *\r
- * \param[out] DeviceDescriptorPtr Pointer to the destination device descriptor structure where\r
- * the read data is to be stored.\r
- *\r
- * \return A value from the \ref USB_Host_SendControlErrorCodes_t enum to indicate the result.\r
- */\r
- uint8_t USB_Host_GetDeviceDescriptor(void* const DeviceDescriptorPtr);\r
-\r
- /** Convenience function. This routine sends a GET DESCRIPTOR standard request to the attached\r
- * device, requesting the string descriptor of the specified index. This can be used to easily\r
- * retrieve string descriptors from the device by index, after the index is obtained from the\r
- * Device or Configuration descriptors.\r
- *\r
- * \note After this routine returns, the control pipe will be selected.\r
- *\r
- * \param[in] Index Index of the string index to retrieve.\r
- * \param[out] Buffer Pointer to the destination buffer where the retrieved string descriptor is\r
- * to be stored.\r
- * \param[in] BufferLength Maximum size of the string descriptor which can be stored into the buffer.\r
- *\r
- * \return A value from the \ref USB_Host_SendControlErrorCodes_t enum to indicate the result.\r
- */\r
- uint8_t USB_Host_GetDeviceStringDescriptor(const uint8_t Index,\r
- void* const Buffer,\r
- const uint8_t BufferLength);\r
-\r
- /** Clears a stall condition on the given pipe, via a CLEAR FEATURE standard request to the attached device.\r
- *\r
- * \note After this routine returns, the control pipe will be selected.\r
- *\r
- * \param[in] EndpointIndex Index of the endpoint to clear, including the endpoint's direction.\r
- *\r
- * \return A value from the \ref USB_Host_SendControlErrorCodes_t enum to indicate the result.\r
- */\r
- uint8_t USB_Host_ClearPipeStall(const uint8_t EndpointIndex);\r
-\r
- /** Selects a given alternative setting for the specified interface, via a SET INTERFACE standard request to\r
- * the attached device.\r
- *\r
- * \note After this routine returns, the control pipe will be selected.\r
- *\r
- * \param[in] InterfaceIndex Index of the interface whose alternative setting is to be altered.\r
- * \param[in] AltSetting Index of the interface's alternative setting which is to be selected.\r
- *\r
- * \return A value from the \ref USB_Host_SendControlErrorCodes_t enum to indicate the result.\r
- */\r
- uint8_t USB_Host_SetInterfaceAltSetting(const uint8_t InterfaceIndex,\r
- const uint8_t AltSetting);\r
-\r
/* Private Interface - For use in library only: */\r
#if !defined(__DOXYGEN__)\r
/* Macros: */\r
projects / pub / lufa.git / blobdiff