media: dt-bindings: media: i2c: Add IMX296 CMOS sensor binding

# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/media/i2c/sony,imx296.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Sony IMX296 1/2.8-Inch CMOS Image Sensor

maintainers:

  - Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>

  - Laurent Pinchart <laurent.pinchart@ideasonboard.com>

description: |-

  The Sony IMX296 is a 1/2.9-Inch active pixel type CMOS Solid-state image

  sensor with square pixel array and 1.58 M effective pixels. This chip

  features a global shutter with variable charge-integration time. It is

  programmable through I2C and 4-wire interfaces. The sensor output is

  available via CSI-2 serial data output (1 Lane).

properties:

  compatible:

    enum:

      - sony,imx296

      - sony,imx296ll

      - sony,imx296lq

    description:

      The IMX296 sensor exists in two different models, a colour variant

      (IMX296LQ) and a monochrome variant (IMX296LL). The device exposes the

      model through registers, allowing for auto-detection with a common

      "sony,imx296" compatible string. However, some camera modules disable the

      ability to read the sensor model register, which disables this feature.

      In those cases, the exact model needs to be specified as "sony,imx296ll"

      or "sony,imx296lq".

  reg:

    maxItems: 1

  clocks:

    maxItems: 1

  clock-names:

    description: Input clock (37.125 MHz, 54 MHz or 74.25 MHz)

    items:

      - const: inck

  avdd-supply:

    description: Analog power supply (3.3V)

  dvdd-supply:

    description: Digital power supply (1.2V)

  ovdd-supply:

    description: Interface power supply (1.8V)

  reset-gpios:

    description: Sensor reset (XCLR) GPIO

    maxItems: 1

  port:

    $ref: /schemas/graph.yaml#/properties/port

required:

  - compatible

  - reg

  - clocks

  - clock-names

  - avdd-supply

  - dvdd-supply

  - ovdd-supply

  - port

additionalProperties: false

examples:

  - |

    #include <dt-bindings/gpio/gpio.h>

    i2c {

        #address-cells = <1>;

        #size-cells = <0>;

        imx296: camera-sensor@1a {

            compatible = "sony,imx296";

            reg = <0x1a>;

            pinctrl-names = "default";

            pinctrl-0 = <&camera_rear_default>;

            clocks = <&gcc 90>;

            clock-names = "inck";

            avdd-supply = <&camera_vdda_3v3>;

            dvdd-supply = <&camera_vddd_1v2>;

            ovdd-supply = <&camera_vddo_1v8>;

            reset-gpios = <&msmgpio 35 GPIO_ACTIVE_LOW>;

            port {

                imx296_ep: endpoint {

                    remote-endpoint = <&csiphy0_ep>;

                };

            };

        };

    };

...

F:	Documentation/devicetree/bindings/media/i2c/sony,imx290.yaml

F:	drivers/media/i2c/imx290.c

SONY IMX296 SENSOR DRIVER

M:	Laurent Pinchart <laurent.pinchart@ideasonboard.com>

M:	Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>

L:	linux-media@vger.kernel.org

S:	Maintained

T:	git git://linuxtv.org/media_tree.git

F:	Documentation/devicetree/bindings/media/i2c/sony,imx296.yaml

SONY IMX319 SENSOR DRIVER

M:	Bingbu Cao <bingbu.cao@intel.com>

L:	linux-media@vger.kernel.org