]> git.proxmox.com Git - mirror_edk2.git/blobdiff - UefiCpuPkg/UefiCpuPkg.dec
UefiCpuPkg/UefiCpuPkg.dec: Add a set of CPU features PCDs
[mirror_edk2.git] / UefiCpuPkg / UefiCpuPkg.dec
index 53f1726664c36a8431e23e3a7f2146de8ece4e96..c4b43e2300471e225593c7e31cdcb9fc155a24a6 100644 (file)
@@ -1,8 +1,7 @@
 ## @file  UefiCpuPkg.dec\r
-#\r
 # This Package provides UEFI compatible CPU modules and libraries.\r
 #\r
-# Copyright (c) 2007 - 2014, Intel Corporation. All rights reserved.<BR>\r
+# Copyright (c) 2007 - 2017, Intel Corporation. All rights reserved.<BR>\r
 #\r
 # This program and the accompanying materials are licensed and made available under\r
 # the terms and conditions of the BSD License which accompanies this distribution.\r
@@ -17,6 +16,7 @@
 [Defines]\r
   DEC_SPECIFICATION              = 0x00010005\r
   PACKAGE_NAME                   = UefiCpuPkg\r
+  PACKAGE_UNI_FILE               = UefiCpuPkg.uni\r
   PACKAGE_GUID                   = 2171df9b-0d39-45aa-ac37-2de190010d23\r
   PACKAGE_VERSION                = 0.3\r
 \r
   ##  @libraryclass  Provides functions to manage the Local APIC on IA32 and X64 CPUs.\r
   ##\r
   LocalApicLib|Include/Library/LocalApicLib.h\r
-  \r
+\r
+  ##  @libraryclass  Provides platform specific initialization functions in the SEC phase.\r
+  ##\r
+  PlatformSecLib|Include/Library/PlatformSecLib.h\r
+\r
+  ##  @libraryclass  Public include file for the SMM CPU Platform Hook Library.\r
+  ##\r
+  SmmCpuPlatformHookLib|Include/Library/SmmCpuPlatformHookLib.h\r
+\r
+  ##  @libraryclass  Provides the CPU specific programming for PiSmmCpuDxeSmm module.\r
+  ##\r
+  SmmCpuFeaturesLib|Include/Library/SmmCpuFeaturesLib.h\r
+\r
+  ##  @libraryclass  Provides functions to support MP services on CpuMpPei and CpuDxe module.\r
+  ##\r
+  MpInitLib|Include/Library/MpInitLib.h\r
+\r
+  ## @libraryclass  Provides services to access Microcode region on flash device.\r
+  #\r
+  MicrocodeFlashAccessLib|Include/Library/MicrocodeFlashAccessLib.h\r
+\r
 [Guids]\r
   gUefiCpuPkgTokenSpaceGuid      = { 0xac05bf33, 0x995a, 0x4ed4, { 0xaa, 0xb8, 0xef, 0x7a, 0xe8, 0xf, 0x5c, 0xb0 }}\r
