Fix MIT license language to make its intent clearer.
[pub/USBasp.git] / LUFA / Drivers / USB / LowLevel / LowLevel.c
1 /*
2 LUFA Library
3 Copyright (C) Dean Camera, 2009.
4
5 dean [at] fourwalledcubicle [dot] com
6 www.fourwalledcubicle.com
7 */
8
9 /*
10 Copyright 2009 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 #include "LowLevel.h"
32
33 #if (!defined(USB_HOST_ONLY) && !defined(USB_DEVICE_ONLY))
34 volatile uint8_t USB_CurrentMode = USB_MODE_NONE;
35 #endif
36
37 #if !defined(USE_STATIC_OPTIONS)
38 volatile uint8_t USB_Options;
39 #endif
40
41 void USB_Init(
42 #if defined(USB_CAN_BE_BOTH)
43 const uint8_t Mode
44 #endif
45
46 #if (defined(USB_CAN_BE_BOTH) && !defined(USE_STATIC_OPTIONS))
47 ,
48 #elif (!defined(USB_CAN_BE_BOTH) && defined(USE_STATIC_OPTIONS))
49 void
50 #endif
51
52 #if !defined(USE_STATIC_OPTIONS)
53 const uint8_t Options
54 #endif
55 )
56 {
57 #if defined(USB_CAN_BE_BOTH)
58 USB_CurrentMode = Mode;
59 #endif
60
61 #if !defined(USE_STATIC_OPTIONS)
62 USB_Options = Options;
63 #endif
64
65 #if defined(USB_CAN_BE_HOST)
66 USB_ControlPipeSize = PIPE_CONTROLPIPE_DEFAULT_SIZE;
67 #endif
68
69 #if defined(USB_DEVICE_ONLY) && (defined(USB_SERIES_6_AVR) || defined(USB_SERIES_7_AVR))
70 UHWCON |= (1 << UIMOD);
71 #elif defined(USB_HOST_ONLY)
72 UHWCON &= ~(1 << UIMOD);
73 #elif defined(USB_CAN_BE_BOTH)
74 if (Mode == USB_MODE_UID)
75 {
76 UHWCON |= (1 << UIDE);
77
78 USB_INT_Clear(USB_INT_IDTI);
79 USB_INT_Enable(USB_INT_IDTI);
80
81 USB_CurrentMode = USB_GetUSBModeFromUID();
82 }
83 else if (Mode == USB_MODE_DEVICE)
84 {
85 UHWCON |= (1 << UIMOD);
86 }
87 else if (Mode == USB_MODE_HOST)
88 {
89 UHWCON &= ~(1 << UIMOD);
90 }
91 else
92 {
93 EVENT_USB_InitFailure(USB_INITERROR_NoUSBModeSpecified);
94 return;
95 }
96 #endif
97
98 USB_ResetInterface();
99
100 #if defined(USB_SERIES_4_AVR) || defined(USB_SERIES_6_AVR) || defined(USB_SERIES_7_AVR)
101 USB_OTGPAD_On();
102 #endif
103
104 USB_IsInitialized = true;
105
106 sei();
107 }
108
109 void USB_ShutDown(void)
110 {
111 USB_ResetInterface();
112 USB_Detach();
113 USB_Controller_Disable();
114
115 if (!(USB_Options & USB_OPT_MANUAL_PLL))
116 USB_PLL_Off();
117
118 #if defined(USB_SERIES_4_AVR) || defined(USB_SERIES_6_AVR) || defined(USB_SERIES_7_AVR)
119 USB_OTGPAD_Off();
120 #endif
121
122 #if defined(USB_CAN_BE_BOTH)
123 UHWCON &= ~(1 << UIDE);
124 #endif
125
126 USB_IsInitialized = false;
127
128 #if defined(USB_CAN_BE_BOTH)
129 USB_CurrentMode = USB_MODE_NONE;
130 #endif
131 }
132
133 void USB_ResetInterface(void)
134 {
135 USB_INT_DisableAllInterrupts();
136 USB_INT_ClearAllInterrupts();
137
138 #if defined(USB_CAN_BE_HOST)
139 USB_HostState = HOST_STATE_Unattached;
140 #endif
141
142 #if defined(USB_CAN_BE_DEVICE)
143 USB_DeviceState = DEVICE_STATE_Unattached;
144 USB_ConfigurationNumber = 0;
145
146 #if !defined(NO_DEVICE_REMOTE_WAKEUP)
147 USB_RemoteWakeupEnabled = false;
148 #endif
149
150 #if !defined(NO_DEVICE_SELF_POWER)
151 USB_CurrentlySelfPowered = false;
152 #endif
153 #endif
154
155 if (!(USB_Options & USB_OPT_MANUAL_PLL))
156 {
157 #if defined(USB_SERIES_4_AVR)
158 PLLFRQ = ((1 << PLLUSB) | (1 << PDIV3) | (1 << PDIV1));
159 #endif
160
161 USB_PLL_On();
162 while (!(USB_PLL_IsReady()));
163 }
164
165 USB_Controller_Reset();
166
167 #if defined(USB_CAN_BE_BOTH)
168 if (UHWCON & (1 << UIDE))
169 {
170 USB_INT_Clear(USB_INT_IDTI);
171 USB_INT_Enable(USB_INT_IDTI);
172 USB_CurrentMode = USB_GetUSBModeFromUID();
173 }
174 #endif
175
176 if (!(USB_Options & USB_OPT_REG_DISABLED))
177 USB_REG_On();
178 else
179 USB_REG_Off();
180
181 USB_CLK_Unfreeze();
182
183 #if (defined(USB_CAN_BE_DEVICE) && (defined(USB_SERIES_4_AVR) || defined(USB_SERIES_6_AVR) || defined(USB_SERIES_7_AVR)))
184 if (USB_CurrentMode == USB_MODE_DEVICE)
185 {
186 if (USB_Options & USB_DEVICE_OPT_LOWSPEED)
187 USB_Device_SetLowSpeed();
188 else
189 USB_Device_SetFullSpeed();
190 }
191 #endif
192
193 #if (defined(USB_CAN_BE_DEVICE) && !defined(FIXED_CONTROL_ENDPOINT_SIZE))
194 if (USB_CurrentMode == USB_MODE_DEVICE)
195 {
196 USB_Descriptor_Device_t* DeviceDescriptorPtr;
197
198 if (CALLBACK_USB_GetDescriptor((DTYPE_Device << 8), 0, (void*)&DeviceDescriptorPtr) != NO_DESCRIPTOR)
199 {
200 #if defined(USE_RAM_DESCRIPTORS)
201 USB_ControlEndpointSize = DeviceDescriptorPtr->Endpoint0Size;
202 #elif defined(USE_EEPROM_DESCRIPTORS)
203 USB_ControlEndpointSize = eeprom_read_byte(&DeviceDescriptorPtr->Endpoint0Size);
204 #else
205 USB_ControlEndpointSize = pgm_read_byte(&DeviceDescriptorPtr->Endpoint0Size);
206 #endif
207 }
208 }
209 #endif
210
211 USB_Attach();
212
213 #if defined(USB_DEVICE_ONLY)
214 USB_INT_Clear(USB_INT_SUSPEND);
215 USB_INT_Enable(USB_INT_SUSPEND);
216 USB_INT_Clear(USB_INT_EORSTI);
217 USB_INT_Enable(USB_INT_EORSTI);
218
219 #if defined(USB_SERIES_4_AVR) || defined(USB_SERIES_6_AVR) || defined(USB_SERIES_7_AVR)
220 USB_INT_Enable(USB_INT_VBUS);
221 #endif
222 #elif defined(USB_HOST_ONLY)
223 USB_Host_HostMode_On();
224
225 USB_Host_VBUS_Auto_Off();
226 USB_OTGPAD_Off();
227
228 USB_Host_VBUS_Manual_Enable();
229 USB_Host_VBUS_Manual_On();
230
231 USB_INT_Enable(USB_INT_SRPI);
232 USB_INT_Enable(USB_INT_BCERRI);
233 #else
234 if (USB_CurrentMode == USB_MODE_DEVICE)
235 {
236 USB_INT_Clear(USB_INT_SUSPEND);
237 USB_INT_Enable(USB_INT_SUSPEND);
238 USB_INT_Clear(USB_INT_EORSTI);
239 USB_INT_Enable(USB_INT_EORSTI);
240
241 #if defined(USB_SERIES_4_AVR) || defined(USB_SERIES_6_AVR) || defined(USB_SERIES_7_AVR)
242 USB_INT_Enable(USB_INT_VBUS);
243 #endif
244
245 #if defined(CONTROL_ONLY_DEVICE)
246 UENUM = ENDPOINT_CONTROLEP;
247 #endif
248 }
249 else if (USB_CurrentMode == USB_MODE_HOST)
250 {
251 USB_Host_HostMode_On();
252
253 USB_Host_VBUS_Auto_Off();
254 USB_OTGPAD_Off();
255
256 USB_Host_VBUS_Manual_Enable();
257 USB_Host_VBUS_Manual_On();
258
259 USB_INT_Enable(USB_INT_SRPI);
260 USB_INT_Enable(USB_INT_BCERRI);
261 }
262 #endif
263 }