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,bd71815-regulator.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: ROHM BD71815 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 BD718215 MFD device. For more details
14  see Documentation/devicetree/bindings/mfd/rohm,bd71815-pmic.yaml.
15
16  The regulator controller is represented as a sub-node of the PMIC node
17  on the device tree.
18
19  The valid names for BD71815 regulator nodes are
20  buck1, buck2, buck3, buck4, buck5,
21  ldo1, ldo2, ldo3, ldo4, ldo5,
22  ldodvref, ldolpsr, wled
23
24properties:
25  wled:
26    type: object
27    description:
28      properties for wled regulator
29    $ref: regulator.yaml#
30
31    properties:
32      regulator-name:
33        const: wled
34
35patternProperties:
36  "^((ldo|buck)[1-5]|ldolpsr|ldodvref)$":
37    type: object
38    description:
39      Properties for single LDO/BUCK regulator.
40    $ref: regulator.yaml#
41
42    properties:
43      regulator-name:
44        pattern: "^((ldo|buck)[1-5]|ldolpsr|ldodvref)$"
45        description:
46          should be "ldo1", ..., "ldo5", "buck1", ..., "buck5" and "ldolpsr"
47          for ldolpsr regulator, "ldodvref" for ldodvref reglator.
48
49      rohm,vsel-gpios:
50        description:
51          GPIO used to control ldo4 state (when ldo4 is controlled by GPIO).
52
53      rohm,dvs-run-voltage:
54        description:
55          PMIC "RUN" state voltage in uV when PMIC HW states are used. See
56          comments below for bucks/LDOs which support this. 0 means
57          regulator should be disabled at RUN state.
58        $ref: "/schemas/types.yaml#/definitions/uint32"
59        minimum: 0
60        maximum: 3300000
61
62      rohm,dvs-snvs-voltage:
63        description:
64          Whether to keep regulator enabled at "SNVS" state or not.
65          0 means regulator should be disabled at SNVS state, non zero voltage
66          keeps regulator enabled. BD71815 does not change voltage level
67          when PMIC transitions to SNVS.SNVS voltage depends on the previous
68          state (from which the PMIC transitioned to SNVS).
69        $ref: "/schemas/types.yaml#/definitions/uint32"
70        minimum: 0
71        maximum: 3300000
72
73      rohm,dvs-suspend-voltage:
74        description:
75          PMIC "SUSPEND" state voltage in uV when PMIC HW states are used. See
76          comments below for bucks/LDOs which support this. 0 means
77          regulator should be disabled at SUSPEND state.
78        $ref: "/schemas/types.yaml#/definitions/uint32"
79        minimum: 0
80        maximum: 3300000
81
82      rohm,dvs-lpsr-voltage:
83        description:
84          PMIC "LPSR" state voltage in uV when PMIC HW states are used. See
85          comments below for bucks/LDOs which support this. 0 means
86          regulator should be disabled at LPSR state.
87        $ref: "/schemas/types.yaml#/definitions/uint32"
88        minimum: 0
89        maximum: 3300000
90
91        # Bucks 1 and 2 support giving separate voltages for operational states
92        # (RUN /CLEAN according to data-sheet) and non operational states
93        # (LPSR/SUSPEND). The voltage is automatically changed when HW
94        # state changes. Omitting these properties from bucks 1 and 2 leave
95        # buck voltages to not be toggled by HW state. Enable status may still
96        # be toggled by state changes depending on HW default settings.
97        #
98        # Bucks 3-5 and ldos 1-5 support setting the RUN state voltage here.
99        # Given RUN voltage is used at all states if regulator is enabled at
100        # given state.
101        # Values given for other states are regarded as enable/disable at
102        # given state (see below).
103        #
104        # All regulators except WLED support specifying enable/disable status
105        # for each of the HW states (RUN/SNVS/SUSPEND/LPSR). HW defaults can
106        # be overridden by setting voltage to 0 (regulator disabled at given
107        # state) or non-zero (regulator enabled at given state). Please note
108        # that setting non zero voltages for bucks 1/2 will also enable voltage
109        # changes according to state change.
110
111    required:
112      - regulator-name
113
114    unevaluatedProperties: false
115
116additionalProperties: false
117