bindings/regulator/richtek%2Crtq2208.yaml

1 # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
3 ---
4 $id: http://devicetree.org/schemas/regulator/richtek,rtq2208.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 title: Richtek RTQ2208 SubPMIC Regulator
10   - Alina Yu <alina_yu@richtek.com>
14   multi-configurable synchronous buck converters and two LDOs.
16   Bucks support "regulator-allowed-modes" and "regulator-mode". The former defines the permitted
17   switching operation in normal mode; the latter defines the operation in suspend to RAM mode.
19   No matter the RTQ2208 is configured to normal or suspend to RAM mode, there are two switching
20   operation modes for all buck rails, automatic power saving mode (Auto mode) and forced continuous
21   conduction mode (FCCM).
25     0 - Auto mode for power saving, which reducing the switching frequency at light load condition
27 …1 - FCCM to meet the strict voltage regulation accuracy, which keeping constant switching frequenc…
35       - richtek,rtq2208
43   richtek,mtp-sel-high:
47       false - Using DVS0 register setting to adjust vout
48       true - Using DVS1 register setting to adjust vout
55       "^buck-[a-h]$":
57         $ref: regulator.yaml#
60           description for buck-[a-h] regulator.
63           regulator-allowed-modes:
66               0 - Auto mode
67               1 - FCCM
71       "^ldo[1-2]$":
73         $ref: regulator.yaml#
76           regulator description for ldo[1-2].
79           richtek,fixed-microvolt:
82               the range of the regulator's adjustable mode.
85   - compatible
86   - reg
87   - regulators
92   - |
93     #include <dt-bindings/interrupt-controller/irq.h>
95       #address-cells = <1>;
96       #size-cells = <0>;
101         interrupts-extended = <&gpio26 0 IRQ_TYPE_LEVEL_LOW>;
102         richtek,mtp-sel-high;
105           buck-a {
106             regulator-min-microvolt = <400000>;
107             regulator-max-microvolt = <2050000>;
108             regulator-allowed-modes = <0 1>;
109             regulator-always-on;
110             regulator-state-mem {
111               regulator-on-in-suspend;
112               regulator-mode = <1>;
115           buck-b {
116             regulator-min-microvolt = <400000>;
117             regulator-max-microvolt = <2050000>;
118             regulator-allowed-modes = <0 1>;
119             regulator-always-on;
120             regulator-state-mem {
121               regulator-on-in-suspend;
122               regulator-mode = <1>;
125           buck-c {
126             regulator-min-microvolt = <400000>;
127             regulator-max-microvolt = <2050000>;
128             regulator-allowed-modes = <0 1>;
129             regulator-always-on;
130             regulator-state-mem {
131               regulator-on-in-suspend;
132               regulator-mode = <1>;
135           buck-d {
136             regulator-min-microvolt = <400000>;
137             regulator-max-microvolt = <2050000>;
138             regulator-allowed-modes = <0 1>;
139             regulator-always-on;
140             regulator-state-mem {
141               regulator-on-in-suspend;
142               regulator-mode = <1>;
145           buck-e {
146             regulator-min-microvolt = <400000>;
147             regulator-max-microvolt = <2050000>;
148             regulator-allowed-modes = <0 1>;
149             regulator-always-on;
150             regulator-state-mem {
151               regulator-on-in-suspend;
152               regulator-mode = <1>;
155           buck-f {
156             regulator-min-microvolt = <400000>;
157             regulator-max-microvolt = <2050000>;
158             regulator-allowed-modes = <0 1>;
159             regulator-always-on;
160             regulator-state-mem {
161               regulator-on-in-suspend;
162               regulator-mode = <1>;
165           buck-g {
166             regulator-min-microvolt = <400000>;
167             regulator-max-microvolt = <2050000>;
168             regulator-allowed-modes = <0 1>;
169             regulator-always-on;
170             regulator-state-mem {
171               regulator-on-in-suspend;
172               regulator-mode = <1>;
175           buck-h {
176             regulator-min-microvolt = <400000>;
177             regulator-max-microvolt = <2050000>;
178             regulator-allowed-modes = <0 1>;
179             regulator-always-on;
180             regulator-state-mem {
181               regulator-on-in-suspend;
182               regulator-mode = <1>;
187             richtek,fixed-microvolt = <1200000>;
188             regulator-min-microvolt = <1200000>;
189             regulator-max-microvolt = <1200000>;
190             regulator-always-on;
191             regulator-state-mem {
192               regulator-on-in-suspend;
197             regulator-min-microvolt = <1800000>;
198             regulator-max-microvolt = <3300000>;
199             regulator-always-on;
200             regulator-state-mem {
201               regulator-on-in-suspend;