From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1030722AbbJ3KJz (ORCPT ); Fri, 30 Oct 2015 06:09:55 -0400 Received: from mail-bn1bon0083.outbound.protection.outlook.com ([157.56.111.83]:23488 "EHLO na01-bn1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1758688AbbJ3KJw (ORCPT ); Fri, 30 Oct 2015 06:09:52 -0400 Authentication-Results: spf=none (sender IP is 165.204.84.221) smtp.mailfrom=amd.com; alien8.de; dkim=none (message not signed) header.d=none;alien8.de; dmarc=permerror action=none header.from=amd.com; X-WSS-ID: 0NX12WA-07-F5I-02 X-M-MSG: From: Huang Rui To: Borislav Petkov , Guenter Roeck , "Peter Zijlstra" , Jean Delvare , "Andy Lutomirski" , Andreas Herrmann , Thomas Gleixner , "Ingo Molnar" , "Rafael J. Wysocki" , "Len Brown" , John Stultz , =?UTF-8?q?Fr=C3=A9d=C3=A9ric=20Weisbecker?= CC: , , , Andreas Herrmann , Aravind Gopalakrishnan , Borislav Petkov , Fengguang Wu , Aaron Lu , SPG_Linux_Kernel , Huang Rui Subject: [PATCH v3 09/10] hwmon: (fam15h_power) Add documentation for TDP and accumulated power algorithm Date: Fri, 30 Oct 2015 17:57:03 +0800 Message-ID: <1446199024-1896-10-git-send-email-ray.huang@amd.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1446199024-1896-1-git-send-email-ray.huang@amd.com> References: <1446199024-1896-1-git-send-email-ray.huang@amd.com> MIME-Version: 1.0 Content-Type: text/plain X-EOPAttributedMessage: 0 X-Forefront-Antispam-Report: CIP:165.204.84.221;CTRY:US;IPV:NLI;EFV:NLI;SFV:NSPM;SFS:(10009020)(6009001)(2980300002)(428002)(189002)(199003)(5001770100001)(53416004)(11100500001)(97736004)(76176999)(5003940100001)(33646002)(5008740100001)(50226001)(50986999)(77096005)(106466001)(87936001)(2950100001)(5007970100001)(101416001)(229853001)(19580395003)(19580405001)(105586002)(86362001)(48376002)(5003600100002)(50466002)(36756003)(92566002)(189998001)(47776003)(921003)(1121003);DIR:OUT;SFP:1101;SCL:1;SRVR:CY1PR12MB0855;H:atltwp01.amd.com;FPR:;SPF:None;PTR:InfoDomainNonexistent;MX:1;A:1;LANG:en; X-Microsoft-Exchange-Diagnostics: 1;CY1PR12MB0855;2:Tw38oRryq+SzqEsauI4k4Td9y/tIPQ36seUVWc5+jgsU72+DCiylLHkGCWIs/uOTz05HRS02g6T4ZXPCyuXB6pe3+N5YWNRsSJBIps/SCYDTklFxmFSAcozjRNnSavYL0JOhWxcw3OsR1LznPSN+r7DONv4ojAJbNcZ+5fFMCY8=;3:+SQoubXWORksRqneXua83RmIWtMkcMeMiizNn4CFznElYfRLsukAwvay8aDiF7OfdtBe/CxdvKiMSwZ4prG6mK0ePDQUECygxtTnKp/06Ehzpwh6f3ggmRev+4AncEj53fltpT8HGenZbiL71UnPT4qnCo/nTkvkCVYzDBcXHRFjvtnz04JwX3iJATw1B9+LqKr+GC3eR4uI03Qd3xBRxpLVvdO6+8EbBHR05MLYTYpLWF8LZ+fgRcsjMDdG6tl7;25:9AbBwrl8y575jzldNYj9bWhj16Uag8vqgGpJTXAPRe/GZU2lo7a26kFCwsPAgmcc0I0Pc3stbHyRybaNxbHgF6yKqb4hdwPyP650WI1QpC8a5Dr1NpNtjOLzKlaRNYz4mImCMoDrTRz6Kl+yDsNWSy9KWo4jDc47UjCzBf/X24ITc3+nRlVLpbQL2J20ghlMTUyjvpPvXM4fUyF1gbodhBSEsUbcHLwflVU69ozibnC/nTbwxvVW4m59fg7BmTJt X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:CY1PR12MB0855; X-Microsoft-Exchange-Diagnostics: 1;CY1PR12MB0855;20:Iruta/uYzhzFXRSrsQDZquQk02PhDHvCzZk8viiJ082VxBEK4IpaE/PY30tIbxABY252N17kj3DxBH/GMuDP4zOmEvOrTgdcv7Tp2kbh5u19R+g6UMurYGJRcYxdkNIf+a85Ep7yDp6diAYnExm2Rq/fHUlUIfBJjfgXciSk6hswqU80GTscpIBR+LqhYoQB8n5WtiyLry7gWgHplpXBVHCH6xT0UHeO9GUkrP05qTte2gXovVTxDDJ6rFKL+iZj+i5a4nmq6VTorGV/JimRKn/WTn2/UbMjlQ1fgQQjsdB6E1I2NjJ3z3Fe2Z5W55CZk5Rz61zKa9XlyG2fAlxdH/uXWxOBlaVy+og6msS5ay9K/P6wZHt6mLV2/zWQaOpoj1qviLjMYbceTA0igo3ZubhI3BSKrvfRhbIjSWV/juUwp36Tk1wleYlyGfCNTIF/uk4neZIzmiRtbrSN69F4QYjO2fWMVACpcek3nPeIwo4DG/MVwQXjEk97MPwyrekI;4:MsflXHbfTYp9Bk0TO3oKO5fwS5Zy5T4A8JTPK+UqiT/u43wpyMaABaLJxx2lgUgSMjSGfgJbxfPUvQSvCT8XiMrFg9FJiYHtok1pocfam2gM825ziJTo1oWiQJQv5gFSszShQBQ9g+aEaUbwF4Jq9QgVIFYuyu50bvYQ502UQWUnOyKwNisCDpwdW6xdSr2G8lIAVOAhno8DYm3XCNtl1cEwDvEwzBJ+J6EGiLDbv/1yVJkbUpu5KWciFnjUE6oQ+9zhuvEN7ww02zz3TkAUllKkX7EdLcG7g6h0Cp1klYhC9bd1hjIm7IKtzxYuDLYUfi0DrpCxKYTvu2+08QPkNW3kKtEXyhbJhEjg1hCbMR9Vp6A+zTyGZ4LrvqmbGZBrUxYO2U7hc1/kc8Slk/NELA== X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(767451399110)(8415204561270); X-Exchange-Antispam-Report-CFA-Test: BCL:0;PCL:0;RULEID:(601004)(2401047)(8121501046)(520078)(5005006)(3002001)(10201501046)(102215026);SRVR:CY1PR12MB0855;BCL:0;PCL:0;RULEID:;SRVR:CY1PR12MB0855; X-Forefront-PRVS: 07459438AA X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1;CY1PR12MB0855;23:Qfc71jR5KDy97yjrqtUujXnXw1UHAmQ+I7Rts9hVI?= =?us-ascii?Q?yEALaGExcr2eMISnfsPGsTS/K5qv3HdUKbqGk0S0icHjMf2k1r/jZoRNErd9?= =?us-ascii?Q?JPnojyhthwSYENcw8d3ynm76KjYRsdo9zxQ2euEDAkWZptMfUnMpV2TgYGz2?= =?us-ascii?Q?l2IHo1D45xIxJN8qA+P5yOtzzVP3uMy/7CSRmlM9JrCaF4bijDEA85oecMWD?= =?us-ascii?Q?+W69eHnb0F4NLtNC5bnBLmzbuQiv0yGt3J8OMzGTVjEADFMTD0MTMYQMgdx2?= =?us-ascii?Q?NXgMI/KCNepgeDtXoi04NWYOM703INk1hjOGlFAUwYckEiqTot+PJS9KegHx?= =?us-ascii?Q?YH9o0OEzASbV2oHUA58D34sPTtM2ljLvZ0q2WB6Lw05rxH8km79QM+2fA1L4?= =?us-ascii?Q?gICevqXWHkZib6FeYl4czYzwUUUXx14dH9aH3Px7ZYubG6VNMgzCyia3il3n?= =?us-ascii?Q?PpTm4xhtqBlgxO5SSl7ljrUenl28csmbDJP9K2vb/rNhA9zDBdrhKed8O7yF?= =?us-ascii?Q?TevWhcKUgQOY6V/umX/F4xWD2o7ysI16K0Rckh+85yBWVMLRKYUWS/Pv1zIR?= =?us-ascii?Q?JES6+eIWCtOZ2aCKOL1VdGcS2LpzeT+O/A7sSxDUjfFv4CC3TOgBGTh0xuiI?= =?us-ascii?Q?w/m29APq3gzijXfNig9IJGOTz4KB1upsDXG7GyUKCKjDxIUuft6oxbjY9b7V?= =?us-ascii?Q?/212tcPjc7ABu4+s6cedUhDt7ufDLaKcKNz+wxSWOX+c2THmivqiSI/bUb+X?= =?us-ascii?Q?5aYUEReEAOfm1swHmY5KoWfieUm2DNGXTc+E02BUWCWFmRdE819Od0nE2WlK?= =?us-ascii?Q?FNXK2pg8h467wySMvvat22+uUp/f+ncVrRr4luutaLmhLuaEBeIbpmE/1hrc?= =?us-ascii?Q?2BGtoqI+ZVxadvLK6afTW2eqHvO+qUoMyejJR68JNRgnSX7uZIUegWZmfGdZ?= =?us-ascii?Q?ejpwJhmzzpi+4v+U1JZpxdJ1T0B3mvbn2Jovh1p9w=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1;CY1PR12MB0855;5:Zmqb1VwUpXV0GorTmCPlpPlGMQXxiZjMHPtR+HWf+zEM89FUrxFl5KTL04GT6ODFsvlmFHNnJV2SGdeWSv3hOxSNL5WQxBLVHWmxsQg/bDQ07tqKFcrwApl3KwSS4YFkOcykoXIz+8ro/UQq1la/Mg==;24:JONosV252btl/G0/b0+1FV4/J3IXYlq1ejCb7o2fxbAH8UUiv6RudEyTHlwzL2Gm53MVBr2oFs0m1FvR875QRHROJYrmERz6L7qSwMXVzbc=;20:6X4+408Im8EggmmByIT6ZiAKBWENlY72SfupG1wCVeLXlGBO40X+TomaGcH0b/ERHfZflnazvA0Fw8lUP3pvBooKpexro86D4h5jGq9b3phWQQbBl/FcwsdRfD/vtoi8K9VAZgDVaK3PCnltxFVoz6boAuMNqZ8gnBBYqxwRKfO1hbcA/SGX2+P/dX2v5doMfcHDBQWuHZkLbJ4d2+NuAVi5cjBOxs3YZY/GHUqOZg1tAetkq4zQQM6CANF7rB8W SpamDiagnosticOutput: 1:23 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 30 Oct 2015 10:09:47.7886 (UTC) 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.221];Helo=[atltwp01.amd.com] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY1PR12MB0855 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org This patch adds the description to explain the TDP reporting mechanism and accumulated power algorithm. Signed-off-by: Huang Rui Cc: Borislav Petkov Cc: Guenter Roeck Cc: Peter Zijlstra Cc: Ingo Molnar --- Documentation/hwmon/fam15h_power | 57 +++++++++++++++++++++++++++++++++++++++- 1 file changed, 56 insertions(+), 1 deletion(-) diff --git a/Documentation/hwmon/fam15h_power b/Documentation/hwmon/fam15h_power index e2b1b69..2c4fbee 100644 --- a/Documentation/hwmon/fam15h_power +++ b/Documentation/hwmon/fam15h_power @@ -10,14 +10,22 @@ Supported chips: Datasheets: BIOS and Kernel Developer's Guide (BKDG) For AMD Family 15h Processors BIOS and Kernel Developer's Guide (BKDG) For AMD Family 16h Processors + AMD64 Architecture Programmer's Manual Volume 2: System Programming Author: Andreas Herrmann Description ----------- +1) Processor TDP (Thermal design power) + +Given a fixed frequency and voltage, the power consumption of a +processor varies based on the workload being executed. Derated power +is the power consumed when running a specific application. Thermal +design power (TDP) is an example of derated power. + This driver permits reading of registers providing power information -of AMD Family 15h and 16h processors. +of AMD Family 15h and 16h processors via TDP algorithm. For AMD Family 15h and 16h processors the following power values can be calculated using different processor northbridge function @@ -37,3 +45,50 @@ This driver provides ProcessorPwrWatts and CurrPwrWatts: On multi-node processors the calculated value is for the entire package and not for a single node. Thus the driver creates sysfs attributes only for internal node0 of a multi-node processor. + +2) Accumulated Power Mechanism + +This driver also introduces an algorithm that should be used to +calculate the average power consumed by a processor during a +measurement interval Tm. The feature of accumulated power mechanism is +indicated by CPUID Fn8000_0007_EDX[12]. + +* Tsample: compute unit power accumulator sample period +* Tref: the PTSC counter period +* PTSC: performance timestamp counter +* N: the ratio of compute unit power accumulator sample period to the + PTSC period +* Jmax: max compute unit accumulated power which is indicated by + MaxCpuSwPwrAcc MSR C001007b +* Jx/Jy: compute unit accumulated power which is indicated by + CpuSwPwrAcc MSR C001007a +* Tx/Ty: the value of performance timestamp counter which is indicated + by CU_PTSC MSR C0010280 +* PwrCPUave: CPU average power + +i. Determine the ratio of Tsample to Tref by executing CPUID Fn8000_0007. + N = value of CPUID Fn8000_0007_ECX[CpuPwrSampleTimeRatio[15:0]]. + +ii. Read the full range of the cumulative energy value from the new +MSR MaxCpuSwPwrAcc. + Jmax = value returned. +iii. At time x, SW reads CpuSwPwrAcc MSR and samples the PTSC. + Jx = value read from CpuSwPwrAcc and Tx = value read from +PTSC. + +iv. At time y, SW reads CpuSwPwrAcc MSR and samples the PTSC. + Jy = value read from CpuSwPwrAcc and Ty = value read from +PTSC. + +v. Calculate the average power consumption for a compute unit over +time period (y-x). Unit of result is uWatt. + if (Jy < Jx) // Rollover has occurred + Jdelta = (Jy + Jmax) - Jx + else + Jdelta = Jy - Jx + PwrCPUave = N * Jdelta * 1000 / (Ty - Tx) + +This driver provides PwrCPUave and interval(default is 10 millisecond +and maximum is 1 second): +* power1_average (PwrCPUave) +* power1_average_interval (Interval) -- 1.9.1