# AhciSmm

## Index
0188

## Size
33E4h (13,284 bytes)

## Phase
DXE SMM (System Management Mode driver)

## Source Package
AmiModulePkg/AHCI/AhciSmm

## Overview
AhciSmm is an SMM driver that manages AHCI (Advanced Host Controller Interface) SATA controllers within System Management Mode. It provides SMI handling for SATA controller events including port errors, hot-plug events, and device interrupts. This driver is essential for proper error recovery and management of SATA storage devices during platform runtime management scenarios.

## Key Functions
- **_ModuleEntryPoint** (0x470): Canonical entry point; initializes AHCI SMM context and dispatches SMI registration.
- **AhciSmmPreInit** (`sub_49C`): Pre-initialization routine that reads AHCI base address registers.
- **AhciSmmRegisterSmiHandlers** (`sub_5DC`): Main SMM entry; registers the SMI handler for SATA/AHCI controller interrupts.
- **AhciPortStartStop** (`sub_E30`): Port-level start/stop control used by command and reset execution.
- **AhciPmpRegisterAccess** (`sub_1274`): Internal AHCI command execution path for PMP register read/write.
- **AhciPollForCommandCompletion** (`sub_7D0`): Port command completion and error-status polling helper.

### Recovered Naming Notes
- `_ModuleEntryPoint` is the canonical entry point name from decompilation notes.
- `ModuleEntryPoint` is kept as a compatibility wrapper name used by existing module wrappers.

### Module/File Split Notes
- `AhciSmm.c` carries the recovered runtime symbols and entrypoint flow stubs for this module snapshot.
- `AhciSmm.h` carries canonical symbol declarations: globals, handler signatures, and compatibility `sub_*` aliases.

## Recovered Variable Naming
- `gImageHandle` (0x2E80)
- `gST` (0x2E70)
- `gBS` (0x2E78)
- `gRT` (0x2E88)
- `gSmst` (0x2E90)
- `mPcd` (0x2EA0)
- `gSmmCpuIo2Protocol` (0x2EB0)
- `mSmmMode` (0x2EB8)
- `gSmmServicesTableBase2` (0x2EE8)
- `gSmmChildProtocol` (0x2EC0)
- `gDxeProtocol` (0x2ED8)
- `gSmiHandlerProtocol` (0x2ED0)
- `gDxeSmiHandlerProtocol` (0x2EF0)
- `gSmmProtocolReady` (0x2EC8)
- `gBuf` (0x2E68)
- `gAhciSavedPxClb` (0x3010)
- `gAhciSavedPxFb` (0x3018)
- `gAhciReturnStatus` (0x3008)
- `gPortCompletionInProgress` (0x2E60)
- `gSoftResetInProgress` (0x2E61)
- `gSmiCallbackHandle` (0x3020)
- `gAhciCommandList` (0x3038)
- `gAhciReceiveArea` (0x3030)
- `gAhciCommandTable` (0x3028)

## Strings
- "AHCI_SMM : PxSERR Port Serial ATA Error Data32_SERR:%x Data32_IS :%x"
- "AHCI : GenerateSoftReset Status : %r"
- "AhciBaseAddr"
- Build path: `AmiModulePkg\AHCI\AhciSmm\AhciSmm.c`

## Platform
Intel Purley (HR650X server platform)