*\r
* \note These macros are only for AVRs which support the OTG protocol, and do not exist for device-only AVRs.\r
*/\r
+ \r
+/** \ingroup Group_USB\r
+ * @defgroup Group_OTGManagement USB On The Go (OTG) Management\r
+ *\r
+ * Functions, macros, variables, enums and types related to the setup and management of dual role devices.\r
+ *\r
+ * @{\r
+ */\r
\r
#ifndef __USBOTG_H__\r
#define __USBOTG_H__\r
\r
/* Public Interface - May be used in end-application: */\r
/* Macros: */\r
- /** Initiate a Host Negotiation Protocol request. This indicates to the other connected device\r
- * that the device wishes to change device/host roles.\r
- */\r
- #define USB_OTG_DEV_Request_HNP() MACROS{ OTGCON |= (1 << HNPREQ); }MACROE\r
-\r
- /** Cancel a Host Negotiation Protocol request. This stops a pending HNP request to the other\r
- * connected device.\r
- */\r
- #define USB_OTG_DEV_Cancel_HNP_Request() MACROS{ OTGCON &= ~(1 << HNPREQ); }MACROE\r
-\r
- /** Returns boolean false if not currently sending a HNP to the other connected device, or true\r
- * if a HNP is currently being issued.\r
- */\r
- #define USB_OTG_DEV_IsSendingHNP() ((OTGCON & (1 << HNPREQ)) ? true : false)\r
- \r
- /** Accepts a HNP from a connected device, indicating that both devices should exchange\r
- * device/host roles.\r
- */\r
- #define USB_OTG_HOST_Accept_HNP() USB_OTG_DEV_Request_HNP()\r
-\r
- /** Rejects a HNP from a connected device, indicating that both devices should remain in their\r
- * current device/host roles.\r
- */\r
- #define USB_OTG_HOST_Reject_HNP() USB_OTG_DEV_Cancel_HNP_Request()\r
- \r
- /** Returns boolean false if the connected device is not currently sending a HNP request, or true\r
- * if a HNP is currently being issued by the connected device.\r
- */\r
- #define USB_OTG_HOST_IsHNPReceived() ((OTGCON & (1 << HNPREQ)) ? true : false)\r
- \r
- /** Initiates a Session Request Protocol request. Most OTG devices turn off VBUS when the USB\r
- * interface is not in use, to conserve power. Sending a SRP to a USB OTG device running in\r
- * host mode indicates that VBUS should be applied and a session started.\r
- *\r
- * There are two different methods of sending a SRP - either pulses on the VBUS line, or by\r
- * pulsing the Data + line via the internal pull-up resistor. The SRP mode is given as the\r
- * "type" parameter, and can be either USB_OTG_SRP_VBUS or USB_OTG_STP_DATA.\r
- */\r
- #define USB_OTG_DEV_Initiate_SRP(type) MACROS{ OTGCON = ((OTGCON & ~(1 << SRPSEL)) | (type | (1 << SRPREQ))); }MACROE\r
-\r
/** Mask for the VBUS pulsing method of SRP, supported by some OTG devices.\r
*\r
* \see USB_OTG_DEV_Initiate_SRP()\r
*/ \r
#define USB_OTG_STP_DATA 0\r
\r
+ /* Psuedo-Function Macros: */\r
+ #if defined(__DOXYGEN__)\r
+ /** Initiate a Host Negotiation Protocol request. This indicates to the other connected device\r
+ * that the device wishes to change device/host roles.\r
+ */\r
+ static inline void USB_OTG_DEV_Request_HNP(void);\r
+ \r
+ /** Cancel a Host Negotiation Protocol request. This stops a pending HNP request to the other\r
+ * connected device.\r
+ */\r
+ static inline void USB_OTG_DEV_Cancel_HNP_Request(void);\r
+ \r
+ /** Determines if the device is currently sending a HNP to an attached host.\r
+ *\r
+ * \return Boolean true if currently sending a HNP to the other connected device, false otherwise\r
+ */\r
+ static inline bool USB_OTG_DEV_IsSendingHNP(void);\r
+ \r
+ /** Accepts a HNP from a connected device, indicating that both devices should exchange\r
+ * device/host roles.\r
+ */\r
+ static inline void USB_OTG_HOST_Accept_HNP(void);\r
+ \r
+ /** Rejects a HNP from a connected device, indicating that both devices should remain in their\r
+ * current device/host roles.\r
+ */\r
+ static inline void USB_OTG_HOST_Reject_HNP(void);\r
+ \r
+ /** Indicates if the connected device is not currently sending a HNP request.\r
+ *\r
+ * \return Boolean true if a HNP is currently being issued by the connected device, false otherwise.\r
+ */\r
+ static inline bool USB_OTG_HOST_IsHNPReceived(void);\r
+ \r
+ /** Initiates a Session Request Protocol request. Most OTG devices turn off VBUS when the USB\r
+ * interface is not in use, to conserve power. Sending a SRP to a USB OTG device running in\r
+ * host mode indicates that VBUS should be applied and a session started.\r
+ *\r
+ * There are two different methods of sending a SRP - either pulses on the VBUS line, or by\r
+ * pulsing the Data + line via the internal pull-up resistor.\r
+ *\r
+ * \param SRPTypeMask Mask indicating the type of SRP to use, either USB_OTG_SRP_VBUS or USB_OTG_STP_DATA.\r
+ */\r
+ static inline void USB_OTG_DEV_Initiate_SRP(uint8_t SRPTypeMask);\r
+ #else\r
+\r
+ #define USB_OTG_DEV_Request_HNP() MACROS{ OTGCON |= (1 << HNPREQ); }MACROE\r
+\r
+ #define USB_OTG_DEV_Cancel_HNP_Request() MACROS{ OTGCON &= ~(1 << HNPREQ); }MACROE\r
+\r
+ #define USB_OTG_DEV_IsSendingHNP() ((OTGCON & (1 << HNPREQ)) ? true : false)\r
+ \r
+ #define USB_OTG_HOST_Accept_HNP() MACROS{ OTGCON |= (1 << HNPREQ); }MACROE\r
+\r
+ #define USB_OTG_HOST_Reject_HNP() MACROS{ OTGCON &= ~(1 << HNPREQ); }MACROE\r
+ \r
+ #define USB_OTG_HOST_IsHNPReceived() ((OTGCON & (1 << HNPREQ)) ? true : false)\r
+ \r
+ #define USB_OTG_DEV_Initiate_SRP(type) MACROS{ OTGCON = ((OTGCON & ~(1 << SRPSEL)) | (type | (1 << SRPREQ))); }MACROE\r
+ #endif\r
+ \r
#endif\r
+ \r
+/** @} */\r
projects / pub / USBasp.git / blobdiff