media: dt-bindings: media: renesas,vsp1: Convert binding to YAML

* Renesas VSP Video Processing Engine

The VSP is a video processing engine that supports up-/down-scaling, alpha

blending, color space conversion and various other image processing features.

It can be found in the Renesas R-Car Gen2, R-Car Gen3, RZ/G1, and RZ/G2 SoCs.

Required properties:

  - compatible: Must contain one of the following values

    - "renesas,vsp1" for the R-Car Gen2 and RZ/G1 VSP1

    - "renesas,vsp2" for the R-Car Gen3 and RZ/G2 VSP2

  - reg: Base address and length of the registers block for the VSP.

  - interrupts: VSP interrupt specifier.

  - clocks: A phandle + clock-specifier pair for the VSP functional clock.

Optional properties:

  - renesas,fcp: A phandle referencing the FCP that handles memory accesses

                 for the VSP. Not needed on Gen2, mandatory on Gen3.

Example: R8A7790 (R-Car H2) VSP1-S node

	vsp@fe928000 {

		compatible = "renesas,vsp1";

		reg = <0 0xfe928000 0 0x8000>;

		interrupts = <0 267 IRQ_TYPE_LEVEL_HIGH>;

		clocks = <&mstp1_clks R8A7790_CLK_VSP1_S>;

	};

# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/media/renesas,vsp1.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Renesas VSP Video Processing Engine

maintainers:

  - Laurent Pinchart <laurent.pinchart@ideasonboard.com>

description:

  The VSP is a video processing engine that supports up-/down-scaling, alpha

  blending, color space conversion and various other image processing features.

  It can be found in the Renesas R-Car Gen2, R-Car Gen3, RZ/G1, and RZ/G2 SoCs.

properties:

  compatible:

    enum:

      - renesas,vsp1 # R-Car Gen2 and RZ/G1

      - renesas,vsp2 # R-Car Gen3 and RZ/G2

  reg:

    maxItems: 1

  interrupts:

    maxItems: 1

  clocks:

    maxItems: 1

  renesas,fcp:

    $ref: /schemas/types.yaml#/definitions/phandle

    description:

      A phandle referencing the FCP that handles memory accesses for the VSP.

required:

  - compatible

  - reg

  - interrupts

  - clocks

additionalProperties: false

if:

  properties:

    compatible:

      items:

        - const: renesas,vsp1

then:

  properties:

    renesas,fcp: false

else:

  required:

    - renesas,fcp

examples:

  # R8A7790 (R-Car H2) VSP1-S

  - |

    #include <dt-bindings/clock/renesas-cpg-mssr.h>

    #include <dt-bindings/interrupt-controller/arm-gic.h>

    vsp@fe928000 {

        compatible = "renesas,vsp1";

        reg = <0xfe928000 0x8000>;

        interrupts = <GIC_SPI 267 IRQ_TYPE_LEVEL_HIGH>;

        clocks = <&cpg CPG_MOD 131>;

    };

  # R8A77951 (R-Car H3) VSP2-BC

  - |

    #include <dt-bindings/clock/renesas-cpg-mssr.h>

    #include <dt-bindings/interrupt-controller/arm-gic.h>

    vsp@fe920000 {

        compatible = "renesas,vsp2";

        reg = <0xfe920000 0x8000>;

        interrupts = <GIC_SPI 465 IRQ_TYPE_LEVEL_HIGH>;

        clocks = <&cpg CPG_MOD 624>;

        renesas,fcp = <&fcpvb1>;

    };

...

L:	linux-renesas-soc@vger.kernel.org

S:	Supported

T:	git git://linuxtv.org/media_tree.git

F:	Documentation/devicetree/bindings/media/renesas,vsp1.txt

F:	Documentation/devicetree/bindings/media/renesas,vsp1.yaml

F:	drivers/media/platform/vsp1/

MEDIA DRIVERS FOR ST STV0910 DEMODULATOR ICs