OvmfPkg/OvmfPkg.dec

   1 ## @file
   2 #  EFI/Framework Open Virtual Machine Firmware (OVMF) platform
   3 #
   4 #  Copyright (c) 2020, Rebecca Cran <rebecca@bsdio.com>
   5 #  Copyright (c) 2006 - 2019, Intel Corporation. All rights reserved.<BR>
   6 #  Copyright (c) 2014, Pluribus Networks, Inc.
   7 #
   8 #  SPDX-License-Identifier: BSD-2-Clause-Patent
   9 #
  10 ##
  11
  12 [Defines]
  13   DEC_SPECIFICATION              = 0x00010005
  14   PACKAGE_NAME                   = OvmfPkg
  15   PACKAGE_GUID                   = 2daf5f34-50e5-4b9d-b8e3-5562334d87e5
  16   PACKAGE_VERSION                = 0.1
  17
  18 [Includes]
  19   Include
  20   Csm/Include
  21
  22 [LibraryClasses]
  23   ##  @libraryclass  Access bhyve's firmware control interface.
  24   BhyveFwCtlLib|Include/Library/BhyveFwCtlLib.h
  25
  26   ##  @libraryclass  Verify blobs read from the VMM
  27   BlobVerifierLib|Include/Library/BlobVerifierLib.h
  28
  29   ##  @libraryclass  Loads and boots a Linux kernel image
  30   #
  31   LoadLinuxLib|Include/Library/LoadLinuxLib.h
  32
  33   ##  @libraryclass  Declares helper functions for Secure Encrypted
  34   #                  Virtualization (SEV) guests.
  35   MemEncryptSevLib|Include/Library/MemEncryptSevLib.h
  36
  37   ##  @libraryclass  Declares helper functions for TDX guests.
  38   #
  39   MemEncryptTdxLib|Include/Library/MemEncryptTdxLib.h
  40
  41   ##  @libraryclass  Handle TPL changes within nested interrupt handlers
  42   #
  43   NestedInterruptTplLib|Include/Library/NestedInterruptTplLib.h
  44
  45   ##  @libraryclass  Save and restore variables using a file
  46   #
  47   NvVarsFileLib|Include/Library/NvVarsFileLib.h
  48
  49   ##  @libraryclass  Provides services to work with PCI capabilities in PCI
  50   #                  config space.
  51   PciCapLib|Include/Library/PciCapLib.h
  52
  53   ##  @libraryclass  Layered on top of PciCapLib, allows clients to plug an
  54   #                  EFI_PCI_IO_PROTOCOL backend into PciCapLib, for config
  55   #                  space access.
  56   PciCapPciIoLib|Include/Library/PciCapPciIoLib.h
  57
  58   ##  @libraryclass  Layered on top of PciCapLib, allows clients to plug a
  59   #                  PciSegmentLib backend into PciCapLib, for config space
  60   #                  access.
  61   PciCapPciSegmentLib|Include/Library/PciCapPciSegmentLib.h
  62
  63   ##  @libraryclass  Provide common utility functions to PciHostBridgeLib
  64   #                  instances in ArmVirtPkg and OvmfPkg.
  65   PciHostBridgeUtilityLib|Include/Library/PciHostBridgeUtilityLib.h
  66
  67   ##  @libraryclass  Register a status code handler for printing the Boot
  68   #                  Manager's LoadImage() and StartImage() preparations, and
  69   #                  return codes, to the UEFI console.
  70   PlatformBmPrintScLib|Include/Library/PlatformBmPrintScLib.h
  71
  72   ##  @libraryclass  Customize FVB2 protocol member functions for a platform.
  73   PlatformFvbLib|Include/Library/PlatformFvbLib.h
  74
  75   ##  @libraryclass  Access QEMU's firmware configuration interface
  76   #
  77   QemuFwCfgLib|Include/Library/QemuFwCfgLib.h
  78
  79   ##  @libraryclass  S3 support for QEMU fw_cfg
  80   #
  81   QemuFwCfgS3Lib|Include/Library/QemuFwCfgS3Lib.h
  82
  83   ##  @libraryclass  Parse the contents of named fw_cfg files as simple
  84   #                  (scalar) data types.
  85   QemuFwCfgSimpleParserLib|Include/Library/QemuFwCfgSimpleParserLib.h
  86
  87   ##  @libraryclass  Rewrite the BootOrder NvVar based on QEMU's "bootorder"
  88   #                  fw_cfg file.
  89   #
  90   QemuBootOrderLib|Include/Library/QemuBootOrderLib.h
  91
  92   ##  @libraryclass  Load a kernel image and command line passed to QEMU via
  93   #                  the command line
  94   #
  95   QemuLoadImageLib|Include/Library/QemuLoadImageLib.h
  96
  97   ##  @libraryclass  Serialize (and deserialize) variables
  98   #
  99   SerializeVariablesLib|Include/Library/SerializeVariablesLib.h
 100
 101   ##  @libraryclass  TdxHelper
 102   #
 103   TdxHelperLib|Include/Library/TdxHelperLib.h
 104
 105   ##  @libraryclass  Declares utility functions for virtio device drivers.
 106   VirtioLib|Include/Library/VirtioLib.h
 107
 108   ##  @libraryclass  Install Virtio Device Protocol instances on virtio-mmio
 109   #                  transports.
 110   VirtioMmioDeviceLib|Include/Library/VirtioMmioDeviceLib.h
 111
 112   ##  @libraryclass  Provides a Nor flash interface.
 113   #
 114   VirtNorFlashPlatformLib|Include/Library/VirtNorFlashPlatformLib.h
 115
 116   ##  @libraryclass  Invoke Xen hypercalls
 117   #
 118   XenHypercallLib|Include/Library/XenHypercallLib.h
 119
 120   ##  @libraryclass  Manage XenBus device path and I/O handles
 121   #
 122   XenIoMmioLib|Include/Library/XenIoMmioLib.h
 123
 124   ##  @libraryclass  Get information about Xen
 125   #
 126   XenPlatformLib|Include/Library/XenPlatformLib.h
 127
 128   ##  @libraryclass  TdxMailboxLib
 129   #
 130   TdxMailboxLib|Include/Library/TdxMailboxLib.h
 131
 132   ##  @libraryclass  PlatformInitLib
 133   #
 134   PlatformInitLib|Include/Library/PlatformInitLib.h
 135
 136   ##  @libraryclass  PeilessStartupLib
 137   #
 138   PeilessStartupLib|Include/Library/PeilessStartupLib.h
 139
 140   ##  @libraryclass  HardwareInfoLib
 141   #
 142   HardwareInfoLib|Include/Library/HardwareInfoLib.h
 143
 144 [Guids]
 145   gUefiOvmfPkgTokenSpaceGuid            = {0x93bb96af, 0xb9f2, 0x4eb8, {0x94, 0x62, 0xe0, 0xba, 0x74, 0x56, 0x42, 0x36}}
 146   gEfiXenInfoGuid                       = {0xd3b46f3b, 0xd441, 0x1244, {0x9a, 0x12, 0x0, 0x12, 0x27, 0x3f, 0xc1, 0x4d}}
 147   gOvmfPkKek1AppPrefixGuid              = {0x4e32566d, 0x8e9e, 0x4f52, {0x81, 0xd3, 0x5b, 0xb9, 0x71, 0x5f, 0x97, 0x27}}
 148   gOvmfPlatformConfigGuid               = {0x7235c51c, 0x0c80, 0x4cab, {0x87, 0xac, 0x3b, 0x08, 0x4a, 0x63, 0x04, 0xb1}}
 149   gVirtioMmioTransportGuid              = {0x837dca9e, 0xe874, 0x4d82, {0xb2, 0x9a, 0x23, 0xfe, 0x0e, 0x23, 0xd1, 0xe2}}
 150   gQemuRamfbGuid                        = {0x557423a1, 0x63ab, 0x406c, {0xbe, 0x7e, 0x91, 0xcd, 0xbc, 0x08, 0xc4, 0x57}}
 151   gXenBusRootDeviceGuid                 = {0xa732241f, 0x383d, 0x4d9c, {0x8a, 0xe1, 0x8e, 0x09, 0x83, 0x75, 0x89, 0xd7}}
 152   gRootBridgesConnectedEventGroupGuid   = {0x24a2d66f, 0xeedd, 0x4086, {0x90, 0x42, 0xf2, 0x6e, 0x47, 0x97, 0xee, 0x69}}
 153   gMicrosoftVendorGuid                  = {0x77fa9abd, 0x0359, 0x4d32, {0xbd, 0x60, 0x28, 0xf4, 0xe7, 0x8f, 0x78, 0x4b}}
 154   gEfiLegacyBiosGuid                    = {0x2E3044AC, 0x879F, 0x490F, {0x97, 0x60, 0xBB, 0xDF, 0xAF, 0x69, 0x5F, 0x50}}
 155   gEfiLegacyDevOrderVariableGuid        = {0xa56074db, 0x65fe, 0x45f7, {0xbd, 0x21, 0x2d, 0x2b, 0xdd, 0x8e, 0x96, 0x52}}
 156   gQemuKernelLoaderFsMediaGuid          = {0x1428f772, 0xb64a, 0x441e, {0xb8, 0xc3, 0x9e, 0xbd, 0xd7, 0xf8, 0x93, 0xc7}}
 157   gGrubFileGuid                         = {0xb5ae312c, 0xbc8a, 0x43b1, {0x9c, 0x62, 0xeb, 0xb8, 0x26, 0xdd, 0x5d, 0x07}}
 158   gConfidentialComputingSecretGuid      = {0xadf956ad, 0xe98c, 0x484c, {0xae, 0x11, 0xb5, 0x1c, 0x7d, 0x33, 0x64, 0x47}}
 159   gConfidentialComputingSevSnpBlobGuid  = {0x067b1f5f, 0xcf26, 0x44c5, {0x85, 0x54, 0x93, 0xd7, 0x77, 0x91, 0x2d, 0x42}}
 160   gUefiOvmfPkgPlatformInfoGuid          = {0xdec9b486, 0x1f16, 0x47c7, {0x8f, 0x68, 0xdf, 0x1a, 0x41, 0x88, 0x8b, 0xa5}}
 161   gVMMBootOrderGuid                     = {0x668f4529, 0x63d0, 0x4bb5, {0xb6, 0x5d, 0x6f, 0xbb, 0x9d, 0x36, 0xa4, 0x4a}}
 162   gUefiOvmfPkgTdxAcpiHobGuid            = {0x6a0c5870, 0xd4ed, 0x44f4, {0xa1, 0x35, 0xdd, 0x23, 0x8b, 0x6f, 0x0c, 0x8d}}
 163   gEfiNonCcFvGuid                       = {0xae047c6d, 0xbce9, 0x426c, {0xae, 0x03, 0xa6, 0x8e, 0x3b, 0x8a, 0x04, 0x88}}
 164   gOvmfVariableGuid                     = {0x50bea1e5, 0xa2c5, 0x46e9, {0x9b, 0x3a, 0x59, 0x59, 0x65, 0x16, 0xb0, 0x0a}}
 165
 166 [Ppis]
 167   # PPI whose presence in the PPI database signals that the TPM base address
 168   # has been discovered and recorded
 169   gOvmfTpmDiscoveredPpiGuid             = {0xb9a61ad0, 0x2802, 0x41f3, {0xb5, 0x13, 0x96, 0x51, 0xce, 0x6b, 0xd5, 0x75}}
 170
 171   # This PPI signals that accessing the MMIO range of the TPM is possible in
 172   # the PEI phase, regardless of memory encryption
 173   gOvmfTpmMmioAccessiblePpiGuid         = {0x35c84ff2, 0x7bfe, 0x453d, {0x84, 0x5f, 0x68, 0x3a, 0x49, 0x2c, 0xf7, 0xb7}}
 174
 175   gEfiPeiMpInitLibMpDepPpiGuid          = {0x138f9cf4, 0xf0e7, 0x4721, { 0x8f, 0x49, 0xf5, 0xff, 0xec, 0xf4, 0x2d, 0x40}}
 176   gEfiPeiMpInitLibUpDepPpiGuid          = {0xb590774, 0xbc67, 0x49f4, { 0xa7, 0xdb, 0xe8, 0x2e, 0x89, 0xe6, 0xb5, 0xd6}}
 177
 178 [Protocols]
 179   gVirtioDeviceProtocolGuid             = {0xfa920010, 0x6785, 0x4941, {0xb6, 0xec, 0x49, 0x8c, 0x57, 0x9f, 0x16, 0x0a}}
 180   gXenBusProtocolGuid                   = {0x3d3ca290, 0xb9a5, 0x11e3, {0xb7, 0x5d, 0xb8, 0xac, 0x6f, 0x7d, 0x65, 0xe6}}
 181   gXenIoProtocolGuid                    = {0x6efac84f, 0x0ab0, 0x4747, {0x81, 0xbe, 0x85, 0x55, 0x62, 0x59, 0x04, 0x49}}
 182   gIoMmuAbsentProtocolGuid              = {0xf8775d50, 0x8abd, 0x4adf, {0x92, 0xac, 0x85, 0x3e, 0x51, 0xf6, 0xc8, 0xdc}}
 183   gEfiLegacy8259ProtocolGuid            = {0x38321dba, 0x4fe0, 0x4e17, {0x8a, 0xec, 0x41, 0x30, 0x55, 0xea, 0xed, 0xc1}}
 184   gEfiFirmwareVolumeProtocolGuid        = {0x389F751F, 0x1838, 0x4388, {0x83, 0x90, 0xcd, 0x81, 0x54, 0xbd, 0x27, 0xf8}}
 185   gEfiIsaAcpiProtocolGuid               = {0x64a892dc, 0x5561, 0x4536, {0x92, 0xc7, 0x79, 0x9b, 0xfc, 0x18, 0x33, 0x55}}
 186   gEfiIsaIoProtocolGuid                 = {0x7ee2bd44, 0x3da0, 0x11d4, {0x9a, 0x38, 0x0, 0x90, 0x27, 0x3f, 0xc1, 0x4d}}
 187   gEfiLegacyBiosProtocolGuid            = {0xdb9a1e3d, 0x45cb, 0x4abb, {0x85, 0x3b, 0xe5, 0x38, 0x7f, 0xdb, 0x2e, 0x2d}}
 188   gEfiLegacyBiosPlatformProtocolGuid    = {0x783658a3, 0x4172, 0x4421, {0xa2, 0x99, 0xe0, 0x09, 0x07, 0x9c, 0x0c, 0xb4}}
 189   gEfiLegacyInterruptProtocolGuid       = {0x31ce593d, 0x108a, 0x485d, {0xad, 0xb2, 0x78, 0xf2, 0x1f, 0x29, 0x66, 0xbe}}
 190   gEfiVgaMiniPortProtocolGuid           = {0xc7735a2f, 0x88f5, 0x4882, {0xae, 0x63, 0xfa, 0xac, 0x8c, 0x8b, 0x86, 0xb3}}
 191   gOvmfLoadedX86LinuxKernelProtocolGuid = {0xa3edc05d, 0xb618, 0x4ff6, {0x95, 0x52, 0x76, 0xd7, 0x88, 0x63, 0x43, 0xc8}}
 192   gOvmfSevMemoryAcceptanceProtocolGuid  = {0xc5a010fe, 0x38a7, 0x4531, {0x8a, 0x4a, 0x05, 0x00, 0xd2, 0xfd, 0x16, 0x49}}
 193   gQemuAcpiTableNotifyProtocolGuid      = {0x928939b2, 0x4235, 0x462f, {0x95, 0x80, 0xf6, 0xa2, 0xb2, 0xc2, 0x1a, 0x4f}}
 194   gEfiMpInitLibMpDepProtocolGuid        = {0xbb00a5ca, 0x8ce,  0x462f, {0xa5, 0x37, 0x43, 0xc7, 0x4a, 0x82, 0x5c, 0xa4}}
 195   gEfiMpInitLibUpDepProtocolGuid        = {0xa9e7cef1, 0x5682, 0x42cc, {0xb1, 0x23, 0x99, 0x30, 0x97, 0x3f, 0x4a, 0x9f}}
 196
 197 [PcdsFixedAtBuild]
 198   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfPeiMemFvBase|0x0|UINT32|0
 199   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfPeiMemFvSize|0x0|UINT32|1
 200   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfDxeMemFvBase|0x0|UINT32|0x15
 201   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfDxeMemFvSize|0x0|UINT32|0x16
 202   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfDxeNonCcFvBase|0x0|UINT32|0x6a
 203   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfDxeNonCcFvSize|0x0|UINT32|0x6b
 204
 205   ## This flag is used to control the destination port for PlatformDebugLibIoPort
 206   gUefiOvmfPkgTokenSpaceGuid.PcdDebugIoPort|0x402|UINT16|4
 207
 208   ## When VirtioScsiDxe is instantiated for a HBA, the numbers of targets and
 209   #  LUNs are retrieved from the host during virtio-scsi setup.
 210   #  MdeModulePkg/Bus/Scsi/ScsiBusDxe then scans all MaxTarget * MaxLun
 211   #  possible devices. This can take extremely long, for example with
 212   #  MaxTarget=255 and MaxLun=16383. The *inclusive* constants below limit
 213   #  MaxTarget and MaxLun, independently, should the host report higher values,
 214   #  so that scanning the number of devices given by their product is still
 215   #  acceptably fast.
 216   gUefiOvmfPkgTokenSpaceGuid.PcdVirtioScsiMaxTargetLimit|31|UINT16|6
 217   gUefiOvmfPkgTokenSpaceGuid.PcdVirtioScsiMaxLunLimit|7|UINT32|7
 218
 219   ## Sets the *inclusive* number of targets and LUNs that PvScsi exposes for
 220   #  scan by ScsiBusDxe.
 221   #  As specified above for VirtioScsi, ScsiBusDxe scans all MaxTarget * MaxLun
 222   #  possible devices, which can take extremely long. Thus, the below constants
 223   #  are used so that scanning the number of devices given by their product
 224   #  is still acceptably fast.
 225   gUefiOvmfPkgTokenSpaceGuid.PcdPvScsiMaxTargetLimit|64|UINT8|0x36
 226   gUefiOvmfPkgTokenSpaceGuid.PcdPvScsiMaxLunLimit|0|UINT8|0x37
 227
 228   ## After PvScsiDxe sends a SCSI request to the device, it waits for
 229   #  the request completion in a polling loop.
 230   #  This constant defines how many micro-seconds to wait between each
 231   #  polling loop iteration.
 232   gUefiOvmfPkgTokenSpaceGuid.PcdPvScsiWaitForCmpStallInUsecs|5|UINT32|0x38
 233
 234   ## Set the *inclusive* number of targets that MptScsi exposes for scan
 235   #  by ScsiBusDxe.
 236   gUefiOvmfPkgTokenSpaceGuid.PcdMptScsiMaxTargetLimit|7|UINT8|0x39
 237
 238   ## Microseconds to stall between polling for MptScsi request result
 239   gUefiOvmfPkgTokenSpaceGuid.PcdMptScsiStallPerPollUsec|5|UINT32|0x3a
 240
 241   ## Set the *inclusive* number of targets and LUNs that LsiScsi exposes for
 242   #  scan by ScsiBusDxe.
 243   gUefiOvmfPkgTokenSpaceGuid.PcdLsiScsiMaxTargetLimit|7|UINT8|0x3b
 244   gUefiOvmfPkgTokenSpaceGuid.PcdLsiScsiMaxLunLimit|0|UINT8|0x3c
 245
 246   ## Microseconds to stall between polling for LsiScsi request result
 247   gUefiOvmfPkgTokenSpaceGuid.PcdLsiScsiStallPerPollUsec|5|UINT32|0x3d
 248
 249   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfFlashNvStorageEventLogBase|0x0|UINT32|0x8
 250   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfFlashNvStorageEventLogSize|0x0|UINT32|0x9
 251   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfFirmwareFdSize|0x0|UINT32|0xa
 252   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfFirmwareBlockSize|0|UINT32|0xb
 253   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfFlashNvStorageVariableBase|0x0|UINT32|0xc
 254   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfFlashNvStorageFtwSpareBase|0x0|UINT32|0xd
 255   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfFlashNvStorageFtwWorkingBase|0x0|UINT32|0xe
 256   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfFdBaseAddress|0x0|UINT32|0xf
 257   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfSecPageTablesBase|0x0|UINT32|0x11
 258   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfSecPageTablesSize|0x0|UINT32|0x12
 259   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfSecPeiTempRamBase|0x0|UINT32|0x13
 260   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfSecPeiTempRamSize|0x0|UINT32|0x14
 261   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfLockBoxStorageBase|0x0|UINT32|0x18
 262   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfLockBoxStorageSize|0x0|UINT32|0x19
 263   gUefiOvmfPkgTokenSpaceGuid.PcdGuidedExtractHandlerTableSize|0x0|UINT32|0x1a
 264   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfDecompressionScratchEnd|0x0|UINT32|0x1f
 265
 266   ## Pcd8259LegacyModeMask defines the default mask value for platform. This
 267   #  value is determined.
 268   #  1) If platform only support pure UEFI, value should be set to 0xFFFF or
 269   #     0xFFFE; Because only clock interrupt is allowed in legacy mode in pure
 270   #     UEFI platform.
 271   #  2) If platform install CSM and use thunk module:
 272   #     a) If thunk call provided by CSM binary requires some legacy interrupt
 273   #        support, the corresponding bit should be opened as 0.
 274   #        For example, if keyboard interfaces provided CSM binary use legacy
 275   #        keyboard interrupt in 8259 bit 1, then the value should be set to
 276   #        0xFFFC.
 277   #     b) If all thunk call provied by CSM binary do not require legacy
 278   #        interrupt support, value should be set to 0xFFFF or 0xFFFE.
 279   #
 280   #  The default value of legacy mode mask could be changed by
 281   #  EFI_LEGACY_8259_PROTOCOL->SetMask(). But it is rarely need change it
 282   #  except some special cases such as when initializing the CSM binary, it
 283   #  should be set to 0xFFFF to mask all legacy interrupt. Please restore the
 284   #  original legacy mask value if changing is made for these special case.
 285   gUefiOvmfPkgTokenSpaceGuid.Pcd8259LegacyModeMask|0xFFFF|UINT16|0x3
 286
 287   ## Pcd8259LegacyModeEdgeLevel defines the default edge level for legacy
 288   #  mode's interrrupt controller.
 289   #  For the corresponding bits, 0 = Edge triggered and 1 = Level triggered.
 290   gUefiOvmfPkgTokenSpaceGuid.Pcd8259LegacyModeEdgeLevel|0x0000|UINT16|0x5
 291
 292   ## Indicates if BiosVideo driver will switch to 80x25 Text VGA Mode when
 293   #  exiting boot service.
 294   #   TRUE  - Switch to Text VGA Mode.
 295   #   FALSE - Does not switch to Text VGA Mode.
 296   gUefiOvmfPkgTokenSpaceGuid.PcdBiosVideoSetTextVgaModeEnable|FALSE|BOOLEAN|0x28
 297
 298   ## Indicates if BiosVideo driver will check for VESA BIOS Extension service
 299   #  support.
 300   #   TRUE  - Check for VESA BIOS Extension service.
 301   #   FALSE - Does not check for VESA BIOS Extension service.
 302   gUefiOvmfPkgTokenSpaceGuid.PcdBiosVideoCheckVbeEnable|TRUE|BOOLEAN|0x29
 303
 304   ## Indicates if BiosVideo driver will check for VGA service support.
 305   #  NOTE: If both PcdBiosVideoCheckVbeEnable and PcdBiosVideoCheckVgaEnable
 306   #  are set to FALSE, that means Graphics Output protocol will not be
 307   #  installed, the VGA miniport protocol will be installed instead.
 308   #   TRUE  - Check for VGA service.<BR>
 309   #   FALSE - Does not check for VGA service.<BR>
 310   gUefiOvmfPkgTokenSpaceGuid.PcdBiosVideoCheckVgaEnable|TRUE|BOOLEAN|0x2a
 311
 312   ## Indicates if memory space for legacy region will be set as cacheable.
 313   #   TRUE  - Set cachebility for legacy region.
 314   #   FALSE - Does not set cachebility for legacy region.
 315   gUefiOvmfPkgTokenSpaceGuid.PcdLegacyBiosCacheLegacyRegion|TRUE|BOOLEAN|0x2b
 316
 317   ## Specify memory size with bytes to reserve EBDA below 640K for OPROM.
 318   #  The value should be a multiple of 4KB.
 319   gUefiOvmfPkgTokenSpaceGuid.PcdEbdaReservedMemorySize|0x8000|UINT32|0x2c
 320
 321   ## Specify memory base address for OPROM to find free memory.
 322   #  Some OPROMs do not use EBDA or PMM to allocate memory for its usage,
 323   #  instead they find the memory filled with zero from 0x20000.
 324   #  The value should be a multiple of 4KB.
 325   #  The range should be below the EBDA reserved range from
 326   #  (CONVENTIONAL_MEMORY_TOP - Reserved EBDA Memory Size) to
 327   #  CONVENTIONAL_MEMORY_TOP.
 328   gUefiOvmfPkgTokenSpaceGuid.PcdOpromReservedMemoryBase|0x60000|UINT32|0x2d
 329
 330   ## Specify memory size with bytes for OPROM to find free memory.
 331   #  The value should be a multiple of 4KB. And the range should be below the
 332   #  EBDA reserved range from
 333   #  (CONVENTIONAL_MEMORY_TOP - Reserved EBDA Memory Size) to
 334   #  CONVENTIONAL_MEMORY_TOP.
 335   gUefiOvmfPkgTokenSpaceGuid.PcdOpromReservedMemorySize|0x28000|UINT32|0x2e
 336
 337   ## Specify the end of address below 1MB for the OPROM.
 338   #  The last shadowed OpROM should not exceed this address.
 339   gUefiOvmfPkgTokenSpaceGuid.PcdEndOpromShadowAddress|0xdffff|UINT32|0x2f
 340
 341   ## Specify the low PMM (Post Memory Manager) size with bytes below 1MB.
 342   #  The value should be a multiple of 4KB.
 343   # @Prompt Low PMM (Post Memory Manager) Size
 344   gUefiOvmfPkgTokenSpaceGuid.PcdLowPmmMemorySize|0x10000|UINT32|0x30
 345
 346   ## Specify the high PMM (Post Memory Manager) size with bytes above 1MB.
 347   #  The value should be a multiple of 4KB.
 348   gUefiOvmfPkgTokenSpaceGuid.PcdHighPmmMemorySize|0x400000|UINT32|0x31
 349
 350   gUefiOvmfPkgTokenSpaceGuid.PcdXenPvhStartOfDayStructPtr|0x0|UINT32|0x17
 351   gUefiOvmfPkgTokenSpaceGuid.PcdXenPvhStartOfDayStructPtrSize|0x0|UINT32|0x32
 352
 353   ## Number of page frames to use for storing grant table entries.
 354   gUefiOvmfPkgTokenSpaceGuid.PcdXenGrantFrames|4|UINT32|0x33
 355
 356   ## Specify the extra page table needed to mark the GHCB as unencrypted.
 357   #  The value should be a multiple of 4KB for each.
 358   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfSecGhcbPageTableBase|0x0|UINT32|0x3e
 359   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfSecGhcbPageTableSize|0x0|UINT32|0x3f
 360
 361   ## The base address of the SEC GHCB page used by SEV-ES.
 362   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfSecGhcbBase|0|UINT32|0x40
 363   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfSecGhcbSize|0|UINT32|0x41
 364   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfSecGhcbBackupBase|0|UINT32|0x44
 365   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfSecGhcbBackupSize|0|UINT32|0x45
 366
 367   ## The base address and size of the SEV Launch Secret Area provisioned
 368   #  after remote attestation.  If this is set in the .fdf, the platform
 369   #  is responsible for protecting the area from DXE phase overwrites.
 370   gUefiOvmfPkgTokenSpaceGuid.PcdSevLaunchSecretBase|0x0|UINT32|0x42
 371   gUefiOvmfPkgTokenSpaceGuid.PcdSevLaunchSecretSize|0x0|UINT32|0x43
 372
 373   ## The base address and size of a hash table confirming allowed
 374   #  parameters to be passed in via the Qemu firmware configuration
 375   #  device
 376   gUefiOvmfPkgTokenSpaceGuid.PcdQemuHashTableBase|0x0|UINT32|0x47
 377   gUefiOvmfPkgTokenSpaceGuid.PcdQemuHashTableSize|0x0|UINT32|0x48
 378
 379   ## The base address and size of the work area used during the SEC
 380   # phase by the SEV and TDX supports.
 381   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfWorkAreaBase|0|UINT32|0x49
 382   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfWorkAreaSize|0|UINT32|0x50
 383
 384   ## The work area contains a fixed size header in the Include/WorkArea.h.
 385   # The size of this header is used early boot, and is provided through
 386   # a fixed PCD. It need to be kept in sync with any changes to the
 387   # header definition.
 388   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfConfidentialComputingWorkAreaHeader|4|UINT32|0x51
 389
 390   ## The base address and size of the TDX Cfv base and size.
 391   gUefiOvmfPkgTokenSpaceGuid.PcdCfvBase|0|UINT32|0x52
 392   gUefiOvmfPkgTokenSpaceGuid.PcdCfvRawDataOffset|0|UINT32|0x53
 393   gUefiOvmfPkgTokenSpaceGuid.PcdCfvRawDataSize|0|UINT32|0x54
 394
 395   ## The base address and size of the TDX Bfv base and size.
 396   gUefiOvmfPkgTokenSpaceGuid.PcdBfvBase|0|UINT32|0x55
 397   gUefiOvmfPkgTokenSpaceGuid.PcdBfvRawDataOffset|0|UINT32|0x56
 398   gUefiOvmfPkgTokenSpaceGuid.PcdBfvRawDataSize|0|UINT32|0x57
 399
 400   ## The base address and size of the SEV-SNP Secrets Area that contains
 401   #  the VM platform communication key used to send and recieve the
 402   #  messages to the PSP. If this is set in the .fdf, the platform
 403   #  is responsible to reserve this area from DXE phase overwrites.
 404   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfSnpSecretsBase|0|UINT32|0x58
 405   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfSnpSecretsSize|0|UINT32|0x59
 406
 407   ## The base address and size of a CPUID Area that contains the hypervisor
 408   #  provided CPUID results. In the case of SEV-SNP, the CPUID results are
 409   #  filtered by the SEV-SNP firmware. If this is set in the .fdf, the
 410   #  platform is responsible to reserve this area from DXE phase overwrites.
 411   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfCpuidBase|0|UINT32|0x60
 412   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfCpuidSize|0|UINT32|0x61
 413
 414   ## The range of memory that is validated by the SEC phase.
 415   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfSecValidatedStart|0|UINT32|0x62
 416   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfSecValidatedEnd|0|UINT32|0x63
 417
 418   ## The Tdx accept page size. 0x1000(4k),0x200000(2M)
 419   gUefiOvmfPkgTokenSpaceGuid.PcdTdxAcceptPageSize|0x200000|UINT32|0x65
 420
 421   ## The QEMU fw_cfg variable that UefiDriverEntryPointFwCfgOverrideLib will
 422   #  check to decide whether to abort dispatch of the driver it is linked into.
 423   gUefiOvmfPkgTokenSpaceGuid.PcdEntryPointOverrideFwCfgVarName|""|VOID*|0x68
 424
 425 [PcdsDynamic, PcdsDynamicEx]
 426   gUefiOvmfPkgTokenSpaceGuid.PcdEmuVariableEvent|0|UINT64|2
 427   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfFlashVariablesEnable|FALSE|BOOLEAN|0x10
 428   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfHostBridgePciDevId|0|UINT16|0x1b
 429   gUefiOvmfPkgTokenSpaceGuid.PcdQemuSmbiosValidated|FALSE|BOOLEAN|0x21
 430
 431   ## The IO port aperture shared by all PCI root bridges.
 432   #
 433   gUefiOvmfPkgTokenSpaceGuid.PcdPciIoBase|0x0|UINT64|0x22
 434   gUefiOvmfPkgTokenSpaceGuid.PcdPciIoSize|0x0|UINT64|0x23
 435
 436   ## The 32-bit MMIO aperture shared by all PCI root bridges.
 437   #
 438   gUefiOvmfPkgTokenSpaceGuid.PcdPciMmio32Base|0x0|UINT64|0x24
 439   gUefiOvmfPkgTokenSpaceGuid.PcdPciMmio32Size|0x0|UINT64|0x25
 440
 441   ## The 64-bit MMIO aperture shared by all PCI root bridges.
 442   #
 443   gUefiOvmfPkgTokenSpaceGuid.PcdPciMmio64Base|0x0|UINT64|0x26
 444   gUefiOvmfPkgTokenSpaceGuid.PcdPciMmio64Size|0x0|UINT64|0x27
 445
 446   ## The following setting controls how many megabytes we configure as TSEG on
 447   #  Q35, for SMRAM purposes. Permitted defaults are: 1, 2, 8. Other defaults
 448   #  cause undefined behavior. During boot, the PCD is updated by PlatformPei
 449   #  to reflect the extended TSEG size, if one is advertized by QEMU.
 450   #
 451   #  This PCD is only accessed if PcdSmmSmramRequire is TRUE (see below).
 452   gUefiOvmfPkgTokenSpaceGuid.PcdQ35TsegMbytes|8|UINT16|0x20
 453
 454   ## Set to TRUE by PlatformPei if the Q35 board supports the "SMRAM at default
 455   #  SMBASE" feature.
 456   #
 457   #  This PCD is only accessed if PcdSmmSmramRequire is TRUE (see below).
 458   gUefiOvmfPkgTokenSpaceGuid.PcdQ35SmramAtDefaultSmbase|FALSE|BOOLEAN|0x34
 459
 460   ## This PCD adds a communication channel between OVMF's SmmCpuFeaturesLib
 461   #  instance in PiSmmCpuDxeSmm, and CpuHotplugSmm.
 462   gUefiOvmfPkgTokenSpaceGuid.PcdCpuHotEjectDataAddress|0|UINT64|0x46
 463
 464   ## This PCD tracks where PcdVideo{Horizontal,Vertical}Resolution
 465   #  values are coming from.
 466   #    0 - unset (defaults from platform dsc)
 467   #    1 - set from PlatformConfig
 468   #    2 - set by GOP Driver.
 469   gUefiOvmfPkgTokenSpaceGuid.PcdVideoResolutionSource|0|UINT8|0x64
 470
 471   #
 472   # Whether to force disable ACPI, regardless of the fw_cfg settings
 473   # exposed by QEMU
 474   #
 475   gUefiOvmfPkgTokenSpaceGuid.PcdForceNoAcpi|0x0|BOOLEAN|0x69
 476
 477 [PcdsFeatureFlag]
 478   gUefiOvmfPkgTokenSpaceGuid.PcdQemuBootOrderPciTranslation|TRUE|BOOLEAN|0x1c
 479   gUefiOvmfPkgTokenSpaceGuid.PcdQemuBootOrderMmioTranslation|FALSE|BOOLEAN|0x1d
 480
 481   ## This feature flag enables SMM/SMRAM support. Note that it also requires
 482   #  such support from the underlying QEMU instance; if that support is not
 483   #  present, the firmware will reject continuing after a certain point.
 484   #
 485   #  The flag also acts as a general "security switch"; when TRUE, many
 486   #  components will change behavior, with the goal of preventing a malicious
 487   #  runtime OS from tampering with firmware structures (special memory ranges
 488   #  used by OVMF, the varstore pflash chip, LockBox etc).
 489   gUefiOvmfPkgTokenSpaceGuid.PcdSmmSmramRequire|FALSE|BOOLEAN|0x1e
 490
 491   ## Informs modules (including pre-DXE-phase modules) whether the platform
 492   #  firmware contains a CSM (Compatibility Support Module).
 493   #
 494   gUefiOvmfPkgTokenSpaceGuid.PcdCsmEnable|FALSE|BOOLEAN|0x35