Documentation/hwmon/adm1275

   1 Kernel driver adm1275
   2 =====================
   3
   4 Supported chips:
   5   * Analog Devices ADM1075
   6     Prefix: 'adm1075'
   7     Addresses scanned: -
   8     Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1075.pdf
   9   * Analog Devices ADM1272
  10     Prefix: 'adm1272'
  11     Addresses scanned: -
  12     Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1272.pdf
  13   * Analog Devices ADM1275
  14     Prefix: 'adm1275'
  15     Addresses scanned: -
  16     Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1275.pdf
  17   * Analog Devices ADM1276
  18     Prefix: 'adm1276'
  19     Addresses scanned: -
  20     Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1276.pdf
  21   * Analog Devices ADM1278
  22     Prefix: 'adm1278'
  23     Addresses scanned: -
  24     Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1278.pdf
  25   * Analog Devices ADM1293/ADM1294
  26     Prefix: 'adm1293', 'adm1294'
  27     Addresses scanned: -
  28     Datasheet: http://www.analog.com/media/en/technical-documentation/data-sheets/ADM1293_1294.pdf
  29
  30 Author: Guenter Roeck <linux@roeck-us.net>
  31
  32
  33 Description
  34 -----------
  35
  36 This driver supports hardware monitoring for Analog Devices ADM1075, ADM1272,
  37 ADM1275, ADM1276, ADM1278, ADM1293, and ADM1294 Hot-Swap Controller and
  38 Digital Power Monitors.
  39
  40 ADM1075, ADM1272, ADM1275, ADM1276, ADM1278, ADM1293, and ADM1294 are hot-swap
  41 controllers that allow a circuit board to be removed from or inserted into
  42 a live backplane. They also feature current and voltage readback via an
  43 integrated 12 bit analog-to-digital converter (ADC), accessed using a
  44 PMBus interface.
  45
  46 The driver is a client driver to the core PMBus driver. Please see
  47 Documentation/hwmon/pmbus for details on PMBus client drivers.
  48
  49
  50 Usage Notes
  51 -----------
  52
  53 This driver does not auto-detect devices. You will have to instantiate the
  54 devices explicitly. Please see Documentation/i2c/instantiating-devices for
  55 details.
  56
  57 The ADM1075, unlike many other PMBus devices, does not support internal voltage
  58 or current scaling. Reported voltages, currents, and power are raw measurements,
  59 and will typically have to be scaled.
  60
  61 The shunt value in micro-ohms can be set via device tree at compile-time. Please
  62 refer to the Documentation/devicetree/bindings/hwmon/adm1275.txt for bindings
  63 if the device tree is used.
  64
  65 Platform data support
  66 ---------------------
  67
  68 The driver supports standard PMBus driver platform data. Please see
  69 Documentation/hwmon/pmbus for details.
  70
  71
  72 Sysfs entries
  73 -------------
  74
  75 The following attributes are supported. Limits are read-write, history reset
  76 attributes are write-only, all other attributes are read-only.
  77
  78 inX_label               "vin1" or "vout1" depending on chip variant and
  79                         configuration. On ADM1075, ADM1293, and ADM1294,
  80                         vout1 reports the voltage on the VAUX pin.
  81 inX_input               Measured voltage.
  82 inX_min                 Minimum Voltage.
  83 inX_max                 Maximum voltage.
  84 inX_min_alarm           Voltage low alarm.
  85 inX_max_alarm           Voltage high alarm.
  86 inX_highest             Historical maximum voltage.
  87 inX_reset_history       Write any value to reset history.
  88
  89 curr1_label             "iout1"
  90 curr1_input             Measured current.
  91 curr1_max               Maximum current.
  92 curr1_max_alarm         Current high alarm.
  93 curr1_lcrit             Critical minimum current. Depending on the chip
  94                         configuration, either curr1_lcrit or curr1_crit is
  95                         supported, but not both.
  96 curr1_lcrit_alarm       Critical current low alarm.
  97 curr1_crit              Critical maximum current. Depending on the chip
  98                         configuration, either curr1_lcrit or curr1_crit is
  99                         supported, but not both.
 100 curr1_crit_alarm        Critical current high alarm.
 101 curr1_highest           Historical maximum current.
 102 curr1_reset_history     Write any value to reset history.
 103
 104 power1_label            "pin1"
 105 power1_input            Input power.
 106 power1_input_lowest     Lowest observed input power. ADM1293 and ADM1294 only.
 107 power1_input_highest    Highest observed input power.
 108 power1_reset_history    Write any value to reset history.
 109
 110                         Power attributes are supported on ADM1075, ADM1272,
 111                         ADM1276, ADM1293, and ADM1294.
 112
 113 temp1_input             Chip temperature.
 114 temp1_max               Maximum chip temperature.
 115 temp1_max_alarm         Temperature alarm.
 116 temp1_crit              Critical chip temperature.
 117 temp1_crit_alarm        Critical temperature high alarm.
 118 temp1_highest           Highest observed temperature.
 119 temp1_reset_history     Write any value to reset history.
 120
 121                         Temperature attributes are supported on ADM1272 and
 122                         ADM1278.