144 lines
5.0 KiB
C
144 lines
5.0 KiB
C
/** @file
|
|
Header file for the SiMtrrLib library.
|
|
|
|
@copyright
|
|
INTEL CONFIDENTIAL
|
|
Copyright 2018 - 2021 Intel Corporation.
|
|
|
|
The source code contained or described herein and all documents related to the
|
|
source code ("Material") are owned by Intel Corporation or its suppliers or
|
|
licensors. Title to the Material remains with Intel Corporation or its suppliers
|
|
and licensors. The Material may contain trade secrets and proprietary and
|
|
confidential information of Intel Corporation and its suppliers and licensors,
|
|
and is protected by worldwide copyright and trade secret laws and treaty
|
|
provisions. No part of the Material may be used, copied, reproduced, modified,
|
|
published, uploaded, posted, transmitted, distributed, or disclosed in any way
|
|
without Intel's prior express written permission.
|
|
|
|
No license under any patent, copyright, trade secret or other intellectual
|
|
property right is granted to or conferred upon you by disclosure or delivery
|
|
of the Materials, either expressly, by implication, inducement, estoppel or
|
|
otherwise. Any license under such intellectual property rights must be
|
|
express and approved by Intel in writing.
|
|
|
|
Unless otherwise agreed by Intel in writing, you may not remove or alter
|
|
this notice or any other notice embedded in Materials by Intel or
|
|
Intel's suppliers or licensors in any way.
|
|
|
|
This file contains an 'Intel Peripheral Driver' and is 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.
|
|
|
|
@par Specification Reference:
|
|
**/
|
|
#ifndef _SI_MTRR_LIBRARY_H_
|
|
#define _SI_MTRR_LIBRARY_H_
|
|
|
|
#include <Base.h>
|
|
#include <HostBridgeDataLib.h>
|
|
#include <Register/SaRegsHostBridge.h>
|
|
#include <Register/Msr.h>
|
|
#include <Register/Cpuid.h>
|
|
#include <Uefi/UefiBaseType.h>
|
|
#include <Library/DebugLib.h>
|
|
#include <Library/BaseLib.h>
|
|
#include <Library/BaseMemoryLib.h>
|
|
#include <Library/MtrrLib.h>
|
|
#include <Library/SiMtrrLib.h>
|
|
#include <Library/PciSegmentLib.h>
|
|
#include <IndustryStandard/Pci22.h>
|
|
#include <Register/IgdRegs.h>
|
|
#include <Library/GraphicsInfoLib.h>
|
|
|
|
//
|
|
// Structure to describe a updated variable MTRR
|
|
//
|
|
typedef struct {
|
|
UINT64 BaseAddress;
|
|
UINT64 Length;
|
|
MTRR_MEMORY_CACHE_TYPE OrgMtrrType;
|
|
MTRR_MEMORY_CACHE_TYPE ChgMtrrType;
|
|
BOOLEAN Valid;
|
|
} UPDATED_VARIABLE_MTRR;
|
|
|
|
//
|
|
// Memory cache types
|
|
//
|
|
typedef enum {
|
|
Flash = 0,
|
|
InternalGraphics = 1
|
|
} MTRR_UPDATED;
|
|
|
|
typedef union {
|
|
struct {
|
|
UINT32 Low;
|
|
UINT32 High;
|
|
} Data32;
|
|
UINT64 Data;
|
|
} UINT64_STRUCT;
|
|
|
|
//
|
|
// Below function's implemented are inside UefiCpuPkg\Library\MtrrLib\MtrrLib.c
|
|
// This is a backport from BP1510
|
|
//
|
|
/**
|
|
Initializes the valid bits mask and valid address mask for MTRRs.
|
|
|
|
This function initializes the valid bits mask and valid address mask for MTRRs.
|
|
|
|
@param[out] MtrrValidBitsMask The mask for the valid bit of the MTRR
|
|
@param[out] MtrrValidAddressMask The valid address mask for the MTRR
|
|
|
|
**/
|
|
VOID
|
|
MtrrLibInitializeMtrrMask (
|
|
OUT UINT64 *MtrrValidBitsMask,
|
|
OUT UINT64 *MtrrValidAddressMask
|
|
);
|
|
|
|
/**
|
|
Convert variable MTRRs to a RAW MTRR_MEMORY_RANGE array.
|
|
One MTRR_MEMORY_RANGE element is created for each MTRR setting.
|
|
The routine doesn't remove the overlap or combine the near-by region.
|
|
|
|
@param[in] VariableSettings The variable MTRR values to shadow
|
|
@param[in] VariableMtrrCount The number of variable MTRRs
|
|
@param[in] MtrrValidBitsMask The mask for the valid bit of the MTRR
|
|
@param[in] MtrrValidAddressMask The valid address mask for MTRR
|
|
@param[out] VariableMtrr The array to shadow variable MTRRs content
|
|
|
|
@return Number of MTRRs which has been used.
|
|
|
|
**/
|
|
UINT32
|
|
MtrrLibGetRawVariableRanges (
|
|
IN MTRR_VARIABLE_SETTINGS *VariableSettings,
|
|
IN UINTN VariableMtrrCount,
|
|
IN UINT64 MtrrValidBitsMask,
|
|
IN UINT64 MtrrValidAddressMask,
|
|
OUT MTRR_MEMORY_RANGE *VariableMtrr
|
|
);
|
|
|
|
/**
|
|
Apply the variable MTRR settings to memory range array.
|
|
|
|
@param[in] VariableMtrr The variable MTRR array.
|
|
@param[in] VariableMtrrCount The count of variable MTRRs.
|
|
@param[in, out] Ranges Return the memory range array with new MTRR settings applied.
|
|
@param[in] RangeCapacity The capacity of memory range array.
|
|
@param[in, out] RangeCount Return the count of memory range.
|
|
|
|
@retval RETURN_SUCCESS The memory range array is returned successfully.
|
|
@retval RETURN_OUT_OF_RESOURCES The count of memory ranges exceeds capacity.
|
|
**/
|
|
RETURN_STATUS
|
|
MtrrLibApplyVariableMtrrs (
|
|
IN CONST MTRR_MEMORY_RANGE *VariableMtrr,
|
|
IN UINT32 VariableMtrrCount,
|
|
IN OUT MTRR_MEMORY_RANGE *Ranges,
|
|
IN UINTN RangeCapacity,
|
|
IN OUT UINTN *RangeCount
|
|
);
|
|
#endif // _SI_MTRR_LIBRARY_H_
|