1.. SPDX-License-Identifier: GPL-2.0-only 2 3Kernel driver mpq8785 4======================= 5 6Supported chips: 7 8 * MPS MPM3695 family 9 * MPS MPM82504 10 * MPS MPQ8785 11 12 Prefix: 'mpq8785' 13 14Author: Charles Hsu <ythsu0511@gmail.com> 15 16Description 17----------- 18 19The MPM3695 family is a scalable, ultra-thin, fully integrated power module with 20a PMBus interface. It offers a complete power solution that achieves up to 2110A (-10 variant), 20A (-25 variant), 25A (-20 variant), 100A (-100 variant) 22of output current with excellent load and line regulation across a wide input 23voltage range. It operates at high efficiency over a wide load range, and can 24be parallled to deliver higher current. Variants -10,-20 and -100 have different 25voltage scale configuration register range (10 bits) than -25 version (11 bits). 26 27The MPM82504 is a quad 25A, scalable, fully integrated power module with a PMBus 28interface. The device offers a complete power solution that achieves up to 25A 29per output channel. The MPM82504 has four output channels that can be paralleled 30to provide 50A, 75A, or 100A of output current for flexible configurations. 31The device can also operate in parallel with the MPM3695-100 and additional 32MPM82504 devices to provide a higher output current. The MPM82504 operates 33at high efficiency across a wide load range. 34 35The MPQ8785 is a fully integrated, PMBus-compatible, high-frequency, synchronous 36buck converter. The MPQ8785 offers a very compact solution that achieves up to 3740A output current per phase, with excellent load and line regulation over a 38wide input supply range. The MPQ8785 operates at high efficiency over a wide 39output current load range. 40 41The PMBus interface provides converter configurations and key parameters 42monitoring. 43 44The devices adopts MPS's proprietary multi-phase digital constant-on-time (MCOT) 45control, which provides fast transient response and eases loop stabilization. 46The MCOT scheme also allows multiple devices or channels to be connected in 47parallel with excellent current sharing and phase interleaving for high-current 48applications. 49 50Fully integrated protection features include over-current protection (OCP), 51over-voltage protection (OVP), under-voltage protection (UVP), and 52over-temperature protection (OTP). 53 54Device compliant with: 55 56- PMBus rev 1.3 interface. 57 58The driver exports the following attributes via the 'sysfs' files 59for input voltage: 60 61**in1_input** 62 63**in1_label** 64 65**in1_max** 66 67**in1_max_alarm** 68 69**in1_min** 70 71**in1_min_alarm** 72 73**in1_crit** 74 75**in1_crit_alarm** 76 77The driver provides the following attributes for output voltage: 78 79**in2_input** 80 81**in2_label** 82 83**in2_alarm** 84 85The driver provides the following attributes for output current: 86 87**curr1_input** 88 89**curr1_label** 90 91**curr1_max** 92 93**curr1_max_alarm** 94 95**curr1_crit** 96 97**curr1_crit_alarm** 98 99The driver provides the following attributes for temperature: 100 101**temp1_input** 102 103**temp1_max** 104 105**temp1_max_alarm** 106 107**temp1_crit** 108 109**temp1_crit_alarm** 110