xref: /freebsd/sys/contrib/device-tree/Bindings/regulator/richtek,rt4801-regulator.yaml (revision 924226fba12cc9a228c73b956e1b7fa24c60b055) 
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,rt4801-regulator.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Richtek RT4801 Display Bias regulators
8
9maintainers:
10  - ChiYuan Huang <cy_huang@richtek.com>
11
12description: |
13  Regulator nodes should be named to DSVP and DSVN. The
14  definition for each of these nodes is defined using the standard
15  binding for regulators at
16  Documentation/devicetree/bindings/regulator/regulator.txt.
17  Datasheet is available at
18  https://www.richtek.com/assets/product_file/RT4801H/DS4801H-00.pdf
19
20#The valid names for RT4801 regulator nodes are:
21#DSVP, DSVN
22
23properties:
24  compatible:
25    enum:
26      - richtek,rt4801
27
28  reg:
29    maxItems: 1
30
31  enable-gpios:
32    description: GPIOs to use to enable DSVP/DSVN regulator.
33      The first one is ENP to enable DSVP, and second one is ENM to enable DSVN.
34      Number of GPIO in the array list could be 1 or 2.
35      If only one gpio is specified, only one gpio used to control ENP/ENM.
36      Else both are spefied, DSVP/DSVN could be controlled individually.
37      Othersie, this property not specified. treat both as always-on regulator.
38    minItems: 1
39    maxItems: 2
40
41patternProperties:
42  "^DSV(P|N)$":
43    type: object
44    $ref: regulator.yaml#
45    description:
46      Properties for single display bias regulator.
47
48required:
49  - compatible
50  - reg
51
52additionalProperties: false
53
54examples:
55  - |
56    i2c {
57        #address-cells = <1>;
58        #size-cells = <0>;
59
60        rt4801@73 {
61            compatible = "richtek,rt4801";
62            reg = <0x73>;
63            enable-gpios = <&gpio26 2 0>, <&gpio26 3 0>;
64
65            dsvp: DSVP {
66                regulator-name = "rt4801,dsvp";
67                regulator-min-microvolt = <4000000>;
68                regulator-max-microvolt = <6000000>;
69                regulator-boot-on;
70            };
71            dsvn: DSVN {
72                regulator-name = "rt4801,dsvn";
73                regulator-min-microvolt = <4000000>;
74                regulator-max-microvolt = <6000000>;
75                regulator-boot-on;
76            };
77
78        };
79    };
80