init. 1AQQW051HEADmaster

7 files changed, 846 insertions, 0 deletions

diff --git a/ReferenceCode/Chipset/LynxPoint/S3Support/Dxe/PchS3Support.c b/ReferenceCode/Chipset/LynxPoint/S3Support/Dxe/PchS3Support.c
new file mode 100644
index 0000000..943ffd7
--- /dev/null
+++ b/ReferenceCode/Chipset/LynxPoint/S3Support/Dxe/PchS3Support.c
@@ -0,0 +1,369 @@
+/** @file
+  This is the driver that implements the PCH S3 Support protocol
+
+@copyright
+  Copyright (c) 1999 - 2015 Intel Corporation. All rights reserved
+  This software and associated documentation (if any) is furnished
+  under a license and may only be used or copied in accordance
+  with the terms of the license. Except as permitted by such
+  license, no part of this software or documentation may be
+  reproduced, stored in a retrieval system, or transmitted in any
+  form or by any means without the express written consent of
+  Intel Corporation.
+
+  This file contains an 'Intel Peripheral Driver' and uniquely
+  identified as "Intel Reference Module" and is
+  licensed for Intel CPUs and chipsets under the terms of your
+  license agreement with Intel or your vendor.  This file may
+  be modified by the user, subject to additional terms of the
+  license agreement
+
+**/
+#include "PchS3Support.h"
+#include "S3SupportHob.h"
+// AMI_OVERRIDE, [ EIP217847 ] >>>
+#include "token.h"
+// AMI_OVERRIDE, [ EIP217847 ] <<<
+
+//
+// Global Variables
+//
+EFI_HANDLE                        mImageHandle;
+EFI_PCH_S3_SUPPORT_PROTOCOL       mPchS3SupportProtocol;
+EFI_PCH_S3_SUPPORT_SMM_PROTOCOL   mPchS3SupportSmmProtocol;
+UINT32                            mPchS3ImageEntryPoint;
+EFI_PCH_S3_DISPATCH_ARRAY         *mPchS3CustomDispatchScript;
+
+//
+// GUID Definitions
+//
+EFI_GUID gS3SupportHobGuid        = S3_SUPPORT_HOB_GUID;
+EFI_GUID gS3SupportSmramDataGuid  = EFI_PCH_S3_SUPPORT_DATA_GUID;
+
+//
+// Functions
+//
+
+/**
+  PCH S3 support driver entry point
+
+  @param[in] ImageHandle          Handle for the image of this driver
+  @param[in] SystemTable          Pointer to the EFI System Table
+
+  @retval EFI_STATUS
+**/
+EFI_STATUS
+EFIAPI
+PchS3SupportEntryPoint (
+  IN EFI_HANDLE         ImageHandle,
+  IN EFI_SYSTEM_TABLE   *SystemTable
+  )
+{
+  EFI_STATUS                        Status;
+
+  DEBUG ((EFI_D_INFO, "PchS3SupportEntryPoint() Start\n"));
+  mImageHandle = ImageHandle;
+
+  ///
+  /// Initialize the Boot Services memory for the Dispatch Script Array
+  ///
+  Status = InitializePchS3CustomScriptMemory();
+  ASSERT_EFI_ERROR (Status);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  DEBUG ((EFI_D_INFO, "Dispatch Script Array Space initialized.\n"));
+
+  ///
+  /// Retrieve the PCH S3 Support PEIM entry point and load it into the Module variable
+  ///
+  Status = LoadPchS3ImageEntryPoint (&mPchS3ImageEntryPoint);
+  ASSERT_EFI_ERROR (Status);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  DEBUG ((EFI_D_INFO, "PCH S3 Image Entry Point intialized.\n"));
+
+  ///
+  /// Initialize and Install the PCH S3 Support and PCH S3 SMM Support protocols
+  ///
+  mPchS3SupportSmmProtocol.DispatchArray = mPchS3CustomDispatchScript;
+  mPchS3SupportSmmProtocol.ProtocolSize = 1;  // Allocate one page
+  mPchS3SupportProtocol.SetDispatchItem = PchS3SetDispatchItem;
+  mPchS3SupportProtocol.ReadyToLock = S3SupportReadyToLock;
+  Status = gBS->InstallMultipleProtocolInterfaces (
+                  &mImageHandle,
+                  &gEfiPchS3SupportProtocolGuid,
+                  &mPchS3SupportProtocol,
+                  &gEfiPchS3SupportSmmProtocolGuid,
+                  &mPchS3SupportSmmProtocol,
+                  NULL
+                  );
+  ASSERT_EFI_ERROR (Status);
+
+  DEBUG ((EFI_D_INFO, "PchS3SupportEntryPoint() End\n"));
+
+  return Status;
+}
+
+/**
+  Set an item to be dispatched at S3 resume time. This will initially create a Script
+  entry in Boot Services memory.  At the same time, the entry point of the PCH S3 support
+  image is returned to be used in subsequent boot script save calls.
+
+  @param[in] This                       Pointer to the protocol instance.
+  @param[in] DispatchItem               The item to be dispatched.
+  @param[out] S3DispatchEntryPoint      The entry point of the PCH S3 support image.
+
+  @retval EFI_STATUS                    Successfully completed.
+  @retval EFI_OUT_OF_RESOURCES          Out of resources.
+**/
+EFI_STATUS
+EFIAPI
+PchS3SetDispatchItem (
+  IN     EFI_PCH_S3_SUPPORT_PROTOCOL   *This,
+  IN     EFI_PCH_S3_DISPATCH_ITEM      *InputDispatchItem,
+  OUT    EFI_PHYSICAL_ADDRESS          *S3DispatchEntryPoint
+  )
+{
+  EFI_STATUS                Status;
+  UINT32                    TypeSize;
+  UINT32                    ParameterSize;
+  UINT32                    Size;
+  UINT8                     *CurrentPos;
+
+  DEBUG ((EFI_D_INFO, "PchS3SetDispatchItem() Start\n"));
+
+  Status = EFI_SUCCESS;
+
+  DEBUG ((EFI_D_INFO, "Dispatch Item Address: 0x%x; Dispatch Item Type: %x\n", (UINTN)InputDispatchItem, (UINTN)InputDispatchItem->ItemType.Value));
+
+  ///
+  /// Calculate the size required;
+  /// ** Always round up to be 8 byte aligned as the script is initially created from 64-bit code in DXE
+  ///
+  switch (InputDispatchItem->ItemType.Value) {
+  case PchS3ItemTypeSendCodecCommand:
+    ParameterSize = QWORD_ALIGNED_SIZE(EFI_PCH_S3_PARAMETER_SEND_CODEC_COMMAND);
+    break;
+
+  case PchS3ItemTypeInitPcieRootPortDownstream:
+    ParameterSize = QWORD_ALIGNED_SIZE(EFI_PCH_S3_PARAMETER_INIT_PCIE_ROOT_PORT_DOWNSTREAM);
+    break;
+
+  case PchS3ItemTypePcieSetPm:
+    ParameterSize = QWORD_ALIGNED_SIZE(EFI_PCH_S3_PARAMETER_PCIE_SET_PM);
+    break;
+
+  case PchS3ItemTypeProgramIobp:
+    ParameterSize = QWORD_ALIGNED_SIZE(EFI_PCH_S3_PARAMETER_PROG_IOBP);
+    break;
+
+  default:
+    ParameterSize = 0;
+    DEBUG ((EFI_D_INFO, "Unrecognized Custom Dispatch Type\n"));
+    ASSERT (FALSE);
+    return EFI_INVALID_PARAMETER;
+  }
+  
+  ///
+  /// Round up TypeSize to be 8 byte aligned
+  ///
+  TypeSize  = QWORD_ALIGNED_SIZE (EFI_PCH_S3_DISPATCH_ITEM_TYPE);
+
+  ///
+  /// Total size is TypeSize + ParameterSize
+  ///
+  Size = TypeSize + ParameterSize;
+
+  if (mPchS3CustomDispatchScript->BufferSpaceRemaining < Size) {
+    DEBUG ((EFI_D_INFO, "Space remaining in Dispatch Script buffer is too small\n"));
+    ASSERT (FALSE);
+    return EFI_OUT_OF_RESOURCES;
+  }
+
+  if (mPchS3CustomDispatchScript->NextDispatchItem == NULL) {
+    DEBUG ((EFI_D_INFO, "S3 Support Protocol has been unregistered.  Error.\n"));
+    ASSERT (FALSE);
+    return EFI_ACCESS_DENIED;
+  }
+
+  ///
+  /// Store the dispatch type and dispatch parameter
+  ///
+  CurrentPos  = mPchS3CustomDispatchScript->NextDispatchItem;
+  *(EFI_PCH_S3_DISPATCH_ITEM_TYPE *)CurrentPos = InputDispatchItem->ItemType.Value;
+  CurrentPos += TypeSize;
+  CopyMem (CurrentPos, InputDispatchItem->Parameter, ParameterSize);
+
+  ///
+  /// Move the pointer to the NextDispatchItem ahead to free space in our buffer
+  /// and decrement the space remaining data
+  ///
+  mPchS3CustomDispatchScript->NextDispatchItem += Size;
+  mPchS3CustomDispatchScript->BufferSpaceRemaining -= Size;
+
+  ///
+  /// Return the S3 Image's entry point
+  ///
+  *S3DispatchEntryPoint = mPchS3ImageEntryPoint;
+
+  DEBUG ((EFI_D_INFO, "PchS3SetDispatchItem() End\n"));
+
+  return Status;
+}
+  
+
+/**
+  Perform the EFI_PCH_S3_SUPPORT_SMM_PROTOCOL IO Trap to invoke DispatchArray data copy and
+  IO Trap Unregister.
+
+  @param[in] This                       Pointer to the protocol instance.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+**/
+EFI_STATUS
+EFIAPI
+S3SupportReadyToLock(
+  IN    EFI_PCH_S3_SUPPORT_PROTOCOL   *This
+  )
+{
+  EFI_STATUS                        Status;
+
+
+  DEBUG ((EFI_D_INFO, "S3SupportExitPmAuthCallback() Start\n"));
+
+  Status = EFI_SUCCESS;
+
+  DEBUG ((EFI_D_INFO, "Invoke the S3 Support IO Trap: 0x%x\n", mPchS3SupportSmmProtocol.PchS3SupportIoTrap));
+
+  ///
+  /// Invoke the SMM IO Trap Handler for invoking the data copy to SMRAM and unregistration of the IO Trap
+  ///
+  IoWrite32 (mPchS3SupportSmmProtocol.PchS3SupportIoTrap, 0);
+
+  if (mImageHandle != NULL)
+  {
+    DEBUG ((EFI_D_INFO, "Uninstall the S3 Support Protocol\n", mPchS3SupportSmmProtocol.PchS3SupportIoTrap));
+
+    Status = gBS->UninstallMultipleProtocolInterfaces (
+                  mImageHandle,
+                  &gEfiPchS3SupportProtocolGuid,
+                  &mPchS3SupportProtocol,
+                  NULL
+                  );
+    ASSERT_EFI_ERROR (Status);
+  }
+  DEBUG ((EFI_D_INFO, "S3SupportExitPmAuthCallback() End\n"));
+
+  return Status;
+}
+
+/**
+  Initialize the Pch S3 Custom Script memory area.  This will later be transferred to SMRAM.
+  
+  @param[in] VOID
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_OUT_OF_RESOURCES          Not enough space was available to allocate for the BS memory required.
+**/
+EFI_STATUS
+InitializePchS3CustomScriptMemory (
+  VOID
+  )
+{
+  EFI_STATUS            Status;
+  EFI_PHYSICAL_ADDRESS  Address;
+
+  ///
+  /// Allocate Boot Services memory for the initial copy of the PCH S3 Custom Dispatch Script
+  ///
+  Status = (gBS->AllocatePool)(
+    EfiBootServicesData, 
+    EFI_PAGE_SIZE, 
+    &(VOID *)Address);
+  if (!EFI_ERROR (Status)) {
+
+    mPchS3CustomDispatchScript = (EFI_PCH_S3_DISPATCH_ARRAY *)(UINTN)Address;
+
+    ///
+    /// Initialize the DispatchScriptArray
+    /// Ensure to account for the HOB space that will be needed for moving the data from SMRAM to normal
+    /// memory during S3 resume in the MaximumBufferSize parameter.
+    ///
+    mPchS3CustomDispatchScript->PchS3CustomScriptGuid = gS3SupportSmramDataGuid;
+    mPchS3CustomDispatchScript->MaximumBufferSize = EFI_PAGE_SIZE - QWORD_ALIGNED_SIZE(EFI_HOB_GUID_TYPE);
+    mPchS3CustomDispatchScript->BufferSpaceRemaining = mPchS3CustomDispatchScript->MaximumBufferSize - QWORD_ALIGNED_SIZE(EFI_PCH_S3_DISPATCH_ARRAY);
+    mPchS3CustomDispatchScript->NextDispatchItem = (UINT8*)mPchS3CustomDispatchScript + QWORD_ALIGNED_SIZE(EFI_PCH_S3_DISPATCH_ARRAY);
+  }
+
+  return Status;
+}
+
+
+/**
+  Load the entry point address of the PCHS3Peim from the HOB that it generated during the PEI phase of POST
+
+  @param[out] ImageEntryPoint     The ImageEntryPoint after success loading
+
+  @retval EFI_STATUS
+**/
+EFI_STATUS
+LoadPchS3ImageEntryPoint (
+  OUT   UINT32          *ImageEntryPoint
+  )
+{
+  EFI_STATUS                      Status;
+  S3_SUPPORT_HOB                  *S3SupportHob;
+//  EFI_SPI_DATA_PROTOCOL           *SpiDataInterface;
+
+  DEBUG ((EFI_D_INFO, "LoadPchS3ImageEntryPoint() Start\n"));
+
+  Status = EFI_SUCCESS;
+  S3SupportHob = NULL;
+  *ImageEntryPoint = 0;
+
+  //
+  // Search for the S3SupportHob
+  //
+  S3SupportHob = GetFirstGuidHob(&gS3SupportHobGuid);
+  if (S3SupportHob == NULL) {
+    DEBUG ((EFI_D_INFO, "S3SupportHob not found.\n"));
+    ASSERT_EFI_ERROR (Status);
+    return Status;
+  }
+
+  //
+  // Find the SPI protocol and save the pointer.
+  //
+//  Status = gBS->LocateProtocol (&gEfiSpiDataProtocolGuid, NULL, &SpiDataInterface);
+//  if (EFI_ERROR (Status)) {
+//    DEBUG ((EFI_D_ERROR, "ERROR - Spi LocateProtocol failed!\n"));
+//    return Status;
+//  }
+
+  ///
+  /// If the PCH S3 PEIM is not located in flash, fail
+  ///
+// AMI_OVERRIDE, [ EIP217847 ] >>>
+//  if (S3SupportHob->PchS3PeimEntryPoint < SpiDataInterface->BiosStartMemoryAddress ||
+//      S3SupportHob->PchS3PeimEntryPoint > SpiDataInterface->BiosStartMemoryAddress + SpiDataInterface->BiosSize)
+  if ((S3SupportHob->PchS3PeimEntryPoint < (0xFFFFFFFF - FLASH_SIZE + 1)) || (S3SupportHob->PchS3PeimEntryPoint > 0xFFFFFFFF))
+// AMI_OVERRIDE, [ EIP217847 ] <<<
+  {
+    DEBUG ((EFI_D_INFO, "PchS3Image is NOT located in Flash. Current Entry Point: %x\n", S3SupportHob->PchS3PeimEntryPoint));
+    
+    ASSERT(FALSE);
+    return EFI_SECURITY_VIOLATION;
+  }
+
+  // Load the HOB data from PEI execution which contains the entry point of the PCHS3Peim from Flash
+  *ImageEntryPoint = S3SupportHob->PchS3PeimEntryPoint;
+
+  DEBUG ((EFI_D_INFO, "PchS3Image is Located in Flash at Entry Point: %x\n", S3SupportHob->PchS3PeimEntryPoint));
+  DEBUG ((EFI_D_INFO, "LoadPchS3ImageEntryPoint() End\n"));
+  
+  return Status;
+}
\ No newline at end of file
diff --git a/ReferenceCode/Chipset/LynxPoint/S3Support/Dxe/PchS3Support.cif b/ReferenceCode/Chipset/LynxPoint/S3Support/Dxe/PchS3Support.cif
new file mode 100644
index 0000000..cbd8f6a
--- /dev/null
+++ b/ReferenceCode/Chipset/LynxPoint/S3Support/Dxe/PchS3Support.cif
@@ -0,0 +1,13 @@
+<component>
+	name = "PchS3Support"
+	category = ModulePart
+	LocalRoot = "ReferenceCode\Chipset\LynxPoint\S3Support\Dxe"
+	RefName = "PchS3Support"
+[files]
+"PchS3Support.sdl"	
+"PchS3Support.mak"	
+"PchS3Support.c"	
+"PchS3Support.h"	
+"PchS3Support.dxs"	
+"PchS3Support.inf"	
+<endComponent>
\ No newline at end of file
diff --git a/ReferenceCode/Chipset/LynxPoint/S3Support/Dxe/PchS3Support.dxs b/ReferenceCode/Chipset/LynxPoint/S3Support/Dxe/PchS3Support.dxs
new file mode 100644
index 0000000..8c346bd
--- /dev/null
+++ b/ReferenceCode/Chipset/LynxPoint/S3Support/Dxe/PchS3Support.dxs
@@ -0,0 +1,45 @@
+/** @file
+  Dispatch dependency expression file for the PchS3Support driver.
+
+@copyright
+  Copyright (c)  1999 - 2015 Intel Corporation. All rights reserved
+  This software and associated documentation (if any) is furnished
+  under a license and may only be used or copied in accordance
+  with the terms of the license. Except as permitted by such
+  license, no part of this software or documentation may be
+  reproduced, stored in a retrieval system, or transmitted in any
+  form or by any means without the express written consent of
+  Intel Corporation.
+
+  This file contains a 'Sample Driver' and is licensed as such
+  under the terms of your license agreement with Intel or your
+  vendor.  This file may be modified by the user, subject to
+  the additional terms of the license agreement
+
+**/
+
+//
+// Common for R8 and R9 codebase
+//
+#include "AutoGen.h"
+#include "DxeDepex.h"
+
+//
+// BUILD_WITH_GLUELIB and BUILD_WITH_EDKII_GLUE_LIB are both "defined" in R8 codebase;
+// BUILD_WITH_EDKII_GLUE_LIB is defined in Edk-Dev-Snapshot-20070228 and later version
+// BUILD_WITH_GLUELIB and BUILD_WITH_EDKII_GLUE_LIB are "not defined" in R9 codebase.
+//
+#if defined (BUILD_WITH_GLUELIB) || defined (BUILD_WITH_EDKII_GLUE_LIB)
+#include "EfiDepex.h"
+
+#include EFI_PROTOCOL_DEFINITION      (BootScriptSave)
+#include EFI_PROTOCOL_CONSUMER        (Spi)
+#endif
+
+//DEPENDENCY_START
+//  EFI_BOOT_SCRIPT_SAVE_PROTOCOL_GUID AND
+//  EFI_SPI_DATA_PROTOCOL_GUID
+//DEPENDENCY_END
+DEPENDENCY_START
+  EFI_BOOT_SCRIPT_SAVE_PROTOCOL_GUID
+DEPENDENCY_END
\ No newline at end of file
diff --git a/ReferenceCode/Chipset/LynxPoint/S3Support/Dxe/PchS3Support.h b/ReferenceCode/Chipset/LynxPoint/S3Support/Dxe/PchS3Support.h
new file mode 100644
index 0000000..817f786
--- /dev/null
+++ b/ReferenceCode/Chipset/LynxPoint/S3Support/Dxe/PchS3Support.h
@@ -0,0 +1,126 @@
+/** @file
+  Header file for PCH S3 Support driver
+
+@copyright
+  Copyright (c) 1999 - 2015 Intel Corporation. All rights reserved
+  This software and associated documentation (if any) is furnished
+  under a license and may only be used or copied in accordance
+  with the terms of the license. Except as permitted by such
+  license, no part of this software or documentation may be
+  reproduced, stored in a retrieval system, or transmitted in any
+  form or by any means without the express written consent of
+  Intel Corporation.
+
+  This file contains an 'Intel Peripheral Driver' and uniquely
+  identified as "Intel Reference Module" and is
+  licensed for Intel CPUs and chipsets under the terms of your
+  license agreement with Intel or your vendor.  This file may
+  be modified by the user, subject to additional terms of the
+  license agreement
+**/
+#ifndef _PCH_S3_SUPPORT_DRIVER_H_
+#define _PCH_S3_SUPPORT_DRIVER_H_
+
+//
+// External include files do NOT need to be explicitly specified in real EDKII
+// environment
+//
+#if !defined(EDK_RELEASE_VERSION) || (EDK_RELEASE_VERSION < 0x00020000)
+
+#include "EdkIIGlueDxe.h"
+#include "EfiScriptLib.h"
+
+//
+// Driver Produced Protocol Prototypes
+//
+#include EFI_PROTOCOL_PRODUCER (PchS3Support)
+#include EFI_GUID_DEFINITION   (S3SupportHob)
+#include EFI_PROTOCOL_CONSUMER (Spi)
+
+#include "PchAccess.h"
+#include "PchPlatformLib.h"
+#endif
+
+///
+/// EDK and EDKII have different GUID formats
+///
+#if !defined(EDK_RELEASE_VERSION) || (EDK_RELEASE_VERSION < 0x00020000)
+#define EFI_PCH_S3_IMAGE_GUID \
+  { \
+    0x271dd6f2, 0x54cb, 0x45e6, 0x85, 0x85, 0x8c, 0x92, 0x3c, 0x1a, 0xc7, 0x6 \
+  }
+#else
+#define EFI_PCH_S3_IMAGE_GUID \
+  { \
+    0x271dd6f2, 0x54cb, 0x45e6, \
+    { \
+      0x85, 0x85, 0x8c, 0x92, 0x3c, 0x1a, 0xc7, 0x6 \
+    } \
+  }
+#endif
+
+extern EFI_GUID gEfiSpiProtocolGuid;
+
+//
+// Function prototypes
+//
+
+/**
+  Set an item to be dispatched at S3 resume time. At the same time, the entry point
+  of the PCH S3 support image is returned to be used in subsequent boot script save
+  call
+
+  @param[in] This                       Pointer to the protocol instance.
+  @param[in] InputDispatchItem          The item to be dispatched.
+  @param[out] S3DispatchEntryPoint      The entry point of the PCH S3 support image.
+
+  @retval EFI_STATUS                    Successfully completed.
+  @retval EFI_OUT_OF_RESOURCES          Out of resources.
+**/
+EFI_STATUS
+EFIAPI
+PchS3SetDispatchItem (
+  IN     EFI_PCH_S3_SUPPORT_PROTOCOL   *This,
+  IN     EFI_PCH_S3_DISPATCH_ITEM      *InputDispatchItem,
+  OUT    EFI_PHYSICAL_ADDRESS          *S3DispatchEntryPoint
+  );
+
+/**
+  Perform the EFI_PCH_S3_SUPPORT_SMM_PROTOCOL IO Trap to invoke DispatchArray data copy and
+  IO Trap Unregister.
+
+  @param[in] This                       Pointer to the protocol instance.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+**/
+EFI_STATUS
+EFIAPI
+S3SupportReadyToLock(
+  IN    EFI_PCH_S3_SUPPORT_PROTOCOL   *This
+  );
+
+/**
+  Initialize the Pch S3 Custom Script memory area.  This will later be transferred to SMRAM.
+  
+  @param[in] VOID
+
+  @retval None
+**/
+EFI_STATUS
+InitializePchS3CustomScriptMemory (
+  VOID
+  );
+
+/**
+  Load the entry point address of the PCHS3Peim from the HOB that it generated during the PEI phase of POST
+
+  @param[out] ImageEntryPoint     The ImageEntryPoint after success loading
+
+  @retval EFI_STATUS
+**/
+EFI_STATUS
+LoadPchS3ImageEntryPoint (
+  OUT   UINT32          *ImageEntryPoint
+  );
+
+#endif
diff --git a/ReferenceCode/Chipset/LynxPoint/S3Support/Dxe/PchS3Support.inf b/ReferenceCode/Chipset/LynxPoint/S3Support/Dxe/PchS3Support.inf
new file mode 100644
index 0000000..c65847f
--- /dev/null
+++ b/ReferenceCode/Chipset/LynxPoint/S3Support/Dxe/PchS3Support.inf
@@ -0,0 +1,103 @@
+## @file
+#  Component description file for Pch Initialization driver
+#
+#@copyright
+#  Copyright (c)  1999 - 2015 Intel Corporation. All rights reserved
+#  This software and associated documentation (if any) is furnished
+#  under a license and may only be used or copied in accordance
+#  with the terms of the license. Except as permitted by such
+#  license, no part of this software or documentation may be
+#  reproduced, stored in a retrieval system, or transmitted in any
+#  form or by any means without the express written consent of
+#  Intel Corporation.
+#
+#  This file contains a 'Sample Driver' and is licensed as such
+#  under the terms of your license agreement with Intel or your
+#  vendor.  This file may be modified by the user, subject to
+#  the additional terms of the license agreement
+#
+
+[defines]
+BASE_NAME            = PchS3Support
+FILE_GUID            = C7EA9787-CA0A-43b4-B1E5-25EF87391F8D
+COMPONENT_TYPE       = BS_DRIVER
+
+[sources.common]
+  PchS3Support.h
+  PchS3Support.c
+
+#
+# Edk II Glue Driver Entry Point
+#
+  EdkIIGlueDxeDriverEntryPoint.c
+
+[includes.common]
+  $(EDK_SOURCE)/Foundation/Efi
+  .
+  $(EDK_SOURCE)/Foundation/Include
+  $(EDK_SOURCE)/Foundation/Efi/Include
+  $(EDK_SOURCE)/Foundation/Framework/Include
+  $(EDK_SOURCE)/Foundation/Framework/Guid/Hob
+  $(EFI_SOURCE)/$(PROJECT_PCH_ROOT)
+  $(EFI_SOURCE)/$(PROJECT_PCH_ROOT)/Include
+  $(EFI_SOURCE)/$(PROJECT_PCH_ROOT)/Include/Library
+  $(EFI_SOURCE)/$(PROJECT_PCH_ROOT)/Guid/S3SupportHob
+  $(EFI_SOURCE)/$(PROJECT_PCH_ROOT)/Protocol
+  $(EFI_SOURCE)/$(PROJECT_PCH_ROOT)/Protocol/PchPlatformPolicy
+  $(EFI_SOURCE)/$(PROJECT_PCH_ROOT)/Protocol/PchS3Support
+#
+# EDK II Glue Library utilizes some standard headers from EDK
+#
+  $(EFI_SOURCE)
+  $(EDK_SOURCE)/Foundation
+  $(EDK_SOURCE)/Foundation/Framework
+  $(EDK_SOURCE)/Foundation/Include/IndustryStandard
+  $(EDK_SOURCE)/Foundation/Core/Dxe
+  $(EDK_SOURCE)/Foundation/Library/Dxe/Include
+  $(EDK_SOURCE)/Foundation/Library/EdkIIGlueLib/Include
+  $(EDK_SOURCE)/Foundation/Library/EdkIIGlueLib/Include/Library
+
+#
+# Typically the sample code referenced will be available in the code base already
+# So keep this include at the end to defer to the source base definition
+# and only use the sample code definition if source base does not include these files.
+#
+  $(EFI_SOURCE)/$(PROJECT_PCH_ROOT)/SampleCode
+
+[libraries.common]
+  EfiScriptLib
+  EfiCommonLib
+  EdkProtocolLib
+  EdkFrameworkProtocolLib
+  $(PROJECT_PCH_FAMILY)ProtocolLib
+  PchPlatformLib
+  EdkIIGlueBaseIoLibIntrinsic
+  EdkIIGlueDxeReportStatusCodeLib
+  EdkIIGlueDxeDebugLibReportStatusCode
+  EdkIIGlueUefiBootServicesTableLib
+  EdkIIGlueUefiRuntimeServicesTableLib
+  EdkIIGlueDxeServicesTableLib
+  EdkIIGlueDxeMemoryAllocationLib
+  EdkIIGlueDxeHobLib
+  EdkIIGlueBasePciLibPciExpress
+  EfiDriverLib
+  EdkIIGlueUefiDevicePathLib
+  EdkIIGlueUefiLib
+  EfiGuidLib
+
+[nmake.common]
+  IMAGE_ENTRY_POINT = _ModuleEntryPoint
+  DPX_SOURCE        = PchS3Support.dxs
+#
+# Module Entry Point
+#
+  C_FLAGS = $(C_FLAGS) -D __EDKII_GLUE_MODULE_ENTRY_POINT__=PchS3SupportEntryPoint
+  C_FLAGS = $(C_FLAGS) -D __EDKII_GLUE_BASE_IO_LIB_INTRINSIC__ \
+                       -D __EDKII_GLUE_DXE_REPORT_STATUS_CODE_LIB__ \
+                       -D __EDKII_GLUE_DXE_DEBUG_LIB_REPORT_STATUS_CODE__ \
+                       -D __EDKII_GLUE_UEFI_BOOT_SERVICES_TABLE_LIB__ \
+                       -D __EDKII_GLUE_UEFI_RUNTIME_SERVICES_TABLE_LIB__ \
+                       -D __EDKII_GLUE_DXE_SERVICES_TABLE_LIB__ \
+                       -D __EDKII_GLUE_DXE_MEMORY_ALLOCATION_LIB__ \
+                       -D __EDKII_GLUE_BASE_PCI_LIB_PCI_EXPRESS__ \
+                       -D __EDKII_GLUE_DXE_HOB_LIB__
diff --git a/ReferenceCode/Chipset/LynxPoint/S3Support/Dxe/PchS3Support.mak b/ReferenceCode/Chipset/LynxPoint/S3Support/Dxe/PchS3Support.mak
new file mode 100644
index 0000000..cabc751
--- /dev/null
+++ b/ReferenceCode/Chipset/LynxPoint/S3Support/Dxe/PchS3Support.mak
@@ -0,0 +1,115 @@
+#*************************************************************************
+#*************************************************************************
+#**                                                                     **
+#**        (C)Copyright 1985-2015, American Megatrends, Inc.            **
+#**                                                                     **
+#**                       All Rights Reserved.                          **
+#**                                                                     **
+#**      5555 Oakbrook Parkway, Suite 200, Norcross, GA 30093           **
+#**                                                                     **
+#**                       Phone: (770)-246-8600                         **
+#**                                                                     **
+#*************************************************************************
+#*************************************************************************
+
+#*************************************************************************
+# $Header: /Alaska/BIN/Chipset/Intel/SouthBridge/LynxPoint/Intel Pch SB Refcode/S3Support/Dxe/PchS3Support.mak 1     5/21/15 2:53a Dennisliu $
+#
+# $Revision: 1 $
+#
+# $Date: 5/21/15 2:53a $
+#*************************************************************************
+# Revision History
+# ----------------
+# $Log: /Alaska/BIN/Chipset/Intel/SouthBridge/LynxPoint/Intel Pch SB Refcode/S3Support/Dxe/PchS3Support.mak $
+# 
+# 1     5/21/15 2:53a Dennisliu
+# [TAG]  		EIP217847 
+# [Category]  	Improvement
+# [Description]  	[PCH] Shark Bay-M/DT Reference Code Production Version
+# 1.9.1
+# [Files]  		PchS3Support.sdl
+# PchS3Support.mak
+# PchS3Support.c
+# PchS3Support.h
+# PchS3Support.dxs
+# PchS3Support.inf
+# 
+#*************************************************************************
+
+#---------------------------------------------------------------------------
+#   Create PchS3Support Driver
+#---------------------------------------------------------------------------
+EDK : PchS3Support
+PchS3Support : $(BUILD_DIR)\PchS3Support.mak PchS3SupportBin
+
+
+$(BUILD_DIR)\PchS3Support.mak : $(PchS3Support_DIR)\$(@B).cif $(PchS3Support_DIR)\$(@B).mak $(BUILD_RULES)
+  $(CIF2MAK) $(PchS3Support_DIR)\$(@B).cif $(CIF2MAK_DEFAULTS)
+
+PchS3Support_INCLUDES=\
+            $(INTEL_PCH_INCLUDES)\
+            $(EdkIIGlueLib_INCLUDES)\
+
+PchS3Support_DEFINES = $(MY_DEFINES)\
+            /D"__EDKII_GLUE_MODULE_ENTRY_POINT__=PchS3SupportEntryPoint"\
+            /D __EDKII_GLUE_BASE_IO_LIB_INTRINSIC__ \
+            /D __EDKII_GLUE_DXE_REPORT_STATUS_CODE_LIB__ \
+            /D __EDKII_GLUE_DXE_DEBUG_LIB_REPORT_STATUS_CODE__ \
+            /D __EDKII_GLUE_UEFI_BOOT_SERVICES_TABLE_LIB__ \
+            /D __EDKII_GLUE_DXE_SERVICES_TABLE_LIB__ \
+            /D __EDKII_GLUE_BASE_PCI_LIB_PCI_EXPRESS__ \
+            /D __EDKII_GLUE_UEFI_RUNTIME_SERVICES_TABLE_LIB__ \
+            /D __EDKII_GLUE_DXE_HOB_LIB__ \
+
+PchS3Support_LIB_LINKS =\
+            $(EDKFRAMEWORKPROTOCOLLIB)\
+            $(EDKPROTOCOLLIB)\
+            $(PchPlatformDxeLib_LIB)\
+            $(EFISCRIPTLIB) $(EFIPROTOCOLLIB)\
+            $(INTEL_PCH_PROTOCOL_LIB)\
+            $(EdkIIGlueBaseLib_LIB)\
+!IF "$(x64_BUILD)"=="1"
+            $(EdkIIGlueBaseLibX64_LIB)\
+!ELSE
+            $(EdkIIGlueBaseLibIA32_LIB)\
+!ENDIF
+            $(EdkIIGlueBaseIoLibIntrinsic_LIB)\
+            $(EdkIIGlueDxeReportStatusCodeLib_LIB)\
+            $(EdkIIGlueDxeDebugLibReportStatusCode_LIB)\
+            $(EdkIIGlueUefiBootServicesTableLib_LIB)\
+            $(EdkIIGlueDxeServicesTableLib_LIB)\
+            $(PchS3SupportCommonDxeLib_LIB)\
+            $(EdkIIGlueBasePciLibPciExpress_LIB)\
+            $(EdkIIGlueUefiRuntimeServicesTableLib_LIB)\
+            $(EFIDRIVERLIB)\
+            $(EdkIIGlueUefiDevicePathLib_LIB)\
+            $(EdkIIGlueUefiLib_LIB)\
+            $(EdkIIGlueDxeHobLib_LIB)\
+
+
+PchS3SupportBin: $(PchS3Support_LIB_LINKS)
+            $(MAKE) /$(MAKEFLAGS) $(EDKIIGLUE_DEFAULTS)\
+            /f $(BUILD_DIR)\PchS3Support.mak all \
+            "MY_INCLUDES=$(PchS3Support_INCLUDES)"\
+            "MY_DEFINES=$(PchS3Support_DEFINES)"\
+            GUID=08F2C63B-08DE-4ccd-8670-ACFE644A1C48\
+            ENTRY_POINT=_ModuleEntryPoint \
+            TYPE=BS_DRIVER\
+            EDKIIModule=DXEDRIVER\
+            DEPEX1=$(PchS3Support_DIR)\PchS3Support.dxs\
+            DEPEX1_TYPE=EFI_SECTION_DXE_DEPEX\
+            COMPRESS=1
+#*************************************************************************
+#*************************************************************************
+#**                                                                     **
+#**        (C)Copyright 1985-2015, American Megatrends, Inc.            **
+#**                                                                     **
+#**                       All Rights Reserved.                          **
+#**                                                                     **
+#**      5555 Oakbrook Parkway, Suite 200, Norcross, GA 30093           **
+#**                                                                     **
+#**                       Phone: (770)-246-8600                         **
+#**                                                                     **
+#*************************************************************************
+#*************************************************************************
\ No newline at end of file
diff --git a/ReferenceCode/Chipset/LynxPoint/S3Support/Dxe/PchS3Support.sdl b/ReferenceCode/Chipset/LynxPoint/S3Support/Dxe/PchS3Support.sdl
new file mode 100644
index 0000000..15c9702
--- /dev/null
+++ b/ReferenceCode/Chipset/LynxPoint/S3Support/Dxe/PchS3Support.sdl
@@ -0,0 +1,75 @@
+#*************************************************************************
+#*************************************************************************
+#**                                                                     **
+#**        (C)Copyright 1985-2015, American Megatrends, Inc.            **
+#**                                                                     **
+#**                       All Rights Reserved.                          **
+#**                                                                     **
+#**      5555 Oakbrook Parkway, Suite 200, Norcross, GA 30093           **
+#**                                                                     **
+#**                       Phone: (770)-246-8600                         **
+#**                                                                     **
+#*************************************************************************
+#*************************************************************************
+
+#*************************************************************************
+# $Header: /Alaska/BIN/Chipset/Intel/SouthBridge/LynxPoint/Intel Pch SB Refcode/S3Support/Dxe/PchS3Support.sdl 1     5/21/15 2:53a Dennisliu $
+#
+# $Revision: 1 $
+#
+# $Date: 5/21/15 2:53a $
+#*************************************************************************
+# Revision History
+# ----------------
+# $Log: /Alaska/BIN/Chipset/Intel/SouthBridge/LynxPoint/Intel Pch SB Refcode/S3Support/Dxe/PchS3Support.sdl $
+# 
+# 1     5/21/15 2:53a Dennisliu
+# [TAG]  		EIP217847 
+# [Category]  	Improvement
+# [Description]  	[PCH] Shark Bay-M/DT Reference Code Production Version
+# 1.9.1
+# [Files]  		PchS3Support.sdl
+# PchS3Support.mak
+# PchS3Support.c
+# PchS3Support.h
+# PchS3Support.dxs
+# PchS3Support.inf
+# 
+#*************************************************************************
+TOKEN
+        Name  = "PchS3Support_SUPPORT"
+        Value  = "1"
+        Help  = "Main switch to enable PchS3Support support in Project"
+        TokenType = Boolean
+        TargetEQU = Yes
+        TargetMAK = Yes
+        Master = Yes
+End
+
+PATH
+        Name  = "PchS3Support_DIR"
+End
+
+MODULE
+        Help  = "Includes PchS3Support.mak to Project"
+        File  = "PchS3Support.mak"
+End
+
+ELINK
+        Name  = "$(BUILD_DIR)\PchS3Support.ffs"
+        Parent  = "FV_MAIN"
+        InvokeOrder = AfterParent
+End
+#*************************************************************************
+#*************************************************************************
+#**                                                                     **
+#**        (C)Copyright 1985-2015, American Megatrends, Inc.            **
+#**                                                                     **
+#**                       All Rights Reserved.                          **
+#**                                                                     **
+#**      5555 Oakbrook Parkway, Suite 200, Norcross, GA 30093           **
+#**                                                                     **
+#**                       Phone: (770)-246-8600                         **
+#**                                                                     **
+#*************************************************************************
+#*************************************************************************
\ No newline at end of file