# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/leds/ti,lm3533.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: TI LM3533 Complete Lighting Power Solution

description: >
  The LM3533 is a complete power source for backlight, keypad, and indicator LEDs
  in smartphone handsets. The high-voltage inductive boost converter provides the
  power for two high voltage series LED strings for display backlight and four low
  voltage control banks for individual LEDs. Additionally, LM3533 features an
  interface for an external light sensor.

  https://www.ti.com/product/LM3533

maintainers:
  - Svyatoslav Ryhel <clamor95@gmail.com>

properties:
  compatible:
    const: ti,lm3533

  reg:
    maxItems: 1

  enable-gpios:
    description: GPIO connected to the HWEN pin.
    maxItems: 1

  vin-supply:
    description: Supply connected to the IN line (2.7 V to 5.5 V).

  '#address-cells':
    const: 1

  '#size-cells':
    const: 0

  ti,boost-ovp-microvolt:
    description: boost OVP select (16V, 24V, 32V, 40V)
    enum: [ 16000000, 24000000, 32000000, 40000000 ]
    default: 16000000

  ti,boost-freq-hz:
    description: boost frequency select (500KHz or 1MHz)
    enum: [ 500000, 1000000 ]
    default: 500000

  light-sensor:
    type: object
    additionalProperties: false

    properties:
      compatible:
        const: ti,lm3533-als

      interrupts:
        maxItems: 1

      ti,resistor-ohms:
        description:
          Internal configuration resistor value when light sensor is in
          Analog Sensor mode and PWM mode is disabled. The expectation is
          the input is a current from the external analog light sensor and
          this is used to convert it to a voltage within the target range.
        minimum: 1575
        maximum: 200000

      ti,pwm-mode:
        type: boolean
        description:
          Switch for mode in which light sensor interface is running. If
          this property is set then the light sensor interface is running
          in PWM mode, internal resistor value is set to high-impedance (0)
          and ti,resistor-ohms property is ignored.

    required:
      - compatible

    oneOf:
      - required:
          - ti,resistor-ohms
      - required:
          - ti,pwm-mode

patternProperties:
  "^backlight@[01]$":
    $ref: /schemas/leds/backlight/ti,lm3533-backlight.yaml#

  "^led@[2-5]$":
    $ref: /schemas/leds/ti,lm3533-leds.yaml#

required:
  - compatible
  - reg
  - '#address-cells'
  - '#size-cells'

additionalProperties: false

examples:
  - |
    #include <dt-bindings/gpio/gpio.h>
    #include <dt-bindings/interrupt-controller/irq.h>

    i2c {
        #address-cells = <1>;
        #size-cells = <0>;

        led-controller@36 {
            compatible = "ti,lm3533";
            reg = <0x36>;

            enable-gpios = <&gpio 110 GPIO_ACTIVE_HIGH>;
            vin-supply = <&vdd_3v3_bat>;

            ti,boost-ovp-microvolt = <24000000>;
            ti,boost-freq-hz = <500000>;

            #address-cells = <1>;
            #size-cells = <0>;

            backlight@0 {
                compatible = "ti,lm3533-backlight";
                reg = <0>;

                default-brightness = <113>;

                led-max-microamp = <23400>;
                led-sources = <0 1>;
            };

            led@2 {
                compatible = "ti,lm3533-leds";
                reg = <2>;

                led-max-microamp = <23400>;
                led-sources = <0 1>;
            };

            led@4 {
                compatible = "ti,lm3533-leds";
                reg = <4>;

                led-max-microamp = <23400>;
                led-sources = <2>;
            };

            led@5 {
                compatible = "ti,lm3533-leds";
                reg = <5>;

                led-max-microamp = <23400>;
                led-sources = <3 4>;
            };

            light-sensor {
                compatible = "ti,lm3533-als";

                interrupt-parent = <&gpio>;
                interrupts = <80 IRQ_TYPE_LEVEL_LOW>;

                ti,pwm-mode;
            };
        };
    };
...