+++ /dev/null
-/*++\r
-\r
- Copyright (c) 2004 - 2014, Intel Corporation. All rights reserved.<BR>\r
- \r\r
- SPDX-License-Identifier: BSD-2-Clause-Patent\r
-\r
- \r\r
-\r
-\r
-Module Name:\r
-\r
- EfiRegTableLib.h\r
-\r
-Abstract:\r
-\r
- Definitions and macros for building register tables for chipset\r
- initialization..\r
-\r
- Components linking this lib must include CpuIo, PciRootBridgeIo, and\r
- BootScriptSave protocols in their DPX.\r
-\r
-\r
-\r
---*/\r
-\r
-#ifndef EFI_REG_TABLE_H\r
-#define EFI_REG_TABLE_H\r
-\r
-\r
-#include <PiDxe.h>\r
-#include <Library/BaseLib.h>\r
-#include <Library/DebugLib.h>\r
-#include <Library/UefiLib.h>\r
-#include <Library/UefiDriverEntryPoint.h>\r
-#include <Protocol/CpuIo.h>\r
-#include <Protocol/BootScriptSave.h>\r
-#include <Framework/BootScript.h>\r
-#include <Protocol/PciRootBridgeIo.h>\r
-\r
-\r
-#define OPCODE_BASE(OpCode) ((UINT8)((OpCode) & 0xFF))\r
-#define OPCODE_FLAGS(OpCode) ((UINT8)(((OpCode) >> 8) & 0xFF))\r
-#define OPCODE_EXTRA_DATA(OpCode) ((UINT16)((OpCode) >> 16))\r
-\r
-//\r
-// RegTable Base OpCodes\r
-//\r
-#define OP_TERMINATE_TABLE 0\r
-#define OP_MEM_WRITE 1\r
-#define OP_MEM_READ_MODIFY_WRITE 2\r
-#define OP_IO_WRITE 3\r
-#define OP_IO_READ_MODIFY_WRITE 4\r
-#define OP_PCI_WRITE 5\r
-#define OP_PCI_READ_MODIFY_WRITE 6\r
-#define OP_STALL 7\r
-\r
-//\r
-// RegTable OpCode Flags\r
-//\r
-#define OPCODE_FLAG_S3SAVE 1\r
-\r
-\r
-#define TERMINATE_TABLE { (UINT32) OP_TERMINATE_TABLE, (UINT32) 0, (UINT32) 0 }\r
-\r
-\r
-//\r
-// REG_TABLE_ENTRY_PCI_WRITE encodes the width in the upper bits of the OpCode\r
-// as one of the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH values\r
-//\r
-typedef struct {\r
- UINT32 OpCode;\r
- UINT32 PciAddress;\r
- UINT32 Data;\r
-} EFI_REG_TABLE_PCI_WRITE;\r
-\r
-#define PCI_WRITE(Bus, Dev, Fnc, Reg, Width, Data, S3Flag) \\r
- { \\r
- (UINT32) (OP_PCI_WRITE | ((S3Flag) << 8) | ((Width) << 16)), \\r
- (UINT32) (EFI_PCI_ADDRESS ((Bus), (Dev), (Fnc), (Reg))), \\r
- (UINT32) (Data), \\r
- (UINT32) (0) \\r
- }\r
-\r
-typedef struct {\r
- UINT32 OpCode;\r
- UINT32 MemAddress;\r
- UINT32 Data;\r
-} EFI_REG_TABLE_MEM_WRITE;\r
-\r
-typedef struct {\r
- UINT32 OpCode;\r
- UINT32 PciAddress;\r
- UINT32 OrMask;\r
- UINT32 AndMask;\r
-} EFI_REG_TABLE_PCI_READ_MODIFY_WRITE;\r
-\r
-#define PCI_READ_MODIFY_WRITE(Bus, Dev, Fnc, Reg, Width, OrMask, AndMask, S3Flag) \\r
- { \\r
- (UINT32) (OP_PCI_READ_MODIFY_WRITE | ((S3Flag) << 8) | ((Width) << 16)), \\r
- (UINT32) (EFI_PCI_ADDRESS ((Bus), (Dev), (Fnc), (Reg))), \\r
- (UINT32) (OrMask), \\r
- (UINT32) (AndMask) \\r
- }\r
-\r
-typedef struct {\r
- UINT32 OpCode;\r
- UINT32 MemAddress;\r
- UINT32 OrMask;\r
- UINT32 AndMask;\r
-} EFI_REG_TABLE_MEM_READ_MODIFY_WRITE;\r
-\r
-#define MEM_READ_MODIFY_WRITE(Address, Width, OrMask, AndMask, S3Flag) \\r
- { \\r
- (UINT32) (OP_MEM_READ_MODIFY_WRITE | ((S3Flag) << 8) | ((Width) << 16)), \\r
- (UINT32) (Address), \\r
- (UINT32) (OrMask), \\r
- (UINT32) (AndMask) \\r
- }\r
-\r
-typedef struct {\r
- UINT32 OpCode;\r
- UINT32 Field2;\r
- UINT32 Field3;\r
- UINT32 Field4;\r
-} EFI_REG_TABLE_GENERIC;\r
-\r
-typedef union {\r
- EFI_REG_TABLE_GENERIC Generic;\r
- EFI_REG_TABLE_PCI_WRITE PciWrite;\r
- EFI_REG_TABLE_PCI_READ_MODIFY_WRITE PciReadModifyWrite;\r
- EFI_REG_TABLE_MEM_READ_MODIFY_WRITE MemReadModifyWrite;\r
-} EFI_REG_TABLE;\r
-\r
-/**\r
- Processes register table assuming which may contain PCI, IO, MEM, and STALL\r
- entries.\r
-\r
- No parameter checking is done so the caller must be careful about omitting\r
- values for PciRootBridgeIo or CpuIo parameters. If the regtable does\r
- not contain any PCI accesses, it is safe to omit the PciRootBridgeIo (supply\r
- NULL). If the regtable does not contain any IO or Mem entries, it is safe to\r
- omit the CpuIo (supply NULL).\r
-\r
- The RegTableEntry parameter is not checked, but is required.\r
-\r
- gBS is assumed to have been defined and is used when processing stalls.\r
-\r
- The function processes each entry sequentially until an OP_TERMINATE_TABLE\r
- entry is encountered.\r
-\r
- @param[in] RegTableEntry A pointer to the register table to process\r
-\r
- @param[in] PciRootBridgeIo A pointer to the instance of PciRootBridgeIo that is used\r
- when processing PCI table entries\r
-\r
- @param[in] CpuIo A pointer to the instance of CpuIo that is used when processing IO and\r
- MEM table entries\r
-\r
- @retval Nothing.\r
-\r
-**/\r
-VOID\r
-ProcessRegTablePci (\r
- EFI_REG_TABLE * RegTableEntry,\r
- EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL * PciRootBridgeIo,\r
- EFI_CPU_IO_PROTOCOL * CpuIo\r
- );\r
-\r
-/**\r
- Processes register table assuming which may contain IO, MEM, and STALL\r
- entries, but must NOT contain any PCI entries. Any PCI entries cause an\r
- ASSERT in a DEBUG build and are skipped in a free build.\r
-\r
- No parameter checking is done. Both RegTableEntry and CpuIo parameters are\r
- required.\r
-\r
- gBS is assumed to have been defined and is used when processing stalls.\r
-\r
- The function processes each entry sequentially until an OP_TERMINATE_TABLE\r
- entry is encountered.\r
-\r
- @param[in] RegTableEntry - A pointer to the register table to process\r
-\r
- @param[in] CpuIo - A pointer to the instance of CpuIo that is used when processing IO and\r
- MEM table entries\r
-\r
- @retval Nothing.\r
-\r
-**/\r
-VOID\r
-ProcessRegTableCpu (\r
- EFI_REG_TABLE * RegTableEntry,\r
- EFI_CPU_IO_PROTOCOL * CpuIo\r
- );\r
-\r
-#endif\r
projects / mirror_edk2.git / blobdiff