From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: mx.groups.io; dkim=missing; spf=pass (domain: intel.com, ip: 192.55.52.151, mailfrom: michael.d.kinney@intel.com) Received: from mga17.intel.com (mga17.intel.com [192.55.52.151]) by groups.io with SMTP; Mon, 15 Apr 2019 08:57:21 -0700 X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga007.fm.intel.com ([10.253.24.52]) by fmsmga107.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 15 Apr 2019 08:57:20 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.60,354,1549958400"; d="scan'208,217";a="143138565" Received: from orsmsx106.amr.corp.intel.com ([10.22.225.133]) by fmsmga007.fm.intel.com with ESMTP; 15 Apr 2019 08:57:20 -0700 Received: from orsmsx152.amr.corp.intel.com (10.22.226.39) by ORSMSX106.amr.corp.intel.com (10.22.225.133) with Microsoft SMTP Server (TLS) id 14.3.408.0; Mon, 15 Apr 2019 08:57:20 -0700 Received: from orsmsx113.amr.corp.intel.com ([169.254.9.24]) by ORSMSX152.amr.corp.intel.com ([169.254.8.32]) with mapi id 14.03.0415.000; Mon, 15 Apr 2019 08:57:20 -0700 From: "Michael D Kinney" To: "Xu, Wei6" , "devel@edk2.groups.io" , "Kinney, Michael D" CC: "Zhang, Chao B" , "Gao, Liming" Subject: Re: [staging/UEFI_CapsuleOnDisk][PATCH] Announce to create "UEFI_CapsuleOnDisk" branch in edk2-staging. Thread-Topic: [staging/UEFI_CapsuleOnDisk][PATCH] Announce to create "UEFI_CapsuleOnDisk" branch in edk2-staging. Thread-Index: AdTxCYnSP9BMahW/T5mHq04jUMrdzQAAndeAAKXdqtA= Date: Mon, 15 Apr 2019 15:57:19 +0000 Message-ID: References: <59B8EAB3797CDB4091332F0685A110ED50D69AB4@SHSMSX104.ccr.corp.intel.com> In-Reply-To: <59B8EAB3797CDB4091332F0685A110ED50D69AB4@SHSMSX104.ccr.corp.intel.com> Accept-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: dlp-product: dlpe-windows dlp-version: 11.0.600.7 dlp-reaction: no-action x-originating-ip: [10.22.254.140] MIME-Version: 1.0 Return-Path: michael.d.kinney@intel.com Content-Language: en-US Content-Type: multipart/alternative; boundary="_000_E92EE9817A31E24EB0585FDF735412F5B9C94BA7ORSMSX113amrcor_" --_000_E92EE9817A31E24EB0585FDF735412F5B9C94BA7ORSMSX113amrcor_ Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Wei Xu, Thanks for providing this request for a new edk2-staging branch. Please add the branch maintainers to the Readme along with the criteria tha= t must be met for the feature to be considered a candidate for edk2/master. With those updates, Reviewed-by: Michael D Kinney michael.d.kinney@intel.co= m Thanks, Mike From: Xu, Wei6 Sent: Friday, April 12, 2019 2:05 AM To: devel@edk2.groups.io Cc: Zhang, Chao B ; Gao, Liming ; Kinney, Michael D Subject: [staging/UEFI_CapsuleOnDisk][PATCH] Announce to create "UEFI_Capsu= leOnDisk" branch in edk2-staging. UEFI_CapsuleOnDisk branch is used to develop the Capsule-On-Disk feature. P= lease refer to the patch of Readme.md to get the detailed feature introduct= ion. Note: The branch will be created by the end of Apr 19th if no objection. Cc: Kinney Michael D > Cc: Zhang, Chao B > Cc: Gao, Liming > Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: xuwei6 > --- Readme.md | 42 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 Readme.md diff --git a/Readme.md b/Readme.md new file mode 100644 index 0000000000..5528044802 --- /dev/null +++ b/Readme.md @@ -0,0 +1,42 @@ + +# Introduction + +This branch is used to develop the **Capsule-On-Disk** feature. +The branch owner: Chao Zhang < [chao.b.zhang@intel.com](mailto:chao.b.zhan= g@intel.com) >, Wei Xu < [wei6.xu@intel.com](mailto:wei6.xu@intel.com) > + +# Feature Summary + +Traditionally capsule image is delivered to BIOS in persistent memory acro= ss system reset, but not all platforms support or function well across memo= ry persistent reset. To solve this problem, **Capsule-On-Disk** delivers ca= psule images through EFI system partition on peripheral storage device. For= security reasons, Design is composed of 2 solutions. +- **Solution A)** - Load the image out of TCB and rely on Capsule-In-RAM t= o deliver Capsule-On-Disk. +- **Solution B)** - Relocate capsule image outside TCB. And leverage exist= ing storage stack in PEI to load all capsule on disk images. Solution B) ha= s bigger TCB but can work without Capsule-In-RAM support + +>User can test this feature with **CapsuleApp** in **MdeModulePkg**. It ha= s been updated to support Capsule on Disk since **2019 Q1 stable release**. + +Brief working flow of **Capsule-On-Disk**: +``` +1. Store capsule images into \EFI\Capsules\ folder on EFI system partition= . +2. Set EFI_OS_INDICATIONS_FILE_CAPSULE_DELIVERY_SUPPORTED flag in L"OsIndi= cations". +3. Reboot system. +4. Get all capsule images from \EFI\Capsules\ after TCB, relocated them to= root direcotry of a platform-specific NV storage device with BlockIo proto= col. +5. Reboot system. +6. Load capsule imaages from the root direcotry in TCB, and build CV hobs +``` + +## Related Modules + +The following modules are related to **Capsule-On-Disk**. +``` +MdeModulePkg\Library\DxeCapsuleLibFmp\DxeCapsuleLib.inf +MdeModulePkg\Universal\CapsuleOnDiskLoadPei\CapsuleOnDiskLoadPei.inf +``` + +# Time Line + +|Date |Event | +|----------------|-------------------------------| +|2019 Q2 | Exit Staging | + + +# Related Materials + +UEFI Specification - http://uefi.org/specifications \ No newline at end of file -- 2.16.2.windows.1 --_000_E92EE9817A31E24EB0585FDF735412F5B9C94BA7ORSMSX113amrcor_ Content-Type: text/html; charset="us-ascii" Content-Transfer-Encoding: quoted-printable

