Documentation/devicetree/bindings/mfd/richtek,rt4831.yaml

   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
   7 title: Richtek RT4831 DSV and Backlight Integrated IC
   8
   9 maintainers:
  10   - ChiYuan Huang <cy_huang@richtek.com>
  11
  12 description: |
  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
  25 properties:
  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
  45 required:
  46   - compatible
  47   - reg
  48
  49 additionalProperties: false
  50
  51 examples:
  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     };