^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 max16601
^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) * Maxim MAX16601
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) Prefix: 'max16601'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) Addresses scanned: -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) Datasheet: Not published
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) Author: Guenter Roeck <linux@roeck-us.net>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) This driver supports the MAX16601 VR13.HC Dual-Output Voltage Regulator
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) Chipset.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) The driver is a client driver to the core PMBus driver.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) Usage Notes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) This driver does not auto-detect devices. You will have to instantiate the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) details.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) Platform data support
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) ---------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) The driver supports standard PMBus driver platform data.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) Sysfs entries
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) -------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) The following attributes are supported.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) ======================= =======================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) in1_label "vin1"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) in1_input VCORE input voltage.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) in1_alarm Input voltage alarm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) in2_label "vout1"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) in2_input VCORE output voltage.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) in2_alarm Output voltage alarm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) curr1_label "iin1"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) curr1_input VCORE input current, derived from duty cycle and output
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) curr1_max Maximum input current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) curr1_max_alarm Current high alarm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) curr2_label "iin1.0"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) curr2_input VCORE phase 0 input current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) curr3_label "iin1.1"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) curr3_input VCORE phase 1 input current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) curr4_label "iin1.2"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) curr4_input VCORE phase 2 input current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) curr5_label "iin1.3"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) curr5_input VCORE phase 3 input current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) curr6_label "iin1.4"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) curr6_input VCORE phase 4 input current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) curr7_label "iin1.5"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) curr7_input VCORE phase 5 input current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) curr8_label "iin1.6"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) curr8_input VCORE phase 6 input current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) curr9_label "iin1.7"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) curr9_input VCORE phase 7 input current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) curr10_label "iin2"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) curr10_input VCORE input current, derived from sensor element.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) curr11_label "iin3"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) curr11_input VSA input current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) curr12_label "iout1"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) curr12_input VCORE output current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) curr12_crit Critical output current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) curr12_crit_alarm Output current critical alarm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) curr12_max Maximum output current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98) curr12_max_alarm Output current high alarm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) curr13_label "iout1.0"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) curr13_input VCORE phase 0 output current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) curr14_label "iout1.1"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) curr14_input VCORE phase 1 output current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) curr15_label "iout1.2"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) curr15_input VCORE phase 2 output current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) curr16_label "iout1.3"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) curr16_input VCORE phase 3 output current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) curr17_label "iout1.4"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113) curr17_input VCORE phase 4 output current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) curr18_label "iout1.5"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116) curr18_input VCORE phase 5 output current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) curr19_label "iout1.6"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) curr19_input VCORE phase 6 output current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) curr20_label "iout1.7"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) curr20_input VCORE phase 7 output current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) curr21_label "iout3"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125) curr21_input VSA output current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126) curr21_highest Historical maximum VSA output current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127) curr21_reset_history Write any value to reset curr21_highest.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 128) curr21_crit Critical output current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 129) curr21_crit_alarm Output current critical alarm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 130) curr21_max Maximum output current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 131) curr21_max_alarm Output current high alarm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 132)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 133) power1_label "pin1"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 134) power1_input Input power, derived from duty cycle and output current.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 135) power1_alarm Input power alarm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 136)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 137) power2_label "pin2"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 138) power2_input Input power, derived from input current sensor.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 139)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 140) power3_label "pout"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 141) power3_input Output power.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 142)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 143) temp1_input VCORE temperature.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 144) temp1_crit Critical high temperature.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 145) temp1_crit_alarm Chip temperature critical high alarm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 146) temp1_max Maximum temperature.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 147) temp1_max_alarm Chip temperature high alarm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 148)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 149) temp2_input TSENSE_0 temperature
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 150) temp3_input TSENSE_1 temperature
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 151) temp4_input TSENSE_2 temperature
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 152) temp5_input TSENSE_3 temperature
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 153)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 154) temp6_input VSA temperature.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 155) temp6_crit Critical high temperature.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 156) temp6_crit_alarm Chip temperature critical high alarm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 157) temp6_max Maximum temperature.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 158) temp6_max_alarm Chip temperature high alarm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 159) ======================= =======================================================