Documentation/devicetree/bindings/regulator/ti,tps65219.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/ti,tps65219.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: TI tps65219 Power Management Integrated Circuit regulators
   8
   9 maintainers:
  10   - Jerome Neanne <jerome.neanne@baylibre.com>
  11
  12 description: |
  13   Regulator nodes should be named to buck<number> and ldo<number>.
  14
  15 properties:
  16   compatible:
  17     enum:
  18       - ti,tps65219
  19
  20   reg:
  21     maxItems: 1
  22
  23   system-power-controller:
  24     type: boolean
  25     description: Optional property that indicates that this device is
  26       controlling system power.
  27
  28   interrupts:
  29     description: Short-circuit, over-current, under-voltage for regulators, PB interrupts.
  30     maxItems: 1
  31
  32   interrupt-controller: true
  33
  34   '#interrupt-cells':
  35     description: Specifies the PIN numbers and Flags, as defined in
  36       include/dt-bindings/interrupt-controller/irq.h
  37     const: 1
  38
  39   ti,power-button:
  40     type: boolean
  41     description: |
  42       Optional property that sets the EN/PB/VSENSE pin to be a
  43       power-button.
  44       TPS65219 has a multipurpose pin called EN/PB/VSENSE that can be either
  45       1. EN in which case it functions as an enable pin.
  46       2. VSENSE which compares the voltages and triggers an automatic
  47       on/off request.
  48       3. PB in which case it can be configured to trigger an interrupt
  49       to the SoC.
  50       ti,power-button reflects the last one of those options
  51       where the board has a button wired to the pin and triggers
  52       an interrupt on pressing it.
  53
  54 patternProperties:
  55   "^buck[1-3]-supply$":
  56     description: Input supply phandle of one regulator.
  57
  58   "^ldo[1-4]-supply$":
  59     description: Input supply phandle of one regulator.
  60
  61   regulators:
  62     type: object
  63     description: |
  64       list of regulators provided by this controller
  65
  66     patternProperties:
  67       "^ldo[1-4]$":
  68         type: object
  69         $ref: regulator.yaml#
  70         description:
  71           Properties for single LDO regulator.
  72
  73         unevaluatedProperties: false
  74
  75       "^buck[1-3]$":
  76         type: object
  77         $ref: regulator.yaml#
  78         description:
  79           Properties for single BUCK regulator.
  80
  81         unevaluatedProperties: false
  82
  83     additionalProperties: false
  84
  85 required:
  86   - compatible
  87   - reg
  88   - interrupts
  89   - regulators
  90
  91 additionalProperties: false
  92
  93 examples:
  94   - |
  95     #include <dt-bindings/interrupt-controller/arm-gic.h>
  96     i2c {
  97         #address-cells = <1>;
  98         #size-cells = <0>;
  99
 100         tps65219: pmic@30 {
 101             compatible = "ti,tps65219";
 102             reg = <0x30>;
 103             buck1-supply = <&vcc_3v3_sys>;
 104             buck2-supply = <&vcc_3v3_sys>;
 105             buck3-supply = <&vcc_3v3_sys>;
 106             ldo1-supply = <&vcc_3v3_sys>;
 107             ldo2-supply = <&buck2_reg>;
 108             ldo3-supply = <&vcc_3v3_sys>;
 109             ldo4-supply = <&vcc_3v3_sys>;
 110
 111             pinctrl-0 = <&pmic_irq_pins_default>;
 112
 113             interrupt-parent = <&gic500>;
 114             interrupts = <GIC_SPI 224 IRQ_TYPE_LEVEL_HIGH>;
 115             ti,power-button;
 116
 117             regulators {
 118                 buck1_reg: buck1 {
 119                     regulator-name = "VDD_CORE";
 120                     regulator-min-microvolt = <750000>;
 121                     regulator-max-microvolt = <750000>;
 122                     regulator-boot-on;
 123                     regulator-always-on;
 124                 };
 125
 126                 buck2_reg: buck2 {
 127                     regulator-name = "VCC1V8";
 128                     regulator-min-microvolt = <1800000>;
 129                     regulator-max-microvolt = <1800000>;
 130                     regulator-boot-on;
 131                     regulator-always-on;
 132                 };
 133
 134                 buck3_reg: buck3 {
 135                     regulator-name = "VDD_LPDDR4";
 136                     regulator-min-microvolt = <1100000>;
 137                     regulator-max-microvolt = <1100000>;
 138                     regulator-boot-on;
 139                     regulator-always-on;
 140                 };
 141
 142                 ldo1_reg: ldo1 {
 143                     regulator-name = "VDDSHV_SD_IO_PMIC";
 144                     regulator-min-microvolt = <33000000>;
 145                     regulator-max-microvolt = <33000000>;
 146                 };
 147
 148                 ldo2_reg: ldo2 {
 149                     regulator-name = "VDDAR_CORE";
 150                     regulator-min-microvolt = <850000>;
 151                     regulator-max-microvolt = <850000>;
 152                     regulator-boot-on;
 153                     regulator-always-on;
 154                 };
 155
 156                 ldo3_reg: ldo3 {
 157                     regulator-name = "VDDA_1V8";
 158                     regulator-min-microvolt = <18000000>;
 159                     regulator-max-microvolt = <18000000>;
 160                     regulator-boot-on;
 161                     regulator-always-on;
 162                 };
 163
 164                 ldo4_reg: ldo4 {
 165                     regulator-name = "VDD_PHY_2V5";
 166                     regulator-min-microvolt = <25000000>;
 167                     regulator-max-microvolt = <25000000>;
 168                     regulator-boot-on;
 169                     regulator-always-on;
 170                 };
 171             };
 172         };
 173     };