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