From nobody Sun Dec 22 23:24:17 2024 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; spf=none (zoho.com: 198.145.21.10 is neither permitted nor denied by domain of lists.01.org) smtp.mailfrom=edk2-devel-bounces@lists.01.org Return-Path: Received: from ml01.01.org (ml01.01.org [198.145.21.10]) by mx.zohomail.com with SMTPS id 15211753381951007.3084462860091; Thu, 15 Mar 2018 21:42:18 -0700 (PDT) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id 9FCF222646316; Thu, 15 Mar 2018 21:35:50 -0700 (PDT) Received: from mga05.intel.com (mga05.intel.com [192.55.52.43]) (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 11B9822603AFC for ; Thu, 15 Mar 2018 21:35:49 -0700 (PDT) Received: from fmsmga006.fm.intel.com ([10.253.24.20]) by fmsmga105.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 15 Mar 2018 21:42:13 -0700 Received: from shwde7172.ccr.corp.intel.com ([10.239.9.15]) by fmsmga006.fm.intel.com with ESMTP; 15 Mar 2018 21:42:12 -0700 X-Original-To: edk2-devel@lists.01.org Received-SPF: none (zoho.com: 198.145.21.10 is neither permitted nor denied by domain of lists.01.org) client-ip=198.145.21.10; envelope-from=edk2-devel-bounces@lists.01.org; helo=ml01.01.org; Received-SPF: Pass (sender SPF authorized) identity=mailfrom; client-ip=192.55.52.43; helo=mga05.intel.com; envelope-from=liming.gao@intel.com; receiver=edk2-devel@lists.01.org X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.48,313,1517904000"; d="scan'208";a="211830220" From: Liming Gao To: edk2-devel@lists.01.org Date: Fri, 16 Mar 2018 12:41:52 +0800 Message-Id: <1521175314-6672-2-git-send-email-liming.gao@intel.com> X-Mailer: git-send-email 2.8.0.windows.1 In-Reply-To: <1521175314-6672-1-git-send-email-liming.gao@intel.com> References: <1521175314-6672-1-git-send-email-liming.gao@intel.com> Subject: [edk2] [Patch 1/3] DSCSpecification: Add syntax to support SKU ID inherit from another SKU ID X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Michael Kinney MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Errors-To: edk2-devel-bounces@lists.01.org Sender: "edk2-devel" X-ZohoMail: RSF_4 Z_629925259 SPT_0 Content-Type: text/plain; charset="utf-8" Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Liming Gao Cc: Michael Kinney Cc: Yonghong Zhu Reviewed-by: Yonghong Zhu =20 --- 2_dsc_overview/25_[skuids]_section_processing.md | 11 +++++++---- 3_edk_ii_dsc_file_format/37_[skuids]_section.md | 10 ++++++---- 2 files changed, 13 insertions(+), 8 deletions(-) diff --git a/2_dsc_overview/25_[skuids]_section_processing.md b/2_dsc_overv= iew/25_[skuids]_section_processing.md index afd102e..70b98b1 100644 --- a/2_dsc_overview/25_[skuids]_section_processing.md +++ b/2_dsc_overview/25_[skuids]_section_processing.md @@ -34,16 +34,19 @@ The contents of this section are used to define valid `SKUID_IDENTIFIER` n= ames. Since a platform may support different SKUs, and different SKUs may implem= ent different methods for handing platform configuration data (PCD) the user c= an -define, in this section, tag names to use. Use `0` for the `DEFAULT` SKU -identifier. Each entry below the section header is of the form: +define, in this section, tag names to use. One SKU may override some setti= ngs=20 +in another SKU setting, and inherit other setting from it. If not specifie= d,=20 +SKU will inherit DEFAULT SKU setting. Use `0` for the `DEFAULT` SKU identi= fier.=20 +Each entry below the section header is of the form: =20 -`Number | word` +`Number | word [|word]` =20 The following is an example of a `[SkuIds]` section: =20 ``` [SkuIds] + 0|DEFAULT 1|Sku_Two 22|Sku1 - 5|SkuSeven + 5|SkuSeven | Sku1 #SkuSeven inherits Sku1 setting. ``` diff --git a/3_edk_ii_dsc_file_format/37_[skuids]_section.md b/3_edk_ii_dsc= _file_format/37_[skuids]_section.md index 756ded2..8e70b33 100644 --- a/3_edk_ii_dsc_file_format/37_[skuids]_section.md +++ b/3_edk_ii_dsc_file_format/37_[skuids]_section.md @@ -37,8 +37,9 @@ The `[SkuIds]` section is optional in all EDK II DSC file= s. =20 Entries may appear in any order. This section lists numeric mappings to th= e SKU ID User Interface Name, only valid values from this list can be specified = in -the defines section. Use of the `!include` statement is supported; it is -recommended that a ".txt" extension be used. +the defines section. If one SKU inherits from none DEFAULT SKU, it can spe= cify=20 +its parent SKU User Name after its definition. Use of the `!include` state= ment=20 +is supported; it is recommended that a ".txt" extension be used. =20 If this section is not specified, the parsing tools will assume a SkuId of= 0, with a `UiName` of "DEFAULT". The default entry must not be re-defined. @@ -51,7 +52,7 @@ The `!include` file can only contain an ASCII (not Unicod= e) list of ```c ::=3D "[SkuIds]" {*} {} - ::=3D + ::=3D [ ] ::=3D ``` =20 @@ -60,5 +61,6 @@ The `!include` file can only contain an ASCII (not Unicod= e) list of ```ini [SkuIds] 0|DEFAULT # The entry: 0|DEFAULT is reserved and always required. - 1|SkuTwo + 1|SkuOne + 2|SkuTwo|SkuOne # SkuTwo setting inherits from SkuOne ``` --=20 2.8.0.windows.1 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel From nobody Sun Dec 22 23:24:17 2024 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; spf=none (zoho.com: 198.145.21.10 is neither permitted nor denied by domain of lists.01.org) smtp.mailfrom=edk2-devel-bounces@lists.01.org Return-Path: Received: from ml01.01.org (ml01.01.org [198.145.21.10]) by mx.zohomail.com with SMTPS id 152117534094912.267906730881009; Thu, 15 Mar 2018 21:42:20 -0700 (PDT) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id 10A502264D230; Thu, 15 Mar 2018 21:35:53 -0700 (PDT) Received: from mga05.intel.com (mga05.intel.com [192.55.52.43]) (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 314A1226462FC for ; Thu, 15 Mar 2018 21:35:49 -0700 (PDT) Received: from fmsmga006.fm.intel.com ([10.253.24.20]) by fmsmga105.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 15 Mar 2018 21:42:14 -0700 Received: from shwde7172.ccr.corp.intel.com ([10.239.9.15]) by fmsmga006.fm.intel.com with ESMTP; 15 Mar 2018 21:42:13 -0700 X-Original-To: edk2-devel@lists.01.org Received-SPF: none (zoho.com: 198.145.21.10 is neither permitted nor denied by domain of lists.01.org) client-ip=198.145.21.10; envelope-from=edk2-devel-bounces@lists.01.org; helo=ml01.01.org; Received-SPF: Pass (sender SPF authorized) identity=mailfrom; client-ip=192.55.52.43; helo=mga05.intel.com; envelope-from=liming.gao@intel.com; receiver=edk2-devel@lists.01.org X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.48,313,1517904000"; d="scan'208";a="211830229" From: Liming Gao To: edk2-devel@lists.01.org Date: Fri, 16 Mar 2018 12:41:53 +0800 Message-Id: <1521175314-6672-3-git-send-email-liming.gao@intel.com> X-Mailer: git-send-email 2.8.0.windows.1 In-Reply-To: <1521175314-6672-1-git-send-email-liming.gao@intel.com> References: <1521175314-6672-1-git-send-email-liming.gao@intel.com> Subject: [edk2] [Patch 2/3] DscSpecification: Add DefaultStores section to describe the default setting X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Michael Kinney MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Errors-To: edk2-devel-bounces@lists.01.org Sender: "edk2-devel" X-ZohoMail: RSF_4 Z_629925259 SPT_0 Content-Type: text/plain; charset="utf-8" Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Liming Gao Cc: Michael Kinney Cc: Yonghong Zhu Reviewed-by: Yonghong Zhu =20 --- .../213_[defaultstores]_section_processing.md | 49 ++++++++++++ 3_edk_ii_dsc_file_format/310_pcd_sections.md | 86 ++++++++++++++++++= ++-- .../313_[defaultstores]_section.md | 60 +++++++++++++++ 3 files changed, 190 insertions(+), 5 deletions(-) create mode 100644 2_dsc_overview/213_[defaultstores]_section_processing.md create mode 100644 3_edk_ii_dsc_file_format/313_[defaultstores]_section.md diff --git a/2_dsc_overview/213_[defaultstores]_section_processing.md b/2_d= sc_overview/213_[defaultstores]_section_processing.md new file mode 100644 index 0000000..88a7ad2 --- /dev/null +++ b/2_dsc_overview/213_[defaultstores]_section_processing.md @@ -0,0 +1,49 @@ + + +## 2.13 [DefaultStores] Section Processing + +The contents of this section are used to define DefaultStores names. Defau= lt=20 +store is UEFI HII concept. It is used to define HII default setting for th= e=20 +different store, such as standard default, manufacturing default. Platform=20 +can define the supported default store for DynamicHii/DynamicExHii PCD in = this=20 +section, tag name to be used. This section is optional. By default, standa= rd=20 +default will be used. Each entry below the section header is of the form: + +`Number | word` + +The following is an example of a `[DefaultStores]` section: + +``` +[DefaultStores] + 0 | Standard # UEFI Standard default + 1 | Manufacturing # UEFI Manufacturing default +``` diff --git a/3_edk_ii_dsc_file_format/310_pcd_sections.md b/3_edk_ii_dsc_fi= le_format/310_pcd_sections.md index 18a243d..f79a0fd 100644 --- a/3_edk_ii_dsc_file_format/310_pcd_sections.md +++ b/3_edk_ii_dsc_file_format/310_pcd_sections.md @@ -1,7 +1,7 @@ + +## 3.13 [DefaultStores] Section + +The `[DefaultStores]` section is optional in all EDK II DSC files. + +#### Summary + +Entries may appear in any order. This section lists numeric mappings to th= e=20 +Default Store User Interface Name, only valid values from this list can be=20 +specified in the PcdsDynamicHii/PcdsDynamicExHii section. + +If this section is not specified, the parsing tools will assume standard d= efault +be applied in PcdsDynamicHii/PcdsDynamicExHii section. + +#### Prototype + +```c + ::=3D "[DefaultStores]" + {*} + ::=3D + ::=3D +``` + +#### Example + +```ini +[DefaultStores] + 0 | Standard # UEFI Standard default + 1 | Manufacturing # UEFI Manufacturing default +``` --=20 2.8.0.windows.1 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel From nobody Sun Dec 22 23:24:17 2024 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; spf=none (zoho.com: 198.145.21.10 is neither permitted nor denied by domain of lists.01.org) smtp.mailfrom=edk2-devel-bounces@lists.01.org Return-Path: Received: from ml01.01.org (ml01.01.org [198.145.21.10]) by mx.zohomail.com with SMTPS id 1521175343285547.0077461582183; Thu, 15 Mar 2018 21:42:23 -0700 (PDT) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id 8DCDE2264D237; Thu, 15 Mar 2018 21:35:53 -0700 (PDT) Received: from mga05.intel.com (mga05.intel.com [192.55.52.43]) (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 23F54226462FC for ; Thu, 15 Mar 2018 21:35:50 -0700 (PDT) Received: from fmsmga006.fm.intel.com ([10.253.24.20]) by fmsmga105.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 15 Mar 2018 21:42:14 -0700 Received: from shwde7172.ccr.corp.intel.com ([10.239.9.15]) by fmsmga006.fm.intel.com with ESMTP; 15 Mar 2018 21:42:14 -0700 X-Original-To: edk2-devel@lists.01.org Received-SPF: none (zoho.com: 198.145.21.10 is neither permitted nor denied by domain of lists.01.org) client-ip=198.145.21.10; envelope-from=edk2-devel-bounces@lists.01.org; helo=ml01.01.org; Received-SPF: Pass (sender SPF authorized) identity=mailfrom; client-ip=192.55.52.43; helo=mga05.intel.com; envelope-from=liming.gao@intel.com; receiver=edk2-devel@lists.01.org X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.48,313,1517904000"; d="scan'208";a="211830235" From: Liming Gao To: edk2-devel@lists.01.org Date: Fri, 16 Mar 2018 12:41:54 +0800 Message-Id: <1521175314-6672-4-git-send-email-liming.gao@intel.com> X-Mailer: git-send-email 2.8.0.windows.1 In-Reply-To: <1521175314-6672-1-git-send-email-liming.gao@intel.com> References: <1521175314-6672-1-git-send-email-liming.gao@intel.com> Subject: [edk2] [Patch 3/3] DscSpecification: Add structure PCD field value assignment syntax X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Michael Kinney MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Errors-To: edk2-devel-bounces@lists.01.org Sender: "edk2-devel" X-ZohoMail: RSF_4 Z_629925259 SPT_0 Content-Type: text/plain; charset="utf-8" Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Liming Gao Cc: Michael Kinney Cc: Yonghong Zhu Reviewed-by: Yonghong Zhu =20 --- 2_dsc_overview/28_pcd_section_processing.md | 10 ++++++---- 3_edk_ii_dsc_file_format/310_pcd_sections.md | 19 +++++++++++----= ---- .../33_platform_dsc_definition.md | 6 +++++- 3 files changed, 22 insertions(+), 13 deletions(-) diff --git a/2_dsc_overview/28_pcd_section_processing.md b/2_dsc_overview/2= 8_pcd_section_processing.md index 1adde81..4c5d952 100644 --- a/2_dsc_overview/28_pcd_section_processing.md +++ b/2_dsc_overview/28_pcd_section_processing.md @@ -1,7 +1,7 @@