MrcOemHooksPeim - Module Analysis

Overview

Module: MrcOemHooksPeim.efi (index 0372)
Hash: ec5c461bc56ce7ac930e64fcb6aea6e956b9a6985d0434fae2ef7c066cfc4f64
Source Path: HR650X_3647_AJAX_BIOS_ORIGINAL.pe_structured/pe_files/0372_MrcOemHooksPeim_ec5c461bc56c
Architecture: IA32 (32-bit)
Base Address: 0xffdb79f4
Image Size: 0x182e0 (99,040 bytes)

Binary Statistics

• Total Functions: 201
• Named Functions (after rename): 103
• Library Functions: 0
• Unnamed Functions: 98
• Total Strings: 491
• Total Segments: 6

Source Files

This module is compiled from the following source paths:

1. PurleyPlatPkg\Platform\Pei\MrcOemHooksPeim\MrcOemHooksPeim.c
2. PurleyPlatPkg\Library\OemProcMemInitLib\OemProcMemInit.c
3. PurleyPlatPkg\Library\OemProcMemInitLib\EdkProcMemInit.c
4. PurleyPlatPkg\Library\OemIioInit\OemIioInitPei.c

Module Capabilities

1. OEM Memory Initialization (MRC)

The core function OemProcessMrcResult() handles MRC initialization results:

• OemInitSysHostMem() allocates system host memory via AllocSysHostMemory()
• ConfigSysHostMem() configures system host memory controller registers
• OemConfigDdrMem() performs DDR memory training and configuration
• OemInstallEfiMemory() installs EFI memory map after MRC

2. IIO/UPI Port Bifurcation

Configuration of IIO (Integrated I/O) ports via:

• OemGetIioPortBifurcation() - queries and applies bifurcation settings
• SetIioPortBifurcation() - writes the actual register values
• GetIioPortBifurcationCfg() - looks up configuration per socket/channel
• SetIioPortBifurcationInit() - initializes the DQ/DQS pin mapping
• InitMemConfigData() - sets up all memory config data structures

3. PCIe Topology

• ConfigPcieTopology() - enumerates and configures PCIe topology
• GetPciExpressBar() - obtains PCIe configuration base address
• PciReadConfig32() / PciWriteConfig32() - PCI config space access

4. OEM Hook System

The module provides a callback/hook dispatch framework:

• RegisterOemCallbacks() - registers platform-specific callbacks
• OemHookDispatch2Arg() / OemHookDispatch3Arg() / OemHookDispatch4Arg() / OemHookDispatch7Arg() - dispatchers
• DispatchMemInitHooks() - dispatches memory init hooks
• CollectOemCallbacks() - collects all callbacks from tables

5. Soft SKU Licensing

• OemGetIioSoftSkuInfo() - reads SocketLicense0/SocketCapability0/ForceProvisioning NVRAM variables
• Applies capability/license data to sockets based on provisioning
• Handles force provisioning override

6. TPM Save State

• OemTpmSaveState() - runs TPM1.2 or TPM2.0 save state on reset/suspend
• Tpm2SaveStateRun() / Tpm12SaveStateRun() - actual TPM commands

7. ME (Management Engine) Communication

• MeSendHostResetWarning() - notifies ME before system reset
• Uses PeiServicesInstallPpi() for PPI installation

8. NVRAM Save/Restore

• OemSaveMemNvram() - saves memory training data via decompression
• OemLoadSetupData() - loads setup configuration (IntelSetup variable)
• ApplySetupDataToConfig() - applies setup data to memory config

9. Board Detection

• CheckBoardVsCpuConflict() - detects board vs CPU incompatible configuration
• GetPchStepping() - reads PCH stepping
• GetIioCpuPackageType() - identifies CPU package type

10. Debug & Assert Framework

• DebugPrint() / DbgPrintMemInit() - platform debug output with severity levels
• IsDebugEnabled() / IsDebugLevelEnabled() - debug enablement checks
• AssertEfiError() - EFI_STATUS check macro

Key Data Tables

Named Functions Summary

Total named: 103 | Total unnamed remaining: 98 (mostly leaf helpers, small utilities)

Entry and Init

• MrcOemHooksPeimEntryPoint - module entry point, main init dispatch
• MrcOemHooksPeimMainInit - calls PeiServices->InstallPpi, boots MRC

Memory Initialization (19 functions)

OemInitSysHostMem, ConfigSysHostMem, ConfigPcieTopology, OemConfigDdrMem,
OemProcessMrcResult, OemInstallEfiMemory, OemSaveMemNvram, OemLoadSetupData,
OemFinalizeMemInit, OemIssueReset, OemGetIioProcMemInit, InstallEfiMemMap,
CheckNvramSanity, CheckNvramCrcSanity, InitMemDefaults, InitMemConfigData,
InitMemCtrlConfig, CalcDimmIndex, ReadDimmSpdData

IIO/PCI (12 functions)

OemGetIioPortBifurcation, SetIioPortBifurcation, SetIioPortBifurcationInit,
GetIioPortBifurcationCfg, GetIioCpuPackageType, ConfigPcieTopology,
GetPciExpressBar, GetPciCfgBaseAddr, PciReadConfig32, PciWriteConfig32,
AllocSysHostMemory, IsIioInitRequired

Callback System (10 functions)

RegisterOemCallbacks, CollectOemCallbacks, OemHookDispatch2Arg,
OemHookDispatch3Arg, OemHookDispatch3Arg_1, OemHookDispatch4Arg,
OemHookDispatch7Arg, OemHookDispatch7ArgB, DispatchMemInitHooks,
DispatchMemInitHooksCore

Debug/Assert/Output (7 functions)

DebugPrint, IsDebugEnabled, IsDebugLevelEnabled, DbgPrintMemInit,
DbgPrintFormatted, DebugPrintBoardConflict, SetErrorStatus

TPM (4 functions)

OemTpmSaveState, Tpm12SaveStateInit, Tpm12SaveStateRun, Tpm2SaveStateRun

ME Management (1 function)

MeSendHostResetWarning

Soft SKU (6 functions)

OemGetIioSoftSkuInfo, GetFullSpeedEparamEntry, SetDefaultTimeout,
ParseNvramVarData, ValidateVarData, GetPchStepping

Utility (15 functions)

GetDebugInstance, AssertEfiError, GetBootMode, RegisterPeiNotifyCallback,
GetGuidHobData, SetupMrcHobs, PublishGuidHob, PublishOpaSocketMapHob,
GetPeiServicesPtr, SetStructPairs, Memset32Wrapper, NullCallback,
PeiInstallPpi, CalculateCrc16, GetFvFileInfo