target/linux/bcm27xx/patches-6.1/950-0676-dt-bindings-media-i2c-Replace-IMX708-sensor-binding-.patch

   1 From f3dbbaa2a6c8ddfc22feac62e1fea6310a4fd659 Mon Sep 17 00:00:00 2001
   2 From: Naushir Patuck <naush@raspberrypi.com>
   3 Date: Fri, 31 Mar 2023 11:52:25 +0100
   4 Subject: [PATCH] dt-bindings: media: i2c: Replace IMX708 sensor
   5  binding documentation file
   6
   7 Replace the existing imx708.yaml file with sony,imx708.yaml that follows
   8 the latest devicetree conventions for camera sensors.
   9
  10 Signed-off-by: Naushir Patuck <naush@raspberrypi.com>
  11 ---
  12  .../devicetree/bindings/media/i2c/imx708.yaml | 119 ----------------
  13  .../bindings/media/i2c/sony,imx708.yaml       | 128 ++++++++++++++++++
  14  MAINTAINERS                                   |   2 +-
  15  3 files changed, 129 insertions(+), 120 deletions(-)
  16  delete mode 100644 Documentation/devicetree/bindings/media/i2c/imx708.yaml
  17  create mode 100644 Documentation/devicetree/bindings/media/i2c/sony,imx708.yaml
  18
  19 --- a/Documentation/devicetree/bindings/media/i2c/imx708.yaml
  20 +++ /dev/null
  21 @@ -1,119 +0,0 @@
  22 -# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
  23 -%YAML 1.2
  24 ----
  25 -$id: http://devicetree.org/schemas/media/i2c/imx708.yaml#
  26 -$schema: http://devicetree.org/meta-schemas/core.yaml#
  27 -
  28 -title: Sony 1/2.3-Inch 12Mpixel CMOS Digital Image Sensor
  29 -
  30 -maintainers:
  31 -  - Naushir Patuck <naush@raspberypi.com>
  32 -
  33 -description: |-
  34 -  The Sony IMX708 is a 1/2.3-inch CMOS active pixel digital image sensor
  35 -  with an active array size of 4608H x 2592V. It is programmable through
  36 -  I2C interface. The I2C address is fixed to 0x1A as per sensor data sheet.
  37 -  Image data is sent through MIPI CSI-2, which is configured as either 2 or
  38 -  4 data lanes.
  39 -
  40 -properties:
  41 -  compatible:
  42 -    const: sony,imx708
  43 -
  44 -  reg:
  45 -    description: I2C device address
  46 -    maxItems: 1
  47 -
  48 -  clocks:
  49 -    maxItems: 1
  50 -
  51 -  VDIG-supply:
  52 -    description:
  53 -      Digital I/O voltage supply, 1.1 volts
  54 -
  55 -  VANA1-supply:
  56 -    description:
  57 -      Analog1 voltage supply, 2.8 volts
  58 -
  59 -  VANA2-supply:
  60 -    description:
  61 -      Analog2 voltage supply, 1.8 volts
  62 -
  63 -  VDDL-supply:
  64 -    description:
  65 -      Digital core voltage supply, 1.8 volts
  66 -
  67 -  reset-gpios:
  68 -    description: |-
  69 -      Reference to the GPIO connected to the xclr pin, if any.
  70 -      Must be released (set high) after all supplies and INCK are applied.
  71 -
  72 -  # See ../video-interfaces.txt for more details
  73 -  port:
  74 -    type: object
  75 -    properties:
  76 -      endpoint:
  77 -        type: object
  78 -        properties:
  79 -          data-lanes:
  80 -            description: |-
  81 -              The sensor supports either two-lane, or four-lane operation.
  82 -              For two-lane operation the property must be set to <1 2>.
  83 -            items:
  84 -              - const: 1
  85 -              - const: 2
  86 -
  87 -          clock-noncontinuous:
  88 -            type: boolean
  89 -            description: |-
  90 -              MIPI CSI-2 clock is non-continuous if this property is present,
  91 -              otherwise it's continuous.
  92 -
  93 -          link-frequencies:
  94 -            allOf:
  95 -              - $ref: /schemas/types.yaml#/definitions/uint64-array
  96 -            description:
  97 -              Allowed data bus frequencies.
  98 -
  99 -        required:
 100 -          - link-frequencies
 101 -
 102 -required:
 103 -  - compatible
 104 -  - reg
 105 -  - clocks
 106 -  - VANA1-supply
 107 -  - VANA2-supply
 108 -  - VDIG-supply
 109 -  - VDDL-supply
 110 -  - port
 111 -
 112 -additionalProperties: false
 113 -
 114 -examples:
 115 -  - |
 116 -    i2c0 {
 117 -        #address-cells = <1>;
 118 -        #size-cells = <0>;
 119 -
 120 -        imx708: sensor@1a {
 121 -            compatible = "sony,imx708";
 122 -            reg = <0x1a>;
 123 -            clocks = <&imx708_clk>;
 124 -            VANA1-supply = <&imx708_vana1>; /* 1.8v */
 125 -            VANA2-supply = <&imx708_vana2>; /* 2.8v */
 126 -            VDIG-supply = <&imx708_vdig>;   /* 1.1v */
 127 -            VDDL-supply = <&imx708_vddl>;   /* 1.8v */
 128 -
 129 -            port {
 130 -                imx708_0: endpoint {
 131 -                    remote-endpoint = <&csi1_ep>;
 132 -                    data-lanes = <1 2>;
 133 -                    clock-noncontinuous;
 134 -                    link-frequencies = /bits/ 64 <450000000>;
 135 -                };
 136 -            };
 137 -        };
 138 -    };
 139 -
 140 -...
 141 --- /dev/null
 142 +++ b/Documentation/devicetree/bindings/media/i2c/sony,imx708.yaml
 143 @@ -0,0 +1,128 @@
 144 +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
 145 +%YAML 1.2
 146 +---
 147 +$id: http://devicetree.org/schemas/media/i2c/sony,imx708.yaml#
 148 +$schema: http://devicetree.org/meta-schemas/core.yaml#
 149 +
 150 +title: Sony 1/2.3-Inch 12Mpixel CMOS Digital Image Sensor
 151 +
 152 +maintainers:
 153 +  - Raspberry Pi Kernel Maintenance <kernel-list@raspberrypi.com>
 154 +
 155 +description: |-
 156 +  The Sony IMX708 is a 1/2.3-inch CMOS active pixel digital image sensor
 157 +  with an active array size of 4608H x 2592V. It is programmable through
 158 +  I2C interface. The I2C address is fixed to 0x1A as per sensor data sheet.
 159 +  Image data is sent through MIPI CSI-2, which is configured as either 2 or
 160 +  4 data lanes.
 161 +
 162 +properties:
 163 +  compatible:
 164 +    const: sony,imx708
 165 +
 166 +  reg:
 167 +    maxItems: 1
 168 +
 169 +  clocks:
 170 +    maxItems: 1
 171 +
 172 +  clock-names:
 173 +    description: Input clock (6 to 27 MHz)
 174 +    items:
 175 +      - const: inck
 176 +
 177 +  vdig-supply:
 178 +    description:
 179 +      Digital I/O voltage supply, 1.1 volts
 180 +
 181 +  vana1-supply:
 182 +    description:
 183 +      Analog1 voltage supply, 2.8 volts
 184 +
 185 +  vana2-supply:
 186 +    description:
 187 +      Analog2 voltage supply, 1.8 volts
 188 +
 189 +  vddl-supply:
 190 +    description:
 191 +      Digital core voltage supply, 1.8 volts
 192 +
 193 +  reset-gpios:
 194 +    description: Sensor reset (XCLR) GPIO
 195 +    maxItems: 1
 196 +
 197 +  port:
 198 +    $ref: /schemas/graph.yaml#/$defs/port-base
 199 +    description: |
 200 +      Video output port
 201 +
 202 +    properties:
 203 +      endpoint:
 204 +        $ref: /schemas/media/video-interfaces.yaml#
 205 +        unevaluatedProperties: false
 206 +
 207 +        properties:
 208 +          data-lanes:
 209 +            anyOf:
 210 +              - items:
 211 +                  - const: 1
 212 +                  - const: 2
 213 +              - items:
 214 +                  - const: 1
 215 +                  - const: 2
 216 +                  - const: 3
 217 +                  - const: 4
 218 +
 219 +          link-frequencies: true
 220 +
 221 +        required:
 222 +          - data-lanes
 223 +          - link-frequencies
 224 +
 225 +    additionalProperties: false
 226 +
 227 +required:
 228 +  - compatible
 229 +  - reg
 230 +  - clocks
 231 +  - clock-names
 232 +  - vdig-supply
 233 +  - vana1-supply
 234 +  - vana2-supply
 235 +  - vddl-supply
 236 +  - port
 237 +
 238 +additionalProperties: false
 239 +
 240 +examples:
 241 +  - |
 242 +    #include <dt-bindings/gpio/gpio.h>
 243 +
 244 +    i2c {
 245 +        #address-cells = <1>;
 246 +        #size-cells = <0>;
 247 +
 248 +        imx708: camera-sensor@1a {
 249 +            compatible = "sony,imx708";
 250 +            reg = <0x1a>;
 251 +
 252 +            clocks = <&clk 90>;
 253 +            clock-names = "inck";
 254 +
 255 +            vdig-supply = <&camera_vdig>;
 256 +            vana1-supply = <&camera_vana1>;
 257 +            vana2-supply = <&camera_vana2>;
 258 +            vddl-supply = <&camera_vddl>;
 259 +
 260 +            reset-gpios = <&gpio 35 GPIO_ACTIVE_LOW>;
 261 +
 262 +            port {
 263 +                imx708_ep: endpoint {
 264 +                    data-lanes = <1 2>;
 265 +                    link-frequencies = /bits/ 64 <450000000>;
 266 +                    remote-endpoint = <&csi_ep>;
 267 +                };
 268 +            };
 269 +        };
 270 +    };
 271 +...
 272 --- a/MAINTAINERS
 273 +++ b/MAINTAINERS
 274 @@ -19344,7 +19344,7 @@ M:      Raspberry Pi Kernel Maintenance <kern
 275  L:     linux-media@vger.kernel.org
 276  S:     Maintained
 277  T:     git git://linuxtv.org/media_tree.git
 278 -F:     Documentation/devicetree/bindings/media/i2c/imx708.yaml
 279 +F:     Documentation/devicetree/bindings/media/i2c/sony,imx708.yaml
 280  F:     drivers/media/i2c/imx708.c
 281
 282  SONY MEMORYSTICK SUBSYSTEM