From: Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
To: Rob Herring <robh@kernel.org>, Sakari Ailus <sakari.ailus@iki.fi>
Cc: mchehab@kernel.org, linux-media@vger.kernel.org,
linux-kernel@vger.kernel.org, devicetree@vger.kernel.org,
linux-arm-kernel@lists.infradead.org, c.barrett@framos.com,
a.brela@framos.com, peter.griffin@linaro.org
Subject: Re: [PATCH v3 1/2] dt-bindings: media: i2c: Add IMX296 CMOS sensor binding
Date: Wed, 30 Oct 2019 12:15:55 +0530 [thread overview]
Message-ID: <20191030064555.GB11637@Mani-XPS-13-9360> (raw)
In-Reply-To: <20191029221213.GB17996@bogus>
Hi Rob, Sakari,
On Tue, Oct 29, 2019 at 05:12:13PM -0500, Rob Herring wrote:
> On Mon, Oct 28, 2019 at 02:21:15PM +0200, Sakari Ailus wrote:
> > Hi Manivannan,
> >
> > Thanks for the update.
> >
> > On Fri, Oct 25, 2019 at 11:29:07PM +0530, Manivannan Sadhasivam wrote:
> > > Add YAML devicetree binding for IMX296 CMOS image sensor.
> > >
> > > Signed-off-by: Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
> > > ---
> > > .../devicetree/bindings/media/i2c/imx296.yaml | 98 +++++++++++++++++++
> > > 1 file changed, 98 insertions(+)
> > > create mode 100644 Documentation/devicetree/bindings/media/i2c/imx296.yaml
> > >
> > > diff --git a/Documentation/devicetree/bindings/media/i2c/imx296.yaml b/Documentation/devicetree/bindings/media/i2c/imx296.yaml
> > > new file mode 100644
> > > index 000000000000..4e204fd7cf90
> > > --- /dev/null
> > > +++ b/Documentation/devicetree/bindings/media/i2c/imx296.yaml
> > > @@ -0,0 +1,98 @@
> > > +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
> > > +%YAML 1.2
> > > +---
> > > +$id: http://devicetree.org/schemas/media/i2c/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>
> > > +
> > > +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:
> > > + const: sony,imx296
> > > +
> > > + reg:
> > > + maxItems: 1
> > > +
> > > + clocks:
> > > + maxItems: 1
> > > +
> > > + clock-names:
> > > + description:
> > > + Input clock for the sensor.
> > > + items:
> > > + - const: mclk
> > > +
> > > + clock-frequency:
> > > + description:
> > > + Frequency of the mclk clock in Hertz.
> > > + default: 37125000
> >
> > I think you could omit the default.
>
> Yes, there's no default if it is required.
>
Okay.
> > > +
> > > + vddo-supply:
> > > + description:
> > > + Definition of the regulator used as interface power supply.
> > > + maxItems: 1
> > > +
> > > + vdda-supply:
> > > + description:
> > > + Definition of the regulator used as analog power supply.
> > > + maxItems: 1
> > > +
> > > + vddd-supply:
> > > + description:
> > > + Definition of the regulator used as digital power supply.
> > > + maxItems: 1
> > > +
> > > + reset-gpios:
> > > + description:
> > > + The phandle and specifier for the GPIO that controls sensor reset.
> > > + maxItems: 1
> > > +
> > > + # See ../video-interfaces.txt for details
>
> details on what?
>
Standard properties like endpoint, reg, etc... I can remove it if not
required.
> > > +
> > > +required:
> > > + - compatible
> > > + - reg
> > > + - clocks
> > > + - clock-names
> > > + - clock-frequency
> > > + - vddo-supply
> > > + - vdda-supply
> > > + - vddd-supply
> >
> > I think the port and endpoint nodes should documented here as well.
>
> port yes, but endpoint no. Unless you have endpoint properties other
> than remote-endpoint or reg.
>
Okay. Will document port.
Thanks,
Mani
> >
> > > +
> > > +additionalProperties: false
> > > +
> > > +examples:
> > > + - |
> > > + #include <dt-bindings/gpio/gpio.h>
> > > +
> > > + imx296: camera-sensor@1a {
> > > + compatible = "sony,imx296";
> > > + reg = <0x1a>;
> > > + reset-gpios = <&msmgpio 35 GPIO_ACTIVE_LOW>;
> > > + pinctrl-names = "default";
> > > + pinctrl-0 = <&camera_rear_default>;
> > > + clocks = <&gcc 90>;
> > > + clock-names = "mclk";
> > > + clock-frequency = <37125000>;
> > > + vddo-supply = <&camera_vddo_1v8>;
> > > + vdda-supply = <&camera_vdda_3v3>;
> > > + vddd-supply = <&camera_vddd_1v2>;
> > > +
> > > + port {
> > > + imx296_ep: endpoint {
> > > + remote-endpoint = <&csiphy0_ep>;
> > > + };
> > > + };
> > > + };
> > > +
> > > +...
> >
> > --
> > Regards,
> >
> > Sakari Ailus
next prev parent reply other threads:[~2019-10-30 6:46 UTC|newest]
Thread overview: 12+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-10-25 17:59 [PATCH v3 0/2] Add IMX296 CMOS image sensor support Manivannan Sadhasivam
2019-10-25 17:59 ` [PATCH v3 1/2] dt-bindings: media: i2c: Add IMX296 CMOS sensor binding Manivannan Sadhasivam
2019-10-28 12:21 ` Sakari Ailus
2019-10-29 22:12 ` Rob Herring
2019-10-30 6:45 ` Manivannan Sadhasivam [this message]
2019-10-29 22:09 ` Rob Herring
2019-10-25 17:59 ` [PATCH v3 2/2] media: i2c: Add IMX296 CMOS image sensor driver Manivannan Sadhasivam
2019-10-29 12:13 ` Sakari Ailus
2019-10-30 6:26 ` Manivannan Sadhasivam
2019-10-30 8:35 ` Sakari Ailus
2019-10-30 9:33 ` Manivannan Sadhasivam
2022-08-23 0:58 [PATCH v3 0/2] media: i2c: IMX296 camera sensor support Laurent Pinchart
2022-08-23 0:58 ` [PATCH v3 1/2] dt-bindings: media: i2c: Add IMX296 CMOS sensor binding Laurent Pinchart
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20191030064555.GB11637@Mani-XPS-13-9360 \
--to=manivannan.sadhasivam@linaro.org \
--cc=a.brela@framos.com \
--cc=c.barrett@framos.com \
--cc=devicetree@vger.kernel.org \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-media@vger.kernel.org \
--cc=mchehab@kernel.org \
--cc=peter.griffin@linaro.org \
--cc=robh@kernel.org \
--cc=sakari.ailus@iki.fi \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).