IntelFrameworkPkg/Include/Ppi/BootScriptExecuter.h

   1 /** @file
   2   This file declares Boot Script Executer PPI.
   3
   4   This PPI is published by a PEIM upon dispatch and provides an execution engine for the
   5   Framework boot script. This PEIM should be platform neutral and have no specific knowledge of
   6   platform instructions and other information. The ability to interpret the boot script depends on the
   7   abundance of other PPIs that are available. For example, if the script requests an SMBus command
   8   execution, the PEIM looks for a relevant PPI that is available to execute it, rather than executing it
   9   by issuing the native IA-32 instruction.
  10
  11   Copyright (c) 2007 - 2009, Intel Corporation
  12   All rights reserved. This program and the accompanying materials
  13   are licensed and made available under the terms and conditions of the BSD License
  14   which accompanies this distribution.  The full text of the license may be found at
  15   http://opensource.org/licenses/bsd-license.php
  16
  17   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  18   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  19
  20   Module Name:  BootScriptExecuter.h
  21
  22   @par Revision Reference:
  23   This PPI is defined in Framework of EFI BootScript spec.
  24   Version 0.91.
  25
  26 **/
  27
  28 #ifndef _PEI_BOOT_SCRIPT_EXECUTER_PPI_H_
  29 #define _PEI_BOOT_SCRIPT_EXECUTER_PPI_H_
  30
  31 #include <PiPei.h>
  32
  33 #define EFI_ACPI_S3_RESUME_SCRIPT_TABLE               0x00
  34
  35 //
  36 // Boot Script Opcode Definitions
  37 //
  38
  39 ///
  40 /// The opcode is to add a record for an I/O write operation into a specified boot script table.
  41 ///
  42 #define EFI_BOOT_SCRIPT_IO_WRITE_OPCODE               0x00
  43 ///
  44 /// The opcode is to add a record for an I/O modify operation into a specified boot script table.
  45 ///
  46 #define EFI_BOOT_SCRIPT_IO_READ_WRITE_OPCODE          0x01
  47 ///
  48 /// The opcode is to add a record for a memory write operation into a specified boot script table.
  49 ///
  50 #define EFI_BOOT_SCRIPT_MEM_WRITE_OPCODE              0x02
  51 ///
  52 /// The opcode is to add a record for a memory modify operation into a specified boot script table.
  53 ///
  54 #define EFI_BOOT_SCRIPT_MEM_READ_WRITE_OPCODE         0x03
  55 ///
  56 /// The opcode is to adds a record for a PCI configuration space write operation into a specified boot
  57 /// script table.
  58 ///
  59 #define EFI_BOOT_SCRIPT_PCI_CONFIG_WRITE_OPCODE       0x04
  60 ///
  61 /// The opcode is to add a record for a PCI configuration space modify operation into a specified
  62 /// boot script table.
  63 ///
  64 #define EFI_BOOT_SCRIPT_PCI_CONFIG_READ_WRITE_OPCODE  0x05
  65 ///
  66 /// The opcode is to add a record for an SMBus command execution into a specified boot script table.
  67 ///
  68 #define EFI_BOOT_SCRIPT_SMBUS_EXECUTE_OPCODE          0x06
  69 ///
  70 /// The opcode is to adds a record for an execution stall on the processor into a specified
  71 /// boot script table.
  72 ///
  73 #define EFI_BOOT_SCRIPT_STALL_OPCODE                  0x07
  74 ///
  75 /// The opcode is to add a record for dispatching specified arbitrary code into a specified
  76 /// boot script table.
  77 ///
  78 #define EFI_BOOT_SCRIPT_DISPATCH_OPCODE               0x08
  79
  80 //
  81 // Extensions to boot script definitions
  82 //
  83 ///
  84 /// Inconsistent with specification here:
  85 /// Follow OPCODEs are not defined in Framework Spec BootScript_0.91, but in
  86 /// PI1.0 Spec. And OPCODEs which are needed in the implementation
  87 ///
  88 ///
  89 /// The opcode is to add a record for memory reads of the memory location and continues when the
  90 /// exit criteria is satisfied or after a defined duration.
  91 ///
  92 #define EFI_BOOT_SCRIPT_MEM_POLL_OPCODE               0x09
  93 ///
  94 /// The opcode is to store arbitrary information in the boot script table which is a no-op on dispatch
  95 /// and is only used for debugging script issues.
  96 ///
  97 #define EFI_BOOT_SCRIPT_INFORMATION_OPCODE            0x0A
  98 ///
  99 /// The opcode is to add a record for a PCI configuration space write operation into a
 100 /// specified boot script table.
 101 ///
 102 #define EFI_BOOT_SCRIPT_PCI_CONFIG2_WRITE_OPCODE      0x0B
 103 ///
 104 /// The opcode is to add a record for a PCI configuration space modify operation into a specified
 105 /// boot script table.
 106 ///
 107 #define EFI_BOOT_SCRIPT_PCI_CONFIG2_READ_WRITE_OPCODE 0x0C
 108 ///
 109 /// The opcode is to add a record for dispatching specified arbitrary code into a specified
 110 /// boot script table.
 111 ///
 112 #define EFI_BOOT_SCRIPT_DISPATCH_2_OPCODE             0x0D
 113
 114 ///
 115 /// The opcode indicate the start of the boot script table.
 116 ///
 117 #define EFI_BOOT_SCRIPT_TABLE_OPCODE                  0xAA
 118 ///
 119 /// The opcode indicate the end of the boot script table.
 120 ///
 121 #define EFI_BOOT_SCRIPT_TERMINATE_OPCODE              0xFF
 122
 123 ///
 124 /// EFI Boot Script Width
 125 ///
 126 typedef enum {
 127   EfiBootScriptWidthUint8,
 128   EfiBootScriptWidthUint16,
 129   EfiBootScriptWidthUint32,
 130   EfiBootScriptWidthUint64,
 131   EfiBootScriptWidthFifoUint8,
 132   EfiBootScriptWidthFifoUint16,
 133   EfiBootScriptWidthFifoUint32,
 134   EfiBootScriptWidthFifoUint64,
 135   EfiBootScriptWidthFillUint8,
 136   EfiBootScriptWidthFillUint16,
 137   EfiBootScriptWidthFillUint32,
 138   EfiBootScriptWidthFillUint64,
 139   EfiBootScriptWidthMaximum
 140 } EFI_BOOT_SCRIPT_WIDTH;
 141
 142 #define EFI_PEI_BOOT_SCRIPT_EXECUTER_PPI_GUID \
 143   { \
 144     0xabd42895, 0x78cf, 0x4872, {0x84, 0x44, 0x1b, 0x5c, 0x18, 0x0b, 0xfb, 0xff } \
 145   }
 146
 147 typedef struct _EFI_PEI_BOOT_SCRIPT_EXECUTER_PPI EFI_PEI_BOOT_SCRIPT_EXECUTER_PPI;
 148
 149 /**
 150   Executes the Framework boot script table.
 151
 152   @param  PeiServices    A pointer to the system PEI Services Table.
 153   @param  This           A pointer to the EFI_PEI_BOOT_SCRIPT_EXECUTER_PPI instance.
 154   @param  Address        The physical memory address where the table is stored.
 155                          It must be zero if the table to be executed is stored in a firmware volume file.
 156   @param  FvFile         The firmware volume file name that contains the table to
 157                          be executed. It must be NULL if the table to be executed is stored in physical memory.
 158
 159   @retval EFI_SUCCESS           The boot script table was executed successfully.
 160   @retval EFI_INVALID_PARAMETER Address is zero and FvFile is NULL.
 161   @retval EFI_NOT_FOUND         The file name specified in FvFile cannot be found.
 162   @retval EFI_UNSUPPORTED       The format of the boot script table is invalid.
 163                                 Or An unsupported opcode occurred in the table.
 164                                 Or There were opcode execution errors, such as an insufficient dependency.
 165
 166 **/
 167 typedef
 168 EFI_STATUS
 169 (EFIAPI *EFI_PEI_BOOT_SCRIPT_EXECUTE)(
 170   IN     EFI_PEI_SERVICES                        **PeiServices,
 171   IN     EFI_PEI_BOOT_SCRIPT_EXECUTER_PPI        *This,
 172   IN     EFI_PHYSICAL_ADDRESS                    Address,
 173   IN     EFI_GUID                                *FvFile OPTIONAL
 174   );
 175
 176 ///
 177 /// EFI_PEI_BOOT_SCRIPT_EXECUTER_PPI produces the function which interprets and
 178 /// executes the Framework boot script table
 179 ///
 180 struct _EFI_PEI_BOOT_SCRIPT_EXECUTER_PPI {
 181         ///
 182         /// Executes a boot script table
 183         ///
 184   EFI_PEI_BOOT_SCRIPT_EXECUTE Execute;
 185 };
 186
 187 extern EFI_GUID gEfiPeiBootScriptExecuterPpiGuid;
 188
 189 #endif