XhciReg.h

Go to the documentation of this file.

 
#ifndef _EFI_PEI_XHCI_REG_H_
#define _EFI_PEI_XHCI_REG_H_
 
//
// Capability registers offset
//
#define XHC_CAPLENGTH_OFFSET   0x00             // Capability register length offset
#define XHC_HCIVERSION_OFFSET  0x02             // Interface Version Number 02-03h
#define XHC_HCSPARAMS1_OFFSET  0x04             // Structural Parameters 1
#define XHC_HCSPARAMS2_OFFSET  0x08             // Structural Parameters 2
#define XHC_HCSPARAMS3_OFFSET  0x0c             // Structural Parameters 3
#define XHC_HCCPARAMS_OFFSET   0x10             // Capability Parameters
#define XHC_DBOFF_OFFSET       0x14             // Doorbell Offset
#define XHC_RTSOFF_OFFSET      0x18             // Runtime Register Space Offset
 
//
// Operational registers offset
//
#define XHC_USBCMD_OFFSET    0x0000             // USB Command Register Offset
#define XHC_USBSTS_OFFSET    0x0004             // USB Status Register Offset
#define XHC_PAGESIZE_OFFSET  0x0008             // USB Page Size Register Offset
#define XHC_DNCTRL_OFFSET    0x0014             // Device Notification Control Register Offset
#define XHC_CRCR_OFFSET      0x0018             // Command Ring Control Register Offset
#define XHC_DCBAAP_OFFSET    0x0030             // Device Context Base Address Array Pointer Register Offset
#define XHC_CONFIG_OFFSET    0x0038             // Configure Register Offset
#define XHC_PORTSC_OFFSET    0x0400             // Port Status and Control Register Offset
 
//
// Runtime registers offset
//
#define XHC_MFINDEX_OFFSET  0x00                // Microframe Index Register Offset
#define XHC_IMAN_OFFSET     0x20                // Interrupter X Management Register Offset
#define XHC_IMOD_OFFSET     0x24                // Interrupter X Moderation Register Offset
#define XHC_ERSTSZ_OFFSET   0x28                // Event Ring Segment Table Size Register Offset
#define XHC_ERSTBA_OFFSET   0x30                // Event Ring Segment Table Base Address Register Offset
#define XHC_ERDP_OFFSET     0x38                // Event Ring Dequeue Pointer Register Offset
 
//
// Register Bit Definition
//
#define XHC_USBCMD_RUN    BIT0                  // Run/Stop
#define XHC_USBCMD_RESET  BIT1                  // Host Controller Reset
#define XHC_USBCMD_INTE   BIT2                  // Interrupter Enable
#define XHC_USBCMD_HSEE   BIT3                  // Host System Error Enable
 
#define XHC_USBSTS_HALT  BIT0                   // Host Controller Halted
#define XHC_USBSTS_HSE   BIT2                   // Host System Error
#define XHC_USBSTS_EINT  BIT3                   // Event Interrupt
#define XHC_USBSTS_PCD   BIT4                   // Port Change Detect
#define XHC_USBSTS_SSS   BIT8                   // Save State Status
#define XHC_USBSTS_RSS   BIT9                   // Restore State Status
#define XHC_USBSTS_SRE   BIT10                  // Save/Restore Error
#define XHC_USBSTS_CNR   BIT11                  // Host Controller Not Ready
#define XHC_USBSTS_HCE   BIT12                  // Host Controller Error
 
#define XHC_PAGESIZE_MASK  0xFFFF               // Page Size
 
#define XHC_CRCR_RCS  BIT0                      // Ring Cycle State
#define XHC_CRCR_CS   BIT1                      // Command Stop
#define XHC_CRCR_CA   BIT2                      // Command Abort
#define XHC_CRCR_CRR  BIT3                      // Command Ring Running
 
#define XHC_CONFIG_MASK  0xFF                   // Max Device Slots Enabled
 