+  gMsegSmramGuid                 = { 0x5802bce4, 0xeeee, 0x4e33, { 0xa1, 0x30, 0xeb, 0xad, 0x27, 0xf0, 0xe4, 0x39 }}\r
+\r
+  ## Include/Guid/MicrocodeFmp.h\r
+  gMicrocodeFmpImageTypeIdGuid      = { 0x96d4fdcd, 0x1502, 0x424d, { 0x9d, 0x4c, 0x9b, 0x12, 0xd2, 0xdc, 0xae, 0x5c } }\r
+\r
+[Protocols]\r
+  ## Include/Protocol/SmmCpuService.h\r
+  gEfiSmmCpuServiceProtocolGuid  = { 0x1d202cab, 0xc8ab, 0x4d5c, { 0x94, 0xf7, 0x3c, 0xfc, 0xc0, 0xd3, 0xd3, 0x35 }}\r
+\r
+  ## Include/Protocol/SmMonitorInit.h\r
+  gEfiSmMonitorInitProtocolGuid  = { 0x228f344d, 0xb3de, 0x43bb, { 0xa4, 0xd7, 0xea, 0x20, 0xb, 0x1b, 0x14, 0x82 }}\r
+\r
+#\r
+# [Error.gUefiCpuPkgTokenSpaceGuid]\r
+#   0x80000001 | Invalid value provided.\r
+#\r
+\r
+[PcdsFeatureFlag]\r
+  ## Indicates if SMM Profile will be enabled.\r
+  #  If enabled, instruction executions in and data accesses to memory outside of SMRAM will be logged.\r
+  #  This PCD is only for validation purpose. It should be set to false in production.<BR><BR>\r
+  #   TRUE  - SMM Profile will be enabled.<BR>\r
+  #   FALSE - SMM Profile will be disabled.<BR>\r
+  # @Prompt Enable SMM Profile.\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmProfileEnable|FALSE|BOOLEAN|0x32132109\r
+\r
+  ## Indicates if the SMM profile log buffer is a ring buffer.\r
+  #  If disabled, no additional log can be done when the buffer is full.<BR><BR>\r
+  #   TRUE  - the SMM profile log buffer is a ring buffer.<BR>\r
+  #   FALSE - the SMM profile log buffer is a normal buffer.<BR>\r
+  # @Prompt The SMM profile log buffer is a ring buffer.\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmProfileRingBuffer|FALSE|BOOLEAN|0x3213210a\r
+\r
+  ## Indicates if SMM Startup AP in a blocking fashion.\r
+  #   TRUE  - SMM Startup AP in a blocking fashion.<BR>\r
+  #   FALSE - SMM Startup AP in a non-blocking fashion.<BR>\r
+  # @Prompt SMM Startup AP in a blocking fashion.\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmBlockStartupThisAp|FALSE|BOOLEAN|0x32132108\r
+\r
+  ## Indicates if SMM Stack Guard will be enabled.\r
+  #  If enabled, stack overflow in SMM can be caught, preventing chaotic consequences.<BR><BR>\r
+  #   TRUE  - SMM Stack Guard will be enabled.<BR>\r
+  #   FALSE - SMM Stack Guard will be disabled.<BR>\r
+  # @Prompt Enable SMM Stack Guard.\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmStackGuard|TRUE|BOOLEAN|0x1000001C\r
+\r
+  ## Indicates if BSP election in SMM will be enabled.\r
+  #  If enabled, a BSP will be dynamically elected among all processors in each SMI.\r
+  #  Otherwise, processor 0 is always as BSP in each SMI.<BR><BR>\r
+  #   TRUE  - BSP election in SMM will be enabled.<BR>\r
+  #   FALSE - BSP election in SMM will be disabled.<BR>\r
+  # @Prompt Enable BSP election in SMM.\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmEnableBspElection|TRUE|BOOLEAN|0x32132106\r
+\r
+  ## Indicates if CPU SMM hot-plug will be enabled.<BR><BR>\r
+  #   TRUE  - SMM CPU hot-plug will be enabled.<BR>\r
+  #   FALSE - SMM CPU hot-plug will be disabled.<BR>\r
+  # @Prompt SMM CPU hot-plug.\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuHotPlugSupport|FALSE|BOOLEAN|0x3213210C\r
+\r
+  ## Indicates if SMM Debug will be enabled.\r
+  #  If enabled, hardware breakpoints in SMRAM can be set outside of SMM mode and take effect in SMM.<BR><BR>\r
+  #   TRUE  - SMM Debug will be enabled.<BR>\r
+  #   FALSE - SMM Debug will be disabled.<BR>\r
+  # @Prompt Enable SMM Debug.\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmDebug|FALSE|BOOLEAN|0x1000001B\r
+\r
+  ## Indicates if lock SMM Feature Control MSR.<BR><BR>\r
+  #   TRUE  - SMM Feature Control MSR will be locked.<BR>\r
+  #   FALSE - SMM Feature Control MSR will not be locked.<BR>\r
+  # @Prompt Lock SMM Feature Control MSR.\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmFeatureControlMsrLock|TRUE|BOOLEAN|0x3213210B\r
 \r
 [PcdsFixedAtBuild, PcdsPatchableInModule]\r
