xref: /freebsd/sys/contrib/device-tree/Bindings/regulator/richtek,rtq2134-regulator.yaml (revision c7046f76c2c027b00c0e6ba57cfd28f1a78f5e23) 
1# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/regulator/richtek,rtq2134-regulator.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Richtek RTQ2134 SubPMIC Regulator
8
9maintainers:
10  - ChiYuan Huang <cy_huang@richtek.com>
11
12description: |
13  The RTQ2134 is a multi-phase, programmable power management IC that
14  integrates with four high efficient, synchronous step-down converter cores.
15
16  Datasheet is available at
17  https://www.richtek.com/assets/product_file/RTQ2134-QA/DSQ2134-QA-01.pdf
18
19properties:
20  compatible:
21    enum:
22      - richtek,rtq2134
23
24  reg:
25    maxItems: 1
26
27  regulators:
28    type: object
29
30    patternProperties:
31      "^buck[1-3]$":
32        type: object
33        $ref: regulator.yaml#
34        description: |
35          regulator description for buck[1-3].
36
37        properties:
38          richtek,use-vsel-dvs:
39            type: boolean
40            description: |
41              If specified, buck will listen to 'vsel' pin for dvs config.
42              Else, use dvs0 voltage by default.
43
44          richtek,uv-shutdown:
45            type: boolean
46            description: |
47              If specified, use shutdown as UV action. Else, hiccup by default.
48
49        unevaluatedProperties: false
50
51    additionalProperties: false
52
53required:
54  - compatible
55  - reg
56  - regulators
57
58additionalProperties: false
59
60examples:
61  - |
62    i2c {
63      #address-cells = <1>;
64      #size-cells = <0>;
65
66      rtq2134@18 {
67        compatible = "richtek,rtq2134";
68        reg = <0x18>;
69
70        regulators {
71          buck1 {
72            regulator-name = "rtq2134-buck1";
73            regulator-min-microvolt = <300000>;
74            regulator-max-microvolt = <1850000>;
75            regulator-always-on;
76            richtek,use-vsel-dvs;
77            regulator-state-mem {
78              regulator-suspend-min-microvolt = <550000>;
79              regulator-suspend-max-microvolt = <550000>;
80            };
81          };
82          buck2 {
83            regulator-name = "rtq2134-buck2";
84            regulator-min-microvolt = <1120000>;
85            regulator-max-microvolt = <1120000>;
86            regulator-always-on;
87            richtek,use-vsel-dvs;
88            regulator-state-mem {
89              regulator-suspend-min-microvolt = <1120000>;
90              regulator-suspend-max-microvolt = <1120000>;
91            };
92          };
93          buck3 {
94            regulator-name = "rtq2134-buck3";
95            regulator-min-microvolt = <600000>;
96            regulator-max-microvolt = <600000>;
97            regulator-always-on;
98            richtek,use-vsel-dvs;
99            regulator-state-mem {
100              regulator-suspend-min-microvolt = <600000>;
101              regulator-suspend-max-microvolt = <600000>;
102            };
103          };
104        };
105      };
106    };
107