xref: /openbmc/linux/Documentation/hwmon/xdpe12284.rst (revision 0a923a76d615b4f54456ce6c52865bb0d5b5516d)
1971dfd8cSVadim Pasternak.. SPDX-License-Identifier: GPL-2.0
2971dfd8cSVadim Pasternak
3971dfd8cSVadim PasternakKernel driver xdpe122
4971dfd8cSVadim Pasternak=====================
5971dfd8cSVadim Pasternak
6971dfd8cSVadim PasternakSupported chips:
7971dfd8cSVadim Pasternak
8971dfd8cSVadim Pasternak  * Infineon XDPE12254
9971dfd8cSVadim Pasternak
10971dfd8cSVadim Pasternak    Prefix: 'xdpe12254'
11971dfd8cSVadim Pasternak
12971dfd8cSVadim Pasternak  * Infineon XDPE12284
13971dfd8cSVadim Pasternak
14971dfd8cSVadim Pasternak    Prefix: 'xdpe12284'
15971dfd8cSVadim Pasternak
16971dfd8cSVadim PasternakAuthors:
17971dfd8cSVadim Pasternak
18971dfd8cSVadim Pasternak	Vadim Pasternak <vadimp@mellanox.com>
19971dfd8cSVadim Pasternak
20971dfd8cSVadim PasternakDescription
21971dfd8cSVadim Pasternak-----------
22971dfd8cSVadim Pasternak
23971dfd8cSVadim PasternakThis driver implements support for Infineon Multi-phase XDPE122 family
24971dfd8cSVadim Pasternakdual loop voltage regulators.
25971dfd8cSVadim PasternakThe family includes XDPE12284 and XDPE12254 devices.
26971dfd8cSVadim PasternakThe devices from this family complaint with:
27*0a923a76SRandy Dunlap
28971dfd8cSVadim Pasternak- Intel VR13 and VR13HC rev 1.3, IMVP8 rev 1.2 and IMPVP9 rev 1.3 DC-DC
29971dfd8cSVadim Pasternak  converter specification.
30971dfd8cSVadim Pasternak- Intel SVID rev 1.9. protocol.
31971dfd8cSVadim Pasternak- PMBus rev 1.3 interface.
32971dfd8cSVadim Pasternak
33971dfd8cSVadim PasternakDevices support linear format for reading input voltage, input and output current,
34971dfd8cSVadim Pasternakinput and output power and temperature.
35971dfd8cSVadim PasternakDevice supports VID format for reading output voltage. The below modes are
36971dfd8cSVadim Pasternaksupported:
37971dfd8cSVadim Pasternak- VR12.0 mode, 5-mV DAC - 0x01.
38971dfd8cSVadim Pasternak- VR12.5 mode, 10-mV DAC - 0x02.
39971dfd8cSVadim Pasternak- IMVP9 mode, 5-mV DAC - 0x03.
40971dfd8cSVadim Pasternak- AMD mode 6.25mV - 0x10.
41971dfd8cSVadim Pasternak
42971dfd8cSVadim PasternakDevices support two pages for telemetry.
43971dfd8cSVadim Pasternak
44971dfd8cSVadim PasternakThe driver provides for current: input, maximum and critical thresholds
45971dfd8cSVadim Pasternakand maximum and critical alarms. Critical thresholds and critical alarm are
46971dfd8cSVadim Pasternaksupported only for current output.
47971dfd8cSVadim PasternakThe driver exports the following attributes for via the sysfs files, where
48971dfd8cSVadim Pasternakindexes 1, 2 are for "iin" and 3, 4 for "iout":
49971dfd8cSVadim Pasternak
50971dfd8cSVadim Pasternak**curr[3-4]_crit**
51971dfd8cSVadim Pasternak
52971dfd8cSVadim Pasternak**curr[3-4]_crit_alarm**
53971dfd8cSVadim Pasternak
54971dfd8cSVadim Pasternak**curr[1-4]_input**
55971dfd8cSVadim Pasternak
56971dfd8cSVadim Pasternak**curr[1-4]_label**
57971dfd8cSVadim Pasternak
58971dfd8cSVadim Pasternak**curr[1-4]_max**
59971dfd8cSVadim Pasternak
60971dfd8cSVadim Pasternak**curr[1-4]_max_alarm**
61971dfd8cSVadim Pasternak
62971dfd8cSVadim PasternakThe driver provides for voltage: input, critical and low critical thresholds
63971dfd8cSVadim Pasternakand critical and low critical alarms.
64971dfd8cSVadim PasternakThe driver exports the following attributes for via the sysfs files, where
65971dfd8cSVadim Pasternakindexes 1, 2 are for "vin" and 3, 4 for "vout":
66971dfd8cSVadim Pasternak
67971dfd8cSVadim Pasternak**in[1-4]_crit**
68971dfd8cSVadim Pasternak
69971dfd8cSVadim Pasternak**in[1-4_crit_alarm**
70971dfd8cSVadim Pasternak
71971dfd8cSVadim Pasternak**in[1-4]_input**
72971dfd8cSVadim Pasternak
73971dfd8cSVadim Pasternak**in[1-4_label**
74971dfd8cSVadim Pasternak
75971dfd8cSVadim Pasternak**in[1-4]_lcrit**
76971dfd8cSVadim Pasternak
77971dfd8cSVadim Pasternak**in[1-41_lcrit_alarm**
78971dfd8cSVadim Pasternak
79971dfd8cSVadim PasternakThe driver provides for power: input and alarms. Power alarm is supported only
80971dfd8cSVadim Pasternakfor power input.
81971dfd8cSVadim PasternakThe driver exports the following attributes for via the sysfs files, where
82971dfd8cSVadim Pasternakindexes 1, 2 are for "pin" and 3, 4 for "pout":
83971dfd8cSVadim Pasternak
84971dfd8cSVadim Pasternak**power[1-2]_alarm**
85971dfd8cSVadim Pasternak
86971dfd8cSVadim Pasternak**power[1-4]_input**
87971dfd8cSVadim Pasternak
88971dfd8cSVadim Pasternak**power[1-4]_label**
89971dfd8cSVadim Pasternak
90971dfd8cSVadim PasternakThe driver provides for temperature: input, maximum and critical thresholds
91971dfd8cSVadim Pasternakand maximum and critical alarms.
92971dfd8cSVadim PasternakThe driver exports the following attributes for via the sysfs files:
93971dfd8cSVadim Pasternak
94971dfd8cSVadim Pasternak**temp[1-2]_crit**
95971dfd8cSVadim Pasternak
96971dfd8cSVadim Pasternak**temp[1-2]_crit_alarm**
97971dfd8cSVadim Pasternak
98971dfd8cSVadim Pasternak**temp[1-2]_input**
99971dfd8cSVadim Pasternak
100971dfd8cSVadim Pasternak**temp[1-2]_max**
101971dfd8cSVadim Pasternak
102971dfd8cSVadim Pasternak**temp[1-2]_max_alarm**
103