Documentation/devicetree/bindings/regulator/fixed-regulator.yaml

   1 # SPDX-License-Identifier: GPL-2.0
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/regulator/fixed-regulator.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Fixed Voltage regulators
   8
   9 maintainers:
  10   - Liam Girdwood <lgirdwood@gmail.com>
  11   - Mark Brown <broonie@kernel.org>
  12
  13 description:
  14   Any property defined as part of the core regulator binding, defined in
  15   regulator.yaml, can also be used. However a fixed voltage regulator is
  16   expected to have the regulator-min-microvolt and regulator-max-microvolt
  17   to be the same.
  18
  19 allOf:
  20   - $ref: regulator.yaml#
  21   - if:
  22       properties:
  23         compatible:
  24           contains:
  25             const: regulator-fixed-clock
  26     then:
  27       required:
  28         - clocks
  29   - if:
  30       properties:
  31         compatible:
  32           contains:
  33             const: regulator-fixed-domain
  34     then:
  35       required:
  36         - power-domains
  37         - required-opps
  38   - not:
  39       required:
  40         - gpio
  41         - gpios
  42
  43 properties:
  44   compatible:
  45     enum:
  46       - regulator-fixed
  47       - regulator-fixed-clock
  48       - regulator-fixed-domain
  49
  50   regulator-name: true
  51
  52   gpio:
  53     description: gpio to use for enable control
  54     maxItems: 1
  55
  56   gpios:
  57     maxItems: 1
  58
  59   clocks:
  60     description:
  61       clock to use for enable control. This binding is only available if
  62       the compatible is chosen to regulator-fixed-clock. The clock binding
  63       is mandatory if compatible is chosen to regulator-fixed-clock.
  64     maxItems: 1
  65
  66   power-domains:
  67     deprecated: true
  68     description:
  69       Power domain to use for enable control. This binding is only
  70       available if the compatible is chosen to regulator-fixed-domain.
  71     maxItems: 1
  72
  73   required-opps:
  74     deprecated: true
  75     description:
  76       Performance state to use for enable control. This binding is only
  77       available if the compatible is chosen to regulator-fixed-domain. The
  78       power-domain binding is mandatory if compatible is chosen to
  79       regulator-fixed-domain.
  80     maxItems: 1
  81
  82   startup-delay-us:
  83     description: startup time in microseconds
  84
  85   off-on-delay-us:
  86     description: off delay time in microseconds
  87
  88   enable-active-high:
  89     description:
  90       Polarity of GPIO is Active high. If this property is missing,
  91       the default assumed is Active low.
  92     type: boolean
  93
  94   gpio-open-drain:
  95     description:
  96       GPIO is open drain type. If this property is missing then default
  97       assumption is false.
  98     type: boolean
  99
 100   vin-supply:
 101     description: Input supply phandle.
 102
 103   interrupts:
 104     maxItems: 1
 105     description:
 106       Interrupt signaling a critical under-voltage event.
 107
 108 required:
 109   - compatible
 110   - regulator-name
 111
 112 unevaluatedProperties: false
 113
 114 examples:
 115   - |
 116     reg_1v8: regulator-1v8 {
 117       compatible = "regulator-fixed";
 118       regulator-name = "1v8";
 119       regulator-min-microvolt = <1800000>;
 120       regulator-max-microvolt = <1800000>;
 121       gpio = <&gpio1 16 0>;
 122       startup-delay-us = <70000>;
 123       enable-active-high;
 124       regulator-boot-on;
 125       gpio-open-drain;
 126       vin-supply = <&parent_reg>;
 127     };
 128     reg_1v8_clk: regulator-1v8-clk {
 129       compatible = "regulator-fixed-clock";
 130       regulator-name = "1v8";
 131       regulator-min-microvolt = <1800000>;
 132       regulator-max-microvolt = <1800000>;
 133       clocks = <&clock1>;
 134       startup-delay-us = <70000>;
 135       enable-active-high;
 136       regulator-boot-on;
 137       vin-supply = <&parent_reg>;
 138     };
 139     reg_1v8_domain: regulator-1v8-domain {
 140       compatible = "regulator-fixed-domain";
 141       regulator-name = "1v8";
 142       regulator-min-microvolt = <1800000>;
 143       regulator-max-microvolt = <1800000>;
 144       power-domains = <&domain1>;
 145       required-opps = <&domain1_state1>;
 146       startup-delay-us = <70000>;
 147       enable-active-high;
 148       regulator-boot-on;
 149       vin-supply = <&parent_reg>;
 150     };
 151 ...