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