Import PeiDxePostCodeLibReportStatusCode.

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@2891 6f19259b-4bc3-4df7-8a09-765794883524

2 files changed, 206 insertions, 0 deletions

diff --git a/MdePkg/Library/PeiDxePostCodeLibReportStatusCode/PeiDxePostCodeLibReportStatusCode.msa b/MdePkg/Library/PeiDxePostCodeLibReportStatusCode/PeiDxePostCodeLibReportStatusCode.msa
new file mode 100644
index 0000000000..2b1bf6ac2e
--- /dev/null
+++ b/MdePkg/Library/PeiDxePostCodeLibReportStatusCode/PeiDxePostCodeLibReportStatusCode.msa
@@ -0,0 +1,56 @@
+<?xml version="1.0" encoding="UTF-8"?>

+<ModuleSurfaceArea xmlns="http://www.TianoCore.org/2006/Edk2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

+  <MsaHeader>

+    <ModuleName>PeiDxePostCodeLibReportStatusCode</ModuleName>

+    <ModuleType>PEIM</ModuleType>

+    <GuidValue>e062c52d-78dc-4cc5-b246-b13497a8123c</GuidValue>

+    <Version>1.0</Version>

+    <Abstract>Post code library based on report status code library</Abstract>

+    <Description>PostCode Library for PEIMs and DXE drivers that send PostCode to ReportStatusCode</Description>

+    <Copyright>Copyright (c) 2006, Intel Corporation.</Copyright>

+    <License>All rights reserved. This program and the accompanying materials
+      are licensed and made available under the terms and conditions of the BSD License
+      which 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.</License>

+    <Specification>FRAMEWORK_BUILD_PACKAGING_SPECIFICATION   0x00000052</Specification>

+  </MsaHeader>

+  <ModuleDefinitions>

+    <SupportedArchitectures>IA32 X64 IPF EBC</SupportedArchitectures>

+    <BinaryModule>false</BinaryModule>

+    <OutputFileBasename>PeiDxePostCodeLibReportStatusCode</OutputFileBasename>

+  </ModuleDefinitions>

+  <LibraryClassDefinitions>

+    <LibraryClass Usage="ALWAYS_PRODUCED" SupModuleList="DXE_CORE DXE_DRIVER DXE_RUNTIME_DRIVER DXE_SAL_DRIVER DXE_SMM_DRIVER PEIM PEI_CORE UEFI_APPLICATION UEFI_DRIVER">

+      <Keyword>PostCodeLib</Keyword>

+    </LibraryClass>

+    <LibraryClass Usage="ALWAYS_CONSUMED">

+      <Keyword>ReportStatusCodeLib</Keyword>

+    </LibraryClass>

+    <LibraryClass Usage="ALWAYS_CONSUMED">

+      <Keyword>PcdLib</Keyword>

+    </LibraryClass>

+    <LibraryClass Usage="ALWAYS_CONSUMED">

+      <Keyword>BaseLib</Keyword>

+    </LibraryClass>

+  </LibraryClassDefinitions>

+  <SourceFiles>

+    <Filename>PostCode.c</Filename>

+  </SourceFiles>

+  <PackageDependencies>

+    <Package PackageGuid="5e0e9358-46b6-4ae2-8218-4ab8b9bbdcec"/>

+  </PackageDependencies>

+  <Externs>

+    <Specification>EFI_SPECIFICATION_VERSION 0x00020000</Specification>

+    <Specification>EDK_RELEASE_VERSION 0x00020000</Specification>

+  </Externs>

+  <PcdCoded>

+    <PcdEntry PcdItemType="FIXED_AT_BUILD">

+      <C_Name>PcdPostCodePropertyMask</C_Name>

+      <TokenSpaceGuidCName>gEfiMdePkgTokenSpaceGuid</TokenSpaceGuidCName>

+      <HelpText>The bitmask of flags that specify the enable/disable of Post
+                Code, Post Code Description.</HelpText>

+    </PcdEntry>

+  </PcdCoded>

+</ModuleSurfaceArea>
\ No newline at end of file
diff --git a/MdePkg/Library/PeiDxePostCodeLibReportStatusCode/PostCode.c b/MdePkg/Library/PeiDxePostCodeLibReportStatusCode/PostCode.c
new file mode 100644
index 0000000000..408ede45c7
--- /dev/null
+++ b/MdePkg/Library/PeiDxePostCodeLibReportStatusCode/PostCode.c
@@ -0,0 +1,150 @@
+/** @file

+  Report Status Code Library Post Code functions for DXE Phase.

+

+  Copyright (c) 2006, Intel Corporation<BR>

+  All rights reserved. This program and the accompanying materials                          

+  are licensed and made available under the terms and conditions of the BSD License         

+  which 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.             

+

+**/

+

