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