1 Kernel driver max34440 2 ====================== 3 4 Supported chips: 5 6 * Maxim MAX34440 7 8 Prefixes: 'max34440' 9 10 Addresses scanned: - 11 12 Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX34440.pdf 13 14 * Maxim MAX34441 15 16 PMBus 5-Channel Power-Supply Manager and Intelligent Fan Controller 17 18 Prefixes: 'max34441' 19 20 Addresses scanned: - 21 22 Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX34441.pdf 23 24 * Maxim MAX34446 25 26 PMBus Power-Supply Data Logger 27 28 Prefixes: 'max34446' 29 30 Addresses scanned: - 31 32 Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX34446.pdf 33 34 * Maxim MAX34451 35 36 PMBus 16-Channel V/I Monitor and 12-Channel Sequencer/Marginer 37 38 Prefixes: 'max34451' 39 40 Addresses scanned: - 41 42 Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX34451.pdf 43 44 * Maxim MAX34460 45 46 PMBus 12-Channel Voltage Monitor & Sequencer 47 48 Prefix: 'max34460' 49 50 Addresses scanned: - 51 52 Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX34460.pdf 53 54 * Maxim MAX34461 55 56 PMBus 16-Channel Voltage Monitor & Sequencer 57 58 Prefix: 'max34461' 59 60 Addresses scanned: - 61 62 Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX34461.pdf 63 64 Author: Guenter Roeck <linux@roeck-us.net> 65 66 67 Description 68 ----------- 69 70 This driver supports hardware monitoring for Maxim MAX34440 PMBus 6-Channel 71 Power-Supply Manager, MAX34441 PMBus 5-Channel Power-Supply Manager 72 and Intelligent Fan Controller, and MAX34446 PMBus Power-Supply Data Logger. 73 It also supports the MAX34451, MAX34460, and MAX34461 PMBus Voltage Monitor & 74 Sequencers. The MAX34451 supports monitoring voltage or current of 12 channels 75 based on GIN pins. The MAX34460 supports 12 voltage channels, and the MAX34461 76 supports 16 voltage channels. 77 78 The driver is a client driver to the core PMBus driver. Please see 79 Documentation/hwmon/pmbus.rst for details on PMBus client drivers. 80 81 82 Usage Notes 83 ----------- 84 85 This driver does not auto-detect devices. You will have to instantiate the 86 devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for 87 details. 88 89 For MAX34446, the value of the currX_crit attribute determines if current or 90 voltage measurement is enabled for a given channel. Voltage measurement is 91 enabled if currX_crit is set to 0; current measurement is enabled if the 92 attribute is set to a positive value. Power measurement is only enabled if 93 channel 1 (3) is configured for voltage measurement, and channel 2 (4) is 94 configured for current measurement. 95 96 97 Platform data support 98 --------------------- 99 100 The driver supports standard PMBus driver platform data. 101 102 103 Sysfs entries 104 ------------- 105 106 The following attributes are supported. Limits are read-write; all other 107 attributes are read-only. 108 109 In 110 ~~ 111 112 ======================= ======================================================= 113 in[1-6]_label "vout[1-6]". 114 in[1-6]_input Measured voltage. From READ_VOUT register. 115 in[1-6]_min Minimum Voltage. From VOUT_UV_WARN_LIMIT register. 116 in[1-6]_max Maximum voltage. From VOUT_OV_WARN_LIMIT register. 117 in[1-6]_lcrit Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register. 118 in[1-6]_crit Critical maximum voltage. From VOUT_OV_FAULT_LIMIT 119 register. 120 in[1-6]_min_alarm Voltage low alarm. From VOLTAGE_UV_WARNING status. 121 in[1-6]_max_alarm Voltage high alarm. From VOLTAGE_OV_WARNING status. 122 in[1-6]_lcrit_alarm Voltage critical low alarm. From VOLTAGE_UV_FAULT 123 status. 124 in[1-6]_crit_alarm Voltage critical high alarm. From VOLTAGE_OV_FAULT 125 status. 126 in[1-6]_lowest Historical minimum voltage. 127 in[1-6]_highest Historical maximum voltage. 128 in[1-6]_reset_history Write any value to reset history. 129 ======================= ======================================================= 130 131 .. note:: MAX34446 only supports in[1-4]. 132 133 Curr 134 ~~~~ 135 136 ======================= ======================================================== 137 curr[1-6]_label "iout[1-6]". 138 curr[1-6]_input Measured current. From READ_IOUT register. 139 curr[1-6]_max Maximum current. From IOUT_OC_WARN_LIMIT register. 140 curr[1-6]_crit Critical maximum current. From IOUT_OC_FAULT_LIMIT 141 register. 142 curr[1-6]_max_alarm Current high alarm. From IOUT_OC_WARNING status. 143 curr[1-6]_crit_alarm Current critical high alarm. From IOUT_OC_FAULT status. 144 curr[1-4]_average Historical average current (MAX34446/34451 only). 145 curr[1-6]_highest Historical maximum current. 146 curr[1-6]_reset_history Write any value to reset history. 147 ======================= ======================================================== 148 149 .. note:: 150 151 - in6 and curr6 attributes only exist for MAX34440. 152 - MAX34446 only supports curr[1-4]. 153 154 Power 155 ~~~~~ 156 157 ======================= ======================================================== 158 power[1,3]_label "pout[1,3]" 159 power[1,3]_input Measured power. 160 power[1,3]_average Historical average power. 161 power[1,3]_highest Historical maximum power. 162 ======================= ======================================================== 163 164 .. note:: Power attributes only exist for MAX34446. 165 166 Temp 167 ~~~~ 168 169 ======================= ======================================================== 170 temp[1-8]_input Measured temperatures. From READ_TEMPERATURE_1 register. 171 temp1 is the chip's internal temperature. temp2..temp5 172 are remote I2C temperature sensors. For MAX34441, temp6 173 is a remote thermal-diode sensor. For MAX34440, temp6..8 174 are remote I2C temperature sensors. 175 temp[1-8]_max Maximum temperature. From OT_WARN_LIMIT register. 176 temp[1-8]_crit Critical high temperature. From OT_FAULT_LIMIT register. 177 temp[1-8]_max_alarm Temperature high alarm. 178 temp[1-8]_crit_alarm Temperature critical high alarm. 179 temp[1-8]_average Historical average temperature (MAX34446 only). 180 temp[1-8]_highest Historical maximum temperature. 181 temp[1-8]_reset_history Write any value to reset history. 182 ======================= ======================================================== 183 184 185 .. note:: 186 - temp7 and temp8 attributes only exist for MAX34440. 187 - MAX34446 only supports temp[1-3]. 188 189 190 .. note:: 191 192 - MAX34451 supports attribute groups in[1-16] (or curr[1-16] based on 193 input pins) and temp[1-5]. 194 - MAX34460 supports attribute groups in[1-12] and temp[1-5]. 195 - MAX34461 supports attribute groups in[1-16] and temp[1-5].
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.