Make the function comments follow EDK2 coding style. Cc: Sami Mujawar <sami.mujawar@arm.com> Cc: Evan Lloyd <evan.lloyd@arm.com> Cc: Jaben Carsey <jaben.carsey@intel.com> Cc: Ruiyu Ni <ruiyu.ni@intel.com> Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Dandan Bi <dandan.bi@intel.com> Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>
		
			
				
	
	
		
			97 lines
		
	
	
		
			2.8 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			97 lines
		
	
	
		
			2.8 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/** @file
 | 
						|
  MCFG table parser
 | 
						|
 | 
						|
  Copyright (c) 2016 - 2018, ARM Limited. All rights reserved.
 | 
						|
  This program and the accompanying materials
 | 
						|
  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
 | 
						|
  http://opensource.org/licenses/bsd-license.php
 | 
						|
 | 
						|
  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
 | 
						|
  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 | 
						|
 | 
						|
  @par Reference(s):
 | 
						|
    - PCI Firmware Specification - Revision 3.2, January 26, 2015.
 | 
						|
**/
 | 
						|
 | 
						|
#include <IndustryStandard/Acpi.h>
 | 
						|
#include <Library/UefiLib.h>
 | 
						|
#include "AcpiParser.h"
 | 
						|
#include "AcpiTableParser.h"
 | 
						|
 | 
						|
// Local variables
 | 
						|
STATIC ACPI_DESCRIPTION_HEADER_INFO AcpiHdrInfo;
 | 
						|
 | 
						|
/**
 | 
						|
  An ACPI_PARSER array describing the ACPI MCFG Table.
 | 
						|
**/
 | 
						|
STATIC CONST ACPI_PARSER McfgParser[] = {
 | 
						|
  PARSE_ACPI_HEADER (&AcpiHdrInfo),
 | 
						|
  {L"Reserved", 8, 36, L"0x%lx", NULL, NULL, NULL, NULL},
 | 
						|
};
 | 
						|
 | 
						|
/**
 | 
						|
  An ACPI_PARSER array describing the PCI configuration Space Base Address structure.
 | 
						|
**/
 | 
						|
STATIC CONST ACPI_PARSER PciCfgSpaceBaseAddrParser[] = {
 | 
						|
  {L"Base Address", 8, 0, L"0x%lx", NULL, NULL, NULL, NULL},
 | 
						|
  {L"PCI Segment Group No.", 2, 8, L"0x%x", NULL, NULL, NULL, NULL},
 | 
						|
  {L"Start Bus No.", 1, 10, L"0x%x", NULL, NULL, NULL, NULL},
 | 
						|
  {L"End Bus No.", 1, 11, L"0x%x", NULL, NULL, NULL, NULL},
 | 
						|
  {L"Reserved", 4, 12, L"0x%x", NULL, NULL, NULL, NULL}
 | 
						|
};
 | 
						|
 | 
						|
/**
 | 
						|
  This function parses the ACPI MCFG table.
 | 
						|
  When trace is enabled this function parses the MCFG table and
 | 
						|
  traces the ACPI table fields.
 | 
						|
 | 
						|
  This function also performs validation of the ACPI table fields.
 | 
						|
 | 
						|
  @param [in] Trace              If TRUE, trace the ACPI fields.
 | 
						|
  @param [in] Ptr                Pointer to the start of the buffer.
 | 
						|
  @param [in] AcpiTableLength    Length of the ACPI table.
 | 
						|
  @param [in] AcpiTableRevision  Revision of the ACPI table.
 | 
						|
**/
 | 
						|
VOID
 | 
						|
EFIAPI
 | 
						|
ParseAcpiMcfg (
 | 
						|
  IN BOOLEAN Trace,
 | 
						|
  IN UINT8*  Ptr,
 | 
						|
  IN UINT32  AcpiTableLength,
 | 
						|
  IN UINT8   AcpiTableRevision
 | 
						|
  )
 | 
						|
{
 | 
						|
  UINT32 Offset;
 | 
						|
  UINT32 PciCfgOffset;
 | 
						|
  UINT8* PciCfgSpacePtr;
 | 
						|
 | 
						|
  if (!Trace) {
 | 
						|
    return;
 | 
						|
  }
 | 
						|
 | 
						|
  Offset = ParseAcpi (
 | 
						|
             TRUE,
 | 
						|
             0,
 | 
						|
             "MCFG",
 | 
						|
             Ptr,
 | 
						|
             AcpiTableLength,
 | 
						|
             PARSER_PARAMS (McfgParser)
 | 
						|
             );
 | 
						|
 | 
						|
  PciCfgSpacePtr = Ptr + Offset;
 | 
						|
 | 
						|
  while (Offset < AcpiTableLength) {
 | 
						|
    PciCfgOffset = ParseAcpi (
 | 
						|
                     TRUE,
 | 
						|
                     2,
 | 
						|
                     "PCI Configuration Space",
 | 
						|
                     PciCfgSpacePtr,
 | 
						|
                     (AcpiTableLength - Offset),
 | 
						|
                     PARSER_PARAMS (PciCfgSpaceBaseAddrParser)
 | 
						|
                     );
 | 
						|
    PciCfgSpacePtr += PciCfgOffset;
 | 
						|
    Offset += PciCfgOffset;
 | 
						|
  }
 | 
						|
}
 |