158 lines · yaml
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)2# Copyright (C) 2024 Collabora Ltd.3%YAML 1.24---5$id: http://devicetree.org/schemas/media/i2c/maxim,max96717.yaml#6$schema: http://devicetree.org/meta-schemas/core.yaml#7 8title: MAX96717 CSI-2 to GMSL2 Serializer9 10maintainers:11 - Julien Massot <julien.massot@collabora.com>12 13description:14 The MAX96717 serializer converts MIPI CSI-2 D-PHY formatted input15 into GMSL2 serial outputs. The device allows the GMSL2 link to16 simultaneously transmit bidirectional control-channel data while forward17 video transmissions are in progress. The MAX96717 can connect to one18 remotely located deserializer using industry-standard coax or STP19 interconnects. The device cans operate in pixel or tunnel mode. In pixel mode20 the MAX96717 can select the MIPI datatype, while the tunnel mode forward all the MIPI21 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 the26 forward direction and 187.5Mbps in the reverse direction.27 MAX96717F only supports a fixed rate of 3Gbps in the forward direction.28 29properties:30 compatible:31 oneOf:32 - const: maxim,max96717f33 - items:34 - enum:35 - maxim,max9671736 - const: maxim,max96717f37 38 '#gpio-cells':39 const: 240 description:41 First cell is the GPIO pin number, second cell is the flags. The GPIO pin42 number must be in range of [0, 10].43 44 gpio-controller: true45 46 '#clock-cells':47 const: 048 49 reg:50 maxItems: 151 52 ports:53 $ref: /schemas/graph.yaml#/properties/ports54 55 properties:56 port@0:57 $ref: /schemas/graph.yaml#/$defs/port-base58 unevaluatedProperties: false59 description: CSI-2 Input port60 61 properties:62 endpoint:63 $ref: /schemas/media/video-interfaces.yaml#64 unevaluatedProperties: false65 66 properties:67 data-lanes:68 minItems: 169 maxItems: 470 71 lane-polarities:72 minItems: 173 maxItems: 574 75 required:76 - data-lanes77 78 port@1:79 $ref: /schemas/graph.yaml#/properties/port80 unevaluatedProperties: false81 description: GMSL Output port82 83 required:84 - port@185 86 i2c-gate:87 $ref: /schemas/i2c/i2c-gate.yaml88 unevaluatedProperties: false89 description:90 The MAX96717 will forward the I2C requests from the91 incoming GMSL2 link. Therefore, it supports an i2c-gate92 subnode to configure a sensor.93 94required:95 - compatible96 - reg97 - ports98 99additionalProperties: false100 101examples: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...158