xref: /freebsd/sys/contrib/device-tree/Bindings/regulator/rohm,bd71828-regulator.yaml (revision 8ddb146abcdf061be9f2c0db7e391697dafad85c) 
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
7title: ROHM BD71828 Power Management Integrated Circuit regulators
8
9maintainers:
10  - Matti Vaittinen <matti.vaittinen@fi.rohmeurope.com>
11
12description: |
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
24patternProperties:
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
105additionalProperties: false
106