From patchwork Tue Oct 10 15:34:09 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Vipin Varghese X-Patchwork-Id: 132465 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 38D3A4234D; Tue, 10 Oct 2023 17:34:30 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id BBC5C4029F; Tue, 10 Oct 2023 17:34:29 +0200 (CEST) Received: from NAM11-CO1-obe.outbound.protection.outlook.com (mail-co1nam11on2089.outbound.protection.outlook.com [40.107.220.89]) by mails.dpdk.org (Postfix) with ESMTP id 99E7040297 for ; Tue, 10 Oct 2023 17:34:28 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=DpEJdoyMI3cAlBrGlJAdW/gutR0dUluxnZgfvEDwU3vDR2g7mN/mOaKC2sfcxtHilYO6XEt4mTBwvL4f7b6I1fiituouDdAewLrSIjpc0pkeTlQFfMknOe1tKkQdLgV2Ol+yVV/NpP9Kb2br1YYYsxuFAnPS3N9lV8zGqSEBlPPu4SiocsOPSCPANmeXrpCd3xni8fRpTsqUBWFykDv5T5rdfR16e5X94NI/pnl56368B98RxTqCYSDoPDG3Z94HdB/kbokvYIzCUUfqmqzCYKz3y48ovAlL+23mFyT5SxdveZch3EhPbRWCE8RdYF4lojBVeZb21949rDITf6VUMA== 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=o0tuRXZOZB3CY80ZzU5NNnr33dytc0AC3ubYimPgZek=; b=Gv+2bVCEN+Z+0nLdKQH4D+SPJcrVJe7kht6EtAC3JAaB9VcziHmuH/FBO3Xm3xZbiGNkxXHUzbAUG5g2rGQwJ42bSDjRBJMmZ9RSCxMhXMNU0ITu2RUtVaNxMjwOUHzeJlysAv5+/MTOqP4KqFHQZZyWW3jo5rOJDS7BfmxQ/Q9A7Y9Qa6feYgMEYfRTGi99GkH4NqWhETKaFYWLxntuA4XPu+RqQ0LlcgbwvaObhnzRJ6G5VRglCvkPbyy1vs9/1eumyf2KmAC8pZXXo4KVmkiwD6J9y4IEI8qPFgJ5iuwgX/vY6yzuwEb1GOb77gYQYJ3uWgUp39ZfAZzSigmG3A== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 165.204.84.17) smtp.rcpttodomain=dpdk.org 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 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=o0tuRXZOZB3CY80ZzU5NNnr33dytc0AC3ubYimPgZek=; b=3AzyrSFduzvHELYu95sZHb2B/dGwWMUb0tupfEK0z8CmnR692t4U/9lEG1MBtGJhZ/cmhtQue7DmtO+cHq1b2gfJdw5nuYiEOQu5lzNoc8tanNynV+hE6eiUxumf+zvfkD8bQ5hf6ZGSECNC3HEBxw854MKBBgAKuoHkFBRXXE4= Received: from MW4PR04CA0104.namprd04.prod.outlook.com (2603:10b6:303:83::19) by PH7PR12MB9149.namprd12.prod.outlook.com (2603:10b6:510:2ea::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6863.38; Tue, 10 Oct 2023 15:34:26 +0000 Received: from CO1PEPF000044F1.namprd05.prod.outlook.com (2603:10b6:303:83:cafe::34) by MW4PR04CA0104.outlook.office365.com (2603:10b6:303:83::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6863.38 via Frontend Transport; Tue, 10 Oct 2023 15:34:26 +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 (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 Received: from SATLEXMB04.amd.com (165.204.84.17) by CO1PEPF000044F1.mail.protection.outlook.com (10.167.241.71) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.6838.22 via Frontend Transport; Tue, 10 Oct 2023 15:34:26 +0000 Received: from BLR-5CG134626B.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.27; Tue, 10 Oct 2023 10:34:23 -0500 From: Vipin Varghese To: CC: , , Subject: [RFC] doc/linux_gsg: add amd configuration section Date: Tue, 10 Oct 2023 21:04:09 +0530 Message-ID: <20231010153409.1701-1-vipin.varghese@amd.com> X-Mailer: git-send-email 2.41.0.windows.3 MIME-Version: 1.0 X-Originating-IP: [10.180.168.240] X-ClientProxiedBy: SATLEXMB03.amd.com (10.181.40.144) To SATLEXMB04.amd.com (10.181.40.145) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CO1PEPF000044F1:EE_|PH7PR12MB9149:EE_ X-MS-Office365-Filtering-Correlation-Id: e876a1e0-44af-4841-2898-08dbc9a662c4 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: TdkqpgUv5mctwuFgPar/sUrGwsCqerIXO15/wDfShnf4W9C9bo+jObbnZl5SGB0b/mUIzNjUcpsLDx2E6EK9Wq4tQrRQ2KPdOGj9Ym7CKe4BhbmogyAjYc4QASrgPpCNPzbEb2DdiXsPKyAOURFzuvKVwOo/WtMNXcfqHCrjX098lEK07DZtgPGvuUPzCi7ErFVJ2vuVqQsJKbiMifnz9X9jd2IqTJ5ZjyaEi5AqvNBkwbi1aNVIrolkwPQQQ2V0AJwSSO3M7WB46CqqS/UA0hgHRHgMWRwKFlbU4b1QNRHHWyt844fKXnvxhVP/97yNQBFVYx02vJtNLBiHE6YWVYhHRGJOjfFUpWVRm1IDb2q88J9cC75G4lblqS2agH+nUXfqhmaynb49jZBAtBm2jfGQfERqq+Y6tP+S3yK0nH4xGmrQHsTDI2wiSskHEt+paRK/fSAnMJNw0+PkgxAs9csCLpiV166VD/YmWxgDGr+EQ39kezLGqhz0uBBU7vf2mQJ9vFLPCN6rgLgfBlYEoe3TuvE3d+OFUGM1nwZrkAuIeSzK/VEs9bF3C8H7Y8VP352Zm7Mmuf9/XSm5gAdcxUVyI9cTXnXt52KlUN+hMI6YdUVjyXxL5+kkcupqn6HRSq4ZQVfHJjKn3PZKvs8M8YQZz7M8D+RZi+tZ6r8lq83JR5+g79YgCfqAiSvqA3Bu48idKOzPfhqFxCyySh4KLdX3Ewe7P1t5ZeD/ha2ubATpacR6EDg+YU3DBqifvz2EAfEnPez0vpOE6kDPO/zi4W1/0t6xyS4Jdgd5zpazoalet7cH0Z2e6ahMguXcFaGG X-Forefront-Antispam-Report: CIP:165.204.84.17; CTRY:US; LANG:en; SCL:1; SRV:; IPV:CAL; SFV:NSPM; H:SATLEXMB04.amd.com; PTR:InfoDomainNonexistent; CAT:NONE; SFS:(13230031)(4636009)(376002)(346002)(396003)(136003)(39860400002)(230922051799003)(451199024)(64100799003)(82310400011)(1800799009)(186009)(40470700004)(36840700001)(46966006)(86362001)(81166007)(356005)(36756003)(66899024)(40480700001)(478600001)(5660300002)(82740400003)(44832011)(8676002)(8936002)(41300700001)(6666004)(7696005)(2906002)(4326008)(1076003)(336012)(2616005)(40460700003)(426003)(47076005)(316002)(70206006)(6916009)(16526019)(70586007)(54906003)(26005)(36860700001)(36900700001); DIR:OUT; SFP:1101; X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 10 Oct 2023 15:34:26.0271 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: e876a1e0-44af-4841-2898-08dbc9a662c4 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: CO1PEPF000044F1.namprd05.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH7PR12MB9149 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Add AMD EPYC SoC tuning guide as new setcion of linux getting started guide. Signed-off-by: Vipin Varghese --- doc/guides/linux_gsg/amd_platform.rst | 63 +++++++++++++++++++++++++++ doc/guides/linux_gsg/index.rst | 1 + 2 files changed, 64 insertions(+) create mode 100644 doc/guides/linux_gsg/amd_platform.rst diff --git a/doc/guides/linux_gsg/amd_platform.rst b/doc/guides/linux_gsg/amd_platform.rst new file mode 100644 index 0000000000..cdb535e9c0 --- /dev/null +++ b/doc/guides/linux_gsg/amd_platform.rst @@ -0,0 +1,63 @@ +.. SPDX-License-Identifier: BSD-3-Clause + Copyright(c) 2023 Advanced Micro Devices, Inc. All rights reserved. + +How to get best performance on AMD platform +=========================================== + +This document shares step-by-step guide for configuring AMD EPYC SoC across various families for getting best performance for DPDK applications. +Various factors like BIOS, Numa Per Socket, Memory per Numa, near-far from IO device affects the overall performance. + +These are covered in various sections of tuning guides shared below. + + +Tuning Guide for AMD EPYC SoC +----------------------------- + +#. `MILAN `_ + +#. `GENOA `_ + +#. `BERGAMO|SIENNA `_ + + +General Requirements +-------------------- + +Memory +~~~~~~ + +Refer `Memory Configuration` section for SoC specific details. + +Note: general thumb rule is to ensure that each memory channel has at least one memory DIMM populated. The ideal memory size for each is at least 8|16|32 GB ECC modules. + + +BIOS +---- + +Refer `BIOS Performance` section in tuning guide for recommended settings. + + +Linux Grub +---------- + +Refer `Linux OS & Kernel` in tuning guide for recommended settings. + + +NIC and Accelerator +------------------- + +AMD EPYC supports PCIe Generation of 1|2|3|4|5 depending upon SoC families. For best performance ensure the right slots are used which provides adequate bandwidth. + +Use ``lspci`` to check the speed of a PCI slot :: + + lspci -s 41:00.0 -vv | grep LnkSta + + LnkSta: Speed 16GT/s, Width x16, TrErr- Train- SlotClk+ DLActive- ... + LnkSta2: Current De-emphasis Level: -6dB, EqualizationComplete+ ... + + +Compiler +------- + +Refer `Compiler Flags` for recommended version and `-march` flags. + diff --git a/doc/guides/linux_gsg/index.rst b/doc/guides/linux_gsg/index.rst index c3e67bf9ec..ecdaf35eec 100644 --- a/doc/guides/linux_gsg/index.rst +++ b/doc/guides/linux_gsg/index.rst @@ -21,3 +21,4 @@ Getting Started Guide for Linux linux_eal_parameters enable_func nic_perf_intel_platform + amd_platform