aboutsummaryrefslogtreecommitdiffstats
path: root/LUFA/Drivers/USB/Core/UC3/Endpoint_UC3.h
diff options
context:
space:
mode:
Diffstat (limited to 'LUFA/Drivers/USB/Core/UC3/Endpoint_UC3.h')
-rw-r--r--LUFA/Drivers/USB/Core/UC3/Endpoint_UC3.h22
1 files changed, 10 insertions, 12 deletions
diff --git a/LUFA/Drivers/USB/Core/UC3/Endpoint_UC3.h b/LUFA/Drivers/USB/Core/UC3/Endpoint_UC3.h
index 2c151babc..c919effa7 100644
--- a/LUFA/Drivers/USB/Core/UC3/Endpoint_UC3.h
+++ b/LUFA/Drivers/USB/Core/UC3/Endpoint_UC3.h
@@ -199,8 +199,8 @@
/** Retrieves the maximum bank size in bytes of a given endpoint.
*
- * \note This macro will only work correctly on endpoint indexes that are compile-time constants
- * defined by the preprocessor.
+ * \attention This macro will only work correctly on endpoint indexes that are compile-time constants
+ * defined by the preprocessor.
*
* \param[in] EPIndex Endpoint number, a value between 0 and (\ref ENDPOINT_TOTAL_ENDPOINTS - 1)
*/
@@ -208,8 +208,8 @@
/** Retrieves the total number of banks supported by the given endpoint.
*
- * \note This macro will only work correctly on endpoint indexes that are compile-time constants
- * defined by the preprocessor.
+ * \attention This macro will only work correctly on endpoint indexes that are compile-time constants
+ * defined by the preprocessor.
*
* \param[in] EPIndex Endpoint number, a value between 0 and (\ref ENDPOINT_TOTAL_ENDPOINTS - 1)
*/
@@ -273,9 +273,8 @@
* More banks uses more USB DPRAM, but offers better performance. Isochronous type
* endpoints <b>must</b> have at least two banks.
*
- * \note When the \c ORDERED_EP_CONFIG compile time option is used, Endpoints <b>must</b> be configured in
- * ascending order, or bank corruption will occur.
- * \n\n
+ * \attention When the \c ORDERED_EP_CONFIG compile time option is used, Endpoints <b>must</b> be configured in
+ * ascending order, or bank corruption will occur.
*
* \note Different endpoints may have different maximum packet sizes based on the endpoint's index - refer to
* the chosen microcontroller model's datasheet to determine the maximum bank size for each endpoint.
@@ -310,9 +309,6 @@
/** Indicates the number of bytes currently stored in the current endpoint's selected bank.
*
- * \note The return width of this function may differ, depending on the maximum endpoint bank size
- * of the selected AVR model.
- *
* \ingroup Group_EndpointRW_UC3
*
* \return Total number of bytes in the currently selected Endpoint's FIFO buffer.
@@ -831,8 +827,8 @@
* \c FIXED_CONTROL_ENDPOINT_SIZE token - it is recommended that the \c FIXED_CONTROL_ENDPOINT_SIZE token
* be used in the device descriptors to ensure this.
*
- * \note This variable should be treated as read-only in the user application, and never manually
- * changed in value.
+ * \attention This variable should be treated as read-only in the user application, and never manually
+ * changed in value.
*/
#if (!defined(FIXED_CONTROL_ENDPOINT_SIZE) || defined(__DOXYGEN__))
extern uint8_t USB_Device_ControlEndpointSize;
@@ -844,6 +840,8 @@
/** Completes the status stage of a control transfer on a CONTROL type endpoint automatically,
* with respect to the data direction. This is a convenience function which can be used to
* simplify user control request handling.
+ *
+ * \note This routine should not be called on non CONTROL type endpoints.
*/
void Endpoint_ClearStatusStage(void);