xref: /linux/Documentation/hwmon/isl28022.rst (revision 1260ed77798502de9c98020040d2995008de10cc)
139671a14SYikai Tsai.. SPDX-License-Identifier: GPL-2.0-or-later
239671a14SYikai Tsai
339671a14SYikai TsaiKernel driver isl28022
439671a14SYikai Tsai======================
539671a14SYikai Tsai
639671a14SYikai TsaiSupported chips:
739671a14SYikai Tsai
839671a14SYikai Tsai  * Renesas ISL28022
939671a14SYikai Tsai
1039671a14SYikai Tsai    Prefix: 'isl28022'
1139671a14SYikai Tsai
1239671a14SYikai Tsai    Addresses scanned: none
1339671a14SYikai Tsai
1439671a14SYikai Tsai    Datasheet: Publicly available at the Renesas website
1539671a14SYikai Tsai
1639671a14SYikai Tsai	       https://www.renesas.com/us/en/www/doc/datasheet/isl28022.pdf
1739671a14SYikai Tsai
1839671a14SYikai TsaiAuthor:
1939671a14SYikai Tsai    Carsten Spieß <mail@carsten-spiess.de>
2039671a14SYikai Tsai
2139671a14SYikai TsaiDescription
2239671a14SYikai Tsai-----------
2339671a14SYikai Tsai
2439671a14SYikai TsaiThe ISL28022 is a power monitor with I2C interface. The device monitors
2539671a14SYikai Tsaivoltage, current via shunt resistor and calculated power.
2639671a14SYikai Tsai
2739671a14SYikai TsaiUsage Notes
2839671a14SYikai Tsai-----------
2939671a14SYikai Tsai
3039671a14SYikai TsaiThis driver does not auto-detect devices. You will have to instantiate the
3139671a14SYikai Tsaidevice explicitly. Please see Documentation/i2c/instantiating-devices.rst for
3239671a14SYikai Tsaidetails.
3339671a14SYikai Tsai
3439671a14SYikai TsaiThe shunt value in micro-ohms, shunt voltage range and averaging can be set
3539671a14SYikai Tsaiwith device properties.
36895cbbc1SWolfram SangPlease refer to the Documentation/devicetree/bindings/hwmon/renesas,isl28022.yaml
3739671a14SYikai Tsaifor bindings if the device tree is used.
3839671a14SYikai Tsai
3939671a14SYikai TsaiThe driver supports only shunt and bus continuous ADC mode at 15bit resolution.
4039671a14SYikai TsaiAveraging can be set from 1 to 128 samples (power of 2) on both channels.
4139671a14SYikai TsaiShunt voltage range of 40, 80, 160 or 320mV is allowed
4239671a14SYikai TsaiThe bus voltage range is 60V fixed.
4339671a14SYikai Tsai
4439671a14SYikai TsaiSysfs entries
4539671a14SYikai Tsai-------------
4639671a14SYikai Tsai
4739671a14SYikai TsaiThe following attributes are supported. All attributes are read-only.
4839671a14SYikai Tsai
4939671a14SYikai Tsai======================= =======================================================
5039671a14SYikai Tsaiin0_input		bus voltage (milli Volt)
51*262a3f6eSWolfram Sangin1_input		shunt voltage (milli Volt)
5239671a14SYikai Tsai
5339671a14SYikai Tsaicurr1_input		current (milli Ampere)
5439671a14SYikai Tsaipower1_input		power (micro Watt)
5539671a14SYikai Tsai======================= =======================================================
5639671a14SYikai Tsai
5739671a14SYikai TsaiDebugfs entries
5839671a14SYikai Tsai---------------
5939671a14SYikai Tsai
6039671a14SYikai TsaiThe following attributes are supported. All attributes are read-only.
6139671a14SYikai Tsai
6239671a14SYikai Tsai======================= =======================================================
6339671a14SYikai Tsaishunt_voltage		shunt voltage (micro Volt)
6439671a14SYikai Tsai======================= =======================================================
65