xref: /freebsd/sys/contrib/device-tree/Bindings/regulator/richtek,rt5739.yaml (revision aa1a8ff2d6dbc51ef058f46f3db5a8bb77967145) 
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
18allOf:
19  - $ref: regulator.yaml#
20
21properties:
22  compatible:
23    enum:
24      - richtek,rt5733
25      - richtek,rt5739
26
27  reg:
28    maxItems: 1
29
30  enable-gpios:
31    maxItems: 1
32
33  richtek,vsel-active-high:
34    description: |
35      If property is present, use the 'VSEL1' register group for buck control.
36      Else, use the 'VSEL0' register group. This depends on external hardware
37      'VSEL' pin connection.
38    type: boolean
39
40  regulator-allowed-modes:
41    description: |
42      buck allowed operating mode
43        0: Auto PFM/PWM mode
44        1: Forced PWM mode
45    items:
46      enum: [0, 1]
47
48required:
49  - compatible
50  - reg
51
52unevaluatedProperties: false
53
54examples:
55  - |
56    #include <dt-bindings/gpio/gpio.h>
57
58    i2c {
59      #address-cells = <1>;
60      #size-cells = <0>;
61
62      regulator@50 {
63        compatible = "richtek,rt5739";
64        reg = <0x50>;
65        enable-gpios = <&gpio26 1 GPIO_ACTIVE_HIGH>;
66        richtek,vsel-active-high;
67        regulator-name = "richtek,rt5739-buck";
68        regulator-min-microvolt = <300000>;
69        regulator-max-microvolt = <1300000>;
70        regulator-allowed-modes = <0 1>;
71        regulator-boot-on;
72      };
73    };
74