From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mga17.intel.com (mga17.intel.com [192.55.52.151]) by mx.groups.io with SMTP id smtpd.web10.5576.1580376543479086249 for ; Thu, 30 Jan 2020 01:29:03 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@intel.onmicrosoft.com header.s=selector2-intel-onmicrosoft-com header.b=Eff584Y3; spf=pass (domain: intel.com, ip: 192.55.52.151, mailfrom: rangasai.v.chaganty@intel.com) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga008.fm.intel.com ([10.253.24.58]) by fmsmga107.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 30 Jan 2020 01:29:03 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.70,381,1574150400"; d="scan'208";a="224074896" Received: from orsmsx109.amr.corp.intel.com ([10.22.240.7]) by fmsmga008.fm.intel.com with ESMTP; 30 Jan 2020 01:29:02 -0800 Received: from orsmsx605.amr.corp.intel.com (10.22.229.18) by ORSMSX109.amr.corp.intel.com (10.22.240.7) with Microsoft SMTP Server (TLS) id 14.3.439.0; Thu, 30 Jan 2020 01:29:02 -0800 Received: from orsmsx605.amr.corp.intel.com (10.22.229.18) by ORSMSX605.amr.corp.intel.com (10.22.229.18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.1713.5; Thu, 30 Jan 2020 01:29:01 -0800 Received: from ORSEDG001.ED.cps.intel.com (10.7.248.4) by orsmsx605.amr.corp.intel.com (10.22.229.18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256) id 15.1.1713.5 via Frontend Transport; Thu, 30 Jan 2020 01:29:01 -0800 Received: from NAM11-BN8-obe.outbound.protection.outlook.com (104.47.58.176) by edgegateway.intel.com (134.134.137.100) with Microsoft SMTP Server (TLS) id 14.3.439.0; Thu, 30 Jan 2020 01:29:01 -0800 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=aMm1ax0hBH5X+/1mz2k5CfmalR5g/ETe9sVfQBIGaggM2KOf1Qt7OC0oPT3x056XUyfJL3jh5aGAqq3udTlpyhlGtdL2PMPqvmYLQb50CzGj79oJaAwUASj+vHNkLOw5t50+GDHE+6tIGynJWNY7kzzYXUasj10arWx+IVuz7CZDCjLzUbRXQsRSzktjB1gIbKt7OGEhrME78U5WG1jev+xhheBo6sWMtR69kWQKmlF2ZYAQnShw21QXtY9Cy4T/TLVCbKVQyalmfHnh5NUVh8wQF/PafRmfv/A1m4MDFakNbxjVAzTxpIrZLwiwABMaLogP6LEkxD7i6/fUjN8+tQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=wckqXIDz8SJjM5nbGLtbnXoTC7v0+RJcRKRx8lnjYSE=; b=m3lpO4svaOar4M+8b1dYGCXWEQygk3vlzr6Ft+t2GGIf2+oCwtdxEjL+FC/Plh4K9K5nrtb9DlF9l74hGUwak63NazAdcPwJiqguvDvAYtwRxBSFPGTzAC90QuhnDYrXZbaSbS/jTaWyGZXVhhfXwwA6OiCJ8D6dhRG7cJfC5poMVFAT11hiXPepAiCBAFRCnKg+EGqBotcXDiBIoyvIV57feKFUR9npf78QOThZF/zFhlptVQ0DdiM1KNjPrycoXWKeH3mZWnRsGVVh/xY4emHOnFUKZw7o1AxRGwC6fPluZUAFjjo3e3VW/B+P4xXfOFSGnxRcqLDYhq38nC4EbA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=intel.com; dmarc=pass action=none header.from=intel.com; dkim=pass header.d=intel.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=intel.onmicrosoft.com; s=selector2-intel-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=wckqXIDz8SJjM5nbGLtbnXoTC7v0+RJcRKRx8lnjYSE=; b=Eff584Y3YGH5SJ5IWDVaU/Dp2p6EDR5FajoxxRZW4ZVk8TaFO/37WOvJ8ma0rmQz28R/niS7YpeBuQbc2zK1RPX1NC2yCXIaIjHXyftvHc/3g515gA2sjbM+Pu7srUxJndRCzw9l0Do7L5Ks/qxWSZSCp/NjFtn6PFrx9LnJxTE= Received: from MN2PR11MB3759.namprd11.prod.outlook.com (20.178.252.145) by MN2PR11MB4144.namprd11.prod.outlook.com (20.179.150.210) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2665.24; Thu, 30 Jan 2020 09:28:59 +0000 Received: from MN2PR11MB3759.namprd11.prod.outlook.com ([fe80::79e4:57e0:942:f73e]) by MN2PR11MB3759.namprd11.prod.outlook.com ([fe80::79e4:57e0:942:f73e%3]) with mapi id 15.20.2665.027; Thu, 30 Jan 2020 09:28:59 +0000 From: "Chaganty, Rangasai V" To: "Kubacki, Michael A" , "devel@edk2.groups.io" CC: "Desimone, Nathaniel L" Subject: Re: [tianocore-docs][PATCH V1 1/1] edk2-MinimumPlatformSpecification: Advanced Feature section updates Thread-Topic: [tianocore-docs][PATCH V1 1/1] edk2-MinimumPlatformSpecification: Advanced Feature section updates Thread-Index: AQHV1bvBsUSybJRihkOJ3QqxVcC4pagC8+bA Date: Thu, 30 Jan 2020 09:28:59 +0000 Message-ID: References: <20200128091632.13608-1-michael.a.kubacki@intel.com> In-Reply-To: <20200128091632.13608-1-michael.a.kubacki@intel.com> Accept-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: dlp-reaction: no-action dlp-version: 11.2.0.6 dlp-product: dlpe-windows authentication-results: spf=none (sender IP is ) smtp.mailfrom=rangasai.v.chaganty@intel.com; x-originating-ip: [134.134.136.210] x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 00033182-2159-4f9d-d470-08d7a566d62a x-ms-traffictypediagnostic: MN2PR11MB4144: x-ld-processed: 46c98d88-e344-4ed4-8496-4ed7712e255d,ExtAddr x-ms-exchange-transport-forked: True x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:9508; x-forefront-prvs: 02981BE340 x-forefront-antispam-report: SFV:NSPM;SFS:(10019020)(376002)(136003)(346002)(396003)(366004)(39860400002)(189003)(199004)(316002)(15650500001)(19627235002)(7696005)(86362001)(26005)(8676002)(9686003)(81166006)(81156014)(66946007)(55016002)(5660300002)(66476007)(2906002)(66556008)(33656002)(66446008)(64756008)(53546011)(186003)(76116006)(6506007)(8936002)(52536014)(4326008)(30864003)(478600001)(110136005)(71200400001)(107886003)(559001)(579004)(19607625011);DIR:OUT;SFP:1102;SCL:1;SRVR:MN2PR11MB4144;H:MN2PR11MB3759.namprd11.prod.outlook.com;FPR:;SPF:None;LANG:en;PTR:InfoNoRecords;MX:1;A:1; x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: UWwRX73MAcynZPb6ppcceceuzjpoTUwYTrGfHcba7UyjSOLe1gyXDDNdYbhVKndwmwhbhf+9obGumP72RjAXtNn3wg8AnHebgR7koZn2pUxKulIXk/tF5vlWmsSHQmd4xEOHG3lbkBU2Mwj2sweRNd2bQ4ddRBIVU8w+v5o/GMBe7LjyCLtJFV8M5ackeQxAbriACFEMOPApMGkh2vck8PlnJ8u8ecvJok5o0FDssERA4x5zZdBdpg4Yh9nt+vrgOZBQXXiPNwFrywEQ5buhpzXOJUhqmvsRmMAXNwwaDbIopD3dcrXQ/tGKStmagTEtDYni/bnaVf1GfglWaUcgxOa6tHoh0cQG77vBi8llo9De8Cx78iJoPVfO+fuDCXRR12kx156hoP7F2wzOlUfBs5xHCCcDKwhQJyEBzBWODWnG3uQ5Kk6sP6ECEO6W4sSXoBsHF0vsvyDtVpTOu3IVzCXZDW7G4K7AifJHWqA5dGRG70Jn7iPGixJbr6xRkR0ichlRQopwtkAu95d9BnPae9QMu3es/rDN6v7RF77yTwarX6YeCvKznsGjxz1kvcnX x-ms-exchange-antispam-messagedata: wG7rlK1QmCXCKy+rGa1A3V/ciAPVIkXfncwanLvfG67wS/590nmRFACM9Wp0NorJoirfeOtyKBnhtl8uJ0XqEwO3ziKBpDxUDCZTXlnCP+nJvasnEU5E0WG6yVa6suNLfMwb/apozPAqtEodgJmI7g== MIME-Version: 1.0 X-MS-Exchange-CrossTenant-Network-Message-Id: 00033182-2159-4f9d-d470-08d7a566d62a X-MS-Exchange-CrossTenant-originalarrivaltime: 30 Jan 2020 09:28:59.2853 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 46c98d88-e344-4ed4-8496-4ed7712e255d X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: 8DMU78ZFIQtqTyPOhdQhlJIgF4jEJMcP23D5XIMnmbogVqOKTpZRU+GhCTxyGVi8x7UMEV3rGfwCgCpp6Q443ZX9ckZpuSt3v2pZusJ/R+0= X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR11MB4144 Return-Path: rangasai.v.chaganty@intel.com X-OriginatorOrg: intel.com Content-Language: en-US Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Reviewed-by: Sai Chaganty -----Original Message----- From: Kubacki, Michael A =20 Sent: Tuesday, January 28, 2020 1:17 AM To: devel@edk2.groups.io Cc: Chaganty, Rangasai V ; Desimone, Nathani= el L Subject: [tianocore-docs][PATCH V1 1/1] edk2-MinimumPlatformSpecification: = Advanced Feature section updates This change makes the following updates to Section 8 - Stage VI Advanced Fe= ature Selection: * Remove the advanced feature template * This is no longer provided in the specification but maintained in the Readme.md file in edk2-platforms/Features/Intel/Readme.md * Remove the following advanced feature examples: 1. Network stack feature 2. Signed capsule update feature * These examples are maintained in edk2-platforms/Features/Intel * Update the Advanced Feature description in Section 8.1 to align with the description in edk2-platforms/Features/Intel/Readme.md Cc: Sai Chaganty Cc: Nate DeSimone Signed-off-by: Michael Kubacki --- 8_stage_6_advanced_feature_selection/85_advanced_feature_template.md = | 54 -------- 8_stage_6_advanced_feature_selection/86_network_stack_feature_example.md = | 136 ------------------- 8_stage_6_advanced_feature_selection/87_signed_capsule_update_enabling_exa= mple.md | 137 -------------------- 8_stage_6_advanced_feature_selection/README.md = | 113 ++++------------ SUMMARY.md = | 3 - 5 files changed, 25 insertions(+), 418 deletions(-) diff --git a/8_stage_6_advanced_feature_selection/85_advanced_feature_templ= ate.md b/8_stage_6_advanced_feature_selection/85_advanced_feature_template.= md deleted file mode 100644 index 428c731..0000000 --- a/8_stage_6_advanced_feature_selection/85_advanced_feature_template.md +++ /dev/null @@ -1,54 +0,0 @@ - - -## 8.5 Advanced Feature Template - -Define an advanced feature using the following template. The template is -= roughly equivalent to preceding stage description sections within this -doc= ument, with the addition of common optimization opportunities. This -templa= te should be included in feature review and placed in the feature -root dir= ectory as README.md. - -| `Overview` | `An overview of the feature` = = | -| ------------------------------ | ---------------------------------------= ---------------------------------------------------------------------------= ---------------------------------------------- | -| **Firmware Volumes** | The binary containers needed for the fe= ature. = | -| **Modules** | The EDK II component binaries and stati= c libraries required. = | -| **Required Functions** | Functions that are useful for understan= ding, porting, or debugging the feature and how these key functions are int= egrated into the Stage I-V required functions. | -| **Configuration** | The configurable parameters for a given= feature. = | -| **Data Flows** | The architecturally defined data struct= ures and flows for a given feature. = | -| **Control Flows** | Key control flows for the feature. = = | -| **Build Files** | The DSC/FDF for integrating the feature= . = | -| **Test Point Results** | The test that can verify porting is com= plete for the feature. = | -| **Functional Exit Criteria** | The testable functionality for the feat= ure. = | -| **Feature Enabling Checklist** | The required activities to achieve desi= red functionality for the feature. = | -| **Common Optimizations** | Common size or performance tuning optio= ns for this feature. = | - -###### Table 70 Advanced Feature Template diff --git a/8_stage_6_advanced_= feature_selection/86_network_stack_feature_example.md b/8_stage_6_advanced_= feature_selection/86_network_stack_feature_example.md deleted file mode 100644 index a4d6ddd..0000000 --- a/8_stage_6_advanced_feature_selection/86_network_stack_feature_example= .md +++ /dev/null @@ -1,136 +0,0 @@ - - -## 8.6 Network Stack Feature Example -*** -**Note:** The network stack example is presently incomplete and -no longer= accurately represents the latest vision for advanced features. -This section will be updated to provide more accurate examples in the futu= re. -*** -### 8.6.1 Overview - -The UEFI network stack supports IP4 and IP6, UDP, TCP/IP, MFTP, iSCSI, ARP= , -DHCP, and PXE. Refer to the UEFI specification for related interfaces. M= ore -details on UEFI networking can be found online such as the following r= esource -[UEFI Driver Network Boot Devices Guide](https://www.intel.com/con= tent/dam/doc/guide/uefi-driver-networkboot-devices-guide.pdf). - -### 8.6.2 Firmware Volumes - -| `Name` | `Content` | `Compressed` | `Parent FV` | -| --------- | --------- | ------------ | ----------- | -| FvNetwork | Network | Yes | FvAdvanced | - -#### 8.6.3 Modules - -The network stack can be considered a relatively complicated UEFI Driver M= odel -compliant feature stack. The majority of the modules are board and si= licon -independent so no porting is expected for the following components. - -##### 8.6.3.1 UEFI Components (DXE) - -| `Item` | `Producing Package` | `Libraries Consumed` | -| ------------------ | ------------------- | -------------------- | -| SnpDxe.inf | MdeModulePkg | | -| DcpDxe.inf | MdeModulePkg | | -| MnpDxe.inf | MdeModulePkg | | -| VlanConfigDxe.inf | MdeModulePkg | | -| ArpDxe.inf | MdeModulePkg | | -| Dhcp4Dxe.inf | MdeModulePkg | | -| Ip4Dxe.inf | MdeModulePkg | | -| Mtftp4Dxe.inf | MdeModulePkg | | -| Tcp4Dxe.inf | MdeModulePkg | | -| Udp4Dxe.inf | MdeModulePkg | | -| UefiPxeBcDxe.inf | NetworkPkg | | -| IScsiDxe.inf | MdeModulePkg | | -| Ip6Dxe.inf | NetworkPkg | | -| TcpDxe.inf | NetworkPkg | | -| Udp6Dxe.inf | NetworkPkg | | -| Dhcp6Dxe.inf | NetworkPkg | | -| Mtftp6Dxe.inf | NetworkPkg | | -| UndiRuntimeDxe.inf | OptionRomPkg | | - -##### 8.6.3.2 Platform Architecture Libraries - -None - -#### 8.6.4 Required Functions - -None - -### 8.6.5 Configuration - -None. `PcdEfiNetworkSupport` exists to allow user or build to disable netw= ork -option ROM dispatch by the PCI Bus driver. That PCD is enabled by defa= ult and -is detailed in Common Optimizations. - -### 8.6.6 Data Flows - -None - -### 8.6.7 Control Flows - -None - -### 8.6.8 Build Files - -These are the advanced feature module build files (i.e. INF files) include= d in -a board to build and include the FvNetwork.fv in the FvAdvanced firmw= are -volume. - -### 8.6.9 Test Point Results - -There are currently no test points defined for the network stack. - -### 8.6.10 Functional Exit Criteria - -TBD - -### 8.6.11 Feature Enabling Checklist - -TBD - -### 8.6.12 Common Optimizations - -#### 8.6.12.1 Performance - -| `PCD` | `Default` | `Purp= ose` | -| ---------------------------------------------------- | --------- | -----= --------------------------------------------------------------------- | -| gEfiMdeModulePkgTokenSpaceGuid.PcdEfiNetworkSupport | TRUE | This = causes PciBus driver to skip loading network option ROM if set FALSE. | - -#### 8.6.12.2 Size - -1. Remove IPv4 - -2. Remove PXE - -3. Remove iSCSI - -4. ... diff --git a/8_stage_6_advanced_feature_selection/87_signed_capsule_update_= enabling_example.md b/8_stage_6_advanced_feature_selection/87_signed_capsul= e_update_enabling_example.md deleted file mode 100644 index 9bce739..0000000 --- a/8_stage_6_advanced_feature_selection/87_signed_capsule_update_enablin= g_example.md +++ /dev/null @@ -1,137 +0,0 @@ - - -## 8.7 Signed Capsule Update Enabling Example -*** -**Note:** The signed capsule update example is presently incomplete and -n= o longer accurately represents the latest vision for advanced features.=20 -This section will be updated to provide more accurate examples in the futu= re. -*** - -### 8.7.1 Overview - -The Signed Capsule Update stack supports capsule update functionality. Ref= er -to the UEFI specification for related interfaces. More details on UEFI = Signed -Capsule Update can be found online such as the following resource -= [A Tour Beyond BIOS - Capsule Update and Recovery in EDK II](https://github= .com/tianocoredocs/Docs/raw/master/White_Papers/A_Tour_Beyond_BIOS_Capsule_= Update_and_Recovery_in_EDK_II.pdf) - -### 8.7.2 Firmware Volumes - -TBD - -### 8.7.3 Modules - -The signed capsule update stack is a relatively simple feature stack. The = -majority of the modules are board and silicon independent so minimal -port= ing is required. - -#### 8.7.3.1 UEFI Components (DXE) - -The libraries consumed are the subset of libraries required by this -speci= fication. Some libraries are defined in this specification, some are -defin= ed in EDK II documentation. - -| `Item` | `Producing Package` | `Libraries Consumed` = | -| ------------------------ | ------------------- | ---------------------- = | -| CapsuleRuntime.inf | MdeModulePkg | = | -| SystemFirmwareUpdate.inf | SignedCapsulePkg | PlatformFlashAccessLib = | - -#### 8.7.3.2 Platform Architecture Libraries - -Board porting will require creation of libraries identified as produced by= the -BoardPkg. Depending on the board, there may be existing libraries tha= t are -sufficient for a board, so it is important to assess the utility of = existing -library instances when developing board support. - -| `Item` | `API Definition Package` | `Producing Packag= e` | `Description` | -| ------------------------- | ------------------------ | -----------------= -- | ----------------------------- | -| `PlatformFlashAccessLib` | SignedCapsule Pkg | BoardPkg = | Signed Capsule Update details | - -### 8.7.4 Required Functions - -None - -### 8.7.5 Configuration - -| `PCD` | `Purpose`= = | -| ------------------------------------------------------------ | ---------= ---------------------------------------------------------------------------= --------------- | -| gEfiMdeModulePkgTokenSpaceGuid. PcdSupportUpdateCapsuleReset | Indicates= if the platform can support update capsule across a system reset. = | -| gEfiMdeModulePkgTokenSpaceGuid. PcdMaxSizeNonPopulateCapsule | Indicates= the maximum size of the capsule image without a reset flag that the platfo= rm can support. | -| gEfiMdeModulePkgTokenSpaceGuid. PcdMaxSizePopulateCapsule | Indicates= the maximum size of the capsule image with a reset flag that the platform = can support. | - -### 8.7.6 Data Flows - -None - -### 8.7.7 Control Flows - -None - -### 8.7.8 Build Files - -These are the advanced feature module build files (i.e. INF files) include= d in -a board to build and include the FvSignedCapsuleUpdate.fv in the FvAd= vanced -firmware volume. - -### 8.7.9 Test Point Results - -There are currently no test points defined for the signed capsule update s= tack. - -### 8.7.10 Functional Exit Criteria - -TBD - -### 8.7.11 Feature Enabling Checklist - -The following steps should be followed to enable a platform for enabling t= he -Signed Capsule Update feature stack: - -1. Create a BoardCapsuleLib library class instance - -2. Include BoardCapsuleLib - -3. Include SecureCapsuleUpdate.dsc - -4. Include SecureCapsuleUpdate.fdf - -5. Add FvSecureCapsuleUpdate.fv - -6. Set Set `gMinPlatformPkgTokenSpaceGuid.PcdBootStage` =3D 6 - -7. Verify if reset is required or optional - -8. Verify PCD default sizes cover required firmware image sizes - -9. Verify functionality as per whitepaper referenced in Overview - -### 8.7.12 Common Optimizations - -None diff --git a/8_stage_6_advanced_feature_selection/README.md b/8_stage_6_adv= anced_feature_selection/README.md index 9bdd812..2e38dfe 100644 --- a/8_stage_6_advanced_feature_selection/README.md +++ b/8_stage_6_advanced_feature_selection/README.md @@ -1,7 +1,7 @@