#define XHC_PORTSC_CCS    BIT0                      // Current Connect Status
#define XHC_PORTSC_PED    BIT1                      // Port Enabled/Disabled
#define XHC_PORTSC_OCA    BIT3                      // Over-current Active
#define XHC_PORTSC_RESET  BIT4                      // Port Reset
#define XHC_PORTSC_PLS    (BIT5|BIT6|BIT7|BIT8)     // Port Link State
#define XHC_PORTSC_PP     BIT9                      // Port Power
#define XHC_PORTSC_PS     (BIT10|BIT11|BIT12|BIT13) // Port Speed
#define XHC_PORTSC_LWS    BIT16                     // Port Link State Write Strobe
#define XHC_PORTSC_CSC    BIT17                     // Connect Status Change
#define XHC_PORTSC_PEC    BIT18                     // Port Enabled/Disabled Change
#define XHC_PORTSC_WRC    BIT19                     // Warm Port Reset Change
#define XHC_PORTSC_OCC    BIT20                     // Over-Current Change
#define XHC_PORTSC_PRC    BIT21                     // Port Reset Change
#define XHC_PORTSC_PLC    BIT22                     // Port Link State Change
#define XHC_PORTSC_CEC    BIT23                     // Port Config Error Change
#define XHC_PORTSC_CAS    BIT24                     // Cold Attach Status
 
#define XHC_HUB_PORTSC_CCS    BIT0              // Hub's Current Connect Status
#define XHC_HUB_PORTSC_PED    BIT1              // Hub's Port Enabled/Disabled
#define XHC_HUB_PORTSC_OCA    BIT3              // Hub's Over-current Active
#define XHC_HUB_PORTSC_RESET  BIT4              // Hub's Port Reset
#define XHC_HUB_PORTSC_PP     BIT9              // Hub's Port Power
#define XHC_HUB_PORTSC_CSC    BIT16             // Hub's Connect Status Change
#define XHC_HUB_PORTSC_PEC    BIT17             // Hub's Port Enabled/Disabled Change
#define XHC_HUB_PORTSC_OCC    BIT19             // Hub's Over-Current Change
#define XHC_HUB_PORTSC_PRC    BIT20             // Hub's Port Reset Change
#define XHC_HUB_PORTSC_BHRC   BIT21             // Hub's Port Warm Reset Change
 
#define XHC_IMAN_IP  BIT0                       // Interrupt Pending
#define XHC_IMAN_IE  BIT1                       // Interrupt Enable
 
#define XHC_IMODI_MASK  0x0000FFFF                  // Interrupt Moderation Interval
#define XHC_IMODC_MASK  0xFFFF0000                  // Interrupt Moderation Counter
 
#pragma pack (1)
typedef struct {
  UINT8     MaxSlots;                   // Number of Device Slots
  UINT16    MaxIntrs : 11;              // Number of Interrupters
  UINT16    Rsvd     : 5;
  UINT8     MaxPorts;                   // Number of Ports
} HCSPARAMS1;
 
//
// Structural Parameters 1 Register Bitmap Definition
//
typedef union {
  UINT32        Dword;
  HCSPARAMS1    Data;
} XHC_HCSPARAMS1;
 
typedef struct {
  UINT32    Ist          : 4;           // Isochronous Scheduling Threshold
  UINT32    Erst         : 4;           // Event Ring Segment Table Max
  UINT32    Rsvd         : 13;
  UINT32    ScratchBufHi : 5;           // Max Scratchpad Buffers Hi
  UINT32    Spr          : 1;           // Scratchpad Restore
  UINT32    ScratchBufLo : 5;           // Max Scratchpad Buffers Lo
} HCSPARAMS2;
 
//
// Structural Parameters 2 Register Bitmap Definition
//
typedef union {
  UINT32        Dword;
  HCSPARAMS2    Data;
} XHC_HCSPARAMS2;
 
typedef struct {
  UINT16    Ac64       : 1;            // 64-bit Addressing Capability
  UINT16    Bnc        : 1;            // BW Negotiation Capability
  UINT16    Csz        : 1;            // Context Size
  UINT16    Ppc        : 1;            // Port Power Control
  UINT16    Pind       : 1;            // Port Indicators
  UINT16    Lhrc       : 1;            // Light HC Reset Capability
  UINT16    Ltc        : 1;            // Latency Tolerance Messaging Capability
  UINT16    Nss        : 1;            // No Secondary SID Support
  UINT16    Pae        : 1;            // Parse All Event Data
  UINT16    Rsvd       : 3;
  UINT16    MaxPsaSize : 4;            // Maximum Primary Stream Array Size
  UINT16    ExtCapReg;                 // xHCI Extended Capabilities Pointer
} HCCPARAMS;
 
