Documentation/devicetree/bindings/regulator/pfuze100.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/pfuze100.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: PFUZE100 family of regulators
   8
   9 maintainers:
  10   - Robin Gong <yibin.gong@nxp.com>
  11
  12 description: |
  13   The valid names for regulators are:
  14   --PFUZE100
  15   sw1ab,sw1c,sw2,sw3a,sw3b,sw4,swbst,vsnvs,vrefddr,vgen1~vgen6
  16   --PFUZE200
  17   sw1ab,sw2,sw3a,sw3b,swbst,vsnvs,vrefddr,vgen1~vgen6,coin
  18   --PFUZE3000
  19   sw1a,sw1b,sw2,sw3,swbst,vsnvs,vrefddr,vldo1,vldo2,vccsd,v33,vldo3,vldo4
  20   --PFUZE3001
  21   sw1,sw2,sw3,vsnvs,vldo1,vldo2,vccsd,v33,vldo3,vldo4
  22
  23   Each regulator is defined using the standard binding for regulators.
  24
  25 properties:
  26   $nodename:
  27     pattern: "^pmic@[0-9]$"
  28
  29   compatible:
  30     enum:
  31       - fsl,pfuze100
  32       - fsl,pfuze200
  33       - fsl,pfuze3000
  34       - fsl,pfuze3001
  35
  36   reg:
  37     maxItems: 1
  38
  39   interrupts:
  40     maxItems: 1
  41
  42   fsl,pfuze-support-disable-sw:
  43     $ref: /schemas/types.yaml#/definitions/flag
  44     description: |
  45       Boolean, if present disable all unused switch regulators to save power
  46       consumption. Attention, ensure that all important regulators
  47       (e.g. DDR ref, DDR supply) has set the "regulator-always-on" property.
  48       If not present, the switched regulators are always on and can't be
  49       disabled. This binding is a workaround to keep backward compatibility
  50       with old dtb's which rely on the fact that the switched regulators are
  51       always on and don't mark them explicit as "regulator-always-on".
  52
  53   fsl,pmic-stby-poweroff:
  54     $ref: /schemas/types.yaml#/definitions/flag
  55     description: |
  56       if present, configure the PMIC to shutdown all
  57       power rails when PMIC_STBY_REQ line is asserted during the power off sequence.
  58       Use this option if the SoC should be powered off by external power management
  59       IC (PMIC) on PMIC_STBY_REQ signal.
  60       As opposite to PMIC_STBY_REQ boards can implement PMIC_ON_REQ signal.
  61
  62   regulators:
  63     type: object
  64     description: |
  65       list of regulators provided by this controller.
  66
  67     patternProperties:
  68       "^sw([1-4]|[1-4][a-c]|[1-4][a-c][a-c])$":
  69         $ref: regulator.yaml#
  70         type: object
  71
  72       "^vgen[1-6]$":
  73         $ref: regulator.yaml#
  74         type: object
  75
  76       "^vldo[1-4]$":
  77         $ref: regulator.yaml#
  78         type: object
  79
  80       "^(vsnvs|vref|vrefddr|swbst|coin|v33|vccsd)$":
  81         $ref: regulator.yaml#
  82         type: object
  83
  84     additionalProperties: false
  85
  86 required:
  87   - compatible
  88   - reg
  89
  90 additionalProperties: false
  91
  92 examples:
  93   - |
  94     i2c {
  95         #address-cells = <1>;
  96         #size-cells = <0>;
  97
  98         pmic@8 {
  99             compatible = "fsl,pfuze100";
 100             reg = <0x08>;
 101
 102             regulators {
 103                 sw1a_reg: sw1ab {
 104                     regulator-min-microvolt = <300000>;
 105                     regulator-max-microvolt = <1875000>;
 106                     regulator-boot-on;
 107                     regulator-always-on;
 108                     regulator-ramp-delay = <6250>;
 109                 };
 110
 111                 sw1c_reg: sw1c {
 112                     regulator-min-microvolt = <300000>;
 113                     regulator-max-microvolt = <1875000>;
 114                     regulator-boot-on;
 115                     regulator-always-on;
 116                 };
 117
 118                 sw2_reg: sw2 {
 119                     regulator-min-microvolt = <800000>;
 120                     regulator-max-microvolt = <3300000>;
 121                     regulator-boot-on;
 122                     regulator-always-on;
 123                 };
 124
 125                 sw3a_reg: sw3a {
 126                     regulator-min-microvolt = <400000>;
 127                     regulator-max-microvolt = <1975000>;
 128                     regulator-boot-on;
 129                     regulator-always-on;
 130                 };
 131
 132                 sw3b_reg: sw3b {
 133                     regulator-min-microvolt = <400000>;
 134                     regulator-max-microvolt = <1975000>;
 135                     regulator-boot-on;
 136                     regulator-always-on;
 137                 };
 138
 139                 sw4_reg: sw4 {
 140                     regulator-min-microvolt = <800000>;
 141                     regulator-max-microvolt = <3300000>;
 142                 };
 143
 144                 swbst_reg: swbst {
 145                     regulator-min-microvolt = <5000000>;
 146                     regulator-max-microvolt = <5150000>;
 147                 };
 148
 149                 snvs_reg: vsnvs {
 150                     regulator-min-microvolt = <1000000>;
 151                     regulator-max-microvolt = <3000000>;
 152                     regulator-boot-on;
 153                     regulator-always-on;
 154                 };
 155
 156                 vref_reg: vrefddr {
 157                     regulator-boot-on;
 158                     regulator-always-on;
 159                 };
 160
 161                 vgen1_reg: vgen1 {
 162                     regulator-min-microvolt = <800000>;
 163                     regulator-max-microvolt = <1550000>;
 164                 };
 165
 166                 vgen2_reg: vgen2 {
 167                     regulator-min-microvolt = <800000>;
 168                     regulator-max-microvolt = <1550000>;
 169                 };
 170
 171                 vgen3_reg: vgen3 {
 172                     regulator-min-microvolt = <1800000>;
 173                     regulator-max-microvolt = <3300000>;
 174                 };
 175
 176                 vgen4_reg: vgen4 {
 177                     regulator-min-microvolt = <1800000>;
 178                     regulator-max-microvolt = <3300000>;
 179                     regulator-always-on;
 180                 };
 181
 182                 vgen5_reg: vgen5 {
 183                     regulator-min-microvolt = <1800000>;
 184                     regulator-max-microvolt = <3300000>;
 185                     regulator-always-on;
 186                 };
 187
 188                 vgen6_reg: vgen6 {
 189                     regulator-min-microvolt = <1800000>;
 190                     regulator-max-microvolt = <3300000>;
 191                     regulator-always-on;
 192                 };
 193             };
 194         };
 195     };