1 .. SPDX-License-Identifier: GPL-2.0 1 .. SPDX-License-Identifier: GPL-2.0
2 2
3 Kernel driver mp2888 3 Kernel driver mp2888
4 ==================== 4 ====================
5 5
6 Supported chips: 6 Supported chips:
7 7
8 * MPS MP12254 8 * MPS MP12254
9 9
10 Prefix: 'mp2888' 10 Prefix: 'mp2888'
11 11
12 Author: 12 Author:
13 13
14 Vadim Pasternak <vadimp@nvidia.com> 14 Vadim Pasternak <vadimp@nvidia.com>
15 15
16 Description 16 Description
17 ----------- 17 -----------
18 18
19 This driver implements support for Monolithic 19 This driver implements support for Monolithic Power Systems, Inc. (MPS)
20 vendor dual-loop, digital, multi-phase control 20 vendor dual-loop, digital, multi-phase controller MP2888.
21 21
22 This device: supports: 22 This device: supports:
23 23
24 - One power rail. 24 - One power rail.
25 - Programmable Multi-Phase up to 10 Phases. 25 - Programmable Multi-Phase up to 10 Phases.
26 - PWM-VID Interface 26 - PWM-VID Interface
27 - One pages 0 for telemetry. 27 - One pages 0 for telemetry.
28 - Programmable pins for PMBus Address. 28 - Programmable pins for PMBus Address.
29 - Built-In EEPROM to Store Custom Configuratio 29 - Built-In EEPROM to Store Custom Configurations.
30 30
31 Device complaint with: 31 Device complaint with:
32 32
33 - PMBus rev 1.3 interface. 33 - PMBus rev 1.3 interface.
34 34
35 Device supports direct format for reading outp 35 Device supports direct format for reading output current, output voltage,
36 input and output power and temperature. 36 input and output power and temperature.
37 Device supports linear format for reading inpu 37 Device supports linear format for reading input voltage and input power.
38 38
39 The driver provides the next attributes for th 39 The driver provides the next attributes for the current:
40 40
41 - for current out input and maximum alarm; 41 - for current out input and maximum alarm;
42 - for phase current: input and label. 42 - for phase current: input and label.
43 43
44 The driver exports the following attributes vi 44 The driver exports the following attributes via the 'sysfs' files, where:
45 45
46 - 'n' is number of configured phases (from 1 t 46 - 'n' is number of configured phases (from 1 to 10);
47 - index 1 for "iout"; 47 - index 1 for "iout";
48 - indexes 2 ... 1 + n for phases. 48 - indexes 2 ... 1 + n for phases.
49 49
50 **curr[1-{1+n}]_input** 50 **curr[1-{1+n}]_input**
51 51
52 **curr[1-{1+n}]_label** 52 **curr[1-{1+n}]_label**
53 53
54 **curr1_max** 54 **curr1_max**
55 55
56 **curr1_max_alarm** 56 **curr1_max_alarm**
57 57
58 The driver provides the next attributes for th 58 The driver provides the next attributes for the voltage:
59 59
60 - for voltage in: input, low and high critical 60 - for voltage in: input, low and high critical thresholds, low and high
61 critical alarms; 61 critical alarms;
62 - for voltage out: input and high alarm; 62 - for voltage out: input and high alarm;
63 63
64 The driver exports the following attributes vi 64 The driver exports the following attributes via the 'sysfs' files, where
65 65
66 **in1_crit** 66 **in1_crit**
67 67
68 **in1_crit_alarm** 68 **in1_crit_alarm**
69 69
70 **in1_input** 70 **in1_input**
71 71
72 **in1_label** 72 **in1_label**
73 73
74 **in1_min** 74 **in1_min**
75 75
76 **in1_min_alarm** 76 **in1_min_alarm**
77 77
78 **in2_alarm** 78 **in2_alarm**
79 79
80 **in2_input** 80 **in2_input**
81 81
82 **in2_label** 82 **in2_label**
83 83
84 The driver provides the next attributes for th 84 The driver provides the next attributes for the power:
85 85
86 - for power in alarm and input. 86 - for power in alarm and input.
87 - for power out: cap, cap alarm an input. 87 - for power out: cap, cap alarm an input.
88 88
89 The driver exports the following attributes vi 89 The driver exports the following attributes via the 'sysfs' files, where
90 - indexes 1 for "pin"; 90 - indexes 1 for "pin";
91 - indexes 2 for "pout"; 91 - indexes 2 for "pout";
92 92
93 **power1_alarm** 93 **power1_alarm**
94 94
95 **power1_input** 95 **power1_input**
96 96
97 **power1_label** 97 **power1_label**
98 98
99 **power2_input** 99 **power2_input**
100 100
101 **power2_label** 101 **power2_label**
102 102
103 **power2_max** 103 **power2_max**
104 104
105 **power2_max_alarm** 105 **power2_max_alarm**
106 106
107 The driver provides the next attributes for th 107 The driver provides the next attributes for the temperature:
108 108
109 **temp1_input** 109 **temp1_input**
110 110
111 **temp1_max** 111 **temp1_max**
112 112
113 **temp1_max_alarm** 113 **temp1_max_alarm**
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.