ti,ds90ub953.yaml

  1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
  2%YAML 1.2
  3---
  4$id: http://devicetree.org/schemas/media/i2c/ti,ds90ub953.yaml#
  5$schema: http://devicetree.org/meta-schemas/core.yaml#
  6
  7title: Texas Instruments DS90UB953 FPD-Link III Serializer
  8
  9maintainers:
 10  - Tomi Valkeinen <tomi.valkeinen@ideasonboard.com>
 11
 12description:
 13  The TI DS90UB953 is an FPD-Link III video serializer for MIPI CSI-2.
 14
 15properties:
 16  compatible:
 17    enum:
 18      - ti,ds90ub953-q1
 19      - ti,ds90ub971-q1
 20
 21  '#gpio-cells':
 22    const: 2
 23    description:
 24      First cell is the GPIO pin number, second cell is the flags. The GPIO pin
 25      number must be in range of [0, 3].
 26
 27  gpio-controller: true
 28
 29  clocks:
 30    maxItems: 1
 31    description:
 32      Reference clock connected to the CLKIN pin.
 33
 34  clock-names:
 35    items:
 36      - const: clkin
 37
 38  '#clock-cells':
 39    const: 0
 40
 41  reg:
 42    maxItems: 1
 43    description:
 44      The strap I2C address of the serializer. Can be used by the deserializer
 45      to communicate over back-channel when the forward-channel is not yet
 46      active.
 47
 48  ports:
 49    $ref: /schemas/graph.yaml#/properties/ports
 50
 51    properties:
 52      port@0:
 53        $ref: /schemas/graph.yaml#/$defs/port-base
 54        unevaluatedProperties: false
 55        description: CSI-2 input port
 56
 57        properties:
 58          endpoint:
 59            $ref: /schemas/media/video-interfaces.yaml#
 60            unevaluatedProperties: false
 61
 62            required:
 63              - data-lanes
 64
 65      port@1:
 66        $ref: /schemas/graph.yaml#/properties/port
 67        unevaluatedProperties: false
 68        description: FPD-Link III output port
 69
 70    required:
 71      - port@0
 72      - port@1
 73
 74  i2c:
 75    $ref: /schemas/i2c/i2c-controller.yaml#
 76    unevaluatedProperties: false
 77
 78required:
 79  - compatible
 80  - '#gpio-cells'
 81  - gpio-controller
 82  - '#clock-cells'
 83  - ports
 84
 85additionalProperties: false
 86
 87examples:
 88  - |
 89    #include <dt-bindings/gpio/gpio.h>
 90
 91    link {
 92      #address-cells = <1>;
 93      #size-cells = <0>;
 94
 95      serializer@18 {
 96        compatible = "ti,ds90ub953-q1";
 97        reg = <0x18>;
 98
 99        gpio-controller;
100        #gpio-cells = <2>;
101
102        #clock-cells = <0>;
103
104        ports {
105          #address-cells = <1>;
106          #size-cells = <0>;
107
108          port@0 {
109            reg = <0>;
110            ub953_in: endpoint {
111              clock-lanes = <0>;
112              data-lanes = <1 2 3 4>;
113              remote-endpoint = <&sensor_out>;
114            };
115          };
116
117          port@1 {
118            reg = <1>;
119            endpoint {
120              remote-endpoint = <&deser_fpd_in>;
121            };
122          };
123        };
124
125        i2c {
126          #address-cells = <1>;
127          #size-cells = <0>;
128
129          sensor@1a {
130            compatible = "sony,imx274";
131            reg = <0x1a>;
132
133            reset-gpios = <&serializer 0 GPIO_ACTIVE_LOW>;
134
135            clocks = <&serializer>;
136            clock-names = "inck";
137
138            port {
139              sensor_out: endpoint {
140                remote-endpoint = <&ub953_in>;
141              };
142            };
143          };
144        };
145      };
146    };
147...