2012-05-12 12:36:38 +04:00
Kernel driver ina2xx
====================
Supported chips:
2019-04-17 12:46:27 +03:00
2012-05-12 12:36:38 +04:00
* Texas Instruments INA219
2019-04-17 12:46:27 +03:00
2012-05-12 12:36:38 +04:00
Prefix: 'ina219'
Addresses: I2C 0x40 - 0x4f
2019-04-17 12:46:27 +03:00
2012-05-12 12:36:38 +04:00
Datasheet: Publicly available at the Texas Instruments website
2019-04-17 12:46:27 +03:00
2020-07-19 21:15:30 +03:00
https://www.ti.com/
2012-05-12 12:36:38 +04:00
2012-05-12 22:33:11 +04:00
* Texas Instruments INA220
2019-04-17 12:46:27 +03:00
2012-05-12 22:33:11 +04:00
Prefix: 'ina220'
2019-04-17 12:46:27 +03:00
2012-05-12 22:33:11 +04:00
Addresses: I2C 0x40 - 0x4f
2019-04-17 12:46:27 +03:00
2012-05-12 22:33:11 +04:00
Datasheet: Publicly available at the Texas Instruments website
2019-04-17 12:46:27 +03:00
2020-07-19 21:15:30 +03:00
https://www.ti.com/
2012-05-12 22:33:11 +04:00
2012-05-12 12:36:38 +04:00
* Texas Instruments INA226
2019-04-17 12:46:27 +03:00
2012-05-12 12:36:38 +04:00
Prefix: 'ina226'
2019-04-17 12:46:27 +03:00
2012-05-12 12:36:38 +04:00
Addresses: I2C 0x40 - 0x4f
2019-04-17 12:46:27 +03:00
2012-05-12 12:36:38 +04:00
Datasheet: Publicly available at the Texas Instruments website
2019-04-17 12:46:27 +03:00
2020-07-19 21:15:30 +03:00
https://www.ti.com/
2012-05-12 12:36:38 +04:00
2012-05-12 22:33:11 +04:00
* Texas Instruments INA230
2019-04-17 12:46:27 +03:00
2012-05-12 22:33:11 +04:00
Prefix: 'ina230'
2019-04-17 12:46:27 +03:00
2012-05-12 22:33:11 +04:00
Addresses: I2C 0x40 - 0x4f
2019-04-17 12:46:27 +03:00
2012-05-12 22:33:11 +04:00
Datasheet: Publicly available at the Texas Instruments website
2019-04-17 12:46:27 +03:00
2020-07-19 21:15:30 +03:00
https://www.ti.com/
2012-05-12 22:33:11 +04:00
2015-01-15 04:34:58 +03:00
* Texas Instruments INA231
2019-04-17 12:46:27 +03:00
2015-01-15 04:34:58 +03:00
Prefix: 'ina231'
2019-04-17 12:46:27 +03:00
2015-01-15 04:34:58 +03:00
Addresses: I2C 0x40 - 0x4f
2019-04-17 12:46:27 +03:00
2015-01-15 04:34:58 +03:00
Datasheet: Publicly available at the Texas Instruments website
2019-04-17 12:46:27 +03:00
2020-07-19 21:15:30 +03:00
https://www.ti.com/
2015-01-15 04:34:58 +03:00
2018-08-14 10:09:37 +03:00
Author: Lothar Felten <lothar.felten@gmail.com>
2012-05-12 12:36:38 +04:00
Description
-----------
The INA219 is a high-side current shunt and power monitor with an I2C
interface. The INA219 monitors both shunt drop and supply voltage, with
programmable conversion times and filtering.
2012-05-12 22:33:11 +04:00
The INA220 is a high or low side current shunt and power monitor with an I2C
interface. The INA220 monitors both shunt drop and supply voltage.
2012-05-12 12:36:38 +04:00
The INA226 is a current shunt and power monitor with an I2C interface.
The INA226 monitors both a shunt voltage drop and bus supply voltage.
2015-01-15 04:34:58 +03:00
INA230 and INA231 are high or low side current shunt and power monitors
with an I2C interface. The chips monitor both a shunt voltage drop and
bus supply voltage.
2012-05-12 22:33:11 +04:00
2015-01-05 17:20:55 +03:00
The shunt value in micro-ohms can be set via platform data or device tree at
compile-time or via the shunt_resistor attribute in sysfs at run-time. Please
2021-01-13 13:59:17 +03:00
refer to the Documentation/devicetree/bindings/hwmon/ti,ina2xx.yaml for bindings
2013-06-19 10:50:20 +04:00
if the device tree is used.
2015-01-09 19:03:42 +03:00
Additionally ina226 supports update_interval attribute as described in
2019-04-17 12:46:29 +03:00
Documentation/hwmon/sysfs-interface.rst. Internally the interval is the sum of
2015-01-09 19:03:42 +03:00
bus and shunt voltage conversion times multiplied by the averaging rate. We
don't touch the conversion times and only modify the number of averages. The
lower limit of the update_interval is 2 ms, the upper limit is 2253 ms.
The actual programmed interval may vary from the desired value.
2018-11-19 23:31:16 +03:00
General sysfs entries
2019-04-17 12:46:27 +03:00
---------------------
2018-11-19 23:31:16 +03:00
2019-04-17 12:46:27 +03:00
======================= ===============================
2018-11-19 23:31:16 +03:00
in0_input Shunt voltage(mV) channel
in1_input Bus voltage(mV) channel
curr1_input Current(mA) measurement channel
power1_input Power(uW) measurement channel
shunt_resistor Shunt resistance(uOhm) channel
2019-04-17 12:46:27 +03:00
======================= ===============================
2018-11-19 23:31:16 +03:00
Sysfs entries for ina226, ina230 and ina231 only
2019-04-17 12:46:27 +03:00
------------------------------------------------
2018-11-19 23:31:16 +03:00
2019-04-17 12:46:27 +03:00
======================= ====================================================
2020-05-05 03:59:45 +03:00
in0_lcrit Critical low shunt voltage
in0_crit Critical high shunt voltage
in0_lcrit_alarm Shunt voltage critical low alarm
in0_crit_alarm Shunt voltage critical high alarm
in1_lcrit Critical low bus voltage
in1_crit Critical high bus voltage
in1_lcrit_alarm Bus voltage critical low alarm
in1_crit_alarm Bus voltage critical high alarm
power1_crit Critical high power
power1_crit_alarm Power critical high alarm
2018-11-19 23:31:16 +03:00
update_interval data conversion time; affects number of samples used
to average results for shunt and bus voltages.
2019-04-17 12:46:27 +03:00
======================= ====================================================
2020-05-05 03:59:45 +03:00
.. note ::
- Configure `shunt_resistor` before configure `power1_crit` , because power
value is calculated based on `shunt_resistor` set.
- Because of the underlying register implementation, only one `*crit` setting
and its `alarm` can be active. Writing to one `*crit` setting clears other
`*crit` settings and alarms. Writing 0 to any `*crit` setting clears all
`*crit` settings and alarms.