From nobody Mon Feb  9 07:55:20 2026
Delivered-To: importer@patchew.org
Received-SPF: pass (zoho.com: domain of groups.io designates 66.175.222.12 as
 permitted sender) client-ip=66.175.222.12;
 envelope-from=bounce+27952+50517+1787277+3901457@groups.io;
 helo=web01.groups.io;
Authentication-Results: mx.zohomail.com;
	dkim=pass;
	spf=pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted
 sender)  smtp.mailfrom=bounce+27952+50517+1787277+3901457@groups.io;
	dmarc=fail(p=none dis=none)  header.from=intel.com
ARC-Seal: i=1; a=rsa-sha256; t=1573615746; cv=none;
	d=zoho.com; s=zohoarc;
	b=TLtLBaVROZSVj//fLOHRZknB8ivvHHfrIEOsHYpI/My51t9dmOUy2o59LSNory+U/T0MYO/Bbwv3150X2N3sXe158b8J+MLaHhCwfNG4HTPvUsSwvN5ByWCKC8LSNXEiYAJSqWgymSpYTNAJcCAy0FXgzcnQevOpX65J/Qkubqw=
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zoho.com;
 s=zohoarc;
	t=1573615746;
 h=Cc:Date:From:In-Reply-To:List-Id:List-Unsubscribe:Message-ID:Reply-To:References:Sender:Subject:To;
	bh=dOryjxUy+/Io4Sa4WVyC+lPcXnlHuEiQYeTDy227i3o=;
	b=FChMtSDPRK0lY/rWhsmmeMOCIp7rTAn6xeW5adQ2evkQgg19jdcqapTdzfFJBb37aWJEIxWHW180fAZ3k2thgQEar7DVKM7mYIn3H9qggM3oIpVwmbgvy7r20AZnn0vmjmDoMyff9taK/aGjpo362/UdiBYfStSX33PVQH9jqzI=
ARC-Authentication-Results: i=1; mx.zoho.com;
	dkim=pass;
	spf=pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted
 sender)  smtp.mailfrom=bounce+27952+50517+1787277+3901457@groups.io;
	dmarc=fail header.from=<michael.a.kubacki@intel.com> (p=none dis=none)
 header.from=<michael.a.kubacki@intel.com>
Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by
 mx.zohomail.com
	with SMTPS id 1573615746744423.419367917434;
 Tue, 12 Nov 2019 19:29:06 -0800 (PST)
Return-Path: <bounce+27952+50517+1787277+3901457@groups.io>
X-Received: by 127.0.0.2 with SMTP id aaaaYY1788612xaaaaaaaaaa;
 Tue, 12 Nov 2019 19:29:04 -0800
X-Received: from mga11.intel.com (mga11.intel.com [])
 by mx.groups.io with SMTP id smtpd.web10.2401.1573615709373949821
 for <devel@edk2.groups.io>;
 Tue, 12 Nov 2019 19:29:03 -0800
X-Amp-Result: SKIPPED(no attachment in message)
X-Amp-File-Uploaded: False
X-Received: from orsmga005.jf.intel.com ([10.7.209.41])
  by fmsmga102.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384;
 12 Nov 2019 19:29:03 -0800
X-ExtLoop1: 1
X-IronPort-AV: E=Sophos;i="5.68,299,1569308400";
   d="scan'208";a="379090885"
X-Received: from makuback-desk1.amr.corp.intel.com ([10.7.159.162])
  by orsmga005.jf.intel.com with ESMTP; 12 Nov 2019 19:29:03 -0800
From: "Kubacki, Michael A" <michael.a.kubacki@intel.com>
To: devel@edk2.groups.io
Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>,
	Nate DeSimone <nathaniel.l.desimone@intel.com>,
	Liming Gao <liming.gao@intel.com>
Subject: [edk2-devel] [edk2-platforms][PATCH V1 11/49] TemplateFeaturePkg: Add
 initial package
