From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received-SPF: Pass (sender SPF authorized) identity=mailfrom; client-ip=192.55.52.88; helo=mga01.intel.com; envelope-from=jiaxin.wu@intel.com; receiver=edk2-devel@lists.01.org Received: from mga01.intel.com (mga01.intel.com [192.55.52.88]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ml01.01.org (Postfix) with ESMTPS id 5C857211ACEC3 for ; Sun, 20 Jan 2019 10:21:48 -0800 (PST) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga005.jf.intel.com ([10.7.209.41]) by fmsmga101.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 20 Jan 2019 10:21:47 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.56,499,1539673200"; d="scan'208";a="293008795" Received: from fmsmsx104.amr.corp.intel.com ([10.18.124.202]) by orsmga005.jf.intel.com with ESMTP; 20 Jan 2019 10:21:47 -0800 Received: from fmsmsx155.amr.corp.intel.com (10.18.116.71) by fmsmsx104.amr.corp.intel.com (10.18.124.202) with Microsoft SMTP Server (TLS) id 14.3.408.0; Sun, 20 Jan 2019 10:21:47 -0800 Received: from shsmsx151.ccr.corp.intel.com (10.239.6.50) by FMSMSX155.amr.corp.intel.com (10.18.116.71) with Microsoft SMTP Server (TLS) id 14.3.408.0; Sun, 20 Jan 2019 10:21:46 -0800 Received: from shsmsx107.ccr.corp.intel.com ([169.254.9.239]) by SHSMSX151.ccr.corp.intel.com ([169.254.3.71]) with mapi id 14.03.0415.000; Mon, 21 Jan 2019 02:21:44 +0800 From: "Wu, Jiaxin" To: Leif Lindholm CC: "edk2-devel@lists.01.org" , "Wang, Fan" , "Ye, Ting" , "Li, Ruth" , "Kinney, Michael D" , "Fu, Siyuan" Thread-Topic: [edk2] [staging/UEFI_Redfish][PATCH v1] Announce to create "UEFI_Redfish" branch in edk2-staging. Thread-Index: AQHUrxI7DTJCFvmz5kqq/BJr1veOn6W0fHuAgAP+5YA= Date: Sun, 20 Jan 2019 18:21:43 +0000 Message-ID: <895558F6EA4E3B41AC93A00D163B727416EC6CB8@SHSMSX107.ccr.corp.intel.com> References: <20190118094240.17072-1-Jiaxin.wu@intel.com> <20190118131857.rmvlgdcbm4yr5u7s@bivouac.eciton.net> In-Reply-To: <20190118131857.rmvlgdcbm4yr5u7s@bivouac.eciton.net> Accept-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-titus-metadata-40: eyJDYXRlZ29yeUxhYmVscyI6IiIsIk1ldGFkYXRhIjp7Im5zIjoiaHR0cDpcL1wvd3d3LnRpdHVzLmNvbVwvbnNcL0ludGVsMyIsImlkIjoiYTg5MWQ0ZWYtYjFiNy00OGIwLWE0MGMtODkyOGMyOWFkMjU4IiwicHJvcHMiOlt7Im4iOiJDVFBDbGFzc2lmaWNhdGlvbiIsInZhbHMiOlt7InZhbHVlIjoiQ1RQX05UIn1dfV19LCJTdWJqZWN0TGFiZWxzIjpbXSwiVE1DVmVyc2lvbiI6IjE3LjEwLjE4MDQuNDkiLCJUcnVzdGVkTGFiZWxIYXNoIjoiTzFvVno5dnQxTVBhblZOWTBvWkNuUmhcL3AxZ1NqaVhkNHdNR2hQNE5HcWNzNnNrenNZOTNjMklUcFJXMWdQS28ifQ== x-ctpclassification: CTP_NT dlp-product: dlpe-windows dlp-version: 11.0.400.15 dlp-reaction: no-action x-originating-ip: [10.239.127.40] MIME-Version: 1.0 Subject: Re: [staging/UEFI_Redfish][PATCH v1] Announce to create "UEFI_Redfish" branch in edk2-staging. X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 20 Jan 2019 18:21:48 -0000 Content-Language: en-US Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Good suggestion. Thanks Leif. Already resubmit as version 2. =20 > -----Original Message----- > From: Leif Lindholm [mailto:leif.lindholm@linaro.org] > Sent: Friday, January 18, 2019 9:19 PM > To: Wu, Jiaxin > Cc: edk2-devel@lists.01.org; Wang, Fan ; Ye, Ting > ; Li, Ruth ; Kinney, Michael D > ; Fu, Siyuan > Subject: Re: [edk2] [staging/UEFI_Redfish][PATCH v1] Announce to create > "UEFI_Redfish" branch in edk2-staging. >=20 > Hi Jiaxin, >=20 > I am happy to see the creation of this branch. However, Could you > possibly resubmit this as a diff adding a Readme.md rather than > modifying it? >=20 > The diff against edk2/Readme.md is not really relevant, and confuses revi= ew. >=20 > (For example, in your branch, *delete* the existing Readme.md in a > separate commit, and then in the commit next *add* the one for the > branch. Only the *add* patch needs to be reviewed.) >=20 > Best Regards, >=20 > Leif >=20 > On Fri, Jan 18, 2019 at 05:42:40PM +0800, Jiaxin Wu wrote: > > UEFI_Redfish branch is to develop the UEFI Redfish feature. The code ba= se > > of development is based on the release of edk2-stable201811 tag. Please > > refer to the patch of Readme.md to get the detailed feature introductio= n. > > > > Note: The branch will be created by the end of Jan 28th if no objection= . > > > > Cc: Rothman Michael A > > Cc: Kinney Michael D > > Cc: Li Ruth > > Cc: Ye Ting > > Cc: Fu Siyuan > > Cc: Wang Fan > > Contributed-under: TianoCore Contribution Agreement 1.1 > > Signed-off-by: Wu Jiaxin > > --- > > Readme.md | 114 ++++++++++++++++++++++++++++++++++++++++------------ > -- > > 1 file changed, 85 insertions(+), 29 deletions(-) > > > > diff --git a/Readme.md b/Readme.md > > index 1ef0780ee0..b9b5ab38e2 100644 > > --- a/Readme.md > > +++ b/Readme.md > > @@ -1,29 +1,85 @@ > > -# EDK II Project > > - > > -A modern, feature-rich, cross-platform firmware development environmen= t > > -for the UEFI and PI specifications from www.uefi.org. > > - > > -Contributions to the EDK II open source project are covered by the > > -[TianoCore Contribution Agreement 1.1](Contributions.txt) > > - > > -The majority of the content in the EDK II open source project uses a > > -[BSD 2-Clause License](License.txt). The EDK II open source project c= ontains > > -the following components that are covered by additional licenses: > > -* [AppPkg/Applications/Python/Python- > 2.7.2/Tools/pybench](AppPkg/Applications/Python/Python- > 2.7.2/Tools/pybench/LICENSE) > > -* [AppPkg/Applications/Python/Python- > 2.7.2](AppPkg/Applications/Python/Python-2.7.2/LICENSE) > > -* [AppPkg/Applications/Python/Python- > 2.7.10](AppPkg/Applications/Python/Python-2.7.10/LICENSE) > > -* > [BaseTools/Source/C/BrotliCompress](BaseTools/Source/C/BrotliCompress/LIC > ENSE) > > -* > [MdeModulePkg/Library/BrotliCustomDecompressLib](MdeModulePkg/Library/ > BrotliCustomDecompressLib/LICENSE) > > -* [OvmfPkg](OvmfPkg/License.txt) > > -* > [CryptoPkg/Library/OpensslLib/openssl](CryptoPkg/Library/OpensslLib/opens= sl/ > LICENSE) > > - > > -The EDK II Project is composed of packages. The maintainers for each > package > > -are listed in [Maintainers.txt](Maintainers.txt). > > - > > -# Resources > > -* [TianoCore](http://www.tianocore.org) > > -* [EDK II](https://github.com/tianocore/tianocore.github.io/wiki/EDK-I= I) > > -* [Getting Started with EDK > II](https://github.com/tianocore/tianocore.github.io/wiki/Getting-Started= -with- > EDK-II) > > -* [Mailing > Lists](https://github.com/tianocore/tianocore.github.io/wiki/Mailing-List= s) > > -* [TianoCore Bugzilla](https://bugzilla.tianocore.org) > > -* [How To > Contribute](https://github.com/tianocore/tianocore.github.io/wiki/How-To- > Contribute) > > +This branch is used to develop the **UEFI Redfish Feature**. The code = base > of development is based on the release of **edk2-stable201811** tag. > > + > > +The branch owner: > > +Fu Siyuan , Ye Ting , Wang Fan > , Wu Jiaxin > > + > > +## Introduction > > +UEFI Redfish is an efficient and secure solution for end users to remo= te > control and configure UEFI pre-OS environment by leveraging the RESTful A= PI. > It's simple for end users to access the data from UEFI firmware defined i= n JSON > format. > > + > > +One of the design goals for UEFI Redfish solution is to provide a scal= able > implementation which allow users to easily add/remove/modify each > independent Redfish configure features (RedfishBiosDxe & RedfishBootInfoD= xe). > This is done by extracting the generic logic to a single UEFI driver mode= l driver > (RedfishConfigDxe), and several library instances (DxeRedfishLib & BaseJs= onLib). > > + > > +#### Supported Features > > + * Protocols > > + * EFI RestEx Service Binding Protocol > > + * EFI RestEx Protocol > > + * Redfish ConfigHandler Protocol > > + * Redfish Credential Protocol > > + > > + * Configuration Items via UEFI Redfish > > + * [ISCSI Boot Keywords](http://www.uefi.org/confignamespace). > > + * HII Opcodes/Questions marked with REST_SYTLE flag or in REST_SYT= LE > formset. > > + * BootOrder/BootNext variables. > > + > > + * Redfish Schemas > > + * > [AttributeRegistry](https://redfish.dmtf.org/schemas/v1/AttributeRegistry= .v1_1 > _0.json) > > + * > [ComputerSystemCollection](https://redfish.dmtf.org/schemas/ComputerSyste > mCollection.json) > > + * > [ComputerSystem](https://redfish.dmtf.org/schemas/v1/ComputerSystem.v1_5 > _0.json) > > + * [Bios](https://redfish.dmtf.org/schemas/v1/Bios.v1_0_2.json) > > + * > [BootOptionCollection](https://redfish.dmtf.org/schemas/BootOptionCollect= io > n.json) > > + * [BootOption](https://redfish.dmtf.org/schemas/BootOption.v1_0_0.= json) > > + > > + If any additional Redfish Schema or a new version of above Schemas= are > required to be supported, please send the email to edk2-devel mailing lis= t by > following [edk2-satging process](https://github.com/tianocore/edk2-stagin= g). > > + > > +#### Related Modules > > + The following modules are related to UEFI Redfish solution, **Redfis= hPkg** > is the new package to support UEFI Redfish solution: > > + * **RedfishPkg\RestExDxe\RestExDxe.inf** - UEFI driver to enable > standardized RESTful access to resources from UEFI environment. > > + > > + * **RedfishPkg\Library\DxeRedfishLib** - Library to > Create/Read/Update/Delete (CRUD) resources and provide basic query abilit= ies > by using [URI/RedPath](https://github.com/DMTF/libredfish). > > + > > + * **RedfishPkg\Library\BaseJsonLib** - Library to encode/decode JSON > data. > > + > > + * **RedfishPkg\RedfishConfigDxe\RedfishConfigDxe.inf** - UEFI driver= to > execute registered Redfish Configuration Handlers: > > + > > + * **RedfishPkg\Features\RedfishBiosDxe\RedfishBiosDxe.inf** - DXE > driver to register Redfish configuration handler to process "Bios" schema= and > "AttributeRegistry" schema. > > + > > + * > **RedfishPkg\Features\Features\RedfishBootInfoDxe\RedfishBootInfoDxe.inf* > * - DXE driver to register Redfish configuration handler to process Boot = property > defined in "ComputerSystem" schema. > > + > > + * Platform Components for NT32: > > + * **Nt32Pkg\RedfishPlatformDxe\RedfishPlatformDxe.inf** - UEFI sam= ple > platform driver for NT32 to fill the SMBIOS table 42 and publish Redfish > Credential info. > > + > > + * > **Nt32Pkg\Application\RedfishPlatformConfig\RedfishPlatformConfig.inf** - > UEFI application for NT32 to publish Redfish Host Interface Record. > > + > > + * Misc > > + * BaseTools - VfrCompile changes to support Rest Style Formset/Flag= . > > + > > + * MdePkg - Headers related to Rest Style Formset/Flag. > > + > > + * MdeModulePkg - Extract more general APIs in UefiHiiLib & DxeHttpL= ib & > DxeNetLib. > > + > > + * NetworkPkg - 1) UefiPxeBcDxe & HttpBootDxe: Consume new APIs > defined in DxeHttpLib & DxeNetLib. 2) HttpDxe: Cross-Subnet support. 3) > IScsiDxe: REST Style FORMSET support. > > + > > + * Nt32Pkg - 1) Enable UEFI Redfish feature in NT32 platform. 2) Fix= TLS build > error with CryptoPkg from edk2-stable201811 tag. > > + > > + > > +## Promote to edk2 Trunk > > +If a subset feature or a bug fix in this staging branch could meet bel= ow > requirement, it could be promoted to edk2 trunk and removed from this sta= ging > branch: > > +* Meet all edk2 required quality criteria. > > +* Support both IA32 and X64 Platform. > > +* Ready for product integration. > > + > > +## Timeline > > +| Time | Event | Related Modules | > > +|:----:|:-----:|:--------------:| > > +| 2019.01 | Initial open source release of UEFI Redfish feature. | Ref= er to > "Related Modules" | > > +|...|...|...| > > + > > +## Related Materials > > +1. DSP0270 - Redfish Host Interface Specification, 1.0.1 > > + > > +2. DSP0266 - Redfish Scalable Platforms Management API Specification, = 1.5.0 > > + > > +3. UEFI Configuration Namespace Registry - > http://www.uefi.org/confignamespace > > + > > +4. Redfish Schemas - https://redfish.dmtf.org/schemas/v1/ > > + > > +5. UEFI Specification - http://uefi.org/specifications > > -- > > 2.17.1.windows.2 > > > > _______________________________________________ > > edk2-devel mailing list > > edk2-devel@lists.01.org > > https://lists.01.org/mailman/listinfo/edk2-devel