xref: /linux/Documentation/devicetree/bindings/hwmon/pmbus/isil,isl68137.yaml (revision db4a3f0fbedb0398f77b9047e8b8bb2b49f355bb) 
1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2%YAML 1.2
3---
4
5$id: http://devicetree.org/schemas/hwmon/pmbus/isil,isl68137.yaml#
6$schema: http://devicetree.org/meta-schemas/core.yaml#
7
8title: Renesas Digital Multiphase Voltage Regulators with PMBus
9
10maintainers:
11  - Grant Peltier <grant.peltier.jg@renesas.com>
12
13description: |
14  Renesas digital multiphase voltage regulators with PMBus.
15  https://www.renesas.com/en/products/power-management/multiphase-power/multiphase-dcdc-switching-controllers
16
17properties:
18  compatible:
19    enum:
20      - isil,isl68137
21      - renesas,isl68220
22      - renesas,isl68221
23      - renesas,isl68222
24      - renesas,isl68223
25      - renesas,isl68224
26      - renesas,isl68225
27      - renesas,isl68226
28      - renesas,isl68227
29      - renesas,isl68229
30      - renesas,isl68233
31      - renesas,isl68239
32      - renesas,isl69222
33      - renesas,isl69223
34      - renesas,isl69224
35      - renesas,isl69225
36      - renesas,isl69227
37      - renesas,isl69228
38      - renesas,isl69234
39      - renesas,isl69236
40      - renesas,isl69239
41      - renesas,isl69242
42      - renesas,isl69243
43      - renesas,isl69247
44      - renesas,isl69248
45      - renesas,isl69254
46      - renesas,isl69255
47      - renesas,isl69256
48      - renesas,isl69259
49      - isil,isl69260
50      - renesas,isl69268
51      - isil,isl69269
52      - renesas,isl69298
53      - renesas,raa228000
54      - renesas,raa228004
55      - renesas,raa228006
56      - renesas,raa228228
57      - renesas,raa228244
58      - renesas,raa228246
59      - renesas,raa229001
60      - renesas,raa229004
61      - renesas,raa229621
62
63  reg:
64    maxItems: 1
65
66  '#address-cells':
67    const: 1
68
69  '#size-cells':
70    const: 0
71
72patternProperties:
73  "^channel@([0-3])$":
74    type: object
75    description:
76      Container for properties specific to a particular channel (rail).
77
78    properties:
79      reg:
80        description: The channel (rail) index.
81        items:
82          minimum: 0
83          maximum: 3
84
85      vout-voltage-divider:
86        description: |
87          Resistances of a voltage divider placed between Vout and the voltage
88          sense (Vsense) pin for the given channel (rail). It has two numbers
89          representing the resistances of the voltage divider provided as
90          <Rout Rtotal> which yields an adjusted Vout as
91          Vout_adj = Vout * Rtotal / Rout given the original Vout as reported
92          by the Vsense pin. Given a circuit configuration similar to the one
93          below, Rtotal = R1 + Rout.
94
95            Vout ----.
96                     |
97                  .-----.
98                  | R1  |
99                  '-----'
100                     |
101                     +---- Vsense
102                     |
103                  .-----.
104                  | Rout|
105                  '-----'
106                     |
107                    GND
108
109        $ref: /schemas/types.yaml#/definitions/uint32-array
110        minItems: 2
111        maxItems: 2
112
113    required:
114      - reg
115
116    additionalProperties: false
117
118required:
119  - compatible
120  - reg
121
122additionalProperties: false
123
124examples:
125  - |
126    i2c {
127      #address-cells = <1>;
128      #size-cells = <0>;
129
130      isl68239@60 {
131        compatible = "isil,isl68137";
132        reg = <0x60>;
133      };
134    };
135  - |
136    i2c {
137      #address-cells = <1>;
138      #size-cells = <0>;
139
140      isl68239@60 {
141        compatible = "renesas,isl68239";
142        reg = <0x60>;
143        #address-cells = <1>;
144        #size-cells = <0>;
145
146        channel@0 {
147          reg = <0>;
148          vout-voltage-divider = <1000 2000>;  // Reported Vout/Pout would be scaled by 2
149        };
150      };
151    };
152