/** @file\r
- This file declares Boot Script Executer PPI.\r
+ This file declares the Boot Script Executer PPI.\r
\r
- Copyright (c) 2007, Intel Corporation\r
- All rights reserved. This program and the accompanying materials\r
- are licensed and made available under the terms and conditions of the BSD License\r
- which accompanies this distribution. The full text of the license may be found at\r
- http://opensource.org/licenses/bsd-license.php\r
+ This PPI is published by a PEIM upon dispatch and provides an execution engine for the\r
+ Framework boot script. This PEIM should be platform neutral and have no specific knowledge of\r
+ platform instructions or other information. The ability to interpret the boot script depends on the\r
+ abundance of other PPIs that are available. For example, if the script requests an SMBus command\r
+ execution, the PEIM looks for a relevant PPI that is available to execute it, rather than executing it\r
+ by issuing the native IA-32 instruction.\r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+Copyright (c) 2007 - 2018, Intel Corporation. All rights reserved.<BR>\r
+This program and the accompanying materials are licensed and made available under\r
+the terms and conditions of the BSD License that accompanies this distribution.\r
+The full text of the license may be found at\r
+http://opensource.org/licenses/bsd-license.php.\r
\r
- Module Name: BootScriptExecuter.h\r
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
@par Revision Reference:\r
This PPI is defined in Framework of EFI BootScript spec.\r
#ifndef _PEI_BOOT_SCRIPT_EXECUTER_PPI_H_\r
#define _PEI_BOOT_SCRIPT_EXECUTER_PPI_H_\r
\r
-#include <PiPei.h>\r
-\r
-#define EFI_ACPI_S3_RESUME_SCRIPT_TABLE 0x00\r
-\r
-//\r
-// Boot Script Opcode Definitions\r
-//\r
-\r
-#define EFI_BOOT_SCRIPT_IO_WRITE_OPCODE 0x00\r
-#define EFI_BOOT_SCRIPT_IO_READ_WRITE_OPCODE 0x01\r
-#define EFI_BOOT_SCRIPT_MEM_WRITE_OPCODE 0x02\r
-#define EFI_BOOT_SCRIPT_MEM_READ_WRITE_OPCODE 0x03\r
-#define EFI_BOOT_SCRIPT_PCI_CONFIG_WRITE_OPCODE 0x04\r
-#define EFI_BOOT_SCRIPT_PCI_CONFIG_READ_WRITE_OPCODE 0x05\r
-#define EFI_BOOT_SCRIPT_SMBUS_EXECUTE_OPCODE 0x06\r
-#define EFI_BOOT_SCRIPT_STALL_OPCODE 0x07\r
-#define EFI_BOOT_SCRIPT_DISPATCH_OPCODE 0x08\r
-\r
-//\r
-// Extensions to boot script definitions\r
-//\r
-#define EFI_BOOT_SCRIPT_MEM_POLL_OPCODE 0x09\r
-#define EFI_BOOT_SCRIPT_INFORMATION_OPCODE 0x0A\r
-#define EFI_BOOT_SCRIPT_PCI_CONFIG2_WRITE_OPCODE 0x0B\r
-#define EFI_BOOT_SCRIPT_PCI_CONFIG2_READ_WRITE_OPCODE 0x0C\r
-#define EFI_BOOT_SCRIPT_DISPATCH_2_OPCODE 0x0D\r
-#define EFI_BOOT_SCRIPT_TABLE_OPCODE 0xAA\r
-#define EFI_BOOT_SCRIPT_TERMINATE_OPCODE 0xFF\r
-\r
-//\r
-// EFI Boot Script Width\r
-//\r
-typedef enum {\r
- EfiBootScriptWidthUint8,\r
- EfiBootScriptWidthUint16,\r
- EfiBootScriptWidthUint32,\r
- EfiBootScriptWidthUint64,\r
- EfiBootScriptWidthFifoUint8,\r
- EfiBootScriptWidthFifoUint16,\r
- EfiBootScriptWidthFifoUint32,\r
- EfiBootScriptWidthFifoUint64,\r
- EfiBootScriptWidthFillUint8,\r
- EfiBootScriptWidthFillUint16,\r
- EfiBootScriptWidthFillUint32,\r
- EfiBootScriptWidthFillUint64,\r
- EfiBootScriptWidthMaximum\r
-} EFI_BOOT_SCRIPT_WIDTH;\r
-\r
#define EFI_PEI_BOOT_SCRIPT_EXECUTER_PPI_GUID \\r
{ \\r
0xabd42895, 0x78cf, 0x4872, {0x84, 0x44, 0x1b, 0x5c, 0x18, 0x0b, 0xfb, 0xff } \\r
@param PeiServices A pointer to the system PEI Services Table.\r
@param This A pointer to the EFI_PEI_BOOT_SCRIPT_EXECUTER_PPI instance.\r
@param Address The physical memory address where the table is stored.\r
- It must be zero if the table to be executed is stored in a firmware volume file.\r
+ It must be zero if the table to be executed is stored in\r
+ a firmware volume file.\r
@param FvFile The firmware volume file name that contains the table to\r
- be executed. It must be NULL if the table to be executed is stored in physical memory.\r
+ be executed. It must be NULL if the table to be executed\r
+ is stored in physical memory.\r
\r
@retval EFI_SUCCESS The boot script table was executed successfully.\r
@retval EFI_INVALID_PARAMETER Address is zero and FvFile is NULL.\r
@retval EFI_NOT_FOUND The file name specified in FvFile cannot be found.\r
@retval EFI_UNSUPPORTED The format of the boot script table is invalid.\r
- Or An unsupported opcode occurred in the table.\r
- Or There were opcode execution errors, such as an insufficient dependency.\r
+ Or, an unsupported opcode occurred in the table.\r
+ Or there were opcode execution errors, such as an\r
+ insufficient dependency.\r
\r
**/\r
typedef\r
EFI_STATUS\r
-(EFIAPI *EFI_PEI_BOOT_SCRIPT_EXECUTE) (\r
+(EFIAPI *EFI_PEI_BOOT_SCRIPT_EXECUTE)(\r
IN EFI_PEI_SERVICES **PeiServices,\r
IN EFI_PEI_BOOT_SCRIPT_EXECUTER_PPI *This,\r
IN EFI_PHYSICAL_ADDRESS Address,\r
IN EFI_GUID *FvFile OPTIONAL\r
);\r
\r
-/**\r
- @par Ppi Description:\r
- This PPI produces functions to interpret and execute the Framework boot script table.\r
-\r
- @param Execute\r
- Executes a boot script table.\r
-\r
-**/\r
+///\r
+/// EFI_PEI_BOOT_SCRIPT_EXECUTER_PPI produces the function which interprets and\r
+/// executes the Framework boot script table.\r
+///\r
struct _EFI_PEI_BOOT_SCRIPT_EXECUTER_PPI {\r
+ ///\r
+ /// Executes a boot script table.\r
+ ///\r
EFI_PEI_BOOT_SCRIPT_EXECUTE Execute;\r
};\r
\r
projects / mirror_edk2.git / blobdiff