tyler.durden/audk
1
0
Fork 0
mirror of https://github.com/acidanthera/audk.git synced 2025-07-27 15:44:04 +02:00
Code Issues Packages Projects Releases Wiki Activity

MdeModulePkg: Clean ACPI 2.0 characters in UEFI spec

Browse Source 
v2: Add some missing changes.

Cc: Liming Gao <liming.gao@intel.com>
Cc: Star Zeng <star.zeng@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Dandan Bi <dandan.bi@intel.com>
Reviewed-by: Star Zeng <star.zeng@intel.com>
This commit is contained in:
Dandan Bi 2017-06-16 13:24:02 +08:00 committed by Hao Wu
parent 51312091b2
commit 6fbaed1f00
4 changed files with 16 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
MdeModulePkg/Bus/Pci/PciBusDxe/PciIo.c
View File

@ -1,7 +1,7 @@
/** @file /** @file
EFI PCI IO protocol functions implementation for PCI Bus module. EFI PCI IO protocol functions implementation for PCI Bus module.
Copyright (c) 2006 - 2016, Intel Corporation. All rights reserved.<BR> Copyright (c) 2006 - 2017, Intel Corporation. All rights reserved.<BR>
This program and the accompanying materials This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License are licensed and made available under the terms and conditions of the BSD License
which accompanies this distribution. The full text of the license may be found at which accompanies this distribution. The full text of the license may be found at
@ -1838,12 +1838,12 @@ GetMmioAddressTranslationOffset (
base address for resource range. The legal range for this field is 0..5. base address for resource range. The legal range for this field is 0..5.
@param Supports A pointer to the mask of attributes that this PCI controller supports @param Supports A pointer to the mask of attributes that this PCI controller supports
setting for this BAR with SetBarAttributes(). setting for this BAR with SetBarAttributes().
@param Resources A pointer to the ACPI 2.0 resource descriptors that describe the current @param Resources A pointer to the resource descriptors that describe the current
configuration of this BAR of the PCI controller. configuration of this BAR of the PCI controller.
@retval EFI_SUCCESS If Supports is not NULL, then the attributes that the PCI @retval EFI_SUCCESS If Supports is not NULL, then the attributes that the PCI
controller supports are returned in Supports. If Resources controller supports are returned in Supports. If Resources
is not NULL, then the ACPI 2.0 resource descriptors that the PCI is not NULL, then the resource descriptors that the PCI
controller is currently using are returned in Resources. controller is currently using are returned in Resources.
@retval EFI_INVALID_PARAMETER Both Supports and Attributes are NULL. @retval EFI_INVALID_PARAMETER Both Supports and Attributes are NULL.
@retval EFI_UNSUPPORTED BarIndex not valid for this PCI controller. @retval EFI_UNSUPPORTED BarIndex not valid for this PCI controller.

6
MdeModulePkg/Bus/Pci/PciBusDxe/PciIo.h
View File

@ -1,7 +1,7 @@
/** @file /** @file
EFI PCI IO protocol functions declaration for PCI Bus module. EFI PCI IO protocol functions declaration for PCI Bus module.
Copyright (c) 2006 - 2009, Intel Corporation. All rights reserved.<BR> Copyright (c) 2006 - 2017, Intel Corporation. All rights reserved.<BR>
This program and the accompanying materials This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License are licensed and made available under the terms and conditions of the BSD License
which accompanies this distribution. The full text of the license may be found at which accompanies this distribution. The full text of the license may be found at
@ -590,12 +590,12 @@ PciIoAttributes (
base address for resource range. The legal range for this field is 0..5. base address for resource range. The legal range for this field is 0..5.
@param Supports A pointer to the mask of attributes that this PCI controller supports @param Supports A pointer to the mask of attributes that this PCI controller supports
setting for this BAR with SetBarAttributes(). setting for this BAR with SetBarAttributes().
@param Resources A pointer to the ACPI 2.0 resource descriptors that describe the current @param Resources A pointer to the resource descriptors that describe the current
configuration of this BAR of the PCI controller. configuration of this BAR of the PCI controller.
@retval EFI_SUCCESS If Supports is not NULL, then the attributes that the PCI @retval EFI_SUCCESS If Supports is not NULL, then the attributes that the PCI
controller supports are returned in Supports. If Resources controller supports are returned in Supports. If Resources
is not NULL, then the ACPI 2.0 resource descriptors that the PCI is not NULL, then the resource descriptors that the PCI
controller is currently using are returned in Resources. controller is currently using are returned in Resources.
@retval EFI_INVALID_PARAMETER Both Supports and Attributes are NULL. @retval EFI_INVALID_PARAMETER Both Supports and Attributes are NULL.
@retval EFI_UNSUPPORTED BarIndex not valid for this PCI controller. @retval EFI_UNSUPPORTED BarIndex not valid for this PCI controller.

6
MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridge.h
View File

@ -2,7 +2,7 @@
The PCI Root Bridge header file. The PCI Root Bridge header file.
Copyright (c) 1999 - 2016, Intel Corporation. All rights reserved.<BR> Copyright (c) 1999 - 2017, Intel Corporation. All rights reserved.<BR>
This program and the accompanying materials This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License are licensed and made available under the terms and conditions of the BSD License
which accompanies this distribution. The full text of the license may be found at which accompanies this distribution. The full text of the license may be found at
@ -554,10 +554,10 @@ RootBridgeIoSetAttributes (
/** /**
Retrieves the current resource settings of this PCI root bridge Retrieves the current resource settings of this PCI root bridge
in the form of a set of ACPI 2.0 resource descriptor. in the form of a set of ACPI resource descriptor.
@param This - Pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL instance. @param This - Pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL instance.
@param Resources - Pointer to the ACPI 2.0 resource descriptor that @param Resources - Pointer to the resource descriptor that
describe the current configuration of this PCI root describe the current configuration of this PCI root
bridge. bridge.

15
MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c
View File

@ -1560,20 +1560,19 @@ RootBridgeIoSetAttributes (
/** /**
Retrieves the current resource settings of this PCI root bridge in the form Retrieves the current resource settings of this PCI root bridge in the form
of a set of ACPI 2.0 resource descriptors. of a set of ACPI resource descriptors.
There are only two resource descriptor types from the ACPI Specification that There are only two resource descriptor types from the ACPI Specification that
may be used to describe the current resources allocated to a PCI root bridge. may be used to describe the current resources allocated to a PCI root bridge.
These are the QWORD Address Space Descriptor (ACPI 2.0 Section 6.4.3.5.1), These are the QWORD Address Space Descriptor, and the End Tag. The QWORD
and the End Tag (ACPI 2.0 Section 6.4.2.8). The QWORD Address Space Address Space Descriptor can describe memory, I/O, and bus number ranges for
Descriptor can describe memory, I/O, and bus number ranges for dynamic or dynamic or fixed resources. The configuration of a PCI root bridge is described
fixed resources. The configuration of a PCI root bridge is described with one with one or more QWORD Address Space Descriptors followed by an End Tag.
or more QWORD Address Space Descriptors followed by an End Tag.
@param[in] This A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL. @param[in] This A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
@param[out] Resources A pointer to the ACPI 2.0 resource descriptors that @param[out] Resources A pointer to the resource descriptors that
describe the current configuration of this PCI root describe the current configuration of this PCI root
bridge. The storage for the ACPI 2.0 resource bridge. The storage for the resource
descriptors is allocated by this function. The descriptors is allocated by this function. The
caller must treat the return buffer as read-only caller must treat the return buffer as read-only
data, and the buffer must not be freed by the data, and the buffer must not be freed by the