0001 .. SPDX-License-Identifier: GPL-2.0
0002
0003 Kernel driver max16601
0004 ======================
0005
0006 Supported chips:
0007
0008 * Maxim MAX16508
0009
0010 Prefix: 'max16508'
0011
0012 Addresses scanned: -
0013
0014 Datasheet: Not published
0015
0016 * Maxim MAX16601
0017
0018 Prefix: 'max16601'
0019
0020 Addresses scanned: -
0021
0022 Datasheet: Not published
0023
0024 * Maxim MAX16602
0025
0026 Prefix: 'max16602'
0027
0028 Addresses scanned: -
0029
0030 Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX16602.pdf
0031
0032 Author: Guenter Roeck <linux@roeck-us.net>
0033
0034
0035 Description
0036 -----------
0037
0038 This driver supports the MAX16508 VR13 Dual-Output Voltage Regulator
0039 as well as the MAX16601 VR13.HC Dual-Output Voltage Regulator chipsets.
0040
0041 The driver is a client driver to the core PMBus driver.
0042 Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
0043
0044
0045 Usage Notes
0046 -----------
0047
0048 This driver does not auto-detect devices. You will have to instantiate the
0049 devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
0050 details.
0051
0052
0053 Platform data support
0054 ---------------------
0055
0056 The driver supports standard PMBus driver platform data.
0057
0058
0059 Sysfs entries
0060 -------------
0061
0062 The following attributes are supported.
0063
0064 =============================== ===============================================
0065 in1_label "vin1"
0066 in1_input VCORE input voltage.
0067 in1_alarm Input voltage alarm.
0068
0069 in2_label "vout1"
0070 in2_input VCORE output voltage.
0071 in2_alarm Output voltage alarm.
0072
0073 curr1_label "iin1"
0074 curr1_input VCORE input current, derived from duty cycle
0075 and output current.
0076 curr1_max Maximum input current.
0077 curr1_max_alarm Current high alarm.
0078
0079 curr[P+2]_label "iin1.P"
0080 curr[P+2]_input VCORE phase P input current.
0081
0082 curr[N+2]_label "iin2"
0083 curr[N+2]_input VCORE input current, derived from sensor
0084 element.
0085 'N' is the number of enabled/populated phases.
0086
0087 curr[N+3]_label "iin3"
0088 curr[N+3]_input VSA input current.
0089
0090 curr[N+4]_label "iout1"
0091 curr[N+4]_input VCORE output current.
0092 curr[N+4]_crit Critical output current.
0093 curr[N+4]_crit_alarm Output current critical alarm.
0094 curr[N+4]_max Maximum output current.
0095 curr[N+4]_max_alarm Output current high alarm.
0096
0097 curr[N+P+5]_label "iout1.P"
0098 curr[N+P+5]_input VCORE phase P output current.
0099
0100 curr[2*N+5]_label "iout3"
0101 curr[2*N+5]_input VSA output current.
0102 curr[2*N+5]_highest Historical maximum VSA output current.
0103 curr[2*N+5]_reset_history Write any value to reset curr21_highest.
0104 curr[2*N+5]_crit Critical output current.
0105 curr[2*N+5]_crit_alarm Output current critical alarm.
0106 curr[2*N+5]_max Maximum output current.
0107 curr[2*N+5]_max_alarm Output current high alarm.
0108
0109 power1_label "pin1"
0110 power1_input Input power, derived from duty cycle and output
0111 current.
0112 power1_alarm Input power alarm.
0113
0114 power2_label "pin2"
0115 power2_input Input power, derived from input current sensor.
0116
0117 power3_label "pout"
0118 power3_input Output power.
0119
0120 temp1_input VCORE temperature.
0121 temp1_crit Critical high temperature.
0122 temp1_crit_alarm Chip temperature critical high alarm.
0123 temp1_max Maximum temperature.
0124 temp1_max_alarm Chip temperature high alarm.
0125
0126 temp2_input TSENSE_0 temperature
0127 temp3_input TSENSE_1 temperature
0128 temp4_input TSENSE_2 temperature
0129 temp5_input TSENSE_3 temperature
0130
0131 temp6_input VSA temperature.
0132 temp6_crit Critical high temperature.
0133 temp6_crit_alarm Chip temperature critical high alarm.
0134 temp6_max Maximum temperature.
0135 temp6_max_alarm Chip temperature high alarm.
0136 =============================== ===============================================