git.openwrt.org Git - openwrt/openwrt.git/blob

   1 From a307b7b21da2c1b61226a5f1b2b56b6582fe7cc4 Mon Sep 17 00:00:00 2001
   2 From: David Plowman <david.plowman@raspberrypi.com>
   3 Date: Tue, 29 Jun 2021 14:38:23 +0100
   4 Subject: [PATCH] Documentation: devicetree: Add documentation for
   5  imx378 sensor
   6
   7 The imx378 sensor is compatible with the imx477 and shares common
   8 device tree settings.
   9
  10 Signed-off-by: David Plowman <david.plowman@raspberrypi.com>
  11 ---
  12  .../devicetree/bindings/media/i2c/imx378.yaml | 113 ++++++++++++++++++
  13  MAINTAINERS                                   |   1 +
  14  2 files changed, 114 insertions(+)
  15  create mode 100644 Documentation/devicetree/bindings/media/i2c/imx378.yaml
  16
  17 --- /dev/null
  18 +++ b/Documentation/devicetree/bindings/media/i2c/imx378.yaml
  19 @@ -0,0 +1,113 @@
  20 +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
  21 +%YAML 1.2
  22 +---
  23 +$id: http://devicetree.org/schemas/media/i2c/imx378.yaml#
  24 +$schema: http://devicetree.org/meta-schemas/core.yaml#
  25 +
  26 +title: Sony 1/2.3-Inch 12Mpixel CMOS Digital Image Sensor
  27 +
  28 +maintainers:
  29 +  - Naushir Patuck <naush@raspberypi.com>
  30 +
  31 +description: |-
  32 +  The Sony IMX378 is a 1/2.3-inch CMOS active pixel digital image sensor
  33 +  with an active array size of 4056H x 3040V. It is programmable through
  34 +  I2C interface. The I2C address is fixed to 0x1A as per sensor data sheet.
  35 +  Image data is sent through MIPI CSI-2, which is configured as either 2 or
  36 +  4 data lanes.
  37 +
  38 +properties:
  39 +  compatible:
  40 +    const: sony,imx378
  41 +
  42 +  reg:
  43 +    description: I2C device address
  44 +    maxItems: 1
  45 +
  46 +  clocks:
  47 +    maxItems: 1
  48 +
  49 +  VDIG-supply:
  50 +    description:
  51 +      Digital I/O voltage supply, 1.05 volts
  52 +
  53 +  VANA-supply:
  54 +    description:
  55 +      Analog voltage supply, 2.8 volts
  56 +
  57 +  VDDL-supply:
  58 +    description:
  59 +      Digital core voltage supply, 1.8 volts
  60 +
  61 +  reset-gpios:
  62 +    description: |-
  63 +      Reference to the GPIO connected to the xclr pin, if any.
  64 +      Must be released (set high) after all supplies and INCK are applied.
  65 +
  66 +  # See ../video-interfaces.txt for more details
  67 +  port:
  68 +    type: object
  69 +    properties:
  70 +      endpoint:
  71 +        type: object
  72 +        properties:
  73 +          data-lanes:
  74 +            description: |-
  75 +              The sensor supports either two-lane, or four-lane operation.
  76 +              For two-lane operation the property must be set to <1 2>.
  77 +            items:
  78 +              - const: 1
  79 +              - const: 2
  80 +
  81 +          clock-noncontinuous:
  82 +            type: boolean
  83 +            description: |-
  84 +              MIPI CSI-2 clock is non-continuous if this property is present,
  85 +              otherwise it's continuous.
  86 +
  87 +          link-frequencies:
  88 +            allOf:
  89 +              - $ref: /schemas/types.yaml#/definitions/uint64-array
  90 +            description:
  91 +              Allowed data bus frequencies.
  92 +
  93 +        required:
  94 +          - link-frequencies
  95 +
  96 +required:
  97 +  - compatible
  98 +  - reg
  99 +  - clocks
 100 +  - VANA-supply
 101 +  - VDIG-supply
 102 +  - VDDL-supply
 103 +  - port
 104 +
 105 +additionalProperties: false
 106 +
 107 +examples:
 108 +  - |
 109 +    i2c0 {
 110 +        #address-cells = <1>;
 111 +        #size-cells = <0>;
 112 +
 113 +        imx378: sensor@10 {
 114 +            compatible = "sony,imx378";
 115 +            reg = <0x1a>;
 116 +            clocks = <&imx378_clk>;
 117 +            VANA-supply = <&imx378_vana>;   /* 2.8v */
 118 +            VDIG-supply = <&imx378_vdig>;   /* 1.05v */
 119 +            VDDL-supply = <&imx378_vddl>;   /* 1.8v */
 120 +
 121 +            port {
 122 +                imx378_0: endpoint {
 123 +                    remote-endpoint = <&csi1_ep>;
 124 +                    data-lanes = <1 2>;
 125 +                    clock-noncontinuous;
 126 +                    link-frequencies = /bits/ 64 <450000000>;
 127 +                };
 128 +            };
 129 +        };
 130 +    };
 131 +
 132 +...
 133 --- a/MAINTAINERS
 134 +++ b/MAINTAINERS
 135 @@ -17539,6 +17539,7 @@ M:      Raspberry Pi Kernel Maintenance <kern
 136  L:     linux-media@vger.kernel.org
 137  S:     Maintained
 138  T:     git git://linuxtv.org/media_tree.git
 139 +F:     Documentation/devicetree/bindings/media/i2c/imx378.yaml
 140  F:     Documentation/devicetree/bindings/media/i2c/imx477.yaml
 141  F:     drivers/media/i2c/imx477.c
 142