Documentation/devicetree/bindings/regulator/rohm,bd71837-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,bd71837-regulator.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: ROHM BD71837 Power Management Integrated Circuit regulators
   8
   9 maintainers:
  10   - Matti Vaittinen <matti.vaittinen@fi.rohmeurope.com>
  11
  12 description: |
  13   List of regulators provided by this controller. BD71837 regulators node
  14   should be sub node of the BD71837 MFD node. See BD71837 MFD bindings at
  15   Documentation/devicetree/bindings/mfd/rohm,bd71837-pmic.yaml
  16   Regulator nodes should be named to BUCK_<number> and LDO_<number>. The
  17   definition for each of these nodes is defined using the standard
  18   binding for regulators at
  19   Documentation/devicetree/bindings/regulator/regulator.txt.
  20   Note that if BD71837 starts at RUN state you probably want to use
  21   regulator-boot-on at least for BUCK6 and BUCK7 so that those are not
  22   disabled by driver at startup. LDO5 and LDO6 are supplied by those and
  23   if they are disabled at startup the voltage monitoring for LDO5/LDO6 will
  24   cause PMIC to reset.
  25
  26 #The valid names for BD71837 regulator nodes are:
  27 #BUCK1, BUCK2, BUCK3, BUCK4, BUCK5, BUCK6, BUCK7, BUCK8
  28 #LDO1, LDO2, LDO3, LDO4, LDO5, LDO6, LDO7
  29
  30 patternProperties:
  31   "^LDO[1-7]$":
  32     type: object
  33     allOf:
  34       - $ref: regulator.yaml#
  35     description:
  36       Properties for single LDO regulator.
  37
  38     properties:
  39       regulator-name:
  40         pattern: "^ldo[1-7]$"
  41         description:
  42           should be "ldo1", ..., "ldo7"
  43
  44   "^BUCK[1-8]$":
  45     type: object
  46     allOf:
  47       - $ref: regulator.yaml#
  48     description:
  49       Properties for single BUCK regulator.
  50
  51     properties:
  52       regulator-name:
  53         pattern: "^buck[1-8]$"
  54         description:
  55           should be "buck1", ..., "buck8"
  56
  57       rohm,dvs-run-voltage:
  58         allOf:
  59           - $ref: "/schemas/types.yaml#/definitions/uint32"
  60           - minimum: 0
  61             maximum: 1300000
  62         description:
  63           PMIC default "RUN" state voltage in uV. See below table for
  64           bucks which support this. 0 means disabled.
  65
  66       rohm,dvs-idle-voltage:
  67         allOf:
  68           - $ref: "/schemas/types.yaml#/definitions/uint32"
  69           - minimum: 0
  70             maximum: 1300000
  71         description:
  72           PMIC default "IDLE" state voltage in uV. See below table for
  73           bucks which support this. 0 means disabled.
  74
  75       rohm,dvs-suspend-voltage:
  76         allOf:
  77           - $ref: "/schemas/types.yaml#/definitions/uint32"
  78           - minimum: 0
  79             maximum: 1300000
  80         description:
  81           PMIC default "SUSPEND" state voltage in uV. See below table for
  82           bucks which support this. 0 means disabled.
  83
  84         # Supported default DVS states:
  85         #
  86         # BD71837:
  87         # buck | dvs-run-voltage | dvs-idle-voltage | dvs-suspend-voltage
  88         # ----------------------------------------------------------------
  89         # 1    | supported       | supported        | supported
  90         # ----------------------------------------------------------------
  91         # 2    | supported       | supported        | not supported
  92         # ----------------------------------------------------------------
  93         # 3    | supported       | not supported    | not supported
  94         # ----------------------------------------------------------------
  95         # 4    | supported       | not supported    | not supported
  96         # ----------------------------------------------------------------
  97         # rest | not supported   | not supported    | not supported
  98
  99
 100     required:
 101       - regulator-name
 102   additionalProperties: false
 103 additionalProperties: false