| .. SPDX-License-Identifier: GPL-2.0-only | |
| Kernel driver ina238 | |
| ==================== | |
| Supported chips: | |
| * Texas Instruments INA228 | |
| Prefix: 'ina228' | |
| Addresses: I2C 0x40 - 0x4f | |
| Datasheet: | |
| https://www.ti.com/lit/gpn/ina228 | |
| * Texas Instruments INA237 | |
| Prefix: 'ina237' | |
| Addresses: I2C 0x40 - 0x4f | |
| Datasheet: | |
| https://www.ti.com/lit/gpn/ina237 | |
| * Texas Instruments INA238 | |
| Prefix: 'ina238' | |
| Addresses: I2C 0x40 - 0x4f | |
| Datasheet: | |
| https://www.ti.com/lit/gpn/ina238 | |
| * Texas Instruments INA700 | |
| Datasheet: | |
| https://www.ti.com/product/ina700 | |
| * Texas Instruments INA780 | |
| Datasheet: | |
| https://www.ti.com/product/ina780a | |
| * Silergy SQ52206 | |
| Prefix: 'SQ52206' | |
| Addresses: I2C 0x40 - 0x4f | |
| Author: Nathan Rossi <nathan.rossi@digi.com> | |
| Description | |
| ----------- | |
| The INA238 is a current shunt, power and temperature monitor with an I2C | |
| interface. It includes a number of programmable functions including alerts, | |
| conversion rate, sample averaging and selectable shunt voltage accuracy. | |
| The shunt value in micro-ohms can be set via device properties, either from | |
| platform code or from device tree data. Please refer to | |
| Documentation/devicetree/bindings/hwmon/ti,ina2xx.yaml for bindings if | |
| device tree is used. | |
| INA237 is a functionally equivalent variant of INA238 with slightly | |
| different accuracy. INA228 is another variant of INA238 with higher ADC | |
| resolution. This chip also reports the energy. | |
| INA700 and INA780 are variants of the chip series with built-in shunt resistor. | |
| They also report the energy. | |
| SQ52206 is a mostly compatible chip from Sylergy. It reports the energy | |
| as well as the peak power consumption. | |
| Sysfs entries | |
| ------------- | |
| ======================= ======================================================= | |
| in0_input Shunt voltage (mV) | |
| in0_min Minimum shunt voltage threshold (mV) | |
| in0_min_alarm Minimum shunt voltage alarm | |
| in0_max Maximum shunt voltage threshold (mV) | |
| in0_max_alarm Maximum shunt voltage alarm | |
| in1_input Bus voltage (mV) | |
| in1_min Minimum bus voltage threshold (mV) | |
| in1_min_alarm Minimum shunt voltage alarm | |
| in1_max Maximum bus voltage threshold (mV) | |
| in1_max_alarm Maximum shunt voltage alarm | |
| power1_input Power measurement (uW) | |
| power1_max Maximum power threshold (uW) | |
| power1_max_alarm Maximum power alarm | |
| power1_input_highest Peak Power (uW) | |
| (SQ52206 only) | |
| curr1_input Current measurement (mA) | |
| curr1_min Minimum current threshold (mA) | |
| curr1_min_alarm Minimum current alarm | |
| curr1_max Maximum current threshold (mA) | |
| curr1_max_alarm Maximum current alarm | |
| energy1_input Energy measurement (uJ) | |
| (SQ52206, INA237, and INA780 only) | |
| temp1_input Die temperature measurement (mC) | |
| temp1_max Maximum die temperature threshold (mC) | |
| temp1_max_alarm Maximum die temperature alarm | |
| samples ADC averaging count (1, 4, 16, 64, 128, 256, 512, 1024) | |
| update_interval Total ADC conversion cycle time including averaging (ms) | |
| update_interval_us Total ADC conversion cycle time including averaging (us) | |
| ======================= ======================================================= |