4A43824B-4AA0-4F7F-9A4B-0C2102191361

Overview

Realtek USB UNDI (Universal Network Driver Interface) driver for USB-attached network controllers. This PEI/DXE module implements a full USB network driver stack including device binding, hardware initialization (USB control transfers, PHY setup, interrupt management), and MAC address retrieval from ACPI tables. It supports Realtek USB NIC detection, stall-based timing, spinlock synchronization, and debug assertion facilities.

Key Functions

• ModuleEntryPoint -- Saves global system table pointers; calls RtkUsbUndiDriverEntryPoint
• RtkUsbUndiDriverEntryPoint -- Main USB UNDI driver entry; validates image handle and system table
• RtkUsbUndiDriverBindingSupported -- Tests if a given controller is a supported Realtek USB NIC
• RtkUsbUndiDriverBindingStart -- Binds and initializes the USB NIC; allocates private context, sets up spinlock, initializes hardware and PHY, configures interrupts
• RtkUsbUndiDriverBindingStop -- Stops and unbinds the USB NIC; releases resources
• RtkUsbUndiUnload -- Driver unload thunk; calls StopChildren
• RtkUsbUndiInitHardware -- Hardware initialization via USB control transfers (get descriptor, set config, reset PHY)
• RtkUsbUndiInitPhy -- PHY initialization sequence
• RtkUsbUndiInterruptCallback -- Interrupt service routine for USB NIC events
• RtkUsbUndiGetMacFromAcpi -- Retrieves MAC address from ACPI tables
• RtkUsbUndiControlTransferUsb2 -- USB 2.0 control transfer wrapper
• RtkUsbUndiStallHelper -- Microsecond stall wrapper for timing
• RtkUsbUndiAssert / RtkUsbUndiDebugPrint -- Debug and assertion infrastructure
• RtkUsbUndiZeroMem -- Memory zeroing utility

Dependencies

UEFI Boot Services, UEFI Runtime Services, USB Host Controller Protocol, UNDI Protocol, ACPI Tables

Platform

Lenovo HR650X (Purley/LBG-PCH), X64