Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

media: dt-binding: mediatek: add bindings for MediaTek CCORR and WDMA

This patch adds DT binding documentation for MediaTek's CCORR and
WDMA components.
These components exist in both MediaTek's Media Data Path 3(MDP3) and DRM,
and the bindings are placed under the folder "./soc/mediatek" to prevent
duplicate builds.

Signed-off-by: Moudy Ho <moudy.ho@mediatek.com>
Reviewed-by: Rob Herring <robh@kernel.org>
Reviewed-by: AngeloGioacchino Del Regno <angelogioacchino.delregno@collabora.com>
Signed-off-by: Hans Verkuil <hverkuil-cisco@xs4all.nl>
Signed-off-by: Mauro Carvalho Chehab <mchehab@kernel.org>

authored by

Moudy Ho and committed by
Mauro Carvalho Chehab
8bbdead4 4ad7b396

+149
+68
Documentation/devicetree/bindings/soc/mediatek/mediatek,ccorr.yaml
··· 1 + # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/soc/mediatek/mediatek,ccorr.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: MediaTek color correction 8 + 9 + maintainers: 10 + - Matthias Brugger <matthias.bgg@gmail.com> 11 + - Moudy Ho <moudy.ho@mediatek.com> 12 + 13 + description: | 14 + MediaTek color correction with 3X3 matrix. 15 + 16 + properties: 17 + compatible: 18 + items: 19 + - enum: 20 + - mediatek,mt8183-mdp3-ccorr 21 + 22 + reg: 23 + maxItems: 1 24 + 25 + mediatek,gce-client-reg: 26 + $ref: /schemas/types.yaml#/definitions/phandle-array 27 + items: 28 + items: 29 + - description: phandle of GCE 30 + - description: GCE subsys id 31 + - description: register offset 32 + - description: register size 33 + description: The register of client driver can be configured by gce with 34 + 4 arguments defined in this property. Each GCE subsys id is mapping to 35 + a client defined in the header include/dt-bindings/gce/<chip>-gce.h. 36 + 37 + mediatek,gce-events: 38 + description: 39 + The event id which is mapping to the specific hardware event signal 40 + to gce. The event id is defined in the gce header 41 + include/dt-bindings/gce/<chip>-gce.h of each chips. 42 + $ref: /schemas/types.yaml#/definitions/uint32-array 43 + 44 + clocks: 45 + minItems: 1 46 + 47 + required: 48 + - compatible 49 + - reg 50 + - mediatek,gce-client-reg 51 + - mediatek,gce-events 52 + - clocks 53 + 54 + additionalProperties: false 55 + 56 + examples: 57 + - | 58 + #include <dt-bindings/clock/mt8183-clk.h> 59 + #include <dt-bindings/gce/mt8183-gce.h> 60 + 61 + mdp3_ccorr: mdp3-ccorr@1401c000 { 62 + compatible = "mediatek,mt8183-mdp3-ccorr"; 63 + reg = <0x1401c000 0x1000>; 64 + mediatek,gce-client-reg = <&gce SUBSYS_1401XXXX 0xc000 0x1000>; 65 + mediatek,gce-events = <CMDQ_EVENT_MDP_CCORR_SOF>, 66 + <CMDQ_EVENT_MDP_CCORR_EOF>; 67 + clocks = <&mmsys CLK_MM_MDP_CCORR>; 68 + };
+81
Documentation/devicetree/bindings/soc/mediatek/mediatek,wdma.yaml
··· 1 + # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/soc/mediatek/mediatek,wdma.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: MediaTek Write Direct Memory Access 8 + 9 + maintainers: 10 + - Matthias Brugger <matthias.bgg@gmail.com> 11 + - Moudy Ho <moudy.ho@mediatek.com> 12 + 13 + description: | 14 + MediaTek Write Direct Memory Access(WDMA) component used to write 15 + the data into DMA. 16 + 17 + properties: 18 + compatible: 19 + items: 20 + - enum: 21 + - mediatek,mt8183-mdp3-wdma 22 + 23 + reg: 24 + maxItems: 1 25 + 26 + mediatek,gce-client-reg: 27 + $ref: /schemas/types.yaml#/definitions/phandle-array 28 + items: 29 + items: 30 + - description: phandle of GCE 31 + - description: GCE subsys id 32 + - description: register offset 33 + - description: register size 34 + description: The register of client driver can be configured by gce with 35 + 4 arguments defined in this property. Each GCE subsys id is mapping to 36 + a client defined in the header include/dt-bindings/gce/<chip>-gce.h. 37 + 38 + mediatek,gce-events: 39 + description: 40 + The event id which is mapping to the specific hardware event signal 41 + to gce. The event id is defined in the gce header 42 + include/dt-bindings/gce/<chip>-gce.h of each chips. 43 + $ref: /schemas/types.yaml#/definitions/uint32-array 44 + 45 + power-domains: 46 + maxItems: 1 47 + 48 + clocks: 49 + minItems: 1 50 + 51 + iommus: 52 + maxItems: 1 53 + 54 + required: 55 + - compatible 56 + - reg 57 + - mediatek,gce-client-reg 58 + - mediatek,gce-events 59 + - power-domains 60 + - clocks 61 + - iommus 62 + 63 + additionalProperties: false 64 + 65 + examples: 66 + - | 67 + #include <dt-bindings/clock/mt8183-clk.h> 68 + #include <dt-bindings/gce/mt8183-gce.h> 69 + #include <dt-bindings/power/mt8183-power.h> 70 + #include <dt-bindings/memory/mt8183-larb-port.h> 71 + 72 + mdp3_wdma: mdp3-wdma@14006000 { 73 + compatible = "mediatek,mt8183-mdp3-wdma"; 74 + reg = <0x14006000 0x1000>; 75 + mediatek,gce-client-reg = <&gce SUBSYS_1400XXXX 0x6000 0x1000>; 76 + mediatek,gce-events = <CMDQ_EVENT_MDP_WDMA0_SOF>, 77 + <CMDQ_EVENT_MDP_WDMA0_EOF>; 78 + power-domains = <&spm MT8183_POWER_DOMAIN_DISP>; 79 + clocks = <&mmsys CLK_MM_MDP_WDMA0>; 80 + iommus = <&iommu>; 81 + };