9344f09215
https://bugzilla.tianocore.org/show_bug.cgi?id=1373 Replace BSD 2-Clause License with BSD+Patent License. This change is based on the following emails: https://lists.01.org/pipermail/edk2-devel/2019-February/036260.html https://lists.01.org/pipermail/edk2-devel/2018-October/030385.html RFCs with detailed process for the license change: V3: https://lists.01.org/pipermail/edk2-devel/2019-March/038116.html V2: https://lists.01.org/pipermail/edk2-devel/2019-March/037669.html V1: https://lists.01.org/pipermail/edk2-devel/2019-March/037500.html Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com> Reviewed-by: Liming Gao <liming.gao@intel.com>
140 lines
4.0 KiB
C
140 lines
4.0 KiB
C
/** @file
|
|
Post Code Library instance that writes post code values to I/O port 0x80.
|
|
|
|
Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
|
|
#include <Base.h>
|
|
|
|
#include <Library/PostCodeLib.h>
|
|
#include <Library/PcdLib.h>
|
|
#include <Library/IoLib.h>
|
|
#include <Library/DebugLib.h>
|
|
|
|
/**
|
|
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 Post Code Library function, then
|
|
PostCode() must return Value immediately.
|
|
|
|
@param Value The 32-bit value to write to the POST card.
|
|
|
|
@return The 32-bit value to write to the POST card.
|
|
|
|
**/
|
|
UINT32
|
|
EFIAPI
|
|
PostCode (
|
|
IN UINT32 Value
|
|
)
|
|
{
|
|
switch (PcdGet8 (PcdPort80DataWidth)) {
|
|
case 8:
|
|
IoWrite8 (0x80, (UINT8)(Value));
|
|
break;
|
|
case 16:
|
|
IoWrite16 (0x80, (UINT16)(Value));
|
|
break;
|
|
case 32:
|
|
IoWrite32 (0x80, Value);
|
|
break;
|
|
default:
|
|
//
|
|
// Assert on the invalid data width
|
|
//
|
|
ASSERT (FALSE);
|
|
break;
|
|
}
|
|
|
|
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 Post
|
|
Code Library function, then PostCodeWithDescription() must return Value
|
|
immediately.
|
|
|
|
@param Value The 32-bit value to write to the POST card.
|
|
@param Description The pointer to an ASCII string that is a description of the
|
|
POST code value. This is an optional parameter that may
|
|
be NULL.
|
|
|
|
@return The 32-bit value to write to the POST card.
|
|
|
|
**/
|
|
UINT32
|
|
EFIAPI
|
|
PostCodeWithDescription (
|
|
IN UINT32 Value,
|
|
IN CONST CHAR8 *Description OPTIONAL
|
|
)
|
|
{
|
|
PostCode (Value);
|
|
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_DESCRIPTION_ENABLED
|
|
bit of PcdPostCodePropertyMask is set. Otherwise FALSE is returned.
|
|
|
|
@retval TRUE The POST_CODE_PROPERTY_POST_CODE_DESCRIPTION_ENABLED bit of
|
|
PcdPostCodeProperyMask is set.
|
|
@retval FALSE The POST_CODE_PROPERTY_POST_CODE_DESCRIPTION_ENABLED bit of
|
|
PcdPostCodeProperyMask is clear.
|
|
|
|
**/
|
|
BOOLEAN
|
|
EFIAPI
|
|
PostCodeDescriptionEnabled (
|
|
VOID
|
|
)
|
|
{
|
|
return (BOOLEAN) ((PcdGet8(PcdPostCodePropertyMask) & POST_CODE_PROPERTY_POST_CODE_DESCRIPTION_ENABLED) != 0);
|
|
}
|