1) Add package description file (dec) for PcAtChipsetPkg

2) Add Pcd8259LegacyModeMask for platform developer configure default mask value in legacy mode.

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@8750 6f19259b-4bc3-4df7-8a09-765794883524

diff --git a/PcAtChipsetPkg/PcAtChipsetPkg.dec b/PcAtChipsetPkg/PcAtChipsetPkg.dec
new file mode 100644 (file)
index 0000000..81750c6
--- /dev/null
+++ b/PcAtChipsetPkg/PcAtChipsetPkg.dec
@@ -0,0 +1,47 @@
+#/** @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, Intel Corporation.\r
+#\r
+# All rights reserved. This program and the accompanying materials\r
+# are licensed and made available under the terms and conditions of the BSD License\r
+# which accompanies this distribution. The full text of the license may be found at\r
+# http://opensource.org/licenses/bsd-license.php\r
+#\r
+# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+#\r
+#**/\r
+\r
+[Defines]\r
+  DEC_SPECIFICATION              = 0x00010005\r
+  PACKAGE_NAME                   = PcAtChipsetPkg\r
+  PACKAGE_GUID                   = B728689A-52D3-4b8c-AE89-2CE5514CC6DC\r
+  PACKAGE_VERSION                = 0.1\r
+\r
+[PcdsFixedAtBuild.common]\r
+  ## Pcd8259LegacyModeMask defines the default mask value for platform. This value is determined\r
+  #  1) If platform only support pure UEFI, value should be set to 0xFFFF or 0xFFFE;\r
+  #     Because only clock interrupt is allowed in legacy mode in pure UEFI platform.\r
+  #  2) If platform install CSM and use thunk module:\r
+  #     a) If thunk call provided by CSM binary requires some legacy interrupt support, the corresponding bit \r
+  #        should be opened as 0.\r
+  #        For example, if keyboard interfaces provided CSM binary use legacy keyboard interrupt in 8259 bit 2, then\r
+  #        the value should be set to 0xFFFC\r
+  #     b) If all thunk call provied by CSM binary do not require legacy interrupt support, value should be set\r
+  #        to 0xFFFF or 0xFFFE.\r
+  #\r
+  #  Because the value is used as intialization value, PCD's type should be FixedAtBuild.\r
+  #\r
+  #  The default value of legacy mode mask could be changed by EFI_LEGACY_8259_PROTOCOL->SetMask(). But it is rarely\r
+  #  need change it except some special cases such as when initializing the CSM binary, it should be set to 0xFFFF to \r
+  #  mask all legacy interrupt. Please restore the original legacy mask value if changing is made for these special case.\r
+  #\r
+  gPcAtChipsetPkgTokenSpaceGuid.Pcd8259LegacyModeMask|0x00000001|UINT16|0xFFFF\r
+\r
+[Guids.common]\r
+  gPcAtChipsetPkgTokenSpaceGuid = { 0x326ae723, 0xae32, 0x4589, { 0x98, 0xb8, 0xca, 0xc2, 0x3c, 0xdc, 0xc1, 0xb1 } }\r
+\r