xref: /linux/Documentation/devicetree/bindings/regulator/richtek,rt5739.yaml (revision a23e1966932464e1c5226cb9ac4ce1d5fc10ba22)
12e238605SChiYuan Huang# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
22e238605SChiYuan Huang%YAML 1.2
32e238605SChiYuan Huang---
42e238605SChiYuan Huang$id: http://devicetree.org/schemas/regulator/richtek,rt5739.yaml#
52e238605SChiYuan Huang$schema: http://devicetree.org/meta-schemas/core.yaml#
62e238605SChiYuan Huang
72e238605SChiYuan Huangtitle: Richtek RT5739 Step-Down Buck Converter
82e238605SChiYuan Huang
92e238605SChiYuan Huangmaintainers:
102e238605SChiYuan Huang  - ChiYuan Huang <cy_huang@richtek.com>
112e238605SChiYuan Huang
122e238605SChiYuan Huangdescription: |
132e238605SChiYuan Huang  The RT5739 is a step-down switching buck converter that can deliver the
142e238605SChiYuan Huang  programmable output voltage from 300mV to 1300mV with wide input voltage
152e238605SChiYuan Huang  supply of 2.5V to 5.5V. It can provide up to 3.5A continuous current
162e238605SChiYuan Huang  capability at over 80% high efficiency.
172e238605SChiYuan Huang
182e238605SChiYuan HuangallOf:
192e238605SChiYuan Huang  - $ref: regulator.yaml#
202e238605SChiYuan Huang
212e238605SChiYuan Huangproperties:
222e238605SChiYuan Huang  compatible:
232e238605SChiYuan Huang    enum:
248978af5eSChiYuan Huang      - richtek,rt5733
252e238605SChiYuan Huang      - richtek,rt5739
262e238605SChiYuan Huang
272e238605SChiYuan Huang  reg:
282e238605SChiYuan Huang    maxItems: 1
292e238605SChiYuan Huang
302e238605SChiYuan Huang  enable-gpios:
312e238605SChiYuan Huang    maxItems: 1
322e238605SChiYuan Huang
332e238605SChiYuan Huang  richtek,vsel-active-high:
342e238605SChiYuan Huang    description: |
352e238605SChiYuan Huang      If property is present, use the 'VSEL1' register group for buck control.
362e238605SChiYuan Huang      Else, use the 'VSEL0' register group. This depends on external hardware
372e238605SChiYuan Huang      'VSEL' pin connection.
382e238605SChiYuan Huang    type: boolean
392e238605SChiYuan Huang
402e238605SChiYuan Huang  regulator-allowed-modes:
412e238605SChiYuan Huang    description: |
422e238605SChiYuan Huang      buck allowed operating mode
432e238605SChiYuan Huang        0: Auto PFM/PWM mode
442e238605SChiYuan Huang        1: Forced PWM mode
452e238605SChiYuan Huang    items:
462e238605SChiYuan Huang      enum: [0, 1]
472e238605SChiYuan Huang
482e238605SChiYuan Huangrequired:
492e238605SChiYuan Huang  - compatible
502e238605SChiYuan Huang  - reg
512e238605SChiYuan Huang
522e238605SChiYuan HuangunevaluatedProperties: false
532e238605SChiYuan Huang
542e238605SChiYuan Huangexamples:
552e238605SChiYuan Huang  - |
562e238605SChiYuan Huang    #include <dt-bindings/gpio/gpio.h>
572e238605SChiYuan Huang
582e238605SChiYuan Huang    i2c {
592e238605SChiYuan Huang      #address-cells = <1>;
602e238605SChiYuan Huang      #size-cells = <0>;
612e238605SChiYuan Huang
622e238605SChiYuan Huang      regulator@50 {
632e238605SChiYuan Huang        compatible = "richtek,rt5739";
642e238605SChiYuan Huang        reg = <0x50>;
652e238605SChiYuan Huang        enable-gpios = <&gpio26 1 GPIO_ACTIVE_HIGH>;
662e238605SChiYuan Huang        richtek,vsel-active-high;
672e238605SChiYuan Huang        regulator-name = "richtek,rt5739-buck";
682e238605SChiYuan Huang        regulator-min-microvolt = <300000>;
692e238605SChiYuan Huang        regulator-max-microvolt = <1300000>;
702e238605SChiYuan Huang        regulator-allowed-modes = <0 1>;
712e238605SChiYuan Huang        regulator-boot-on;
722e238605SChiYuan Huang      };
732e238605SChiYuan Huang    };
74