110 lines
2.8 KiB
ReStructuredText
110 lines
2.8 KiB
ReStructuredText
.. 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
|
|
======================= =======================================================
|