xref: /freebsd/sys/contrib/device-tree/Bindings/leds/backlight/apple,dwi-bl.yaml (revision 8ccc0d235c226d84112561d453c49904398d085c)
1*8ccc0d23SEmmanuel Vadot# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2*8ccc0d23SEmmanuel Vadot%YAML 1.2
3*8ccc0d23SEmmanuel Vadot---
4*8ccc0d23SEmmanuel Vadot$id: http://devicetree.org/schemas/leds/backlight/apple,dwi-bl.yaml#
5*8ccc0d23SEmmanuel Vadot$schema: http://devicetree.org/meta-schemas/core.yaml#
6*8ccc0d23SEmmanuel Vadot
7*8ccc0d23SEmmanuel Vadottitle: Apple DWI 2-Wire Interface Backlight Controller
8*8ccc0d23SEmmanuel Vadot
9*8ccc0d23SEmmanuel Vadotmaintainers:
10*8ccc0d23SEmmanuel Vadot  - Nick Chan <towinchenmi@gmail.com>
11*8ccc0d23SEmmanuel Vadot
12*8ccc0d23SEmmanuel Vadotdescription:
13*8ccc0d23SEmmanuel Vadot  Apple SoCs contain a 2-wire interface called DWI. On some Apple iPhones,
14*8ccc0d23SEmmanuel Vadot  iPads and iPod touches with a LCD display, 1-2 backlight controllers
15*8ccc0d23SEmmanuel Vadot  are connected via DWI. Interfacing with DWI controls all backlight
16*8ccc0d23SEmmanuel Vadot  controllers at the same time. As such, the backlight controllers are
17*8ccc0d23SEmmanuel Vadot  treated as a single controller regardless of the underlying
18*8ccc0d23SEmmanuel Vadot  configuration.
19*8ccc0d23SEmmanuel Vadot
20*8ccc0d23SEmmanuel VadotallOf:
21*8ccc0d23SEmmanuel Vadot  - $ref: common.yaml#
22*8ccc0d23SEmmanuel Vadot
23*8ccc0d23SEmmanuel Vadotproperties:
24*8ccc0d23SEmmanuel Vadot  compatible:
25*8ccc0d23SEmmanuel Vadot    items:
26*8ccc0d23SEmmanuel Vadot      - enum:
27*8ccc0d23SEmmanuel Vadot          - apple,s5l8960x-dwi-bl
28*8ccc0d23SEmmanuel Vadot          - apple,t7000-dwi-bl
29*8ccc0d23SEmmanuel Vadot          - apple,s8000-dwi-bl
30*8ccc0d23SEmmanuel Vadot          - apple,t8010-dwi-bl
31*8ccc0d23SEmmanuel Vadot          - apple,t8015-dwi-bl
32*8ccc0d23SEmmanuel Vadot      - const: apple,dwi-bl
33*8ccc0d23SEmmanuel Vadot
34*8ccc0d23SEmmanuel Vadot  reg:
35*8ccc0d23SEmmanuel Vadot    maxItems: 1
36*8ccc0d23SEmmanuel Vadot
37*8ccc0d23SEmmanuel Vadot  power-domains:
38*8ccc0d23SEmmanuel Vadot    maxItems: 1
39*8ccc0d23SEmmanuel Vadot
40*8ccc0d23SEmmanuel Vadotrequired:
41*8ccc0d23SEmmanuel Vadot  - compatible
42*8ccc0d23SEmmanuel Vadot  - reg
43*8ccc0d23SEmmanuel Vadot
44*8ccc0d23SEmmanuel VadotunevaluatedProperties: false
45*8ccc0d23SEmmanuel Vadot
46*8ccc0d23SEmmanuel Vadotexamples:
47*8ccc0d23SEmmanuel Vadot  - |
48*8ccc0d23SEmmanuel Vadot    soc {
49*8ccc0d23SEmmanuel Vadot      #address-cells = <2>;
50*8ccc0d23SEmmanuel Vadot      #size-cells = <2>;
51*8ccc0d23SEmmanuel Vadot
52*8ccc0d23SEmmanuel Vadot      dwi_bl: backlight@20e200010 {
53*8ccc0d23SEmmanuel Vadot        compatible = "apple,s5l8960x-dwi-bl", "apple,dwi-bl";
54*8ccc0d23SEmmanuel Vadot        reg = <0x2 0x0e200010 0x0 0x8>;
55*8ccc0d23SEmmanuel Vadot        power-domains = <&ps_dwi>;
56*8ccc0d23SEmmanuel Vadot      };
57*8ccc0d23SEmmanuel Vadot    };
58