bindings/regulator/rohm%2Cbd71837-regulator.yaml

1 # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
3 ---
4 $id: http://devicetree.org/schemas/regulator/rohm,bd71837-regulator.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 title: ROHM BD71837 Power Management Integrated Circuit regulators
10   - Matti Vaittinen <mazziesaccount@gmail.com>
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
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
24   cause PMIC to reset.
26 # The valid names for BD71837 regulator nodes are:
31   "^LDO[1-7]$":
38       regulator-name:
39         pattern: "^ldo[1-7]$"
45   "^BUCK[1-8]$":
52       regulator-name:
53         pattern: "^buck[1-8]$"
57       rohm,dvs-run-voltage:
62           PMIC default "RUN" state voltage in uV. See below table for
65       rohm,dvs-idle-voltage:
70           PMIC default "IDLE" state voltage in uV. See below table for
73       rohm,dvs-suspend-voltage:
78           PMIC default "SUSPEND" state voltage in uV. See below table for
83         # BD71837:
84         # buck | dvs-run-voltage | dvs-idle-voltage | dvs-suspend-voltage
85         # ----------------------------------------------------------------
87         # ----------------------------------------------------------------
89         # ----------------------------------------------------------------
91         # ----------------------------------------------------------------
93         # ----------------------------------------------------------------
96       # BD71837 power outputs can either be controlled by the PMIC internal
99       # PMIC HW state machine) - then you should set this property.
101       # regulator (other than invoking a PMIC state change).
102       rohm,no-regulator-enable-control:
105           PMIC hardware state machine.
110       # connected to feedback-pin (over suitable resistors) is getting popular
111       # amongst users of BD71837. (This allows for example scaling down the
118       # |---------------|
119       # |       buck 8  |-------+----->Vout
121       # |---------------|       |
124       #        +-------+--R2----+
128       #        V FB-pull-up
132       # Vout_o = Vo - (Vpu - Vo)*R2/R1
138       # Vpu is the pull-up voltage V FB-pull-up in the picture
141       rohm,fb-pull-up-microvolt:
143           Feedback-pin has pull-up connection to adjust voltage range. This is
144           the used pull-up voltage before R1.
146       rohm,feedback-pull-up-r1-ohms:
148           Feedback-pin has pull-up connection to adjust voltage range. This is
151       rohm,feedback-pull-up-r2-ohms:
153           Feedback-pin has pull-up connection to adjust voltage range. This is
157       - regulator-name