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**