target/linux/bcm27xx/patches-6.1/950-0528-dtbindings-media-i2c-Add-IMX708-CMOS-sensor-binding.patch

   1 From 27a49357c8dc582428cc7a7c80b39da157bf3f66 Mon Sep 17 00:00:00 2001
   2 From: Dave Stevenson <dave.stevenson@raspberrypi.com>
   3 Date: Thu, 22 Dec 2022 14:08:35 +0000
   4 Subject: [PATCH] dtbindings: media: i2c: Add IMX708 CMOS sensor
   5  binding
   6
   7 Add YAML devicetree binding for IMX708 CMOS image sensor.
   8 Let's also add a MAINTAINERS entry for the binding and driver.
   9
  10 Signed-off-by: Dave Stevenson <dave.stevenson@raspberrypi.com>
  11 ---
  12  .../devicetree/bindings/media/i2c/imx708.yaml | 119 ++++++++++++++++++
  13  MAINTAINERS                                   |   8 ++
  14  2 files changed, 127 insertions(+)
  15  create mode 100644 Documentation/devicetree/bindings/media/i2c/imx708.yaml
  16
  17 --- /dev/null
  18 +++ b/Documentation/devicetree/bindings/media/i2c/imx708.yaml
  19 @@ -0,0 +1,119 @@
  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/imx708.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 IMX708 is a 1/2.3-inch CMOS active pixel digital image sensor
  33 +  with an active array size of 4608H x 2592V. 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,imx708
  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.1 volts
  52 +
  53 +  VANA1-supply:
  54 +    description:
  55 +      Analog1 voltage supply, 2.8 volts
  56 +
  57 +  VANA2-supply:
  58 +    description:
  59 +      Analog2 voltage supply, 1.8 volts
  60 +
  61 +  VDDL-supply:
  62 +    description:
  63 +      Digital core voltage supply, 1.8 volts
  64 +
  65 +  reset-gpios:
  66 +    description: |-
  67 +      Reference to the GPIO connected to the xclr pin, if any.
  68 +      Must be released (set high) after all supplies and INCK are applied.
  69 +
  70 +  # See ../video-interfaces.txt for more details
  71 +  port:
  72 +    type: object
  73 +    properties:
  74 +      endpoint:
  75 +        type: object
  76 +        properties:
  77 +          data-lanes:
  78 +            description: |-
  79 +              The sensor supports either two-lane, or four-lane operation.
  80 +              For two-lane operation the property must be set to <1 2>.
  81 +            items:
  82 +              - const: 1
  83 +              - const: 2
  84 +
  85 +          clock-noncontinuous:
  86 +            type: boolean
  87 +            description: |-
  88 +              MIPI CSI-2 clock is non-continuous if this property is present,
  89 +              otherwise it's continuous.
  90 +
  91 +          link-frequencies:
  92 +            allOf:
  93 +              - $ref: /schemas/types.yaml#/definitions/uint64-array
  94 +            description:
  95 +              Allowed data bus frequencies.
  96 +
  97 +        required:
  98 +          - link-frequencies
  99 +
 100 +required:
 101 +  - compatible
 102 +  - reg
 103 +  - clocks
 104 +  - VANA1-supply
 105 +  - VANA2-supply
 106 +  - VDIG-supply
 107 +  - VDDL-supply
 108 +  - port
 109 +
 110 +additionalProperties: false
 111 +
 112 +examples:
 113 +  - |
 114 +    i2c0 {
 115 +        #address-cells = <1>;
 116 +        #size-cells = <0>;
 117 +
 118 +        imx708: sensor@1a {
 119 +            compatible = "sony,imx708";
 120 +            reg = <0x1a>;
 121 +            clocks = <&imx708_clk>;
 122 +            VANA1-supply = <&imx708_vana1>; /* 1.8v */
 123 +            VANA2-supply = <&imx708_vana2>; /* 2.8v */
 124 +            VDIG-supply = <&imx708_vdig>;   /* 1.1v */
 125 +            VDDL-supply = <&imx708_vddl>;   /* 1.8v */
 126 +
 127 +            port {
 128 +                imx708_0: endpoint {
 129 +                    remote-endpoint = <&csi1_ep>;
 130 +                    data-lanes = <1 2>;
 131 +                    clock-noncontinuous;
 132 +                    link-frequencies = /bits/ 64 <450000000>;
 133 +                };
 134 +            };
 135 +        };
 136 +    };
 137 +
 138 +...
 139 --- a/MAINTAINERS
 140 +++ b/MAINTAINERS
 141 @@ -19332,6 +19332,14 @@ T:     git git://linuxtv.org/media_tree.git
 142  F:     Documentation/devicetree/bindings/media/i2c/imx519.yaml
 143  F:     drivers/media/i2c/imx519.c
 144
 145 +SONY IMX708 SENSOR DRIVER
 146 +M:     Raspberry Pi Kernel Maintenance <kernel-list@raspberrypi.com>
 147 +L:     linux-media@vger.kernel.org
 148 +S:     Maintained
 149 +T:     git git://linuxtv.org/media_tree.git
 150 +F:     Documentation/devicetree/bindings/media/i2c/imx708.yaml
 151 +F:     drivers/media/i2c/imx708.c
 152 +
 153  SONY MEMORYSTICK SUBSYSTEM
 154  M:     Maxim Levitsky <maximlevitsky@gmail.com>
 155  M:     Alex Dubov <oakad@yahoo.com>