From patchwork Wed Jan 24 18:10:21 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Vipin Varghese X-Patchwork-Id: 136110 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 DDB8D439B8; Wed, 24 Jan 2024 19:10:47 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id AB409402A6; Wed, 24 Jan 2024 19:10:47 +0100 (CET) Received: from NAM11-DM6-obe.outbound.protection.outlook.com (mail-dm6nam11on2050.outbound.protection.outlook.com [40.107.223.50]) by mails.dpdk.org (Postfix) with ESMTP id 6474440262 for ; Wed, 24 Jan 2024 19:10:46 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=IJFcin5b0GxZ6eZ6mPAZtkcbwiE+c66pm2ryInDn1JC/DQ4ryVswMA2hSE5w4UL2h1iyJGGFfnyU5NAoPPbCbI2e8YOLYnRX+kWmPATKsRPP5k0kWPZOj/V4dKvcw/UTAQdeyuBqIP8vjYZzr7IWH+YnyAtwFE5zH9H9H5mtWzY591dYGPTObKeDKuuzqn3v5w9j3JF6dAufu2H7xPcgvUG4Uqe0iLYMZrhGsbSFSgHwCbOPg0FqozEprK98NjJj7oivy4WWmkaXXqhypVN4XzlWLzjn43SBeIJn2jPyb2hn3kdlyrqnkhIXynPuOeHFSn5g9e5Y5W1vuwDgLhRD7Q== 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=WP1vfowTH10XIicbsR1BZdkr0PbaOyqtOeJpQg9CMUM=; b=GmU9YBKTq1hH9j0zDnZjQbjzNQ/8uUdOmRYeaXGEplVlzNIchTdVJWyn3/lvk2t9VhbwRNf9KXAQuGOj2t9ZJJfkoY79wTLU6KLCZWn6C/ojryTLrA+/nV5ZNAWiIuhsqBcz55D2VvyQwunoBoKq7kctLuamNFkJbwQ6QvixvKjFxitsWbfpQf3urwpwYFd56sHGdTZnOIy9OSgIA8D5sYd+u0BIQyViow4M3IQAOuvRzgqJasqkNX379DCRvJqdZHthdrYcSNUJyDM7xnR17Xf3AViWdLVa+sJwDoBkgOylvrUIDKUrXdnJZcxX/Uys/l/OIdpLlmoDMxBIq13ddQ== 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 (0) 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=WP1vfowTH10XIicbsR1BZdkr0PbaOyqtOeJpQg9CMUM=; b=UCE1K2z/L7L3Aoytkuwug3SyLus8nK/7nHBrDkOPnFDKIBPgpW5tG5zwqkAh+eJQq+GRtM8tJ/zzHIm/3Bofd9W+silJHuaEhnOSWfZowSZx1CYeA21bnQHoNK8WT+ui/cBSVNlfQZ+QwrE4Ap68cjRTP+OEh2pHutabDKPNgIU= Received: from SJ0PR03CA0344.namprd03.prod.outlook.com (2603:10b6:a03:39c::19) by MN0PR12MB6270.namprd12.prod.outlook.com (2603:10b6:208:3c2::20) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7228.22; Wed, 24 Jan 2024 18:10:44 +0000 Received: from CO1PEPF000044F2.namprd05.prod.outlook.com (2603:10b6:a03:39c:cafe::49) by SJ0PR03CA0344.outlook.office365.com (2603:10b6:a03:39c::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7228.22 via Frontend Transport; Wed, 24 Jan 2024 18:10:43 +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 CO1PEPF000044F2.mail.protection.outlook.com (10.167.241.72) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.7202.16 via Frontend Transport; Wed, 24 Jan 2024 18:10:43 +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.34; Wed, 24 Jan 2024 12:10:41 -0600 From: Vipin Varghese To: , CC: Subject: [PATCH] doc/linux_gsg: add amd configuration section Date: Wed, 24 Jan 2024 23:40:21 +0530 Message-ID: <20240124181021.1759-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: 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: CO1PEPF000044F2:EE_|MN0PR12MB6270:EE_ X-MS-Office365-Filtering-Correlation-Id: f43d569f-407c-4360-7c2c-08dc1d07c7f4 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: LSO53ExAxYBiXkjzHi1XtyBiDBMhhonDj5jQ/Lmk/h0ealXfvbMoDDhQWXmXALvPtBW2n8doPO2t1wpc5HmmJc1BIykSGKTvdXTjtEEH1HO2t3C5YcAr4EHutvEv0aS4k/ZFmH+9mtKjikCJXUD33JOOpYci6xFN+rT82eNAOOQoBITklNdPe1vW9UzjsCndN3ZMdUpOFUp8g+K5Oo20jclAGIsBskguC+ri7o6fjKIxfpwliTNCutRDaPuhoFJOnLhkvPykCQpFDTk3cZGjoi92SmNFEdWv2nukC1i2nE3m3ZRa6sgFso033zl23ejWfvbGSw/V7P2As1Et4aoP75y4PCdw5yXMNgOrSnRKATniBEmemsOMGKwJRSMjGDQ5WDvkvbUi5BJvp4shcoODWkdzYaRtY75qJvjR11T5BHXQK48IM5QsZX+1Tc8VudvFI6mX4ycxhzw5byAZNolE/mx71D7lrVzV4CuoqOHODTe+ICDBhgpbEUcYc8XmvNkUtmAWlqXUoINM5cr8Pm/wZ5HsQ+FQ01nhhNGHq8AIOITbpuNjyWxJmB5k5Iaeg+ff59zsWtSSZGXPJdGx3mUm391Afs6m9QHSIPSAq1gS5dt58EcgFvbnS/FJIMzqu2Kh+PrhTjJ0uXcNBZEqxLudzmhjAdmlMIJoFaDZjeNoOCnXu2pIB1Cb9SEH0XMLm96v9PVpe8+iA3Sa6n409YLKocn63zCSKmjl0n8+LR/fYiXbnt2z7zoR9wmTiSwuca3C8ZuH84k2jVnCi9K4jLu6R/YqCUfFswbCLgs5C80Y9fE= 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)(396003)(346002)(376002)(136003)(39860400002)(230922051799003)(64100799003)(1800799012)(82310400011)(186009)(451199024)(36840700001)(46966006)(40470700004)(40480700001)(40460700003)(36756003)(86362001)(316002)(2616005)(70586007)(82740400003)(356005)(81166007)(70206006)(36860700001)(336012)(16526019)(1076003)(7696005)(426003)(6666004)(26005)(8936002)(8676002)(478600001)(110136005)(41300700001)(5660300002)(4326008)(47076005)(2906002)(44832011)(36900700001); DIR:OUT; SFP:1101; X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 24 Jan 2024 18:10:43.4714 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: f43d569f-407c-4360-7c2c-08dc1d07c7f4 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: CO1PEPF000044F2.namprd05.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN0PR12MB6270 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 section of linux getting started guide. Signed-off-by: Vipin Varghese --- MAINTAINERS | 4 ++ doc/guides/linux_gsg/amd_platform.rst | 70 +++++++++++++++++++++++++++ doc/guides/linux_gsg/index.rst | 1 + 3 files changed, 75 insertions(+) create mode 100644 doc/guides/linux_gsg/amd_platform.rst diff --git a/MAINTAINERS b/MAINTAINERS index 0d1c8126e3..e7122f1a85 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -275,6 +275,10 @@ F: lib/eal/include/rte_random.h F: lib/eal/common/rte_random.c F: app/test/test_rand_perf.c +AMD x86 +M: Vipin Varghese +F: doc/guides/linux_gsg/amd_platform.rst + ARM v7 M: Ruifeng Wang F: config/arm/ diff --git a/doc/guides/linux_gsg/amd_platform.rst b/doc/guides/linux_gsg/amd_platform.rst new file mode 100644 index 0000000000..237f84785a --- /dev/null +++ b/doc/guides/linux_gsg/amd_platform.rst @@ -0,0 +1,70 @@ +.. 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 provides a detailed, step-by-step guide on configuring AMD EPYC +System-on-Chip (SoC) for optimal performance in DPDK applications across different +SoC families. + +The overall performance is influenced by factors such as BIOS settings, NUMA Per +Socket configuration, Memory per NUMA allocation, and proximity to IO devices. + +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 to the 'Memory Configuration' section for specific details related to the System-on-Chip (SoC). + +.. Note:: + + As a general guideline, it is recommended to populate at least one memory DIMM in each memory channel. + The optimal memory size for each DIMM is at least 8, 16, or 32 GB, utilizing ECC modules. + + +BIOS +---- + +Refer to the `BIOS Performance` section in tuning guide for recommended settings. + + +Linux Grub +---------- + +Refer to the `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 to the `Compiler Flags` in tuning guide 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