From 31ed75a9bd6e9c0090b94a757fc8ab022341faa0 Mon Sep 17 00:00:00 2001
From: klu2 <klu2@6f19259b-4bc3-4df7-8a09-765794883524>
Date: Mon, 6 Jul 2009 02:59:37 +0000
Subject: [PATCH] 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
---
 PcAtChipsetPkg/PcAtChipsetPkg.dec | 47 +++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 PcAtChipsetPkg/PcAtChipsetPkg.dec

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