bindings/mfd/richtek%2Crt4831.yaml

0001 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
0002 %YAML 1.2
0003 ---
0004 $id: http://devicetree.org/schemas/mfd/richtek,rt4831.yaml#
0005 $schema: http://devicetree.org/meta-schemas/core.yaml#
0006
0007 title: Richtek RT4831 DSV and Backlight Integrated IC
0008
0009 maintainers:
0010   - ChiYuan Huang <cy_huang@richtek.com>
0011
0012 description: |
0013   RT4831 is a multifunctional device that can provide power to the LCD display
0014   and LCD backlight.
0015
0016   For Display Bias Voltage DSVP and DSVN, the output range is about 4V to 6.5V.
0017   It's sufficient to meet the current LCD power requirement.
0018
0019   For the LCD backlight, it can provide four channel WLED driving capability.
0020   Each channel driving current is up to 30mA
0021
0022   Datasheet is available at
0023   https://www.richtek.com/assets/product_file/RT4831A/DS4831A-05.pdf
0024
0025 properties:
0026   compatible:
0027     const: richtek,rt4831
0028
0029   reg:
0030     description: I2C device address.
0031     maxItems: 1
0032
0033   enable-gpios:
0034     description: |
0035       GPIO to enable/disable the chip. It is optional.
0036       Some usage directly tied this pin to follow VIO 1.8V power on sequence.
0037     maxItems: 1
0038
0039   regulators:
0040     $ref: ../regulator/richtek,rt4831-regulator.yaml
0041
0042   backlight:
0043     $ref: ../leds/backlight/richtek,rt4831-backlight.yaml
0044
0045 required:
0046   - compatible
0047   - reg
0048
0049 additionalProperties: false
0050
0051 examples:
0052   - |
0053     #include <dt-bindings/leds/rt4831-backlight.h>
0054     i2c {
0055       #address-cells = <1>;
0056       #size-cells = <0>;
0057
0058       rt4831@11 {
0059         compatible = "richtek,rt4831";
0060         reg = <0x11>;
0061
0062         regulators {
0063           DSVLCM {
0064             regulator-min-microvolt = <4000000>;
0065             regulator-max-microvolt = <7150000>;
0066             regulator-allow-bypass;
0067           };
0068           DSVP {
0069             regulator-name = "rt4831-dsvp";
0070             regulator-min-microvolt = <4000000>;
0071             regulator-max-microvolt = <6500000>;
0072             regulator-boot-on;
0073           };
0074           DSVN {
0075             regulator-name = "rt4831-dsvn";
0076             regulator-min-microvolt = <4000000>;
0077             regulator-max-microvolt = <6500000>;
0078             regulator-boot-on;
0079           };
0080         };
0081
0082         backlight {
0083           compatible = "richtek,rt4831-backlight";
0084           default-brightness = <1024>;
0085           max-brightness = <2048>;
0086           richtek,bled-ovp-sel = /bits/ 8 <RT4831_BLOVPLVL_21V>;
0087           richtek,channel-use = /bits/ 8 <RT4831_BLED_ALLCHEN>;
0088         };
0089       };
0090     };