OvmfPkg/OvmfPkg.dec

   1 ## @file
   2 #  EFI/Framework Open Virtual Machine Firmware (OVMF) platform
   3 #
   4 #  Copyright (c) 2006 - 2013, Intel Corporation. All rights reserved.<BR>
   5 #
   6 #  This program and the accompanying materials
   7 #  are licensed and made available under the terms and conditions of the BSD License
   8 #  which accompanies this distribution. The full text of the license may be found at
   9 #  http://opensource.org/licenses/bsd-license.php
  10 #
  11 #  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  12 #  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  13 #
  14 ##
  15
  16 [Defines]
  17   DEC_SPECIFICATION              = 0x00010005
  18   PACKAGE_NAME                   = OvmfPkg
  19   PACKAGE_GUID                   = 2daf5f34-50e5-4b9d-b8e3-5562334d87e5
  20   PACKAGE_VERSION                = 0.1
  21
  22 [Includes]
  23   Include
  24
  25 [LibraryClasses]
  26   ##  @libraryclass  Loads and boots a Linux kernel image
  27   #
  28   LoadLinuxLib|Include/Library/LoadLinuxLib.h
  29
  30   ##  @libraryclass  Save and restore variables using a file
  31   #
  32   NvVarsFileLib|Include/Library/NvVarsFileLib.h
  33
  34   ##  @libraryclass  Provides services to work with PCI capabilities in PCI
  35   #                  config space.
  36   PciCapLib|Include/Library/PciCapLib.h
  37
  38   ##  @libraryclass  Layered on top of PciCapLib, allows clients to plug an
  39   #                  EFI_PCI_IO_PROTOCOL backend into PciCapLib, for config
  40   #                  space access.
  41   PciCapPciIoLib|Include/Library/PciCapPciIoLib.h
  42
  43   ##  @libraryclass  Layered on top of PciCapLib, allows clients to plug a
  44   #                  PciSegmentLib backend into PciCapLib, for config space
  45   #                  access.
  46   PciCapPciSegmentLib|Include/Library/PciCapPciSegmentLib.h
  47
  48   ##  @libraryclass  Access QEMU's firmware configuration interface
  49   #
  50   QemuFwCfgLib|Include/Library/QemuFwCfgLib.h
  51
  52   ##  @libraryclass  S3 support for QEMU fw_cfg
  53   #
  54   QemuFwCfgS3Lib|Include/Library/QemuFwCfgS3Lib.h
  55
  56   ##  @libraryclass  Rewrite the BootOrder NvVar based on QEMU's "bootorder"
  57   #                  fw_cfg file.
  58   #
  59   QemuBootOrderLib|Include/Library/QemuBootOrderLib.h
  60
  61   ##  @libraryclass  Serialize (and deserialize) variables
  62   #
  63   SerializeVariablesLib|Include/Library/SerializeVariablesLib.h
  64
  65   ##  @libraryclass  Invoke Xen hypercalls
  66   #
  67   XenHypercallLib|Include/Library/XenHypercallLib.h
  68
  69   ##  @libraryclass  Manage XenBus device path and I/O handles
  70   #
  71   XenIoMmioLib|Include/Library/XenIoMmioLib.h
  72
  73 [Guids]
  74   gUefiOvmfPkgTokenSpaceGuid          = {0x93bb96af, 0xb9f2, 0x4eb8, {0x94, 0x62, 0xe0, 0xba, 0x74, 0x56, 0x42, 0x36}}
  75   gEfiXenInfoGuid                     = {0xd3b46f3b, 0xd441, 0x1244, {0x9a, 0x12, 0x0, 0x12, 0x27, 0x3f, 0xc1, 0x4d}}
  76   gOvmfPlatformConfigGuid             = {0x7235c51c, 0x0c80, 0x4cab, {0x87, 0xac, 0x3b, 0x08, 0x4a, 0x63, 0x04, 0xb1}}
  77   gVirtioMmioTransportGuid            = {0x837dca9e, 0xe874, 0x4d82, {0xb2, 0x9a, 0x23, 0xfe, 0x0e, 0x23, 0xd1, 0xe2}}
  78   gQemuRamfbGuid                      = {0x557423a1, 0x63ab, 0x406c, {0xbe, 0x7e, 0x91, 0xcd, 0xbc, 0x08, 0xc4, 0x57}}
  79   gXenBusRootDeviceGuid               = {0xa732241f, 0x383d, 0x4d9c, {0x8a, 0xe1, 0x8e, 0x09, 0x83, 0x75, 0x89, 0xd7}}
  80   gRootBridgesConnectedEventGroupGuid = {0x24a2d66f, 0xeedd, 0x4086, {0x90, 0x42, 0xf2, 0x6e, 0x47, 0x97, 0xee, 0x69}}
  81
  82 [Protocols]
  83   gVirtioDeviceProtocolGuid           = {0xfa920010, 0x6785, 0x4941, {0xb6, 0xec, 0x49, 0x8c, 0x57, 0x9f, 0x16, 0x0a}}
  84   gXenBusProtocolGuid                 = {0x3d3ca290, 0xb9a5, 0x11e3, {0xb7, 0x5d, 0xb8, 0xac, 0x6f, 0x7d, 0x65, 0xe6}}
  85   gXenIoProtocolGuid                  = {0x6efac84f, 0x0ab0, 0x4747, {0x81, 0xbe, 0x85, 0x55, 0x62, 0x59, 0x04, 0x49}}
  86   gIoMmuAbsentProtocolGuid            = {0xf8775d50, 0x8abd, 0x4adf, {0x92, 0xac, 0x85, 0x3e, 0x51, 0xf6, 0xc8, 0xdc}}
  87
  88 [PcdsFixedAtBuild]
  89   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfPeiMemFvBase|0x0|UINT32|0
  90   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfPeiMemFvSize|0x0|UINT32|1
  91   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfDxeMemFvBase|0x0|UINT32|0x15
  92   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfDxeMemFvSize|0x0|UINT32|0x16
  93
  94   ## This flag is used to control the destination port for PlatformDebugLibIoPort
  95   gUefiOvmfPkgTokenSpaceGuid.PcdDebugIoPort|0x402|UINT16|4
  96
  97   ## When VirtioScsiDxe is instantiated for a HBA, the numbers of targets and
  98   #  LUNs are retrieved from the host during virtio-scsi setup.
  99   #  MdeModulePkg/Bus/Scsi/ScsiBusDxe then scans all MaxTarget * MaxLun
 100   #  possible devices. This can take extremely long, for example with
 101   #  MaxTarget=255 and MaxLun=16383. The *inclusive* constants below limit
 102   #  MaxTarget and MaxLun, independently, should the host report higher values,
 103   #  so that scanning the number of devices given by their product is still
 104   #  acceptably fast.
 105   gUefiOvmfPkgTokenSpaceGuid.PcdVirtioScsiMaxTargetLimit|31|UINT16|6
 106   gUefiOvmfPkgTokenSpaceGuid.PcdVirtioScsiMaxLunLimit|7|UINT32|7
 107
 108   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfFlashNvStorageEventLogBase|0x0|UINT32|0x8
 109   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfFlashNvStorageEventLogSize|0x0|UINT32|0x9
 110   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfFirmwareFdSize|0x0|UINT32|0xa
 111   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfFirmwareBlockSize|0|UINT32|0xb
 112   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfFlashNvStorageVariableBase|0x0|UINT32|0xc
 113   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfFlashNvStorageFtwSpareBase|0x0|UINT32|0xd
 114   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfFlashNvStorageFtwWorkingBase|0x0|UINT32|0xe
 115   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfFdBaseAddress|0x0|UINT32|0xf
 116   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfSecPageTablesBase|0x0|UINT32|0x11
 117   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfSecPageTablesSize|0x0|UINT32|0x12
 118   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfSecPeiTempRamBase|0x0|UINT32|0x13
 119   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfSecPeiTempRamSize|0x0|UINT32|0x14
 120   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfLockBoxStorageBase|0x0|UINT32|0x18
 121   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfLockBoxStorageSize|0x0|UINT32|0x19
 122   gUefiOvmfPkgTokenSpaceGuid.PcdGuidedExtractHandlerTableSize|0x0|UINT32|0x1a
 123   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfDecompressionScratchEnd|0x0|UINT32|0x1f
 124
 125 [PcdsDynamic, PcdsDynamicEx]
 126   gUefiOvmfPkgTokenSpaceGuid.PcdEmuVariableEvent|0|UINT64|2
 127   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfFlashVariablesEnable|FALSE|BOOLEAN|0x10
 128   gUefiOvmfPkgTokenSpaceGuid.PcdOvmfHostBridgePciDevId|0|UINT16|0x1b
 129   gUefiOvmfPkgTokenSpaceGuid.PcdQemuSmbiosValidated|FALSE|BOOLEAN|0x21
 130
 131   ## The IO port aperture shared by all PCI root bridges.
 132   #
 133   gUefiOvmfPkgTokenSpaceGuid.PcdPciIoBase|0x0|UINT64|0x22
 134   gUefiOvmfPkgTokenSpaceGuid.PcdPciIoSize|0x0|UINT64|0x23
 135
 136   ## The 32-bit MMIO aperture shared by all PCI root bridges.
 137   #
 138   gUefiOvmfPkgTokenSpaceGuid.PcdPciMmio32Base|0x0|UINT64|0x24
 139   gUefiOvmfPkgTokenSpaceGuid.PcdPciMmio32Size|0x0|UINT64|0x25
 140
 141   ## The 64-bit MMIO aperture shared by all PCI root bridges.
 142   #
 143   gUefiOvmfPkgTokenSpaceGuid.PcdPciMmio64Base|0x0|UINT64|0x26
 144   gUefiOvmfPkgTokenSpaceGuid.PcdPciMmio64Size|0x0|UINT64|0x27
 145
 146   ## The following setting controls how many megabytes we configure as TSEG on
 147   #  Q35, for SMRAM purposes. Permitted defaults are: 1, 2, 8. Other defaults
 148   #  cause undefined behavior. During boot, the PCD is updated by PlatformPei
 149   #  to reflect the extended TSEG size, if one is advertized by QEMU.
 150   #
 151   #  This PCD is only accessed if PcdSmmSmramRequire is TRUE (see below).
 152   gUefiOvmfPkgTokenSpaceGuid.PcdQ35TsegMbytes|8|UINT16|0x20
 153
 154 [PcdsFeatureFlag]
 155   gUefiOvmfPkgTokenSpaceGuid.PcdQemuBootOrderPciTranslation|TRUE|BOOLEAN|0x1c
 156   gUefiOvmfPkgTokenSpaceGuid.PcdQemuBootOrderMmioTranslation|FALSE|BOOLEAN|0x1d
 157
 158   ## This feature flag enables SMM/SMRAM support. Note that it also requires
 159   #  such support from the underlying QEMU instance; if that support is not
 160   #  present, the firmware will reject continuing after a certain point.
 161   #
 162   #  The flag also acts as a general "security switch"; when TRUE, many
 163   #  components will change behavior, with the goal of preventing a malicious
 164   #  runtime OS from tampering with firmware structures (special memory ranges
 165   #  used by OVMF, the varstore pflash chip, LockBox etc).
 166   gUefiOvmfPkgTokenSpaceGuid.PcdSmmSmramRequire|FALSE|BOOLEAN|0x1e