From patchwork Fri Aug 11 10:25:33 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sivaprasad Tummala X-Patchwork-Id: 130157 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 1DE4443033; Fri, 11 Aug 2023 12:26:35 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 07B7E40F16; Fri, 11 Aug 2023 12:26:35 +0200 (CEST) Received: from NAM11-CO1-obe.outbound.protection.outlook.com (mail-co1nam11on2061.outbound.protection.outlook.com [40.107.220.61]) by mails.dpdk.org (Postfix) with ESMTP id CAA3A40E03 for ; Fri, 11 Aug 2023 12:26:33 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=A2hkQGPzJCq6ow/mUjSbkVN6mBzF3wRioffjfvibvXoLgBWhtJ9NTwJg0aIiNZuPXtOm6rsFUUTPsNeKfT340MMQYb4aSxMKpC8CyNMiMnb5P/SQaZJCc52dHwF+a8GLKJea+4hToYctHx+EDT7Fj5Df1n+Zxgqc+v7SUSsmocVRJ1dmrbaCSBdb7G/ha9+gjMHoQAXZYCuEQlYhVi8ey/n4DoIl4OlnVERWPUt/pikpbvWCCZBw0ZpuLVu/EfC86n+3QJ6fr8B/7rmmWptmVEP1yn7IMs40WZFhZOW6xocp5KBGm9dodXM2uZsI4gNtULwWUqEFqtBu4cy0rtzLIQ== 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=cM8qwMTOF7BH82qrUi/Yr8NetsjAONJ8xtZoVnI1ysg=; b=evn4HzBXdOm+puzwS0ZmFUOAraNZrU0Hj5sPeQO4gk/zSDgAeecrxl1bPMRICxlarulXD7hPYcN1QO2q0FNY/AGFmeMYW5MI4xcVf6PHr12dy4oIui3pKXOu+lF9axp1x6fPVTdimzdnU7aSkESrUqn0iLgYh8/s2ok65MnF3G7070gYz2E8b1YFAmJu0/+k4diwY4T67yYSIubMwiSZOpDECnx+hQsplr8Kc37UcPuCSSy71k28mvI45m575CaHBcypjVhxZ9wOErFGI2C93ZiUu2eQKbQ1XstgFQ5Nzosq9/QXQiOKn/2qTMEuxCaABZVE/48eZgMi4SE/t1Z4FQ== 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 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=cM8qwMTOF7BH82qrUi/Yr8NetsjAONJ8xtZoVnI1ysg=; b=HOQYYM+EkO/yWe2xWLy2gfyhYSPCLVdx6VgdOnBFIPT1VsHkcc3ODRitPHV6bKPXtdcyEulIpztWfEuDb7J9PRrg/PgSWbt6cC7kmXpUvSmmwrBtpNcOpFadS3NMQFZn8EW9jhZpbp+3zXZXrBeEEUbkC6wG3coAqm5A1aQkjIQ= Received: from CY5PR15CA0017.namprd15.prod.outlook.com (2603:10b6:930:14::7) by MN2PR12MB4342.namprd12.prod.outlook.com (2603:10b6:208:264::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6678.20; Fri, 11 Aug 2023 10:26:31 +0000 Received: from CY4PEPF0000EE38.namprd03.prod.outlook.com (2603:10b6:930:14:cafe::45) by CY5PR15CA0017.outlook.office365.com (2603:10b6:930:14::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6652.31 via Frontend Transport; Fri, 11 Aug 2023 10:26:31 +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 CY4PEPF0000EE38.mail.protection.outlook.com (10.167.242.12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.6652.19 via Frontend Transport; Fri, 11 Aug 2023 10:26:30 +0000 Received: from telco-siena.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; Fri, 11 Aug 2023 05:26:28 -0500 From: Sivaprasad Tummala To: , , CC: Subject: [PATCH v1 1/2] power: refactor uncore power management interfaces Date: Fri, 11 Aug 2023 03:25:33 -0700 Message-ID: <20230811102534.491000-1-sivaprasad.tummala@amd.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20230503170349.740528-1-sivaprasad.tummala@amd.com> References: <20230503170349.740528-1-sivaprasad.tummala@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: CY4PEPF0000EE38:EE_|MN2PR12MB4342:EE_ X-MS-Office365-Filtering-Correlation-Id: 8e76a576-52a1-4e40-8e92-08db9a556ded X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: LwtI+eSQgEy7yKLNDPsMyL6DS3InA0YV4b5Ob5dt94ZE+xFMueoRiIvfOCZBNCKJpZODv4ztGBd1zrcRY2ZzGPKpZHPJdQHwUjyMFTraYIYa3J7a2cQAT/BWsN5bwZ54W1vcR4pUiqM3fhC32+heKl3UYeqw8xAHQrEJ4/or2MUboXgfUC0lkMZAB/Fhg0tBGwTMbQ27ge33Rgz6vnj6x9VzTRlFfEaptpFico9siqrjXzu/n7dPz7SYTeE6hUfInC1+fZWcL83dzxP5Dnjs1I98i9VmQqS2GrmWdwgFo6Mnr1r8dSXs+/FO9dNT/dGFC1JDbQR7Qa1vrHMbHN3JHjwTM8FDkuQjdpfap7cUMxE67K49IcopLd52ToC4+sUMryfzV3UftO6s6tZXKv467YYdLMMOPfSrY7o2e6lIH3DuLUrhZPE+t8SwGwHDG2kuG+P9qRB/KgyekuCK/Jp8Y6ccay0BLaUvLB4SPC2fJYOEpB9fi1w+DEoNT1R8+nnGMiAgZjWRHlwxmdsUzotp+x6Ox1JiDIKuuGOa0YNFbnA2wp69L1wFUHfbILA+Xu6svF7RGkIQc1bURE56v/m8UF95ZomyQO/rg8l3mjWZtgu9kaNw/N/XGlllw9oCfzMo5JGsUB7q/z0TxEQYyGnNPtDjW8oiA0xaFZ9Rpf51R0Io2FIGrGShAdOabkhJicqmVWJUZ6mSeEeJgdOBtdiTT6GMAFvjkfgJfie59GA2kfi5b5XrSSPVl5f8V8SSPUTJ2XQUJsB7lQmkeJABOeg1OA== 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:(13230028)(4636009)(376002)(396003)(39860400002)(136003)(346002)(82310400008)(1800799006)(186006)(451199021)(46966006)(36840700001)(40470700004)(2906002)(44832011)(5660300002)(70586007)(41300700001)(8676002)(4326008)(8936002)(70206006)(6636002)(478600001)(36860700001)(7696005)(6666004)(2616005)(1076003)(40460700003)(26005)(336012)(83380400001)(316002)(110136005)(426003)(86362001)(40480700001)(47076005)(36756003)(82740400003)(16526019)(81166007)(356005)(36900700001); DIR:OUT; SFP:1101; X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 11 Aug 2023 10:26:30.9146 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 8e76a576-52a1-4e40-8e92-08db9a556ded 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: CY4PEPF0000EE38.namprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR12MB4342 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 currently the uncore power management implementation is vendor specific. Added new vendor agnostic uncore power interface similar to rte_power and rename specific implementations ("rte_power_intel_uncore") to "power_intel_uncore" along with functions. Signed-off-by: Sivaprasad Tummala --- lib/power/rte_power_uncore.h | 254 +++++++++++++++++++++++++++++++++++ 1 file changed, 254 insertions(+) create mode 100644 lib/power/rte_power_uncore.h diff --git a/lib/power/rte_power_uncore.h b/lib/power/rte_power_uncore.h new file mode 100644 index 0000000000..e27f483eae --- /dev/null +++ b/lib/power/rte_power_uncore.h @@ -0,0 +1,254 @@ +/* SPDX-License-Identifier: BSD-3-Clause + * Copyright(c) 2022 Intel Corporation + * Copyright(c) 2023 AMD Corporation + */ + +#ifndef RTE_POWER_UNCORE_H +#define RTE_POWER_UNCORE_H + +/** + * @file + * RTE Uncore Frequency Management + */ + +#include +#include "rte_power.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/* Uncore Power Management Environment */ +enum uncore_power_mgmt_env { UNCORE_PM_ENV_NOT_SET, + UNCORE_PM_ENV_INTEL_UNCORE, UNCORE_PM_ENV_AMD_HSMP}; + +/** + * Initialize uncore frequency management for specific die on a package. + * It will get the available frequencies and prepare to set new die frequencies. + * + * This function should NOT be called in the fast path. + * + * @param pkg + * Package number. + * Each physical CPU in a system is referred to as a package. + * @param die + * Die number. + * Each package can have several dies connected together via the uncore mesh. + * + * @return + * - 0 on success. + * - Negative on error. + */ +__rte_experimental +int +rte_power_uncore_init(unsigned int pkg, unsigned int die); + +/** + * Exit uncore frequency management on a specific die on a package. + * It will restore uncore min and* max values to previous values + * before initialization of API. + * + * This function should NOT be called in the fast path. + * + * @param pkg + * Package number. + * Each physical CPU in a system is referred to as a package. + * @param die + * Die number. + * Each package can have several dies connected together via the uncore mesh. + * + * @return + * - 0 on success. + * - Negative on error. + */ +__rte_experimental +int +rte_power_uncore_exit(unsigned int pkg, unsigned int die); + +/** + * Return the current index of available frequencies of a specific die on a package. + * It should be protected outside of this function for threadsafe. + * + * This function should NOT be called in the fast path. + * + * @param pkg + * Package number. + * Each physical CPU in a system is referred to as a package. + * @param die + * Die number. + * Each package can have several dies connected together via the uncore mesh. + * + * @return + * The current index of available frequencies. + * If error, it will return 'RTE_POWER_INVALID_FREQ_INDEX = (~0)'. + */ +typedef uint32_t (*rte_power_get_uncore_freq_t)(unsigned int pkg, unsigned int die); + +extern rte_power_get_uncore_freq_t rte_power_get_uncore_freq; + +/** + * Set minimum and maximum uncore frequency for specified die on a package + * to specified index value. + * It should be protected outside of this function for threadsafe. + * + * This function should NOT be called in the fast path. + * + * @param pkg + * Package number. + * Each physical CPU in a system is referred to as a package. + * @param die + * Die number. + * Each package can have several dies connected together via the uncore mesh. + * @param index + * The index of available frequencies. + * + * @return + * - 1 on success with frequency changed. + * - 0 on success without frequency changed. + * - Negative on error. + */ +typedef int (*rte_power_set_uncore_freq_t)(unsigned int pkg, unsigned int die, uint32_t index); + +extern rte_power_set_uncore_freq_t rte_power_set_uncore_freq; + +/** + * Function pointer definition for generic frequency change functions. + * + * @param pkg + * Package number. + * Each physical CPU in a system is referred to as a package. + * @param die + * Die number. + * Each package can have several dies connected together via the uncore mesh. + * + * @return + * - 1 on success with frequency changed. + * - 0 on success without frequency changed. + * - Negative on error. + */ +typedef int (*rte_power_uncore_freq_change_t)(unsigned int pkg, unsigned int die); + +/** + * Set minimum and maximum uncore frequency for specified die on a package + * to maximum value according to the available frequencies. + * It should be protected outside of this function for threadsafe. + * + * This function should NOT be called in the fast path. + * + * @param pkg + * Package number. + * Each physical CPU in a system is referred to as a package. + * @param die + * Die number. + * Each package can have several dies connected together via the uncore mesh. + * + * @return + * - 1 on success with frequency changed. + * - 0 on success without frequency changed. + * - Negative on error. + */ +extern rte_power_uncore_freq_change_t rte_power_uncore_freq_max; + +/** + * Set minimum and maximum uncore frequency for specified die on a package + * to minimum value according to the available frequencies. + * It should be protected outside of this function for threadsafe. + * + * This function should NOT be called in the fast path. + * + * @param pkg + * Package number. + * Each physical CPU in a system is referred to as a package. + * @param die + * Die number. + * Each package can have several dies connected together via the uncore mesh. + * + * @return + * - 1 on success with frequency changed. + * - 0 on success without frequency changed. + * - Negative on error. + */ +extern rte_power_uncore_freq_change_t rte_power_uncore_freq_min; + +/** + * Return the list of available frequencies in the index array. + * + * This function should NOT be called in the fast path. + * + * @param pkg + * Package number. + * Each physical CPU in a system is referred to as a package. + * @param die + * Die number. + * Each package can have several dies connected together via the uncore mesh. + * @param freqs + * The buffer array to save the frequencies. + * @param num + * The number of frequencies to get. + * + * @return + * - The number of available index's in frequency array. + * - Negative on error. + */ +typedef int (*rte_power_uncore_freqs_t)(unsigned int pkg, unsigned int die, + uint32_t *freqs, uint32_t num); + +extern rte_power_uncore_freqs_t rte_power_uncore_freqs; + +/** + * Return the list length of available frequencies in the index array. + * + * This function should NOT be called in the fast path. + * + * @param pkg + * Package number. + * Each physical CPU in a system is referred to as a package. + * @param die + * Die number. + * Each package can have several dies connected together via the uncore mesh. + * + * @return + * - The number of available index's in frequency array. + * - Negative on error. + */ +typedef int (*rte_power_uncore_get_num_freqs_t)(unsigned int pkg, unsigned int die); + +extern rte_power_uncore_get_num_freqs_t rte_power_uncore_get_num_freqs; + +/** + * Return the number of packages (CPUs) on a system + * by parsing the uncore sysfs directory. + * + * This function should NOT be called in the fast path. + * + * @return + * - Zero on error. + * - Number of package on system on success. + */ +typedef unsigned int (*rte_power_uncore_get_num_pkgs_t)(void); + +extern rte_power_uncore_get_num_pkgs_t rte_power_uncore_get_num_pkgs; + +/** + * Return the number of dies for pakckages (CPUs) specified + * from parsing the uncore sysfs directory. + * + * This function should NOT be called in the fast path. + * + * @param pkg + * Package number. + * Each physical CPU in a system is referred to as a package. + * + * @return + * - Zero on error. + * - Number of dies for package on sucecss. + */ +typedef unsigned int (*rte_power_uncore_get_num_dies_t)(unsigned int pkg); + +extern rte_power_uncore_get_num_dies_t rte_power_uncore_get_num_dies; + +#ifdef __cplusplus +} +#endif + +#endif /* RTE_POWER_UNCORE_H */