Update For R9 Review.
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@7215 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
@@ -1,4 +1,4 @@
|
||||
/**@file
|
||||
/** @file
|
||||
|
||||
Copyright (c) 2006, Intel Corporation
|
||||
All rights reserved. This program and the accompanying materials
|
||||
@@ -11,8 +11,8 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
|
||||
**/
|
||||
|
||||
#ifndef _EFI_PCI_RESOURCE_SUPPORT_H
|
||||
#define _EFI_PCI_RESOURCE_SUPPORT_H
|
||||
#ifndef _EFI_PCI_RESOURCE_SUPPORT_H_
|
||||
#define _EFI_PCI_RESOURCE_SUPPORT_H_
|
||||
|
||||
#define RESERVED_RESOURCE_SIGNATURE SIGNATURE_32 ('r', 's', 'v', 'd')
|
||||
|
||||
@@ -65,7 +65,7 @@ typedef struct {
|
||||
@param Start address including VGA range
|
||||
@param Length length of VGA range.
|
||||
|
||||
@retval EFI_SUCCESS success
|
||||
@retval EFI_SUCCESS success.
|
||||
**/
|
||||
EFI_STATUS
|
||||
SkipVGAAperture (
|
||||
@@ -74,12 +74,12 @@ SkipVGAAperture (
|
||||
);
|
||||
|
||||
/**
|
||||
This function is used to skip ISA aliasing aperture
|
||||
This function is used to skip ISA aliasing aperture.
|
||||
|
||||
@param Start address including ISA aliasing aperture
|
||||
@param Length length of ISA aliasing aperture
|
||||
@param Start address including ISA aliasing aperture.
|
||||
@param Length length of ISA aliasing aperture.
|
||||
|
||||
@retval EFI_SUCCESS success
|
||||
@retval EFI_SUCCESS success.
|
||||
**/
|
||||
EFI_STATUS
|
||||
SkipIsaAliasAperture (
|
||||
@@ -91,10 +91,10 @@ SkipIsaAliasAperture (
|
||||
This function inserts a resource node into the resource list.
|
||||
The resource list is sorted in descend order.
|
||||
|
||||
@param Bridge PCI resource node for bridge
|
||||
@param ResNode Resource node want to be inserted
|
||||
@param Bridge PCI resource node for bridge.
|
||||
@param ResNode Resource node want to be inserted.
|
||||
|
||||
@retval EFI_SUCCESS Success
|
||||
@retval EFI_SUCCESS Success.
|
||||
**/
|
||||
EFI_STATUS
|
||||
InsertResourceNode (
|
||||
@@ -114,8 +114,8 @@ Routine Description:
|
||||
If the TypeMerge is TRUE, Res resource type is changed to the type of destination resource
|
||||
type.
|
||||
|
||||
@param Dst Point to destination resource tree
|
||||
@param Res Point to source resource tree
|
||||
@param Dst Point to destination resource tree.
|
||||
@param Res Point to source resource tree.
|
||||
@param TypeMerge If the TypeMerge is TRUE, Res resource type is changed to the type of
|
||||
destination resource type.
|
||||
|
||||
@@ -135,7 +135,7 @@ MergeResourceTree (
|
||||
|
||||
@param Bridge PCI resource node for bridge.
|
||||
|
||||
@retval EFI_SUCCESS Success
|
||||
@retval EFI_SUCCESS Success.
|
||||
**/
|
||||
EFI_STATUS
|
||||
CalculateApertureIo16 (
|
||||
@@ -144,11 +144,11 @@ CalculateApertureIo16 (
|
||||
|
||||
/**
|
||||
This function is used to calculate the resource aperture
|
||||
for a given bridge device
|
||||
for a given bridge device.
|
||||
|
||||
@param Bridge Give bridge device
|
||||
@param Bridge Give bridge device.
|
||||
|
||||
@retval EFI_SUCCESS Success
|
||||
@retval EFI_SUCCESS Success.
|
||||
**/
|
||||
EFI_STATUS
|
||||
CalculateResourceAperture (
|
||||
@@ -156,16 +156,16 @@ CalculateResourceAperture (
|
||||
);
|
||||
|
||||
/**
|
||||
Get IO/Memory resource infor for given PCI device
|
||||
Get IO/Memory resource infor for given PCI device.
|
||||
|
||||
@param PciDev Pci device instance
|
||||
@param IoNode Resource info node for IO
|
||||
@param Mem32Node Resource info node for 32-bit memory
|
||||
@param PMem32Node Resource info node for 32-bit PMemory
|
||||
@param Mem64Node Resource info node for 64-bit memory
|
||||
@param PMem64Node Resource info node for 64-bit PMemory
|
||||
@param PciDev Pci device instance.
|
||||
@param IoNode Resource info node for IO .
|
||||
@param Mem32Node Resource info node for 32-bit memory.
|
||||
@param PMem32Node Resource info node for 32-bit PMemory.
|
||||
@param Mem64Node Resource info node for 64-bit memory.
|
||||
@param PMem64Node Resource info node for 64-bit PMemory.
|
||||
|
||||
@retval EFI_SUCCESS Success
|
||||
@retval EFI_SUCCESS Success.
|
||||
**/
|
||||
EFI_STATUS
|
||||
GetResourceFromDevice (
|
||||
@@ -178,14 +178,14 @@ GetResourceFromDevice (
|
||||
);
|
||||
|
||||
/**
|
||||
This function is used to create a resource node
|
||||
This function is used to create a resource node.
|
||||
|
||||
@param PciDev Pci device instance
|
||||
@param Length Length of Io/Memory resource
|
||||
@param Alignment Alignment of resource
|
||||
@param Bar Bar index
|
||||
@param ResType Type of resource: IO/Memory
|
||||
@param ResUage Resource usage
|
||||
@param PciDev Pci device instance.
|
||||
@param Length Length of Io/Memory resource.
|
||||
@param Alignment Alignment of resource.
|
||||
@param Bar Bar index.
|
||||
@param ResType Type of resource: IO/Memory.
|
||||
@param ResUsage Resource usage.
|
||||
**/
|
||||
PCI_RESOURCE_NODE *
|
||||
CreateResourceNode (
|
||||
@@ -201,14 +201,14 @@ CreateResourceNode (
|
||||
This routine is used to extract resource request from
|
||||
device node list.
|
||||
|
||||
@param Bridge Pci device instance
|
||||
@param IoNode Resource info node for IO
|
||||
@param Mem32Node Resource info node for 32-bit memory
|
||||
@param PMem32Node Resource info node for 32-bit PMemory
|
||||
@param Mem64Node Resource info node for 64-bit memory
|
||||
@param PMem64Node Resource info node for 64-bit PMemory
|
||||
@param Bridge Pci device instance.
|
||||
@param IoNode Resource info node for IO.
|
||||
@param Mem32Node Resource info node for 32-bit memory.
|
||||
@param PMem32Node Resource info node for 32-bit PMemory.
|
||||
@param Mem64Node Resource info node for 64-bit memory.
|
||||
@param PMem64Node Resource info node for 64-bit PMemory.
|
||||
|
||||
@retval EFI_SUCCESS Success
|
||||
@retval EFI_SUCCESS Success.
|
||||
**/
|
||||
EFI_STATUS
|
||||
CreateResourceMap (
|
||||
@@ -221,16 +221,16 @@ CreateResourceMap (
|
||||
);
|
||||
|
||||
/**
|
||||
This function is used to do the resource padding for a specific platform
|
||||
This function is used to do the resource padding for a specific platform.
|
||||
|
||||
@param Bridge Pci device instance
|
||||
@param IoNode Resource info node for IO
|
||||
@param Mem32Node Resource info node for 32-bit memory
|
||||
@param PMem32Node Resource info node for 32-bit PMemory
|
||||
@param Mem64Node Resource info node for 64-bit memory
|
||||
@param PMem64Node Resource info node for 64-bit PMemory
|
||||
@param PciDev Pci device instance.
|
||||
@param IoNode Resource info node for IO.
|
||||
@param Mem32Node Resource info node for 32-bit memory.
|
||||
@param PMem32Node Resource info node for 32-bit PMemory.
|
||||
@param Mem64Node Resource info node for 64-bit memory.
|
||||
@param PMem64Node Resource info node for 64-bit PMemory.
|
||||
|
||||
@retval EFI_SUCCESS Success
|
||||
@retval EFI_SUCCESS Success.
|
||||
**/
|
||||
EFI_STATUS
|
||||
ResourcePaddingPolicy (
|
||||
@@ -249,14 +249,13 @@ ResourcePaddingPolicy (
|
||||
PMEM64 -> PMEM32 -> MEM32
|
||||
IO32 -> IO16
|
||||
|
||||
@param Bridge Pci device instance
|
||||
@param IoNode Resource info node for IO
|
||||
@param Mem32Node Resource info node for 32-bit memory
|
||||
@param PMem32Node Resource info node for 32-bit PMemory
|
||||
@param Mem64Node Resource info node for 64-bit memory
|
||||
@param PMem64Node Resource info node for 64-bit PMemory
|
||||
@param Bridge Pci device instance.
|
||||
@param Mem32Node Resource info node for 32-bit memory.
|
||||
@param PMem32Node Resource info node for 32-bit PMemory.
|
||||
@param Mem64Node Resource info node for 64-bit memory.
|
||||
@param PMem64Node Resource info node for 64-bit PMemory.
|
||||
|
||||
@retval EFI_SUCCESS Success
|
||||
@retval EFI_SUCCESS Success.
|
||||
**/
|
||||
EFI_STATUS
|
||||
DegradeResource (
|
||||
@@ -268,12 +267,12 @@ DegradeResource (
|
||||
);
|
||||
|
||||
/**
|
||||
Test whether bridge device support decode resource
|
||||
Test whether bridge device support decode resource.
|
||||
|
||||
@param Bridge Bridge device instance
|
||||
@param Decode Decode type according to resource type
|
||||
@param Bridge Bridge device instance.
|
||||
@param Decode Decode type according to resource type.
|
||||
|
||||
@return whether bridge device support decode resource
|
||||
@return whether bridge device support decode resource.
|
||||
|
||||
**/
|
||||
BOOLEAN
|
||||
@@ -284,13 +283,13 @@ BridgeSupportResourceDecode (
|
||||
|
||||
/**
|
||||
This function is used to program the resource allocated
|
||||
for each resource node
|
||||
for each resource node.
|
||||
|
||||
|
||||
@param Base Base address of resource
|
||||
@param Bridge Bridge device instance
|
||||
@param Base Base address of resource.
|
||||
@param Bridge Bridge device instance.
|
||||
|
||||
@retval EFI_SUCCESS Success
|
||||
@retval EFI_SUCCESS Success.
|
||||
**/
|
||||
EFI_STATUS
|
||||
ProgramResource (
|
||||
@@ -301,10 +300,10 @@ ProgramResource (
|
||||
/**
|
||||
Program Bar register.
|
||||
|
||||
@param Base Base address for resource
|
||||
@param Node Point to resoure node structure
|
||||
@param Base Base address for resource.
|
||||
@param Node Point to resoure node structure.
|
||||
|
||||
@retval EFI_SUCCESS Success
|
||||
@retval EFI_SUCCESS Success.
|
||||
**/
|
||||
EFI_STATUS
|
||||
ProgramBar (
|
||||
@@ -313,12 +312,12 @@ ProgramBar (
|
||||
);
|
||||
|
||||
/**
|
||||
Program PPB apperture
|
||||
Program PPB apperture.
|
||||
|
||||
@param Base Base address for resource
|
||||
@param Node Point to resoure node structure
|
||||
@param Base Base address for resource.
|
||||
@param Node Point to resoure node structure.
|
||||
|
||||
@retval EFI_SUCCESS Success
|
||||
@retval EFI_SUCCESS Success.
|
||||
**/
|
||||
EFI_STATUS
|
||||
ProgramPpbApperture (
|
||||
@@ -327,13 +326,13 @@ ProgramPpbApperture (
|
||||
);
|
||||
|
||||
/**
|
||||
Program parent bridge for oprom
|
||||
Program parent bridge for oprom.
|
||||
|
||||
@param PciDevice Pci deivce instance
|
||||
@param OptionRomBase Base address for oprom
|
||||
@param Enable Enable/Disable
|
||||
@param PciDevice Pci deivce instance.
|
||||
@param OptionRomBase Base address for oprom.
|
||||
@param Enable Enable/Disable.
|
||||
|
||||
@retval EFI_SUCCESS Success
|
||||
@retval EFI_SUCCESS Success.
|
||||
**/
|
||||
EFI_STATUS
|
||||
ProgrameUpstreamBridgeForRom (
|
||||
@@ -343,11 +342,11 @@ ProgrameUpstreamBridgeForRom (
|
||||
);
|
||||
|
||||
/**
|
||||
Test whether resource exists for a bridge
|
||||
Test whether resource exists for a bridge.
|
||||
|
||||
@param Bridge Point to resource node for a bridge
|
||||
@param Bridge Point to resource node for a bridge.
|
||||
|
||||
@return whether resource exists
|
||||
@return whether resource exists.
|
||||
**/
|
||||
BOOLEAN
|
||||
ResourceRequestExisted (
|
||||
@@ -357,8 +356,8 @@ ResourceRequestExisted (
|
||||
/**
|
||||
Initialize resource pool structure.
|
||||
|
||||
@param ResourcePool Point to resource pool structure
|
||||
@param ResourceType Type of resource
|
||||
@param ResourcePool Point to resource pool structure.
|
||||
@param ResourceType Type of resource.
|
||||
**/
|
||||
EFI_STATUS
|
||||
InitializeResourcePool (
|
||||
@@ -367,21 +366,21 @@ InitializeResourcePool (
|
||||
);
|
||||
|
||||
/**
|
||||
Get all resource information for given Pci device
|
||||
Get all resource information for given Pci device.
|
||||
|
||||
@param PciDev Pci device instance
|
||||
@param IoBridge Io resource node
|
||||
@param Mem32Bridge 32-bit memory node
|
||||
@param PMem32Bridge 32-bit Pmemory node
|
||||
@param Mem64Bridge 64-bit memory node
|
||||
@param PMem64Bridge 64-bit PMemory node
|
||||
@param IoPool Link list header for Io resource
|
||||
@param Mem32Pool Link list header for 32-bit memory
|
||||
@param PMem32Pool Link list header for 32-bit Pmemory
|
||||
@param Mem64Pool Link list header for 64-bit memory
|
||||
@param PMem64Pool Link list header for 64-bit Pmemory
|
||||
@param PciDev Pci device instance.
|
||||
@param IoBridge Io resource node.
|
||||
@param Mem32Bridge 32-bit memory node.
|
||||
@param PMem32Bridge 32-bit Pmemory node.
|
||||
@param Mem64Bridge 64-bit memory node.
|
||||
@param PMem64Bridge 64-bit PMemory node.
|
||||
@param IoPool Link list header for Io resource.
|
||||
@param Mem32Pool Link list header for 32-bit memory.
|
||||
@param PMem32Pool Link list header for 32-bit Pmemory.
|
||||
@param Mem64Pool Link list header for 64-bit memory.
|
||||
@param PMem64Pool Link list header for 64-bit Pmemory.
|
||||
|
||||
@retval EFI_SUCCESS Success
|
||||
@retval EFI_SUCCESS Success.
|
||||
**/
|
||||
EFI_STATUS
|
||||
GetResourceMap (
|
||||
@@ -399,11 +398,11 @@ GetResourceMap (
|
||||
);
|
||||
|
||||
/**
|
||||
Destory given resource tree
|
||||
Destory given resource tree.
|
||||
|
||||
@param Bridge root node of resource tree
|
||||
@param Bridge root node of resource tree.
|
||||
|
||||
@retval EFI_SUCCESS Success
|
||||
@retval EFI_SUCCESS Success.
|
||||
**/
|
||||
EFI_STATUS
|
||||
DestroyResourceTree (
|
||||
@@ -413,10 +412,10 @@ DestroyResourceTree (
|
||||
/**
|
||||
Record the reserved resource and insert to reserved list.
|
||||
|
||||
@param Base Base address of reserved resourse
|
||||
@param Length Length of reserved resource
|
||||
@param ResType Resource type
|
||||
@param Bridge Pci device instance
|
||||
@param Base Base address of reserved resourse.
|
||||
@param Length Length of reserved resource.
|
||||
@param ResType Resource type.
|
||||
@param Bridge Pci device instance.
|
||||
**/
|
||||
EFI_STATUS
|
||||
RecordReservedResource (
|
||||
@@ -427,16 +426,16 @@ RecordReservedResource (
|
||||
);
|
||||
|
||||
/**
|
||||
Insert resource padding for P2C
|
||||
Insert resource padding for P2C.
|
||||
|
||||
@param PciDev Pci device instance
|
||||
@param IoNode Resource info node for IO
|
||||
@param Mem32Node Resource info node for 32-bit memory
|
||||
@param PMem32Node Resource info node for 32-bit PMemory
|
||||
@param Mem64Node Resource info node for 64-bit memory
|
||||
@param PMem64Node Resource info node for 64-bit PMemory
|
||||
@param PciDev Pci device instance.
|
||||
@param IoNode Resource info node for IO.
|
||||
@param Mem32Node Resource info node for 32-bit memory.
|
||||
@param PMem32Node Resource info node for 32-bit PMemory.
|
||||
@param Mem64Node Resource info node for 64-bit memory.
|
||||
@param PMem64Node Resource info node for 64-bit PMemory.
|
||||
|
||||
@retval EFI_SUCCESS Success
|
||||
@retval EFI_SUCCESS Success.
|
||||
**/
|
||||
EFI_STATUS
|
||||
ResourcePaddingForCardBusBridge (
|
||||
@@ -449,12 +448,12 @@ ResourcePaddingForCardBusBridge (
|
||||
);
|
||||
|
||||
/**
|
||||
Program P2C register for given resource node
|
||||
Program P2C register for given resource node.
|
||||
|
||||
@param Base Base address of P2C device
|
||||
@param Base Base address of P2C device.
|
||||
@param Node Given resource node.
|
||||
|
||||
@retval EFI_SUCCESS Success
|
||||
@retval EFI_SUCCESS Success.
|
||||
**/
|
||||
EFI_STATUS
|
||||
ProgramP2C (
|
||||
@@ -465,12 +464,12 @@ ProgramP2C (
|
||||
/**
|
||||
Create padding resource node.
|
||||
|
||||
@param PciDev Pci device instance
|
||||
@param IoNode Resource info node for IO
|
||||
@param Mem32Node Resource info node for 32-bit memory
|
||||
@param PMem32Node Resource info node for 32-bit PMemory
|
||||
@param Mem64Node Resource info node for 64-bit memory
|
||||
@param PMem64Node Resource info node for 64-bit PMemory
|
||||
@param PciDev Pci device instance.
|
||||
@param IoNode Resource info node for IO.
|
||||
@param Mem32Node Resource info node for 32-bit memory.
|
||||
@param PMem32Node Resource info node for 32-bit PMemory.
|
||||
@param Mem64Node Resource info node for 64-bit memory.
|
||||
@param PMem64Node Resource info node for 64-bit PMemory.
|
||||
|
||||
@retval EFI_SUCCESS Success
|
||||
|
||||
@@ -488,9 +487,9 @@ ApplyResourcePadding (
|
||||
/**
|
||||
Get padding resource for PPB
|
||||
Light PCI bus driver woundn't support hotplug root device
|
||||
So no need to pad resource for them
|
||||
So no need to pad resource for them.
|
||||
|
||||
@param PciIoDevice Pci device instance
|
||||
@param PciIoDevice Pci device instance.
|
||||
**/
|
||||
VOID
|
||||
GetResourcePaddingPpb (
|
||||
@@ -500,8 +499,8 @@ GetResourcePaddingPpb (
|
||||
/**
|
||||
Reset and all bus number from specific bridge.
|
||||
|
||||
@param Bridge Parent specific bridge
|
||||
@param StartBusNumber start bus number
|
||||
@param Bridge Parent specific bridge.
|
||||
@param StartBusNumber start bus number.
|
||||
**/
|
||||
EFI_STATUS
|
||||
ResetAllPpbBusNumber (
|
||||
|
Reference in New Issue
Block a user