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