From nobody Wed May 15 07:12:51 2024 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) smtp.mailfrom=bounce+27952+106071+1787277+3901457@groups.io; arc=fail (BodyHash is different from the expected one) Received: from mail02.groups.io (mail02.groups.io [66.175.222.108]) by mx.zohomail.com with SMTPS id 1686716569434174.32046889595222; Tue, 13 Jun 2023 21:22:49 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id kNHAYY1788612xLb9qMJ0QBZ; Tue, 13 Jun 2023 21:22:49 -0700 X-Received: from NAM10-DM6-obe.outbound.protection.outlook.com (NAM10-DM6-obe.outbound.protection.outlook.com [40.107.93.69]) by mx.groups.io with SMTP id smtpd.web11.4276.1686716567966241134 for ; Tue, 13 Jun 2023 21:22:48 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=TRstrOI9hTwKosWo0nyvmLckrcapGoCF/m11f9qU3ns5YJHMTC2Oc5qpz11XMdTgJJMEsa3ldHpXSdmyHtVlMvqZs+Gq25VFU8uFA5MuPbgt1wIyLJkGve891jPbX7Y2hhzOUSeemVHc5n6l22onzbLxgC1lShzk4M6li/rAHYoI9rUZf/H4rXmLA6Vr4qsHWtZ7OCU5UQ1KdRGwuSLJNVLQ8c2KozCo529tR/b+QHa1Ypf1NEE8c5Xsa1r2tLrkTxiyz7Lry3Yst1OfuJ9Po9P5waKC4C3XrJ3xL6iCwUbrh7fBkZzyJIHWrSgaWP0x88NVJr4spiNlxLsyHy5wSA== 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=l1kfY7vjiz5XliGN0gmYpTEFT60UL2zuSUETFtFyInc=; b=Mg2TzwEiFUIKX276IiCuG+ghmZx2x9gz+U+mgUnLF/m0T3kyBGmSitaDzxHBMaQnIs7QvzoGWOGwj//gmgXvjoVPe+oRC7I221zv3mIfYNMP5dfNCkfIOCg8YRB6vvjXkeJ+6tUGHPVjCeIW4STc3NYTraQjj2Dg58le+6pyLeovkyCSwXGBoKms4Bg8K8zF7IxvuBWGfk8s708GE466fpLhdrxZS81Gf/JNLbmPs5ZMxbcMI5KzUfAAXU9UStxY0vt9IlCeXeEfstmNTUoynC2DqZFrXzrpLrWYPf1z53LTAr4KF685l1sO5rhOkAE0E25Dzo3U8LI8HS3zVJ9z5w== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 165.204.84.17) smtp.rcpttodomain=edk2.groups.io smtp.mailfrom=amd.com; dmarc=pass (p=quarantine sp=quarantine pct=100) action=none header.from=amd.com; dkim=none (message not signed); arc=none X-Received: from MW4PR04CA0090.namprd04.prod.outlook.com (2603:10b6:303:6b::35) by BN9PR12MB5291.namprd12.prod.outlook.com (2603:10b6:408:104::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6477.29; Wed, 14 Jun 2023 04:22:45 +0000 X-Received: from CO1NAM11FT031.eop-nam11.prod.protection.outlook.com (2603:10b6:303:6b:cafe::f5) by MW4PR04CA0090.outlook.office365.com (2603:10b6:303:6b::35) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6477.35 via Frontend Transport; Wed, 14 Jun 2023 04:22:44 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 165.204.84.17) smtp.mailfrom=amd.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=amd.com; Received-SPF: pass (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) client-ip=66.175.222.108; envelope-from=bounce+27952+106071+1787277+3901457@groups.io; helo=mail02.groups.io; Received-SPF: Pass (protection.outlook.com: domain of amd.com designates 165.204.84.17 as permitted sender) receiver=protection.outlook.com; client-ip=165.204.84.17; helo=SATLEXMB04.amd.com; pr=C X-Received: from SATLEXMB04.amd.com (165.204.84.17) by CO1NAM11FT031.mail.protection.outlook.com (10.13.174.118) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.6500.25 via Frontend Transport; Wed, 14 Jun 2023 04:22:44 +0000 X-Received: from TPE-L1-ABNCHANG.amd.com (10.180.168.240) by SATLEXMB04.amd.com (10.181.40.145) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.23; Tue, 13 Jun 2023 23:22:42 -0500 From: "Chang, Abner via groups.io" To: CC: Leif Lindholm , Michael D Kinney , Abdul Lateef Attar , "Eric Xing" , Jiangang He Subject: [edk2-devel] [edk2-platforms][PATCH] edk2-platform: Add Readme under Platform\AMD Date: Wed, 14 Jun 2023 12:22:31 +0800 Message-ID: <20230614042231.339-1-abner.chang@amd.com> MIME-Version: 1.0 X-Originating-IP: [10.180.168.240] X-ClientProxiedBy: SATLEXMB04.amd.com (10.181.40.145) To SATLEXMB04.amd.com (10.181.40.145) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CO1NAM11FT031:EE_|BN9PR12MB5291:EE_ X-MS-Office365-Filtering-Correlation-Id: 2fb29b6d-a6a8-4011-4495-08db6c8f0064 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam-Message-Info: pYXkfeIr5XxTRN2Um5OkRsKKv4uRXbjnrpWpAUEgknjUGVCZs4eIaa7HnSWbX6/ow8NLWaL/cgXj/YJ68DNEHeu4g7g/hBSceVH5CSJAgK48byzolbrPEFXds6Md/Se8x8extcyWzAP/MpUrpzyez7frtavBCCSAndfpwXmY+7/BTXADRzgtxMc8e2uNgLgX0WPYdYwbXRjDTmsj584of5JO8Cn/gf13udPp5pJocw6fcgRgqy0qlcI9NtsIo5RVLJGjIpO4GWY+rIpkhXZtOI3QvOJp7wcqCqfFbXaD4gAFRM91Z1GhsxYCjw0HQBuHgDv/cFypFFVWhMfQvwwMj/Qmv2dfLB/oGB5QEhAt4XngNNUFmKVAgNez3OkbQL+VCrhqXcMCfsFCtyMFDJoHUqhBuiATJTWuKHw4AFisr8FU5Y9Q7K5B+M4TgmeMpJdah7vzZ6vuGaFJfqFHo//lKfQhhm26126tjLL8aK+95zWjv9ugnmU29yldSdtNYieiJipeBW6CGVZWwk5uU21/49nRwdMGqmw7+v/mmE9p0adrcik7VS4ec6wmwKVV8E9OI+wzbn+2s1pwCLoBmWf29FPy1sSCnbvAJixcje1wA+oNNINAS2wuyuAsayt0leKirOb/S32vziISJ4l9bCsFt8rDo/zASfTUEa/KD7WoDN2oVLv60nnHCAnv4zbyTTM15F20ivPqRjriYAVKl2kL63BUlvAndGXrlVZ3Xv2wJ4WvLCLldZeok3gu2Mw2i7hDCr9Cd8GOTAiNf0Toajw6IA== X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Jun 2023 04:22:44.4345 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 2fb29b6d-a6a8-4011-4495-08db6c8f0064 X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=3dd8961f-e488-4e60-8e11-a82d994e183d;Ip=[165.204.84.17];Helo=[SATLEXMB04.amd.com] X-MS-Exchange-CrossTenant-AuthSource: CO1NAM11FT031.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN9PR12MB5291 Precedence: Bulk List-Unsubscribe: List-Subscribe: List-Help: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,abner.chang@amd.com X-Gm-Message-State: AYC2bFDl37kBq2N5AxHAed4Qx1787277AA= Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1686716569; bh=GAbsZSyBvB6J1vD9nAE6TLo45WOzH4vJY4lMuDLV+Gk=; h=CC:Content-Type:Date:From:Reply-To:Subject:To; b=urz/YFE8RB929ljttHv6SQqNKdsswrYGI/SKC7RG4mhsiRPjtAqRrb/jsoN4f56UVge Eu4hAidcIVgUxiIxpMf+k6RYDiaU81BbS9IJhq300WhalZLAe4BOKJNISviAb6jLw5PoB I1KFGZ9HjnBRitDugJthuWRDhy1MUnlU334= X-ZohoMail-DKIM: pass (identity @groups.io) X-ZM-MESSAGEID: 1686716569721100003 Content-Type: text/plain; charset="utf-8" From: Abner Chang For AMD edk2 opensource project and the needs of opensource AMD platform common modules those can be leverage across AMD business units, AMD server, client and S3 (silicon strategic solution) BUs have the consensus to propose AMD as the maintainer of Platform/AMD folder. The folder and edk2 package structure under Platform/AMD is defined in the Readme for the further upstream works. We still leave the existing maintainers for AMD OverdriveBoard which is no conflicts with this change. Signed-off-by: Abner Chang Cc: Leif Lindholm Cc: Michael D Kinney Cc: Abdul Lateef Attar Cc: Eric Xing Cc: Jiangang He Reviewed-by: Leif Lindholm --- Platform/AMD/Readme.md | 85 ++++++++++++++++++++++++++++++++++++++++++ Maintainers.txt | 10 ++--- 2 files changed, 90 insertions(+), 5 deletions(-) create mode 100644 Platform/AMD/Readme.md diff --git a/Platform/AMD/Readme.md b/Platform/AMD/Readme.md new file mode 100644 index 0000000000..f39b8140f5 --- /dev/null +++ b/Platform/AMD/Readme.md @@ -0,0 +1,85 @@ +# AMD EDK2 Platform + +This is AMD folder that provides the edk2 modules to support AMD edk2 firm= ware +solution for the server, client (e.g., Notebook) and S3 (Strategic Silicon= Solutions) +platforms. The board packages under this folder are the firmware reference= code for +booting certain AMD platforms. The definition of sub-folders is described = in below sections. + +## Term and Definitions + +* **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 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. + +* **AMD edk2 Platform Package** (platform package in short) + =20 + The folder has the AMD edk2 platform common modules. + +* **AMD edk2 Board Package** (board package in short) + + The folder has the edk2 meta files to build the necessary edk2 firmware = modules + and generate the binary to run on a board. + +## Package Definition + +* **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. + +* **AmdMinBoardPkg** + + This package provides the common edk2 modules those can be leverage acro= ss AMD boards those use MinPlatformPkg 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=20 + 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. + + ``` + e.g. OverdriveBoard + e.g. GenoaBoard + |------Board1Pkg + |------Board2Pkg + ``` + + Below is the outline of folder structure under Platform/AMD + + ``` + Platform/AMD + |----AmdPlatformPkg + |----AmdMinBoardPkg + |----OverdriveBoard + |----GenoaBoard + | |------Common Modules for Genoa boards + | |------Board1Pkg + | | |-------Board specific modules + | |------Board2Pkg + | + |----NextGenBoard + |------Common Modules for the next generation + platform boards + |------Board1Pkg + |------Board2Pkg + |-------Board specific modules + ``` + + +## Board Support +Under progress \ No newline at end of file diff --git a/Maintainers.txt b/Maintainers.txt index 020c72677a..d1d7613ef4 100644 --- a/Maintainers.txt +++ b/Maintainers.txt @@ -83,6 +83,11 @@ F: Platform/96Boards/ M: Ard Biesheuvel M: Leif Lindholm =20 +AMD +F: Platform/AMD +M: Abner Chang +M: Abdul Lateef Attar + AMD Seattle F: Platform/AMD/OverdriveBoard/ F: Platform/LeMaker/CelloBoard/ @@ -91,11 +96,6 @@ F: Silicon/AMD/Styx/ M: Ard Biesheuvel M: Leif Lindholm =20 -AMD MinBoard package for MinPlatformPkg -F: Platform/AMD/AmdMinBoardPkg -M: Abner Chang -M: Abdul Lateef Attar - Ampere Computing F: Platform/Ampere F: Silicon/Ampere --=20 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 (#106071): https://edk2.groups.io/g/devel/message/106071 Mute This Topic: https://groups.io/mt/99521710/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-