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