xref: /linux/Documentation/devicetree/bindings/media/renesas,csi2.yaml (revision 8c994eff8fcfe8ecb1f1dbebed25b4d7bb75be12) 
1# SPDX-License-Identifier: GPL-2.0-only
2# Copyright (C) 2020 Renesas Electronics Corp.
3%YAML 1.2
4---
5$id: http://devicetree.org/schemas/media/renesas,csi2.yaml#
6$schema: http://devicetree.org/meta-schemas/core.yaml#
7
8title: Renesas R-Car MIPI CSI-2 receiver
9
10maintainers:
11  - Niklas Söderlund <niklas.soderlund@ragnatech.se>
12
13description:
14  The R-Car CSI-2 receiver device provides MIPI CSI-2 capabilities for the
15  Renesas R-Car and RZ/G2 family of devices. It is used in conjunction with the
16  R-Car VIN module, which provides the video capture capabilities.
17
18properties:
19  compatible:
20    items:
21      - enum:
22          - renesas,r8a774a1-csi2 # RZ/G2M
23          - renesas,r8a774b1-csi2 # RZ/G2N
24          - renesas,r8a774c0-csi2 # RZ/G2E
25          - renesas,r8a774e1-csi2 # RZ/G2H
26          - renesas,r8a7795-csi2  # R-Car H3
27          - renesas,r8a7796-csi2  # R-Car M3-W
28          - renesas,r8a77961-csi2 # R-Car M3-W+
29          - renesas,r8a77965-csi2 # R-Car M3-N
30          - renesas,r8a77970-csi2 # R-Car V3M
31          - renesas,r8a77980-csi2 # R-Car V3H
32          - renesas,r8a77990-csi2 # R-Car E3
33          - renesas,r8a779a0-csi2 # R-Car V3U
34          - renesas,r8a779g0-csi2 # R-Car V4H
35
36  reg:
37    maxItems: 1
38
39  interrupts:
40    maxItems: 1
41
42  clocks:
43    maxItems: 1
44
45  power-domains:
46    maxItems: 1
47
48  resets:
49    maxItems: 1
50
51  ports:
52    $ref: /schemas/graph.yaml#/properties/ports
53
54    properties:
55      port@0:
56        $ref: /schemas/graph.yaml#/$defs/port-base
57        unevaluatedProperties: false
58        description:
59          Input port node, single endpoint describing the CSI-2 transmitter.
60
61        properties:
62          endpoint:
63            $ref: video-interfaces.yaml#
64            unevaluatedProperties: false
65
66            properties:
67              clock-lanes:
68                maxItems: 1
69
70              data-lanes:
71                minItems: 1
72                maxItems: 4
73                items:
74                  maximum: 4
75
76            required:
77              - clock-lanes
78              - data-lanes
79
80      port@1:
81        $ref: /schemas/graph.yaml#/properties/port
82        description:
83          Output port node, multiple endpoints describing all the R-Car VIN
84          modules connected the CSI-2 receiver.
85
86    required:
87      - port@0
88      - port@1
89
90required:
91  - compatible
92  - reg
93  - interrupts
94  - clocks
95  - power-domains
96  - resets
97  - ports
98
99additionalProperties: false
100
101examples:
102  - |
103    #include <dt-bindings/clock/r8a7796-cpg-mssr.h>
104    #include <dt-bindings/interrupt-controller/arm-gic.h>
105    #include <dt-bindings/power/r8a7796-sysc.h>
106
107    csi20: csi2@fea80000 {
108            compatible = "renesas,r8a7796-csi2";
109            reg = <0xfea80000 0x10000>;
110            interrupts = <0 184 IRQ_TYPE_LEVEL_HIGH>;
111            clocks = <&cpg CPG_MOD 714>;
112            power-domains = <&sysc R8A7796_PD_ALWAYS_ON>;
113            resets = <&cpg 714>;
114
115            ports {
116                    #address-cells = <1>;
117                    #size-cells = <0>;
118
119                    port@0 {
120                            reg = <0>;
121
122                            csi20_in: endpoint {
123                                    clock-lanes = <0>;
124                                    data-lanes = <1>;
125                                    remote-endpoint = <&adv7482_txb>;
126                            };
127                    };
128
129                    port@1 {
130                            #address-cells = <1>;
131                            #size-cells = <0>;
132
133                            reg = <1>;
134
135                            csi20vin0: endpoint@0 {
136                                    reg = <0>;
137                                    remote-endpoint = <&vin0csi20>;
138                            };
139                            csi20vin1: endpoint@1 {
140                                    reg = <1>;
141                                    remote-endpoint = <&vin1csi20>;
142                            };
143                            csi20vin2: endpoint@2 {
144                                    reg = <2>;
145                                    remote-endpoint = <&vin2csi20>;
146                            };
147                            csi20vin3: endpoint@3 {
148                                    reg = <3>;
149                                    remote-endpoint = <&vin3csi20>;
150                            };
151                            csi20vin4: endpoint@4 {
152                                    reg = <4>;
153                                    remote-endpoint = <&vin4csi20>;
154                            };
155                            csi20vin5: endpoint@5 {
156                                    reg = <5>;
157                                    remote-endpoint = <&vin5csi20>;
158                            };
159                            csi20vin6: endpoint@6 {
160                                    reg = <6>;
161                                    remote-endpoint = <&vin6csi20>;
162                            };
163                            csi20vin7: endpoint@7 {
164                                    reg = <7>;
165                                    remote-endpoint = <&vin7csi20>;
166                            };
167                    };
168            };
169    };
170