diff options
author | Dean Camera <dean@fourwalledcubicle.com> | 2009-05-18 10:05:21 +0000 |
---|---|---|
committer | Dean Camera <dean@fourwalledcubicle.com> | 2009-05-18 10:05:21 +0000 |
commit | 2ee9fc707784e115d744dbc229bdc893f4bb6bc1 (patch) | |
tree | 1f4de5f6d8e2a9bfe89d3263f19f9b9ebf855812 /LUFA/Drivers/USB/HighLevel/StreamCallbacks.h | |
parent | 72c2922e38a2dfd14eb2d8e3692171704b5508f4 (diff) | |
download | lufa-2ee9fc707784e115d744dbc229bdc893f4bb6bc1.tar.gz lufa-2ee9fc707784e115d744dbc229bdc893f4bb6bc1.tar.bz2 lufa-2ee9fc707784e115d744dbc229bdc893f4bb6bc1.zip |
Rewritten event system to remove all macros, to make user code clearer.
Fixed incorrect ENDPOINT_EPNUM_MASK mask preventing endpoints above EP3 from being selected (thanks to Jonathan Oakley).
Removed STREAM_CALLBACK() macro - callbacks now use regular function definitions to clarify user code.
Removed DESCRIPTOR_COMPARATOR() macro - comparators should now use regular function definitions to clarify user code.
Diffstat (limited to 'LUFA/Drivers/USB/HighLevel/StreamCallbacks.h')
-rw-r--r-- | LUFA/Drivers/USB/HighLevel/StreamCallbacks.h | 34 |
1 files changed, 2 insertions, 32 deletions
diff --git a/LUFA/Drivers/USB/HighLevel/StreamCallbacks.h b/LUFA/Drivers/USB/HighLevel/StreamCallbacks.h index e739d8438..a67cc8988 100644 --- a/LUFA/Drivers/USB/HighLevel/StreamCallbacks.h +++ b/LUFA/Drivers/USB/HighLevel/StreamCallbacks.h @@ -32,7 +32,8 @@ * @defgroup Group_StreamCallbacks Endpoint and Pipe Stream Callbacks
*
* Macros and enums for the stream callback routines. This module contains the code required to easily set up
- * stream callback functions which can be used to force early abort of a stream read/write process.
+ * stream callback functions which can be used to force early abort of a stream read/write process. Each callback
+ * should take no arguments, and return a value from the \ref StreamCallback_Return_ErrorCodes_t enum.
*
* @{
*/
@@ -42,37 +43,6 @@ /* Public Interface - May be used in end-application: */
/* Macros: */
- /** Creates a prototype for or begins a stream callback routine. Stream callback routines are small
- * routines which are executed during stream read or writes (if the callback-enabled versions of
- * these functions are used) which allow the user application to abort the transfer when certain
- * arbitrary conditions are met.
- *
- * Stream callback functions should return a value from the \ref StreamCallback_Return_ErrorCodes_t
- * enum.
- *
- * Usage Example (Device Endpoint, but applicable for Host Pipes also):
- * \code
- * STREAM_CALLBACK(GlobalNotSet); // Callback Prototype
- *
- * STREAM_CALLBACK(GlobalNotSet)
- * {
- * if (MyGlobal == false)
- * return ENDPOINT_STREAMCALLBACK_Continue;
- * else
- * return ENDPOINT_STREAMCALLBACK_Abort;
- * }
- *
- * //...
- * // Inside some routine:
- * if (Endpoint_Write_Stream_LE(DataBuffer, sizeof(DataBuffer), GlobalNotSet) ==
- * ENDPOINT_RWSTREAM_ERROR_CallbackAborted)
- * {
- * // Do something when the callback aborted the transfer early
- * }
- * \endcode
- */
- #define STREAM_CALLBACK(name) uint8_t name (void)
-
/** Used with the Endpoint and Pipe stream functions as the callback function parameter, indicating that the stream
* call has no callback function to be called between USB packets.
*/
|