Documentation/hwmon/ina3221.rst

   1 Kernel driver ina3221
   2 =====================
   3
   4 Supported chips:
   5
   6   * Texas Instruments INA3221
   7
   8     Prefix: 'ina3221'
   9
  10     Addresses: I2C 0x40 - 0x43
  11
  12     Datasheet: Publicly available at the Texas Instruments website
  13
  14                http://www.ti.com/
  15
  16 Author: Andrew F. Davis <afd@ti.com>
  17
  18 Description
  19 -----------
  20
  21 The Texas Instruments INA3221 monitors voltage, current, and power on the high
  22 side of up to three D.C. power supplies. The INA3221 monitors both shunt drop
  23 and supply voltage, with programmable conversion times and averaging, current
  24 and power are calculated host-side from these.
  25
  26 Sysfs entries
  27 -------------
  28
  29 ======================= =======================================================
  30 in[123]_label           Voltage channel labels
  31 in[123]_enable          Voltage channel enable controls
  32 in[123]_input           Bus voltage(mV) channels
  33 curr[123]_input         Current(mA) measurement channels
  34 shunt[123]_resistor     Shunt resistance(uOhm) channels
  35 curr[123]_crit          Critical alert current(mA) setting, activates the
  36                         corresponding alarm when the respective current
  37                         is above this value
  38 curr[123]_crit_alarm    Critical alert current limit exceeded
  39 curr[123]_max           Warning alert current(mA) setting, activates the
  40                         corresponding alarm when the respective current
  41                         average is above this value.
  42 curr[123]_max_alarm     Warning alert current limit exceeded
  43 in[456]_input           Shunt voltage(uV) for channels 1, 2, and 3 respectively
  44 samples                 Number of samples using in the averaging mode.
  45
  46                         Supports the list of number of samples:
  47
  48                           1, 4, 16, 64, 128, 256, 512, 1024
  49
  50 update_interval         Data conversion time in millisecond, following:
  51
  52                           update_interval = C x S x (BC + SC)
  53
  54                           * C:  number of enabled channels
  55                           * S:  number of samples
  56                           * BC: bus-voltage conversion time in millisecond
  57                           * SC: shunt-voltage conversion time in millisecond
  58
  59                         Affects both Bus- and Shunt-voltage conversion time.
  60                         Note that setting update_interval to 0ms sets both BC
  61                         and SC to 140 us (minimum conversion time).
  62 ======================= =======================================================