Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: regulator: ROHM BD72720
The ROHM BD72720 is a new PMIC with 10 BUCk and 11 LDO regulators.
The BD72720 is designed to support using the BUCK10 as a supply for
the LDOs 1 to 4. When the BUCK10 is used for this, it can be set to a
LDON_HEAD mode. In this mode, the BUCK10 voltage can't be controlled by
software, but the voltage is adjusted by PMIC to match the LDO1 .. LDO4
voltages with a given offset. Offset can be 50mV .. 300mV and is
changeable at 50mV steps.
Add 'ldon-head-microvolt' property to denote a board which is designed
to utilize the LDON_HEAD mode.
All other properties are already existing.
Add dt-binding doc for ROHM BD72720 regulators to make it usable.
Signed-off-by: Matti Vaittinen <mazziesaccount@gmail.com>
Reviewed-by: Rob Herring (Arm) <robh@kernel.org>
Link: https://patch.msgid.link/81cb38d0ae1b3fa426e40d5b0a93f69a0f374657.1765804226.git.mazziesaccount@gmail.com
Signed-off-by: Lee Jones <lee@kernel.org>
authored by
Matti Vaittinen
and committed by
Lee Jones
4d08b363
8f0b4cce
+148
+148
Documentation/devicetree/bindings/regulator/rohm,bd72720-regulator.yaml
+148
Documentation/devicetree/bindings/regulator/rohm,bd72720-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,bd72720-regulator.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: ROHM BD72720 Power Management Integrated Circuit regulators
8
+
9
+
maintainers:
10
+
- Matti Vaittinen <mazziesaccount@gmail.com>
11
+
12
+
description: |
13
+
This module is part of the ROHM BD72720 MFD device. For more details
14
+
see Documentation/devicetree/bindings/mfd/rohm,bd72720-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 BD72720 regulator nodes are
21
+
buck1, buck2, buck3, buck4, buck5, buck6, buck7, buck8, buck9, buck10
22
+
ldo1, ldo2, ldo3, ldo4, ldo5, ldo6, ldo7, ldo8, ldo9, ldo10, ldo11
23
+
24
+
patternProperties:
25
+
"^ldo([1-9]|1[0-1])$":
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-9]|1[0-1])$"
34
+
35
+
rohm,dvs-run-voltage:
36
+
description:
37
+
PMIC default "RUN" state voltage in uV. See below table for
38
+
LDOs which support this. 0 means disabled.
39
+
$ref: /schemas/types.yaml#/definitions/uint32
40
+
minimum: 0
41
+
maximum: 3300000
42
+
43
+
rohm,dvs-idle-voltage:
44
+
description:
45
+
PMIC default "IDLE" state voltage in uV. See below table for
46
+
LDOs which support this. 0 means disabled.
47
+
$ref: /schemas/types.yaml#/definitions/uint32
48
+
minimum: 0
49
+
maximum: 3300000
50
+
51
+
rohm,dvs-suspend-voltage:
52
+
description:
53
+
PMIC default "SUSPEND" state voltage in uV. See below table for
54
+
LDOs which support this. 0 means disabled.
55
+
$ref: /schemas/types.yaml#/definitions/uint32
56
+
minimum: 0
57
+
maximum: 3300000
58
+
59
+
rohm,dvs-lpsr-voltage:
60
+
description:
61
+
PMIC default "deep-idle" state voltage in uV. See below table for
62
+
LDOs which support this. 0 means disabled.
63
+
$ref: /schemas/types.yaml#/definitions/uint32
64
+
minimum: 0
65
+
maximum: 3300000
66
+
67
+
# Supported default DVS states:
68
+
# ldo | run | idle | suspend | lpsr
69
+
# --------------------------------------------------------------
70
+
# 1, 2, 3, and 4 | supported | supported | supported | supported
71
+
# --------------------------------------------------------------
72
+
# 5 - 11 | supported (*)
73
+
# --------------------------------------------------------------
74
+
#
75
+
# (*) All states use same voltage but have own enable / disable
76
+
# settings. Voltage 0 can be specified for a state to make
77
+
# regulator disabled on that state.
78
+
79
+
unevaluatedProperties: false
80
+
81
+
"^buck([1-9]|10)$":
82
+
type: object
83
+
description:
84
+
Properties for single BUCK regulator.
85
+
$ref: regulator.yaml#
86
+
87
+
properties:
88
+
regulator-name:
89
+
pattern: "^buck([1-9]|10)$"
90
+
91
+
rohm,ldon-head-microvolt:
92
+
description:
93
+
Set this on boards where BUCK10 is used to supply LDOs 1-4. The bucki
94
+
voltage will be changed by the PMIC to follow the LDO output voltages
95
+
with the offset voltage given here. This will improve the LDO efficiency.
96
+
minimum: 50000
97
+
maximum: 300000
98
+
99
+
rohm,dvs-run-voltage:
100
+
description:
101
+
PMIC default "RUN" state voltage in uV. See below table for
102
+
bucks which support this. 0 means disabled.
103
+
$ref: /schemas/types.yaml#/definitions/uint32
104
+
minimum: 0
105
+
maximum: 3300000
106
+
107
+
rohm,dvs-idle-voltage:
108
+
description:
109
+
PMIC default "IDLE" state voltage in uV. See below table for
110
+
bucks which support this. 0 means disabled.
111
+
$ref: /schemas/types.yaml#/definitions/uint32
112
+
minimum: 0
113
+
maximum: 3300000
114
+
115
+
rohm,dvs-suspend-voltage:
116
+
description:
117
+
PMIC default "SUSPEND" state voltage in uV. See below table for
118
+
bucks which support this. 0 means disabled.
119
+
$ref: /schemas/types.yaml#/definitions/uint32
120
+
minimum: 0
121
+
maximum: 3300000
122
+
123
+
rohm,dvs-lpsr-voltage:
124
+
description:
125
+
PMIC default "deep-idle" state voltage in uV. See below table for
126
+
bucks which support this. 0 means disabled.
127
+
$ref: /schemas/types.yaml#/definitions/uint32
128
+
minimum: 0
129
+
maximum: 3300000
130
+
131
+
# Supported default DVS states:
132
+
# buck | run | idle | suspend | lpsr
133
+
# --------------------------------------------------------------
134
+
# 1, 2, 3, and 4 | supported | supported | supported | supported
135
+
# --------------------------------------------------------------
136
+
# 5 - 10 | supported (*)
137
+
# --------------------------------------------------------------
138
+
#
139
+
# (*) All states use same voltage but have own enable / disable
140
+
# settings. Voltage 0 can be specified for a state to make
141
+
# regulator disabled on that state.
142
+
143
+
required:
144
+
- regulator-name
145
+
146
+
unevaluatedProperties: false
147
+
148
+
additionalProperties: false