xref: /openbmc/linux/Documentation/devicetree/bindings/regulator/richtek,rt5759-regulator.yaml (revision 4f2c0a4acffbec01079c28f839422e64ddeff004)
1*2a826d9cSChiYuan Huang# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
2*2a826d9cSChiYuan Huang%YAML 1.2
3*2a826d9cSChiYuan Huang---
4*2a826d9cSChiYuan Huang$id: http://devicetree.org/schemas/regulator/richtek,rt5759-regulator.yaml#
5*2a826d9cSChiYuan Huang$schema: http://devicetree.org/meta-schemas/core.yaml#
6*2a826d9cSChiYuan Huang
7*2a826d9cSChiYuan Huangtitle: Richtek RT5759 High Performance DCDC Converter
8*2a826d9cSChiYuan Huang
9*2a826d9cSChiYuan Huangmaintainers:
10*2a826d9cSChiYuan Huang  - ChiYuan Huang <cy_huang@richtek.com>
11*2a826d9cSChiYuan Huang
12*2a826d9cSChiYuan Huangdescription: |
13*2a826d9cSChiYuan Huang  The RT5759 is a high-performance, synchronous step-down DC-DC converter that
14*2a826d9cSChiYuan Huang  can deliver up to 9A output current from 3V to 6.5V input supply, The output
15*2a826d9cSChiYuan Huang  voltage can be programmable with I2C controlled 7-Bit VID.
16*2a826d9cSChiYuan Huang
17*2a826d9cSChiYuan Huang  Datasheet is available at
18*2a826d9cSChiYuan Huang  https://www.richtek.com/assets/product_file/RT5759/DS5759-00.pdf
19*2a826d9cSChiYuan Huang
20*2a826d9cSChiYuan Huangproperties:
21*2a826d9cSChiYuan Huang  compatible:
22*2a826d9cSChiYuan Huang    enum:
23*2a826d9cSChiYuan Huang      - richtek,rt5759
24*2a826d9cSChiYuan Huang      - richtek,rt5759a
25*2a826d9cSChiYuan Huang
26*2a826d9cSChiYuan Huang  reg:
27*2a826d9cSChiYuan Huang    maxItems: 1
28*2a826d9cSChiYuan Huang
29*2a826d9cSChiYuan Huang  regulator-allowed-modes:
30*2a826d9cSChiYuan Huang    description: |
31*2a826d9cSChiYuan Huang      buck allowed operating mode
32*2a826d9cSChiYuan Huang        0: auto mode (PSKIP: pulse skipping)
33*2a826d9cSChiYuan Huang        1: force pwm mode
34*2a826d9cSChiYuan Huang    items:
35*2a826d9cSChiYuan Huang      enum: [0, 1]
36*2a826d9cSChiYuan Huang
37*2a826d9cSChiYuan Huang  richtek,watchdog-enable:
38*2a826d9cSChiYuan Huang    description: enable the external watchdog reset pin listening
39*2a826d9cSChiYuan Huang    type: boolean
40*2a826d9cSChiYuan Huang
41*2a826d9cSChiYuan HuangallOf:
42*2a826d9cSChiYuan Huang  - $ref: regulator.yaml#
43*2a826d9cSChiYuan Huang
44*2a826d9cSChiYuan Huang  - if:
45*2a826d9cSChiYuan Huang      properties:
46*2a826d9cSChiYuan Huang        compatible:
47*2a826d9cSChiYuan Huang          contains:
48*2a826d9cSChiYuan Huang            const: richtek,rt5759
49*2a826d9cSChiYuan Huang    then:
50*2a826d9cSChiYuan Huang      properties:
51*2a826d9cSChiYuan Huang        richtek,watchdog-enable: false
52*2a826d9cSChiYuan Huang
53*2a826d9cSChiYuan Huangrequired:
54*2a826d9cSChiYuan Huang  - compatible
55*2a826d9cSChiYuan Huang  - reg
56*2a826d9cSChiYuan Huang
57*2a826d9cSChiYuan HuangunevaluatedProperties: false
58*2a826d9cSChiYuan Huang
59*2a826d9cSChiYuan Huangexamples:
60*2a826d9cSChiYuan Huang  # example 1 for RT5759
61*2a826d9cSChiYuan Huang  - |
62*2a826d9cSChiYuan Huang    i2c {
63*2a826d9cSChiYuan Huang      #address-cells = <1>;
64*2a826d9cSChiYuan Huang      #size-cells = <0>;
65*2a826d9cSChiYuan Huang
66*2a826d9cSChiYuan Huang      regulator@62 {
67*2a826d9cSChiYuan Huang        compatible = "richtek,rt5759";
68*2a826d9cSChiYuan Huang        reg = <0x62>;
69*2a826d9cSChiYuan Huang        regulator-name = "rt5759-buck";
70*2a826d9cSChiYuan Huang        regulator-min-microvolt = <600000>;
71*2a826d9cSChiYuan Huang        regulator-max-microvolt = <1500000>;
72*2a826d9cSChiYuan Huang        regulator-boot-on;
73*2a826d9cSChiYuan Huang      };
74*2a826d9cSChiYuan Huang    };
75*2a826d9cSChiYuan Huang  # example 2 for RT5759A
76*2a826d9cSChiYuan Huang  - |
77*2a826d9cSChiYuan Huang    i2c {
78*2a826d9cSChiYuan Huang      #address-cells = <1>;
79*2a826d9cSChiYuan Huang      #size-cells = <0>;
80*2a826d9cSChiYuan Huang
81*2a826d9cSChiYuan Huang      regulator@62 {
82*2a826d9cSChiYuan Huang        compatible = "richtek,rt5759a";
83*2a826d9cSChiYuan Huang        reg = <0x62>;
84*2a826d9cSChiYuan Huang        regulator-name = "rt5759a-buck";
85*2a826d9cSChiYuan Huang        regulator-min-microvolt = <600000>;
86*2a826d9cSChiYuan Huang        regulator-max-microvolt = <1725000>;
87*2a826d9cSChiYuan Huang        regulator-boot-on;
88*2a826d9cSChiYuan Huang        richtek,watchdog-enable;
89*2a826d9cSChiYuan Huang      };
90*2a826d9cSChiYuan Huang    };
91