xref: /linux/Documentation/hwmon/ina238.rst (revision 6e9a12f85a7567bb9a41d5230468886bd6a27b20)
1.. SPDX-License-Identifier: GPL-2.0-only
2
3Kernel driver ina238
4====================
5
6Supported chips:
7
8  * Texas Instruments INA238
9
10    Prefix: 'ina238'
11
12    Addresses: I2C 0x40 - 0x4f
13
14    Datasheet:
15	https://www.ti.com/lit/gpn/ina238
16
17  * Silergy SQ52206
18
19    Prefix: 'SQ52206'
20
21    Addresses: I2C 0x40 - 0x4f
22
23Author: Nathan Rossi <nathan.rossi@digi.com>
24
25Description
26-----------
27
28The INA238 is a current shunt, power and temperature monitor with an I2C
29interface. It includes a number of programmable functions including alerts,
30conversion rate, sample averaging and selectable shunt voltage accuracy.
31
32The shunt value in micro-ohms can be set via platform data or device tree at
33compile-time or via the shunt_resistor attribute in sysfs at run-time. Please
34refer to the Documentation/devicetree/bindings/hwmon/ti,ina2xx.yaml for bindings
35if the device tree is used.
36
37Sysfs entries
38-------------
39
40======================= =======================================================
41in0_input		Shunt voltage (mV)
42in0_min			Minimum shunt voltage threshold (mV)
43in0_min_alarm		Minimum shunt voltage alarm
44in0_max			Maximum shunt voltage threshold (mV)
45in0_max_alarm		Maximum shunt voltage alarm
46
47in1_input		Bus voltage (mV)
48in1_min			Minimum bus voltage threshold (mV)
49in1_min_alarm		Minimum shunt voltage alarm
50in1_max			Maximum bus voltage threshold (mV)
51in1_max_alarm		Maximum shunt voltage alarm
52
53power1_input		Power measurement (uW)
54power1_max		Maximum power threshold (uW)
55power1_max_alarm	Maximum power alarm
56
57curr1_input		Current measurement (mA)
58
59temp1_input		Die temperature measurement (mC)
60temp1_max		Maximum die temperature threshold (mC)
61temp1_max_alarm		Maximum die temperature alarm
62======================= =======================================================
63
64Additional sysfs entries for sq52206
65------------------------------------
66
67======================= =======================================================
68energy1_input		Energy measurement (uJ)
69
70power1_input_highest	Peak Power (uW)
71======================= =======================================================
72