1.. SPDX-License-Identifier: GPL-2.0
2
3Kernel driver xdpe122
4=====================
5
6Supported chips:
7
8  * Infineon XDPE11280
9
10    Prefix: 'xdpe11280'
11
12  * Infineon XDPE12254
13
14    Prefix: 'xdpe12254'
15
16  * Infineon XDPE12284
17
18    Prefix: 'xdpe12284'
19
20Authors:
21
22	Vadim Pasternak <vadimp@mellanox.com>
23
24Description
25-----------
26
27This driver implements support for Infineon Multi-phase XDPE112 and XDPE122
28family dual loop voltage regulators.
29These families include XDPE11280, XDPE12284 and XDPE12254 devices.
30The devices from this family compliant with:
31
32- Intel VR13 and VR13HC rev 1.3, IMVP8 rev 1.2 and IMPVP9 rev 1.3 DC-DC
33  converter specification.
34- Intel SVID rev 1.9. protocol.
35- PMBus rev 1.3 interface.
36
37Devices support linear format for reading input voltage, input and output current,
38input and output power and temperature.
39Device supports VID format for reading output voltage. The below modes are
40supported:
41- VR12.0 mode, 5-mV DAC - 0x01.
42- VR12.5 mode, 10-mV DAC - 0x02.
43- IMVP9 mode, 5-mV DAC - 0x03.
44- AMD mode 6.25mV - 0x10.
45
46Devices support two pages for telemetry.
47
48The driver provides for current: input, maximum and critical thresholds
49and maximum and critical alarms. Critical thresholds and critical alarm are
50supported only for current output.
51The driver exports the following attributes for via the sysfs files, where
52indexes 1, 2 are for "iin" and 3, 4 for "iout":
53
54**curr[3-4]_crit**
55
56**curr[3-4]_crit_alarm**
57
58**curr[1-4]_input**
59
60**curr[1-4]_label**
61
62**curr[1-4]_max**
63
64**curr[1-4]_max_alarm**
65
66The driver provides for voltage: input, critical and low critical thresholds
67and critical and low critical alarms.
68The driver exports the following attributes for via the sysfs files, where
69indexes 1, 2 are for "vin" and 3, 4 for "vout":
70
71**in[1-4]_crit**
72
73**in[1-4_crit_alarm**
74
75**in[1-4]_input**
76
77**in[1-4_label**
78
79**in[1-4]_lcrit**
80
81**in[1-41_lcrit_alarm**
82
83The driver provides for power: input and alarms. Power alarm is supported only
84for power input.
85The driver exports the following attributes for via the sysfs files, where
86indexes 1, 2 are for "pin" and 3, 4 for "pout":
87
88**power[1-2]_alarm**
89
90**power[1-4]_input**
91
92**power[1-4]_label**
93
94The driver provides for temperature: input, maximum and critical thresholds
95and maximum and critical alarms.
96The driver exports the following attributes for via the sysfs files:
97
98**temp[1-2]_crit**
99
100**temp[1-2]_crit_alarm**
101
102**temp[1-2]_input**
103
104**temp[1-2]_max**
105
106**temp[1-2]_max_alarm**
107