# KbcEmul

**Index:** 0209
**Size:** 14,532 bytes (38C4h)
**Phase:** SMM (DXE_SMM_DRIVER)
**Source Package:** AmiModulePkg\KbcEmulation\KbcEmul

## Overview
SMM-based Keyboard Controller (KBC) emulation driver. Emulates legacy PS/2 keyboard controller functionality (ports 0x60/0x64) from within SMM context on platforms that lack a physical KBC (e.g., Intel Purley server platforms). Traps IO accesses to the legacy KBC IO ports via SMI and provides emulated responses for keyboard, mouse, and AUX device commands. Includes a DXE counterpart (KbcEmulDxe) for boot-time initialization. Has a .reloc section for runtime relocation.

## Key Functions
- **ModuleEntryPoint** -- Main entry: calls `KbcEmulInitialize`, then `KbcEmulRegisterPortEmulation` for KBC emulation setup
- **KbcEmulInitialize** (recovered from `sub_4E8`) -- UEFI driver init; caches ImageHandle/SystemTable and runtime context
- **KbcEmulRegisterPortEmulation** (recovered from `sub_628`) -- Core KBC emulation: registers SMI I/O trap handlers for ports 0x60/0x64
- **KbcEmulContextNeedsSetup / KbcEmulCleanupContext / KbcEmulUnregisterPortTraps** (recovered from `sub_2C0` / `sub_1F94` / `sub_360`) -- KBC emulation context and notification teardown callbacks
- **KbcEmulAssert** (recovered from `sub_2074`) -- Debug ASSERT handler referencing AutoGen.c

## Symbol Recovery Notes
- **Context variable**: `qword_31E8` was recovered as `ModuleStatus`.
- **Context handle**: `unk_30F0` was recovered as `KbcEmulationContext`.

## Module Split
- SMM runtime module in this folder: `KbcEmul` (`KbcEmul.c` + `KbcEmul.h`).
- Boot-stage counterpart referenced by docs: `KbcEmulDxe` (outside this folder).

## Protocols
- EFI_SMM_SYSTEM_TABLE2 for SMM services
- EFI_SMM_CPU_IO2 protocol for IO trap registration
- EFI_SMM_BASE2_PROTOCOL
- Legacy 8042/Keyboard controller emulation interfaces

## Platform
HR650X (Purley), built from AmiModulePkg\KbcEmulation, DEBUG VS2015 X64