Commit 8d561d78 authored by Luca Weiss's avatar Luca Weiss Committed by Hans Verkuil
Browse files

media: dt-bindings: ov2685: convert to dtschema 



Convert the text-based dt-bindings to yaml.

Changes from original txt:
* Take wording for various properties from other yaml bindings, this
  removes e.g. volt amount from schema since it isn't really relevant
  and the datasheet is a better source.
* Don't make reset-gpios a required property since it can be tied to
  DOVDD instead.

Reviewed-by: default avatarKrzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Signed-off-by: default avatarLuca Weiss <luca@z3ntu.xyz>
[Sakari Ailus: bump the maxItems for data-lanes to two]
Signed-off-by: default avatarSakari Ailus <sakari.ailus@linux.intel.com>
Signed-off-by: default avatarHans Verkuil <hverkuil-cisco@xs4all.nl>
parent 9d73363d

Documentation/devicetree/bindings/media/i2c/ov2685.txt

deleted100644 → 0
+0 −41
Original line number Diff line number Diff line 
* Omnivision OV2685 MIPI CSI-2 sensor



Required Properties:

- compatible: shall be "ovti,ov2685"

- clocks: reference to the xvclk input clock

- clock-names: shall be "xvclk"

- avdd-supply: Analog voltage supply, 2.8 volts

- dovdd-supply: Digital I/O voltage supply, 1.8 volts

- dvdd-supply: Digital core voltage supply, 1.8 volts

- reset-gpios: Low active reset gpio



The device node shall contain one 'port' child node with an

'endpoint' subnode for its digital output video port,

in accordance with the video interface bindings defined in

Documentation/devicetree/bindings/media/video-interfaces.txt.

The endpoint optional property 'data-lanes' shall be "<1>".



Example:

&i2c7 {

	ov2685: camera-sensor@3c {

		compatible = "ovti,ov2685";

		reg = <0x3c>;

		pinctrl-names = "default";

		pinctrl-0 = <&clk_24m_cam>;



		clocks = <&cru SCLK_TESTCLKOUT1>;

		clock-names = "xvclk";



		avdd-supply = <&pp2800_cam>;

		dovdd-supply = <&pp1800>;

		dvdd-supply = <&pp1800>;

		reset-gpios = <&gpio2 3 GPIO_ACTIVE_LOW>;



		port {

			ucam_out: endpoint {

				remote-endpoint = <&mipi_in_ucam>;

				data-lanes = <1>;

			};

		};

	};

};

Documentation/devicetree/bindings/media/i2c/ovti,ov2685.yaml

0 → 100644
+101 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/media/i2c/ovti,ov2685.yaml#

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



title: OmniVision OV2685 Image Sensor



maintainers:

  - Shunqian Zheng <zhengsq@rock-chips.com>



properties:

  compatible:

    const: ovti,ov2685



  reg:

    maxItems: 1



  clocks:

    items:

      - description: XVCLK clock



  clock-names:

    items:

      - const: xvclk



  dvdd-supply:

    description: Digital Domain Power Supply



  avdd-supply:

    description: Analog Domain Power Supply



  dovdd-supply:

    description: I/O Domain Power Supply



  reset-gpios:

    maxItems: 1

    description: Reset Pin GPIO Control (active low)



  port:

    description: MIPI CSI-2 transmitter port

    $ref: /schemas/graph.yaml#/$defs/port-base

    additionalProperties: false



    properties:

      endpoint:

        $ref: /schemas/media/video-interfaces.yaml#

        unevaluatedProperties: false



        properties:

          data-lanes:

            maxItems: 2



        required:

          - data-lanes



required:

  - compatible

  - reg

  - clocks

  - clock-names

  - dvdd-supply

  - avdd-supply

  - dovdd-supply

  - port



additionalProperties: false



examples:

  - |

    #include <dt-bindings/clock/rk3399-cru.h>

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



    i2c {

        #address-cells = <1>;

        #size-cells = <0>;



        ov2685: camera-sensor@3c {

            compatible = "ovti,ov2685";

            reg = <0x3c>;

            pinctrl-names = "default";

            pinctrl-0 = <&clk_24m_cam>;



            clocks = <&cru SCLK_TESTCLKOUT1>;

            clock-names = "xvclk";



            avdd-supply = <&pp2800_cam>;

            dovdd-supply = <&pp1800>;

            dvdd-supply = <&pp1800>;

            reset-gpios = <&gpio2 3 GPIO_ACTIVE_LOW>;



            port {

                ucam_out: endpoint {

                    remote-endpoint = <&mipi_in_ucam>;

                    data-lanes = <1>;

                };

            };

        };

    };



...

MAINTAINERS

+1 −0
Original line number Diff line number Diff line
@@ -15389,6 +15389,7 @@ M: Shunqian Zheng <zhengsq@rock-chips.com> 
L:	linux-media@vger.kernel.org

S:	Maintained

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

F:	Documentation/devicetree/bindings/media/i2c/ovti,ov2685.yaml

F:	drivers/media/i2c/ov2685.c









OMNIVISION OV2740 SENSOR DRIVER