[mirror_edk2.git] / PcAtChipsetPkg / PcAtChipsetPkg.dec

## @file\r
# Public definitions for PcAtChipset package.\r
#\r
# This package is designed to public interfaces and implementation which follows\r
# PcAt defacto standard.\r
#\r
# Copyright (c) 2009 - 2019, Intel Corporation. All rights reserved.<BR>\r
# Copyright (c) 2017, AMD Inc. All rights reserved.<BR>\r
# Copyright (c) 2018 - 2020, ARM Limited. All rights reserved.<BR>\r
#\r
# SPDX-License-Identifier: BSD-2-Clause-Patent\r
#\r
##\r
\r
[Defines]\r
  DEC_SPECIFICATION              = 0x00010005\r
  PACKAGE_NAME                   = PcAtChipsetPkg\r
  PACKAGE_UNI_FILE               = PcAtChipsetPkg.uni\r
  PACKAGE_GUID                   = B728689A-52D3-4b8c-AE89-2CE5514CC6DC\r
  PACKAGE_VERSION                = 0.3\r
\r
[Includes]\r
  Include\r
\r
[LibraryClasses]\r
  ##  @libraryclass  Provides functions to manage I/O APIC Redirection Table Entries.\r
  #\r
  IoApicLib|Include/Library/IoApicLib.h\r
\r
[Guids]\r
  gPcAtChipsetPkgTokenSpaceGuid = { 0x326ae723, 0xae32, 0x4589, { 0x98, 0xb8, 0xca, 0xc2, 0x3c, 0xdc, 0xc1, 0xb1 } }\r
\r
#\r
# [Error.gPcAtChipsetPkgTokenSpaceGuid]\r
#   0x80000001 | Invalid value provided.\r
#\r
\r
[PcdsFeatureFlag]\r
  ## Indicates the HPET Timer will be configured to use MSI interrupts if the HPET timer supports them, or use I/O APIC interrupts.<BR><BR>\r
  #   TRUE  - Configures the HPET Timer to use MSI interrupts if the HPET Timer supports them.<BR>\r
  #   FALSE - Configures the HPET Timer to use I/O APIC interrupts.<BR>\r
  # @Prompt Configure HPET to use MSI.\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdHpetMsiEnable|TRUE|BOOLEAN|0x00001000\r
\r
  ## Indicates the RTC port registers are in MMIO space, or in I/O space.\r
  #  Default is I/O space.<BR><BR>\r
  #   TRUE  - RTC port registers are in MMIO space.<BR>\r
  #   FALSE - RTC port registers are in I/O space.<BR>\r
  # @Prompt RTC port registers use MMIO.\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdRtcUseMmio|FALSE|BOOLEAN|0x00000021\r
\r
[PcdsFixedAtBuild, PcdsDynamic, PcdsDynamicEx, PcdsPatchableInModule]\r
  ## This PCD specifies the base address of the HPET timer.\r
  # @Prompt HPET base address.\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdHpetBaseAddress|0xFED00000|UINT32|0x00000009\r
\r
  ## This PCD specifies the Local APIC Interrupt Vector for the HPET Timer.\r
  # @Prompt HPET local APIC vector.\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdHpetLocalApicVector|0x40|UINT8|0x0000000A\r
\r
  ## This PCD specifies the default period of the HPET Timer in 100 ns units.\r
  #  The default value of 100000 100 ns units is the same as 10 ms.\r
  # @Prompt Default period of HPET timer.\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdHpetDefaultTimerPeriod|100000|UINT64|0x0000000B\r
\r
  ## This PCD specifies the base address of the IO APIC.\r
  # @Prompt IO APIC base address.\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdIoApicBaseAddress|0xFEC00000|UINT32|0x0000000C\r
\r
  ## This PCD specifies the minimal valid year in RTC.\r
  # @Prompt Minimal valid year in RTC.\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdMinimalValidYear|1998|UINT16|0x0000000D\r
\r
  ## This PCD specifies the maximal valid year in RTC.\r
  # @Prompt Maximal valid year in RTC.\r
  # @Expression 0x80000001 | gPcAtChipsetPkgTokenSpaceGuid.PcdMaximalValidYear < gPcAtChipsetPkgTokenSpaceGuid.PcdMinimalValidYear + 100\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdMaximalValidYear|2097|UINT16|0x0000000E\r
