1 # SPDX-License-Identifier: (GPL-2.0-only OR BS 1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/display/med 4 $id: http://devicetree.org/schemas/display/mediatek/mediatek,aal.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Mediatek display adaptive ambient light 7 title: Mediatek display adaptive ambient light processor
8 8
9 maintainers: 9 maintainers:
10 - Chun-Kuang Hu <chunkuang.hu@kernel.org> 10 - Chun-Kuang Hu <chunkuang.hu@kernel.org>
11 - Philipp Zabel <p.zabel@pengutronix.de> 11 - Philipp Zabel <p.zabel@pengutronix.de>
12 12
13 description: | 13 description: |
14 Mediatek display adaptive ambient light proc 14 Mediatek display adaptive ambient light processor, namely AAL,
15 is responsible for backlight power saving an 15 is responsible for backlight power saving and sunlight visibility improving.
16 AAL device node must be siblings to the cent 16 AAL device node must be siblings to the central MMSYS_CONFIG node.
17 For a description of the MMSYS_CONFIG bindin 17 For a description of the MMSYS_CONFIG binding, see
18 Documentation/devicetree/bindings/arm/mediat 18 Documentation/devicetree/bindings/arm/mediatek/mediatek,mmsys.yaml
19 for details. 19 for details.
20 20
21 properties: 21 properties:
22 compatible: 22 compatible:
23 oneOf: 23 oneOf:
24 - enum: 24 - enum:
25 - mediatek,mt8173-disp-aal 25 - mediatek,mt8173-disp-aal
26 - mediatek,mt8183-disp-aal 26 - mediatek,mt8183-disp-aal
27 - mediatek,mt8195-mdp3-aal 27 - mediatek,mt8195-mdp3-aal
28 - items: 28 - items:
29 - enum: 29 - enum:
30 - mediatek,mt2712-disp-aal 30 - mediatek,mt2712-disp-aal
31 - mediatek,mt6795-disp-aal 31 - mediatek,mt6795-disp-aal
32 - const: mediatek,mt8173-disp-aal 32 - const: mediatek,mt8173-disp-aal
33 - items: 33 - items:
34 - enum: 34 - enum:
35 - mediatek,mt8186-disp-aal 35 - mediatek,mt8186-disp-aal
36 - mediatek,mt8188-disp-aal 36 - mediatek,mt8188-disp-aal
37 - mediatek,mt8192-disp-aal 37 - mediatek,mt8192-disp-aal
38 - mediatek,mt8195-disp-aal 38 - mediatek,mt8195-disp-aal
39 - mediatek,mt8365-disp-aal 39 - mediatek,mt8365-disp-aal
40 - const: mediatek,mt8183-disp-aal 40 - const: mediatek,mt8183-disp-aal
41 41
42 reg: 42 reg:
43 maxItems: 1 43 maxItems: 1
44 44
45 interrupts: 45 interrupts:
46 maxItems: 1 46 maxItems: 1
47 47
48 power-domains: 48 power-domains:
49 description: A phandle and PM domain speci 49 description: A phandle and PM domain specifier as defined by bindings of
50 the power controller specified by phandl 50 the power controller specified by phandle. See
51 Documentation/devicetree/bindings/power/ 51 Documentation/devicetree/bindings/power/power-domain.yaml for details.
52 52
53 clocks: 53 clocks:
54 items: 54 items:
55 - description: AAL Clock 55 - description: AAL Clock
56 56
57 mediatek,gce-client-reg: 57 mediatek,gce-client-reg:
58 description: The register of client driver 58 description: The register of client driver can be configured by gce with
59 4 arguments defined in this property, su 59 4 arguments defined in this property, such as phandle of gce, subsys id,
60 register offset and size. Each GCE subsy 60 register offset and size. Each GCE subsys id is mapping to a client
61 defined in the header include/dt-binding 61 defined in the header include/dt-bindings/gce/<chip>-gce.h.
62 $ref: /schemas/types.yaml#/definitions/pha 62 $ref: /schemas/types.yaml#/definitions/phandle-array
63 maxItems: 1 63 maxItems: 1
64 64
65 required: 65 required:
66 - compatible 66 - compatible
67 - reg 67 - reg
68 - interrupts 68 - interrupts
69 - power-domains 69 - power-domains
70 - clocks 70 - clocks
71 71
72 additionalProperties: false 72 additionalProperties: false
73 73
74 examples: 74 examples:
75 - | 75 - |
76 #include <dt-bindings/interrupt-controller 76 #include <dt-bindings/interrupt-controller/arm-gic.h>
77 #include <dt-bindings/clock/mt8173-clk.h> 77 #include <dt-bindings/clock/mt8173-clk.h>
78 #include <dt-bindings/power/mt8173-power.h 78 #include <dt-bindings/power/mt8173-power.h>
79 #include <dt-bindings/gce/mt8173-gce.h> 79 #include <dt-bindings/gce/mt8173-gce.h>
80 80
81 soc { 81 soc {
82 #address-cells = <2>; 82 #address-cells = <2>;
83 #size-cells = <2>; 83 #size-cells = <2>;
84 84
85 aal@14015000 { 85 aal@14015000 {
86 compatible = "mediatek,mt8173-disp- 86 compatible = "mediatek,mt8173-disp-aal";
87 reg = <0 0x14015000 0 0x1000>; 87 reg = <0 0x14015000 0 0x1000>;
88 interrupts = <GIC_SPI 189 IRQ_TYPE_ 88 interrupts = <GIC_SPI 189 IRQ_TYPE_LEVEL_LOW>;
89 power-domains = <&scpsys MT8173_POW 89 power-domains = <&scpsys MT8173_POWER_DOMAIN_MM>;
90 clocks = <&mmsys CLK_MM_DISP_AAL>; 90 clocks = <&mmsys CLK_MM_DISP_AAL>;
91 mediatek,gce-client-reg = <&gce SUB 91 mediatek,gce-client-reg = <&gce SUBSYS_1401XXXX 0x5000 0x1000>;
92 }; 92 };
93 }; 93 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.