summaryrefslogtreecommitdiff
path: root/Documentation/hwmon/peci-dimmpower.rst
blob: 0d9c58fdaf9c7a8aa873dd06eacaef9c5f6f36a5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
.. SPDX-License-Identifier: GPL-2.0

Kernel driver peci-dimmpower
==========================

:Copyright: |copy| 2020 Intel Corporation

Supported chips:
	One of Intel server CPUs listed below which is connected to a PECI bus.
		* Intel Xeon E5/E7 v3 server processors
			Intel Xeon E5-14xx v3 family
			Intel Xeon E5-24xx v3 family
			Intel Xeon E5-16xx v3 family
			Intel Xeon E5-26xx v3 family
			Intel Xeon E5-46xx v3 family
			Intel Xeon E7-48xx v3 family
			Intel Xeon E7-88xx v3 family
		* Intel Xeon E5/E7 v4 server processors
			Intel Xeon E5-16xx v4 family
			Intel Xeon E5-26xx v4 family
			Intel Xeon E5-46xx v4 family
			Intel Xeon E7-48xx v4 family
			Intel Xeon E7-88xx v4 family
		* Intel Xeon Scalable server processors
			Intel Xeon D family
			Intel Xeon Bronze family
			Intel Xeon Silver family
			Intel Xeon Gold family
			Intel Xeon Platinum family

	Addresses scanned: PECI client address 0x30 - 0x37
	Datasheet: Available from http://www.intel.com/design/literature.htm

Author:
	Zbigniew Lukwinski <zbigniew.lukwinski@linux.intel.com>

Description
-----------

This driver implements a generic PECI hwmon feature which provides
average power consumption readings of the memory basing on energy counter.
Power value is average power since last measure given in milli Watt and
will be measurable only when the target CPU is powered on.
Driver provides current plane power limit, maximal and minimal power setting
as well.
All needed processor registers are accessible using the PECI Client Command
Suite via the processor PECI client.

``sysfs`` interface
-------------------
======================= =======================================================
power1_label		Provides string "dimm power".
power1_average		Provides average DRAM power since last read in milli Watt.
power1_cap			Provides current DRAM plane power limit.
power1_cap_max		Provides maximal DRAM power setting.
power1_cap_min		Provides minimal DRAM power setting.
======================= =======================================================