Documentation/devicetree/bindings/regulator/mps,mpq7920.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/mps,mpq7920.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Monolithic Power System MPQ7920 PMIC
   8
   9 maintainers:
  10   - Saravanan Sekar <sravanhome@gmail.com>
  11
  12 properties:
  13   $nodename:
  14     pattern: "pmic@[0-9a-f]{1,2}"
  15   compatible:
  16     enum:
  17       - mps,mpq7920
  18
  19   reg:
  20     maxItems: 1
  21
  22   regulators:
  23     type: object
  24     $ref: regulator.yaml#
  25
  26     description: |
  27       list of regulators provided by this controller, must be named
  28       after their hardware counterparts BUCK[1-4], one LDORTC, and LDO[2-5]
  29
  30     properties:
  31       mps,switch-freq:
  32         $ref: "/schemas/types.yaml#/definitions/uint8"
  33         enum: [0, 1, 2, 3]
  34         default: 2
  35         description: |
  36           switching frequency must be one of following corresponding value
  37           1.1MHz, 1.65MHz, 2.2MHz, 2.75MHz
  38
  39     patternProperties:
  40       "^ldo[1-4]$":
  41         type: object
  42         $ref: regulator.yaml#
  43
  44       "^ldortc$":
  45         type: object
  46         $ref: regulator.yaml#
  47
  48       "^buck[1-4]$":
  49         type: object
  50         $ref: regulator.yaml#
  51
  52         properties:
  53           mps,buck-softstart:
  54             $ref: "/schemas/types.yaml#/definitions/uint8"
  55             enum: [0, 1, 2, 3]
  56             description: |
  57               defines the soft start time of this buck, must be one of the following
  58               corresponding values 150us, 300us, 610us, 920us
  59
  60           mps,buck-phase-delay:
  61             $ref: "/schemas/types.yaml#/definitions/uint8"
  62             enum: [0, 1, 2, 3]
  63             description: |
  64               defines the phase delay of this buck, must be one of the following
  65               corresponding values 0deg, 90deg, 180deg, 270deg
  66
  67           mps,buck-ovp-disable:
  68             type: boolean
  69             description: |
  70               disables over voltage protection of this buck
  71
  72         unevaluatedProperties: false
  73
  74     additionalProperties: false
  75
  76 required:
  77   - compatible
  78   - reg
  79   - regulators
  80
  81 additionalProperties: false
  82
  83 examples:
  84   - |
  85     i2c {
  86         #address-cells = <1>;
  87         #size-cells = <0>;
  88
  89         pmic@69 {
  90           compatible = "mps,mpq7920";
  91           reg = <0x69>;
  92
  93           regulators {
  94             mps,switch-freq = /bits/ 8 <1>;
  95
  96             buck1 {
  97              regulator-name = "buck1";
  98              regulator-min-microvolt = <400000>;
  99              regulator-max-microvolt = <3587500>;
 100              regulator-min-microamp  = <460000>;
 101              regulator-max-microamp  = <7600000>;
 102              regulator-boot-on;
 103              mps,buck-ovp-disable;
 104              mps,buck-phase-delay = /bits/ 8 <2>;
 105              mps,buck-softstart = /bits/ 8 <1>;
 106             };
 107
 108             ldo2 {
 109              regulator-name = "ldo2";
 110              regulator-min-microvolt = <650000>;
 111              regulator-max-microvolt = <3587500>;
 112             };
 113          };
 114        };
 115      };
 116 ...