+  ## This value is the CPU Local APIC base address, which aligns the address on a 4-KByte boundary.\r
+  # @Prompt Configure base address of CPU Local APIC\r
+  # @Expression  0x80000001 | (gUefiCpuPkgTokenSpaceGuid.PcdCpuLocalApicBaseAddress & 0xfff) == 0\r
   gUefiCpuPkgTokenSpaceGuid.PcdCpuLocalApicBaseAddress|0xfee00000|UINT32|0x00000001\r
-  ## Specifies delay value in microseconds after sending out an INIT IPI\r
+\r
+  ## Specifies delay value in microseconds after sending out an INIT IPI.\r
+  # @Prompt Configure delay value after send an INIT IPI\r
   gUefiCpuPkgTokenSpaceGuid.PcdCpuInitIpiDelayInMicroSeconds|10000|UINT32|0x30000002\r
 \r
+  ## This value specifies the Application Processor (AP) stack size, used for Mp Service, which must\r
+  ## aligns the address on a 4-KByte boundary.\r
+  # @Prompt Configure stack size for Application Processor (AP)\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuApStackSize|0x8000|UINT32|0x00000003\r
+\r
+  ## Specifies stack size in the temporary RAM. 0 means half of TemporaryRamSize.\r
+  # @Prompt Stack size in the temporary RAM.\r
+  gUefiCpuPkgTokenSpaceGuid.PcdPeiTemporaryRamStackSize|0|UINT32|0x10001003\r
+\r
+  ## Specifies buffer size in bytes to save SMM profile data. The value should be a multiple of 4KB.\r
+  # @Prompt SMM profile data buffer size.\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmProfileSize|0x200000|UINT32|0x32132107\r
+\r
+  ## Specifies stack size in bytes for each processor in SMM.\r
+  # @Prompt Processor stack size in SMM.\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmStackSize|0x2000|UINT32|0x32132105\r
+\r
+  ## Indicates if SMM Code Access Check is enabled.\r
+  #  If enabled, the SMM handler cannot execute the code outside SMM regions.\r
+  #  This PCD is suggested to TRUE in production image.<BR><BR>\r
+  #   TRUE  - SMM Code Access Check will be enabled.<BR>\r
+  #   FALSE - SMM Code Access Check will be disabled.<BR>\r
+  # @Prompt SMM Code Access Check.\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmCodeAccessCheckEnable|TRUE|BOOLEAN|0x60000013\r
+\r
+  ## Specifies the number of variable MTRRs reserved for OS use. The default number of\r
+  #  MTRRs reserved for OS use is 2.\r
+  # @Prompt Number of reserved variable MTRRs.\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuNumberOfReservedVariableMtrrs|0x2|UINT32|0x00000015\r
+\r
+  ## Specifies buffer size in bytes for STM exception stack. The value should be a multiple of 4KB.\r
+  # @Prompt STM exception stack size.\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmStmExceptionStackSize|0x1000|UINT32|0x32132111\r
+\r
+  ## Specifies buffer size in bytes of MSEG. The value should be a multiple of 4KB.\r
+  # @Prompt MSEG size.\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuMsegSize|0x200000|UINT32|0x32132112\r
+\r
+  ## Specifies the supported CPU features bit in array\r
+  # @Prompt Supported CPU features\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuFeaturesSupport|{0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF}|VOID*|0x00000016\r
+\r
+[PcdsFixedAtBuild, PcdsPatchableInModule, PcdsDynamic, PcdsDynamicEx]\r
+  ## Specifies max supported number of Logical Processors.\r
+  # @Prompt Configure max supported number of Logical Processors\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuMaxLogicalProcessorNumber|64|UINT32|0x00000002\r
+  ## Specifies timeout value in microseconds for the BSP to detect all APs for the first time.\r
+  # @Prompt Timeout for the BSP to detect all APs for the first time.\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuApInitTimeOutInMicroSeconds|50000|UINT32|0x00000004\r
+  ## Specifies the base address of the first microcode Patch in the microcode Region.\r
+  # @Prompt Microcode Region base address.\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuMicrocodePatchAddress|0x0|UINT64|0x00000005\r
+  ## Specifies the size of the microcode Region.\r
+  # @Prompt Microcode Region size.\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuMicrocodePatchRegionSize|0x0|UINT64|0x00000006\r
+  ## Specifies the AP wait loop state during POST phase.\r
+  #  The value is defined as below.<BR><BR>\r
+  #  1: Place AP in the Hlt-Loop state.<BR>\r
+  #  2: Place AP in the Mwait-Loop state.<BR>\r
+  #  3: Place AP in the Run-Loop state.<BR>\r
+  # @Prompt The AP wait loop state.\r
+  # @ValidRange  0x80000001 | 1 - 3\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuApLoopMode|1|UINT8|0x60008006\r
+  ## Specifies the AP target C-state for Mwait during POST phase.\r
+  #  The default value 0 means C1 state.\r
+  #  The value is defined as below.<BR><BR>\r
+  # @Prompt The specified AP target C-state for Mwait.\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuApTargetCstate|0|UINT8|0x00000007\r
+\r
+  ## Indicates if SMM uses static page table.\r
+  #  If enabled, SMM will not use on-demand paging. SMM will build static page table for all memory.<BR><BR>\r
+  #  This flag only impacts X64 build, because SMM alway builds static page table for IA32.\r
+  #   TRUE  - SMM uses static page table for all memory.<BR>\r
+  #   FALSE - SMM uses static page table for below 4G memory and use on-demand paging for above 4G memory.<BR>\r
+  # @Prompt Use static page table for all memory in SMM.\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmStaticPageTable|TRUE|BOOLEAN|0x3213210D\r
+\r
+  ## Specifies timeout value in microseconds for the BSP in SMM to wait for all APs to come into SMM.\r
+  # @Prompt AP synchronization timeout value in SMM.\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmApSyncTimeout|1000000|UINT64|0x32132104\r
+\r
+  ## Indicates the CPU synchronization method used when processing an SMI.\r
+  #   0x00  - Traditional CPU synchronization method.<BR>\r
+  #   0x01  - Relaxed CPU synchronization method.<BR>\r
+  # @Prompt SMM CPU Synchronization Method.\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmSyncMode|0x00|UINT8|0x60000014\r
+\r
+  ## Specifies user's desired settings for enabling/disabling processor features.\r
+  # @Prompt User settings for enabling/disabling processor features.\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuFeaturesUserConfiguration|{0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}|VOID*|0x00000017\r
+\r
+[PcdsDynamic, PcdsDynamicEx]\r
+  ## Contains the pointer to a CPU S3 data buffer of structure ACPI_CPU_DATA.\r
+  # @Prompt The pointer to a CPU S3 data buffer.\r
+  # @ValidList   0x80000001 | 0\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuS3DataAddress|0x0|UINT64|0x60000010\r
+\r
+  ## Contains the pointer to a CPU Hot Plug Data structure if CPU hot-plug is supported.\r
+  # @Prompt The pointer to CPU Hot Plug Data.\r
+  # @ValidList   0x80000001 | 0\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuHotPlugDataAddress|0x0|UINT64|0x60000011\r
+\r
+  ## Indicates processor feature capabilities, each bit corresponding to a specific feature.\r
+  # @Prompt Processor feature capabilities.\r
+  # @ValidList   0x80000001 | 0\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuFeaturesCapability|{0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}|VOID*|0x00000018\r
+\r
+  ## Specifies actual settings for processor features, each bit corresponding to a specific feature.\r
+  # @Prompt Actual processor feature settings.\r
+  # @ValidList   0x80000001 | 0\r
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuFeaturesSetting|{0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}|VOID*|0x00000019\r
+\r
+[UserExtensions.TianoCore."ExtraFiles"]\r
+  UefiCpuPkgExtra.uni\r