From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 5A33445DC6; Fri, 29 Nov 2024 05:32:52 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 48338402E3; Fri, 29 Nov 2024 05:32:50 +0100 (CET) Received: from NAM04-DM6-obe.outbound.protection.outlook.com (mail-dm6nam04on2053.outbound.protection.outlook.com [40.107.102.53]) by mails.dpdk.org (Postfix) with ESMTP id 5D0D3402AE for ; Fri, 29 Nov 2024 05:32:48 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=WftD9JqpBhHIzJ/2tFRC7fbblIiDutFysRHG2mJDNrlzCDmSxMbOr8TlTtXbSBT5JWU7zI8MQGo5gvkmo2WGCFN0YnsQtYYYnm1mcrzxnlGMK7drmaLWFt7rY4Vqcxi6B4C+qmj73g3869aRKa6jIvNGS/5xa8yrxEizj04FJoi/e4o8/ielqQtkgzdLQikdkLa2nHbr/ApyuSuvGKLUcftMFhJNQtqNYuQP3wGAfPdfQQi20KyMPj89H3NvJuua17nnQB7jlbeWHVADA8opAWJHbZIffYAUGYdSgQHaE/znh9mBhUush4Ji3OjIZY1RqWZfwEB1/+MV9FR/57ILnA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; 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=7wjwzkii2/u9QZcd7ZTTYuq0q/7CgA57X1lehzjHzmE=; b=JuYgx0aJN2si/aVYZCakZlTFKCHAMQjMBFCW8wXc6DObC4D5pWM/wUP5wRukfE5t1JLo2RykgfLtGuRAOCScfQlRD5b+pVfdDMTPyQdCHQr58es3R7JulNymn7bZ4nu5m5dvRV2uRo6ckj8sr6bOqPaalO3XGHy1OTM+kPxvDMgrPKnlZYO2gfJZtVk3GiBKzbO5qVlM+Cvc3Y0aaqxG/UHHuQqIElFpZSrdMWKZQQeRXJyqBkE7mzDxUe621rXlKNwO/FpjRqExrig6q1KrNN5BnrKA3kDWjLxBWoaWJwVy+oNde+rb9lkOJ/aDL6h8tzyx+7wQPZmkcZlH5Vvusg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 165.204.84.17) smtp.rcpttodomain=intel.com 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=7wjwzkii2/u9QZcd7ZTTYuq0q/7CgA57X1lehzjHzmE=; b=au1njROE3YYW04YtplqRwddrvWfpHQN9BQCjMCh15cLGQ0cbMDrAv2HSwf52aKeCsI7jU6NskvIVjHPTDqSLjDZbFKM7xQ44Dc2GB5H+Q1Z+nXwtfJEbiVZPuIQ7ZI4wXW3rKtgM7vdkotfrcqqW9HP2C6CVWgih84/mPPUvzig= Received: from SJ0PR13CA0035.namprd13.prod.outlook.com (2603:10b6:a03:2c2::10) by DM4PR12MB5793.namprd12.prod.outlook.com (2603:10b6:8:60::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8182.18; Fri, 29 Nov 2024 04:32:43 +0000 Received: from SJ5PEPF00000209.namprd05.prod.outlook.com (2603:10b6:a03:2c2:cafe::4e) by SJ0PR13CA0035.outlook.office365.com (2603:10b6:a03:2c2::10) with Microsoft SMTP Server (version=TLS1_3, cipher=TLS_AES_256_GCM_SHA384) id 15.20.8207.14 via Frontend Transport; Fri, 29 Nov 2024 04:32: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 SJ5PEPF00000209.mail.protection.outlook.com (10.167.244.42) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.8207.12 via Frontend Transport; Fri, 29 Nov 2024 04:32:43 +0000 Received: from jfw9ny3-os.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.39; Thu, 28 Nov 2024 22:32:39 -0600 From: Sivaprasad Tummala To: , , , , , , , , CC: Subject: [PATCH] power/amd_uncore: add e-smi installation instructions Date: Fri, 29 Nov 2024 04:32:07 +0000 Message-ID: <20241129043207.999912-1-sivaprasad.tummala@amd.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20231219032826.4814-1-sivaprasad.tummala@amd.com> References: <20231219032826.4814-1-sivaprasad.tummala@amd.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain 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: SJ5PEPF00000209:EE_|DM4PR12MB5793:EE_ X-MS-Office365-Filtering-Correlation-Id: ffff6166-577b-48ec-cfc5-08dd102eddfb X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; ARA:13230040|1800799024|36860700013|376014|82310400026; X-Microsoft-Antispam-Message-Info: =?us-ascii?Q?1inTbnM+HQN8zs1dnM1Oqtu+WNs8zOnIaP4WNmwPsWi/WbJwq2FtM65g9Dmb?= =?us-ascii?Q?ThGTJTzsQuQ7PyPdK8bCZT4MbmI2JZIjPrJuTmC7v/q78rcgAMDvYPTfY5+Y?= =?us-ascii?Q?CceortlyVFl6VGwYme8hIjtQl/PXGBONuip2UkSwHfUc6uVK7RgFmb9f1yiT?= =?us-ascii?Q?LHmXV3PAVVPWPf2PsyXrXW3k6j0Mh/487cwUiBnnibEly2oL2+MHo39Mv8ns?= =?us-ascii?Q?aa6oM4Gfx0leJ3KXB2qdpiaqrrEkWS5ElyPljrV/AXnbZ8v2GJQRuVCgXpQP?= =?us-ascii?Q?I/oB07yoCJCNvbTD9tsuLvXgCd/bmcfn29qiitM35sJwOV/wpqP7hJDAVOaj?= =?us-ascii?Q?czIhl16uGzRPK798WPprkL1Rrz0HujljVRfZJTpBAJlFFpFafgZFuT704EIb?= =?us-ascii?Q?59CvTtWnUnGL9cabFEZeVPKuLG5hvklS5oKOfaev6TXlF+7F5FNgd4pOGPZF?= =?us-ascii?Q?Uq13b8LmjrxSoJirPnliCbnDWkv+HUHmTKk/PuzCCtxjrslFw4JiEHcP/VNS?= =?us-ascii?Q?4UqtCXOyA/zdOHD52+J9RYXPwAIfdrDemBjXDlNurdOilxtqYTeo2nWBPUEV?= =?us-ascii?Q?uIYR5ecDcEoXQbO1gE1y+HjShASBmKf+/7MWwuRWzItB5mDp9NFTLW3bLThm?= =?us-ascii?Q?+veopELcTTJd9j4ZfLUIWS8uIWsqzbNh6mK+mwV6eml0VKJtFSAtwxl5QySR?= =?us-ascii?Q?VvlzKQO/ObXFlEdOYJGpio8Tw4+S3Rb0wuVyIs13omT6AztHTEJS28Co7l3E?= =?us-ascii?Q?u6YOP4FCdzp5x9DGp2EnOEpZkFNAptfd2hvycLs4NeCJ4uFsoNiJn1c1Rms4?= =?us-ascii?Q?RM7j/g0F979sorLwz1JW3+k+gmsm/gE5ibir4XzBVVTOCP4UZng2PiQSLIsK?= =?us-ascii?Q?7I1hSkpLOxPjrpcKy9xuuCvj8i5UZhWvGJyIL1ESt7UhJy7wP/nZpv4XwlBx?= =?us-ascii?Q?+J9q/lKNyaSRdswGSUihhFG4u5sjsiTJYSJO6MVhOBhF5/7j8lB5SvSEVGyo?= =?us-ascii?Q?ibVaf+BYpUJEMSyn5WWwaYfAKVTAMfA0FLgf1K8qTlBlGk8EiXHPFGoyXCXw?= =?us-ascii?Q?xs79w+9ymFQfXPltrqRbdyewiMBo3JVKaur+PURcLHKvdmisWzQms1UQ6Me5?= =?us-ascii?Q?rm0wHpCsKv7zfNbZMPy4w+4SF0+MuNfB8xfvyUHh6AJFNW1RiOr7axdiKJj/?= =?us-ascii?Q?y7RCPf5fXenmxwgmPGXhdzGrO6dsdvX1EFyeIR23vj2J+ytXL+elrL+euDW5?= =?us-ascii?Q?uZfMy8afhlwKN8n7JVMqRNBH8CQMCM7jWuzUyMlKO2a1XGDVU/e258OUOZKi?= =?us-ascii?Q?6fAktuPWIHrwTH4zZ+/KZR/WBO/AZmWgbrJSL4hvM9k6M2XMGQ8epy2t/Vbq?= =?us-ascii?Q?24GOSKkoQS8cBghz6hCDiDtFH8X/jT1vuoyj9CWliAdChpbqUNxoh5fjdPx7?= =?us-ascii?Q?rKy1mjq05D++DYrxdui8ddbSXWcDVAyU?= 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:(13230040)(1800799024)(36860700013)(376014)(82310400026); DIR:OUT; SFP:1101; X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 29 Nov 2024 04:32:43.3723 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: ffff6166-577b-48ec-cfc5-08dd102eddfb 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: SJ5PEPF00000209.namprd05.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM4PR12MB5793 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 Added section for installing and building the E-SMI library for AMD EPYC Uncore support and version requirements. Signed-off-by: Sivaprasad Tummala --- doc/guides/prog_guide/power_man.rst | 32 +++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/doc/guides/prog_guide/power_man.rst b/doc/guides/prog_guide/power_man.rst index 74039e5786..d367a81596 100644 --- a/doc/guides/prog_guide/power_man.rst +++ b/doc/guides/prog_guide/power_man.rst @@ -249,6 +249,38 @@ Additionally, the EPYC System Management Interface In-band Library for Linux offers essential API, enabling user-space software to effectively manage system functions. +E-SMI Installation +------------------ + +To build DPDK with AMD EPYC Uncore the user is required to download the e-smi +library from `here `_ +and compile it on their user system before building DPDK. + +.. code-block:: console + + cd esmi_ib_library + cmake . + sudo make install + cp /opt/e-sms/e_smi/lib/* /usr/local/lib/* + cp /opt/e-sms/e_smi/include/* /usr/local/include/* + +Library file, header and tool are installed at /opt/e-sms. + +Note: Library is dependent on amd_hsmp.h header and without this, compilation will break. + +The library requires CMake (v3.5.0) to be built. + +As a reference, the following table shows a mapping between the DPDK versions +and the E-SMI library and kernel version supported by them: + +.. table:: DPDK and E-SMI library and kernel version compatibility + + ============== ============== ===================== + DPDK version E-SMI version Linux Kernel version + ============== ============== ===================== + 24.11+ 4.0.0 6.7+ + ============== ============== ===================== + Uncore API Overview ~~~~~~~~~~~~~~~~~~~ -- 2.34.1