1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 # Copyright (C) 2024 Collabora Ltd.
3 %YAML 1.2
4 ---
5 $id: http://devicetree.org/schemas/media/i2c/maxim,max96717.yaml#
6 $schema: http://devicetree.org/meta-schemas/core.yaml#
7
8 title: MAX96717 CSI-2 to GMSL2 Serializer
9
10 maintainers:
11 - Julien Massot <julien.massot@collabora.com>
12
13 description:
14 The MAX96717 serializer converts MIPI CSI-2 D-PHY formatted input
15 into GMSL2 serial outputs. The device allows the GMSL2 link to
16 simultaneously transmit bidirectional control-channel data while forward
17 video transmissions are in progress. The MAX96717 can connect to one
18 remotely located deserializer using industry-standard coax or STP
19 interconnects. The device cans operate in pixel or tunnel mode. In pixel mode
20 the MAX96717 can select the MIPI datatype, while the tunnel mode forward all the MIPI
21 data received by the serializer.
22 The MAX96717 supports Reference Over Reverse (channel),
23 to generate a clock output for the sensor from the GMSL reverse channel.
24
25 The GMSL2 serial link operates at a fixed rate of 3Gbps or 6Gbps in the
26 forward direction and 187.5Mbps in the reverse direction.
27 MAX96717F only supports a fixed rate of 3Gbps in the forward direction.
28
29 properties:
30 compatible:
31 oneOf:
32 - const: maxim,max96717f
33 - items:
34 - enum:
35 - maxim,max96717
36 - const: maxim,max96717f
37
38 '#gpio-cells':
39 const: 2
40 description:
41 First cell is the GPIO pin number, second cell is the flags. The GPIO pin
42 number must be in range of [0, 10].
43
44 gpio-controller: true
45
46 '#clock-cells':
47 const: 0
48
49 reg:
50 maxItems: 1
51
52 ports:
53 $ref: /schemas/graph.yaml#/properties/ports
54
55 properties:
56 port@0:
57 $ref: /schemas/graph.yaml#/$defs/port-base
58 unevaluatedProperties: false
59 description: CSI-2 Input port
60
61 properties:
62 endpoint:
63 $ref: /schemas/media/video-interfaces.yaml#
64 unevaluatedProperties: false
65
66 properties:
67 data-lanes:
68 minItems: 1
69 maxItems: 4
70
71 lane-polarities:
72 minItems: 1
73 maxItems: 5
74
75 required:
76 - data-lanes
77
78 port@1:
79 $ref: /schemas/graph.yaml#/properties/port
80 unevaluatedProperties: false
81 description: GMSL Output port
82
83 required:
84 - port@1
85
86 i2c-gate:
87 $ref: /schemas/i2c/i2c-gate.yaml
88 unevaluatedProperties: false
89 description:
90 The MAX96717 will forward the I2C requests from the
91 incoming GMSL2 link. Therefore, it supports an i2c-gate
92 subnode to configure a sensor.
93
94 required:
95 - compatible
96 - reg
97 - ports
98
99 additionalProperties: false
100
101 examples:
102 - |
103 #include <dt-bindings/gpio/gpio.h>
104 #include <dt-bindings/media/video-interfaces.h>
105
106 i2c {
107 #address-cells = <1>;
108 #size-cells = <0>;
109 serializer: serializer@40 {
110 compatible = "maxim,max96717f";
111 reg = <0x40>;
112 gpio-controller;
113 #gpio-cells = <2>;
114 #clock-cells = <0>;
115
116 ports {
117 #address-cells = <1>;
118 #size-cells = <0>;
119
120 port@0 {
121 reg = <0>;
122 max96717f_csi_in: endpoint {
123 data-lanes = <1 2 3 4>;
124 remote-endpoint = <&sensor_out>;
125 };
126 };
127
128 port@1 {
129 reg = <1>;
130 max96917f_gmsl_out: endpoint {
131 remote-endpoint = <&deser_gmsl_in>;
132 };
133 };
134 };
135
136 i2c-gate {
137 #address-cells = <1>;
138 #size-cells = <0>;
139 sensor@10 {
140 compatible = "st,st-vgxy61";
141 reg = <0x10>;
142 reset-gpios = <&serializer 0 GPIO_ACTIVE_LOW>;
143 clocks = <&serializer>;
144 VCORE-supply = <&v1v2>;
145 VDDIO-supply = <&v1v8>;
146 VANA-supply = <&v2v8>;
147 port {
148 sensor_out: endpoint {
149 data-lanes = <1 2 3 4>;
150 remote-endpoint = <&max96717f_csi_in>;
151 };
152 };
153 };
154 };
155 };
156 };
157 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.