xref: /linux/Documentation/hwmon/mp2891.rst (revision a1ff5a7d78a036d6c2178ee5acd6ba4946243800)
1*38b2b022SNoah Wang.. SPDX-License-Identifier: GPL-2.0
2*38b2b022SNoah Wang
3*38b2b022SNoah WangKernel driver mp2891
4*38b2b022SNoah Wang====================
5*38b2b022SNoah Wang
6*38b2b022SNoah WangSupported chips:
7*38b2b022SNoah Wang
8*38b2b022SNoah Wang  * MPS mp2891
9*38b2b022SNoah Wang
10*38b2b022SNoah Wang    Prefix: 'mp2891'
11*38b2b022SNoah Wang
12*38b2b022SNoah Wang  * Datasheet
13*38b2b022SNoah Wang
14*38b2b022SNoah Wang    Publicly available at the MPS website : https://www.monolithicpower.com/en/mp2891.html
15*38b2b022SNoah Wang
16*38b2b022SNoah WangAuthor:
17*38b2b022SNoah Wang
18*38b2b022SNoah Wang	Noah Wang <noahwang.wang@outlook.com>
19*38b2b022SNoah Wang
20*38b2b022SNoah WangDescription
21*38b2b022SNoah Wang-----------
22*38b2b022SNoah Wang
23*38b2b022SNoah WangThis driver implements support for Monolithic Power Systems, Inc. (MPS)
24*38b2b022SNoah WangMP2891 Multi-phase Digital VR Controller.
25*38b2b022SNoah Wang
26*38b2b022SNoah WangDevice compliant with:
27*38b2b022SNoah Wang
28*38b2b022SNoah Wang- PMBus rev 1.3 interface.
29*38b2b022SNoah Wang
30*38b2b022SNoah WangDevice supports direct and linear format for reading input voltage,
31*38b2b022SNoah Wangoutput voltage, input current, output current, input power, output
32*38b2b022SNoah Wangpower, and temperature.
33*38b2b022SNoah Wang
34*38b2b022SNoah WangThe driver exports the following attributes via the 'sysfs' files
35*38b2b022SNoah Wangfor input voltage:
36*38b2b022SNoah Wang
37*38b2b022SNoah Wang**in1_input**
38*38b2b022SNoah Wang
39*38b2b022SNoah Wang**in1_label**
40*38b2b022SNoah Wang
41*38b2b022SNoah Wang**in1_crit**
42*38b2b022SNoah Wang
43*38b2b022SNoah Wang**in1_crit_alarm**
44*38b2b022SNoah Wang
45*38b2b022SNoah Wang**in1_lcrit**
46*38b2b022SNoah Wang
47*38b2b022SNoah Wang**in1_lcrit_alarm**
48*38b2b022SNoah Wang
49*38b2b022SNoah Wang**in1_min**
50*38b2b022SNoah Wang
51*38b2b022SNoah Wang**in1_min_alarm**
52*38b2b022SNoah Wang
53*38b2b022SNoah WangThe driver provides the following attributes for output voltage:
54*38b2b022SNoah Wang
55*38b2b022SNoah Wang**in2_input**
56*38b2b022SNoah Wang
57*38b2b022SNoah Wang**in2_label**
58*38b2b022SNoah Wang
59*38b2b022SNoah Wang**in2_crit**
60*38b2b022SNoah Wang
61*38b2b022SNoah Wang**in2_crit_alarm**
62*38b2b022SNoah Wang
63*38b2b022SNoah Wang**in2_lcrit**
64*38b2b022SNoah Wang
65*38b2b022SNoah Wang**in2_lcrit_alarm**
66*38b2b022SNoah Wang
67*38b2b022SNoah Wang**in2_min**
68*38b2b022SNoah Wang
69*38b2b022SNoah Wang**in2_min_alarm**
70*38b2b022SNoah Wang
71*38b2b022SNoah Wang**in3_input**
72*38b2b022SNoah Wang
73*38b2b022SNoah Wang**in3_label**
74*38b2b022SNoah Wang
75*38b2b022SNoah Wang**in3_crit**
76*38b2b022SNoah Wang
77*38b2b022SNoah Wang**in3_crit_alarm**
78*38b2b022SNoah Wang
79*38b2b022SNoah Wang**in3_lcrit**
80*38b2b022SNoah Wang
81*38b2b022SNoah Wang**in3_lcrit_alarm**
82*38b2b022SNoah Wang
83*38b2b022SNoah Wang**in3_min**
84*38b2b022SNoah Wang
85*38b2b022SNoah Wang**in3_min_alarm**
86*38b2b022SNoah Wang
87*38b2b022SNoah WangThe driver provides the following attributes for input current:
88*38b2b022SNoah Wang
89*38b2b022SNoah Wang**curr1_input**
90*38b2b022SNoah Wang
91*38b2b022SNoah Wang**curr1_label**
92*38b2b022SNoah Wang
93*38b2b022SNoah Wang**curr1_max**
94*38b2b022SNoah Wang
95*38b2b022SNoah Wang**curr1_max_alarm**
96*38b2b022SNoah Wang
97*38b2b022SNoah Wang**curr2_input**
98*38b2b022SNoah Wang
99*38b2b022SNoah Wang**curr2_label**
100*38b2b022SNoah Wang
101*38b2b022SNoah Wang**curr2_max**
102*38b2b022SNoah Wang
103*38b2b022SNoah Wang**curr2_max_alarm**
104*38b2b022SNoah Wang
105*38b2b022SNoah WangThe driver provides the following attributes for output current:
106*38b2b022SNoah Wang
107*38b2b022SNoah Wang**curr3_input**
108*38b2b022SNoah Wang
109*38b2b022SNoah Wang**curr3_label**
110*38b2b022SNoah Wang
111*38b2b022SNoah Wang**curr3_crit**
112*38b2b022SNoah Wang
113*38b2b022SNoah Wang**curr3_crit_alarm**
114*38b2b022SNoah Wang
115*38b2b022SNoah Wang**curr3_max**
116*38b2b022SNoah Wang
117*38b2b022SNoah Wang**curr3_max_alarm**
118*38b2b022SNoah Wang
119*38b2b022SNoah Wang**curr4_input**
120*38b2b022SNoah Wang
121*38b2b022SNoah Wang**curr4_label**
122*38b2b022SNoah Wang
123*38b2b022SNoah Wang**curr4_crit**
124*38b2b022SNoah Wang
125*38b2b022SNoah Wang**curr4_crit_alarm**
126*38b2b022SNoah Wang
127*38b2b022SNoah Wang**curr4_max**
128*38b2b022SNoah Wang
129*38b2b022SNoah Wang**curr4_max_alarm**
130*38b2b022SNoah Wang
131*38b2b022SNoah WangThe driver provides the following attributes for input power:
132*38b2b022SNoah Wang
133*38b2b022SNoah Wang**power1_input**
134*38b2b022SNoah Wang
135*38b2b022SNoah Wang**power1_label**
136*38b2b022SNoah Wang
137*38b2b022SNoah Wang**power1_max**
138*38b2b022SNoah Wang
139*38b2b022SNoah Wang**power1_alarm**
140*38b2b022SNoah Wang
141*38b2b022SNoah Wang**power2_input**
142*38b2b022SNoah Wang
143*38b2b022SNoah Wang**power2_label**
144*38b2b022SNoah Wang
145*38b2b022SNoah Wang**power2_max**
146*38b2b022SNoah Wang
147*38b2b022SNoah Wang**power2_alarm**
148*38b2b022SNoah Wang
149*38b2b022SNoah WangThe driver provides the following attributes for output power:
150*38b2b022SNoah Wang
151*38b2b022SNoah Wang**power3_input**
152*38b2b022SNoah Wang
153*38b2b022SNoah Wang**power3_label**
154*38b2b022SNoah Wang
155*38b2b022SNoah Wang**power4_input**
156*38b2b022SNoah Wang
157*38b2b022SNoah Wang**power4_label**
158*38b2b022SNoah Wang
159*38b2b022SNoah WangThe driver provides the following attributes for temperature:
160*38b2b022SNoah Wang
161*38b2b022SNoah Wang**temp1_input**
162*38b2b022SNoah Wang
163*38b2b022SNoah Wang**temp1_crit**
164*38b2b022SNoah Wang
165*38b2b022SNoah Wang**temp1_crit_alarm**
166*38b2b022SNoah Wang
167*38b2b022SNoah Wang**temp1_max**
168*38b2b022SNoah Wang
169*38b2b022SNoah Wang**temp1_max_alarm**
170*38b2b022SNoah Wang
171*38b2b022SNoah Wang**temp2_input**
172*38b2b022SNoah Wang
173*38b2b022SNoah Wang**temp2_crit**
174*38b2b022SNoah Wang
175*38b2b022SNoah Wang**temp2_crit_alarm**
176*38b2b022SNoah Wang
177*38b2b022SNoah Wang**temp2_max**
178*38b2b022SNoah Wang
179*38b2b022SNoah Wang**temp2_max_alarm**
180