Documentation/devicetree/bindings/regulator/richtek,rtq2134-regulator.yaml

   1 # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/regulator/richtek,rtq2134-regulator.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Richtek RTQ2134 SubPMIC Regulator
   8
   9 maintainers:
  10   - ChiYuan Huang <cy_huang@richtek.com>
  11
  12 description: |
  13   The RTQ2134 is a multi-phase, programmable power management IC that
  14   integrates with four high efficient, synchronous step-down converter cores.
  15
  16   Datasheet is available at
  17   https://www.richtek.com/assets/product_file/RTQ2134-QA/DSQ2134-QA-01.pdf
  18
  19 properties:
  20   compatible:
  21     enum:
  22       - richtek,rtq2134
  23
  24   reg:
  25     maxItems: 1
  26
  27   regulators:
  28     type: object
  29
  30     patternProperties:
  31       "^buck[1-3]$":
  32         type: object
  33         $ref: regulator.yaml#
  34         description: |
  35           regulator description for buck[1-3].
  36
  37         properties:
  38           richtek,use-vsel-dvs:
  39             type: boolean
  40             description: |
  41               If specified, buck will listen to 'vsel' pin for dvs config.
  42               Else, use dvs0 voltage by default.
  43
  44           richtek,uv-shutdown:
  45             type: boolean
  46             description: |
  47               If specified, use shutdown as UV action. Else, hiccup by default.
  48
  49         unevaluatedProperties: false
  50
  51     additionalProperties: false
  52
  53 required:
  54   - compatible
  55   - reg
  56   - regulators
  57
  58 additionalProperties: false
  59
  60 examples:
  61   - |
  62     i2c {
  63       #address-cells = <1>;
  64       #size-cells = <0>;
  65
  66       rtq2134@18 {
  67         compatible = "richtek,rtq2134";
  68         reg = <0x18>;
  69
  70         regulators {
  71           buck1 {
  72             regulator-name = "rtq2134-buck1";
  73             regulator-min-microvolt = <300000>;
  74             regulator-max-microvolt = <1850000>;
  75             regulator-always-on;
  76             richtek,use-vsel-dvs;
  77             regulator-state-mem {
  78               regulator-suspend-min-microvolt = <550000>;
  79               regulator-suspend-max-microvolt = <550000>;
  80             };
  81           };
  82           buck2 {
  83             regulator-name = "rtq2134-buck2";
  84             regulator-min-microvolt = <1120000>;
  85             regulator-max-microvolt = <1120000>;
  86             regulator-always-on;
  87             richtek,use-vsel-dvs;
  88             regulator-state-mem {
  89               regulator-suspend-min-microvolt = <1120000>;
  90               regulator-suspend-max-microvolt = <1120000>;
  91             };
  92           };
  93           buck3 {
  94             regulator-name = "rtq2134-buck3";
  95             regulator-min-microvolt = <600000>;
  96             regulator-max-microvolt = <600000>;
  97             regulator-always-on;
  98             richtek,use-vsel-dvs;
  99             regulator-state-mem {
 100               regulator-suspend-min-microvolt = <600000>;
 101               regulator-suspend-max-microvolt = <600000>;
 102             };
 103           };
 104         };
 105       };
 106     };