\r
  ## Specifies RTC Index Register address in MMIO space.\r
  # @Prompt RTC Index Register address\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdRtcIndexRegister64|0x0|UINT64|0x00000022\r
\r
  ## Specifies RTC Target Register address in MMIO space.\r
  # @Prompt RTC Target Register address\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdRtcTargetRegister64|0x0|UINT64|0x00000023\r
\r
  ## Specifies RTC Index Register address in I/O space.\r
  # @Prompt RTC Index Register address\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdRtcIndexRegister|0x70|UINT8|0x0000001E\r
\r
  ## Specifies RTC Target Register address in I/O space.\r
  # @Prompt RTC Target Register address\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdRtcTargetRegister|0x71|UINT8|0x0000001F\r
\r
[PcdsFixedAtBuild, PcdsPatchableInModule]\r
  ## Defines the ACPI register set base address.\r
  #  The invalid 0xFFFF is as its default value. It must be configured to the real value.\r
  # @Prompt ACPI Timer IO Port Address\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdAcpiIoPortBaseAddress         |0xFFFF|UINT16|0x00000010\r
\r
  ## Defines the PCI Bus Number of the PCI device that contains the BAR and Enable for ACPI hardware registers.\r
  # @Prompt ACPI Hardware PCI Bus Number\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdAcpiIoPciBusNumber            |  0x00| UINT8|0x00000011\r
\r
  ## Defines the PCI Device Number of the PCI device that contains the BAR and Enable for ACPI hardware registers.\r
  #  The invalid 0xFF is as its default value. It must be configured to the real value.\r
  # @Prompt ACPI Hardware PCI Device Number\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdAcpiIoPciDeviceNumber         |  0xFF| UINT8|0x00000012\r
\r
  ## Defines the PCI Function Number of the PCI device that contains the BAR and Enable for ACPI hardware registers.\r
  #  The invalid 0xFF is as its default value. It must be configured to the real value.\r
  # @Prompt ACPI Hardware PCI Function Number\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdAcpiIoPciFunctionNumber       |  0xFF| UINT8|0x00000013\r
\r
  ## Defines the PCI Register Offset of the PCI device that contains the Enable for ACPI hardware registers.\r
  #  The invalid 0xFFFF is as its default value. It must be configured to the real value.\r
  # @Prompt ACPI Hardware PCI Register Offset\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdAcpiIoPciEnableRegisterOffset |0xFFFF|UINT16|0x00000014\r
\r
  ## Defines the bit mask that must be set to enable the APIC hardware register BAR.\r
  # @Prompt ACPI Hardware PCI Bar Enable BitMask\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdAcpiIoBarEnableMask           |  0x00| UINT8|0x00000015\r
\r
  ## Defines the PCI Register Offset of the PCI device that contains the BAR for ACPI hardware registers.\r
  #  The invalid 0xFFFF is as its default value. It must be configured to the real value.\r
  # @Prompt ACPI Hardware PCI Bar Register Offset\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdAcpiIoPciBarRegisterOffset    |0xFFFF|UINT16|0x00000016\r
\r
  ## Defines the offset to the 32-bit Timer Value register that resides within the ACPI BAR.\r
  # @Prompt Offset to 32-bit Timer register in ACPI BAR\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdAcpiPm1TmrOffset              |0x0008|UINT16|0x00000017\r
\r
  ## Defines the bit mask to retrieve ACPI IO Port Base Address\r
  # @Prompt ACPI IO Port Base Address Mask\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdAcpiIoPortBaseAddressMask     |0xFFFE|UINT16|0x00000018\r
\r
  ## Reset Control Register address in I/O space.\r
  # @Prompt Reset Control Register address\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdResetControlRegister|0x64|UINT64|0x00000019\r
\r
  ## 8bit Reset Control Register value for cold reset.\r
  # @Prompt Reset Control Register value for cold reset\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdResetControlValueColdReset|0xFE|UINT8|0x0000001A\r
\r
  ## Specifies the initial value for Register_A in RTC.\r
  # @Prompt Initial value for Register_A in RTC.\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdInitialValueRtcRegisterA|0x26|UINT8|0x0000001B\r