//
// Capability Parameters Register Bitmap Definition
//
typedef union {
  UINT32       Dword;
  HCCPARAMS    Data;
} XHC_HCCPARAMS;
 
#pragma pack ()
 
//
// XHCi Data and Ctrl Structures
//
#pragma pack(1)
typedef struct {
  UINT8    Pi;
  UINT8    SubClassCode;
  UINT8    BaseCode;
} USB_CLASSC;
 
typedef struct {
  UINT8     Length;
  UINT8     DescType;
  UINT8     NumPorts;
  UINT16    HubCharacter;
  UINT8     PwrOn2PwrGood;
  UINT8     HubContrCurrent;
  UINT8     Filler[16];
} EFI_USB_HUB_DESCRIPTOR;
#pragma pack()
 
//
//  Hub Class Feature Selector for Clear Port Feature Request
//  It's the extension of hub class feature selector of USB 2.0 in USB 3.0 Spec.
//  For more details, Please refer to USB 3.0 Spec Table 10-7.
//
typedef enum {
  Usb3PortBHPortReset       = 28,
  Usb3PortBHPortResetChange = 29
} XHC_PORT_FEATURE;
 
//
// Structure to map the hardware port states to the
// UEFI's port states.
//
typedef struct {
  UINT32    HwState;
  UINT16    UefiState;
} USB_PORT_STATE_MAP;
 
//
// Structure to map the hardware port states to feature selector for clear port feature request.
//
typedef struct {
  UINT32    HwState;
  UINT16    Selector;
} USB_CLEAR_PORT_MAP;
 
UINT32
XhcPeiReadOpReg (
  IN  PEI_XHC_DEV  *Xhc,
  IN  UINT32       Offset
  );
 
VOID
XhcPeiWriteOpReg (
  IN PEI_XHC_DEV  *Xhc,
  IN UINT32       Offset,
  IN UINT32       Data
  );
 
VOID
XhcPeiSetOpRegBit (
  IN PEI_XHC_DEV  *Xhc,
  IN UINT32       Offset,
  IN UINT32       Bit
  );
 
VOID
XhcPeiClearOpRegBit (
  IN PEI_XHC_DEV  *Xhc,
  IN UINT32       Offset,
  IN UINT32       Bit
  );
 
EFI_STATUS
XhcPeiWaitOpRegBit (
  IN PEI_XHC_DEV  *Xhc,
  IN UINT32       Offset,
  IN UINT32       Bit,
  IN BOOLEAN      WaitToSet,
  IN UINT32       Timeout
  );
 
VOID
XhcPeiWriteDoorBellReg (
  IN PEI_XHC_DEV  *Xhc,
  IN UINT32       Offset,
  IN UINT32       Data
  );
 
UINT32
XhcPeiReadRuntimeReg (
  IN PEI_XHC_DEV  *Xhc,
  IN  UINT32      Offset
  );
 
VOID
XhcPeiWriteRuntimeReg (
  IN PEI_XHC_DEV  *Xhc,
  IN UINT32       Offset,
  IN UINT32       Data
  );
 
VOID
XhcPeiSetRuntimeRegBit (
  IN PEI_XHC_DEV  *Xhc,
  IN UINT32       Offset,
  IN UINT32       Bit
  );
 
VOID
XhcPeiClearRuntimeRegBit (
  IN PEI_XHC_DEV  *Xhc,
  IN UINT32       Offset,
  IN UINT32       Bit
  );
 
BOOLEAN
XhcPeiIsHalt (
  IN PEI_XHC_DEV  *Xhc
  );
 
BOOLEAN
XhcPeiIsSysError (
  IN PEI_XHC_DEV  *Xhc
  );
 
EFI_STATUS
XhcPeiResetHC (
  IN PEI_XHC_DEV  *Xhc,
  IN UINT32       Timeout
  );
 
EFI_STATUS
XhcPeiHaltHC (
  IN PEI_XHC_DEV  *Xhc,
  IN UINT32       Timeout
  );
 
EFI_STATUS
XhcPeiRunHC (
  IN PEI_XHC_DEV  *Xhc,
  IN UINT32       Timeout
  );
 
#endif