xref: /openbmc/linux/Documentation/devicetree/bindings/regulator/richtek,rt4803.yaml (revision 1ac731c529cd4d6adbce134754b51ff7d822b145)
1*e126cdaaSChiYuan Huang# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
2*e126cdaaSChiYuan Huang%YAML 1.2
3*e126cdaaSChiYuan Huang---
4*e126cdaaSChiYuan Huang$id: http://devicetree.org/schemas/regulator/richtek,rt4803.yaml#
5*e126cdaaSChiYuan Huang$schema: http://devicetree.org/meta-schemas/core.yaml#
6*e126cdaaSChiYuan Huang
7*e126cdaaSChiYuan Huangtitle: Richtek RT4803 Boost Regulator
8*e126cdaaSChiYuan Huang
9*e126cdaaSChiYuan Huangmaintainers:
10*e126cdaaSChiYuan Huang  - ChiYuan Huang <cy_huang@richtek.com>
11*e126cdaaSChiYuan Huang
12*e126cdaaSChiYuan Huangdescription: |
13*e126cdaaSChiYuan Huang  RT4803 is a boost regulator that's designed to provide the minimum output
14*e126cdaaSChiYuan Huang  voltage, even if the input voltage is lower than the required voltage. It
15*e126cdaaSChiYuan Huang  supports boost and auto bypass mode that depends on the difference between the
16*e126cdaaSChiYuan Huang  input and output voltage. If the input is lower than the output, mode will
17*e126cdaaSChiYuan Huang  transform to boost mode. Otherwise, turn on bypass switch to enter bypass mode.
18*e126cdaaSChiYuan Huang
19*e126cdaaSChiYuan Huang  Datasheet is available at
20*e126cdaaSChiYuan Huang  https://www.richtek.com/assets/product_file/RT4803/DS4803-03.pdf
21*e126cdaaSChiYuan Huang  https://www.richtek.com/assets/product_file/RT4803A/DS4803A-06.pdf
22*e126cdaaSChiYuan Huang
23*e126cdaaSChiYuan HuangallOf:
24*e126cdaaSChiYuan Huang  - $ref: regulator.yaml#
25*e126cdaaSChiYuan Huang
26*e126cdaaSChiYuan Huangproperties:
27*e126cdaaSChiYuan Huang  compatible:
28*e126cdaaSChiYuan Huang    enum:
29*e126cdaaSChiYuan Huang      - richtek,rt4803
30*e126cdaaSChiYuan Huang
31*e126cdaaSChiYuan Huang  reg:
32*e126cdaaSChiYuan Huang    maxItems: 1
33*e126cdaaSChiYuan Huang
34*e126cdaaSChiYuan Huang  richtek,vsel-active-high:
35*e126cdaaSChiYuan Huang    type: boolean
36*e126cdaaSChiYuan Huang    description: Specify the VSEL register group is using when system is active
37*e126cdaaSChiYuan Huang
38*e126cdaaSChiYuan Huang  regulator-allowed-modes:
39*e126cdaaSChiYuan Huang    description: |
40*e126cdaaSChiYuan Huang      Available operating mode
41*e126cdaaSChiYuan Huang        1: Auto PFM/PWM
42*e126cdaaSChiYuan Huang        2: Force PWM
43*e126cdaaSChiYuan Huang    items:
44*e126cdaaSChiYuan Huang      enum: [1, 2]
45*e126cdaaSChiYuan Huang
46*e126cdaaSChiYuan Huangrequired:
47*e126cdaaSChiYuan Huang  - compatible
48*e126cdaaSChiYuan Huang  - reg
49*e126cdaaSChiYuan Huang
50*e126cdaaSChiYuan HuangunevaluatedProperties: false
51*e126cdaaSChiYuan Huang
52*e126cdaaSChiYuan Huangexamples:
53*e126cdaaSChiYuan Huang  - |
54*e126cdaaSChiYuan Huang    i2c {
55*e126cdaaSChiYuan Huang      #address-cells = <1>;
56*e126cdaaSChiYuan Huang      #size-cells = <0>;
57*e126cdaaSChiYuan Huang
58*e126cdaaSChiYuan Huang      regulator@75 {
59*e126cdaaSChiYuan Huang        compatible = "richtek,rt4803";
60*e126cdaaSChiYuan Huang        reg = <0x75>;
61*e126cdaaSChiYuan Huang        richtek,vsel-active-high;
62*e126cdaaSChiYuan Huang        regulator-name = "rt4803-regulator";
63*e126cdaaSChiYuan Huang        regulator-min-microvolt = <2850000>;
64*e126cdaaSChiYuan Huang        regulator-max-microvolt = <4400000>;
65*e126cdaaSChiYuan Huang        regulator-allowed-modes = <1 2>;
66*e126cdaaSChiYuan Huang        regulator-always-on;
67*e126cdaaSChiYuan Huang      };
68*e126cdaaSChiYuan Huang    };
69