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