MdeModulePkg/Library/PiDxeS3BootScriptLib/InternalBootScriptLib.h

   1 /** @file
   2   Support for S3 boot script lib. This file defined some internal macro and internal
   3   data structure
   4
   5   Copyright (c) 2006 - 2011, Intel Corporation. All rights reserved.<BR>
   6
   7   This program and the accompanying materials
   8   are licensed and made available under the terms and conditions
   9   of the BSD License which accompanies this distribution.  The
  10   full text of the license may be found at
  11   http://opensource.org/licenses/bsd-license.php
  12
  13   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  14   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  15
  16 **/
  17 #ifndef __INTERNAL_BOOT_SCRIPT_LIB__
  18 #define __INTERNAL_BOOT_SCRIPT_LIB__
  19
  20 #include <PiDxe.h>
  21
  22 #include <Guid/EventGroup.h>
  23 #include <Protocol/SmmBase2.h>
  24 #include <Protocol/DxeSmmReadyToLock.h>
  25 #include <Protocol/SmmReadyToLock.h>
  26
  27 #include <Library/S3BootScriptLib.h>
  28
  29 #include <Library/UefiBootServicesTableLib.h>
  30 #include <Library/BaseLib.h>
  31 #include <Library/PcdLib.h>
  32 #include <Library/SmbusLib.h>
  33 #include <Library/IoLib.h>
  34 #include <Library/PciLib.h>
  35 #include <Library/DebugLib.h>
  36 #include <Library/BaseMemoryLib.h>
  37 #include <Library/TimerLib.h>
  38 #include <Library/UefiLib.h>
  39 #include <Library/LockBoxLib.h>
  40
  41 #include "BootScriptInternalFormat.h"
  42
  43 #define MAX_IO_ADDRESS 0xFFFF
  44
  45 //
  46 // Macro to convert a UEFI PCI address to a PCI Library PCI address
  47 //
  48 #define PCI_ADDRESS_ENCODE(A) (UINTN)PCI_LIB_ADDRESS( \
  49         ((((UINTN)(A))& 0xff000000) >> 24), ((((UINTN)(A)) &0x00ff0000) >> 16), ((((UINTN)(A)) & 0xff00) >> 8), ((RShiftU64 ((A), 32) & 0xfff) | ((A)& 0xff)) \
  50         )
  51
  52
  53
  54 typedef union {
  55   UINT8 volatile  *Buf;
  56   UINT8 volatile  *Uint8;
  57   UINT16 volatile *Uint16;
  58   UINT32 volatile *Uint32;
  59   UINT64 volatile *Uint64;
  60   UINTN volatile   Uint;
  61 } PTR;
  62
  63
  64 // Minimum and maximum length for SMBus bus block protocols defined in SMBus spec 2.0.
  65 //
  66 #define MIN_SMBUS_BLOCK_LEN               1
  67 #define MAX_SMBUS_BLOCK_LEN               32
  68
  69 //
  70 // The boot script private data.
  71 //
  72 typedef struct {
  73   UINT8           *TableBase;
  74   UINT32          TableLength;               // Record the actual memory length
  75   UINT16          TableMemoryPageNumber;     // Record the page number Allocated for the table
  76   BOOLEAN         AtRuntime;                 // Record if current state is after SmmReadyToLock
  77   BOOLEAN         InSmm;                     // Record if this library is in SMM.
  78 } SCRIPT_TABLE_PRIVATE_DATA;
  79
  80 typedef
  81 EFI_STATUS
  82 (EFIAPI *DISPATCH_ENTRYPOINT_FUNC) (
  83   IN EFI_HANDLE ImageHandle,
  84   IN VOID       *Context
  85   );
  86
  87 extern SCRIPT_TABLE_PRIVATE_DATA       *mS3BootScriptTablePtr;
  88
  89 //
  90 // Define Opcode for Label which is implementation specific and no standard spec define.
  91 //
  92 #define  S3_BOOT_SCRIPT_LIB_LABEL_OPCODE    0xFE
  93
  94 ///
  95 /// The opcode indicate the start of the boot script table.
  96 ///
  97 #define S3_BOOT_SCRIPT_LIB_TABLE_OPCODE                  0xAA
  98 ///
  99 /// The opcode indicate the end of the boot script table.
 100 ///
 101 #define S3_BOOT_SCRIPT_LIB_TERMINATE_OPCODE              0xFF
 102
 103
 104 #endif //__INTERNAL_BOOT_SCRIPT_LIB__
 105