From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from NAM11-CO1-obe.outbound.protection.outlook.com (NAM11-CO1-obe.outbound.protection.outlook.com [40.107.220.82]) by mx.groups.io with SMTP id smtpd.web10.12516.1679844868927185504 for ; Sun, 26 Mar 2023 08:34:29 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@amd.com header.s=selector1 header.b=0EOPHMBM; spf=permerror, err=parse error for token &{10 18 %{i}._ip.%{h}._ehlo.%{d}._spf.vali.email}: invalid domain name (domain: amd.com, ip: 40.107.220.82, mailfrom: abner.chang@amd.com) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=XkumU5EVJHpaXcqdl+GaYwcmry/ay5+skZ79mM/80gvRM59GsE3uMX7U+4z8baujpWSaAuDdN4O316jP7AMF80KckAW1igP3zStT72FIrJfWeWv88QIgqWcWM9kHFU6BV0qYd+uiYWr/8j/MxXTDmfjDydUwjI3oslVcLIBmy+w6z6rV+NklWn79HyF6kAtmoEnRqmFo82/lhwwKfHgBy5gnakE1AyXOZQN3RU0kFSwIKnrynehapIpOxkadFOv+rbHm68ZN9N/hYdkAVLAbAFESju0eyFPs15yXGYUOY8nkc/jnXXQMpMd3RTaCWbZ29694aP+XEG3hMJbL5dkOSA== 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-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=IY/HdcDfiR3p99SZy18Q1kowTuvMaiTOelFvKOxPAeQ=; b=PUvRJsBCQgQ2zr/8nOFnOdAteDCwi+qjSos832lGcYswoux2IW41bYIqSi8uWNM3DOtZSS0PJD1YnEAK/7gGyipPv7vXPqrciNtFk6LLom7/lAE2wdyGLXqgSEU/y/KS9DTTFJP8cXv9tcXnBvBz9V0OOCvFEgKCLtcJirkQALcjKM9ALM9vMEg3Sdy0EA4Ts9Ev19o0NBCe1C1zIfftjyVyBXYY3CUwMr2whyVYUXyWJe1yHPWx50/kbD5w9hPnvtJf9T2RzZ8qNEk27LRYj7M0U5tAN3hgpgq96ytSP7lZ9PTH/M30Vw463/ANRsBj+AYFiahi29MCoFw8JQj/gA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=amd.com; dmarc=pass action=none header.from=amd.com; dkim=pass header.d=amd.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amd.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=IY/HdcDfiR3p99SZy18Q1kowTuvMaiTOelFvKOxPAeQ=; b=0EOPHMBMRFzsv0xHcc44nnxAObQ7hUUP/lI+3ByACXy2VQclYtysaiG1vCYJ8UeJWmU5J1/kc9rutWtGLyjwLN0IDRqvFxtCN5THLh/9R08+eEMB/XquC2KCwCitX2PG1QkiJp/iOgkbJJT++pwcdjZTs2cKu8HBWBSkG3V6SbE= Received: from CH2PR12MB3957.namprd12.prod.outlook.com (2603:10b6:610:2c::17) by BY5PR12MB4100.namprd12.prod.outlook.com (2603:10b6:a03:200::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6178.41; Sun, 26 Mar 2023 15:34:26 +0000 Received: from CH2PR12MB3957.namprd12.prod.outlook.com ([fe80::356e:95ec:357b:3472]) by CH2PR12MB3957.namprd12.prod.outlook.com ([fe80::356e:95ec:357b:3472%7]) with mapi id 15.20.6178.041; Sun, 26 Mar 2023 15:34:26 +0000 From: "Chang, Abner" To: "rfc@edk2.groups.io" CC: "devel@edk2.groups.io" , "michael.d.kinney@intel.com" , Liming Gao Subject: Introduce a new repo "edk2-redfish-client" under Tianocore Github Thread-Topic: Introduce a new repo "edk2-redfish-client" under Tianocore Github Thread-Index: Adlf+FXRXZ0/OYRcQ6qvKKBuiSwlAQ== Date: Sun, 26 Mar 2023 15:34:25 +0000 Message-ID: Accept-Language: zh-CN, en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: msip_labels: MSIP_Label_4342314e-0df4-4b58-84bf-38bed6170a0f_Enabled=true; MSIP_Label_4342314e-0df4-4b58-84bf-38bed6170a0f_SetDate=2023-03-26T15:34:23Z; MSIP_Label_4342314e-0df4-4b58-84bf-38bed6170a0f_Method=Standard; MSIP_Label_4342314e-0df4-4b58-84bf-38bed6170a0f_Name=General; MSIP_Label_4342314e-0df4-4b58-84bf-38bed6170a0f_SiteId=3dd8961f-e488-4e60-8e11-a82d994e183d; MSIP_Label_4342314e-0df4-4b58-84bf-38bed6170a0f_ActionId=b679360a-476c-436e-a0ae-4dd3559b21ed; MSIP_Label_4342314e-0df4-4b58-84bf-38bed6170a0f_ContentBits=1 authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=amd.com; x-ms-publictraffictype: Email x-ms-traffictypediagnostic: CH2PR12MB3957:EE_|BY5PR12MB4100:EE_ x-ms-office365-filtering-correlation-id: 5b2132ea-bd7a-4bcf-d684-08db2e0f94de x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: CQpPNhnXsQdxe/zUq1rDlTws+upA9WbMm0glOQBzXcNAFa9uYPhnjsQEsMPpqU7uRJwQE219g66T44BRQXsn80CEczWoPQdYDsAPpEHSaGahD/I/Wtju0KJOOhjknfUsGcB7llSA4c0Wz7Q+sm7ASCyu5fZQyb6R44AvgDDQD36IAsE7uqTGHVVjCFtUKA4YRSvj5U4ZErDFOXF5MakvVorbOOx18rCPEao0ugXSTihBsFcOh0eQCCQhNkignvWPw69nemMQFINaquTZ8JEO0ik07WJrWY6d8/If7+Z+NlV+oLjf9wuVVY6JbJqij7dDVO0sf2VH9dJQ4WPVVAFl9UhlQTWKqRNO0kGJuTelU2B6FDmyiO4N+YIJ0scWnV61NyELgOeVAglqQyYg8vD9O+PdTffhUuanHvmrjSFQhjCpmgGOnxK4HwiGzIEZkS4Cedur2Ka3b1TFca+i0ATiIOSxEh0ZZo7Podo8pf2NtHgxZDUeDcAZ4k7ReMfebwN+iu+xQIw98+9Y2gvZtle/fBbAR7BCilDtjM+ZinCJYqLOLoAwQlQWjocBdciBcSvEdiGdCHsEaagdsEORHin+2oG+tjK2Wtc7iw5ZNV3JM/NR0CczKgjRueUELzS9EO5wKjHOIbJYHpQ2FhJDdeigPw== x-forefront-antispam-report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:CH2PR12MB3957.namprd12.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230028)(4636009)(346002)(396003)(366004)(39850400004)(376002)(136003)(451199021)(9686003)(186003)(55016003)(4326008)(6916009)(41300700001)(7696005)(66899021)(966005)(83380400001)(6506007)(26005)(71200400001)(478600001)(316002)(54906003)(76116006)(38100700002)(2906002)(166002)(8676002)(66446008)(64756008)(66946007)(66556008)(66476007)(33656002)(122000001)(38070700005)(86362001)(52536014)(5660300002)(8936002);DIR:OUT;SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?uCS7OqOsUQbfl2SJdZ9bh5vfAXkPSv9jnT+/PAPaGNbhPNIGh5S+dTkWwCLg?= =?us-ascii?Q?xYjUxqCfWHPLCk2PRza8qyhO54Zz6hh4pSolT584ZUtW+XC5VAxw39WXnndH?= =?us-ascii?Q?19O8A4zQf0axtIS6//aW9dUk9zChTrJPZksOvJhkOiJtqj5bSmx4197Ov8p7?= =?us-ascii?Q?rw4sMHgiZ7ffrxl8/u8LDVJy0PY5ew/i5pMR9QVJ0Xq6eSMiDwIMHLGD4YGi?= =?us-ascii?Q?7Ui70yFUFYzdpjtiVz/ZbfMpkXyZvy+sucLfrNThBC72qkgSpoNRhMHdk+6A?= =?us-ascii?Q?IHqz0zD1qkV9kFPhej+cND87NVq6Ttnmxr29juRMfi1mUKy++SUjduYG3kPY?= =?us-ascii?Q?9voPfN1+MsweF73nsGJPrIXOSjfZEkrgkKMrCwo6e4ozLuigRdLYO6vGh31i?= =?us-ascii?Q?S7ytBft9ZoVRLiSJGWni5ABU7VA8+gREdO8RlUyGFP87l89pst2yCTwFY7KZ?= =?us-ascii?Q?Aj7lNXB+0Y/fZ+NVKIGjrM8i/OOvl/4vxNWzaIdhnVkk2TzKiQOyx5KU/Npt?= =?us-ascii?Q?zsvi37Bco0xZR3goc+4xN7DeWr8szCbpIlkm1YDSo5mGmiF1dyQYlxTHcO7I?= =?us-ascii?Q?E0dymuNn0JfHNWbW46ho0obZa2sK+ebTIcadXuHx9WTnik81iCRB0CDAem0y?= =?us-ascii?Q?RXqPwWDEsVPkZi+OYZXXbqt4DUZFTsIzhPYhpPBumjiluEY45OGPWGkopzpZ?= =?us-ascii?Q?jSUXi3BO3QDutjvnLNsmNj6P1G0QQm2j8e0SP+3DiBc9wgAADDSRfu04ZPvd?= =?us-ascii?Q?KeDC5ZkIsXqPJMRnSz+JJt+kelQj9Y6SQn4Upx1Q8W3Mwm0wIY/mBHJxzJl6?= =?us-ascii?Q?o61LRlg6b+Zl6O4O3MWUFlz4wS9bG5z6LrQ+kg9YyTltEdQNRM4V3sjRPe3r?= =?us-ascii?Q?pmgealzwTp0XL8mpvWLfSU8/9VvAK29FepwdiGSxQxjAeE9xNZzgPmArIpiS?= =?us-ascii?Q?7s0GNgoXKjZEkVycV16vUGdERuTOe5KKmIelaUqm73CMqjcJe1NUrSthjmAu?= =?us-ascii?Q?VYvj+RfdZ/RcqsHFYpwZ45YdmoxxJOpDN2cRrRipGXAGj4iBh1JZEy1u7v+e?= =?us-ascii?Q?sSFQwnooVs/Q+q/c7/voD6bVxRFFfvbXOkxZwrWYTC6vyHH+a3HBOhOiAZsl?= =?us-ascii?Q?NY4RBPyTpq59S4iZ0mLj+Ef+5A0hVl+1arAY8073EH8UYleNOJfADc03ZuDY?= =?us-ascii?Q?rDTptpXk7O4EpTvc5YXXQ7ExT/lgQ+DjPYUH7mnV3uzGJBH/Umiiwn3ZmMBZ?= =?us-ascii?Q?cY4NpJAOJcAmqe4JElnPQnvuXGZXtWFOcD6nSDW+nPja9xxXUXVRV+uOOMsY?= =?us-ascii?Q?bDD4CZOZdEf3SRLNLA1Ophl7bPJGXPAiJRgTu4I9A7doimzIQfpszOKNisiT?= =?us-ascii?Q?4c2Qb1hCKA000PUpFT2xMan28++KmJ05b3nP9v5Wv+yeVCIglfFWzezKlwaj?= =?us-ascii?Q?kh8bb3trV+xwXJM33CopHv1W21fEwJXF002Z1YxxreqLT2DyIlCv4bCBqAq9?= =?us-ascii?Q?jdgQhY/QXjCwINVu1zQ8/9d8yAP26ZJ1f1iNPGqjbclrX+Z/xs2DLjmDJdsa?= =?us-ascii?Q?4CgvbvLsQnY+EElhhAE=3D?= MIME-Version: 1.0 X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: CH2PR12MB3957.namprd12.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 5b2132ea-bd7a-4bcf-d684-08db2e0f94de X-MS-Exchange-CrossTenant-originalarrivaltime: 26 Mar 2023 15:34:25.9607 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: iuWJEtxs9SbDhDkyNvjovG552/Vtotp4EcqxGPDPwkxzPDe5WLpEJro6cHcu4kaUN9te11kbgMj8iKnrlByffw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: BY5PR12MB4100 Content-Language: en-US Content-Type: multipart/alternative; boundary="_000_CH2PR12MB3957FB29881C636CC41BE8EEEA8A9CH2PR12MB3957namp_" --_000_CH2PR12MB3957FB29881C636CC41BE8EEEA8A9CH2PR12MB3957namp_ Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable [AMD Official Use Only - General] Hi edk2 community, We are proposing to introduce a new repository under Tianocore Github which= is edk2-redfish-client. The plan is to have RedfishClientPkg, Redfish simu= lator and python script that generates edk2 Redfish client drivers under ed= k2-redfish-client repo. edk2-redfish-client, refer to https://github.com/tianocore/edk2-staging/tre= e/edk2-redfish-client/RedfishClientPkg, which is a PoC project (already pro= ved) that provides the mechanism to map HII options (which has the correspo= nding "x-uefi-redfish-$NAMESPACE" language in UNI file) to Redfish properti= es defined in Redfish schema data model. Here is the readme for edk2-redfish-client https://github.com/tianocore/edk= 2-staging/blob/edk2-redfish-client/RedfishClientPkg/Readme.md that delineat= es the mechanism of RedfishClientPkg. In order to provide a simple solution= for edk2 developers, auto-generated source files those are produced by pyt= hon script is required to be built with edk2 firmware to connect HII option= s with Redfish properties. There are two python scripts that generate the n= ecessary edk2 drivers and libraries. * Redfish C to JSON convertor (https://github.com/DMTF/Redfish-Schema-C= -Struct-Generator) This generates edk2 driver modules that compliant with UEFI spec 31.2 EFI R= edfish JSON Structure Converter Auto-generated Source files: https://github.com/tianocore/edk2-staging/tree= /edk2-redfish-client/RedfishClientPkg/ConverterLib and https://github.com/t= ianocore/edk2-staging/tree/edk2-redfish-client/RedfishClientPkg/Converter * Redfish Feature drivers generator (not upstream yet, plan to upstream= that script under edk2-redfish-client. This generates edk2 drivers that act as intermediary layer between HII and = Redfish property and delivers Redfish payload through driver stack provided= by RedfishPkg under edk2 repo. Files: https://github.com/tianocore/edk2-staging/tree/edk2-redfish-client/R= edfishClientPkg/Features You can see that from Redfish schemas (https://www.dmtf.org/sites/default/f= iles/standards/documents/DSP8010_2022.3_0.zip), each Redfish schema introdu= ces more than one version as time goes on. How many Redfish schemas and whi= ch version of Redfish schema are used on system is at discretion of OEM. Cu= rrently there are 3,767 schema files, those schemas propagate ten times of = schema files for above auto-generated files. Of course, platform firmware i= s not able to pull in all of those files. Platform firmware only picks up t= he corresponding auto-generated files for the Redfish schemas and particula= r version those are supported on their system. There is an ongoing edk2 bui= ld tool task that supports to automatically pick up the auto-generated file= s according to "x-uefi-Redfish-" language used in HII form set. We currentl= y had implementation in https://github.com/tianocore/edk2-staging/blob/edk2= -redfish-client/RedfishClientPkg/RedfishJsonStructureDxe.dsc.inc, but edk2 = build tool work is not ready yet. However, edk2 platform developer can stil= l pull in the necessary edk2 Redfish client modules to platform metafiles m= anually. According to above scenario, we are not going to accommodate those files un= der edk2 or edk2-platform repos. Having a separate repo under Tianocore is = a way for edk2 developer to clone the repo when their project requires Redf= ish edk2 firmware support. Maintainers of this repo is also responsible to = update the files when every time Redfish WG releases the new version of Red= fish schema. Your input is welcome. Thanks Abner --_000_CH2PR12MB3957FB29881C636CC41BE8EEEA8A9CH2PR12MB3957namp_ Content-Type: text/html; charset="us-ascii" Content-Transfer-Encoding: quoted-printable

