mirror of https://github.com/acidanthera/audk.git
PrmPkg: Add initial PrmSampleHardwareAccessModule
REF:https://bugzilla.tianocore.org/show_bug.cgi?id=3812 Adds a sample PRM module that demonstrates: 1. How to write a PRM module 2. How to use multiple PRM handlers in a module 3. How to use a basic PRM OS service 4. MSR access at OS runtime Note: This module contains a PRM handler to read from the HPET MMIO range but the memory map changes needed for this to succeed are currently not implemented. These will be implemented in a future change. Cc: Andrew Fish <afish@apple.com> Cc: Kang Gao <kang.gao@intel.com> Cc: Michael D Kinney <michael.d.kinney@intel.com> Cc: Michael Kubacki <michael.kubacki@microsoft.com> Cc: Leif Lindholm <leif@nuviainc.com> Cc: Benjamin You <benjamin.you@intel.com> Cc: Liu Yun <yun.y.liu@intel.com> Cc: Ankit Sinha <ankit.sinha@intel.com> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com> Signed-off-by: Michael Kubacki <michael.kubacki@microsoft.com> Acked-by: Michael D Kinney <michael.d.kinney@intel.com> Acked-by: Liming Gao <gaoliming@byosoft.com.cn> Acked-by: Leif Lindholm <quic_llindhol@quicinc.com> Reviewed-by: Ankit Sinha <ankit.sinha@intel.com>
This commit is contained in:
parent
c63905aba7
commit
27b1a840e4
|
@ -0,0 +1,105 @@
|
||||||
|
/** @file
|
||||||
|
HPET register definitions from the IA-PC HPET (High Precision Event Timers)
|
||||||
|
Specification, Revision 1.0a, October 2004.
|
||||||
|
|
||||||
|
PRM Module Note:
|
||||||
|
This specific header was copied from PcAtChipsetPkg to avoid a module dependency on the package
|
||||||
|
just for this header. This is done for temporary testing purposes of the PRM module.
|
||||||
|
|
||||||
|
Copyright (c) Microsoft Corporation
|
||||||
|
Copyright (c) 2011 - 2018, Intel Corporation. All rights reserved.<BR>
|
||||||
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
||||||
|
|
||||||
|
**/
|
||||||
|
|
||||||
|
#ifndef HPET_REGISTER_H_
|
||||||
|
#define HPET_REGISTER_H_
|
||||||
|
|
||||||
|
///
|
||||||
|
/// HPET General Register Offsets
|
||||||
|
///
|
||||||
|
#define HPET_GENERAL_CAPABILITIES_ID_OFFSET 0x000
|
||||||
|
#define HPET_GENERAL_CONFIGURATION_OFFSET 0x010
|
||||||
|
#define HPET_GENERAL_INTERRUPT_STATUS_OFFSET 0x020
|
||||||
|
|
||||||
|
///
|
||||||
|
/// HPET Timer Register Offsets
|
||||||
|
///
|
||||||
|
#define HPET_MAIN_COUNTER_OFFSET 0x0F0
|
||||||
|
#define HPET_TIMER_CONFIGURATION_OFFSET 0x100
|
||||||
|
#define HPET_TIMER_COMPARATOR_OFFSET 0x108
|
||||||
|
#define HPET_TIMER_MSI_ROUTE_OFFSET 0x110
|
||||||
|
|
||||||
|
///
|
||||||
|
/// Stride between sets of HPET Timer Registers
|
||||||
|
///
|
||||||
|
#define HPET_TIMER_STRIDE 0x20
|
||||||
|
|
||||||
|
#pragma pack(1)
|
||||||
|
|
||||||
|
///
|
||||||
|
/// HPET General Capabilities and ID Register
|
||||||
|
///
|
||||||
|
typedef union {
|
||||||
|
struct {
|
||||||
|
UINT32 Revision:8;
|
||||||
|
UINT32 NumberOfTimers:5;
|
||||||
|
UINT32 CounterSize:1;
|
||||||
|
UINT32 Reserved0:1;
|
||||||
|
UINT32 LegacyRoute:1;
|
||||||
|
UINT32 VendorId:16;
|
||||||
|
UINT32 CounterClockPeriod:32;
|
||||||
|
} Bits;
|
||||||
|
UINT64 Uint64;
|
||||||
|
} HPET_GENERAL_CAPABILITIES_ID_REGISTER;
|
||||||
|
|
||||||
|
///
|
||||||
|
/// HPET General Configuration Register
|
||||||
|
///
|
||||||
|
typedef union {
|
||||||
|
struct {
|
||||||
|
UINT32 MainCounterEnable:1;
|
||||||
|
UINT32 LegacyRouteEnable:1;
|
||||||
|
UINT32 Reserved0:30;
|
||||||
|
UINT32 Reserved1:32;
|
||||||
|
} Bits;
|
||||||
|
UINT64 Uint64;
|
||||||
|
} HPET_GENERAL_CONFIGURATION_REGISTER;
|
||||||
|
|
||||||
|
///
|
||||||
|
/// HPET Timer Configuration Register
|
||||||
|
///
|
||||||
|
typedef union {
|
||||||
|
struct {
|
||||||
|
UINT32 Reserved0:1;
|
||||||
|
UINT32 LevelTriggeredInterrupt:1;
|
||||||
|
UINT32 InterruptEnable:1;
|
||||||
|
UINT32 PeriodicInterruptEnable:1;
|
||||||
|
UINT32 PeriodicInterruptCapability:1;
|
||||||
|
UINT32 CounterSizeCapability:1;
|
||||||
|
UINT32 ValueSetEnable:1;
|
||||||
|
UINT32 Reserved1:1;
|
||||||
|
UINT32 CounterSizeEnable:1;
|
||||||
|
UINT32 InterruptRoute:5;
|
||||||
|
UINT32 MsiInterruptEnable:1;
|
||||||
|
UINT32 MsiInterruptCapability:1;
|
||||||
|
UINT32 Reserved2:16;
|
||||||
|
UINT32 InterruptRouteCapability;
|
||||||
|
} Bits;
|
||||||
|
UINT64 Uint64;
|
||||||
|
} HPET_TIMER_CONFIGURATION_REGISTER;
|
||||||
|
|
||||||
|
///
|
||||||
|
/// HPET Timer MSI Route Register
|
||||||
|
///
|
||||||
|
typedef union {
|
||||||
|
struct {
|
||||||
|
UINT32 Value:32;
|
||||||
|
UINT32 Address:32;
|
||||||
|
} Bits;
|
||||||
|
UINT64 Uint64;
|
||||||
|
} HPET_TIMER_MSI_ROUTE_REGISTER;
|
||||||
|
|
||||||
|
#pragma pack()
|
||||||
|
|
||||||
|
#endif
|
|
@ -0,0 +1,537 @@
|
||||||
|
/** @file
|
||||||
|
|
||||||
|
A sample PRM Module implementation. This PRM Module provides PRM handlers that perform various types
|
||||||
|
of hardware access. This is simply meant to demonstrate hardware access capabilities from a PRM handler.
|
||||||
|
|
||||||
|
Copyright (c) Microsoft Corporation
|
||||||
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
||||||
|
|
||||||
|
**/
|
||||||
|
|
||||||
|
#include <PrmModule.h>
|
||||||
|
|
||||||
|
#include <Library/BaseLib.h>
|
||||||
|
#include <Library/MtrrLib.h>
|
||||||
|
#include <Library/PrintLib.h>
|
||||||
|
#include <Library/UefiLib.h>
|
||||||
|
|
||||||
|
#include <Register/Intel/ArchitecturalMsr.h>
|
||||||
|
#include <Register/Intel/Cpuid.h>
|
||||||
|
|
||||||
|
#include "Hpet.h"
|
||||||
|
|
||||||
|
//
|
||||||
|
// PRM Handler GUIDs
|
||||||
|
//
|
||||||
|
|
||||||
|
// {2120cd3c-848b-4d8f-abbb-4b74ce64ac89}
|
||||||
|
#define MSR_ACCESS_MICROCODE_SIGNATURE_PRM_HANDLER_GUID {0x2120cd3c, 0x848b, 0x4d8f, {0xab, 0xbb, 0x4b, 0x74, 0xce, 0x64, 0xac, 0x89}}
|
||||||
|
|
||||||
|
// {ea0935a7-506b-4159-bbbb-48deeecb6f58}
|
||||||
|
#define MSR_ACCESS_MTRR_DUMP_PRM_HANDLER_GUID {0xea0935a7, 0x506b, 0x4159, {0xbb, 0xbb, 0x48, 0xde, 0xee, 0xcb, 0x6f, 0x58}}
|
||||||
|
|
||||||
|
// {1bd1bda9-909a-4614-9699-25ec0c2783f7}
|
||||||
|
#define MMIO_ACCESS_HPET_PRM_HANDLER_GUID {0x1bd1bda9, 0x909a, 0x4614, {0x96, 0x99, 0x25, 0xec, 0x0c, 0x27, 0x83, 0xf7}}
|
||||||
|
|
||||||
|
#define HPET_BASE_ADDRESS 0xFED00000
|
||||||
|
|
||||||
|
//
|
||||||
|
// BEGIN: MtrrLib internal library globals and function prototypes here for testing
|
||||||
|
//
|
||||||
|
extern CONST CHAR8 *mMtrrMemoryCacheTypeShortName[];
|
||||||
|
|
||||||
|
/**
|
||||||
|
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 fixed MTRR settings to memory range array.
|
||||||
|
|
||||||
|
@param Fixed The fixed MTRR settings.
|
||||||
|
@param Ranges Return the memory range array holding memory type
|
||||||
|
settings for all memory address.
|
||||||
|
@param RangeCapacity The capacity of memory range array.
|
||||||
|
@param 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
|
||||||
|
MtrrLibApplyFixedMtrrs (
|
||||||
|
IN MTRR_FIXED_SETTINGS *Fixed,
|
||||||
|
IN OUT MTRR_MEMORY_RANGE *Ranges,
|
||||||
|
IN UINTN RangeCapacity,
|
||||||
|
IN OUT UINTN *RangeCount
|
||||||
|
);
|
||||||
|
|
||||||
|
/**
|
||||||
|
Apply the variable MTRR settings to memory range array.
|
||||||
|
|
||||||
|
@param VariableMtrr The variable MTRR array.
|
||||||
|
@param VariableMtrrCount The count of variable MTRRs.
|
||||||
|
@param Ranges Return the memory range array with new MTRR settings applied.
|
||||||
|
@param RangeCapacity The capacity of memory range array.
|
||||||
|
@param 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
|
||||||
|
);
|
||||||
|
|
||||||
|
//
|
||||||
|
// END: MtrrLib internal library function prototypes here for testing
|
||||||
|
//
|
||||||
|
|
||||||
|
/**
|
||||||
|
Prints all MTRR values including architectural and variable MTTRs.
|
||||||
|
|
||||||
|
**/
|
||||||
|
VOID
|
||||||
|
EFIAPI
|
||||||
|
PrintAllMtrrs (
|
||||||
|
IN PRM_OS_SERVICE_DEBUG_PRINT OsServiceDebugPrint
|
||||||
|
)
|
||||||
|
{
|
||||||
|
MTRR_SETTINGS LocalMtrrs;
|
||||||
|
MTRR_SETTINGS *Mtrrs;
|
||||||
|
UINTN Index;
|
||||||
|
UINTN RangeCount;
|
||||||
|
UINT64 MtrrValidBitsMask;
|
||||||
|
UINT64 MtrrValidAddressMask;
|
||||||
|
UINT32 VariableMtrrCount;
|
||||||
|
BOOLEAN ContainVariableMtrr;
|
||||||
|
CHAR8 DebugMessage[256];
|
||||||
|
|
||||||
|
MTRR_MEMORY_RANGE Ranges[
|
||||||
|
MTRR_NUMBER_OF_FIXED_MTRR * sizeof (UINT64) + 2 * ARRAY_SIZE (Mtrrs->Variables.Mtrr) + 1
|
||||||
|
];
|
||||||
|
MTRR_MEMORY_RANGE RawVariableRanges[ARRAY_SIZE (Mtrrs->Variables.Mtrr)];
|
||||||
|
|
||||||
|
if (OsServiceDebugPrint == NULL || !IsMtrrSupported ()) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
VariableMtrrCount = GetVariableMtrrCount ();
|
||||||
|
|
||||||
|
MtrrGetAllMtrrs (&LocalMtrrs);
|
||||||
|
Mtrrs = &LocalMtrrs;
|
||||||
|
|
||||||
|
//
|
||||||
|
// Dump RAW MTRR contents
|
||||||
|
//
|
||||||
|
OsServiceDebugPrint (" MTRR Settings:\n");
|
||||||
|
OsServiceDebugPrint (" =============\n");
|
||||||
|
|
||||||
|
AsciiSPrint (
|
||||||
|
&DebugMessage[0],
|
||||||
|
ARRAY_SIZE (DebugMessage),
|
||||||
|
" MTRR Default Type: %016lx\n",
|
||||||
|
Mtrrs->MtrrDefType
|
||||||
|
);
|
||||||
|
OsServiceDebugPrint (&DebugMessage[0]);
|
||||||
|
|
||||||
|
for (Index = 0; Index < MTRR_NUMBER_OF_FIXED_MTRR; Index++) {
|
||||||
|
AsciiSPrint (
|
||||||
|
&DebugMessage[0],
|
||||||
|
ARRAY_SIZE (DebugMessage),
|
||||||
|
" Fixed MTRR[%02d] : %016lx\n",
|
||||||
|
Index,
|
||||||
|
Mtrrs->Fixed.Mtrr[Index]
|
||||||
|
);
|
||||||
|
OsServiceDebugPrint (&DebugMessage[0]);
|
||||||
|
}
|
||||||
|
ContainVariableMtrr = FALSE;
|
||||||
|
for (Index = 0; Index < VariableMtrrCount; Index++) {
|
||||||
|
if ((Mtrrs->Variables.Mtrr[Index].Mask & BIT11) == 0) {
|
||||||
|
//
|
||||||
|
// If mask is not valid, then do not display range
|
||||||
|
//
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
ContainVariableMtrr = TRUE;
|
||||||
|
AsciiSPrint (
|
||||||
|
&DebugMessage[0],
|
||||||
|
ARRAY_SIZE (DebugMessage),
|
||||||
|
" Variable MTRR[%02d]: Base=%016lx Mask=%016lx\n",
|
||||||
|
Index,
|
||||||
|
Mtrrs->Variables.Mtrr[Index].Base,
|
||||||
|
Mtrrs->Variables.Mtrr[Index].Mask
|
||||||
|
);
|
||||||
|
OsServiceDebugPrint (&DebugMessage[0]);
|
||||||
|
}
|
||||||
|
if (!ContainVariableMtrr) {
|
||||||
|
OsServiceDebugPrint (" Variable MTRR : None.\n");
|
||||||
|
}
|
||||||
|
OsServiceDebugPrint ("\n");
|
||||||
|
|
||||||
|
//
|
||||||
|
// Dump MTRR setting in ranges
|
||||||
|
//
|
||||||
|
OsServiceDebugPrint (" Memory Ranges:\n");
|
||||||
|
OsServiceDebugPrint (" ====================================\n");
|
||||||
|
MtrrLibInitializeMtrrMask (&MtrrValidBitsMask, &MtrrValidAddressMask);
|
||||||
|
Ranges[0].BaseAddress = 0;
|
||||||
|
Ranges[0].Length = MtrrValidBitsMask + 1;
|
||||||
|
Ranges[0].Type = MtrrGetDefaultMemoryType ();
|
||||||
|
RangeCount = 1;
|
||||||
|
|
||||||
|
MtrrLibGetRawVariableRanges (
|
||||||
|
&Mtrrs->Variables, VariableMtrrCount,
|
||||||
|
MtrrValidBitsMask, MtrrValidAddressMask, RawVariableRanges
|
||||||
|
);
|
||||||
|
MtrrLibApplyVariableMtrrs (
|
||||||
|
RawVariableRanges, VariableMtrrCount,
|
||||||
|
Ranges, ARRAY_SIZE (Ranges), &RangeCount
|
||||||
|
);
|
||||||
|
|
||||||
|
MtrrLibApplyFixedMtrrs (&Mtrrs->Fixed, Ranges, ARRAY_SIZE (Ranges), &RangeCount);
|
||||||
|
|
||||||
|
for (Index = 0; Index < RangeCount; Index++) {
|
||||||
|
AsciiSPrint (
|
||||||
|
&DebugMessage[0],
|
||||||
|
ARRAY_SIZE (DebugMessage),
|
||||||
|
" %a:%016lx-%016lx\n",
|
||||||
|
mMtrrMemoryCacheTypeShortName[Ranges[Index].Type],
|
||||||
|
Ranges[Index].BaseAddress, Ranges[Index].BaseAddress + Ranges[Index].Length - 1
|
||||||
|
);
|
||||||
|
OsServiceDebugPrint (&DebugMessage[0]);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
Reads a HPET MMIO register.
|
||||||
|
|
||||||
|
Reads the 64-bit HPET MMIO register specified by Address.
|
||||||
|
|
||||||
|
This function must guarantee that all MMIO read and write
|
||||||
|
operations are serialized.
|
||||||
|
|
||||||
|
If Address is not aligned on a 64-bit boundary, zero will be returned.
|
||||||
|
|
||||||
|
@param Offset Specifies the offset of the HPET register to read.
|
||||||
|
|
||||||
|
@return The value read.
|
||||||
|
|
||||||
|
**/
|
||||||
|
UINT64
|
||||||
|
EFIAPI
|
||||||
|
HpetRead (
|
||||||
|
IN UINTN Offset
|
||||||
|
)
|
||||||
|
{
|
||||||
|
UINTN Address;
|
||||||
|
UINT64 Value;
|
||||||
|
|
||||||
|
Address = HPET_BASE_ADDRESS + Offset;
|
||||||
|
|
||||||
|
if ((Address & 7) == 0) {
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
MemoryFence ();
|
||||||
|
Value = *(volatile UINT64*)Address;
|
||||||
|
MemoryFence ();
|
||||||
|
|
||||||
|
return Value;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
Prints HPET configuration information.
|
||||||
|
|
||||||
|
**/
|
||||||
|
VOID
|
||||||
|
EFIAPI
|
||||||
|
PrintHpetConfiguration (
|
||||||
|
IN PRM_OS_SERVICE_DEBUG_PRINT OsServiceDebugPrint
|
||||||
|
)
|
||||||
|
{
|
||||||
|
UINTN TimerIndex;
|
||||||
|
HPET_GENERAL_CAPABILITIES_ID_REGISTER HpetGeneralCapabilities;
|
||||||
|
HPET_GENERAL_CONFIGURATION_REGISTER HpetGeneralConfiguration;
|
||||||
|
CHAR8 DebugMessage[256];
|
||||||
|
|
||||||
|
if (OsServiceDebugPrint == NULL) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
HpetGeneralCapabilities.Uint64 = HpetRead (HPET_GENERAL_CAPABILITIES_ID_OFFSET);
|
||||||
|
HpetGeneralConfiguration.Uint64 = HpetRead (HPET_GENERAL_CONFIGURATION_OFFSET);
|
||||||
|
|
||||||
|
AsciiSPrint (
|
||||||
|
&DebugMessage[0],
|
||||||
|
ARRAY_SIZE (DebugMessage),
|
||||||
|
" HPET Base Address = 0x%08x\n",
|
||||||
|
HPET_BASE_ADDRESS
|
||||||
|
);
|
||||||
|
OsServiceDebugPrint (&DebugMessage[0]);
|
||||||
|
|
||||||
|
AsciiSPrint (
|
||||||
|
&DebugMessage[0],
|
||||||
|
ARRAY_SIZE (DebugMessage),
|
||||||
|
" HPET_GENERAL_CAPABILITIES_ID = 0x%016lx\n",
|
||||||
|
HpetGeneralCapabilities
|
||||||
|
);
|
||||||
|
OsServiceDebugPrint (&DebugMessage[0]);
|
||||||
|
|
||||||
|
AsciiSPrint (
|
||||||
|
&DebugMessage[0],
|
||||||
|
ARRAY_SIZE (DebugMessage),
|
||||||
|
" HPET_GENERAL_CONFIGURATION = 0x%016lx\n",
|
||||||
|
HpetGeneralConfiguration.Uint64
|
||||||
|
);
|
||||||
|
OsServiceDebugPrint (&DebugMessage[0]);
|
||||||
|
|
||||||
|
AsciiSPrint (
|
||||||
|
&DebugMessage[0],
|
||||||
|
ARRAY_SIZE (DebugMessage),
|
||||||
|
" HPET_GENERAL_INTERRUPT_STATUS = 0x%016lx\n",
|
||||||
|
HpetRead (HPET_GENERAL_INTERRUPT_STATUS_OFFSET)
|
||||||
|
);
|
||||||
|
OsServiceDebugPrint (&DebugMessage[0]);
|
||||||
|
|
||||||
|
AsciiSPrint (
|
||||||
|
&DebugMessage[0],
|
||||||
|
ARRAY_SIZE (DebugMessage),
|
||||||
|
" HPET_MAIN_COUNTER = 0x%016lx\n",
|
||||||
|
HpetRead (HPET_MAIN_COUNTER_OFFSET)
|
||||||
|
);
|
||||||
|
OsServiceDebugPrint (&DebugMessage[0]);
|
||||||
|
|
||||||
|
AsciiSPrint (
|
||||||
|
&DebugMessage[0],
|
||||||
|
ARRAY_SIZE (DebugMessage),
|
||||||
|
" HPET Main Counter Period = %d (fs)\n",
|
||||||
|
HpetGeneralCapabilities.Bits.CounterClockPeriod
|
||||||
|
);
|
||||||
|
OsServiceDebugPrint (&DebugMessage[0]);
|
||||||
|
|
||||||
|
for (TimerIndex = 0; TimerIndex <= HpetGeneralCapabilities.Bits.NumberOfTimers; TimerIndex++) {
|
||||||
|
AsciiSPrint (
|
||||||
|
&DebugMessage[0],
|
||||||
|
ARRAY_SIZE (DebugMessage),
|
||||||
|
" HPET_TIMER%d_CONFIGURATION = 0x%016lx\n",
|
||||||
|
TimerIndex,
|
||||||
|
HpetRead (HPET_TIMER_CONFIGURATION_OFFSET + TimerIndex * HPET_TIMER_STRIDE)
|
||||||
|
);
|
||||||
|
OsServiceDebugPrint (&DebugMessage[0]);
|
||||||
|
|
||||||
|
AsciiSPrint (
|
||||||
|
&DebugMessage[0],
|
||||||
|
ARRAY_SIZE (DebugMessage),
|
||||||
|
" HPET_TIMER%d_COMPARATOR = 0x%016lx\n",
|
||||||
|
TimerIndex,
|
||||||
|
HpetRead (HPET_TIMER_COMPARATOR_OFFSET + TimerIndex * HPET_TIMER_STRIDE)
|
||||||
|
);
|
||||||
|
OsServiceDebugPrint (&DebugMessage[0]);
|
||||||
|
|
||||||
|
AsciiSPrint (
|
||||||
|
&DebugMessage[0],
|
||||||
|
ARRAY_SIZE (DebugMessage),
|
||||||
|
" HPET_TIMER%d_MSI_ROUTE = 0x%016lx\n",
|
||||||
|
TimerIndex,
|
||||||
|
HpetRead (HPET_TIMER_MSI_ROUTE_OFFSET + TimerIndex * HPET_TIMER_STRIDE)
|
||||||
|
);
|
||||||
|
OsServiceDebugPrint (&DebugMessage[0]);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
Prints the microcode update signature as read from architectural MSR 0x8B.
|
||||||
|
|
||||||
|
**/
|
||||||
|
VOID
|
||||||
|
EFIAPI
|
||||||
|
PrintMicrocodeUpdateSignature (
|
||||||
|
IN PRM_OS_SERVICE_DEBUG_PRINT OsServiceDebugPrint
|
||||||
|
)
|
||||||
|
{
|
||||||
|
MSR_IA32_BIOS_SIGN_ID_REGISTER BiosSignIdMsr;
|
||||||
|
CHAR8 DebugMessage[256];
|
||||||
|
|
||||||
|
if (OsServiceDebugPrint == NULL) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
AsmWriteMsr64 (MSR_IA32_BIOS_SIGN_ID, 0);
|
||||||
|
AsmCpuid (CPUID_VERSION_INFO, NULL, NULL, NULL, NULL);
|
||||||
|
BiosSignIdMsr.Uint64 = AsmReadMsr64 (MSR_IA32_BIOS_SIGN_ID);
|
||||||
|
|
||||||
|
AsciiSPrint (
|
||||||
|
&DebugMessage[0],
|
||||||
|
ARRAY_SIZE (DebugMessage),
|
||||||
|
" Signature read = 0x%x.\n",
|
||||||
|
BiosSignIdMsr.Bits.MicrocodeUpdateSignature
|
||||||
|
);
|
||||||
|
OsServiceDebugPrint (&DebugMessage[0]);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
A sample Platform Runtime Mechanism (PRM) handler.
|
||||||
|
|
||||||
|
This sample handler attempts to read the microcode update signature MSR and print the result to a debug message.
|
||||||
|
|
||||||
|
@param[in] ParameterBuffer A pointer to the PRM handler parameter buffer
|
||||||
|
@param[in] ContextBUffer A pointer to the PRM handler context buffer
|
||||||
|
|
||||||
|
@retval EFI_STATUS The PRM handler executed successfully.
|
||||||
|
@retval Others An error occurred in the PRM handler.
|
||||||
|
|
||||||
|
**/
|
||||||
|
PRM_HANDLER_EXPORT (MsrAccessMicrocodeSignaturePrmHandler)
|
||||||
|
{
|
||||||
|
PRM_OS_SERVICE_DEBUG_PRINT OsServiceDebugPrint;
|
||||||
|
|
||||||
|
if (ParameterBuffer == NULL) {
|
||||||
|
return EFI_INVALID_PARAMETER;
|
||||||
|
}
|
||||||
|
|
||||||
|
// In the POC, the OS debug print service is assumed to be at the beginning of ParameterBuffer
|
||||||
|
OsServiceDebugPrint = *((PRM_OS_SERVICE_DEBUG_PRINT *) ParameterBuffer);
|
||||||
|
if (OsServiceDebugPrint == NULL) {
|
||||||
|
return EFI_INVALID_PARAMETER;
|
||||||
|
}
|
||||||
|
|
||||||
|
OsServiceDebugPrint ("Hardware Access MsrAccessMicrocodeSignaturePrmHandler entry.\n");
|
||||||
|
OsServiceDebugPrint (" Attempting to read the Microcode Update Signature MSR (0x8B)...\n");
|
||||||
|
PrintMicrocodeUpdateSignature (OsServiceDebugPrint);
|
||||||
|
OsServiceDebugPrint ("Hardware Access MsrAccessMicrocodeSignaturePrmHandler exit.\n");
|
||||||
|
|
||||||
|
return EFI_SUCCESS;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
A sample Platform Runtime Mechanism (PRM) handler.
|
||||||
|
|
||||||
|
This sample handler attempts to read the current MTRR settings and print the result to a debug message.
|
||||||
|
|
||||||
|
@param[in] ParameterBuffer A pointer to the PRM handler parameter buffer
|
||||||
|
@param[in] ContextBUffer A pointer to the PRM handler context buffer
|
||||||
|
|
||||||
|
@retval EFI_STATUS The PRM handler executed successfully.
|
||||||
|
@retval Others An error occurred in the PRM handler.
|
||||||
|
|
||||||
|
**/
|
||||||
|
PRM_HANDLER_EXPORT (MsrAccessMtrrDumpPrmHandler)
|
||||||
|
{
|
||||||
|
PRM_OS_SERVICE_DEBUG_PRINT OsServiceDebugPrint;
|
||||||
|
|
||||||
|
if (ParameterBuffer == NULL) {
|
||||||
|
return EFI_INVALID_PARAMETER;
|
||||||
|
}
|
||||||
|
|
||||||
|
// In the POC, the OS debug print service is assumed to be at the beginning of ParameterBuffer
|
||||||
|
OsServiceDebugPrint = *((PRM_OS_SERVICE_DEBUG_PRINT *) ParameterBuffer);
|
||||||
|
if (OsServiceDebugPrint == NULL) {
|
||||||
|
return EFI_INVALID_PARAMETER;
|
||||||
|
}
|
||||||
|
|
||||||
|
OsServiceDebugPrint ("Hardware Access MsrAccessMtrrDumpPrmHandler entry.\n");
|
||||||
|
OsServiceDebugPrint (" Attempting to dump MTRR values:\n");
|
||||||
|
PrintAllMtrrs (OsServiceDebugPrint);
|
||||||
|
OsServiceDebugPrint ("Hardware Access MsrAccessMtrrDumpPrmHandler exit.\n");
|
||||||
|
|
||||||
|
return EFI_SUCCESS;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
A sample Platform Runtime Mechanism (PRM) handler.
|
||||||
|
|
||||||
|
This sample handler attempts to read from a HPET MMIO resource and print the result to a debug message.
|
||||||
|
|
||||||
|
@param[in] ParameterBuffer A pointer to the PRM handler parameter buffer
|
||||||
|
@param[in] ContextBUffer A pointer to the PRM handler context buffer
|
||||||
|
|
||||||
|
@retval EFI_STATUS The PRM handler executed successfully.
|
||||||
|
@retval Others An error occurred in the PRM handler.
|
||||||
|
|
||||||
|
**/
|
||||||
|
PRM_HANDLER_EXPORT (MmioAccessHpetPrmHandler)
|
||||||
|
{
|
||||||
|
PRM_OS_SERVICE_DEBUG_PRINT OsServiceDebugPrint;
|
||||||
|
|
||||||
|
if (ParameterBuffer == NULL) {
|
||||||
|
return EFI_INVALID_PARAMETER;
|
||||||
|
}
|
||||||
|
|
||||||
|
// In the POC, the OS debug print service is assumed to be at the beginning of ParameterBuffer
|
||||||
|
OsServiceDebugPrint = *((PRM_OS_SERVICE_DEBUG_PRINT *) ParameterBuffer);
|
||||||
|
if (OsServiceDebugPrint == NULL) {
|
||||||
|
return EFI_INVALID_PARAMETER;
|
||||||
|
}
|
||||||
|
|
||||||
|
OsServiceDebugPrint ("Hardware Access MmioAccessHpetPrmHandler entry.\n");
|
||||||
|
OsServiceDebugPrint (" Attempting to read HPET configuration...\n");
|
||||||
|
PrintHpetConfiguration (OsServiceDebugPrint);
|
||||||
|
OsServiceDebugPrint ("Hardware Access MmioAccessHpetPrmHandler exit.\n");
|
||||||
|
|
||||||
|
return EFI_SUCCESS;
|
||||||
|
}
|
||||||
|
|
||||||
|
//
|
||||||
|
// Register the PRM export information for this PRM Module
|
||||||
|
//
|
||||||
|
PRM_MODULE_EXPORT (
|
||||||
|
PRM_HANDLER_EXPORT_ENTRY (MSR_ACCESS_MICROCODE_SIGNATURE_PRM_HANDLER_GUID, MsrAccessMicrocodeSignaturePrmHandler),
|
||||||
|
PRM_HANDLER_EXPORT_ENTRY (MSR_ACCESS_MTRR_DUMP_PRM_HANDLER_GUID, MsrAccessMtrrDumpPrmHandler),
|
||||||
|
PRM_HANDLER_EXPORT_ENTRY (MMIO_ACCESS_HPET_PRM_HANDLER_GUID, MmioAccessHpetPrmHandler)
|
||||||
|
);
|
||||||
|
|
||||||
|
/**
|
||||||
|
Module entry point.
|
||||||
|
|
||||||
|
@param[in] ImageHandle The image handle.
|
||||||
|
@param[in] SystemTable A pointer to the system table.
|
||||||
|
|
||||||
|
@retval EFI_SUCCESS This function always returns success.
|
||||||
|
|
||||||
|
**/
|
||||||
|
EFI_STATUS
|
||||||
|
EFIAPI
|
||||||
|
PrmSampleHardwareAccessModuleInit (
|
||||||
|
IN EFI_HANDLE ImageHandle,
|
||||||
|
IN EFI_SYSTEM_TABLE *SystemTable
|
||||||
|
)
|
||||||
|
{
|
||||||
|
return EFI_SUCCESS;
|
||||||
|
}
|
|
@ -0,0 +1,42 @@
|
||||||
|
## @file
|
||||||
|
# Sample PRM Driver
|
||||||
|
#
|
||||||
|
# A sample PRM Module implementation. This PRM Module provides PRM handlers that perform various types
|
||||||
|
# of hardware access. This is simply meant to demonstrate hardware access capabilities from a PRM handler.
|
||||||
|
#
|
||||||
|
# Copyright (c) Microsoft Corporation
|
||||||
|
#
|
||||||
|
# SPDX-License-Identifier: BSD-2-Clause-Patent
|
||||||
|
#
|
||||||
|
##
|
||||||
|
|
||||||
|
[Defines]
|
||||||
|
INF_VERSION = 0x00010005
|
||||||
|
BASE_NAME = PrmSampleHardwareAccessModule
|
||||||
|
FILE_GUID = 0EF93ED7-14AE-425B-928F-B85A6213B57E
|
||||||
|
MODULE_TYPE = DXE_RUNTIME_DRIVER
|
||||||
|
VERSION_STRING = 1.0
|
||||||
|
ENTRY_POINT = PrmSampleHardwareAccessModuleInit
|
||||||
|
|
||||||
|
[Sources]
|
||||||
|
Hpet.h
|
||||||
|
PrmSampleHardwareAccessModule.c
|
||||||
|
|
||||||
|
[Packages]
|
||||||
|
MdePkg/MdePkg.dec
|
||||||
|
MdeModulePkg/MdeModulePkg.dec
|
||||||
|
UefiCpuPkg/UefiCpuPkg.dec
|
||||||
|
PrmPkg/PrmPkg.dec
|
||||||
|
|
||||||
|
[LibraryClasses]
|
||||||
|
BaseLib
|
||||||
|
MtrrLib
|
||||||
|
PrintLib
|
||||||
|
UefiDriverEntryPoint
|
||||||
|
UefiLib
|
||||||
|
|
||||||
|
[Depex]
|
||||||
|
TRUE
|
||||||
|
|
||||||
|
[BuildOptions.common]
|
||||||
|
MSFT:*_*_*_DLINK_FLAGS = /DLL /SUBSYSTEM:CONSOLE /VERSION:1.0
|
Loading…
Reference in New Issue