Documentation/hwmon/ltc2978

   1 Kernel driver ltc2978
   2 =====================
   3
   4 Supported chips:
   5   * Linear Technology LTC2974
   6     Prefix: 'ltc2974'
   7     Addresses scanned: -
   8     Datasheet: http://www.linear.com/product/ltc2974
   9   * Linear Technology LTC2977
  10     Prefix: 'ltc2977'
  11     Addresses scanned: -
  12     Datasheet: http://www.linear.com/product/ltc2977
  13   * Linear Technology LTC2978
  14     Prefix: 'ltc2978'
  15     Addresses scanned: -
  16     Datasheet: http://www.linear.com/product/ltc2978
  17   * Linear Technology LTC3880
  18     Prefix: 'ltc3880'
  19     Addresses scanned: -
  20     Datasheet: http://www.linear.com/product/ltc3880
  21   * Linear Technology LTC3883
  22     Prefix: 'ltc3883'
  23     Addresses scanned: -
  24     Datasheet: http://www.linear.com/product/ltc3883
  25
  26 Author: Guenter Roeck <linux@roeck-us.net>
  27
  28
  29 Description
  30 -----------
  31
  32 LTC2974 is a quad digital power supply manager. LTC2978 is an octal power supply
  33 monitor. LTC2977 is a pin compatible replacement for LTC2978. LTC3880 is a dual
  34 output poly-phase step-down DC/DC controller. LTC3883 is a single phase
  35 step-down DC/DC controller.
  36
  37
  38 Usage Notes
  39 -----------
  40
  41 This driver does not probe for PMBus devices. You will have to instantiate
  42 devices explicitly.
  43
  44 Example: the following commands will load the driver for an LTC2978 at address
  45 0x60 on I2C bus #1:
  46
  47 # modprobe ltc2978
  48 # echo ltc2978 0x60 > /sys/bus/i2c/devices/i2c-1/new_device
  49
  50
  51 Sysfs attributes
  52 ----------------
  53
  54 in1_label               "vin"
  55 in1_input               Measured input voltage.
  56 in1_min                 Minimum input voltage.
  57 in1_max                 Maximum input voltage.
  58                         LTC2974, LTC2977, and LTC2978 only.
  59 in1_lcrit               Critical minimum input voltage.
  60                         LTC2974, LTC2977, and LTC2978 only.
  61 in1_crit                Critical maximum input voltage.
  62 in1_min_alarm           Input voltage low alarm.
  63 in1_max_alarm           Input voltage high alarm.
  64                         LTC2974, LTC2977, and LTC2978 only.
  65 in1_lcrit_alarm         Input voltage critical low alarm.
  66                         LTC2974, LTC2977, and LTC2978 only.
  67 in1_crit_alarm          Input voltage critical high alarm.
  68 in1_lowest              Lowest input voltage.
  69                         LTC2974, LTC2977, and LTC2978 only.
  70 in1_highest             Highest input voltage.
  71 in1_reset_history       Reset input voltage history.
  72
  73 in[N]_label             "vout[1-8]".
  74                         LTC2974: N=2-5
  75                         LTC2977: N=2-9
  76                         LTC2978: N=2-9
  77                         LTC3880: N=2-3
  78                         LTC3883: N=2
  79 in[N]_input             Measured output voltage.
  80 in[N]_min               Minimum output voltage.
  81 in[N]_max               Maximum output voltage.
  82 in[N]_lcrit             Critical minimum output voltage.
  83 in[N]_crit              Critical maximum output voltage.
  84 in[N]_min_alarm         Output voltage low alarm.
  85 in[N]_max_alarm         Output voltage high alarm.
  86 in[N]_lcrit_alarm       Output voltage critical low alarm.
  87 in[N]_crit_alarm        Output voltage critical high alarm.
  88 in[N]_lowest            Lowest output voltage. LTC2974 and LTC2978 only.
  89 in[N]_highest           Highest output voltage.
  90 in[N]_reset_history     Reset output voltage history.
  91
  92 temp[N]_input           Measured temperature.
  93                         On LTC2974, temp[1-4] report external temperatures,
  94                         and temp5 reports the chip temperature.
  95                         On LTC2977 and LTC2978, only one temperature measurement
  96                         is supported and reports the chip temperature.
  97                         On LTC3880, temp1 and temp2 report external
  98                         temperatures, and temp3 reports the chip temperature.
  99                         On LTC3883, temp1 reports an external temperature,
 100                         and temp2 reports the chip temperature.
 101 temp[N]_min             Mimimum temperature. LTC2974, LCT2977, and LTC2978 only.
 102 temp[N]_max             Maximum temperature.
 103 temp[N]_lcrit           Critical low temperature.
 104 temp[N]_crit            Critical high temperature.
 105 temp[N]_min_alarm       Temperature low alarm.
 106                         LTC2974, LTC2977, and LTC2978 only.
 107 temp[N]_max_alarm       Temperature high alarm.
 108 temp[N]_lcrit_alarm     Temperature critical low alarm.
 109 temp[N]_crit_alarm      Temperature critical high alarm.
 110 temp[N]_lowest          Lowest measured temperature.
 111                         LTC2974, LTC2977, and LTC2978 only.
 112                         Not supported for chip temperature sensor on LTC2974.
 113 temp[N]_highest         Highest measured temperature. Not supported for chip
 114                         temperature sensor on LTC2974.
 115 temp[N]_reset_history   Reset temperature history. Not supported for chip
 116                         temperature sensor on LTC2974.
 117
 118 power1_label            "pin". LTC3883 only.
 119 power1_input            Measured input power.
 120
 121 power[N]_label          "pout[1-4]".
 122                         LTC2974: N=1-4
 123                         LTC2977: Not supported
 124                         LTC2978: Not supported
 125                         LTC3880: N=1-2
 126                         LTC3883: N=2
 127 power[N]_input          Measured output power.
 128
 129 curr1_label             "iin". LTC3880 and LTC3883 only.
 130 curr1_input             Measured input current.
 131 curr1_max               Maximum input current.
 132 curr1_max_alarm         Input current high alarm.
 133 curr1_highest           Highest input current. LTC3883 only.
 134 curr1_reset_history     Reset input current history. LTC3883 only.
 135
 136 curr[N]_label           "iout[1-4]".
 137                         LTC2974: N=1-4
 138                         LTC2977: not supported
 139                         LTC2978: not supported
 140                         LTC3880: N=2-3
 141                         LTC3883: N=2
 142 curr[N]_input           Measured output current.
 143 curr[N]_max             Maximum output current.
 144 curr[N]_crit            Critical high output current.
 145 curr[N]_lcrit           Critical low output current. LTC2974 only.
 146 curr[N]_max_alarm       Output current high alarm.
 147 curr[N]_crit_alarm      Output current critical high alarm.
 148 curr[N]_lcrit_alarm     Output current critical low alarm. LTC2974 only.
 149 curr[N]_lowest          Lowest output current. LTC2974 only.
 150 curr[N]_highest         Highest output current.
 151 curr[N]_reset_history   Reset output current history.