xref: /freebsd/sys/contrib/device-tree/Bindings/media/renesas,vsp1.yaml (revision 2e3507c25e42292b45a5482e116d278f5515d04d) 
1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/media/renesas,vsp1.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Renesas VSP Video Processing Engine
8
9maintainers:
10  - Laurent Pinchart <laurent.pinchart@ideasonboard.com>
11
12description:
13  The VSP is a video processing engine that supports up-/down-scaling, alpha
14  blending, color space conversion and various other image processing features.
15  It can be found in the Renesas R-Car Gen2, R-Car Gen3, RZ/G1, and RZ/G2 SoCs.
16
17properties:
18  compatible:
19    oneOf:
20      - enum:
21          - renesas,r9a07g044-vsp2 # RZ/G2L
22          - renesas,vsp1 # R-Car Gen2 and RZ/G1
23          - renesas,vsp2 # R-Car Gen3 and RZ/G2
24      - items:
25          - enum:
26              - renesas,r9a07g054-vsp2    # RZ/V2L
27          - const: renesas,r9a07g044-vsp2 # RZ/G2L fallback
28
29  reg:
30    maxItems: 1
31
32  interrupts:
33    maxItems: 1
34
35  clocks: true
36  clock-names: true
37
38  power-domains:
39    maxItems: 1
40
41  resets:
42    maxItems: 1
43
44  renesas,fcp:
45    $ref: /schemas/types.yaml#/definitions/phandle
46    description:
47      A phandle referencing the FCP that handles memory accesses for the VSP.
48
49required:
50  - compatible
51  - reg
52  - interrupts
53  - clocks
54  - power-domains
55  - resets
56
57additionalProperties: false
58
59allOf:
60  - if:
61      properties:
62        compatible:
63          contains:
64            const: renesas,vsp1
65    then:
66      properties:
67        renesas,fcp: false
68    else:
69      required:
70        - renesas,fcp
71
72  - if:
73      properties:
74        compatible:
75          contains:
76            const: renesas,r9a07g044-vsp2
77    then:
78      properties:
79        clocks:
80          items:
81            - description: Main clock
82            - description: Register access clock
83            - description: Video clock
84        clock-names:
85          items:
86            - const: aclk
87            - const: pclk
88            - const: vclk
89      required:
90        - clock-names
91    else:
92      properties:
93        clocks:
94          maxItems: 1
95        clock-names: false
96
97examples:
98  # R8A7790 (R-Car H2) VSP1-S
99  - |
100    #include <dt-bindings/clock/renesas-cpg-mssr.h>
101    #include <dt-bindings/interrupt-controller/arm-gic.h>
102    #include <dt-bindings/power/r8a7790-sysc.h>
103
104    vsp@fe928000 {
105        compatible = "renesas,vsp1";
106        reg = <0xfe928000 0x8000>;
107        interrupts = <GIC_SPI 267 IRQ_TYPE_LEVEL_HIGH>;
108        clocks = <&cpg CPG_MOD 131>;
109        power-domains = <&sysc R8A7790_PD_ALWAYS_ON>;
110        resets = <&cpg 131>;
111    };
112
113  # R8A77951 (R-Car H3) VSP2-BC
114  - |
115    #include <dt-bindings/clock/renesas-cpg-mssr.h>
116    #include <dt-bindings/interrupt-controller/arm-gic.h>
117    #include <dt-bindings/power/r8a7795-sysc.h>
118
119    vsp@fe920000 {
120        compatible = "renesas,vsp2";
121        reg = <0xfe920000 0x8000>;
122        interrupts = <GIC_SPI 465 IRQ_TYPE_LEVEL_HIGH>;
123        clocks = <&cpg CPG_MOD 624>;
124        power-domains = <&sysc R8A7795_PD_A3VP>;
125        resets = <&cpg 624>;
126
127        renesas,fcp = <&fcpvb1>;
128    };
129...
130