SmbiosDataUpdateDxeNeonCityEPRP - Analysis Report

Overview

Purpose

This UEFI driver updates SMBIOS data structures at runtime for the NeonCityEPRP server platform (Purley family). It uses the UBA (Universal Build Architecture) layer to customize SMBIOS Type 9 (System Slots) and Type 41 (Onboard Devices) with platform-specific string data stored in HII packages.

Architecture

Call Flow

_ModuleEntryPoint (0x370)

  +-- UefiDriverEntryPoint (0x38C)  -- Driver initialization
     |-- HII services protocol resolution
     |-- DxeServicesTable resolution
     |-- PCI MMCONFIG base protocol (mPciUsra)
     |-- HOB list initialization

  +-- SmbiosDataUpdateEntry (0x654) -- Main entry
-- Opens UBA private protocol
-- Registers HII string packages via HiiAddPackages()
-- Registers callback via UBA protocol

        +-- SmbiosDataUpdateCallback (0xF54)
-- [Loop x30] UpdateSmbiosType9SystemSlots (0x77C)
     Updates SMBIOS Type 9 (System Slots) slot names
-- Deletes all Type 9 keys from UBA
-- [Loop x8]  UpdateSmbiosType41OnboardDevices (0xA20)
     Updates SMBIOS Type 41 (Onboard Devices) device names
-- Deletes all Type 41 keys from UBA
-- [Loop x4]  UpdateSmbiosTypeUnknownExtended (0xD98)
     Updates an additional extended device type
-- FreePool cleanup

Segment Map

SMBIOS Type 9 - System Slots

The function UpdateSmbiosType9SystemSlots() handles up to 30 system slot entries (0x1E). Each slot entry has a 10-byte descriptor containing:

The slot string data is embedded in the code as an array of packed structures starting at offset 0x7A5.

Each slot can have a name string and/or a description string. These are retrieved via HiiGetString() from the HII database and written to the UBA SMBIOS data store via UbaSmbiosUpdateStringReplace().

After all slots are processed, UbaSmbiosDeleteAllKeysOfType(9) removes stale Type 9 entries.

SMBIOS Type 41 - Onboard Devices

The function UpdateSmbiosType41OnboardDevices() handles up to 8 onboard device entries. Similar pattern: for each device index, it reads configuration data, resolves string references via HII, and updates the UBA SMBIOS data store.

After processing, UbaSmbiosDeleteAllKeysOfType(41) removes stale Type 41 entries.

SMBIOS Extended Type

The function UpdateSmbiosTypeUnknownExtended() handles 4 entries of an additional type (likely a platform-specific OEM SMBIOS type). This function could not be decompiled (possibly due to optimization artifacts or inline assembly), but follows the same pattern of index-based iteration with HII string resolution and UBA data store updates.

Key Data Flow

1. HII String Packages: The driver registers HII string packages containing platform-specific SMBIOS strings (slot names, device descriptions).

2. UBA Protocol: Uses UBA private protocol (gSmbiosStringPackHandle) to manage SMBIOS string data through set/get/delete operations.

3. PCI Access: Uses mPciUsra (PCI MMCONFIG base protocol) for PCI register access via PciWriteMmPciUsra().

4. Variable Storage: Uses UEFI variable services through UbaSmbiosGetVariable() / UbaSmbiosSetVariableIfNotExist() for persistent key-value storage.

Renamed Functions (40 new names)

Important Strings

• UBA:SmbiosDataUpdateEntry Image GUID=%g - Debug log at entry
• gSmbiosStringPackHandle != ((void *) 0) - Assertion for pack handle
• \nASSERT_EFI_ERROR (Status = %r)\n - Debug assertion format
• Source path references: PurleyRpPkg/Uba/UbaMain/Dxe/TypeNeonCityEPRP/SmbiosDataUpdateDxe/

Dependencies

• MdePkg - Base UEFI types and libraries
• MdeModulePkg - UEFI HII services
• PurleyPlatPkg - UBA platform library
• CpRcPkg - PCI MMCONFIG base library

Notes

• The module is compiled with DEBUG_VS2015 configuration, meaning all ASSERT macros are active.
• The UBA protocol GUIDs and HII package data are embedded in the module's .data and seg004 sections.
• String replacement in UbaSmbiosUpdateStringReplace() is done in-place within the SMBIOS string block buffer.
• The driver uses a callback model: the UBA layer invokes SmbiosDataUpdateCallback() at the appropriate time for SMBIOS data customization.
• The platform name NeonCityEPRP suggests this is for Intel Purley server platforms with a specific board revision.