Windows-Server-2003/base/ntos/inc/shpc.h

490 lines
12 KiB
C
Raw Normal View History

2024-08-04 01:28:15 +02:00
/*++
Copyright (c) 2000-2001 Microsoft Corporation
Module Name:
shpc.h
Abstract:
Type definitions describing a Standard Hotplug Controller
Author:
Davis Walker (dwalker) 10 October 2000
Revision History:
--*/
#ifndef _SHPC_
#define _SHPC_
#include "pshpack1.h"
//
// Register set structures
//
//
// Slots Available Registers
//
// This is a two DWORD structure.
//
typedef struct _SHPC_SLOTS_AVAILABLE_REGISTER {
ULONG NumSlots33Conv:5; // HWINIT
ULONG:3; // RsvdP
ULONG NumSlots66PciX:5; // HWINIT
ULONG:3; // RsvdP
ULONG NumSlots100PciX:5; // HWINIT
ULONG:3; // RsvdP
ULONG NumSlots133PciX:5; // HWINIT
ULONG:3; // RsvdP
ULONG NumSlots66Conv:5; // HWINIT
ULONG:27; // RsvdP
} SHPC_SLOTS_AVAILABLE_REGISTER, *PSHPC_SLOTS_AVAILABLE_REGISTER;
//
// Slot Configuration Register
//
typedef struct _SHPC_SLOT_CONFIGURATION_REGISTER {
ULONG NumSlots:5; // HWINIT
ULONG:3; // RsvdP
ULONG FirstDeviceID:5; // HWINIT
ULONG:3; // RsvdP
ULONG PhysicalSlotNumber:11; // HWINIT
ULONG:2; // RsvdP
ULONG UpDown:1; // HWINIT
ULONG MRLSensorsImplemented:1; // HWINIT
ULONG AttentionButtonImplemented:1; // HWINIT
} SHPC_SLOT_CONFIGURATION_REGISTER, *PSHPC_SLOT_CONFIGURATION_REGISTER;
//
// Secondary Bus Configuration Register
//
typedef enum _SHPC_BUS_SPEED_MODE {
SHPC_SPEED_33_CONV = 0,
SHPC_SPEED_66_CONV,
SHPC_SPEED_66_PCIX,
SHPC_SPEED_100_PCIX,
SHPC_SPEED_133_PCIX
} SHPC_BUS_SPEED_MODE, *PSHPC_BUS_SPEED_MODE;
typedef struct _SHPC_BUS_CONFIG_REGISTER {
ULONG CurrentBusMode:3; // RO SHPC_SPEED_XXX
ULONG Rsvd:21; // RsvdP
ULONG ProgIF:8; // RO
} SHPC_BUS_CONFIG_REGISTER, *PSHPC_BUS_CONFIG_REGISTER;
//
// Command Register
//
#define SHPC_SLOT_OPERATION_CODE 0x0
#define SHPC_BUS_SEGMENT_OPERATION_CODE 0x8
#define SHPC_POWER_ALL_SLOTS_CODE 0x48
#define SHPC_ENABLE_ALL_SLOTS_CODE 0x49
//
// Command defines
//
#define IS_COMMAND_SLOT_OPERATION(x) \
(x.SlotOperation.CommandCode == SHPC_SLOT_OPERATION_CODE)
#define IS_COMMAND_SET_BUS_SEGMENT(x) \
(x.BusSegmentOperation.CommandCode == SHPC_BUS_SEGMENT_OPERATION_CODE)
#define IS_COMMAND_POWER_ALL_SLOTS(x) \
(x.AsUchar = SHPC_POWER_ALL_SLOTS_CODE)
#define IS_COMMAND_ENABLE_ALL_SLOTS(x) \
(x.AsUchar = SHPC_ENABLE_ALL_SLOTS_CODE)
typedef union _SHPC_CONTROLLER_COMMAND {
struct {
UCHAR SlotState:2;
UCHAR PowerIndicator:2;
UCHAR AttentionIndicator:2;
UCHAR CommandCode:2;
} SlotOperation;
struct {
UCHAR BusSpeed:3; // SHPC_SPEED_XXX
UCHAR CommandCode:5;
} BusSegmentOperation;
struct {
UCHAR Command:6;
UCHAR CommandCode:2;
} General;
UCHAR AsUchar;
} SHPC_CONTROLLER_COMMAND, *PSHPC_CONTROLLER_COMMAND;
typedef struct _SHPC_COMMAND_STATUS {
USHORT ControllerBusy:1; // RO
USHORT MRLOpen:1; // RO
USHORT InvalidCommand:1; // RO
USHORT InvalidSpeedMode:1; // RO
USHORT Rsvd:12; // RsvdP
} SHPC_COMMAND_STATUS, *PSHPC_COMMAND_STATUS;
typedef struct _SHPC_COMMAND_REGISTER {
SHPC_CONTROLLER_COMMAND Command;
struct {
UCHAR TargetForCommand:4;
UCHAR Rsvd:4; // RsvdP
} Target;
SHPC_COMMAND_STATUS Status;
} SHPC_COMMAND_REGISTER, *PSHPC_COMMAND_REGISTER;
//
// Interrupt Locator Register
//
typedef struct _SHPC_INT_LOCATOR_REGISTER {
ULONG CommandCompleteIntPending:1; // RO
ULONG InterruptLocator:31; // RO
} SHPC_INT_LOCATOR_REGISTER, *PSHPC_INT_LOCATOR_REGISTER;
//
// SERR Locator Register
//
typedef struct _SHPC_SERR_LOCATOR_REGISTER {
ULONG ArbiterSERRPending:1; // RO
ULONG SERRLocator:31; // RO
} SHPC_SERR_LOCATOR_REGISTER, *PSHPC_SERR_LOCATOR_REGISTER;
//
// Controller SERR-INT Register
//
// The low word is the interrupt mask. When mask bits are set, the
// corresponding operation is masked out.
//
#define SHPC_MASK_INT_COMMAND_COMPLETE 0x0001
#define SHPC_MASK_INT_GLOBAL 0x0002
#define SHPC_MASK_SERR_GLOBAL 0x0004
#define SHPC_MASK_SERR_ARBITER_TIMEOUT 0x0008
// all other bits in the low word are RsvdP
//
// The high word is the detected word.
//
#define SHPC_DETECTED_COMMAND_COMPLETE 0x0001
#define SHPC_DETECTED_ARBITER_TIMEOUT 0x0002
// all other bits in the high word are RsvdZ
typedef struct _SHPC_SERR_INT_REGISTER {
USHORT SERRIntMask;
USHORT SERRIntDetected;
} SHPC_SERR_INT_REGISTER, *PSHPC_SERR_INT_REGISTER;
//
// Slot Specific Registers
//
//
// Status Field
//
#define SHPC_SLOT_NOP 0
#define SHPC_SLOT_POWERED 1
#define SHPC_SLOT_ENABLED 2
#define SHPC_SLOT_OFF 3
#define SHPC_INDICATOR_NOP 0
#define SHPC_INDICATOR_ON 1
#define SHPC_INDICATOR_BLINK 2
#define SHPC_INDICATOR_OFF 3
#define SHPC_PCIX_NO_CAP 0x0
#define SHPC_PCIX_66_CAP 0x1
#define SHPC_PCIX_133_CAP 0x3
#define SHPC_MRL_CLOSED 0
#define SHPC_MRL_OPEN 1
#define SHPC_PRSNT_7_5_WATTS 0
#define SHPC_PRSNT_25_WATTS 1
#define SHPC_PRSNT_15_WATTS 2
#define SHPC_PRSNT_EMPTY 3
typedef struct _SHPC_SLOT_STATUS_REGISTER {
USHORT SlotState:2; // SHPC_SLOT_XXX
USHORT PowerIndicatorState:2; // SHPC_INDICATOR_XXX
USHORT AttentionIndicatorState:2; // SHPC_INDICATOR_XXX
USHORT PowerFaultDetected:1;
USHORT AttentionButtonState:1;
USHORT MRLSensorState:1; // SHPC_MRL_XXX
USHORT SpeedCapability:1;
USHORT PrsntState:2;
USHORT PCIXCapability:2; //SHPC_PCIX_XXX
USHORT Rsvd:2;
} SHPC_SLOT_STATUS_REGISTER, *PSHPC_SLOT_STATUS_REGISTER;
//
// Slot Event Latch Field
//
// This register is a UCHAR with bit meanings defined
// below.
// All undefined bits are RsvdZ
//
#define SHPC_SLOT_EVENT_CARD_PRESENCE 0x01
#define SHPC_SLOT_EVENT_ISO_FAULT 0x02
#define SHPC_SLOT_EVENT_ATTEN_BUTTON 0x04
#define SHPC_SLOT_EVENT_MRL_SENSOR 0x08
#define SHPC_SLOT_EVENT_CONNECT_FAULT 0x10
#define SHPC_SLOT_EVENT_ALL (SHPC_SLOT_EVENT_CARD_PRESENCE | \
SHPC_SLOT_EVENT_ISO_FAULT | \
SHPC_SLOT_EVENT_ATTEN_BUTTON | \
SHPC_SLOT_EVENT_MRL_SENSOR | \
SHPC_SLOT_EVENT_CONNECT_FAULT)
//
// Slot INT-SERR Mask Field
//
// This register is a UCHAR with bit meanings defined below
// All undefined bits are RsvdP
//
#define SHPC_SLOT_INT_CARD_PRESENCE 0x01
#define SHPC_SLOT_INT_ISO_FAULT 0x02
#define SHPC_SLOT_INT_ATTEN_BUTTON 0x04
#define SHPC_SLOT_INT_MRL_SENSOR 0x08
#define SHPC_SLOT_INT_CONNECT_FAULT 0x10
#define SHPC_SLOT_SERR_MRL_SENSOR 0x20
#define SHPC_SLOT_SERR_CONNECT_FAULT 0x40
#define SHPC_SLOT_INT_ALL (SHPC_SLOT_INT_CARD_PRESENCE | \
SHPC_SLOT_INT_ISO_FAULT | \
SHPC_SLOT_INT_ATTEN_BUTTON | \
SHPC_SLOT_INT_MRL_SENSOR | \
SHPC_SLOT_INT_CONNECT_FAULT)
#define SHPC_SLOT_SERR_ALL (SHPC_SLOT_SERR_CONNECT_FAULT | \
SHPC_SLOT_SERR_MRL_SENSOR)
//
// Overall Slot Register structure
//
typedef struct _SHPC_SLOT_REGISTER {
SHPC_SLOT_STATUS_REGISTER SlotStatus; //RO
UCHAR SlotEventLatch;
UCHAR IntSERRMask;
} SHPC_SLOT_REGISTER, *PSHPC_SLOT_REGISTER;
//
// Overall Register Set Structures
//
#define SHPC_MAX_SLOT_REGISTERS 31
typedef struct _SHPC_WORKING_REGISTERS {
ULONG BaseOffset;
SHPC_SLOTS_AVAILABLE_REGISTER SlotsAvailable;
SHPC_SLOT_CONFIGURATION_REGISTER SlotConfig;
SHPC_BUS_CONFIG_REGISTER BusConfig;
SHPC_COMMAND_REGISTER Command;
SHPC_INT_LOCATOR_REGISTER IntLocator;
SHPC_SERR_LOCATOR_REGISTER SERRLocator;
SHPC_SERR_INT_REGISTER SERRInt;
SHPC_SLOT_REGISTER SlotRegisters[SHPC_MAX_SLOT_REGISTERS];
} SHPC_WORKING_REGISTERS, *PSHPC_WORKING_REGISTERS;
//
// Register access structures and defines
//
#define SHPC_NUM_REGISTERS sizeof(SHPC_WORKING_REGISTERS)/sizeof(ULONG)
#define SHPC_FIRST_SLOT_REG (SHPC_NUM_REGISTERS - SHPC_MAX_SLOT_REGISTERS)
typedef union _SHPC_REGISTER_SET {
SHPC_WORKING_REGISTERS WorkingRegisters;
ULONG AsULONGs[SHPC_NUM_REGISTERS];
} SHPC_REGISTER_SET, *PSHPC_REGISTER_SET;
//
// HBRB defines
//
#define HBRB_PACKAGE_COUNT 2
typedef struct _HBRB_HEADER {
USHORT VendorID;
USHORT DeviceID;
UCHAR RevisionID;
UCHAR ProgIF;
UCHAR BusNumber;
UCHAR HBRBVersion;
USHORT SubVendorID;
USHORT SubSystemID;
ULONG Size;
ULONG CapabilitiesPtr;
} HBRB_HEADER, *PHBRB_HEADER;
typedef struct _HBRB_CAPABILITIES_HEADER {
ULONG CapabilityID;
ULONG Next;
} HBRB_CAPABILITIES_HEADER, *PHBRB_CAPABILITIES_HEADER;
typedef struct _HBRB_CAPABILITY {
HBRB_CAPABILITIES_HEADER Header;
SHPC_WORKING_REGISTERS RegisterSet;
} SHPC_HBRB_CAPABILITY, *PSHPC_HBRB_CAPABILITY;
//
// SHPC config space defines
//
typedef union _SHPC_CONFIG_PENDING {
struct {
UCHAR ControllerSERRPending:1; // RO
UCHAR ControllerIntPending:1; // RO
UCHAR:6; // RsvdP
} Field;
UCHAR AsUCHAR;
} SHPC_CONFIG_PENDING, *PSHPC_CONFIG_PENDING;
typedef struct _SHPC_CONFIG_SPACE {
PCI_CAPABILITIES_HEADER Header; //RO
UCHAR DwordSelect;
SHPC_CONFIG_PENDING Pending;
ULONG Data;
} SHPC_CONFIG_SPACE, *PSHPC_CONFIG_SPACE;
#include "poppack.h"
#define SHPC_CAPABILITY_ID 0xC
//
// Bit type masks
//
//
// XxxRO indicates the mask of bits in the register that are Read Only
// XxxRW indicates the mask of bits in the register that are Read Write
// XxxRWC indicates the mask of bits in the register that are Read/Write Clear
// XxxRsvdP indicates the mask of bits in the register that are Reserved
// and whose values should be preserved on writes.
// XxxRsvdZ indicates the mask of bits in the register that are Reserved
// and whose values should be always written as zeros.
//
// All of the listed masks for a register should always add to 0xFFFFFFFF
//
//
// Base Offset Register
//
#define BaseOffsetRO 0xFFFFFFFF
//
// Slots Available Registers
// DWord1 is the lower dword
// DWord2 is the upper dword
//
#define SlotsAvailDWord1RO 0x1F1F1F1F
#define SlotsAvailDWord1RsvdP 0xE0E0E0E0
#define SlotsAvailDWord2RO 0x0000001F
#define SlotsAvailDWord2RsvdP 0xFFFFFFE0
//
// Slot Configuration Register
//
#define SlotConfigRO 0xE7FF1F1F
#define SlotConfigRsvdP 0x1800E0E0
//
// Secondary Bus Configuration Register
// This mask includes the SHPC Programming Interface register
//
#define BusConfigRO 0xFF000007
#define BusConfigRsvdP 0x00FFFFF8
//
// Controller Command/Status Register
// This mask includes both the Command and Command Status registers
//
#define CommandStatusRO 0x000F0000
#define CommandStatusRW 0x00001FFF
#define CommandStatusRsvdP 0xFFF0E000
//
// Interrupt Locator Register
//
#define IntLocatorRO 0xFFFFFFFF
//
// SERR Locator Register
//
#define SERRLocatorRO 0xFFFFFFFF
//
// Controller SERR-INT Register
//
#define ControllerMaskRW 0x0000000F
#define ControllerMaskRWC 0x00030000
#define ControllerMaskRsvdP 0x0000FFF0
#define ControllerMaskRsvdZ 0xFFFC0000
//
// Slot Specific Registers
//
#define SlotRO 0x00003FFF
#define SlotRW 0x7F000000
#define SlotRWC 0x001F0000
#define SlotRsvdP 0x80000000
#define SlotRsvdZ 0x00E0C000
#endif