SataController

Index: 0128 | Size: 158.0 KB | Phase: DXE | Arch: X64

Source: AmiModulePkg/AHCI/SataController/SataController.c with declarations in
SataController.h.

Overview

SATA host controller driver implementing the EFI_IDE_CONTROLLER_INIT_PROTOCOL for Intel PCH SATA controllers on the Purley platform. Manages channel enumeration, device identification (IDENTIFY DEVICE), PIO/DMA mode calculation, and asynchronous command submission. Also integrates S3 boot script management -- saves/restores SATA controller configuration to/from the SMM LockBox for S3 resume path.

Key Functions

• SataGetDeviceCount / SataGetDevice: Enumerate and identify SATA devices on available channels
• SataIdentifyDevice: Execute ATA IDENTIFY DEVICE command, parse capabilities (PIO modes, DMA modes, IORDY support)
• SataCalculateBestPioMode: Determine optimal PIO timing mode from IDENTIFY data (modes 0-4 based on Field103)
• PchGetPchSeries: Detect PCH generation (SPT range 0x9D00-0x9D3F, CNP range, Cannon Point) for controller-specific configuration
• S3BootScriptLibInit / SaveBootScriptDataToLockBox: Save SATA register state to LockBox for S3 resume, including memory ranges and boot script context

Protocols/Dependencies

• EFI_IDE_CONTROLLER_INIT_PROTOCOL, EFI_SMM_BASE2_PROTOCOL
• PCI I/O protocol (MmPciBase for PCH register access)
• SMM LockBox protocol (SmmLockBoxSave/Restore/SetAttributes)
• S3 Boot Script Library, DxeSmmReadyToLock event

Platform

Intel Purley platform (PurleySktPkg), Lenovo HR650X. PCH SATA controller with S3 resume support.

Module/File Split Notes

• SataController.c: recovered implementations for the EFI_IDE_CONTROLLER_INIT_PROTOCOL surface, mode calculation, PCH detection, S3 boot-script lifecycle, and SMM LockBox wrappers.
• SataController.h: recovered canonical exports and parameter contracts for all recovered symbols.

Recovered Variable Naming

• gBootScriptContext
• gAltBootScriptContext
• gBootScriptAllocated
• gBootScriptFinalGuid
• gBootScriptCloseGuid
• gLockBoxGuid2
• gEventExitBootSvc
• gEventSetVirtualAddrMap
• gEventReadyToLock
• gSmst
• gSmstAllocated
• gDxeSmmReadyToLockEvent
• gLockBoxCommBuffer
• gPchSeries