xref: /linux/Documentation/devicetree/bindings/regulator/richtek,rt5739.yaml (revision ff124bbbca1d3a07fa1392ffdbbdeece71f68ece) 
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,rt5739.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Richtek RT5739 Step-Down Buck Converter
8
9maintainers:
10  - ChiYuan Huang <cy_huang@richtek.com>
11
12description: |
13  The RT5739 is a step-down switching buck converter that can deliver the
14  programmable output voltage from 300mV to 1300mV with wide input voltage
15  supply of 2.5V to 5.5V. It can provide up to 3.5A continuous current
16  capability at over 80% high efficiency.
17
18  The RT8092 is similar type buck converter. Compared to RT5739, it can offer
19  up to 4A output current and more output voltage range to meet the application
20  on most mobile products.
21
22allOf:
23  - $ref: regulator.yaml#
24
25properties:
26  compatible:
27    enum:
28      - richtek,rt5733
29      - richtek,rt5739
30      - richtek,rt8092
31
32  reg:
33    maxItems: 1
34
35  enable-gpios:
36    maxItems: 1
37
38  richtek,vsel-active-high:
39    description: |
40      If property is present, use the 'VSEL1' register group for buck control.
41      Else, use the 'VSEL0' register group. This depends on external hardware
42      'VSEL' pin connection.
43    type: boolean
44
45  regulator-allowed-modes:
46    description: |
47      buck allowed operating mode
48        0: Auto PFM/PWM mode
49        1: Forced PWM mode
50    items:
51      enum: [0, 1]
52
53required:
54  - compatible
55  - reg
56
57unevaluatedProperties: false
58
59examples:
60  - |
61    #include <dt-bindings/gpio/gpio.h>
62
63    i2c {
64      #address-cells = <1>;
65      #size-cells = <0>;
66
67      regulator@50 {
68        compatible = "richtek,rt5739";
69        reg = <0x50>;
70        enable-gpios = <&gpio26 1 GPIO_ACTIVE_HIGH>;
71        richtek,vsel-active-high;
72        regulator-name = "richtek,rt5739-buck";
73        regulator-min-microvolt = <300000>;
74        regulator-max-microvolt = <1300000>;
75        regulator-allowed-modes = <0 1>;
76        regulator-boot-on;
77      };
78    };
79