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     allOf:
  28       - $ref: regulator.yaml#
  29     description:
  30       Properties for single LDO regulator.
  31
  32     properties:
  33       regulator-name:
  34         pattern: "^ldo[1-7]$"
  35         description:
  36           should be "ldo1", ..., "ldo7"
  37
  38   "^BUCK[1-7]$":
  39     type: object
  40     allOf:
  41       - $ref: regulator.yaml#
  42     description:
  43       Properties for single BUCK regulator.
  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         allOf:
  53           - $ref: "/schemas/types.yaml#/definitions/uint32"
  54           - minimum: 0
  55             maximum: 3300000
  56         description:
  57           PMIC default "RUN" state voltage in uV. See below table for
  58           bucks which support this. 0 means disabled.
  59
  60       rohm,dvs-idle-voltage:
  61         allOf:
  62           - $ref: "/schemas/types.yaml#/definitions/uint32"
  63           - minimum: 0
  64             maximum: 3300000
  65         description:
  66           PMIC default "IDLE" state voltage in uV. See below table for
  67           bucks which support this. 0 means disabled.
  68
  69       rohm,dvs-suspend-voltage:
  70         allOf:
  71           - $ref: "/schemas/types.yaml#/definitions/uint32"
  72           - minimum: 0
  73             maximum: 3300000
  74         description:
  75           PMIC default "SUSPEND" state voltage in uV. See below table for
  76           bucks which support this. 0 means disabled.
  77
  78       rohm,dvs-lpsr-voltage:
  79         allOf:
  80           - $ref: "/schemas/types.yaml#/definitions/uint32"
  81           - minimum: 0
  82             maximum: 3300000
  83         description:
  84           PMIC default "LPSR" state voltage in uV. See below table for
  85           bucks which support this. 0 means disabled.
  86
  87         # Supported default DVS states:
  88         #     buck       |    run     |   idle    | suspend  | lpsr
  89         #--------------------------------------------------------------
  90         # 1, 2, 6, and 7 | supported  | supported | supported (*)
  91         #--------------------------------------------------------------
  92         # 3, 4, and 5    |                    supported (**)
  93         #--------------------------------------------------------------
  94         #
  95         #(*)  LPSR and SUSPEND states use same voltage but both states have own
  96         #     enable /
  97         #     disable settings. Voltage 0 can be specified for a state to make
  98         #     regulator disabled on that state.
  99         #
 100         #(**) All states use same voltage but have own enable / disable
 101         #     settings. Voltage 0 can be specified for a state to make
 102         #     regulator disabled on that state.
 103
 104     required:
 105       - regulator-name
 106   additionalProperties: false
 107 additionalProperties: false