Gitiles
Code Review Sign In
git01.mediatek.com / filogic / uboot / dc1917dd4a1b7310e554dd3d698854fc705c2a4b / . / dts / upstream / Bindings / regulator / richtek,rt5190a-regulator.yaml
blob: 89341fdaa3af97846d38fbcc33de858f39c1bab6 [file] [log] [blame]
Tom Rini53633a82024-02-29 12:33:36 -0500[diff] [blame]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,rt5190a-regulator.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Richtek RT5190A PMIC Regulator
8
9maintainers:
10 - ChiYuan Huang <cy_huang@richtek.com>
11
12description: |
13 The RT5190A integrates 1 channel buck controller, 3 channels high efficiency
14 synchronous buck converters, 1 LDO, I2C control interface and peripheral
15 logical control.
16
17 It also supports mute AC OFF depop sound and quick setting storage while
18 input power is removed.
19
20properties:
21 compatible:
22 enum:
23 - richtek,rt5190a
24
25 reg:
26 maxItems: 1
27
28 interrupts:
29 maxItems: 1
30
31 vin2-supply:
32 description: phandle to buck2 input voltage.
33
34 vin3-supply:
35 description: phandle to buck3 input voltage.
36
37 vin4-supply:
38 description: phandle to buck4 input voltage.
39
40 vinldo-supply:
41 description: phandle to ldo input voltage
42
43 richtek,mute-enable:
44 description: |
45 The mute function uses 'mutein', 'muteout', and 'vdet' pins as the control
46 signal. When enabled, The normal behavior is to bypass the 'mutein' signal
47 'muteout'. But if the power source removal is detected from 'vdet',
48 whatever the 'mutein' signal is, it will pull down the 'muteout' to force
49 speakers mute. this function is commonly used to prevent the speaker pop
50 noise during AC power turned off in the modern TV system design.
51 type: boolean
52
53 regulators:
54 type: object
55
56 patternProperties:
57 "^buck[1-4]$|^ldo$":
58 type: object
59 $ref: regulator.yaml#
60 description: |
61 regulator description for buck1 to buck4, and ldo.
62
63 properties:
64 regulator-allowed-modes:
65 description: |
66 buck operating mode, only buck1/4 support mode operating.
67 0: auto mode
68 1: force pwm mode
69 items:
70 enum: [0, 1]
71
72 richtek,latchup-enable:
73 type: boolean
74 description: |
75 If specified, undervolt protection mode changes from the default
76 hiccup to latchup.
77
78 unevaluatedProperties: false
79
80 additionalProperties: false
81
82required:
83 - compatible
84 - reg
85 - regulators
86
87additionalProperties: false
88
89examples:
90 - |
91 #include <dt-bindings/interrupt-controller/irq.h>
92 #include <dt-bindings/regulator/richtek,rt5190a-regulator.h>
93
94 i2c {
95 #address-cells = <1>;
96 #size-cells = <0>;
97
98 pmic@64 {
99 compatible = "richtek,rt5190a";
100 reg = <0x64>;
101 interrupts-extended = <&gpio26 0 IRQ_TYPE_LEVEL_LOW>;
102 vin2-supply = <&rt5190_buck1>;
103 vin3-supply = <&rt5190_buck1>;
104 vin4-supply = <&rt5190_buck1>;
105
106 regulators {
107 rt5190_buck1: buck1 {
108 regulator-name = "rt5190a-buck1";
109 regulator-min-microvolt = <5090000>;
110 regulator-max-microvolt = <5090000>;
111 regulator-allowed-modes = <RT5190A_OPMODE_AUTO RT5190A_OPMODE_FPWM>;
112 regulator-boot-on;
113 };
114 buck2 {
115 regulator-name = "rt5190a-buck2";
116 regulator-min-microvolt = <600000>;
117 regulator-max-microvolt = <1400000>;
118 regulator-boot-on;
119 };
120 buck3 {
121 regulator-name = "rt5190a-buck3";
122 regulator-min-microvolt = <600000>;
123 regulator-max-microvolt = <1400000>;
124 regulator-boot-on;
125 };
126 buck4 {
127 regulator-name = "rt5190a-buck4";
128 regulator-min-microvolt = <850000>;
129 regulator-max-microvolt = <850000>;
130 regulator-allowed-modes = <RT5190A_OPMODE_AUTO RT5190A_OPMODE_FPWM>;
131 regulator-boot-on;
132 };
133 ldo {
134 regulator-name = "rt5190a-ldo";
135 regulator-min-microvolt = <1200000>;
136 regulator-max-microvolt = <1200000>;
137 regulator-boot-on;
138 };
139 };
140 };
141 };