soc/mediatek/mediatek%2Cmutex.yaml

1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
3 ---
4 $id: http://devicetree.org/schemas/soc/mediatek/mediatek,mutex.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 title: Mediatek mutex
10   - Chun-Kuang Hu <chunkuang.hu@kernel.org>
11   - Philipp Zabel <p.zabel@pengutronix.de>
14   Mediatek mutex, namely MUTEX, is used to send the triggers signals called
15   Start Of Frame (SOF) / End Of Frame (EOF) to each sub-modules on the display
17   In some SoC, such as mt2701, MUTEX could be a hardware mutex which protects
19   MUTEX device node must be siblings to the central MMSYS_CONFIG node.
27       - mediatek,mt2701-disp-mutex
28       - mediatek,mt2712-disp-mutex
29       - mediatek,mt6795-disp-mutex
30       - mediatek,mt8167-disp-mutex
31       - mediatek,mt8173-disp-mutex
32       - mediatek,mt8183-disp-mutex
33       - mediatek,mt8186-disp-mutex
34       - mediatek,mt8186-mdp3-mutex
35       - mediatek,mt8188-disp-mutex
36       - mediatek,mt8192-disp-mutex
37       - mediatek,mt8195-disp-mutex
38       - mediatek,mt8195-vpp-mutex
39       - mediatek,mt8365-disp-mutex
47   power-domains:
50       Documentation/devicetree/bindings/power/power-domain.yaml for details.
54       - description: MUTEX Clock
56   mediatek,gce-events:
60       include/dt-bindings/gce/<chip>-gce.h of each chips.
61     $ref: /schemas/types.yaml#/definitions/uint32-array
63   mediatek,gce-client-reg:
64     $ref: /schemas/types.yaml#/definitions/phandle-array
67         - description: phandle of GCE
68         - description: GCE subsys id
69         - description: register offset
70         - description: register size
73       a client defined in the header include/dt-bindings/gce/<chip>-gce.h.
76   - if:
81               - mediatek,mt2701-disp-mutex
82               - mediatek,mt2712-disp-mutex
83               - mediatek,mt6795-disp-mutex
84               - mediatek,mt8173-disp-mutex
85               - mediatek,mt8186-disp-mutex
86               - mediatek,mt8186-mdp3-mutex
87               - mediatek,mt8192-disp-mutex
88               - mediatek,mt8195-disp-mutex
91         - clocks
95   - compatible
96   - reg
97   - interrupts
98   - power-domains
103   - |
104     #include <dt-bindings/interrupt-controller/arm-gic.h>
105     #include <dt-bindings/clock/mt8173-clk.h>
106     #include <dt-bindings/power/mt8173-power.h>
107     #include <dt-bindings/gce/mt8173-gce.h>
110         #address-cells = <2>;
111         #size-cells = <2>;
113         mutex: mutex@14020000 {
114             compatible = "mediatek,mt8173-disp-mutex";
117             power-domains = <&spm MT8173_POWER_DOMAIN_MM>;
119             mediatek,gce-events = <CMDQ_EVENT_MUTEX0_STREAM_EOF>,