Documentation/devicetree/bindings/mfd/rohm,bd71837-pmic.yaml

   1 # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/mfd/rohm,bd71837-pmic.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: ROHM BD71837 Power Management Integrated Circuit bindings
   8
   9 maintainers:
  10   - Matti Vaittinen <matti.vaittinen@fi.rohmeurope.com>
  11
  12 description: |
  13   BD71837MWV is programmable Power Management ICs for powering single-core,
  14   dual-core, and quad-core SoCs such as NXP-i.MX 8M. It is optimized for low
  15   BOM cost and compact solution footprint. BD71837MWV  integrates 8 Buck
  16   regulators and 7 LDOs.
  17   Datasheet for BD71837 is available at
  18   https://www.rohm.com/products/power-management/power-management-ic-for-system/industrial-consumer-applications/nxp-imx/bd71837amwv-product
  19
  20 properties:
  21   compatible:
  22     const: rohm,bd71837
  23
  24   reg:
  25     description:
  26       I2C slave address.
  27     maxItems: 1
  28
  29   interrupts:
  30     maxItems: 1
  31
  32   clocks:
  33     maxItems: 1
  34
  35   "#clock-cells":
  36     const: 0
  37
  38 # The BD718x7 supports two different HW states as reset target states. States
  39 # are called as SNVS and READY. At READY state all the PMIC power outputs go
  40 # down and OTP is reload. At the SNVS state all other logic and external
  41 # devices apart from the SNVS power domain are shut off. Please refer to NXP
  42 # i.MX8 documentation for further information regarding SNVS state. When a
  43 # reset is done via SNVS state the PMIC OTP data is not reload. This causes
  44 # power outputs that have been under SW control to stay down when reset has
  45 # switched power state to SNVS. If reset is done via READY state the power
  46 # outputs will be returned to HW control by OTP loading. Thus the reset
  47 # target state is set to READY by default. If SNVS state is used the boot
  48 # crucial regulators must have the regulator-always-on and regulator-boot-on
  49 # properties set in regulator node.
  50
  51   rohm,reset-snvs-powered:
  52     description: |
  53       Transfer PMIC to SNVS state at reset
  54     type: boolean
  55
  56 # Configure the "short press" and "long press" timers for the power button.
  57 # Values are rounded to what hardware supports
  58 # Short-press:
  59 #   Shortest being 10ms, next 500ms and then multiple of 500ms up to 7,5s
  60 # Long-press:
  61 #   Shortest being 10ms, next 1000ms and then multiple of 1000ms up to 15s
  62 # If these properties are not present the existing configuration (from
  63 # bootloader or OTP) is not touched.
  64
  65   rohm,short-press-ms:
  66     description:
  67       Short press duration in milliseconds
  68     enum:
  69       - 10
  70       - 500
  71       - 1000
  72       - 1500
  73       - 2000
  74       - 2500
  75       - 3000
  76       - 3500
  77       - 4000
  78       - 4500
  79       - 5000
  80       - 5500
  81       - 6000
  82       - 6500
  83       - 7000
  84
  85   rohm,long-press-ms:
  86     description:
  87       Long press duration in milliseconds
  88     enum:
  89       - 10
  90       - 1000
  91       - 2000
  92       - 3000
  93       - 4000
  94       - 5000
  95       - 6000
  96       - 7000
  97       - 8000
  98       - 9000
  99       - 10000
 100       - 11000
 101       - 12000
 102       - 13000
 103       - 14000
 104
 105   regulators:
 106     $ref: ../regulator/rohm,bd71837-regulator.yaml
 107     description:
 108       List of child nodes that specify the regulators.
 109
 110 required:
 111   - compatible
 112   - reg
 113   - interrupts
 114   - clocks
 115   - "#clock-cells"
 116   - regulators
 117
 118 additionalProperties: false
 119
 120 examples:
 121   - |
 122     #include <dt-bindings/interrupt-controller/irq.h>
 123     #include <dt-bindings/leds/common.h>
 124
 125     i2c {
 126         #address-cells = <1>;
 127         #size-cells = <0>;
 128         pmic: pmic@4b {
 129             compatible = "rohm,bd71837";
 130             reg = <0x4b>;
 131             interrupt-parent = <&gpio1>;
 132             interrupts = <29 IRQ_TYPE_LEVEL_LOW>;
 133             #clock-cells = <0>;
 134             clocks = <&osc 0>;
 135             rohm,reset-snvs-powered;
 136             rohm,short-press-ms = <10>;
 137             rohm,long-press-ms = <2000>;
 138
 139             regulators {
 140                 buck1: BUCK1 {
 141                     regulator-name = "buck1";
 142                     regulator-min-microvolt = <700000>;
 143                     regulator-max-microvolt = <1300000>;
 144                     regulator-boot-on;
 145                     regulator-always-on;
 146                     regulator-ramp-delay = <1250>;
 147                     rohm,dvs-run-voltage = <900000>;
 148                     rohm,dvs-idle-voltage = <850000>;
 149                     rohm,dvs-suspend-voltage = <800000>;
 150                 };
 151                 buck2: BUCK2 {
 152                     regulator-name = "buck2";
 153                     regulator-min-microvolt = <700000>;
 154                     regulator-max-microvolt = <1300000>;
 155                     regulator-boot-on;
 156                     regulator-always-on;
 157                     regulator-ramp-delay = <1250>;
 158                     rohm,dvs-run-voltage = <1000000>;
 159                     rohm,dvs-idle-voltage = <900000>;
 160                 };
 161                 buck3: BUCK3 {
 162                     regulator-name = "buck3";
 163                     regulator-min-microvolt = <700000>;
 164                     regulator-max-microvolt = <1300000>;
 165                     regulator-boot-on;
 166                     rohm,dvs-run-voltage = <1000000>;
 167                 };
 168                 buck4: BUCK4 {
 169                     regulator-name = "buck4";
 170                     regulator-min-microvolt = <700000>;
 171                     regulator-max-microvolt = <1300000>;
 172                     regulator-boot-on;
 173                     rohm,dvs-run-voltage = <1000000>;
 174                 };
 175                 buck5: BUCK5 {
 176                     regulator-name = "buck5";
 177                     regulator-min-microvolt = <700000>;
 178                     regulator-max-microvolt = <1350000>;
 179                     regulator-boot-on;
 180                 };
 181                 buck6: BUCK6 {
 182                     regulator-name = "buck6";
 183                     regulator-min-microvolt = <3000000>;
 184                     regulator-max-microvolt = <3300000>;
 185                     regulator-boot-on;
 186                 };
 187                 buck7: BUCK7 {
 188                     regulator-name = "buck7";
 189                     regulator-min-microvolt = <1605000>;
 190                     regulator-max-microvolt = <1995000>;
 191                     regulator-boot-on;
 192                 };
 193                 buck8: BUCK8 {
 194                     regulator-name = "buck8";
 195                     regulator-min-microvolt = <800000>;
 196                     regulator-max-microvolt = <1400000>;
 197                 };
 198
 199                 ldo1: LDO1 {
 200                     regulator-name = "ldo1";
 201                     regulator-min-microvolt = <3000000>;
 202                     regulator-max-microvolt = <3300000>;
 203                     regulator-boot-on;
 204                 };
 205                 ldo2: LDO2 {
 206                     regulator-name = "ldo2";
 207                     regulator-min-microvolt = <900000>;
 208                     regulator-max-microvolt = <900000>;
 209                     regulator-boot-on;
 210                 };
 211                 ldo3: LDO3 {
 212                     regulator-name = "ldo3";
 213                     regulator-min-microvolt = <1800000>;
 214                     regulator-max-microvolt = <3300000>;
 215                 };
 216                 ldo4: LDO4 {
 217                     regulator-name = "ldo4";
 218                     regulator-min-microvolt = <900000>;
 219                     regulator-max-microvolt = <1800000>;
 220                 };
 221                 ldo5: LDO5 {
 222                     regulator-name = "ldo5";
 223                     regulator-min-microvolt = <1800000>;
 224                     regulator-max-microvolt = <3300000>;
 225                 };
 226                 ldo6: LDO6 {
 227                     regulator-name = "ldo6";
 228                     regulator-min-microvolt = <900000>;
 229                     regulator-max-microvolt = <1800000>;
 230                 };
 231                 ldo7_reg: LDO7 {
 232                     regulator-name = "ldo7";
 233                     regulator-min-microvolt = <1800000>;
 234                     regulator-max-microvolt = <3300000>;
 235                 };
 236             };
 237         };
 238     };