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