Date: Tue, 12 Nov 2019 19:27:37 -0800
Message-Id: <20191113032816.4056-12-michael.a.kubacki@intel.com>
In-Reply-To: <20191113032816.4056-1-michael.a.kubacki@intel.com>
References: <20191113032816.4056-1-michael.a.kubacki@intel.com>
Precedence: Bulk
List-Unsubscribe: <https://edk2.groups.io/g/devel/unsub>
Sender: devel@edk2.groups.io
List-Id: <devel.edk2.groups.io>
Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io
Reply-To: devel@edk2.groups.io,michael.a.kubacki@intel.com
X-Gm-Message-State: aaaaaaaaaaaaaaaaaaaaaaaax1787277AA=
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io;
 q=dns/txt; s=20140610; t=1573615744;
 bh=LsGMJZhAmKvGDGq14sbowoTAL9Fx3ovsPljpQ+nQYHw=;
 h=Cc:Date:From:Reply-To:Subject:To;
 b=ju1K/fGoIeJpZhV6XLRNxDazhyrs9RKfo0lhwyqCehIIOCrWukqBceWaJzk5oJH+NFt
 zkgismbM1Ic20BKu+F/80xm6woQ0AHxvZq3CdItKlUQCFyL5VpoO8ZHgBevxrHf4oFFb5
 VrezbASCEqJ1cq32AlBDbV16yYmlralDyGQ=
X-ZohoMail-DKIM: pass (identity @groups.io)
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"

This change adds a new package called TemplateFeaturePkg that
should be used as a starting point for the creation of new advanced
feature packages.

TemplateFeaturePkg is not meant to be built or used directly for
functionality. It simply serves as a template to be copied and
modified. The advanced feature package creation process is
described in detail in Features/Intel/Readme.md.

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Signed-off-by: Michael Kubacki <michael.a.kubacki@intel.com>
Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>
---
 Features/Intel/TemplateFeaturePkg/TemplateFeaturePkg.dec      |  30 ++++++
 Features/Intel/TemplateFeaturePkg/Include/TemplateFeature.dsc | 113 ++++++=
++++++++++++++
 Features/Intel/TemplateFeaturePkg/TemplateFeaturePkg.dsc      |  30 ++++++
 Features/Intel/TemplateFeaturePkg/Include/PostMemory.fdf      |   8 ++
 Features/Intel/TemplateFeaturePkg/Include/PreMemory.fdf       |   8 ++
 Features/Intel/TemplateFeaturePkg/Readme.md                   |  71 ++++++=
++++++
 6 files changed, 260 insertions(+)

diff --git a/Features/Intel/TemplateFeaturePkg/TemplateFeaturePkg.dec b/Fea=
tures/Intel/TemplateFeaturePkg/TemplateFeaturePkg.dec
new file mode 100644
index 0000000000..b37ce8f34a
--- /dev/null
+++ b/Features/Intel/TemplateFeaturePkg/TemplateFeaturePkg.dec
@@ -0,0 +1,30 @@
+## @file
+# This package provides advanced feature functionality for <TEMPLATE> supp=
ort.
+# This package should only depend on EDK II Core packages, IntelSiliconPkg=
, and MinPlatformPkg.
+#
+# The DEC files are used by the utilities that parse DSC and
+# INF files to generate AutoGen.c and AutoGen.h files
+# for the build infrastructure.
+#
+# Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
+#
+# SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+  DEC_SPECIFICATION =3D 0x00010017
+  PACKAGE_NAME      =3D TemplateFeaturePkg
+  PACKAGE_GUID      =3D 00000000-0000-0000-0000-000000000000
+  PACKAGE_VERSION   =3D 0.1
+
+[Includes]
+  Include
+
+[LibraryClasses]
+
+[Guids]
+  gTemplateFeaturePkgTokenSpaceGuid  =3D  {0x00000000, 0x0000, 0x0000, {0x=
00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}}
+
+[PcdsFeatureFlag]
+  gTemplateFeaturePkgTokenSpaceGuid.PcdTemplateFeatureEnable|FALSE|BOOLEAN=
|0xA0000001
diff --git a/Features/Intel/TemplateFeaturePkg/Include/TemplateFeature.dsc =
b/Features/Intel/TemplateFeaturePkg/Include/TemplateFeature.dsc
new file mode 100644
index 0000000000..6742eddcf9
--- /dev/null
+++ b/Features/Intel/TemplateFeaturePkg/Include/TemplateFeature.dsc
@@ -0,0 +1,113 @@
+## @file
+# This is a build description file for the <TEMPLATE> advanced feature.
+# This file should be included into another package DSC file to build this=
 feature.
