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