+/**

+  Converts POST code value to status code value.

+

+  This macro converts the post code to status code value. Bits 0..4 of PostCode 

+  are mapped to bits 16..20 of status code value, and bits 5..7 of PostCode are mapped to bits 

+  24..26 of status code value.  

+

+  @param  PostCode  POST code value. 

+

+  @return The converted status code value.

+

+**/

+#define POST_CODE_TO_STATUS_CODE_VALUE(PostCode)  \

+  ((EFI_STATUS_CODE_VALUE) (((PostCode & 0x1f) << 16) | ((PostCode & 0x3) << 19)))

+

+/**

+  Sends an 32-bit value to a POST card.

+

+  Sends the 32-bit value specified by Value to a POST card, and returns Value.  

+  Some implementations of this library function may perform I/O operations 

+  directly to a POST card device.  Other implementations may send Value to 

+  ReportStatusCode(), and the status code reporting mechanism will eventually 

+  display the 32-bit value on the status reporting device.

+  

+  PostCode() must actively prevent recursion.  If PostCode() is called while 

+  processing another any other Report Status Code Library function, then 

+  PostCode() must return Value immediately.

+

+  @param  Value  The 32-bit value to write to the POST card.

+

+  @return  Value

+

+**/

+UINT32

+EFIAPI

+PostCode (

+  IN UINT32  Value

+  )

+{

+  REPORT_STATUS_CODE (EFI_PROGRESS_CODE, POST_CODE_TO_STATUS_CODE_VALUE (Value));

+  return Value;

+}

+

+

+/**

+  Sends an 32-bit value to a POST and associated ASCII string.

+

+  Sends the 32-bit value specified by Value to a POST card, and returns Value.

+  If Description is not NULL, then the ASCII string specified by Description is 

+  also passed to the handler that displays the POST card value.  Some 

+  implementations of this library function may perform I/O operations directly 

+  to a POST card device.  Other implementations may send Value to ReportStatusCode(), 

+  and the status code reporting mechanism will eventually display the 32-bit 

+  value on the status reporting device.  

+

+  PostCodeWithDescription()must actively prevent recursion.  If 

+  PostCodeWithDescription() is called while processing another any other Report 

+  Status Code Library function, then PostCodeWithDescription() must return Value 

+  immediately.

+

+  @param  Value        The 32-bit value to write to the POST card.

+  @param  Description  Pointer to an ASCII string that is a description of the 

+                       POST code value.  This is an optional parameter that may 

+                       be NULL.

+

+  @return  Value

+

+**/

+UINT32

+EFIAPI

+PostCodeWithDescription (

+  IN UINT32       Value,

+  IN CONST CHAR8  *Description  OPTIONAL

+  )

+{

+  if (Description == NULL) { 

+    REPORT_STATUS_CODE (

+      EFI_PROGRESS_CODE,

+      POST_CODE_TO_STATUS_CODE_VALUE (Value)

+      );

+  } else {

+    REPORT_STATUS_CODE_WITH_EXTENDED_DATA (

+      EFI_PROGRESS_CODE,

+      POST_CODE_TO_STATUS_CODE_VALUE (Value),

+      Description,

+      AsciiStrSize (Description)

+      );

+  }

+

+  return Value;

+}

+

+

+/**

+  Returns TRUE if POST Codes are enabled.

+

+  This function returns TRUE if the POST_CODE_PROPERTY_POST_CODE_ENABLED 

+  bit of PcdPostCodePropertyMask is set.  Otherwise FALSE is returned.

+

+  @retval  TRUE   The POST_CODE_PROPERTY_POST_CODE_ENABLED bit of 

+                  PcdPostCodeProperyMask is set.

+  @retval  FALSE  The POST_CODE_PROPERTY_POST_CODE_ENABLED bit of 

+                  PcdPostCodeProperyMask is clear.

+

+**/

+BOOLEAN

+EFIAPI

+PostCodeEnabled (

+  VOID

+  )

+{

+  return (BOOLEAN) ((PcdGet8(PcdPostCodePropertyMask) & POST_CODE_PROPERTY_POST_CODE_ENABLED) != 0);

+}

+

+

+/**

+  Returns TRUE if POST code descriptions are enabled.

+

+  This function returns TRUE if the 

+  POST_CODE_PROPERTY_POST_CODE_ENABLED bit of 

+  PcdPostCodePropertyMask is set.  Otherwise FALSE is returned.

+

+  @retval  TRUE   The POST_CODE_PROPERTY_POST_CODE_ENABLED 

+                  bit of PcdPostCodeProperyMask is set.

+  @retval  FALSE  The POST_CODE_PROPERTY_POST_CODE_ENABLED 

+                  bit of PcdPostCodeProperyMask is clear.

+

+**/

+BOOLEAN

+EFIAPI

+PostCodeDescriptionEnabled (

+  VOID

+  )

+{

+  return (BOOLEAN) ((PcdGet8(PcdPostCodePropertyMask) & POST_CODE_PROPERTY_POST_CODE_ENABLED) != 0);

+}