Documentation/devicetree/bindings/regulator/rohm,bd71828-regulator.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/rohm,bd71828-regulator.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: ROHM BD71828 Power Management Integrated Circuit regulators
   8
   9 maintainers:
  10   - Matti Vaittinen <matti.vaittinen@fi.rohmeurope.com>
  11
  12 description: |
  13   This module is part of the ROHM BD71828 MFD device. For more details
  14   see Documentation/devicetree/bindings/mfd/rohm,bd71828-pmic.yaml.
  15
  16   The regulator controller is represented as a sub-node of the PMIC node
  17   on the device tree.
  18
  19   Regulator nodes should be named to BUCK_<number> and LDO_<number>.
  20   The valid names for BD71828 regulator nodes are
  21   BUCK1, BUCK2, BUCK3, BUCK4, BUCK5, BUCK6, BUCK7
  22   LDO1, LDO2, LDO3, LDO4, LDO5, LDO6, LDO7
  23
  24 patternProperties:
  25   "^LDO[1-7]$":
  26     type: object
  27     description:
  28       Properties for single LDO regulator.
  29     $ref: regulator.yaml#
  30
  31     properties:
  32       regulator-name:
  33         pattern: "^ldo[1-7]$"
  34         description:
  35           should be "ldo1", ..., "ldo7"
  36
  37     unevaluatedProperties: false
  38
  39   "^BUCK[1-7]$":
  40     type: object
  41     description:
  42       Properties for single BUCK regulator.
  43     $ref: regulator.yaml#
  44
  45     properties:
  46       regulator-name:
  47         pattern: "^buck[1-7]$"
  48         description:
  49           should be "buck1", ..., "buck7"
  50
  51       rohm,dvs-run-voltage:
  52         description:
  53           PMIC default "RUN" state voltage in uV. See below table for
  54           bucks which support this. 0 means disabled.
  55         $ref: "/schemas/types.yaml#/definitions/uint32"
  56         minimum: 0
  57         maximum: 3300000
  58
  59       rohm,dvs-idle-voltage:
  60         description:
  61           PMIC default "IDLE" state voltage in uV. See below table for
  62           bucks which support this. 0 means disabled.
  63         $ref: "/schemas/types.yaml#/definitions/uint32"
  64         minimum: 0
  65         maximum: 3300000
  66
  67       rohm,dvs-suspend-voltage:
  68         description:
  69           PMIC default "SUSPEND" state voltage in uV. See below table for
  70           bucks which support this. 0 means disabled.
  71         $ref: "/schemas/types.yaml#/definitions/uint32"
  72         minimum: 0
  73         maximum: 3300000
  74
  75       rohm,dvs-lpsr-voltage:
  76         description:
  77           PMIC default "LPSR" state voltage in uV. See below table for
  78           bucks which support this. 0 means disabled.
  79         $ref: "/schemas/types.yaml#/definitions/uint32"
  80         minimum: 0
  81         maximum: 3300000
  82
  83         # Supported default DVS states:
  84         #     buck       |    run     |   idle    | suspend  | lpsr
  85         #--------------------------------------------------------------
  86         # 1, 2, 6, and 7 | supported  | supported | supported (*)
  87         #--------------------------------------------------------------
  88         # 3, 4, and 5    |                    supported (**)
  89         #--------------------------------------------------------------
  90         #
  91         #(*)  LPSR and SUSPEND states use same voltage but both states have own
  92         #     enable /
  93         #     disable settings. Voltage 0 can be specified for a state to make
  94         #     regulator disabled on that state.
  95         #
  96         #(**) All states use same voltage but have own enable / disable
  97         #     settings. Voltage 0 can be specified for a state to make
  98         #     regulator disabled on that state.
  99
 100     required:
 101       - regulator-name
 102
 103     unevaluatedProperties: false
 104
 105 additionalProperties: false