1.. SPDX-License-Identifier: GPL-2.0
2
3Kernel driver mp2856
4====================
5
6Supported chips:
7
8  * MPS MP2856
9
10    Prefix: 'mp2856'
11
12  * MPS MP2857
13
14    Prefix: 'mp2857'
15
16Author:
17
18	Peter Yin <peter.yin@quantatw.com>
19
20Description
21-----------
22
23This driver implements support for Monolithic Power Systems, Inc. (MPS)
24vendor dual-loop, digital, multi-phase controller MP2856/MP2857
25
26This device:
27
28- Supports up to two power rail.
29- Supports two pages 0 and 1 for and also pages 2 for configuration.
30- Can configured VOUT readout in direct or VID format and allows
31  setting of different formats on rails 1 and 2. For VID the following
32  protocols are available: AMD SVI3 mode with 5-mV/LSB.
33
34Device supports:
35
36- SVID interface.
37- AVSBus interface.
38
39Device compliant with:
40
41- PMBus rev 1.3 interface.
42
43Device supports direct format for reading output current, output voltage,
44input and output power and temperature.
45Device supports linear format for reading input voltage and input power.
46Device supports VID and direct formats for reading output voltage.
47The below VID modes are supported: AMD SVI3.
48
49The driver provides the following sysfs attributes for current measurements:
50
51- indexes 1  for "iin";
52- indexes 2, 3 for "iout";
53
54**curr[1-3]_alarm**
55
56**curr[1-3]_input**
57
58**curr[1-3]_label**
59
60The driver provides the following sysfs attributes for voltage measurements.
61
62- indexes 1 for "vin";
63- indexes 2, 3 for "vout";
64
65**in[1-3]_crit**
66
67**in[1-3]_crit_alarm**
68
69**in[1-3]_input**
70
71**in[1-3]_label**
72
73**in[1-3]_lcrit**
74
75**in[1-3]_lcrit_alarm**
76
77The driver provides the following sysfs attributes for power measurements.
78
79- indexes 1 for "pin";
80- indexes 2, 3 for "pout";
81
82**power[1-3]_alarm**
83
84**power[1-3]_input**
85
86**power[1-3]_label**
87
88The driver provides the following sysfs attributes for temperature measurements.
89
90**temp[1-2]_crit**
91
92**temp[1-2]_crit_alarm**
93
94**temp[1-2]_input**
95
96**temp[1-2]_max**
97
98**temp[1-2]_max_alarm**
99