xref: /linux/Documentation/devicetree/bindings/leds/backlight/kinetic,ktz8866.yaml (revision c8990c3889ea0a052edcff9dd890a3ab28bc5a47)
1*c8990c38SJianhua Lu# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2*c8990c38SJianhua Lu%YAML 1.2
3*c8990c38SJianhua Lu---
4*c8990c38SJianhua Lu$id: http://devicetree.org/schemas/leds/backlight/kinetic,ktz8866.yaml#
5*c8990c38SJianhua Lu$schema: http://devicetree.org/meta-schemas/core.yaml#
6*c8990c38SJianhua Lu
7*c8990c38SJianhua Lutitle: Kinetic Technologies KTZ8866 backlight
8*c8990c38SJianhua Lu
9*c8990c38SJianhua Lumaintainers:
10*c8990c38SJianhua Lu  - Jianhua Lu <lujianhua000@gmail.com>
11*c8990c38SJianhua Lu
12*c8990c38SJianhua Ludescription: |
13*c8990c38SJianhua Lu  The Kinetic Technologies KTZ8866 is a high efficiency 6-channels-current-sinks
14*c8990c38SJianhua Lu  led backlight with dual lcd bias power.
15*c8990c38SJianhua Lu  https://www.kinet-ic.com/ktz8866/
16*c8990c38SJianhua Lu
17*c8990c38SJianhua LuallOf:
18*c8990c38SJianhua Lu  - $ref: common.yaml#
19*c8990c38SJianhua Lu
20*c8990c38SJianhua Luproperties:
21*c8990c38SJianhua Lu  compatible:
22*c8990c38SJianhua Lu    const: kinetic,ktz8866
23*c8990c38SJianhua Lu
24*c8990c38SJianhua Lu  vddpos-supply:
25*c8990c38SJianhua Lu    description: positive boost supply regulator.
26*c8990c38SJianhua Lu
27*c8990c38SJianhua Lu  vddneg-supply:
28*c8990c38SJianhua Lu    description: negative boost supply regulator.
29*c8990c38SJianhua Lu
30*c8990c38SJianhua Lu  enable-gpios:
31*c8990c38SJianhua Lu    description: GPIO to use to enable/disable the backlight (HWEN pin).
32*c8990c38SJianhua Lu    maxItems: 1
33*c8990c38SJianhua Lu
34*c8990c38SJianhua Lu  current-num-sinks:
35*c8990c38SJianhua Lu    description: number of the LED current sinks' channels.
36*c8990c38SJianhua Lu    enum: [1, 2, 3, 4, 5, 6]
37*c8990c38SJianhua Lu
38*c8990c38SJianhua Lu  kinetic,current-ramp-delay-ms:
39*c8990c38SJianhua Lu    description: |
40*c8990c38SJianhua Lu      LED current ramping delay time in milliseconds, note that the
41*c8990c38SJianhua Lu      case 1 will be mapped to 1μs.
42*c8990c38SJianhua Lu    enum: [1, 2, 4, 8, 16, 32, 64, 128, 192, 256, 320, 384, 448, 512, 576, 640]
43*c8990c38SJianhua Lu
44*c8990c38SJianhua Lu  kinetic,led-enable-ramp-delay-ms:
45*c8990c38SJianhua Lu    description: |
46*c8990c38SJianhua Lu      LED on/off ramping delay time in milliseconds, note that the case 0 will be
47*c8990c38SJianhua Lu      mapped to 512μs because ktz8866 can't ramp faster than it.
48*c8990c38SJianhua Lu    enum: [0, 1, 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024, 2048, 4096, 8192, 16384]
49*c8990c38SJianhua Lu
50*c8990c38SJianhua Lu  kinetic,enable-lcd-bias:
51*c8990c38SJianhua Lu    description: Set if we want to output bias power supply for LCD.
52*c8990c38SJianhua Lu    type: boolean
53*c8990c38SJianhua Lu
54*c8990c38SJianhua Lurequired:
55*c8990c38SJianhua Lu  - compatible
56*c8990c38SJianhua Lu  - vddpos-supply
57*c8990c38SJianhua Lu  - vddneg-supply
58*c8990c38SJianhua Lu  - enable-gpios
59*c8990c38SJianhua Lu
60*c8990c38SJianhua LuunevaluatedProperties: false
61*c8990c38SJianhua Lu
62*c8990c38SJianhua Luexamples:
63*c8990c38SJianhua Lu  - |
64*c8990c38SJianhua Lu    #include <dt-bindings/gpio/gpio.h>
65*c8990c38SJianhua Lu
66*c8990c38SJianhua Lu    backlight {
67*c8990c38SJianhua Lu        compatible = "kinetic,ktz8866";
68*c8990c38SJianhua Lu
69*c8990c38SJianhua Lu        vddpos-supply = <&bl_vddpos_5p5>;
70*c8990c38SJianhua Lu        vddneg-supply = <&bl_vddneg_5p5>;
71*c8990c38SJianhua Lu        enable-gpios = <&tlmm 139 GPIO_ACTIVE_HIGH>;
72*c8990c38SJianhua Lu        current-num-sinks = <5>;
73*c8990c38SJianhua Lu        kinetic,current-ramp-delay-ms = <128>;
74*c8990c38SJianhua Lu        kinetic,led-enable-ramp-delay-ms = <1>;
75*c8990c38SJianhua Lu        kinetic,enable-lcd-bias;
76*c8990c38SJianhua Lu    };
77