target/linux/bcm27xx/patches-5.15/950-0229-dt-bindings-media-i2c-Add-IMX477-CMOS-sensor-binding.patch

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