ArmVirtPkg/ArmVirtPkg.dec

   1 #/** @file
   2 #
   3 #  Copyright (c) 2014, Linaro Limited. All rights reserved.
   4 #
   5 #  This program and the accompanying materials
   6 #  are licensed and made available under the terms and conditions of the BSD License
   7 #  which accompanies this distribution.  The full text of the license may be found at
   8 #  http://opensource.org/licenses/bsd-license.php
   9 #
  10 #  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  11 #  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  12 #
  13 #**/
  14
  15 [Defines]
  16   DEC_SPECIFICATION              = 0x00010005
  17   PACKAGE_NAME                   = ArmVirtPkg
  18   PACKAGE_GUID                   = A0B31216-508E-4025-BEAB-56D836C66F0A
  19   PACKAGE_VERSION                = 0.1
  20
  21 ################################################################################
  22 #
  23 # Include Section - list of Include Paths that are provided by this package.
  24 #                   Comments are used for Keywords and Module Types.
  25 #
  26 # Supported Module Types:
  27 #  BASE SEC PEI_CORE PEIM DXE_CORE DXE_DRIVER DXE_RUNTIME_DRIVER DXE_SMM_DRIVER DXE_SAL_DRIVER UEFI_DRIVER UEFI_APPLICATION
  28 #
  29 ################################################################################
  30 [Includes.common]
  31   Include                        # Root include for the package
  32
  33 [Guids.common]
  34   gArmVirtTokenSpaceGuid = { 0x0B6F5CA7, 0x4F53, 0x445A, { 0xB7, 0x6E, 0x2E, 0x36, 0x5B, 0x80, 0x63, 0x66 } }
  35   gEarlyPL011BaseAddressGuid       = { 0xB199DEA9, 0xFD5C, 0x4A84, { 0x80, 0x82, 0x2F, 0x41, 0x70, 0x78, 0x03, 0x05 } }
  36
  37 [Protocols]
  38   gFdtClientProtocolGuid = { 0xE11FACA0, 0x4710, 0x4C8E, { 0xA7, 0xA2, 0x01, 0xBA, 0xA2, 0x59, 0x1B, 0x4C } }
  39
  40 [PcdsFixedAtBuild, PcdsPatchableInModule]
  41   #
  42   # This is the physical address where the device tree is expected to be stored
  43   # upon first entry into UEFI. This needs to be a FixedAtBuild PCD, so that we
  44   # can do a first pass over the device tree in the SEC phase to discover the
  45   # UART base address.
  46   #
  47   gArmVirtTokenSpaceGuid.PcdDeviceTreeInitialBaseAddress|0x0|UINT64|0x00000001
  48
  49   #
  50   # Padding in bytes to add to the device tree allocation, so that the DTB can
  51   # be modified in place (default: 256 bytes)
  52   #
  53   gArmVirtTokenSpaceGuid.PcdDeviceTreeAllocationPadding|256|UINT32|0x00000002
  54
  55   #
  56   # Binary representation of the GUID that determines the terminal type. The
  57   # size must be exactly 16 bytes. The default value corresponds to
  58   # EFI_VT_100_GUID.
  59   #
  60   gArmVirtTokenSpaceGuid.PcdTerminalTypeGuidBuffer|{0x65, 0x60, 0xA6, 0xDF, 0x19, 0xB4, 0xD3, 0x11, 0x9A, 0x2D, 0x00, 0x90, 0x27, 0x3F, 0xC1, 0x4D}|VOID*|0x00000007
  61
  62 [PcdsDynamic, PcdsFixedAtBuild]
  63   #
  64   # ARM PSCI function invocations can be done either through hypervisor
  65   # calls (HVC) or secure monitor calls (SMC).
  66   # PcdArmPsciMethod == 1 : use HVC
  67   # PcdArmPsciMethod == 2 : use SMC
  68   #
  69   gArmVirtTokenSpaceGuid.PcdArmPsciMethod|0|UINT32|0x00000003
  70
  71   gArmVirtTokenSpaceGuid.PcdFwCfgSelectorAddress|0x0|UINT64|0x00000004
  72   gArmVirtTokenSpaceGuid.PcdFwCfgDataAddress|0x0|UINT64|0x00000005
  73   gArmVirtTokenSpaceGuid.PcdFwCfgDmaAddress|0x0|UINT64|0x00000009
  74
  75 [PcdsFeatureFlag]
  76   #
  77   # "Map PCI MMIO as Cached"
  78   #
  79   # Due to the way Stage1 and Stage2 mappings are combined on Aarch64, and
  80   # because KVM -- for the time being -- does not try to interfere with the
  81   # Stage1 mappings, we must not set EFI_MEMORY_UC for emulated PCI MMIO
  82   # regions.
  83   #
  84   # EFI_MEMORY_UC is mapped to Device-nGnRnE, and that Stage1 attribute would
  85   # direct guest writes to host DRAM immediately, bypassing the cache
  86   # regardless of Stage2 attributes. However, QEMU's reads of the same range
  87   # can easily be served from the (stale) CPU cache.
  88   #
  89   # Setting this PCD to TRUE will use EFI_MEMORY_WB for mapping PCI MMIO
  90   # regions, which ensures that guest writes to such regions go through the CPU
  91   # cache. Strictly speaking this is wrong, but it is needed as a temporary
  92   # workaround for emulated PCI devices. Setting the PCD to FALSE results in
  93   # the theoretically correct EFI_MEMORY_UC mapping, and should be the long
  94   # term choice, especially with assigned devices.
  95   #
  96   # The default is to turn off the kludge; DSC's can selectively enable it.
  97   #
  98   gArmVirtTokenSpaceGuid.PcdKludgeMapPciMmioAsCached|FALSE|BOOLEAN|0x00000006
  99
 100   #
 101   # Pure ACPI boot
 102   #
 103   # Inhibit installation of the FDT as a configuration table if this feature
 104   # PCD is TRUE. Otherwise, the OS is presented with both a DT and an ACPI
 105   # description of the platform, and it is up to the OS to choose.
 106   #
 107   gArmVirtTokenSpaceGuid.PcdPureAcpiBoot|FALSE|BOOLEAN|0x0000000a