Commit 49ceb031 authored by Ariel D'Alessandro's avatar Ariel D'Alessandro Committed by Rob Herring (Arm)
Browse files

dt-bindings: media: Convert MediaTek mt8173-vpu bindings to DT schema



Convert the existing text-based DT bindings for Mediatek MT8173 Video
Processor Unit to a DT schema.

Signed-off-by: default avatarAriel D'Alessandro <ariel.dalessandro@collabora.com>
Reviewed-by: default avatarAngeloGioacchino Del Regno <angelogioacchino.delregno@collabora.com>
Reviewed-by: default avatarKrzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
[robh: update MAINTAINERS and mediatek-mdp.txt references]
Signed-off-by: default avatarRob Herring (Arm) <robh@kernel.org>
parent 37020f86
Loading
Loading
Loading
Loading
+74 −0
Original line number Diff line number Diff line
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/media/mediatek,mt8173-vpu.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Mediatek MT8173 Video Processor Unit

maintainers:
  - Ariel D'Alessandro <ariel.dalessandro@collabora.com>

description:
  Video Processor Unit is a HW video controller. It controls HW Codec including
  H.264/VP8/VP9 Decode, H.264/VP8 Encode and Image Processor (scale/rotate/color
  convert).

properties:
  compatible:
    const: mediatek,mt8173-vpu

  reg:
    maxItems: 2

  reg-names:
    items:
      - const: tcm
      - const: cfg_reg

  interrupts:
    maxItems: 1

  clocks:
    maxItems: 1

  clock-names:
    items:
      - const: main

  memory-region:
    maxItems: 1

required:
  - compatible
  - reg
  - reg-names
  - interrupts
  - clocks
  - clock-names
  - memory-region

additionalProperties: false

examples:
  - |
    #include <dt-bindings/clock/mt8173-clk.h>
    #include <dt-bindings/interrupt-controller/arm-gic.h>

    soc {
        #address-cells = <2>;
        #size-cells = <2>;

        vpu: vpu@10020000 {
            compatible = "mediatek,mt8173-vpu";
            reg = <0 0x10020000 0 0x30000>,
                  <0 0x10050000 0 0x100>;
            reg-names = "tcm", "cfg_reg";
            interrupts = <GIC_SPI 166 IRQ_TYPE_LEVEL_HIGH>;
            clocks = <&topckgen CLK_TOP_SCP_SEL>;
            clock-names = "main";
            memory-region = <&vpu_dma_reserved>;
        };
    };

...
+2 −1
Original line number Diff line number Diff line
@@ -5,7 +5,8 @@ Media Data Path is used for scaling and color space conversion.
Required properties (controller node):
- compatible: "mediatek,mt8173-mdp"
- mediatek,vpu: the node of video processor unit, see
  Documentation/devicetree/bindings/media/mediatek-vpu.txt for details.
  Documentation/devicetree/bindings/media/mediatek,mt8173-vpu.yaml for 
  details.

Required properties (all function blocks, child node):
- compatible: Should be one of
+0 −31
Original line number Diff line number Diff line
* Mediatek Video Processor Unit

Video Processor Unit is a HW video controller. It controls HW Codec including
H.264/VP8/VP9 Decode, H.264/VP8 Encode and Image Processor (scale/rotate/color convert).

Required properties:
  - compatible: "mediatek,mt8173-vpu"
  - reg: Must contain an entry for each entry in reg-names.
  - reg-names: Must include the following entries:
    "tcm": tcm base
    "cfg_reg": Main configuration registers base
  - interrupts: interrupt number to the cpu.
  - clocks : clock name from clock manager
  - clock-names: must be main. It is the main clock of VPU

Optional properties:
  - memory-region: phandle to a node describing memory (see
    Documentation/devicetree/bindings/reserved-memory/reserved-memory.txt)
    to be used for VPU extended memory; if not present, VPU may be located
    anywhere in the memory

Example:
	vpu: vpu@10020000 {
		compatible = "mediatek,mt8173-vpu";
		reg = <0 0x10020000 0 0x30000>,
		      <0 0x10050000 0 0x100>;
		reg-names = "tcm", "cfg_reg";
		interrupts = <GIC_SPI 166 IRQ_TYPE_LEVEL_HIGH>;
		clocks = <&topckgen TOP_SCP_SEL>;
		clock-names = "main";
	};
+1 −1
Original line number Diff line number Diff line
@@ -15540,7 +15540,7 @@ M: Andrew-CT Chen <andrew-ct.chen@mediatek.com>
M:	Yunfei Dong <yunfei.dong@mediatek.com>
S:	Supported
F:	Documentation/devicetree/bindings/media/mediatek,vcodec*.yaml
F:	Documentation/devicetree/bindings/media/mediatek-vpu.txt
F:	Documentation/devicetree/bindings/media/mediatek,mt8173-vpu.yaml
F:	drivers/media/platform/mediatek/vcodec/
F:	drivers/media/platform/mediatek/vpu/