From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail05.groups.io (mail05.groups.io [45.79.224.7]) by spool.mail.gandi.net (Postfix) with ESMTPS id 42B86D802E7 for ; Thu, 23 May 2024 07:47:33 +0000 (UTC) DKIM-Signature: a=rsa-sha256; bh=uWAaTXdRxESnVbfWPtLcnmZ2DKOUrfci2rQ5v+omwXU=; c=relaxed/simple; d=groups.io; h=From:To:CC:Subject:Thread-Topic:Thread-Index:Date:Message-ID:References:In-Reply-To:Accept-Language:msip_labels:MIME-Version:Precedence:List-Subscribe:List-Help:Sender:List-Id:Mailing-List:Delivered-To:Resent-Date:Resent-From:Reply-To:List-Unsubscribe-Post:List-Unsubscribe:Content-Language:Content-Type:Content-Transfer-Encoding; s=20240206; t=1716450451; v=1; b=b3MbG1rZYEFoWFlLs2oQvsjT11Kekp02oPoeJur1wzZR+Ffb522igVMrmpHgfd2chwUSpMHw 68OpSbgMgrm2do1ZBfs+eja8gaBjpyGaSx8tV5e6ko2S1zRHAiY2EFs4P/4mzjyc5uLcW5/Ui1k vzuGlEc2rrqpFGXY6CrqtAaf67lRNKJd3WTjU6ahKeb18FZLFyzfEbbtiBmrpcNya22ncbCICFc GGYdWh/IzsvQf+CdDpu/E2tijRnuKFuDEeWAyKtpyDMgj7Txilza3IqDrSOBiTv+qj/lY6iUWx1 VMpZFMwDV8n5/TpsUXjD9Z6Ls76RbRDkK45Oujn0Lt50A== X-Received: by 127.0.0.2 with SMTP id 9k2zYY7687511xfprpmbZdRg; Thu, 23 May 2024 00:47:31 -0700 X-Received: from NAM11-BN8-obe.outbound.protection.outlook.com (NAM11-BN8-obe.outbound.protection.outlook.com [40.107.236.59]) by mx.groups.io with SMTP id smtpd.web10.10121.1716450450564038405 for ; Thu, 23 May 2024 00:47:30 -0700 X-Received: from DS0PR12MB9445.namprd12.prod.outlook.com (2603:10b6:8:1a1::19) by CH3PR12MB8073.namprd12.prod.outlook.com (2603:10b6:610:126::8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7587.36; Thu, 23 May 2024 07:47:25 +0000 X-Received: from DS0PR12MB9445.namprd12.prod.outlook.com ([fe80::a499:b8c8:dccb:9bfc]) by DS0PR12MB9445.namprd12.prod.outlook.com ([fe80::a499:b8c8:dccb:9bfc%5]) with mapi id 15.20.7611.016; Thu, 23 May 2024 07:47:25 +0000 From: "Zhai, MingXin (Duke) via groups.io" To: "Chang, Abner" , "devel@edk2.groups.io" CC: "Grimes, Paul" , "Attar, AbdulLateef (Abdul Lateef)" , "Fu, Igniculus" , "Yao, Ken" , "Xing, Eric" Subject: Re: [edk2-devel] [edk2-platforms][PATCH 2/3] Platform/AMD: Update Readme.md Thread-Topic: [edk2-platforms][PATCH 2/3] Platform/AMD: Update Readme.md Thread-Index: AQHarMd7c57XtqSgHU2ZwiqOv3Px6rGkcUwg Date: Thu, 23 May 2024 07:47:24 +0000 Message-ID: References: <20240523041209.1661-1-abner.chang@amd.com> <20240523041209.1661-2-abner.chang@amd.com> In-Reply-To: <20240523041209.1661-2-abner.chang@amd.com> Accept-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: msip_labels: MSIP_Label_dce362fe-1558-4fb5-9f64-8a6240d76441_ActionId=02edfef9-b73a-463c-8c33-e298690dc840;MSIP_Label_dce362fe-1558-4fb5-9f64-8a6240d76441_ContentBits=0;MSIP_Label_dce362fe-1558-4fb5-9f64-8a6240d76441_Enabled=true;MSIP_Label_dce362fe-1558-4fb5-9f64-8a6240d76441_Method=Standard;MSIP_Label_dce362fe-1558-4fb5-9f64-8a6240d76441_Name=AMD Internal Distribution Only;MSIP_Label_dce362fe-1558-4fb5-9f64-8a6240d76441_SetDate=2024-05-23T07:47:15Z;MSIP_Label_dce362fe-1558-4fb5-9f64-8a6240d76441_SiteId=3dd8961f-e488-4e60-8e11-a82d994e183d; x-ms-publictraffictype: Email x-ms-traffictypediagnostic: DS0PR12MB9445:EE_|CH3PR12MB8073:EE_ x-ms-office365-filtering-correlation-id: 3473d094-20fb-4965-f8df-08dc7afc960d x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam-message-info: =?us-ascii?Q?Aw+XkkaO9sOXKF/eU6LAT/1sl3JLbUBOBDT7F2pcJ+LCx6zRcalB79uInoPN?= =?us-ascii?Q?EjvDmXE5DCWl6Go8P2WQPl3ss4g6L9aHhxsaaFPrQ65QQhXViU75GzQ+zXiT?= =?us-ascii?Q?w4Mn33gB5MGOUs0sWg5pzk9SuysuoQryBjlmOfm/ejnB1MKHaUZ6xsMwOkP4?= =?us-ascii?Q?YQ9E8C1kvgE94KDlWDo8Lhnmv4+6Pv4j/bak654/r3Q/Dydt8OFC/eI4JJnc?= =?us-ascii?Q?8wVh5rT8NTxWQH/BPO43VSO12pjMIl7dvwm9avwFm0Yv6pByRc5YNmAngSDu?= =?us-ascii?Q?8OAbpHyKEgV4O7ReGk0N2OWMI4DAmpiySTBygpKWVFam4DOh8g4Dbtb9Trss?= =?us-ascii?Q?GlHl1SgTDESytYfDZ/aYLxcQI7kOf5yxfAdFG1sNg4GmONbTjIlerVqn2erU?= =?us-ascii?Q?dI/KsUplFUHyLQbg7CNb7gLPkqb7ucJG4jFh8ndHRxItJEdYdla99Hln1+7K?= =?us-ascii?Q?S/txF4m8DHuOPQsKEPcOREAugurchnVjh/N4/Hm/DhCGw781DQuHzt8cFtjB?= =?us-ascii?Q?IH+d6wZaNjXmMtmOWHtbJruI+CDbZR018Cj37BJu4nElXpYCnmYnUAQ6l/o6?= =?us-ascii?Q?u9Mx9wtlmb9Q5a13mXD6OHvDOAeOH+k9RIHNb7j+1gfjSs4fYPS+ILwsoboC?= =?us-ascii?Q?+vXJ+dgL2ivNPrSQkLfNHZGqwI7Q7UAM14RCyffSbRp+CatlAijAvgsPK/N1?= =?us-ascii?Q?y1dIxyH5B8ZD+WzzpOyO+Urxr0nhYmXSULgiRIEuXjG20Zmeewol6uMQ9yQn?= =?us-ascii?Q?wwakT65PlbZBJkuoFAYoZ9/JU+EXwjQ4l/E19QLPVz3q7WJrIyJg3JvMVvub?= =?us-ascii?Q?i0X0z8fsOHV30MdJGh5l/yEhtThPNOFGT+vBY71IVoVJHSK5XJdxjt2y2oF8?= =?us-ascii?Q?tsUHDW0HojKzSqdBXyH7JMMje8Do1qd2GpqC0oWpWbS3YU2+Zhqe3uEgZWug?= =?us-ascii?Q?4uV9yqPedrlqZzmOfgMV9BEPnUAbb59Vscv280oIt1v88ju27EJaQnDf2C6i?= =?us-ascii?Q?ke+ISvm3gKx3Ij0sragEAzwp8W8cQ0SQZbRZ7gXVewvKR5StDlR1zAPK7LM6?= =?us-ascii?Q?UiWjceQA5KQzw3ZsGxfABAPbPoAmE3lxwRmk7cLSFri9q2dvdKlpFzsLgdId?= =?us-ascii?Q?C4CVrLID7Pcwb/NxhsGdan+hWc0axqiy0yuq4xnlNIuEQ36mGx+0F+rYgJZI?= =?us-ascii?Q?xuCHPBNZVoJEx/hnThkbaHBRMSeESVRQWOk5XYF1QY1XkL8++3Mho5sj4VVV?= =?us-ascii?Q?RWjod0DJdMpVuP9X0jjgTHA6fTHiYKPNos2V0DQ3wNqDbstPeeDN8XEoo8hZ?= =?us-ascii?Q?w6kgUZC5maYSKv6IjLoRbMYGF8JW+GR42Of2yx6uxa7wdw=3D=3D?= x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?CHOvC1mXAmlUUtjhPJqm/jjN+YFfUaUKGWtJPpSJHnUO0Gff0zDBY4dkB8RJ?= =?us-ascii?Q?mQpWPugVFQdMVlDxxm+8Lev1VCAB7Q/7+nehzgLKXuryW2KadNyGEaYTUzR6?= =?us-ascii?Q?Dc2u7h2eokl/Z0WFT//oyMh8A5axM+SMhz7asOxpmRsu2KQZ1mTx04AfTmLP?= =?us-ascii?Q?+zuw7ZAeMi4YRR9Gud9Yq2iHc7YruANCh7PrdeMvuf/QjVIaKKhnSFO4mbqm?= =?us-ascii?Q?H+rWsImUfko8ru4l810UgvrFICIsamRivUqVz8RcjAoV7LBlzliIAukNj9ua?= =?us-ascii?Q?w82/mZhcdr+RVK2jnH0cjNeWhFJQbk+Oyr4eHK+XQdJCpqFB30ShL5X0obfj?= =?us-ascii?Q?UcIhwqUag5HIDSiYxgkHkdbaq5uV8DgahaZCGwN3PpMkwb11KFm1R0Lr1F55?= =?us-ascii?Q?IPl8waqEMa9qu0ZAGsz5iooecUdhebYC25z3xXxXT9cPNcW9dnZfQO9bt7yf?= =?us-ascii?Q?nfMY5d/Bl+TKMVca+razENzciXY+3gmiTXf6620BfvdcfIckY246KwPfKADT?= =?us-ascii?Q?4+X3hvlQD2kajbzU4J1A2VJlZgKfmknZ0KTovy0HCxIYwIXEqUxchaeFdcY5?= =?us-ascii?Q?SDwlaEr27tN82QCiwGzM3X0P5kI7e7EvGJk97FJvGWh9VDtpwS2JyRNELZSz?= =?us-ascii?Q?CRtBYJIkkk3vOyBL1vBIFA9ZwmnPg7NOAOq5FvZO1kFKYFNJiF1hKpW4dGLp?= =?us-ascii?Q?V3veCR4KOfVl522rc287Fvrl6xmEU8qME9hVCGQ4wLyxQLHN71jAqIPEYbQf?= =?us-ascii?Q?xK+4yQ9L0hlmoXrjkZs3HQDQ1tfqiMzbtpwPyGZQOZoLkysY9rX3DqhQoBUD?= =?us-ascii?Q?e8max+NDV2Yb7uFbX7VkZnUI9vJn1XlpE50HCXAyqsB+Jc0GW8MhKUBFFE6J?= =?us-ascii?Q?khqe8KbjOGuXHGUz9YBZq30Mh2O+/y2Bjsu5HoROyIKQbFzjbDw+mijv9vp1?= =?us-ascii?Q?2bRtzbtrVULuGA5D52TpOeQGOAneVy2f8bUVlwrlQngYTpJsF1E0IhVVCoaZ?= =?us-ascii?Q?a+R/VndrIt6fPIutxEdqRXZO6gRAXLbGvdoyVAF8okq+BM9oVhsEWuWwMIKA?= =?us-ascii?Q?0OOA+YbQLmlmirPiJARpmxzPQDsuOL88X8Wp3hfJWCUl82G+rh6Mnul3mu9W?= =?us-ascii?Q?LgWjWrjlLoL/WIwOD0ufoLhXSE37Q4ajF0iBKLP1HUZ/rBQXwM0x7uhmV6fh?= =?us-ascii?Q?mGmxj+VSjmlI21pmw5KzE5CZPqoS+O+l+LkXL6e25dLmIsEc7/uPbOdOOH49?= =?us-ascii?Q?Q9pLc10HFSkhcqkJi/IuFDwzgpclnYkVD3sz05wivxUUzmn+kUjnv+mK4slW?= =?us-ascii?Q?MGxm3l0N/XiGK3QLR4iSQve9q147fHgCPSBiAT0XLZb6QS06YgK3RmWrwATM?= =?us-ascii?Q?jEgna/z1UsrGrTbuoETJma1EDfkbsw7zKGrzgwLdHwYeGCb9JAvq3DAHSqyH?= =?us-ascii?Q?9hmVZP6UJ/DMQb2kOeEda8v6OVkMJECEtcXoBElTe4z0zaBn4n+Mg4cM/D6J?= =?us-ascii?Q?LcvApUlC5kY42yX+dmCj4Cs0u/8+BwpzZov2n5OJonmBU4m7QijxjEwEGNSl?= =?us-ascii?Q?eeQbLTgYq0WmNI17rHU=3D?= MIME-Version: 1.0 X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: DS0PR12MB9445.namprd12.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 3473d094-20fb-4965-f8df-08dc7afc960d X-MS-Exchange-CrossTenant-originalarrivaltime: 23 May 2024 07:47:24.7355 (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: LUJQGYP+lghslii1CsmuDdwIQpmCcvAh1rAZSdN4LTTlZ9nyku/qJB3Gs3E+Nlrzhln+FvGNM9xppgjlAYVEaA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: CH3PR12MB8073 Precedence: Bulk List-Subscribe: List-Help: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Resent-Date: Thu, 23 May 2024 00:47:30 -0700 Resent-From: duke.zhai@amd.com Reply-To: devel@edk2.groups.io,duke.zhai@amd.com List-Unsubscribe-Post: List-Unsubscribe=One-Click List-Unsubscribe: X-Gm-Message-State: iKmoaJfBhIOgGdB0eaYs1mSqx7686176AA= Content-Language: en-US Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable X-GND-Status: LEGIT Authentication-Results: spool.mail.gandi.net; dkim=pass header.d=groups.io header.s=20240206 header.b=b3MbG1rZ; spf=pass (spool.mail.gandi.net: domain of bounce@groups.io designates 45.79.224.7 as permitted sender) smtp.mailfrom=bounce@groups.io; dmarc=pass (policy=none) header.from=groups.io [AMD Official Use Only - AMD Internal Distribution Only] Thanks Abner for the up-stream. Looks good to me. -----Original Message----- From: Chang, Abner Sent: Thursday, May 23, 2024 12:12 PM To: devel@edk2.groups.io Cc: Grimes, Paul ; Attar, AbdulLateef (Abdul Lateef) <= AbdulLateef.Attar@amd.com>; Fu, Igniculus ; Yao, Ken = ; Xing, Eric ; Zhai, MingXin (Duke) Subject: [edk2-platforms][PATCH 2/3] Platform/AMD: Update Readme.md From: Abner Chang Cc: Paul Grimes Cc: Abdul Lateef Attar Cc: Igniculus Fu Cc: Ken Yao Cc: Eric Xing Cc: Duke Zhai Signed-off-by: Abner Chang --- Platform/AMD/Readme.md | 64 ++++++++++++++++++++++++++++++++---------- 1 file changed, 49 insertions(+), 15 deletions(-) diff --git a/Platform/AMD/Readme.md b/Platform/AMD/Readme.md index 99d2b990= c7..3297c6ba59 100644 --- a/Platform/AMD/Readme.md +++ b/Platform/AMD/Readme.md @@ -7,18 +7,25 @@ booting certain AMD platforms. The definition of sub-fold= ers is described in bel ## Term and Definitions +* **AGESA** + + AMD Generic Encapsulated Software Architecture that are executed as + part of a host platform BIOS. + * **AMD Platform** (platform in short) - AMD platform refers to a platform that supports the particular AMD SoC (= processor), such as AMD EPYC Milan and Genoa processors. + AMD platform refers to a platform that supports the particular AMD + SoC (processor), such as AMD EPYC Milan and Genoa processors. * **AMD Board** (board in short) AMD board is a generic terminology refers to a board that is designed ba= sed on a specific AMD SoC architecture (also referred as AMD platform). More than= one boards - are possibly designed to support an AMD platform with different configur= ation, such as 1-processor socket or 2-processor sockets board. + are possibly designed to support an AMD platform with different + configuration, such as 1-processor socket or 2-processor sockets board. * **AMD edk2 Platform Package** (platform package in short) - + The folder has the AMD edk2 platform common modules. * **AMD edk2 Board Package** (board package in short) @@ -28,29 +35,52 @@ = booting certain AMD platforms. The definition of sub-folders is described i= n bel ## Package Definition +* **AgesaModulePkg** + + This package contains all of the private interfaces and build + configuration files for the AGESA support. + +* **AgesaPkg** + + This package contains all of the public interfaces and build + configuration files for the AGESA support. + +* **AmdCbsPkg** + + AMD Configurable BIOS Setting. Provides the edk2 formset following + the UEFI HII spec to configure BIOS settings. + +* **AmdCpmPkg** + + AMD Common Platform Module software is a BIOS procedure library + designed to aid AMD customers to quickly implement AMD platform technolo= gy into their products. + * **AmdPlatformPkg** - AMD platform edk2 package under this folder provides the common edk2 mod= ules those - are leverage by platforms. Usually those modules have no dependencies wi= th - particular platforms. The module under this scope can provides a common = implementation - for all platforms, or it may just provide a framework but the difference= s of implementation could be configured through the PCDs declared in AmdPla= tformPkg.dec, or - the board level library provided in the \Pkg. + AMD platform edk2 package under this folder provides the common edk2 + modules that are leveraged by platforms. Usually those modules have no + dependencies with particular platforms. Modules under this scope can + provide a common implementation for all platforms, or may just + provide a framework but the differences of implementation could be + configured through the PCDs declared in AmdPlatformPkg.dec, or the board = level library provided in the \Pkg. * **AmdMinBoardPkg** - This package provides the common edk2 modules those can be leverage acro= ss AMD boards those use MinPlatformPkg framework. + This package provides the common edk2 modules that can be leveraged + across AMD boards using the MinPlatform framework. * **\Board** - This is the folder named by SoC and accommodate one or multiple board pa= ckages those - are designed base on the same SoC platform. Board folder may c= ontain edk2 - package meta files directly or the sub-folders named by \Pk= g for a - variety configurations of a platform. + This is the folder named by SoC and accommodates one or multiple + board packages that are designed based on the same SoC platform. Board folder may contain edk2 package meta files directly or the + sub-folders named by \Pkg for a variety configurations of a= platform. * **Pkg** - This is the folder that contains edk2 package meta files for a board whi= ch is designed base on a platform. Besides the edk2 meta files, Pkg may also provides - edk2 modules which are specifically to a board. + This is the folder that contains edk2 package meta files for a board + which is designed base on a platform. Besides the edk2 meta files, + Pkg may also provides edk2 modules which are specifically t= o a board. ``` e.g. OverdriveBoard @@ -63,6 +93,10 @@ booting certain AMD platforms. The definition of sub-fol= ders is described in bel ``` Platform/AMD + |----AgesaModulePkg + |----AgesaPkg + |----AmdCbsPkg + |----AmdCpmPkg |----AmdPlatformPkg |----AmdMinBoardPkg |----OverdriveBoard -- 2.37.1.windows.1 -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#119134): https://edk2.groups.io/g/devel/message/119134 Mute This Topic: https://groups.io/mt/106257080/7686176 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [rebecca@openfw.io] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-