xref: /freebsd/sys/contrib/device-tree/Bindings/regulator/richtek,rt5739.yaml (revision fac71e4e09885bb2afa3d984a0c239a52e1a7418)
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