+#
+# The DEC files are used by the utilities that parse DSC and
+# INF files to generate AutoGen.c and AutoGen.h files
+# for the build infrastructure.
+#
+# Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
+#
+# SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+##########################################################################=
######
+#
+# Defines Section - statements that will be processed to create a Makefile.
+#
+##########################################################################=
######
+[Defines]
+!ifndef $(PEI_ARCH)
+  !error "PEI_ARCH must be specified to build this feature!"
+!endif
+!ifndef $(DXE_ARCH)
+  !error "DXE_ARCH must be specified to build this feature!"
+!endif
+
+##########################################################################=
######
+#
+# Library Class section - list of all Library Classes needed by this featu=
re.
+#
+##########################################################################=
######
+[LibraryClasses]
+
+  ## Note: This comment block should be removed from the template when the
+  #        template is used.
+  #
+  #  Library classes should have a comment header that describes the type =
of
+  #  package the library is used from for organization purposes.
+  #
+  #  For an advanced feature, these are typically:
+  #    * Edk2 Packages
+  #    * Silicon Initialization Package
+  #    * Platform Package
+  #    * Feature Package
+  #
+  #  The comment header should follow the format:
+  #
+  #  #######################################
+  #  # Edk2 Packages
+  #  #######################################
+
+##########################################################################=
######
+#
+# Component section - list of all components that need built for this feat=
ure.
+#
+# Note: The EDK II DSC file is not used to specify how compiled binary ima=
ges get placed
+#       into firmware volume images. This section is just a list of module=
s to compile from
+#       source into UEFI-compliant binaries.
+#       It is the FDF file that contains information on combining binary f=
iles into firmware
+#       volume images, whose concept is beyond UEFI and is described in PI=
 specification.
+#       There may also be modules listed in this section that are not requ=
ired in the FDF file,
+#       When a module listed here is excluded from FDF file, then UEFI-com=
pliant binary will be
+#       generated for it, but the binary will not be put into any firmware=
 volume.
+#
+##########################################################################=
######
+
+#
+# Feature PEI Components
+#
+
+# @todo: Change below line to [Components.$(PEI_ARCH)] after https://bugzi=
lla.tianocore.org/show_bug.cgi?id=3D2308
+#        is completed.
+[Components.IA32]
+  #####################################
+  # <TEMPALTE> Feature Package
+  #####################################
+
+  # Add library instances here that are not included in package components=
 and should be tested
+  # in the package build.
+
+  # Add components here that should be included in the package build.
+
+#
+# Feature DXE Components
+#
+
+# @todo: Change below line to [Components.$(DXE_ARCH)] after https://bugzi=
lla.tianocore.org/show_bug.cgi?id=3D2308
+#        is completed.
+[Components.X64]
+  #####################################
+  # <TEMPLATE> Feature Package
+  #####################################
+
+  # Add library instances here that are not included in package components=
 and should be tested
+  # in the package build.
+
+  # Add components here that should be included in the package build.
+
+##########################################################################=
#########################
+#
+# BuildOptions Section - Define the module specific tool chain flags that =
should be used as
+#                        the default flags for a module. These flags are a=
ppended to any
+#                        standard flags that are defined by the build proc=
ess. They can be
+#                        applied for any modules or only those modules wit=
h the specific
+#                        module style (EDK or EDKII) specified in [Compone=
nts] section.
+#
+#                        For advanced features, it is recommended to enabl=
e [BuildOptions] in
+#                        the applicable INF file so it does not affect the=
 whole board package
