projects / linux-block.git / blame
| Commit | Line | Data |
|---|---|---|
| 7cb6dcff AD |
1 | Kernel driver ina3221 |
| 2 | ===================== | |
| 3 | ||
| 4 | Supported chips: | |
| b04f2f7d | 5 | |
| 7cb6dcff | 6 | * Texas Instruments INA3221 |
| b04f2f7d | 7 | |
| 7cb6dcff | 8 | Prefix: 'ina3221' |
| b04f2f7d | 9 | |
| 7cb6dcff | 10 | Addresses: I2C 0x40 - 0x43 |
| b04f2f7d | 11 | |
| 7cb6dcff | 12 | Datasheet: Publicly available at the Texas Instruments website |
| b04f2f7d | 13 | |
| ad736c1a | 14 | https://www.ti.com/ |
| 7cb6dcff AD |
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 | ||
| b04f2f7d | 29 | ======================= ======================================================= |
| a9e9dd9c NC |
30 | in[123]_label Voltage channel labels |
| 31 | in[123]_enable Voltage channel enable controls | |
| 7cb6dcff AD |
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 | |
| b04f2f7d MCC |
36 | corresponding alarm when the respective current |
| 37 | is above this value | |
| 7cb6dcff AD |
38 | curr[123]_crit_alarm Critical alert current limit exceeded |
| 39 | curr[123]_max Warning alert current(mA) setting, activates the | |
| b04f2f7d MCC |
40 | corresponding alarm when the respective current |
| 41 | average is above this value. | |
| 7cb6dcff AD |
42 | curr[123]_max_alarm Warning alert current limit exceeded |
| 43 | in[456]_input Shunt voltage(uV) for channels 1, 2, and 3 respectively | |
| 2057bdfb NC |
44 | in7_input Sum of shunt voltage(uV) channels |
| 45 | in7_label Channel label for sum of shunt voltage | |
| 46 | curr4_input Sum of current(mA) measurement channels, | |
| 47 | (only available when all channels use the same resistor | |
| 48 | value for their shunt resistors) | |
| 49 | curr4_crit Critical alert current(mA) setting for sum of current | |
| 50 | measurements, activates the corresponding alarm | |
| 51 | when the respective current is above this value | |
| 52 | (only effective when all channels use the same resistor | |
| 53 | value for their shunt resistors) | |
| 54 | curr4_crit_alarm Critical alert current limit exceeded for sum of | |
| 55 | current measurements. | |
| 5c090abf | 56 | samples Number of samples using in the averaging mode. |
| b04f2f7d MCC |
57 | |
| 58 | Supports the list of number of samples: | |
| 59 | ||
| 5c090abf | 60 | 1, 4, 16, 64, 128, 256, 512, 1024 |
| 023912db NC |
61 | |
| 62 | update_interval Data conversion time in millisecond, following: | |
| 63 | ||
| 64 | update_interval = C x S x (BC + SC) | |
| 65 | ||
| 66 | * C: number of enabled channels | |
| 67 | * S: number of samples | |
| 68 | * BC: bus-voltage conversion time in millisecond | |
| 69 | * SC: shunt-voltage conversion time in millisecond | |
| 70 | ||
| 71 | Affects both Bus- and Shunt-voltage conversion time. | |
| 72 | Note that setting update_interval to 0ms sets both BC | |
| 73 | and SC to 140 us (minimum conversion time). | |
| b04f2f7d | 74 | ======================= ======================================================= |