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