Blame view

LUFA/Drivers/USB/Core/USBTask.h 8.46 KB
c9b6255a   dmohamed   ajout de la bibli...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
  /*
               LUFA Library
       Copyright (C) Dean Camera, 2017.
  
    dean [at] fourwalledcubicle [dot] com
             www.lufa-lib.org
  */
  
  /*
    Copyright 2017  Dean Camera (dean [at] fourwalledcubicle [dot] com)
  
    Permission to use, copy, modify, distribute, and sell this
    software and its documentation for any purpose is hereby granted
    without fee, provided that the above copyright notice appear in
    all copies and that both that the copyright notice and this
    permission notice and warranty disclaimer appear in supporting
    documentation, and that the name of the author not be used in
    advertising or publicity pertaining to distribution of the
    software without specific, written prior permission.
  
    The author disclaims all warranties with regard to this
    software, including all implied warranties of merchantability
    and fitness.  In no event shall the author be liable for any
    special, indirect or consequential damages or any damages
    whatsoever resulting from loss of use, data or profits, whether
    in an action of contract, negligence or other tortious action,
    arising out of or in connection with the use or performance of
    this software.
  */
  
  /** \file
   *  \brief Main USB service task management.
   *
   *  This file contains the function definitions required for the main USB service task, which must be called
   *  from the user application to ensure that the USB connection to or from a connected USB device is maintained.
   *
   *  \note This file should not be included directly. It is automatically included as needed by the USB driver
   *        dispatch header located in LUFA/Drivers/USB/USB.h.
   */
  
  #ifndef __USBTASK_H__
  #define __USBTASK_H__
  
  	/* Includes: */
  		#include "../../../Common/Common.h"
  		#include "USBMode.h"
  		#include "USBController.h"
  		#include "Events.h"
  		#include "StdRequestType.h"
  		#include "StdDescriptors.h"
  
  		#if defined(USB_CAN_BE_DEVICE)
  			#include "DeviceStandardReq.h"
  		#endif
  
  		#if defined(USB_CAN_BE_HOST)
  			#include "HostStandardReq.h"
  		#endif
  
  	/* Enable C linkage for C++ Compilers: */
  		#if defined(__cplusplus)
  			extern "C" {
  		#endif
  
  	/* Preprocessor Checks: */
  		#if !defined(__INCLUDE_FROM_USB_DRIVER)
  			#error Do not include this file directly. Include LUFA/Drivers/USB/USB.h instead.
  		#endif
  
  	/* Public Interface - May be used in end-application: */
  		/* Global Variables: */
  			/** Indicates if the USB interface is currently initialized but not necessarily connected to a host
  			 *  or device (i.e. if \ref USB_Init() has been run). If this is false, all other library globals related
  			 *  to the USB driver are invalid.
  			 *
  			 *  \attention This variable should be treated as read-only in the user application, and never manually
  			 *             changed in value.
  			 *
  			 *  \ingroup Group_USBManagement
  			 */
  			extern volatile bool USB_IsInitialized;
  
  			/** Structure containing the last received Control request when in Device mode (for use in user-applications
  			 *  inside of the \ref EVENT_USB_Device_ControlRequest() event, or for filling up with a control request to
  			 *  issue when in Host mode before calling \ref USB_Host_SendControlRequest().
  			 *
  			 *  \note The contents of this structure is automatically endian-corrected for the current CPU architecture.
  			 *
  			 *  \ingroup Group_USBManagement
  			 */
  			 extern USB_Request_Header_t USB_ControlRequest;
  
  			#if defined(USB_CAN_BE_HOST) || defined(__DOXYGEN__)
  				#if !defined(HOST_STATE_AS_GPIOR) || defined(__DOXYGEN__)
  					/** Indicates the current host state machine state. When in host mode, this indicates the state
  					 *  via one of the values of the \ref USB_Host_States_t enum values.
  					 *
  					 *  This value should not be altered by the user application as it is handled automatically by the
  					 *  library.
  					 *
  					 *  To reduce program size and speed up checks of this global on the AVR8 architecture, it can be
  					 *  placed into one of the AVR's \c GPIOR hardware registers instead of RAM by defining the
  					 *  \c HOST_STATE_AS_GPIOR token to a value between 0 and 2 in the project makefile and passing it to
  					 *  the compiler via the -D switch. When defined, the corresponding GPIOR register should not be used
  					 *  in the user application except implicitly via the library APIs.
  					 *
  					 *  \note This global is only present if the user application can be a USB host.
  					 *
  					 *  \see \ref USB_Host_States_t for a list of possible device states.
  					 *
  					 *  \ingroup Group_Host
  					 */
  					extern volatile uint8_t USB_HostState;
  				#else
  					#define USB_HostState            CONCAT_EXPANDED(GPIOR, HOST_STATE_AS_GPIOR)
  				#endif
  			#endif
  
  			#if defined(USB_CAN_BE_DEVICE) || defined(__DOXYGEN__)
  				#if !defined(DEVICE_STATE_AS_GPIOR) || defined(__DOXYGEN__)
  					/** Indicates the current device state machine state. When in device mode, this indicates the state
  					 *  via one of the values of the \ref USB_Device_States_t enum values.
  					 *
  					 *  This value should not be altered by the user application as it is handled automatically by the
  					 *  library. The only exception to this rule is if the NO_LIMITED_CONTROLLER_CONNECT token is used
  					 *  (see \ref EVENT_USB_Device_Connect() and \ref EVENT_USB_Device_Disconnect() events).
  					 *
  					 *  To reduce program size and speed up checks of this global on the AVR8 architecture, it can be
  					 *  placed into one of the AVR's \c GPIOR hardware registers instead of RAM by defining the
  					 *  \c DEVICE_STATE_AS_GPIOR token to a value between 0 and 2 in the project makefile and passing it to
  					 *  the compiler via the -D switch. When defined, the corresponding GPIOR register should not be used
  					 *  in the user application except implicitly via the library APIs.
  					 *
  					 *  \attention This variable should be treated as read-only in the user application, and never manually
  					 *             changed in value except in the circumstances outlined above.
  					 *
  					 *  \note This global is only present if the user application can be a USB device.
  					 *        \n\n
  					 *
  					 *  \see \ref USB_Device_States_t for a list of possible device states.
  					 *
  					 *  \ingroup Group_Device
  					 */
  					extern volatile uint8_t USB_DeviceState;
  				#else
  					#define USB_DeviceState            CONCAT_EXPANDED(GPIOR, DEVICE_STATE_AS_GPIOR)
  				#endif
  			#endif
  
  		/* Function Prototypes: */
  			/** This is the main USB management task. The USB driver requires this task to be executed
  			 *  continuously when the USB system is active (device attached in host mode, or attached to a host
  			 *  in device mode) in order to manage USB communications. This task may be executed inside an RTOS,
  			 *  fast timer ISR or the main user application loop.
  			 *
  			 *  The USB task must be serviced within 30ms while in device mode, or within 1ms while in host mode.
  			 *  The task may be serviced at all times, or (for minimum CPU consumption):
  			 *
  			 *    - In device mode, it may be disabled at start-up, enabled on the firing of the \ref EVENT_USB_Device_Connect()
  			 *      event and disabled again on the firing of the \ref EVENT_USB_Device_Disconnect() event.
  			 *
  			 *    - In host mode, it may be disabled at start-up, enabled on the firing of the \ref EVENT_USB_Host_DeviceAttached()
  			 *      event and disabled again on the firing of the \ref EVENT_USB_Host_DeviceEnumerationComplete() or
  			 *      \ref EVENT_USB_Host_DeviceEnumerationFailed() events.
  			 *
  			 *  If in device mode (only), the control endpoint can instead be managed via interrupts entirely by the library
  			 *  by defining the INTERRUPT_CONTROL_ENDPOINT token and passing it to the compiler via the -D switch.
  			 *
  			 *  \see \ref Group_Events for more information on the USB events.
  			 *
  			 *  \ingroup Group_USBManagement
  			 */
  			void USB_USBTask(void);
  
  	/* Private Interface - For use in library only: */
  	#if !defined(__DOXYGEN__)
  		/* Function Prototypes: */
  			#if defined(__INCLUDE_FROM_USBTASK_C)
  				#if defined(USB_CAN_BE_HOST)
  					static void USB_HostTask(void);
  				#endif
  
  				#if defined(USB_CAN_BE_DEVICE)
  					static void USB_DeviceTask(void);
  				#endif
  			#endif
  
  		/* Macros: */
  			#define HOST_TASK_NONBLOCK_WAIT(Duration, NextState) do { USB_HostState   = HOST_STATE_WaitForDevice; \
  			                                                          WaitMSRemaining = (Duration);               \
  			                                                          PostWaitState   = (NextState);              } while (0)
  	#endif
  
  	/* Disable C linkage for C++ Compilers: */
  		#if defined(__cplusplus)
  			}
  		#endif
  
  #endif