xref: /linux/Documentation/devicetree/bindings/hwmon/pmbus/isil,isl68137.yaml (revision 364eeb79a213fcf9164208b53764223ad522d6b3) 
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,raa229001
58      - renesas,raa229004
59
60  reg:
61    maxItems: 1
62
63  '#address-cells':
64    const: 1
65
66  '#size-cells':
67    const: 0
68
69patternProperties:
70  "^channel@([0-3])$":
71    type: object
72    description:
73      Container for properties specific to a particular channel (rail).
74
75    properties:
76      reg:
77        description: The channel (rail) index.
78        items:
79          minimum: 0
80          maximum: 3
81
82      vout-voltage-divider:
83        description: |
84          Resistances of a voltage divider placed between Vout and the voltage
85          sense (Vsense) pin for the given channel (rail). It has two numbers
86          representing the resistances of the voltage divider provided as
87          <Rout Rtotal> which yields an adjusted Vout as
88          Vout_adj = Vout * Rtotal / Rout given the original Vout as reported
89          by the Vsense pin. Given a circuit configuration similar to the one
90          below, Rtotal = R1 + Rout.
91
92            Vout ----.
93                     |
94                  .-----.
95                  | R1  |
96                  '-----'
97                     |
98                     +---- Vsense
99                     |
100                  .-----.
101                  | Rout|
102                  '-----'
103                     |
104                    GND
105
106        $ref: /schemas/types.yaml#/definitions/uint32-array
107        minItems: 2
108        maxItems: 2
109
110    required:
111      - reg
112
113    additionalProperties: false
114
115required:
116  - compatible
117  - reg
118
119additionalProperties: false
120
121examples:
122  - |
123    i2c {
124      #address-cells = <1>;
125      #size-cells = <0>;
126
127      isl68239@60 {
128        compatible = "isil,isl68137";
129        reg = <0x60>;
130      };
131    };
132  - |
133    i2c {
134      #address-cells = <1>;
135      #size-cells = <0>;
136
137      isl68239@60 {
138        compatible = "renesas,isl68239";
139        reg = <0x60>;
140        #address-cells = <1>;
141        #size-cells = <0>;
142
143        channel@0 {
144          reg = <0>;
145          vout-voltage-divider = <1000 2000>;  // Reported Vout/Pout would be scaled by 2
146        };
147      };
148    };
149