Documentation/devicetree/bindings/mfd/rohm,bd9571mwv.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,bd9571mwv.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: ROHM BD9571MWV/BD9574MWF Power Management Integrated Circuit (PMIC)
   8
   9 maintainers:
  10   - Marek Vasut <marek.vasut@gmail.com>
  11
  12 properties:
  13   compatible:
  14     enum:
  15       - rohm,bd9571mwv
  16       - rohm,bd9574mwf
  17
  18   reg:
  19     maxItems: 1
  20
  21   interrupts:
  22     maxItems: 1
  23
  24   interrupt-controller: true
  25
  26   '#interrupt-cells':
  27     const: 2
  28
  29   gpio-controller: true
  30
  31   '#gpio-cells':
  32     const: 2
  33
  34   rohm,ddr-backup-power:
  35     $ref: /schemas/types.yaml#/definitions/uint32
  36     minimum: 0x0
  37     maximum: 0xf
  38     description: |
  39       Value to use for DDR-Backup Power (default 0).
  40       This is a bitmask that specifies which DDR power rails need to be kept
  41       powered when backup mode is entered, for system suspend:
  42         - bit 0: DDR0
  43         - bit 1: DDR1
  44         - bit 2: DDR0C
  45         - bit 3: DDR1C
  46       These bits match the KEEPON_DDR* bits in the documentation for the "BKUP
  47       Mode Cnt" register.
  48
  49   rohm,rstbmode-level:
  50     $ref: /schemas/types.yaml#/definitions/flag
  51     description:
  52       The RSTB signal is configured for level mode, to accommodate a toggle
  53       power switch (the RSTBMODE pin is strapped low).
  54
  55   rohm,rstbmode-pulse:
  56     $ref: /schemas/types.yaml#/definitions/flag
  57     description:
  58       The RSTB signal is configured for pulse mode, to accommodate a momentary
  59       power switch (the RSTBMODE pin is strapped high).
  60
  61   regulators:
  62     type: object
  63     description:
  64       List of child nodes that specify the regulator initialization data.
  65       Child nodes must be named after their hardware counterparts.
  66
  67     patternProperties:
  68       "^(vd09|vd18|vd25|vd33|dvfs)$":
  69         type: object
  70         $ref: ../regulator/regulator.yaml#
  71
  72         properties:
  73           regulator-name:
  74             pattern: "^(vd09|vd18|vd25|vd33|dvfs)$"
  75
  76         unevaluatedProperties: false
  77
  78     additionalProperties: false
  79
  80 additionalProperties: false
  81
  82 required:
  83   - compatible
  84   - reg
  85   - interrupts
  86   - interrupt-controller
  87   - '#interrupt-cells'
  88   - gpio-controller
  89   - '#gpio-cells'
  90
  91 oneOf:
  92   - required:
  93       - rohm,rstbmode-level
  94   - required:
  95       - rohm,rstbmode-pulse
  96
  97 examples:
  98   - |
  99     #include <dt-bindings/interrupt-controller/irq.h>
 100
 101     i2c {
 102           #address-cells = <1>;
 103           #size-cells = <0>;
 104
 105           pmic: pmic@30 {
 106                   compatible = "rohm,bd9571mwv";
 107                   reg = <0x30>;
 108                   interrupt-parent = <&gpio2>;
 109                   interrupts = <0 IRQ_TYPE_LEVEL_LOW>;
 110                   interrupt-controller;
 111                   #interrupt-cells = <2>;
 112                   gpio-controller;
 113                   #gpio-cells = <2>;
 114                   rohm,ddr-backup-power = <0xf>;
 115                   rohm,rstbmode-pulse;
 116
 117                   regulators {
 118                           dvfs: dvfs {
 119                                   regulator-name = "dvfs";
 120                                   regulator-min-microvolt = <750000>;
 121                                   regulator-max-microvolt = <1030000>;
 122                                   regulator-boot-on;
 123                                   regulator-always-on;
 124                           };
 125                   };
 126           };
 127     };