xref: /linux/Documentation/hwmon/isl28022.rst (revision e814f3fd16acfb7f9966773953de8f740a1e3202)
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/renesas,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)
51in1_input		shunt voltage (milli Volt)
52
53curr1_input		current (milli Ampere)
54power1_input		power (micro Watt)
55======================= =======================================================
56
57Debugfs entries
58---------------
59
60The following attributes are supported. All attributes are read-only.
61
62======================= =======================================================
63shunt_voltage		shunt voltage (micro Volt)
64======================= =======================================================
65