Hi Hans, On Mon, Mar 06, 2017 at 03:56:02PM +0100, Hans Verkuil wrote: > From: Hans Verkuil <hans.verkuil@xxxxxxxxx> > > Add binding documentation and add that file to the MAINTAINERS entry. > > Signed-off-by: Hans Verkuil <hans.verkuil@xxxxxxxxx> > --- > .../devicetree/bindings/media/i2c/ov7670.txt | 44 ++++++++++++++++++++++ > MAINTAINERS | 1 + > 2 files changed, 45 insertions(+) > create mode 100644 Documentation/devicetree/bindings/media/i2c/ov7670.txt > > diff --git a/Documentation/devicetree/bindings/media/i2c/ov7670.txt b/Documentation/devicetree/bindings/media/i2c/ov7670.txt > new file mode 100644 > index 000000000000..6d9c90dff7a7 > --- /dev/null > +++ b/Documentation/devicetree/bindings/media/i2c/ov7670.txt > @@ -0,0 +1,44 @@ > +* Omnivision OV7670 CMOS sensor > + > +The Omnivision OV7670 sensor supports multiple resolutions output, such as > +CIF, SVGA, UXGA. It also can support the YUV422/420, RGB565/555 or raw RGB > +output formats. > + > +Required Properties: > +- compatible: should be "ovti,ov7670" > +- clocks: reference to the xclk input clock. > +- clock-names: should be "xclk". > + > +Optional Properties: > +- reset-gpios: reference to the GPIO connected to the resetb pin, if any. > + Active is low. > +- powerdown-gpios: reference to the GPIO connected to the pwdn pin, if any. > + Active is high. > + > +The device node must contain one 'port' child node for its digital output > +video port, in accordance with the video interface bindings defined in > +Documentation/devicetree/bindings/media/video-interfaces.txt. > + > +Example: > + > + i2c1: i2c@f0018000 { > + ov7670: camera@21 { > + compatible = "ovti,ov7670"; > + reg = <0x21>; > + pinctrl-names = "default"; > + pinctrl-0 = <&pinctrl_pck0_as_isi_mck &pinctrl_sensor_power &pinctrl_sensor_reset>; > + reset-gpios = <&pioE 11 GPIO_ACTIVE_LOW>; > + powerdown-gpios = <&pioE 13 GPIO_ACTIVE_HIGH>; > + clocks = <&pck0>; > + clock-names = "xclk"; > + assigned-clocks = <&pck0>; > + assigned-clock-rates = <25000000>; > + > + port { > + ov7670_0: endpoint { > + remote-endpoint = <&isi_0>; > + bus-width = <8>; Didn't I previously request to specify which of the standardised properties are relevant for the device (and which ones are required and which are optional)? If I didn't, I'm doing that now. :-) E.g. the omap3isp driver documentation looks like this: Documentation/devicetree/bindings/media/ti,omap3isp.txt > + }; > + }; > + }; > + }; > diff --git a/MAINTAINERS b/MAINTAINERS > index 83a42ef1d1a7..93500928ca4f 100644 > --- a/MAINTAINERS > +++ b/MAINTAINERS > @@ -9273,6 +9273,7 @@ L: linux-media@xxxxxxxxxxxxxxx > T: git git://linuxtv.org/media_tree.git > S: Maintained > F: drivers/media/i2c/ov7670.c > +F: Documentation/devicetree/bindings/media/i2c/ov7670.txt > > ONENAND FLASH DRIVER > M: Kyungmin Park <kyungmin.park@xxxxxxxxxxx> -- Kind regards, Sakari Ailus e-mail: sakari.ailus@xxxxxx XMPP: sailus@xxxxxxxxxxxxxx -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html