2 EFI PCAT ISA ACPI Driver for a Generic PC Platform
4 Copyright (c) 2006 - 2017, Intel Corporation. All rights reserved.<BR>
5 This program and the accompanying materials
6 are licensed and made available under the terms and conditions of the BSD License
7 which accompanies this distribution. The full text of the license may be found at
8 http://opensource.org/licenses/bsd-license.php
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
15 #include "PcatIsaAcpi.h"
18 // PcatIsaAcpi Driver Binding Protocol
20 EFI_DRIVER_BINDING_PROTOCOL gPcatIsaAcpiDriverBinding
= {
21 PcatIsaAcpiDriverBindingSupported
,
22 PcatIsaAcpiDriverBindingStart
,
23 PcatIsaAcpiDriverBindingStop
,
30 the entry point of the PcatIsaAcpi driver.
32 @param ImageHandle Handle for driver image
33 @param SystemTable Point to EFI_SYSTEM_TABLE
35 @return Success or not for installing driver binding protocol
39 PcatIsaAcpiDriverEntryPoint (
40 IN EFI_HANDLE ImageHandle
,
41 IN EFI_SYSTEM_TABLE
*SystemTable
44 return EfiLibInstallDriverBindingComponentName2 (
47 &gPcatIsaAcpiDriverBinding
,
49 &gPcatIsaAcpiComponentName
,
50 &gPcatIsaAcpiComponentName2
55 ControllerDriver Protocol Method
57 @param This Driver Binding protocol instance pointer.
58 @param Controller Handle of device to test.
59 @param RemainingDevicePath Optional parameter use to pick a specific child
61 @retval EFI_SUCCESS This driver supports this device.
62 @retval other This driver does not support this device.
67 PcatIsaAcpiDriverBindingSupported (
68 IN EFI_DRIVER_BINDING_PROTOCOL
*This
,
69 IN EFI_HANDLE Controller
,
70 IN EFI_DEVICE_PATH_PROTOCOL
*RemainingDevicePath
74 EFI_PCI_IO_PROTOCOL
*PciIo
;
82 // Get PciIo protocol instance
84 Status
= gBS
->OpenProtocol (
86 &gEfiPciIoProtocolGuid
,
88 This
->DriverBindingHandle
,
90 EFI_OPEN_PROTOCOL_BY_DRIVER
92 if (EFI_ERROR(Status
)) {
96 Status
= PciIo
->Pci
.Read (
100 sizeof(Pci
) / sizeof(UINT32
),
103 if (!EFI_ERROR (Status
)) {
104 Status
= EFI_UNSUPPORTED
;
105 if ((Pci
.Hdr
.Command
& 0x03) == 0x03) {
106 if (Pci
.Hdr
.ClassCode
[2] == PCI_CLASS_BRIDGE
) {
108 // See if this is a standard PCI to ISA Bridge from the Base Code and Class Code
110 if (Pci
.Hdr
.ClassCode
[1] == PCI_CLASS_BRIDGE_ISA
) {
111 Status
= EFI_SUCCESS
;
115 // See if this is an Intel PCI to ISA bridge in Positive Decode Mode
117 if (Pci
.Hdr
.ClassCode
[1] == PCI_CLASS_BRIDGE_ISA_PDECODE
&&
118 Pci
.Hdr
.VendorId
== 0x8086 ) {
120 // See if this is on Function #0 to avoid false positives on
121 // PCI_CLASS_BRIDGE_OTHER that has the same value as
122 // PCI_CLASS_BRIDGE_ISA_PDECODE
124 Status
= PciIo
->GetLocation (
131 if (!EFI_ERROR (Status
) && FunctionNumber
== 0) {
132 Status
= EFI_SUCCESS
;
134 Status
= EFI_UNSUPPORTED
;
143 &gEfiPciIoProtocolGuid
,
144 This
->DriverBindingHandle
,
152 Install EFI_ISA_ACPI_PROTOCOL.
154 @param This Driver Binding protocol instance pointer.
155 @param ControllerHandle Handle of device to bind driver to.
156 @param RemainingDevicePath Optional parameter use to pick a specific child
159 @retval EFI_SUCCESS This driver is added to ControllerHandle
160 @retval EFI_ALREADY_STARTED This driver is already running on ControllerHandle
161 @retval other This driver does not support this device
165 PcatIsaAcpiDriverBindingStart (
166 IN EFI_DRIVER_BINDING_PROTOCOL
*This
,
167 IN EFI_HANDLE Controller
,
168 IN EFI_DEVICE_PATH_PROTOCOL
*RemainingDevicePath
172 EFI_PCI_IO_PROTOCOL
*PciIo
;
173 PCAT_ISA_ACPI_DEV
*PcatIsaAcpiDev
;
175 UINT64 OriginalAttributes
;
180 PcatIsaAcpiDev
= NULL
;
182 // Open the PCI I/O Protocol Interface
185 Status
= gBS
->OpenProtocol (
187 &gEfiPciIoProtocolGuid
,
189 This
->DriverBindingHandle
,
191 EFI_OPEN_PROTOCOL_BY_DRIVER
193 if (EFI_ERROR (Status
)) {
198 // Get supported PCI attributes
200 Status
= PciIo
->Attributes (
202 EfiPciIoAttributeOperationSupported
,
206 if (EFI_ERROR (Status
)) {
210 Supports
&= (UINT64
) (EFI_PCI_IO_ATTRIBUTE_ISA_IO
| EFI_PCI_IO_ATTRIBUTE_ISA_IO_16
);
211 if (Supports
== 0 || Supports
== (EFI_PCI_IO_ATTRIBUTE_ISA_IO
| EFI_PCI_IO_ATTRIBUTE_ISA_IO_16
)) {
212 Status
= EFI_UNSUPPORTED
;
216 Status
= PciIo
->Attributes (
218 EfiPciIoAttributeOperationGet
,
222 if (EFI_ERROR (Status
)) {
226 Status
= PciIo
->Attributes (
228 EfiPciIoAttributeOperationEnable
,
229 EFI_PCI_DEVICE_ENABLE
| Supports
| EFI_PCI_IO_ATTRIBUTE_ISA_MOTHERBOARD_IO
,
232 if (EFI_ERROR (Status
)) {
238 // Allocate memory for the PCAT ISA ACPI Device structure
240 PcatIsaAcpiDev
= NULL
;
241 Status
= gBS
->AllocatePool (
243 sizeof(PCAT_ISA_ACPI_DEV
),
244 (VOID
**)&PcatIsaAcpiDev
246 if (EFI_ERROR (Status
)) {
251 // Initialize the PCAT ISA ACPI Device structure
253 PcatIsaAcpiDev
->Signature
= PCAT_ISA_ACPI_DEV_SIGNATURE
;
254 PcatIsaAcpiDev
->Handle
= Controller
;
255 PcatIsaAcpiDev
->PciIo
= PciIo
;
256 PcatIsaAcpiDev
->OriginalAttributes
= OriginalAttributes
;
259 // Initialize PcatIsaAcpiDeviceList
261 InitializePcatIsaAcpiDeviceList ();
266 (PcatIsaAcpiDev
->IsaAcpi
).DeviceEnumerate
= IsaDeviceEnumerate
;
267 (PcatIsaAcpiDev
->IsaAcpi
).SetPower
= IsaDeviceSetPower
;
268 (PcatIsaAcpiDev
->IsaAcpi
).GetCurResource
= IsaGetCurrentResource
;
269 (PcatIsaAcpiDev
->IsaAcpi
).GetPosResource
= IsaGetPossibleResource
;
270 (PcatIsaAcpiDev
->IsaAcpi
).SetResource
= IsaSetResource
;
271 (PcatIsaAcpiDev
->IsaAcpi
).EnableDevice
= IsaEnableDevice
;
272 (PcatIsaAcpiDev
->IsaAcpi
).InitDevice
= IsaInitDevice
;
273 (PcatIsaAcpiDev
->IsaAcpi
).InterfaceInit
= IsaInterfaceInit
;
276 // Install the ISA ACPI Protocol interface
278 Status
= gBS
->InstallMultipleProtocolInterfaces (
280 &gEfiIsaAcpiProtocolGuid
, &PcatIsaAcpiDev
->IsaAcpi
,
285 if (EFI_ERROR (Status
)) {
286 if (PciIo
!= NULL
&& Enabled
) {
289 EfiPciIoAttributeOperationSet
,
296 &gEfiPciIoProtocolGuid
,
297 This
->DriverBindingHandle
,
300 if (PcatIsaAcpiDev
!= NULL
) {
301 gBS
->FreePool (PcatIsaAcpiDev
);
311 Stop this driver on ControllerHandle. Support stopping any child handles
312 created by this driver.
314 @param This Protocol instance pointer.
315 @param ControllerHandle Handle of device to stop driver on
316 @param NumberOfChildren Number of Handles in ChildHandleBuffer. If number of
317 children is zero stop the entire bus driver.
318 @param ChildHandleBuffer List of Child Handles to Stop.
320 @retval EFI_SUCCESS This driver is removed ControllerHandle
321 @retval other This driver was not removed from this device
326 PcatIsaAcpiDriverBindingStop (
327 IN EFI_DRIVER_BINDING_PROTOCOL
*This
,
328 IN EFI_HANDLE Controller
,
329 IN UINTN NumberOfChildren
,
330 IN EFI_HANDLE
*ChildHandleBuffer
334 EFI_ISA_ACPI_PROTOCOL
*IsaAcpi
;
335 PCAT_ISA_ACPI_DEV
*PcatIsaAcpiDev
;
338 // Get the ISA ACPI Protocol Interface
340 Status
= gBS
->OpenProtocol (
342 &gEfiIsaAcpiProtocolGuid
,
344 This
->DriverBindingHandle
,
346 EFI_OPEN_PROTOCOL_GET_PROTOCOL
348 if (EFI_ERROR (Status
)) {
353 // Get the PCAT ISA ACPI Device structure from the ISA ACPI Protocol
355 PcatIsaAcpiDev
= PCAT_ISA_ACPI_DEV_FROM_THIS (IsaAcpi
);
358 // Restore PCI attributes
360 Status
= PcatIsaAcpiDev
->PciIo
->Attributes (
361 PcatIsaAcpiDev
->PciIo
,
362 EfiPciIoAttributeOperationSet
,
363 PcatIsaAcpiDev
->OriginalAttributes
,
366 if (EFI_ERROR (Status
)) {
371 // Uninstall protocol interface: EFI_ISA_ACPI_PROTOCOL
373 Status
= gBS
->UninstallProtocolInterface (
375 &gEfiIsaAcpiProtocolGuid
, &PcatIsaAcpiDev
->IsaAcpi
377 if (EFI_ERROR (Status
)) {
383 &gEfiPciIoProtocolGuid
,
384 This
->DriverBindingHandle
,
388 gBS
->FreePool (PcatIsaAcpiDev
);