mirror of https://github.com/acidanthera/audk.git
Import PeiDxePostCodeLibReportStatusCode.
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@2891 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
parent
8aaff939b7
commit
cdffda11f4
|
@ -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>
|
|
@ -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);
|
||||
}
|
Loading…
Reference in New Issue