+#                        build when this DSC file is active.
+#
+##########################################################################=
#########################
+[BuildOptions]
diff --git a/Features/Intel/TemplateFeaturePkg/TemplateFeaturePkg.dsc b/Fea=
tures/Intel/TemplateFeaturePkg/TemplateFeaturePkg.dsc
new file mode 100644
index 0000000000..0ce8debee0
--- /dev/null
+++ b/Features/Intel/TemplateFeaturePkg/TemplateFeaturePkg.dsc
@@ -0,0 +1,30 @@
+## @file
+# This package provides advanced feature functionality for <TEMPLATE> supp=
ort.
+# This package should only depend on EDK II Core packages, IntelSiliconPkg=
, and MinPlatformPkg.
+#
+# The DEC files are used by the utilities that parse DSC and
+# INF files to generate AutoGen.c and AutoGen.h files
+# for the build infrastructure.
+#
+# Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
+#
+# SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+  PLATFORM_NAME                  =3D TemplateFeaturePkg
+  PLATFORM_GUID                  =3D 00000000-0000-0000-0000-000000000000
+  PLATFORM_VERSION               =3D 0.1
+  DSC_SPECIFICATION              =3D 0x00010005
+  OUTPUT_DIRECTORY               =3D Build/$(PLATFORM_NAME)
+  SUPPORTED_ARCHITECTURES        =3D IA32|X64
+  BUILD_TARGETS                  =3D DEBUG|RELEASE|NOOPT
+  SKUID_IDENTIFIER               =3D DEFAULT
+  PEI_ARCH                       =3D IA32
+  DXE_ARCH                       =3D X64
+
+#
+# This package always builds the feature.
+#
+!include Include/TemplateFeature.dsc
diff --git a/Features/Intel/TemplateFeaturePkg/Include/PostMemory.fdf b/Fea=
tures/Intel/TemplateFeaturePkg/Include/PostMemory.fdf
new file mode 100644
index 0000000000..86225cefbe
--- /dev/null
+++ b/Features/Intel/TemplateFeaturePkg/Include/PostMemory.fdf
@@ -0,0 +1,8 @@
+## @file
+#  FDF file for post-memory <TEMPLATE> advanced feature modules.
+#
+# Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
+#
+# SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
diff --git a/Features/Intel/TemplateFeaturePkg/Include/PreMemory.fdf b/Feat=
ures/Intel/TemplateFeaturePkg/Include/PreMemory.fdf
new file mode 100644
index 0000000000..5ce30af174
--- /dev/null
+++ b/Features/Intel/TemplateFeaturePkg/Include/PreMemory.fdf
@@ -0,0 +1,8 @@
+## @file
+#  FDF file for pre-memory <TEMPLATE> advanced feature modules.
+#
+# Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
+#
+# SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
diff --git a/Features/Intel/TemplateFeaturePkg/Readme.md b/Features/Intel/T=
emplateFeaturePkg/Readme.md
new file mode 100644
index 0000000000..90be279ae3
--- /dev/null
+++ b/Features/Intel/TemplateFeaturePkg/Readme.md
@@ -0,0 +1,71 @@
+# Overview
+* **Feature Name:** <Feature Name>
+* **PI Phase(s) Supported:** <PI Phases Supported>
+* **SMM Required?** <Yes/No>
+
+## Purpose
+Simple overview that describes the purpose of the feature. In general, thi=
s should be no longer than one paragraph.
+
+# High-Level Theory of Operation
+A description of how the device works at a high-level.
+
+The description should not be constrained to implementation details but pr=
ovide a simple mental model of how the
+feature is supposed to work.
+
+## Firmware Volumes
+A bulleted list of the firmware volumes that feature module(s) are placed =
in.
+
+## Modules
+A bulleted list of the modules that make up the feature.
+
+## <Module Name>
+Each module in the feature should have a section that describes the module=
 in a level of detail that is useful
+to better understand the module source code.
+
+## <Library Name>
+Each library in the feature should have a section that describes the libra=
ry in a level of detail that is useful
+to better understand the library source code.
+
+## Key Functions
+A bulleted list of key functions for interacting with the feature.
+
+Not all features need to be listed. Only functions exposed through externa=
l interfaces that are important for feature
+users to be aware of.
+
+## Configuration
+Information that is useful for configuring the feature.
+
+Not all configuration options need to be listed. This section is used to p=
rovide more background on configuration
+options than possible elsewhere.
+
+## Data Flows
+Architecturally defined data structures and flows for the feature.
+
+## Control Flows
+Key control flows for the feature.
+
+## Build Flows
+Any special build flows should be described in this section.
+
+This is particularly useful for features that use custom build tools or re=
quire non-standard tool configuration. If the
+standard flow in the feature package template is used, this section may be=
 empty.
+
+## Test Point Results
+The test(s) that can verify porting is complete for the feature.
+
+Each feature must describe at least one test point to verify the feature i=
s successful. If the test point is not
+implemented, this should be stated.
+
+## Functional Exit Criteria
+The testable functionality for the feature.
+
+This section should provide an ordered list of criteria that a board integ=
rator can reference to ensure the feature is
+functional on their board.
+
+## Feature Enabling Checklist
+An ordered list of required activities to achieve desired functionality fo=
r the feature.
+
+## Common Optimizations
+Common size or performance tuning options for this feature.
+
+This section is recommended but not required. If not used, the contents sh=
ould be left empty.
--=20
2.16.2.windows.1


-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-
Groups.io Links: You receive all messages sent to this group.

View/Reply Online (#50517): https://edk2.groups.io/g/devel/message/50517
Mute This Topic: https://groups.io/mt/55160621/1787277
Group Owner: devel+owner@edk2.groups.io
Unsubscribe: https://edk2.groups.io/g/devel/unsub  [importer@patchew.org]
-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-