xref: /linux/Documentation/devicetree/bindings/hwmon/renesas,isl28022.yaml (revision c771600c6af14749609b49565ffb4cac2959710d)
1*f3bfd13cSYikai Tsai# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2*f3bfd13cSYikai Tsai%YAML 1.2
3*f3bfd13cSYikai Tsai---
4*f3bfd13cSYikai Tsai$id: http://devicetree.org/schemas/hwmon/renesas,isl28022.yaml#
5*f3bfd13cSYikai Tsai$schema: http://devicetree.org/meta-schemas/core.yaml#
6*f3bfd13cSYikai Tsai
7*f3bfd13cSYikai Tsaititle: Renesas ISL28022 power monitor
8*f3bfd13cSYikai Tsai
9*f3bfd13cSYikai Tsaimaintainers:
10*f3bfd13cSYikai Tsai  - Carsten Spieß <mail@carsten-spiess.de>
11*f3bfd13cSYikai Tsai
12*f3bfd13cSYikai Tsaidescription: |
13*f3bfd13cSYikai Tsai  The ISL28022 is a power monitor with I2C interface. The device monitors
14*f3bfd13cSYikai Tsai  voltage, current via shunt resistor and calculated power.
15*f3bfd13cSYikai Tsai
16*f3bfd13cSYikai Tsai  Datasheets:
17*f3bfd13cSYikai Tsai    https://www.renesas.com/us/en/www/doc/datasheet/isl28022.pdf
18*f3bfd13cSYikai Tsai
19*f3bfd13cSYikai Tsaiproperties:
20*f3bfd13cSYikai Tsai  compatible:
21*f3bfd13cSYikai Tsai    const: renesas,isl28022
22*f3bfd13cSYikai Tsai
23*f3bfd13cSYikai Tsai  reg:
24*f3bfd13cSYikai Tsai    maxItems: 1
25*f3bfd13cSYikai Tsai
26*f3bfd13cSYikai Tsai  shunt-resistor-micro-ohms:
27*f3bfd13cSYikai Tsai    description:
28*f3bfd13cSYikai Tsai      Shunt resistor value in micro-Ohm
29*f3bfd13cSYikai Tsai    minimum: 800
30*f3bfd13cSYikai Tsai    default: 10000
31*f3bfd13cSYikai Tsai
32*f3bfd13cSYikai Tsai  renesas,shunt-range-microvolt:
33*f3bfd13cSYikai Tsai    description:
34*f3bfd13cSYikai Tsai      Maximal shunt voltage range of +/- 40 mV, 80 mV, 160 mV or 320 mV
35*f3bfd13cSYikai Tsai    default: 320000
36*f3bfd13cSYikai Tsai    enum: [40000, 80000, 160000, 320000]
37*f3bfd13cSYikai Tsai
38*f3bfd13cSYikai Tsai  renesas,average-samples:
39*f3bfd13cSYikai Tsai    description:
40*f3bfd13cSYikai Tsai      Number of samples to be used to report voltage, current and power values.
41*f3bfd13cSYikai Tsai    default: 1
42*f3bfd13cSYikai Tsai    $ref: /schemas/types.yaml#/definitions/uint32
43*f3bfd13cSYikai Tsai    enum: [1, 2, 4, 8, 16, 32, 64, 128]
44*f3bfd13cSYikai Tsai
45*f3bfd13cSYikai Tsairequired:
46*f3bfd13cSYikai Tsai  - compatible
47*f3bfd13cSYikai Tsai  - reg
48*f3bfd13cSYikai Tsai
49*f3bfd13cSYikai TsaiadditionalProperties: false
50*f3bfd13cSYikai Tsai
51*f3bfd13cSYikai Tsaiexamples:
52*f3bfd13cSYikai Tsai  - |
53*f3bfd13cSYikai Tsai    i2c {
54*f3bfd13cSYikai Tsai        #address-cells = <1>;
55*f3bfd13cSYikai Tsai        #size-cells = <0>;
56*f3bfd13cSYikai Tsai
57*f3bfd13cSYikai Tsai        power-monitor@40 {
58*f3bfd13cSYikai Tsai            compatible = "renesas,isl28022";
59*f3bfd13cSYikai Tsai            reg = <0x40>;
60*f3bfd13cSYikai Tsai            shunt-resistor-micro-ohms = <8000>;
61*f3bfd13cSYikai Tsai            renesas,shunt-range-microvolt = <40000>;
62*f3bfd13cSYikai Tsai            renesas,average-samples = <128>;
63*f3bfd13cSYikai Tsai        };
64*f3bfd13cSYikai Tsai    };
65