Wei Xu,

 

Thanks for providing this request for a new edk2-staging branch= .

 

Please add the branch maintainers to the Readme along with the = criteria that must be met for the feature to be considered a candidate for edk2/master.

 

With those updates, Reviewed-by: Michael D Kinney michael.d.kinney@intel.com

 

Thanks,

 

Mike

 

From: Xu, Wei6
Sent: Friday, April 12, 2019 2:05 AM
To: devel@edk2.groups.io
Cc: Zhang, Chao B <chao.b.zhang@intel.com>; Gao, Liming <li= ming.gao@intel.com>; Kinney, Michael D <michael.d.kinney@intel.com>= ;
Subject: [staging/UEFI_CapsuleOnDisk][PATCH] Announce to create &quo= t;UEFI_CapsuleOnDisk" branch in edk2-staging.

 

UEFI_CapsuleOnDisk branch is used to develop the Cap= sule-On-Disk feature. Please refer to the patch of Readme.md to get the det= ailed feature introduction.

 

Note: The branch will be created by the end of Apr 1= 9th if no objection.

 

Cc: Kinney Michael D <michael.d.kinney@intel.com>

Cc: Zhang, Chao B <chao.b.zhang@intel.com>

Cc: Gao, Liming <liming.gao@intel.com>

Contributed-under: TianoCore Contribution Agreement = 1.1

Signed-off-by: xuwei6 <wei6.xu@intel.com>

---

Readme.md | 42 +++++++&#= 43;++++++++++++++&#= 43;++++++++++++++&#= 43;++++

1 file changed, 42 insertions(+)

create mode 100644 Readme.md

 

diff --git a/Readme.md b/Readme.md

new file mode 100644

index 0000000000..5528044802

--- /dev/null

+++ b/Readme.md

@@ -0,0 +1,42 @@

+

+# Introduction

+

+This branch is used to develop the **Capsule-On= -Disk** feature.

+The branch owner: Chao Zhang < [chao.b.zhang= @intel.com](mailto:chao.b.zhang@i= ntel.com) >, Wei Xu < [wei6.xu@intel.com](mailto:wei6.xu@intel.com) >

+

+# Feature Summary

+

+Traditionally capsule image is delivered to BIO= S in persistent memory across system reset, but not all platforms support o= r function well across memory persistent reset. To solve this problem, **Ca= psule-On-Disk** delivers capsule images through EFI system partition on peripheral storage device. For security re= asons, Design is composed of 2 solutions.

+- **Solution A)** - Load the image out of TCB a= nd rely on Capsule-In-RAM to deliver Capsule-On-Disk.

+- **Solution B)** - Relocate capsule image outs= ide TCB. And leverage existing storage stack in PEI to load all capsule on = disk images. Solution B) has bigger TCB but can work without Capsule-In-RAM= support

+

+>User can test this feature with **CapsuleAp= p** in **MdeModulePkg**. It has been updated to support Capsule on Disk sin= ce **2019 Q1 stable release**.

+

+Brief working flow of  **Capsule-On-Disk**= :

+```

+1. Store capsule images into \EFI\Capsules\ fol= der on EFI system partition.

+2. Set EFI_OS_INDICATIONS_FILE_CAPSULE_DELIVERY= _SUPPORTED flag in L"OsIndications".

+3. Reboot system.

+4. Get all capsule images from \EFI\Capsules\ a= fter TCB, relocated them to root direcotry of a platform-specific NV storag= e device with BlockIo protocol.

+5. Reboot system.

+6. Load capsule imaages from the root direcotry= in TCB, and build CV hobs

+```

+

+## Related Modules

+

+The following modules are related to **Capsule-= On-Disk**.

+```

+MdeModulePkg\Library\DxeCapsuleLibFmp\DxeCapsul= eLib.inf

+MdeModulePkg\Universal\CapsuleOnDiskLoadPei\Cap= suleOnDiskLoadPei.inf

+```

+

+# Time Line

+

+|Date       =      |Event       &n= bsp;            = ;      |

+|----------------|-----------------------------= --|

+|2019 Q2      &nb= sp;  | Exit Staging        &nb= sp;         |

+

+

+# Related Materials

+

+UEFI Specification - http://uefi.org/specifications

\ No newline at end of file

--

2.16.2.windows.1

 

--_000_E92EE9817A31E24EB0585FDF735412F5B9C94BA7ORSMSX113amrcor_--