Commit 65c5fac1 authored by Laurent Pinchart's avatar Laurent Pinchart Committed by Mauro Carvalho Chehab
Browse files

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

parent e80cdf0a
Loading
Loading
Loading
Loading
+0 −34
Original line number Diff line number Diff line
Renesas R-Car Frame Compression Processor (FCP)
-----------------------------------------------

The FCP is a companion module of video processing modules in the Renesas R-Car
Gen3 and RZ/G2 SoCs. It provides data compression and decompression, data
caching, and conversion of AXI transactions in order to reduce the memory
bandwidth.

There are three types of FCP: FCP for Codec (FCPC), FCP for VSP (FCPV) and FCP
for FDP (FCPF). Their configuration and behaviour depend on the module they
are paired with. These DT bindings currently support the FCPV and FCPF.

 - compatible: Must be one or more of the following

   - "renesas,fcpv" for generic compatible 'FCP for VSP'
   - "renesas,fcpf" for generic compatible 'FCP for FDP'

 - reg: the register base and size for the device registers
 - clocks: Reference to the functional clock

Optional properties:
 - power-domains : power-domain property defined with a power domain specifier
		   to respective power domain.


Device node example
-------------------

	fcpvd1: fcp@fea2f000 {
		compatible = "renesas,fcpv";
		reg = <0 0xfea2f000 0 0x200>;
		clocks = <&cpg CPG_MOD 602>;
		power-domains = <&sysc R8A7795_PD_A3VP>;
	};
+56 −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/renesas,fcp.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Renesas R-Car Frame Compression Processor (FCP)

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

description: |
  The FCP is a companion module of video processing modules in the Renesas
  R-Car Gen3 and RZ/G2 SoCs. It provides data compression and decompression,
  data caching, and conversion of AXI transactions in order to reduce the
  memory bandwidth.

  There are three types of FCP: FCP for Codec (FCPC), FCP for VSP (FCPV) and
  FCP for FDP (FCPF). Their configuration and behaviour depend on the module
  they are paired with. These DT bindings currently support the FCPV and FCPF.

properties:
  compatible:
    enum:
      - renesas,fcpv # FCP for VSP
      - renesas,fcpf # FCP for FDP

  reg:
    maxItems: 1

  clocks:
    maxItems: 1

  power-domains:
    maxItems: 1

required:
  - compatible
  - reg
  - clocks

additionalProperties: false

examples:
  # R8A7795 (R-Car H3) FCP for VSP-D1
  - |
    #include <dt-bindings/clock/renesas-cpg-mssr.h>
    #include <dt-bindings/power/r8a7795-sysc.h>

    fcp@fea2f000 {
        compatible = "renesas,fcpv";
        reg = <0xfea2f000 0x200>;
        clocks = <&cpg CPG_MOD 602>;
        power-domains = <&sysc R8A7795_PD_ALWAYS_ON>;
    };
...
+1 −1
Original line number Diff line number Diff line
@@ -10726,7 +10726,7 @@ L: linux-media@vger.kernel.org
L:	linux-renesas-soc@vger.kernel.org
S:	Supported
T:	git git://linuxtv.org/media_tree.git
F:	Documentation/devicetree/bindings/media/renesas,fcp.txt
F:	Documentation/devicetree/bindings/media/renesas,fcp.yaml
F:	drivers/media/platform/rcar-fcp.c
F:	include/media/rcar-fcp.h