ARK-OS/arkos/kernel/Documentation/hwmon/mpq8785.rst

.. SPDX-License-Identifier: GPL-2.0-only

Kernel driver mpq8785
=======================

Supported chips:

  * MPS MPM3695 family
  * MPS MPM82504
  * MPS MPQ8785

    Prefix: 'mpq8785'

Author: Charles Hsu <ythsu0511@gmail.com>

Description
-----------

The MPM3695 family is a scalable, ultra-thin, fully integrated power module with
a PMBus interface. It offers a complete power solution that achieves up to
10A (-10 variant), 20A (-25 variant), 25A (-20 variant), 100A (-100 variant)
of output current with excellent load and line regulation across a wide input
voltage range. It operates at high efficiency over a wide load range, and can
be parallled to deliver higher current. Variants -10,-20 and -100 have different
voltage scale configuration register range (10 bits) than -25 version (11 bits).

The MPM82504 is a quad 25A, scalable, fully integrated power module with a PMBus
interface. The device offers a complete power solution that achieves up to 25A
per output channel. The MPM82504 has four output channels that can be paralleled
to provide 50A, 75A, or 100A of output current for flexible configurations.
The device can also operate in parallel with the MPM3695-100 and additional
MPM82504 devices to provide a higher output current. The MPM82504 operates
at high efficiency across a wide load range.

The MPQ8785 is a fully integrated, PMBus-compatible, high-frequency, synchronous
buck converter. The MPQ8785 offers a very compact solution that achieves up to
40A output current per phase, with excellent load and line regulation over a
wide input supply range. The MPQ8785 operates at high efficiency over a wide
output current load range.

The PMBus interface provides converter configurations and key parameters
monitoring.

The devices adopts MPS's proprietary multi-phase digital constant-on-time (MCOT)
control, which provides fast transient response and eases loop stabilization.
The MCOT scheme also allows multiple devices or channels to be connected in
parallel with excellent current sharing and phase interleaving for high-current
applications.

Fully integrated protection features include over-current protection (OCP),
over-voltage protection (OVP), under-voltage protection (UVP), and
over-temperature protection (OTP).

Device compliant with:

- PMBus rev 1.3 interface.

The driver exports the following attributes via the 'sysfs' files
for input voltage:

**in1_input**

**in1_label**

**in1_max**

**in1_max_alarm**

**in1_min**

**in1_min_alarm**

**in1_crit**

**in1_crit_alarm**

The driver provides the following attributes for output voltage:

**in2_input**

**in2_label**

**in2_alarm**

The driver provides the following attributes for output current:

**curr1_input**

**curr1_label**

**curr1_max**

**curr1_max_alarm**

**curr1_crit**

**curr1_crit_alarm**

The driver provides the following attributes for temperature:

**temp1_input**

**temp1_max**

**temp1_max_alarm**

**temp1_crit**

**temp1_crit_alarm**