0001 .. SPDX-License-Identifier: GPL-2.0
0002
0003 Kernel driver mp2888
0004 ====================
0005
0006 Supported chips:
0007
0008 * MPS MP12254
0009
0010 Prefix: 'mp2888'
0011
0012 Author:
0013
0014 Vadim Pasternak <vadimp@nvidia.com>
0015
0016 Description
0017 -----------
0018
0019 This driver implements support for Monolithic Power Systems, Inc. (MPS)
0020 vendor dual-loop, digital, multi-phase controller MP2888.
0021
0022 This device: supports:
0023
0024 - One power rail.
0025 - Programmable Multi-Phase up to 10 Phases.
0026 - PWM-VID Interface
0027 - One pages 0 for telemetry.
0028 - Programmable pins for PMBus Address.
0029 - Built-In EEPROM to Store Custom Configurations.
0030
0031 Device complaint with:
0032
0033 - PMBus rev 1.3 interface.
0034
0035 Device supports direct format for reading output current, output voltage,
0036 input and output power and temperature.
0037 Device supports linear format for reading input voltage and input power.
0038
0039 The driver provides the next attributes for the current:
0040
0041 - for current out input and maximum alarm;
0042 - for phase current: input and label.
0043
0044 The driver exports the following attributes via the 'sysfs' files, where:
0045
0046 - 'n' is number of configured phases (from 1 to 10);
0047 - index 1 for "iout";
0048 - indexes 2 ... 1 + n for phases.
0049
0050 **curr[1-{1+n}]_input**
0051
0052 **curr[1-{1+n}]_label**
0053
0054 **curr1_max**
0055
0056 **curr1_max_alarm**
0057
0058 The driver provides the next attributes for the voltage:
0059
0060 - for voltage in: input, low and high critical thresholds, low and high
0061 critical alarms;
0062 - for voltage out: input and high alarm;
0063
0064 The driver exports the following attributes via the 'sysfs' files, where
0065
0066 **in1_crit**
0067
0068 **in1_crit_alarm**
0069
0070 **in1_input**
0071
0072 **in1_label**
0073
0074 **in1_min**
0075
0076 **in1_min_alarm**
0077
0078 **in2_alarm**
0079
0080 **in2_input**
0081
0082 **in2_label**
0083
0084 The driver provides the next attributes for the power:
0085
0086 - for power in alarm and input.
0087 - for power out: cap, cap alarm an input.
0088
0089 The driver exports the following attributes via the 'sysfs' files, where
0090 - indexes 1 for "pin";
0091 - indexes 2 for "pout";
0092
0093 **power1_alarm**
0094
0095 **power1_input**
0096
0097 **power1_label**
0098
0099 **power2_input**
0100
0101 **power2_label**
0102
0103 **power2_max**
0104
0105 **power2_max_alarm**
0106
0107 The driver provides the next attributes for the temperature:
0108
0109 **temp1_input**
0110
0111 **temp1_max**
0112
0113 **temp1_max_alarm**
