isil,isl68137.yaml

  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    };