Documentation/devicetree/bindings/media/allwinner,sun6i-a31-mipi-csi2.yaml

   1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/media/allwinner,sun6i-a31-mipi-csi2.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Allwinner A31 MIPI CSI-2
   8
   9 maintainers:
  10   - Paul Kocialkowski <paul.kocialkowski@bootlin.com>
  11
  12 properties:
  13   compatible:
  14     oneOf:
  15       - const: allwinner,sun6i-a31-mipi-csi2
  16       - items:
  17           - const: allwinner,sun8i-v3s-mipi-csi2
  18           - const: allwinner,sun6i-a31-mipi-csi2
  19
  20   reg:
  21     maxItems: 1
  22
  23   interrupts:
  24     maxItems: 1
  25
  26   clocks:
  27     items:
  28       - description: Bus Clock
  29       - description: Module Clock
  30
  31   clock-names:
  32     items:
  33       - const: bus
  34       - const: mod
  35
  36   phys:
  37     maxItems: 1
  38     description: MIPI D-PHY
  39
  40   phy-names:
  41     items:
  42       - const: dphy
  43
  44   resets:
  45     maxItems: 1
  46
  47   ports:
  48     $ref: /schemas/graph.yaml#/properties/ports
  49
  50     properties:
  51       port@0:
  52         $ref: /schemas/graph.yaml#/$defs/port-base
  53         description: Input port, connect to a MIPI CSI-2 sensor
  54
  55         properties:
  56           reg:
  57             const: 0
  58
  59           endpoint:
  60             $ref: video-interfaces.yaml#
  61             unevaluatedProperties: false
  62
  63             properties:
  64               data-lanes:
  65                 minItems: 1
  66                 maxItems: 4
  67
  68             required:
  69               - data-lanes
  70
  71         unevaluatedProperties: false
  72
  73       port@1:
  74         $ref: /schemas/graph.yaml#/properties/port
  75         description: Output port, connect to a CSI controller
  76
  77     required:
  78       - port@0
  79       - port@1
  80
  81 required:
  82   - compatible
  83   - reg
  84   - interrupts
  85   - clocks
  86   - clock-names
  87   - phys
  88   - phy-names
  89   - resets
  90   - ports
  91
  92 additionalProperties: false
  93
  94 examples:
  95   - |
  96     #include <dt-bindings/interrupt-controller/arm-gic.h>
  97     #include <dt-bindings/clock/sun8i-v3s-ccu.h>
  98     #include <dt-bindings/reset/sun8i-v3s-ccu.h>
  99
 100     mipi_csi2: csi@1cb1000 {
 101         compatible = "allwinner,sun8i-v3s-mipi-csi2",
 102                      "allwinner,sun6i-a31-mipi-csi2";
 103         reg = <0x01cb1000 0x1000>;
 104         interrupts = <GIC_SPI 90 IRQ_TYPE_LEVEL_HIGH>;
 105         clocks = <&ccu CLK_BUS_CSI>,
 106                  <&ccu CLK_CSI1_SCLK>;
 107         clock-names = "bus", "mod";
 108         resets = <&ccu RST_BUS_CSI>;
 109
 110         phys = <&dphy>;
 111         phy-names = "dphy";
 112
 113         ports {
 114             #address-cells = <1>;
 115             #size-cells = <0>;
 116
 117             mipi_csi2_in: port@0 {
 118                 reg = <0>;
 119
 120                 mipi_csi2_in_ov5648: endpoint {
 121                     data-lanes = <1 2 3 4>;
 122
 123                     remote-endpoint = <&ov5648_out_mipi_csi2>;
 124                 };
 125             };
 126
 127             mipi_csi2_out: port@1 {
 128                 reg = <1>;
 129
 130                 mipi_csi2_out_csi0: endpoint {
 131                     remote-endpoint = <&csi0_in_mipi_csi2>;
 132                 };
 133             };
 134         };
 135     };
 136
 137 ...