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