0001 Kernel driver ina3221
0002 =====================
0003
0004 Supported chips:
0005
0006 * Texas Instruments INA3221
0007
0008 Prefix: 'ina3221'
0009
0010 Addresses: I2C 0x40 - 0x43
0011
0012 Datasheet: Publicly available at the Texas Instruments website
0013
0014 https://www.ti.com/
0015
0016 Author: Andrew F. Davis <afd@ti.com>
0017
0018 Description
0019 -----------
0020
0021 The Texas Instruments INA3221 monitors voltage, current, and power on the high
0022 side of up to three D.C. power supplies. The INA3221 monitors both shunt drop
0023 and supply voltage, with programmable conversion times and averaging, current
0024 and power are calculated host-side from these.
0025
0026 Sysfs entries
0027 -------------
0028
0029 ======================= =======================================================
0030 in[123]_label Voltage channel labels
0031 in[123]_enable Voltage channel enable controls
0032 in[123]_input Bus voltage(mV) channels
0033 curr[123]_input Current(mA) measurement channels
0034 shunt[123]_resistor Shunt resistance(uOhm) channels
0035 curr[123]_crit Critical alert current(mA) setting, activates the
0036 corresponding alarm when the respective current
0037 is above this value
0038 curr[123]_crit_alarm Critical alert current limit exceeded
0039 curr[123]_max Warning alert current(mA) setting, activates the
0040 corresponding alarm when the respective current
0041 average is above this value.
0042 curr[123]_max_alarm Warning alert current limit exceeded
0043 in[456]_input Shunt voltage(uV) for channels 1, 2, and 3 respectively
0044 in7_input Sum of shunt voltage(uV) channels
0045 in7_label Channel label for sum of shunt voltage
0046 curr4_input Sum of current(mA) measurement channels,
0047 (only available when all channels use the same resistor
0048 value for their shunt resistors)
0049 curr4_crit Critical alert current(mA) setting for sum of current
0050 measurements, activates the corresponding alarm
0051 when the respective current is above this value
0052 (only effective when all channels use the same resistor
0053 value for their shunt resistors)
0054 curr4_crit_alarm Critical alert current limit exceeded for sum of
0055 current measurements.
0056 samples Number of samples using in the averaging mode.
0057
0058 Supports the list of number of samples:
0059
0060 1, 4, 16, 64, 128, 256, 512, 1024
0061
0062 update_interval Data conversion time in millisecond, following:
0063
0064 update_interval = C x S x (BC + SC)
0065
0066 * C: number of enabled channels
0067 * S: number of samples
0068 * BC: bus-voltage conversion time in millisecond
0069 * SC: shunt-voltage conversion time in millisecond
0070
0071 Affects both Bus- and Shunt-voltage conversion time.
0072 Note that setting update_interval to 0ms sets both BC
0073 and SC to 140 us (minimum conversion time).
0074 ======================= =======================================================
