Add missing doxygen group terminator to the new CompilerSpecific.h header file.
[pub/USBasp.git] / LUFA / Drivers / USB / Core / UC3 / Pipe_UC3.c
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 #define __INCLUDE_FROM_USB_DRIVER
32 #include "../USBMode.h"
33
34 #if defined(USB_CAN_BE_HOST)
35
36 #include "../Pipe.h"
37
38 uint8_t USB_ControlPipeSize = PIPE_CONTROLPIPE_DEFAULT_SIZE;
39
40 volatile uint32_t USB_SelectedPipe = PIPE_CONTROLPIPE;
41 volatile uint8_t* USB_PipeFIFOPos[PIPE_TOTAL_PIPES];
42
43 bool Pipe_ConfigurePipe(const uint8_t Number,
44 const uint8_t Type,
45 const uint8_t Token,
46 const uint8_t EndpointNumber,
47 const uint16_t Size,
48 const uint8_t Banks)
49 {
50 Pipe_SelectPipe(Number);
51 Pipe_EnablePipe();
52
53 (&AVR32_USBB.upcfg0)[Number] = 0;
54 (&AVR32_USBB.upcfg0)[Number] = (AVR32_USBB_ALLOC_MASK |
55 ((uint32_t)Type << AVR32_USBB_PTYPE_OFFSET) |
56 ((uint32_t)Token << AVR32_USBB_PTOKEN_OFFSET) |
57 ((uint32_t)Banks << AVR32_USBB_PBK_OFFSET) |
58 ((EndpointNumber & PIPE_EPNUM_MASK) << AVR32_USBB_PEPNUM_OFFSET));
59 USB_PipeFIFOPos[Number] = &AVR32_USBB_SLAVE[Number * 0x10000];
60
61 Pipe_SetInfiniteINRequests();
62
63 return Pipe_IsConfigured();
64 }
65
66 void Pipe_ClearPipes(void)
67 {
68 for (uint8_t PNum = 0; PNum < PIPE_TOTAL_PIPES; PNum++)
69 {
70 Pipe_SelectPipe(PNum);
71 (&AVR32_USBB.upcfg0)[PNum] = 0;
72 (&AVR32_USBB.upcon0clr)[PNum] = -1;
73 USB_PipeFIFOPos[PNum] = &AVR32_USBB_SLAVE[PNum * 0x10000];
74 Pipe_DisablePipe();
75 }
76 }
77
78 bool Pipe_IsEndpointBound(const uint8_t EndpointAddress)
79 {
80 uint8_t PrevPipeNumber = Pipe_GetCurrentPipe();
81
82 for (uint8_t PNum = 0; PNum < PIPE_TOTAL_PIPES; PNum++)
83 {
84 Pipe_SelectPipe(PNum);
85
86 if (!(Pipe_IsConfigured()))
87 continue;
88
89 if (Pipe_GetBoundEndpointAddress() == EndpointAddress)
90 return true;
91 }
92
93 Pipe_SelectPipe(PrevPipeNumber);
94 return false;
95 }
96
97 uint8_t Pipe_WaitUntilReady(void)
98 {
99 #if (USB_STREAM_TIMEOUT_MS < 0xFF)
100 uint8_t TimeoutMSRem = USB_STREAM_TIMEOUT_MS;
101 #else
102 uint16_t TimeoutMSRem = USB_STREAM_TIMEOUT_MS;
103 #endif
104
105 uint16_t PreviousFrameNumber = USB_Host_GetFrameNumber();
106
107 for (;;)
108 {
109 if (Pipe_GetPipeToken() == PIPE_TOKEN_IN)
110 {
111 if (Pipe_IsINReceived())
112 return PIPE_READYWAIT_NoError;
113 }
114 else
115 {
116 if (Pipe_IsOUTReady())
117 return PIPE_READYWAIT_NoError;
118 }
119
120 if (Pipe_IsStalled())
121 return PIPE_READYWAIT_PipeStalled;
122 else if (USB_HostState == HOST_STATE_Unattached)
123 return PIPE_READYWAIT_DeviceDisconnected;
124
125 uint16_t CurrentFrameNumber = USB_Host_GetFrameNumber();
126
127 if (CurrentFrameNumber != PreviousFrameNumber)
128 {
129 PreviousFrameNumber = CurrentFrameNumber;
130
131 if (!(TimeoutMSRem--))
132 return PIPE_READYWAIT_Timeout;
133 }
134 }
135 }
136
137 #endif
138