xref: /freebsd/sys/contrib/device-tree/Bindings/mfd/richtek,rt4831.yaml (revision 2e3507c25e42292b45a5482e116d278f5515d04d) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/mfd/richtek,rt4831.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Richtek RT4831 DSV and Backlight Integrated IC
8
9maintainers:
10  - ChiYuan Huang <cy_huang@richtek.com>
11
12description: |
13  RT4831 is a multifunctional device that can provide power to the LCD display
14  and LCD backlight.
15
16  For Display Bias Voltage DSVP and DSVN, the output range is about 4V to 6.5V.
17  It's sufficient to meet the current LCD power requirement.
18
19  For the LCD backlight, it can provide four channel WLED driving capability.
20  Each channel driving current is up to 30mA
21
22  Datasheet is available at
23  https://www.richtek.com/assets/product_file/RT4831A/DS4831A-05.pdf
24
25properties:
26  compatible:
27    const: richtek,rt4831
28
29  reg:
30    description: I2C device address.
31    maxItems: 1
32
33  enable-gpios:
34    description: |
35      GPIO to enable/disable the chip. It is optional.
36      Some usage directly tied this pin to follow VIO 1.8V power on sequence.
37    maxItems: 1
38
39  regulators:
40    $ref: ../regulator/richtek,rt4831-regulator.yaml
41
42  backlight:
43    $ref: ../leds/backlight/richtek,rt4831-backlight.yaml
44
45required:
46  - compatible
47  - reg
48
49additionalProperties: false
50
51examples:
52  - |
53    #include <dt-bindings/leds/rt4831-backlight.h>
54    i2c {
55      #address-cells = <1>;
56      #size-cells = <0>;
57
58      rt4831@11 {
59        compatible = "richtek,rt4831";
60        reg = <0x11>;
61
62        regulators {
63          DSVLCM {
64            regulator-min-microvolt = <4000000>;
65            regulator-max-microvolt = <7150000>;
66            regulator-allow-bypass;
67          };
68          DSVP {
69            regulator-name = "rt4831-dsvp";
70            regulator-min-microvolt = <4000000>;
71            regulator-max-microvolt = <6500000>;
72            regulator-boot-on;
73          };
74          DSVN {
75            regulator-name = "rt4831-dsvn";
76            regulator-min-microvolt = <4000000>;
77            regulator-max-microvolt = <6500000>;
78            regulator-boot-on;
79          };
80        };
81
82        backlight {
83          compatible = "richtek,rt4831-backlight";
84          default-brightness = <1024>;
85          max-brightness = <2048>;
86          richtek,bled-ovp-sel = /bits/ 8 <RT4831_BLOVPLVL_21V>;
87          richtek,channel-use = /bits/ 8 <RT4831_BLED_ALLCHEN>;
88        };
89      };
90    };
91