xref: /freebsd/sys/contrib/device-tree/Bindings/regulator/richtek,rt5739.yaml (revision aa1a8ff2d6dbc51ef058f46f3db5a8bb77967145)
1fac71e4eSEmmanuel Vadot# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
2fac71e4eSEmmanuel Vadot%YAML 1.2
3fac71e4eSEmmanuel Vadot---
4fac71e4eSEmmanuel Vadot$id: http://devicetree.org/schemas/regulator/richtek,rt5739.yaml#
5fac71e4eSEmmanuel Vadot$schema: http://devicetree.org/meta-schemas/core.yaml#
6fac71e4eSEmmanuel Vadot
7fac71e4eSEmmanuel Vadottitle: Richtek RT5739 Step-Down Buck Converter
8fac71e4eSEmmanuel Vadot
9fac71e4eSEmmanuel Vadotmaintainers:
10fac71e4eSEmmanuel Vadot  - ChiYuan Huang <cy_huang@richtek.com>
11fac71e4eSEmmanuel Vadot
12fac71e4eSEmmanuel Vadotdescription: |
13fac71e4eSEmmanuel Vadot  The RT5739 is a step-down switching buck converter that can deliver the
14fac71e4eSEmmanuel Vadot  programmable output voltage from 300mV to 1300mV with wide input voltage
15fac71e4eSEmmanuel Vadot  supply of 2.5V to 5.5V. It can provide up to 3.5A continuous current
16fac71e4eSEmmanuel Vadot  capability at over 80% high efficiency.
17fac71e4eSEmmanuel Vadot
18fac71e4eSEmmanuel VadotallOf:
19fac71e4eSEmmanuel Vadot  - $ref: regulator.yaml#
20fac71e4eSEmmanuel Vadot
21fac71e4eSEmmanuel Vadotproperties:
22fac71e4eSEmmanuel Vadot  compatible:
23fac71e4eSEmmanuel Vadot    enum:
24*aa1a8ff2SEmmanuel Vadot      - richtek,rt5733
25fac71e4eSEmmanuel Vadot      - richtek,rt5739
26fac71e4eSEmmanuel Vadot
27fac71e4eSEmmanuel Vadot  reg:
28fac71e4eSEmmanuel Vadot    maxItems: 1
29fac71e4eSEmmanuel Vadot
30fac71e4eSEmmanuel Vadot  enable-gpios:
31fac71e4eSEmmanuel Vadot    maxItems: 1
32fac71e4eSEmmanuel Vadot
33fac71e4eSEmmanuel Vadot  richtek,vsel-active-high:
34fac71e4eSEmmanuel Vadot    description: |
35fac71e4eSEmmanuel Vadot      If property is present, use the 'VSEL1' register group for buck control.
36fac71e4eSEmmanuel Vadot      Else, use the 'VSEL0' register group. This depends on external hardware
37fac71e4eSEmmanuel Vadot      'VSEL' pin connection.
38fac71e4eSEmmanuel Vadot    type: boolean
39fac71e4eSEmmanuel Vadot
40fac71e4eSEmmanuel Vadot  regulator-allowed-modes:
41fac71e4eSEmmanuel Vadot    description: |
42fac71e4eSEmmanuel Vadot      buck allowed operating mode
43fac71e4eSEmmanuel Vadot        0: Auto PFM/PWM mode
44fac71e4eSEmmanuel Vadot        1: Forced PWM mode
45fac71e4eSEmmanuel Vadot    items:
46fac71e4eSEmmanuel Vadot      enum: [0, 1]
47fac71e4eSEmmanuel Vadot
48fac71e4eSEmmanuel Vadotrequired:
49fac71e4eSEmmanuel Vadot  - compatible
50fac71e4eSEmmanuel Vadot  - reg
51fac71e4eSEmmanuel Vadot
52fac71e4eSEmmanuel VadotunevaluatedProperties: false
53fac71e4eSEmmanuel Vadot
54fac71e4eSEmmanuel Vadotexamples:
55fac71e4eSEmmanuel Vadot  - |
56fac71e4eSEmmanuel Vadot    #include <dt-bindings/gpio/gpio.h>
57fac71e4eSEmmanuel Vadot
58fac71e4eSEmmanuel Vadot    i2c {
59fac71e4eSEmmanuel Vadot      #address-cells = <1>;
60fac71e4eSEmmanuel Vadot      #size-cells = <0>;
61fac71e4eSEmmanuel Vadot
62fac71e4eSEmmanuel Vadot      regulator@50 {
63fac71e4eSEmmanuel Vadot        compatible = "richtek,rt5739";
64fac71e4eSEmmanuel Vadot        reg = <0x50>;
65fac71e4eSEmmanuel Vadot        enable-gpios = <&gpio26 1 GPIO_ACTIVE_HIGH>;
66fac71e4eSEmmanuel Vadot        richtek,vsel-active-high;
67fac71e4eSEmmanuel Vadot        regulator-name = "richtek,rt5739-buck";
68fac71e4eSEmmanuel Vadot        regulator-min-microvolt = <300000>;
69fac71e4eSEmmanuel Vadot        regulator-max-microvolt = <1300000>;
70fac71e4eSEmmanuel Vadot        regulator-allowed-modes = <0 1>;
71fac71e4eSEmmanuel Vadot        regulator-boot-on;
72fac71e4eSEmmanuel Vadot      };
73fac71e4eSEmmanuel Vadot    };
74