\r
  ## Specifies the initial value for Register_B in RTC.\r
  # @Prompt Initial value for Register_B in RTC.\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdInitialValueRtcRegisterB|0x02|UINT8|0x0000001C\r
\r
  ## Specifies the initial value for Register_D in RTC.\r
  # @Prompt Initial value for Register_D in RTC.\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdInitialValueRtcRegisterD|0x00|UINT8|0x0000001D\r
\r
  ## RTC Update Timeout Value(microsecond).\r
  # @Prompt RTC Update Timeout Value.\r
  gPcAtChipsetPkgTokenSpaceGuid.PcdRealTimeClockUpdateTimeout|100000|UINT32|0x00000020\r
\r
[UserExtensions.TianoCore."ExtraFiles"]\r
  PcAtChipsetPkgExtra.uni\r
Commit	Line	Data
	1	## @file\r
	2	# Public definitions for PcAtChipset package.\r
	3	#\r
	4	# This package is designed to public interfaces and implementation which follows\r
	5	# PcAt defacto standard.\r
	6	#\r
	7	# Copyright (c) 2009 - 2019, Intel Corporation. All rights reserved.<BR>\r
	8	# Copyright (c) 2017, AMD Inc. All rights reserved.<BR>\r
	9	# Copyright (c) 2018 - 2020, ARM Limited. All rights reserved.<BR>\r
	10	#\r
	11	# SPDX-License-Identifier: BSD-2-Clause-Patent\r
	12	#\r
	13	##\r
	14	\r
	15	[Defines]\r
	16	DEC_SPECIFICATION = 0x00010005\r
	17	PACKAGE_NAME = PcAtChipsetPkg\r
	18	PACKAGE_UNI_FILE = PcAtChipsetPkg.uni\r
	19	PACKAGE_GUID = B728689A-52D3-4b8c-AE89-2CE5514CC6DC\r
	20	PACKAGE_VERSION = 0.3\r
	21	\r
	22	[Includes]\r
	23	Include\r
	24	\r
	25	[LibraryClasses]\r
	26	## @libraryclass Provides functions to manage I/O APIC Redirection Table Entries.\r
	27	#\r
	28	IoApicLib\|Include/Library/IoApicLib.h\r
	29	\r
	30	[Guids]\r
	31	gPcAtChipsetPkgTokenSpaceGuid = { 0x326ae723, 0xae32, 0x4589, { 0x98, 0xb8, 0xca, 0xc2, 0x3c, 0xdc, 0xc1, 0xb1 } }\r
	32	\r
	33	#\r
	34	# [Error.gPcAtChipsetPkgTokenSpaceGuid]\r
	35	# 0x80000001 \| Invalid value provided.\r
	36	#\r
	37	\r
	38	[PcdsFeatureFlag]\r
	39	## Indicates the HPET Timer will be configured to use MSI interrupts if the HPET timer supports them, or use I/O APIC interrupts.<BR><BR>\r
	40	# TRUE - Configures the HPET Timer to use MSI interrupts if the HPET Timer supports them.<BR>\r
	41	# FALSE - Configures the HPET Timer to use I/O APIC interrupts.<BR>\r
	42	# @Prompt Configure HPET to use MSI.\r
	43	gPcAtChipsetPkgTokenSpaceGuid.PcdHpetMsiEnable\|TRUE\|BOOLEAN\|0x00001000\r
	44	\r
	45	## Indicates the RTC port registers are in MMIO space, or in I/O space.\r
	46	# Default is I/O space.<BR><BR>\r
	47	# TRUE - RTC port registers are in MMIO space.<BR>\r
	48	# FALSE - RTC port registers are in I/O space.<BR>\r
	49	# @Prompt RTC port registers use MMIO.\r
	50	gPcAtChipsetPkgTokenSpaceGuid.PcdRtcUseMmio\|FALSE\|BOOLEAN\|0x00000021\r
	51	\r
	52	[PcdsFixedAtBuild, PcdsDynamic, PcdsDynamicEx, PcdsPatchableInModule]\r
	53	## This PCD specifies the base address of the HPET timer.\r
	54	# @Prompt HPET base address.\r
	55	gPcAtChipsetPkgTokenSpaceGuid.PcdHpetBaseAddress\|0xFED00000\|UINT32\|0x00000009\r
	56	\r
	57	## This PCD specifies the Local APIC Interrupt Vector for the HPET Timer.\r
	58	# @Prompt HPET local APIC vector.\r
	59	gPcAtChipsetPkgTokenSpaceGuid.PcdHpetLocalApicVector\|0x40\|UINT8\|0x0000000A\r
	60	\r
	61	## This PCD specifies the default period of the HPET Timer in 100 ns units.\r
	62	# The default value of 100000 100 ns units is the same as 10 ms.\r
	63	# @Prompt Default period of HPET timer.\r
	64	gPcAtChipsetPkgTokenSpaceGuid.PcdHpetDefaultTimerPeriod\|100000\|UINT64\|0x0000000B\r
	65	\r
	66	## This PCD specifies the base address of the IO APIC.\r
	67	# @Prompt IO APIC base address.\r
	68	gPcAtChipsetPkgTokenSpaceGuid.PcdIoApicBaseAddress\|0xFEC00000\|UINT32\|0x0000000C\r
	69	\r
	70	## This PCD specifies the minimal valid year in RTC.\r
	71	# @Prompt Minimal valid year in RTC.\r
	72	gPcAtChipsetPkgTokenSpaceGuid.PcdMinimalValidYear\|1998\|UINT16\|0x0000000D\r
	73	\r
	74	## This PCD specifies the maximal valid year in RTC.\r
	75	# @Prompt Maximal valid year in RTC.\r
	76	# @Expression 0x80000001 \| gPcAtChipsetPkgTokenSpaceGuid.PcdMaximalValidYear < gPcAtChipsetPkgTokenSpaceGuid.PcdMinimalValidYear + 100\r
	77	gPcAtChipsetPkgTokenSpaceGuid.PcdMaximalValidYear\|2097\|UINT16\|0x0000000E\r
	78	\r
	79	## Specifies RTC Index Register address in MMIO space.\r
	80	# @Prompt RTC Index Register address\r
	81	gPcAtChipsetPkgTokenSpaceGuid.PcdRtcIndexRegister64\|0x0\|UINT64\|0x00000022\r
	82	\r
	83	## Specifies RTC Target Register address in MMIO space.\r
	84	# @Prompt RTC Target Register address\r
	85	gPcAtChipsetPkgTokenSpaceGuid.PcdRtcTargetRegister64\|0x0\|UINT64\|0x00000023\r
	86	\r
	87	## Specifies RTC Index Register address in I/O space.\r
	88	# @Prompt RTC Index Register address\r
	89	gPcAtChipsetPkgTokenSpaceGuid.PcdRtcIndexRegister\|0x70\|UINT8\|0x0000001E\r
	90	\r
	91	## Specifies RTC Target Register address in I/O space.\r
	92	# @Prompt RTC Target Register address\r
	93	gPcAtChipsetPkgTokenSpaceGuid.PcdRtcTargetRegister\|0x71\|UINT8\|0x0000001F\r
	94	\r
	95	[PcdsFixedAtBuild, PcdsPatchableInModule]\r
	96	## Defines the ACPI register set base address.\r
	97	# The invalid 0xFFFF is as its default value. It must be configured to the real value.\r
	98	# @Prompt ACPI Timer IO Port Address\r
	99	gPcAtChipsetPkgTokenSpaceGuid.PcdAcpiIoPortBaseAddress \|0xFFFF\|UINT16\|0x00000010\r
	100	\r
	101	## Defines the PCI Bus Number of the PCI device that contains the BAR and Enable for ACPI hardware registers.\r
	102	# @Prompt ACPI Hardware PCI Bus Number\r
	103	gPcAtChipsetPkgTokenSpaceGuid.PcdAcpiIoPciBusNumber \| 0x00\| UINT8\|0x00000011\r
	104	\r
	105	## Defines the PCI Device Number of the PCI device that contains the BAR and Enable for ACPI hardware registers.\r
	106	# The invalid 0xFF is as its default value. It must be configured to the real value.\r
	107	# @Prompt ACPI Hardware PCI Device Number\r
	108	gPcAtChipsetPkgTokenSpaceGuid.PcdAcpiIoPciDeviceNumber \| 0xFF\| UINT8\|0x00000012\r
	109	\r
	110	## Defines the PCI Function Number of the PCI device that contains the BAR and Enable for ACPI hardware registers.\r
	111	# The invalid 0xFF is as its default value. It must be configured to the real value.\r
	112	# @Prompt ACPI Hardware PCI Function Number\r
	113	gPcAtChipsetPkgTokenSpaceGuid.PcdAcpiIoPciFunctionNumber \| 0xFF\| UINT8\|0x00000013\r
	114	\r
	115	## Defines the PCI Register Offset of the PCI device that contains the Enable for ACPI hardware registers.\r
	116	# The invalid 0xFFFF is as its default value. It must be configured to the real value.\r
	117	# @Prompt ACPI Hardware PCI Register Offset\r
	118	gPcAtChipsetPkgTokenSpaceGuid.PcdAcpiIoPciEnableRegisterOffset \|0xFFFF\|UINT16\|0x00000014\r
	119	\r
	120	## Defines the bit mask that must be set to enable the APIC hardware register BAR.\r
	121	# @Prompt ACPI Hardware PCI Bar Enable BitMask\r
	122	gPcAtChipsetPkgTokenSpaceGuid.PcdAcpiIoBarEnableMask \| 0x00\| UINT8\|0x00000015\r
	123	\r
	124	## Defines the PCI Register Offset of the PCI device that contains the BAR for ACPI hardware registers.\r
	125	# The invalid 0xFFFF is as its default value. It must be configured to the real value.\r
	126	# @Prompt ACPI Hardware PCI Bar Register Offset\r
	127	gPcAtChipsetPkgTokenSpaceGuid.PcdAcpiIoPciBarRegisterOffset \|0xFFFF\|UINT16\|0x00000016\r
	128	\r
	129	## Defines the offset to the 32-bit Timer Value register that resides within the ACPI BAR.\r
	130	# @Prompt Offset to 32-bit Timer register in ACPI BAR\r
	131	gPcAtChipsetPkgTokenSpaceGuid.PcdAcpiPm1TmrOffset \|0x0008\|UINT16\|0x00000017\r
	132	\r
	133	## Defines the bit mask to retrieve ACPI IO Port Base Address\r
	134	# @Prompt ACPI IO Port Base Address Mask\r
	135	gPcAtChipsetPkgTokenSpaceGuid.PcdAcpiIoPortBaseAddressMask \|0xFFFE\|UINT16\|0x00000018\r
	136	\r
	137	## Reset Control Register address in I/O space.\r
	138	# @Prompt Reset Control Register address\r
	139	gPcAtChipsetPkgTokenSpaceGuid.PcdResetControlRegister\|0x64\|UINT64\|0x00000019\r
	140	\r
	141	## 8bit Reset Control Register value for cold reset.\r
	142	# @Prompt Reset Control Register value for cold reset\r
	143	gPcAtChipsetPkgTokenSpaceGuid.PcdResetControlValueColdReset\|0xFE\|UINT8\|0x0000001A\r
	144	\r
	145	## Specifies the initial value for Register_A in RTC.\r
	146	# @Prompt Initial value for Register_A in RTC.\r
	147	gPcAtChipsetPkgTokenSpaceGuid.PcdInitialValueRtcRegisterA\|0x26\|UINT8\|0x0000001B\r
	148	\r
	149	## Specifies the initial value for Register_B in RTC.\r
	150	# @Prompt Initial value for Register_B in RTC.\r
	151	gPcAtChipsetPkgTokenSpaceGuid.PcdInitialValueRtcRegisterB\|0x02\|UINT8\|0x0000001C\r
	152	\r
	153	## Specifies the initial value for Register_D in RTC.\r
	154	# @Prompt Initial value for Register_D in RTC.\r
	155	gPcAtChipsetPkgTokenSpaceGuid.PcdInitialValueRtcRegisterD\|0x00\|UINT8\|0x0000001D\r
	156	\r
	157	## RTC Update Timeout Value(microsecond).\r
	158	# @Prompt RTC Update Timeout Value.\r
	159	gPcAtChipsetPkgTokenSpaceGuid.PcdRealTimeClockUpdateTimeout\|100000\|UINT32\|0x00000020\r
	160	\r
	161	[UserExtensions.TianoCore."ExtraFiles"]\r
	162	PcAtChipsetPkgExtra.uni\r