[AMD Official Use O= nly - General]


Hi edk2 community,

We are proposing to introduce a new repository under= Tianocore Github which is edk2-redfish-client. The plan is to have Redfish= ClientPkg, Redfish simulator and python script that generates edk2 Redfish = client drivers under edk2-redfish-client repo.

edk2-redfish-client, refer to https://github.com/tianocore/edk2-staging/tree/edk2-redfish-client/RedfishC= lientPkg, which is a PoC project (already proved) that provides the mec= hanism to map HII options (which has the corresponding “x-uefi-redfis= h-$NAMESPACE“ language in UNI file) to Redfish properties defined in Redfish schema data model.

Here is the readme for edk2-redfish-client https://github.com/tianocore/edk2-staging/blob/edk2-redfish-client/RedfishC= lientPkg/Readme.md that delineates the mechanism of RedfishClientPkg. I= n order to provide a simple solution for edk2 developers, auto-generated so= urce files those are produced by python script is required to be built with edk2 firmware to connect HII op= tions with Redfish properties. There are two python scripts that generate t= he necessary edk2 drivers and libraries.

This generates edk2 driver modules that compl= iant with UEFI spec 31.2 EFI Redfish JSON Structure Converter

Auto-generated Source files: https://github.com/tianocore/edk2-staging/tree/edk2-redfish-client/RedfishC= lientPkg/ConverterLib and https://github.com/tianocore/edk2-staging/tree/edk2-redfish-client/RedfishC= lientPkg/Converter

 

  • Redfish Feature drivers generator (not upstream yet, plan to upstream= that script under edk2-redfish-client.

This generates edk2 drive= rs that act as intermediary layer between HII and Redfish property and deli= vers Redfish payload through driver stack provided by RedfishPkg under edk2= repo.

Files: https://github.com/tianocore/edk2-staging/tree/edk2-redfish-client/RedfishC= lientPkg/Features

 

You can see that from Redfish schemas (https://www.dmtf.org/sites/default/files/standards/documents/DSP8010_= 2022.3_0.zip), each Redfish schema introduces more than one version as time goes on. How many Redfish schemas= and which version of Redfish schema are used on system is at discretion of= OEM. Currently there are 3,767 schema files, those schemas propagate ten t= imes of schema files for above auto-generated files. Of course, platform firmware is not able to pull in all of those fi= les. Platform firmware only picks up the corresponding auto-generated files= for the Redfish schemas and particular version those are supported on thei= r system. There is an ongoing edk2 build tool task that supports to automatically pick up the auto-generated = files according to “x-uefi-Redfish-“ language used in HII form = set. We currently had implementation in https://github.com/tianocore/edk2-staging/blob/edk2-redfish-client/RedfishC= lientPkg/RedfishJsonStructureDxe.dsc.inc, but edk2 build tool work is n= ot ready yet. However, edk2 platform developer can still pull in the necess= ary edk2 Redfish client modules to platform metafiles manually.

 

According to above scenario, we are not going to acc= ommodate those files under edk2 or edk2-platform repos. Having a separate r= epo under Tianocore is a way for edk2 developer to clone the repo when thei= r project requires Redfish edk2 firmware support. Maintainers of this repo is also responsible to update the files = when every time Redfish WG releases the new version of Redfish schema.=

Your input is welcome.

Thanks

Abner

 

 

 

--_000_CH2PR12MB3957FB29881C636CC41BE8EEEA8A9CH2PR12MB3957namp_--