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
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
|
/** @file
Header file for the PCH USB Common Driver.
@copyright
Copyright (c) 2009 - 2012 Intel Corporation. All rights reserved
This software and associated documentation (if any) is furnished
under a license and may only be used or copied in accordance
with the terms of the license. Except as permitted by such
license, no part of this software or documentation may be
reproduced, stored in a retrieval system, or transmitted in any
form or by any means without the express written consent of
Intel Corporation.
This file contains an 'Intel Peripheral Driver' and uniquely
identified as "Intel Reference Module" and is
licensed for Intel CPUs and chipsets under the terms of your
license agreement with Intel or your vendor. This file may
be modified by the user, subject to additional terms of the
license agreement
**/
#ifndef _USB_COMMON_H_
#define _USB_COMMON_H_
#if !defined(EDK_RELEASE_VERSION) || (EDK_RELEASE_VERSION < 0x00020000)
#include "EdkIIGlueBase.h"
#include "PchAccess.h"
#include "PchPlatformLib.h"
#include "PchInitCommon.h"
#endif
#define USB_PR_CASE_0 0
#define USB_PR_CASE_1 1
#define USB_PR_CASE_2 2
#define TEN_MS_TIMEOUT 10000
#define PORT_RESET_TIMEOUT 10 ///< 100 ms timeout for xHCI port reset
typedef struct {
UINT8 Device;
UINT8 Function;
} USB_CONTROLLER;
/**
Configures PCH USB controller
@param[in] UsbConfig The PCH Platform Policy for USB configuration
@param[in] EhciMmioBase Memory base address of EHCI Controller
@param[in] XhciMmioBase Memory base address of XHCI Controller
@param[in] BusNumber PCI Bus Number of the PCH device
@param[in] RootComplexBar RootComplexBar value of this PCH device
@param[out] FuncDisableReg Function Disable Register
@param[in] Revision The policy revision used for backward compatible check
@retval EFI_INVALID_PARAMETER The parameter of PchPlatformPolicy is invalid
@retval EFI_SUCCESS The function completed successfully
**/
EFI_STATUS
EFIAPI
CommonUsbInit (
IN PCH_USB_CONFIG *UsbConfig,
IN UINT32 EhciMmioBase,
IN UINT32 XhciMmioBase,
IN UINT8 BusNumber,
IN UINT32 RootComplexBar,
OUT UINT32 *FuncDisableReg,
IN UINT8 Revision
);
/**
Performs basic configuration of PCH EHCI controller.
@param[in] UsbConfig The PCH Platform Policy for USB configuration
@param[in] EhciMmioBase Memory base address of EHCI Controller
@param[in] BusNumber PCI Bus Number of the PCH device
@param[in] Revision The policy revision used for backward compatible check
@param[in] LpcDeviceId The device ID of LPC
@param[in] RootComplexBar RootComplexBar value of this PCH device
@retval EFI_SUCCESS The function completed successfully
**/
EFI_STATUS
EFIAPI
CommonEhciHcsInit (
IN PCH_USB_CONFIG *UsbConfig,
IN UINT32 EhciMmioBase,
IN UINT8 BusNumber,
IN UINT8 Revision,
IN UINT16 LpcDeviceId,
IN UINT32 RootComplexBar
);
/**
Performs basic configuration of PCH USB3 (xHCI) controller.
@param[in] UsbConfig The PCH Platform Policy for USB configuration
@param[in] XhciMmioBase Memory base address of xHCI Controller
@param[in] Revision The policy revision used for backward compatible check
@param[in] LpcDeviceId The device ID of LPC
@param[in] XhciPciMmBase XHCI PCI Base Address
@retval None
**/
VOID
CommonXhciHcInit (
IN PCH_USB_CONFIG *UsbConfig,
IN UINT32 XhciMmioBase,
IN UINT8 Revision,
IN UINT16 LpcDeviceId,
IN UINTN XhciPciMmBase
);
/**
Performs basic configuration of PCH USB3 (xHCI) controller.
@param[in] UsbConfig The PCH Platform Policy for USB configuration
@param[in] XhciMmioBase Memory base address of XHCI Controller
@param[in] Revision The policy revision used for backward compatible check
@param[in] LpcDeviceId The device ID of LPC
@param[in] XhciPciMmBase XHCI PCI Base Address
@param[in] PciD31F0RegBase LPC PCI Base Address
@retval None
**/
VOID
PerformXhciEhciPortSwitchingFlow (
IN PCH_USB_CONFIG *UsbConfig,
IN UINT32 XhciMmioBase,
IN UINT8 Revision,
IN UINT16 LpcDeviceId,
IN UINTN XhciPciMmBase,
IN UINTN PciD31F0RegBase
);
/**
Retrieves information about number of implemented xHCI ports
and sets appropriate port mask registers.
@param[in] XhciPciMmBase XHCI PCI Base Address
@param[out] HsPortCount Count of High Speed Ports
@param[out] HsUsbrPortCount Count of USBr Port
@param[out] SsPortCount Count of Super Speed Ports
@retval None
**/
VOID
GetXhciPortCountAndSetPortRoutingMask (
IN UINTN XhciPciMmBase,
OUT UINTN *HsPortCount,
OUT UINTN *HsUsbrPortCount,
OUT UINTN *SsPortCount
);
/**
Setup XHCI Over-Current Mapping
@param[in] UsbConfig The PCH Platform Policy for USB configuration
@param[in] XhciPciMmBase XHCI PCI Base Address
@retval None
**/
VOID
XhciOverCurrentMapping (
IN PCH_USB_CONFIG *UsbConfig,
IN UINTN XhciPciMmBase
);
/**
Setup EHCI Over-Current Mapping
@param[in] UsbConfig The PCH Platform Policy for USB configuration
@param[in] Ehci1PciMmBase EHCI 1 PCI Base Address
@param[in] Ehci2PciMmBase EHCI 2 PCI Base Address
@retval None
**/
VOID
EhciOverCurrentMapping (
IN PCH_USB_CONFIG *UsbConfig,
IN UINTN Ehci1PciMmBase,
IN UINTN Ehci2PciMmBase
);
/**
Program Ehci Port Disable Override
@param[in] UsbConfig The PCH Platform Policy for USB configuration
@param[in] Ehci1PciMmBase EHCI 1 PCI Base Address
@param[in] Ehci2PciMmBase EHCI 2 PCI Base Address
@retval None
**/
VOID
EhciPortDisableOverride (
IN PCH_USB_CONFIG *UsbConfig,
IN UINTN Ehci1PciMmBase,
IN UINTN Ehci2PciMmBase
);
/**
Program Xhci Port Disable Override
@param[in] UsbConfig The PCH Platform Policy for USB configuration
@param[in] XhciPciMmBase XHCI PCI Base Address
@param[in] Revision Platform policy revision
@retval None
**/
VOID
XhciPortDisableOverride (
IN PCH_USB_CONFIG *UsbConfig,
IN UINTN XhciPciMmBase,
IN UINT8 Revision
);
/**
Enable EHCI USBR device
@param[in] EhciPciMmBase Ehci PCI Base Address
@retval None
**/
VOID
EhciUsbrEnable (
IN UINTN EhciPciMmBase
);
/**
Program and enable XHCI Memory Space
@param[in] UsbConfig The PCH Platform Policy for USB configuration
@param[in] XhciMmioBase Memory base address of XHCI Controller
@param[in] XhciPciMmBase XHCI PCI Base Address
@retval None
**/
VOID
XhciMemorySpaceOpen (
IN PCH_USB_CONFIG *UsbConfig,
IN UINT32 XhciMmioBase,
IN UINTN XhciPciMmBase
);
/**
Clear and disable XHCI Memory Space
@param[in] UsbConfig The PCH Platform Policy for USB configuration
@param[in] XhciMmioBase Memory base address of XHCI Controller
@param[in] XhciPciMmBase XHCI PCI Base Address
@retval None
**/
VOID
XhciMemorySpaceClose (
IN PCH_USB_CONFIG *UsbConfig,
IN UINT32 XhciMmioBase,
IN UINTN XhciPciMmBase
);
/**
Tune the USB 2.0 high-speed signals quality.
@param[in] UsbConfig The PCH Platform Policy for USB configuration
@param[in] LpcDeviceId The device ID of LPC
@param[in] RootComplexBar RootComplexBar value of this PCH device
@retval None
**/
VOID
Usb2PortLengthProgramming (
IN PCH_USB_CONFIG *UsbConfig,
IN UINT16 LpcDeviceId,
IN UINT32 RootComplexBar
);
/**
Initialization USB Clock Gating registers
@param[in] PchPlatformPolicy The PCH Platform Policy
@param[in] RootComplexBar RootComplexBar value of this PCH device
@retval None
**/
VOID
ConfigureUsbClockGating (
IN DXE_PCH_PLATFORM_POLICY_PROTOCOL *PchPlatformPolicy,
IN UINT32 RootComplexBar
);
/**
Initialization EHCI Clock Gating registers
@param[in] PchPlatformPolicy The PCH Platform Policy
@param[in] RootComplexBar RootComplexBar value of this PCH device
@retval None
**/
VOID
ConfigureEhciClockGating (
IN DXE_PCH_PLATFORM_POLICY_PROTOCOL *PchPlatformPolicy,
IN UINT32 RootComplexBar
);
/**
Initialization XHCI Clock Gating registers
@param[in] PchPlatformPolicy The PCH Platform Policy
@param[in] RootComplexBar RootComplexBar value of this PCH device
@retval None
**/
VOID
ConfigureXhciClockGating (
IN DXE_PCH_PLATFORM_POLICY_PROTOCOL *PchPlatformPolicy,
IN UINT32 RootComplexBar
);
#ifdef USB_PRECONDITION_ENABLE_FLAG
/**
Perform USB precondition on EHCI, it is the HC on USB HC in PEI phase;
it is the root port reset on installed USB device in DXE phase
@param[in] Device The device number of the EHCI
@param[in] EhciMmioBase Memory base address of EHCI Controller
@retval None
**/
VOID
EhciPrecondition (
IN UINT8 Device,
IN UINT32 EhciMmioBase
);
/**
Perform USB precondition on XHCI, it is the HC on USB HC in PEI phase;
it is the root port reset on installed USB device in DXE phase
@param[in] BusNumber The Bus number of the XHCI
@param[in] Device The device number of the XHCI
@param[in] Function The function number of the XHCI
@param[in] XhciMmioBase Memory base address of XHCI Controller
@param[in] XhciUSB2Ptr Pointer to USB2 protocol port register
@param[in] HsPortCount The number of USB2 protocol port supported by this XHCI
@retval None
**/
VOID
XhciPrecondition (
IN UINT8 BusNumber,
IN UINT8 Device,
IN UINT8 Function,
IN UINT32 XhciMmioBase,
IN UINTN *XhciUSB2Ptr,
IN UINTN HsPortCount,
IN UINTN *XhciUSB3Ptr,
IN UINTN SsPortCount
);
#endif // USB_PRECONDITION_ENABLE_FLAG
#endif
|