xref: /linux/Documentation/hwmon/isl28022.rst (revision 7f71507851fc7764b36a3221839607d3a45c2025)
1.. SPDX-License-Identifier: GPL-2.0-or-later
2
3Kernel driver isl28022
4======================
5
6Supported chips:
7
8  * Renesas ISL28022
9
10    Prefix: 'isl28022'
11
12    Addresses scanned: none
13
14    Datasheet: Publicly available at the Renesas website
15
16	       https://www.renesas.com/us/en/www/doc/datasheet/isl28022.pdf
17
18Author:
19    Carsten Spieß <mail@carsten-spiess.de>
20
21Description
22-----------
23
24The ISL28022 is a power monitor with I2C interface. The device monitors
25voltage, current via shunt resistor and calculated power.
26
27Usage Notes
28-----------
29
30This driver does not auto-detect devices. You will have to instantiate the
31device explicitly. Please see Documentation/i2c/instantiating-devices.rst for
32details.
33
34The shunt value in micro-ohms, shunt voltage range and averaging can be set
35with device properties.
36Please refer to the Documentation/devicetree/bindings/hwmon/isl,isl28022.yaml
37for bindings if the device tree is used.
38
39The driver supports only shunt and bus continuous ADC mode at 15bit resolution.
40Averaging can be set from 1 to 128 samples (power of 2) on both channels.
41Shunt voltage range of 40, 80, 160 or 320mV is allowed
42The bus voltage range is 60V fixed.
43
44Sysfs entries
45-------------
46
47The following attributes are supported. All attributes are read-only.
48
49======================= =======================================================
50in0_input		bus voltage (milli Volt)
51
52curr1_input		current (milli Ampere)
53power1_input		power (micro Watt)
54======================= =======================================================
55
56Debugfs entries
57---------------
58
59The following attributes are supported. All attributes are read-only.
60
61======================= =======================================================
62shunt_voltage		shunt voltage (micro Volt)
63======================= =======================================================
64