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
|
/** @file
Pch Ehci PPI Init
@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
**/
#include "PchEhci.h"
#include "PchPlatformLib.h"
EFI_GUID mPeiEhciControllerPpiGuid = PEI_USB_CONTROLLER_PPI_GUID;
///
/// PPI interface function
///
STATIC
EFI_STATUS
EFIAPI
GetEhciController (
IN EFI_PEI_SERVICES **PeiServices,
IN PEI_USB_CONTROLLER_PPI *This,
IN UINT8 UsbControllerId,
OUT UINTN *ControllerType,
OUT UINTN *BaseAddress
);
///
/// Globals variable
///
STATIC PEI_USB_CONTROLLER_PPI mEhciControllerPpi = { GetEhciController };
STATIC EFI_PEI_PPI_DESCRIPTOR mPpiList = {
(EFI_PEI_PPI_DESCRIPTOR_PPI | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST),
&mPeiEhciControllerPpiGuid,
NULL
};
///
/// Helper function
///
STATIC
EFI_STATUS
EnableEhciController (
IN EFI_PEI_SERVICES **PeiServices,
IN PCH_EHCI_DEVICE *PeiPchEhciDev,
IN UINT8 UsbControllerId
);
/**
Initialize PCH EHCI PEIM
@param[in] PeiServices General purpose services available to every PEIM.
@param[in] UsbPolicyPpi PCH Usb Policy PPI
@retval EFI_SUCCESS The PCH EHCI PEIM is initialized successfully
@retval EFI_INVALID_PARAMETER UsbControllerId is out of range
@retval EFI_OUT_OF_RESOURCES Insufficient resources to create database
@retval Others All other error conditions encountered result in an ASSERT.
**/
EFI_STATUS
InitForEHCI (
IN EFI_PEI_SERVICES **PeiServices,
IN PCH_USB_POLICY_PPI *UsbPolicyPpi
)
{
EFI_STATUS Status;
UINTN Index;
PCH_EHCI_DEVICE *PeiPchEhciDev;
EFI_BOOT_MODE BootMode;
DEBUG ((EFI_D_INFO, "InitForEHCI() Start\n"));
Status = (*PeiServices)->GetBootMode (PeiServices, &BootMode);
///
/// We do not export this in S3 boot path, because it is only for recovery.
///
if (BootMode == BOOT_ON_S3_RESUME) {
return EFI_SUCCESS;
}
PeiPchEhciDev = (PCH_EHCI_DEVICE *) AllocatePool (sizeof (PCH_EHCI_DEVICE));
if (PeiPchEhciDev == NULL) {
DEBUG ((EFI_D_ERROR, "Failed to allocate memory for PeiPchEhciDev! \n"));
return EFI_OUT_OF_RESOURCES;
}
PeiPchEhciDev->EhciControllerPpi = mEhciControllerPpi;
PeiPchEhciDev->PpiList = mPpiList;
PeiPchEhciDev->PpiList.Ppi = &PeiPchEhciDev->EhciControllerPpi;
PeiPchEhciDev->TotalEhciControllers = PchEhciControllerMax;
///
/// Assign resources and enable EHCI controllers
///
if (UsbPolicyPpi->EhciMemLength < (EHCI_MEMORY_SPACE * PeiPchEhciDev->TotalEhciControllers)) {
DEBUG ((EFI_D_ERROR, "The EhciMemLength got from UsbPolicyPpi is less than the required (%0x) !\n", (EHCI_MEMORY_SPACE * PeiPchEhciDev->TotalEhciControllers)));
return EFI_INVALID_PARAMETER;
}
for (Index = 0; Index < PeiPchEhciDev->TotalEhciControllers; Index++) {
PeiPchEhciDev->MemBase[Index] = UsbPolicyPpi->EhciMemBaseAddr + EHCI_MEMORY_SPACE * Index;
Status = EnableEhciController (PeiServices, PeiPchEhciDev, (UINT8) Index);
ASSERT_EFI_ERROR (Status);
}
///
/// Install USB Controller PPI
///
Status = PeiServicesInstallPpi (&PeiPchEhciDev->PpiList);
ASSERT_EFI_ERROR (Status);
DEBUG ((EFI_D_INFO, "InitForEHCI() End\n"));
return Status;
}
///
/// PPI interface implementation
///
/**
Get EHCI controller information
@param[in] PeiServices General PEI services
@param[in] This Pointer to the PEI_EHCI_CONTROLLER_PPI
@param[in] UsbControllerId The USB controller number
@param[out] ControllerType Output: USB controller type
@param[out] BaseAddress Output: EHCI controller memory base address
@retval EFI_INVALID_PARAMETER UsbControllerId is out of range
@retval EFI_SUCCESS Function completes successfully
**/
STATIC
EFI_STATUS
EFIAPI
GetEhciController (
IN EFI_PEI_SERVICES **PeiServices,
IN PEI_USB_CONTROLLER_PPI *This,
IN UINT8 UsbControllerId,
OUT UINTN *ControllerType,
OUT UINTN *BaseAddress
)
{
PCH_EHCI_DEVICE *PeiPchEhciDev;
PeiPchEhciDev = PCH_EHCI_DEVICE_FROM_THIS (This);
if (UsbControllerId >= PeiPchEhciDev->TotalEhciControllers) {
return EFI_INVALID_PARAMETER;
}
*ControllerType = PEI_EHCI_CONTROLLER;
*BaseAddress = PeiPchEhciDev->MemBase[UsbControllerId];
return EFI_SUCCESS;
}
/**
Enable the EHCI controller
@param[in] PeiServices The general PEI services
@param[in] PeiPchEhciDev The EHCI device
@param[in] UsbControllerId The USB Controller number
@retval EFI_INVALID_PARAMETER UsbControllerId is out of range
@retval EFI_SUCCESS The function completes successfully
**/
STATIC
EFI_STATUS
EnableEhciController (
IN EFI_PEI_SERVICES **PeiServices,
IN PCH_EHCI_DEVICE *PeiPchEhciDev,
IN UINT8 UsbControllerId
)
{
UINTN BaseAddress;
UINTN EhciAddress;
PCH_SERIES PchSeries;
PchSeries = GetPchSeries();
if (UsbControllerId >= PeiPchEhciDev->TotalEhciControllers) {
return EFI_INVALID_PARAMETER;
}
BaseAddress = PeiPchEhciDev->MemBase[UsbControllerId];
EhciAddress = EFI_UNSUPPORTED;
if (PchSeries == PchH) {
EhciAddress = PCH_H_PCIE_EHCI_ADDR (UsbControllerId);
} else if (PchSeries == PchLp) {
EhciAddress = PCH_LP_PCIE_EHCI_ADDR (UsbControllerId);
}
if (EhciAddress == EFI_UNSUPPORTED) {
return EFI_INVALID_PARAMETER;
}
///
/// Assign base address register
///
MmioWrite32 ((EhciAddress + R_PCH_EHCI_MEM_BASE), BaseAddress);
///
/// Enable PCH EHCI register
///
MmioOr16 (
(EhciAddress + R_PCH_EHCI_COMMAND_REGISTER),
(UINT16) (B_PCH_EHCI_COMMAND_BME | B_PCH_EHCI_COMMAND_MSE)
);
return EFI_SUCCESS;
}
|
