IntelFrameworkPkg/Include/Framework/PeiCis.h - edk2 - Git at Google

 /** @file
   The Include file for definitions in the Intel Platform Innovation Framework for EFI
   Pre-EFI Initialization Core Interface Specification (PEI CIS) Version 0.91.

 Copyright (c) 2006 - 2010, Intel Corporation.  All rights reserved<BR>
 This program and the accompanying materials are licensed and made available under
 the terms and conditions of the BSD License that 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.

 **/

 #ifndef __PEICIS_H__
 #define __PEICIS_H__

 #include <Ppi/PciCfg.h>
 //
 // Framework PEI Specification Revision information
 //
 #define FRAMEWORK_PEI_SPECIFICATION_MAJOR_REVISION    0
 #define FRAMEWORK_PEI_SPECIFICATION_MINOR_REVISION    91


 //
 // PEI services signature and Revision defined in Framework PEI spec
 //
 #define FRAMEWORK_PEI_SERVICES_SIGNATURE               0x5652455320494550ULL
 #define FRAMEWORK_PEI_SERVICES_REVISION               ((FRAMEWORK_PEI_SPECIFICATION_MAJOR_REVISION<<16) | (FRAMEWORK_PEI_SPECIFICATION_MINOR_REVISION))


 typedef struct _FRAMEWORK_EFI_PEI_SERVICES FRAMEWORK_EFI_PEI_SERVICES;

 /**
   The PEI Dispatcher will invoke each PEIM one time.  During this pass, the PEI
   Dispatcher will pass control to the PEIM at the AddressOfEntryPoint in the PE Header.

   @param  FfsHeader        The pointer to the FFS file header.
   @param  PeiServices      Describes the list of possible PEI Services.

   @return Status code

 **/
 typedef
 EFI_STATUS
 (EFIAPI *EFI_PEIM_ENTRY_POINT)(
   IN EFI_FFS_FILE_HEADER            *FfsHeader,
   IN EFI_PEI_SERVICES               **PeiServices
   );

 /**
   This service abstracts the capability of the PEI
   Foundation to discover instances of firmware volumes in the system.
   Given the input file pointer, this service searches for the next
   matching file in the Firmware File System (FFS) volume.

   @param  PeiServices      An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation.
   @param  Instance         This instance of the firmware volume to find. The value 0 is the Boot Firmware Volume (BFV).
   @param  FwVolHeader      The pointer to the firmware volume header of the volume to return.

   @retval EFI_SUCCESS           The volume was found.
   @retval EFI_NOT_FOUND         The volume was not found.
   @retval EFI_INVALID_PARAMETER FwVolHeader is NULL

 **/
 typedef
 EFI_STATUS
 (EFIAPI *EFI_PEI_FFS_FIND_NEXT_VOLUME)(
   IN FRAMEWORK_EFI_PEI_SERVICES     **PeiServices,
   IN UINTN                          Instance,
   IN OUT EFI_FIRMWARE_VOLUME_HEADER **FwVolHeader
   );

 /**
   This service abstracts the capability of the PEI
   Foundation to discover instances of firmware files in the system.
   Given the input file pointer, this service searches for the next matching
   file in the Firmware File System (FFS) volume.

   @param  PeiServices      An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation.
   @param  SearchType       A filter to find files only of this type.
   @param  FwVolHeader      The pointer to the firmware volume header of the volume to search. This parameter
                            must point to a valid FFS volume.
   @param  FileHeader       The pointer to the current file from which to begin searching. Upon return this pointer will be
                            updated to reflect the file found.

   @retval EFI_SUCCESS      The file was found.
   @retval EFI_NOT_FOUND    The file was not found.
   @retval EFI_NOT_FOUND    The header checksum was not zero.

 **/
 typedef
 EFI_STATUS
 (EFIAPI *EFI_PEI_FFS_FIND_NEXT_FILE)(
   IN FRAMEWORK_EFI_PEI_SERVICES     **PeiServices,
   IN EFI_FV_FILETYPE                SearchType,
   IN EFI_FIRMWARE_VOLUME_HEADER     *FwVolHeader,
   IN OUT EFI_FFS_FILE_HEADER        **FileHeader
   );

 /**
   Given the input file pointer, this service searches for the next
   matching file in the Firmware File System (FFS) volume.

   @param  PeiServices      An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation.
   @param  SectionType      The value of the section type to find.
   @param  FfsFileHeader    A pointer to the file header that contains the set of sections to be searched.
   @param  SectionData      A pointer to the discovered section, if successful.

   @retval EFI_SUCCESS      The section was found.
   @retval EFI_NOT_FOUND    The section was not found.

 **/
 typedef
 EFI_STATUS
 (EFIAPI *EFI_PEI_FFS_FIND_SECTION_DATA)(
   IN FRAMEWORK_EFI_PEI_SERVICES     **PeiServices,
   IN EFI_SECTION_TYPE               SectionType,
   IN EFI_FFS_FILE_HEADER            *FfsFileHeader,
   IN OUT VOID                       **SectionData
   );

 ///
 ///  FRAMEWORK_EFI_PEI_SERVICES is a collection of functions whose implementation is provided by the PEI
 ///  Foundation. The table may be located in the temporary or permanent memory, depending upon the capabilities
 ///  and phase of execution of PEI.
 ///
 ///  These services fall into various classes, including the following:
 ///  - Managing the boot mode.
 ///  - Allocating both early and permanent memory.
 ///  - Supporting the Firmware File System (FFS).
 ///  - Abstracting the PPI database abstraction.
 ///  - Creating Hand-Off Blocks (HOBs).
 ///
 struct _FRAMEWORK_EFI_PEI_SERVICES {
   EFI_TABLE_HEADER                  Hdr;
   //
   // PPI Functions
   //
   EFI_PEI_INSTALL_PPI               InstallPpi;
   EFI_PEI_REINSTALL_PPI             ReInstallPpi;
   EFI_PEI_LOCATE_PPI                LocatePpi;
   EFI_PEI_NOTIFY_PPI                NotifyPpi;
   //
   // Boot Mode Functions
   //
   EFI_PEI_GET_BOOT_MODE             GetBootMode;
   EFI_PEI_SET_BOOT_MODE             SetBootMode;
   //
   // HOB Functions
   //
   EFI_PEI_GET_HOB_LIST              GetHobList;
   EFI_PEI_CREATE_HOB                CreateHob;
   //
   // Firmware Volume Functions
   //
   EFI_PEI_FFS_FIND_NEXT_VOLUME      FfsFindNextVolume;
   EFI_PEI_FFS_FIND_NEXT_FILE        FfsFindNextFile;
   EFI_PEI_FFS_FIND_SECTION_DATA     FfsFindSectionData;
   //
   // PEI Memory Functions
   //
   EFI_PEI_INSTALL_PEI_MEMORY        InstallPeiMemory;
   EFI_PEI_ALLOCATE_PAGES            AllocatePages;
   EFI_PEI_ALLOCATE_POOL             AllocatePool;
   EFI_PEI_COPY_MEM                  CopyMem;
   EFI_PEI_SET_MEM                   SetMem;
   //
   // (the following interfaces are installed by publishing PEIM)
   // Status Code
   //
   EFI_PEI_REPORT_STATUS_CODE        ReportStatusCode;
   //
   // Reset
   //
   EFI_PEI_RESET_SYSTEM              ResetSystem;
   ///
   /// Inconsistent with specification here:
   /// In Framework Spec, PeiCis0.91, CpuIo and PciCfg are NOT pointers.
   ///

   //
   // I/O Abstractions
   //
   EFI_PEI_CPU_IO_PPI                *CpuIo;
   EFI_PEI_PCI_CFG_PPI               *PciCfg;
 };
 ///
 /// Enumeration of reset types defined in the Framework Specification PeiCis.
 ///
 typedef enum {
   ///
   /// Used to induce a system-wide reset. This sets all circuitry within the
   /// system to its initial state.  This type of reset is asynchronous to system
   /// operation and operates withgout regard to cycle boundaries.  EfiColdReset
   /// is tantamount to a system power cycle.
   ///
   EfiPeiResetCold,
   ///
   /// Used to induce a system-wide initialization. The processors are set to their
   /// initial state, and pending cycles are not corrupted.  If the system does
   /// not support this reset type, then an EfiResetCold must be performed.
   ///
   EfiPeiResetWarm,
 } EFI_PEI_RESET_TYPE;

 #endif
	/** @file
	The Include file for definitions in the Intel Platform Innovation Framework for EFI
	Pre-EFI Initialization Core Interface Specification (PEI CIS) Version 0.91.

	Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved<BR>
	This program and the accompanying materials are licensed and made available under
	the terms and conditions of the BSD License that 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.

	**/

	#ifndef __PEICIS_H__
	#define __PEICIS_H__

	#include <Ppi/PciCfg.h>
	//
	// Framework PEI Specification Revision information
	//
	#define FRAMEWORK_PEI_SPECIFICATION_MAJOR_REVISION 0
	#define FRAMEWORK_PEI_SPECIFICATION_MINOR_REVISION 91


	//
	// PEI services signature and Revision defined in Framework PEI spec
	//
	#define FRAMEWORK_PEI_SERVICES_SIGNATURE 0x5652455320494550ULL
	#define FRAMEWORK_PEI_SERVICES_REVISION ((FRAMEWORK_PEI_SPECIFICATION_MAJOR_REVISION<<16) \| (FRAMEWORK_PEI_SPECIFICATION_MINOR_REVISION))



	typedef struct _FRAMEWORK_EFI_PEI_SERVICES FRAMEWORK_EFI_PEI_SERVICES;

	/**
	The PEI Dispatcher will invoke each PEIM one time. During this pass, the PEI
	Dispatcher will pass control to the PEIM at the AddressOfEntryPoint in the PE Header.

	@param FfsHeader The pointer to the FFS file header.
	@param PeiServices Describes the list of possible PEI Services.

	@return Status code

	**/
	typedef
	EFI_STATUS
	(EFIAPI *EFI_PEIM_ENTRY_POINT)(
	IN EFI_FFS_FILE_HEADER *FfsHeader,
	IN EFI_PEI_SERVICES **PeiServices
	);

	/**
	This service abstracts the capability of the PEI
	Foundation to discover instances of firmware volumes in the system.
	Given the input file pointer, this service searches for the next
	matching file in the Firmware File System (FFS) volume.

	@param PeiServices An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation.
	@param Instance This instance of the firmware volume to find. The value 0 is the Boot Firmware Volume (BFV).
	@param FwVolHeader The pointer to the firmware volume header of the volume to return.

	@retval EFI_SUCCESS The volume was found.
	@retval EFI_NOT_FOUND The volume was not found.
	@retval EFI_INVALID_PARAMETER FwVolHeader is NULL

	**/
	typedef
	EFI_STATUS
	(EFIAPI *EFI_PEI_FFS_FIND_NEXT_VOLUME)(
	IN FRAMEWORK_EFI_PEI_SERVICES **PeiServices,
	IN UINTN Instance,
	IN OUT EFI_FIRMWARE_VOLUME_HEADER **FwVolHeader
	);

	/**
	This service abstracts the capability of the PEI
	Foundation to discover instances of firmware files in the system.
	Given the input file pointer, this service searches for the next matching
	file in the Firmware File System (FFS) volume.

	@param PeiServices An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation.
	@param SearchType A filter to find files only of this type.
	@param FwVolHeader The pointer to the firmware volume header of the volume to search. This parameter
	must point to a valid FFS volume.
	@param FileHeader The pointer to the current file from which to begin searching. Upon return this pointer will be
	updated to reflect the file found.

	@retval EFI_SUCCESS The file was found.
	@retval EFI_NOT_FOUND The file was not found.
	@retval EFI_NOT_FOUND The header checksum was not zero.

	**/
	typedef
	EFI_STATUS
	(EFIAPI *EFI_PEI_FFS_FIND_NEXT_FILE)(
	IN FRAMEWORK_EFI_PEI_SERVICES **PeiServices,
	IN EFI_FV_FILETYPE SearchType,
	IN EFI_FIRMWARE_VOLUME_HEADER *FwVolHeader,
	IN OUT EFI_FFS_FILE_HEADER **FileHeader
	);

	/**
	Given the input file pointer, this service searches for the next
	matching file in the Firmware File System (FFS) volume.

	@param PeiServices An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation.
	@param SectionType The value of the section type to find.
	@param FfsFileHeader A pointer to the file header that contains the set of sections to be searched.
	@param SectionData A pointer to the discovered section, if successful.

	@retval EFI_SUCCESS The section was found.
	@retval EFI_NOT_FOUND The section was not found.

	**/
	typedef
	EFI_STATUS
	(EFIAPI *EFI_PEI_FFS_FIND_SECTION_DATA)(
	IN FRAMEWORK_EFI_PEI_SERVICES **PeiServices,
	IN EFI_SECTION_TYPE SectionType,
	IN EFI_FFS_FILE_HEADER *FfsFileHeader,
	IN OUT VOID **SectionData
	);

	///
	/// FRAMEWORK_EFI_PEI_SERVICES is a collection of functions whose implementation is provided by the PEI
	/// Foundation. The table may be located in the temporary or permanent memory, depending upon the capabilities
	/// and phase of execution of PEI.
	///
	/// These services fall into various classes, including the following:
	/// - Managing the boot mode.
	/// - Allocating both early and permanent memory.
	/// - Supporting the Firmware File System (FFS).
	/// - Abstracting the PPI database abstraction.
	/// - Creating Hand-Off Blocks (HOBs).
	///
	struct _FRAMEWORK_EFI_PEI_SERVICES {
	EFI_TABLE_HEADER Hdr;
	//
	// PPI Functions
	//
	EFI_PEI_INSTALL_PPI InstallPpi;
	EFI_PEI_REINSTALL_PPI ReInstallPpi;
	EFI_PEI_LOCATE_PPI LocatePpi;
	EFI_PEI_NOTIFY_PPI NotifyPpi;
	//
	// Boot Mode Functions
	//
	EFI_PEI_GET_BOOT_MODE GetBootMode;
	EFI_PEI_SET_BOOT_MODE SetBootMode;
	//
	// HOB Functions
	//
	EFI_PEI_GET_HOB_LIST GetHobList;
	EFI_PEI_CREATE_HOB CreateHob;
	//
	// Firmware Volume Functions
	//
	EFI_PEI_FFS_FIND_NEXT_VOLUME FfsFindNextVolume;
	EFI_PEI_FFS_FIND_NEXT_FILE FfsFindNextFile;
	EFI_PEI_FFS_FIND_SECTION_DATA FfsFindSectionData;
	//
	// PEI Memory Functions
	//
	EFI_PEI_INSTALL_PEI_MEMORY InstallPeiMemory;
	EFI_PEI_ALLOCATE_PAGES AllocatePages;
	EFI_PEI_ALLOCATE_POOL AllocatePool;
	EFI_PEI_COPY_MEM CopyMem;
	EFI_PEI_SET_MEM SetMem;
	//
	// (the following interfaces are installed by publishing PEIM)
	// Status Code
	//
	EFI_PEI_REPORT_STATUS_CODE ReportStatusCode;
	//
	// Reset
	//
	EFI_PEI_RESET_SYSTEM ResetSystem;
	///
	/// Inconsistent with specification here:
	/// In Framework Spec, PeiCis0.91, CpuIo and PciCfg are NOT pointers.
	///

	//
	// I/O Abstractions
	//
	EFI_PEI_CPU_IO_PPI *CpuIo;
	EFI_PEI_PCI_CFG_PPI *PciCfg;
	};
	///
	/// Enumeration of reset types defined in the Framework Specification PeiCis.
	///
	typedef enum {
	///
	/// Used to induce a system-wide reset. This sets all circuitry within the
	/// system to its initial state. This type of reset is asynchronous to system
	/// operation and operates withgout regard to cycle boundaries. EfiColdReset
	/// is tantamount to a system power cycle.
	///
	EfiPeiResetCold,
	///
	/// Used to induce a system-wide initialization. The processors are set to their
	/// initial state, and pending cycles are not corrupted. If the system does
	/// not support this reset type, then an EfiResetCold must be performed.
	///
	EfiPeiResetWarm,
	} EFI_PEI_RESET_TYPE;

	#endif