xref: /linux/Documentation/devicetree/bindings/media/i2c/imi,rdacm2x-gmsl.yaml (revision 20c7775aecea04d8ca322039969d49dcf568e0e9) 
1# SPDX-License-Identifier: GPL-2.0 OR BSD-2-Clause
2# Copyright (C) 2019 Renesas Electronics Corp.
3%YAML 1.2
4---
5$id: http://devicetree.org/schemas/media/i2c/imi,rdacm2x-gmsl.yaml#
6$schema: http://devicetree.org/meta-schemas/core.yaml#
7
8title: IMI D&D RDACM20 and RDACM21 Automotive Camera Platforms
9
10maintainers:
11  - Jacopo Mondi <jacopo+renesas@jmondi.org>
12  - Kieran Bingham <kieran.bingham+renesas@ideasonboard.com>
13  - Laurent Pinchart <laurent.pinchart+renesas@ideasonboard.com>
14  - Niklas Söderlund <niklas.soderlund+renesas@ragnatech.se>
15
16description: -|
17  The IMI D&D RDACM20 and RDACM21 are GMSL-compatible camera designed for
18  automotive applications.
19
20  The RDACM20 camera module encloses a Maxim Integrated MAX9271 GMSL serializer,
21  coupled with an OV10635 image sensor and an embedded MCU. Both the MCU and
22  the image sensor are connected to the serializer local I2C bus and are
23  accessible by the host SoC by direct addressing.
24
25  The RDACM21 camera module encloses the same serializer, coupled with an
26  OV10640 image sensor and an OV490 ISP. Only the OV490 ISP is interfaced to
27  the serializer local I2C bus while the image sensor is not accessible from
28  the host SoC.
29
30  They both connect to a remote GMSL endpoint through a coaxial cable.
31
32                                                   IMI RDACM20
33  +---------------+                        +--------------------------------+
34  |      GMSL     |   <- Video Stream      |       <- Video--------\        |
35  |               |< === GMSL Link ====== >|MAX9271<- I2C bus-> <-->OV10635 |
36  | de-serializer |   <- I2C messages ->   |                   \<-->MCU     |
37  +---------------+                        +--------------------------------+
38
39                                                   IMI RDACM21
40  +---------------+                        +--------------------------------+
41  |      GMSL     |   <- Video Stream      |       <- Video--------\        |
42  |               |< === GMSL Link ====== >|MAX9271<- I2C bus-> <-->OV490   |
43  |               |   <- I2C messages ->   |                          |     |
44  | de-serializer |                        |          OV10640 <-------|     |
45  +---------------+                        +--------------------------------+
46
47  Both camera modules serialize video data generated by the embedded camera
48  sensor on the GMSL serial channel to a remote GMSL de-serializer. They also
49  receive and transmit I2C messages encapsulated and transmitted on the GMSL
50  bidirectional control channel.
51
52  All I2C traffic received on the GMSL link not directed to the serializer is
53  propagated on the local I2C bus to the remote device there connected. All the
54  I2C traffic generated on the local I2C bus not directed to the serializer is
55  propagated to the remote de-serializer encapsulated in the GMSL control
56  channel.
57
58  The RDACM20 and RDACM21 DT node should be a direct child of the GMSL
59  deserializer's I2C bus corresponding to the GMSL link that the camera is
60  attached to.
61
62properties:
63  '#address-cells':
64    const: 1
65
66  '#size-cells':
67    const: 0
68
69  compatible:
70    enum:
71      - imi,rdacm20
72      - imi,rdacm21
73
74  reg:
75    description: -|
76      I2C device addresses, the first to be assigned to the serializer, the
77      following ones to be assigned to the remote devices.
78
79      For RDACM20 the second entry of the property is assigned to the
80      OV10635 image sensor and the optional third one to the embedded MCU.
81
82      For RDACM21 the second entry is assigned to the OV490 ISP and the optional
83      third one ignored.
84
85    minItems: 2
86    maxItems: 3
87
88  port:
89    type: object
90    additionalProperties: false
91    description: -|
92      Connection to the remote GMSL endpoint are modelled using the OF graph
93      bindings in accordance with the video interface bindings defined in
94      Documentation/devicetree/bindings/media/video-interfaces.txt.
95
96      The device node contains a single "port" child node with a single
97      "endpoint" sub-device.
98
99    properties:
100      endpoint:
101        type: object
102        additionalProperties: false
103
104        properties:
105          remote-endpoint:
106            description: -|
107              phandle to the remote GMSL endpoint sub-node in the remote node
108              port.
109            maxItems: 1
110
111        required:
112          - remote-endpoint
113
114    required:
115      - endpoint
116
117required:
118  - compatible
119  - reg
120  - port
121
122additionalProperties: false
123
124examples:
125  - |
126    i2c@e66d8000 {
127      #address-cells = <1>;
128      #size-cells = <0>;
129
130      reg = <0 0xe66d8000>;
131
132      camera@31 {
133        compatible = "imi,rdacm20";
134        reg = <0x31>, <0x41>, <0x51>;
135
136        port {
137          rdacm20_out0: endpoint {
138            remote-endpoint = <&max9286_in0>;
139          };
140        };
141      };
142    };
143
144  - |
145    i2c@e66d8000 {
146      #address-cells = <1>;
147      #size-cells = <0>;
148
149      reg = <0 0xe66d8000>;
150
151      camera@31 {
152        compatible = "imi,rdacm21";
153        reg = <0x31>, <0x41>;
154
155        port {
156          rdacm21_out0: endpoint {
157            remote-endpoint = <&max9286_in0>;
158          };
159        };
160      };
161    };
162