Documentation/hwmon/max34440.rst

   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].