Statistics
| Branch: | Tag: | Revision:

root / LUFA / Drivers / USB / Core / EndpointStream.h @ 978b99e5

History | View | Annotate | Download (5.33 KB)

1
/*
2
             LUFA Library
3
     Copyright (C) Dean Camera, 2011.
4
              
5
  dean [at] fourwalledcubicle [dot] com
6
           www.lufa-lib.org
7
*/
8

    
9
/*
10
  Copyright 2011  Dean Camera (dean [at] fourwalledcubicle [dot] com)
11

12
  Permission to use, copy, modify, distribute, and sell this 
13
  software and its documentation for any purpose is hereby granted
14
  without fee, provided that the above copyright notice appear in 
15
  all copies and that both that the copyright notice and this
16
  permission notice and warranty disclaimer appear in supporting 
17
  documentation, and that the name of the author not be used in 
18
  advertising or publicity pertaining to distribution of the 
19
  software without specific, written prior permission.
20

21
  The author disclaim all warranties with regard to this
22
  software, including all implied warranties of merchantability
23
  and fitness.  In no event shall the author be liable for any
24
  special, indirect or consequential damages or any damages
25
  whatsoever resulting from loss of use, data or profits, whether
26
  in an action of contract, negligence or other tortious action,
27
  arising out of or in connection with the use or performance of
28
  this software.
29
*/
30

    
31
/** \file
32
 *  \brief Endpoint data stream transmission and reception management.
33
 *  \copydetails Group_EndpointStreamRW
34
 *
35
 *  \note This file should not be included directly. It is automatically included as needed by the USB driver
36
 *        dispatch header located in LUFA/Drivers/USB/USB.h.
37
 */
38

    
39
/** \ingroup Group_EndpointRW  
40
 *  \defgroup Group_EndpointStreamRW Read/Write of Multi-Byte Streams
41
 *  \brief Endpoint data stream transmission and reception management.
42
 *
43
 *  Functions, macros, variables, enums and types related to data reading and writing of data streams from
44
 *  and to endpoints.
45
 *
46
 *  @{
47
 */ 
48

    
49
#ifndef __ENDPOINT_STREAM_H__
50
#define __ENDPOINT_STREAM_H__
51

    
52
        /* Includes: */
53
                #include "../../../Common/Common.h"
54
                #include "USBMode.h"
55

    
56
        /* Enable C linkage for C++ Compilers: */
57
                #if defined(__cplusplus)
58
                        extern "C" {
59
                #endif
60

    
61
        /* Preprocessor Checks: */
62
                #if !defined(__INCLUDE_FROM_USB_DRIVER)
63
                        #error Do not include this file directly. Include LUFA/Drivers/USB/USB.h instead.
64
                #endif
65

    
66
        /* Public Interface - May be used in end-application: */
67
                /* Enums: */
68
                        /** Enum for the possible error return codes of the \c Endpoint_*_Stream_* functions. */
69
                        enum Endpoint_Stream_RW_ErrorCodes_t
70
                        {
71
                                ENDPOINT_RWSTREAM_NoError            = 0, /**< Command completed successfully, no error. */
72
                                ENDPOINT_RWSTREAM_EndpointStalled    = 1, /**< The endpoint was stalled during the stream
73
                                                                           *   transfer by the host or device.
74
                                                                           */
75
                                ENDPOINT_RWSTREAM_DeviceDisconnected = 2, /**< Device was disconnected from the host during
76
                                                                           *   the transfer.
77
                                                                           */
78
                                ENDPOINT_RWSTREAM_BusSuspended       = 3, /**< The USB bus has been suspended by the host and
79
                                                                           *   no USB endpoint traffic can occur until the bus
80
                                                                           *   has resumed.
81
                                                                           */
82
                                ENDPOINT_RWSTREAM_Timeout            = 4, /**< The host failed to accept or send the next packet
83
                                                                           *   within the software timeout period set by the
84
                                                                           *   \ref USB_STREAM_TIMEOUT_MS macro.
85
                                                                           */
86
                                ENDPOINT_RWSTREAM_IncompleteTransfer = 5, /**< Indicates that the endpoint bank became full or empty before
87
                                                                           *   the complete contents of the current stream could be
88
                                                                           *   transferred. The endpoint stream function should be called
89
                                                                           *   again to process the next chunk of data in the transfer.
90
                                                                           */
91
                        };
92
                        
93
                        /** Enum for the possible error return codes of the \c Endpoint_*_Control_Stream_* functions. */
94
                        enum Endpoint_ControlStream_RW_ErrorCodes_t
95
                        {
96
                                ENDPOINT_RWCSTREAM_NoError            = 0, /**< Command completed successfully, no error. */
97
                                ENDPOINT_RWCSTREAM_HostAborted        = 1, /**< The aborted the transfer prematurely. */
98
                                ENDPOINT_RWCSTREAM_DeviceDisconnected = 2, /**< Device was disconnected from the host during
99
                                                                            *   the transfer.
100
                                                                            */
101
                                ENDPOINT_RWCSTREAM_BusSuspended       = 3, /**< The USB bus has been suspended by the host and
102
                                                                            *   no USB endpoint traffic can occur until the bus
103
                                                                            *   has resumed.
104
                                                                            */
105
                        };
106

    
107
        /* Architecture Includes: */
108
                #if (ARCH == ARCH_AVR8)
109
                        #include "AVR8/EndpointStream_AVR8.h"
110
                #elif (ARCH == ARCH_UC3)
111
                        #include "UC3/EndpointStream_UC3.h"
112
                #elif (ARCH == ARCH_XMEGA)
113
                        #include "XMEGA/EndpointStream_XMEGA.h"        
114
                #endif
115

    
116
        /* Disable C linkage for C++ Compilers: */
117
                #if defined(__cplusplus)
118
                        }
119
                #endif
120

    
121
#endif
122

    
123
/** @} */
124