1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 # Copyright (C) 2019 Renesas Electronics Corp.
5 $id: http://devicetree.org/schemas/media/i2c/maxim,max9286.yaml#
6 $schema: http://devicetree.org/meta-schemas/core.yaml#
8 title: Maxim Integrated Quad GMSL Deserializer
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>
17 The MAX9286 deserializer receives video data on up to 4 Gigabit Multimedia
18 Serial Links (GMSL) and outputs them on a CSI-2 D-PHY port using up to 4 data
21 In addition to video data, the GMSL links carry a bidirectional control
22 channel that encapsulates I2C messages. The MAX9286 forwards all I2C traffic
23 not addressed to itself to the other side of the links, where a GMSL
24 serializer will output it on a local I2C bus. In the other direction all I2C
25 traffic received over GMSL by the MAX9286 is output on the local I2C bus.
38 description: I2C device address
42 description: Regulator providing Power over Coax to all the ports
45 description: GPIO connected to the \#PWDN pin with inverted polarity
54 $ref: /schemas/types.yaml#/definitions/uint32
57 The GMSL serial data bus width. This setting is normally controlled by
58 the BWS pin, but may be overridden with this property. The value must
59 match the configuration of the remote serializers.
61 maxim,i2c-remote-bus-hz:
62 enum: [ 8470, 28300, 84700, 105000, 173000, 339000, 533000, 837000 ]
65 The I2C clock frequency for the remote I2C buses. The value must match
66 the configuration of the remote serializers.
68 maxim,reverse-channel-microvolt:
73 Initial amplitude of the reverse control channel, in micro volts.
75 The initial amplitude shall be adjusted to a value compatible with the
76 configuration of the connected remote serializer.
78 Some camera modules (for example RDACM20) include an on-board MCU that
79 pre-programs the embedded serializer with power supply noise immunity
80 (high-threshold) enabled. A typical value of the deserializer's reverse
81 channel amplitude to communicate with pre-programmed serializers is
84 A typical value for the reverse channel amplitude to communicate with
85 a remote serializer whose high-threshold noise immunity is not enabled
89 $ref: /schemas/types.yaml#/definitions/uint32-array
93 Index of the MAX9286 gpio output line (0 or 1) that controls Power over
94 Coax to the cameras and its associated polarity flag.
96 The property accepts an array of two unsigned integers, the first being
97 the gpio line index (0 or 1) and the second being the gpio line polarity
98 flag (GPIO_ACTIVE_HIGH or GPIO_ACTIVE_LOW) as defined in
99 <include/dt-bindings/gpio/gpio.h>.
101 When the remote cameras power is controlled by one of the MAX9286 gpio
102 lines, this property has to be used to specify which line among the two
103 available ones controls the remote camera power enablement.
105 When this property is used it is not possible to register a gpio
106 controller as the gpio lines are controlled directly by the MAX9286 and
107 not available for consumers, nor the 'poc-supply' property should be
111 $ref: /schemas/graph.yaml#/properties/ports
115 $ref: /schemas/graph.yaml#/properties/port
116 description: GMSL Input 0
119 $ref: /schemas/graph.yaml#/properties/port
120 description: GMSL Input 1
123 $ref: /schemas/graph.yaml#/properties/port
124 description: GMSL Input 2
127 $ref: /schemas/graph.yaml#/properties/port
128 description: GMSL Input 3
131 $ref: /schemas/graph.yaml#/$defs/port-base
132 unevaluatedProperties: false
133 description: CSI-2 Output
137 $ref: /schemas/media/video-interfaces.yaml#
138 unevaluatedProperties: false
151 $ref: /schemas/i2c/i2c-mux.yaml#
152 unevaluatedProperties: false
154 Each GMSL link is modelled as a child bus of an i2c bus multiplexer/switch.
159 additionalProperties: false
161 Child node of the i2c bus multiplexer which represents a GMSL link.
162 Each serializer device on the GMSL link remote end is represented with
163 an i2c-mux child node. The MAX9286 chip supports up to 4 GMSL
168 description: The index of the GMSL channel.
178 "^camera@[a-f0-9]+$":
181 The remote camera device, composed by a GMSL serializer and a
182 connected video source.
186 description: The remote device compatible string.
192 The I2C addresses to be assigned to the remote devices through
193 address reprogramming. The number of entries depends on the
194 requirements of the currently connected remote device.
197 $ref: /schemas/graph.yaml#/properties/port
198 description: Connection to the MAX9286 sink.
205 additionalProperties: false
208 "^port[0-3]-poc-supply$":
209 description: Regulator providing Power over Coax for a particular port
218 # Only one way of specifying power supplies is allowed: 'maxim,gpio-poc',
219 # 'poc-supply' or per-port poc-supply. Additionally, if 'maxim,gpio-poc' is
220 # present, then 'gpio-controller' isn't allowed.
227 gpio-controller: false
229 "^port[0-3]-poc-supply$": false
236 "^port[0-3]-poc-supply$": false
238 additionalProperties: false
242 #include <dt-bindings/gpio/gpio.h>
245 #address-cells = <1>;
248 reg = <0 0xe66d8000>;
250 gmsl-deserializer@2c {
251 compatible = "maxim,max9286";
253 poc-supply = <&camera_poc_12v>;
254 enable-gpios = <&gpio 13 GPIO_ACTIVE_HIGH>;
259 maxim,i2c-remote-bus-hz = <339000>;
260 maxim,reverse-channel-microvolt = <170000>;
263 #address-cells = <1>;
269 max9286_in0: endpoint {
270 remote-endpoint = <&rdacm20_out0>;
277 max9286_in1: endpoint {
278 remote-endpoint = <&rdacm20_out1>;
285 max9286_in2: endpoint {
286 remote-endpoint = <&rdacm20_out2>;
293 max9286_in3: endpoint {
294 remote-endpoint = <&rdacm20_out3>;
301 max9286_out: endpoint {
302 data-lanes = <1 2 3 4>;
303 remote-endpoint = <&csi40_in>;
309 #address-cells = <1>;
313 #address-cells = <1>;
318 compatible = "imi,rdacm20";
319 reg = <0x51>, <0x61>;
322 rdacm20_out0: endpoint {
323 remote-endpoint = <&max9286_in0>;
331 #address-cells = <1>;
336 compatible = "imi,rdacm20";
337 reg = <0x52>, <0x62>;
340 rdacm20_out1: endpoint {
341 remote-endpoint = <&max9286_in1>;
348 #address-cells = <1>;
353 compatible = "imi,rdacm20";
354 reg = <0x53>, <0x63>;
357 rdacm20_out2: endpoint {
358 remote-endpoint = <&max9286_in2>;
365 #address-cells = <1>;
370 compatible = "imi,rdacm20";
371 reg = <0x54>, <0x64>;
374 rdacm20_out3: endpoint {
375 remote-endpoint = <&max9286_in3>;
384 * Example of a deserializer that controls the camera Power over Coax
385 * through one of its gpio lines.
387 gmsl-deserializer@6c {
388 compatible = "maxim,max9286";
390 enable-gpios = <&gpio 14 GPIO_ACTIVE_HIGH>;
393 * The remote camera power is controlled by MAX9286 GPIO line #0.
394 * No 'poc-supply' nor 'gpio-controller' are specified.
396 maxim,gpio-poc = <0 GPIO_ACTIVE_LOW>;
399 * Do not describe connections as they're the same as in the previous
403 #address-cells = <1>;
412 #address-cells = <1>;