xref: /linux/Documentation/devicetree/bindings/regulator/rohm,bd71837-regulator.yaml (revision bd4af432cc71b5fbfe4833510359a6ad3ada250d)
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
7title: ROHM BD71837 Power Management Integrated Circuit regulators
8
9maintainers:
10  - Matti Vaittinen <matti.vaittinen@fi.rohmeurope.com>
11
12description: |
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
30patternProperties:
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
103additionalProperties: false
104