media: dt-bindings: ov772x: add device tree binding

This adds a device tree binding documentation for OV7720/OV7725 sensor.

Cc: Jacopo Mondi <jacopo+renesas@jmondi.org>
Cc: Hans Verkuil <hans.verkuil@cisco.com>
Cc: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Cc: Rob Herring <robh+dt@kernel.org>
Reviewed-by: Rob Herring <robh@kernel.org>
Reviewed-by: Jacopo Mondi <jacopo@jmondi.org>
Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Signed-off-by: Akinobu Mita <akinobu.mita@gmail.com>
Signed-off-by: Sakari Ailus <sakari.ailus@linux.intel.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>

diff --git a/Documentation/devicetree/bindings/media/i2c/ov772x.txt b/Documentation/devicetree/bindings/media/i2c/ov772x.txt
new file mode 100644 (file)
index 0000000..0b3ede5
--- /dev/null
+++ b/Documentation/devicetree/bindings/media/i2c/ov772x.txt
@@ -0,0 +1,40 @@
+* Omnivision OV7720/OV7725 CMOS sensor
+
+The Omnivision OV7720/OV7725 sensor supports multiple resolutions output,
+such as VGA, QVGA, and any size scaling down from CIF to 40x30. It also can
+support the YUV422, RGB565/555/444, GRB422 or raw RGB output formats.
+
+Required Properties:
+- compatible: shall be one of
+       "ovti,ov7720"
+       "ovti,ov7725"
+- clocks: reference to the xclk input clock.
+
+Optional Properties:
+- reset-gpios: reference to the GPIO connected to the RSTB pin which is
+  active low, if any.
+- powerdown-gpios: reference to the GPIO connected to the PWDN pin which is
+  active high, if any.
+
+The device node shall contain one 'port' child node with one child 'endpoint'
+subnode for its digital output video port, in accordance with the video
+interface bindings defined in Documentation/devicetree/bindings/media/
+video-interfaces.txt.
+
+Example:
+
+&i2c0 {
+       ov772x: camera@21 {
+               compatible = "ovti,ov7725";
+               reg = <0x21>;
+               reset-gpios = <&axi_gpio_0 0 GPIO_ACTIVE_LOW>;
+               powerdown-gpios = <&axi_gpio_0 1 GPIO_ACTIVE_LOW>;
+               clocks = <&xclk>;
+
+               port {
+                       ov772x_0: endpoint {
+                               remote-endpoint = <&vcap1_in0>;
+                       };
+               };
+       };
+};

diff --git a/MAINTAINERS b/MAINTAINERS
index d9db405..a38e24a 100644 (file)
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -10364,6 +10364,7 @@ T:      git git://linuxtv.org/media_tree.git
 S:     Odd fixes
 F:     drivers/media/i2c/ov772x.c
 F:     include/media/i2c/ov772x.h
+F:     Documentation/devicetree/bindings/media/i2c/ov772x.txt
 
 OMNIVISION OV7740 SENSOR DRIVER
 M:     Wenyou Yang <wenyou.yang@microchip.com>