From: Sakari Ailus <sakari.ailus@iki.fi>
To: Ken Sloat <KSloat@aampglobal.com>
Cc: "Eugen.Hristev@microchip.com" <Eugen.Hristev@microchip.com>,
"mchehab@kernel.org" <mchehab@kernel.org>,
"Nicolas.Ferre@microchip.com" <Nicolas.Ferre@microchip.com>,
"alexandre.belloni@bootlin.com" <alexandre.belloni@bootlin.com>,
"Ludovic.Desroches@microchip.com"
<Ludovic.Desroches@microchip.com>,
"linux-media@vger.kernel.org" <linux-media@vger.kernel.org>,
"devicetree@vger.kernel.org" <devicetree@vger.kernel.org>
Subject: Re: [PATCH v2 2/2] media: atmel-isc: Update device tree binding documentation
Date: Wed, 23 Jan 2019 14:45:38 +0200 [thread overview]
Message-ID: <20190123124538.5vfxhsyl2npy4jnp@valkosipuli.retiisi.org.uk> (raw)
In-Reply-To: <DM5PR07MB411967243FA1C96C1179071FAD9C0@DM5PR07MB4119.namprd07.prod.outlook.com>
On Fri, Jan 18, 2019 at 06:05:23PM +0000, Ken Sloat wrote:
> > -----Original Message-----
> > From: Eugen.Hristev@microchip.com <Eugen.Hristev@microchip.com>
> > Sent: Friday, January 18, 2019 9:40 AM
> > To: Ken Sloat <KSloat@aampglobal.com>
> > Cc: mchehab@kernel.org; Nicolas.Ferre@microchip.com;
> > alexandre.belloni@bootlin.com; Ludovic.Desroches@microchip.com; linux-
> > media@vger.kernel.org; devicetree@vger.kernel.org
> > Subject: Re: [PATCH v2 2/2] media: atmel-isc: Update device tree binding
> > documentation
> >
> >
> >
> > On 18.01.2019 16:28, Ken Sloat wrote:
> > > From: Ken Sloat <ksloat@aampglobal.com>
> > >
> > > Update device tree binding documentation specifying how to enable
> > > BT656 with CRC decoding.
> > >
> > > Signed-off-by: Ken Sloat <ksloat@aampglobal.com>
> > > ---
> > > Changes in v2:
> > > -Use correct media "bus-type" dt property.
> > >
> > > Documentation/devicetree/bindings/media/atmel-isc.txt | 5 +++++
> > > 1 file changed, 5 insertions(+)
> > >
> > > diff --git a/Documentation/devicetree/bindings/media/atmel-isc.txt
> > > b/Documentation/devicetree/bindings/media/atmel-isc.txt
> > > index bbe0e87c6188..2d4378dfd6c8 100644
> > > --- a/Documentation/devicetree/bindings/media/atmel-isc.txt
> > > +++ b/Documentation/devicetree/bindings/media/atmel-isc.txt
> > > @@ -21,6 +21,11 @@ Required properties for ISC:
> > > - pinctrl-names, pinctrl-0
> > > Please refer to pinctrl-bindings.txt.
> > >
> > > +Optional properties for ISC:
> > > +- bus-type
> > > + When set to 6, Bt.656 decoding (embedded sync) with CRC decoding
> > > + is enabled.
> > > +
> >
> > I don't think this patch is required at all actually, the binding complies to the
> > video-interfaces bus specification which includes the parallel and bt.656.
> >
> > Would be worth mentioning below explicitly that parallel and bt.656 are
> > supported, or added above that also plain parallel bus is supported ?
> >
> > > ISC supports a single port node with parallel bus. It should contain
> > > one
> >
> > here inside the previous line
> Hi Eugen,
>
> Yes it's true adding new documentation here may be overkill, but yes it should say something
> (as a user I always find it helpful if the docs are more verbose than not).
>
> So per your suggestion, how about the simplified:
> "ISC supports a single port node with parallel bus and optionally Bt.656 support."
>
> and I'll remit the other statements.
Please still include the name of the property, as well as the valid values
for it (numeric as well as human-readable). The rest of the documentation
should stay in video-interfaces.txt IMO --- this is documentation for the
hardware only.
--
Regards,
Sakari Ailus
next prev parent reply other threads:[~2019-01-23 12:46 UTC|newest]
Thread overview: 8+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-01-18 14:28 [PATCH v2 1/2] media: atmel-isc: Add support for BT656 with CRC decoding Ken Sloat
2019-01-18 14:28 ` [PATCH v2 2/2] media: atmel-isc: Update device tree binding documentation Ken Sloat
2019-01-18 14:39 ` Eugen.Hristev
2019-01-18 18:05 ` Ken Sloat
2019-01-21 7:43 ` Eugen.Hristev
2019-01-23 12:45 ` Sakari Ailus [this message]
2019-01-29 20:22 ` Ken Sloat
2019-01-30 10:51 ` Sakari Ailus
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=20190123124538.5vfxhsyl2npy4jnp@valkosipuli.retiisi.org.uk \
--to=sakari.ailus@iki.fi \
--cc=Eugen.Hristev@microchip.com \
--cc=KSloat@aampglobal.com \
--cc=Ludovic.Desroches@microchip.com \
--cc=Nicolas.Ferre@microchip.com \
--cc=alexandre.belloni@bootlin.com \
--cc=devicetree@vger.kernel.org \
--cc=linux-media@vger.kernel.org \
--cc=mchehab@kernel.org \
/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).