Documentation/devicetree/bindings/regulator/rohm,bd71847-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,bd71847-regulator.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: ROHM BD71847 and BD71850 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. BD71847 regulators node
  14   should be sub node of the BD71847 MFD node. See BD71847 MFD bindings at
  15   Documentation/devicetree/bindings/mfd/rohm,bd71847-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 BD71847 starts at RUN state you probably want to use
  21   regulator-boot-on at least for BUCK5. LDO6 is supplied by it and it must
  22   not be disabled by driver at startup. If BUCK5 is disabled at startup the
  23   voltage monitoring for LDO5/LDO6 can cause PMIC to reset.
  24
  25 #The valid names for BD71847 regulator nodes are:
  26 #BUCK1, BUCK2, BUCK3, BUCK4, BUCK5, BUCK6
  27 #LDO1, LDO2, LDO3, LDO4, LDO5, LDO6
  28
  29 patternProperties:
  30   "^LDO[1-6]$":
  31     type: object
  32     allOf:
  33       - $ref: regulator.yaml#
  34     description:
  35       Properties for single LDO regulator.
  36
  37     properties:
  38       regulator-name:
  39         pattern: "^ldo[1-6]$"
  40         description:
  41           should be "ldo1", ..., "ldo6"
  42
  43   "^BUCK[1-6]$":
  44     type: object
  45     allOf:
  46       - $ref: regulator.yaml#
  47     description:
  48       Properties for single BUCK regulator.
  49
  50     properties:
  51       regulator-name:
  52         pattern: "^buck[1-6]$"
  53         description:
  54           should be "buck1", ..., "buck6"
  55
  56       rohm,dvs-run-voltage:
  57         allOf:
  58           - $ref: "/schemas/types.yaml#/definitions/uint32"
  59           - minimum: 0
  60             maximum: 1300000
  61         description:
  62           PMIC default "RUN" state voltage in uV. See below table for
  63           bucks which support this. 0 means disabled.
  64
  65       rohm,dvs-idle-voltage:
  66         allOf:
  67           - $ref: "/schemas/types.yaml#/definitions/uint32"
  68           - minimum: 0
  69             maximum: 1300000
  70         description:
  71           PMIC default "IDLE" state voltage in uV. See below table for
  72           bucks which support this. 0 means disabled.
  73
  74       rohm,dvs-suspend-voltage:
  75         allOf:
  76           - $ref: "/schemas/types.yaml#/definitions/uint32"
  77           - minimum: 0
  78             maximum: 1300000
  79         description:
  80           PMIC default "SUSPEND" state voltage in uV. See below table for
  81           bucks which support this. 0 means disabled.
  82
  83         # Supported default DVS states:
  84         #
  85         # BD71847:
  86         # buck | dvs-run-voltage | dvs-idle-voltage | dvs-suspend-voltage
  87         # ----------------------------------------------------------------
  88         # 1    | supported       | supported        | supported
  89         # ----------------------------------------------------------------
  90         # 2    | supported       | supported        | not supported
  91         # ----------------------------------------------------------------
  92         # rest | not supported   | not supported    | not supported
  93
  94     required:
  95       - regulator-name
  96   additionalProperties: false
  97 additionalProperties: false