From: Hans Verkuil <hverkuil@xs4all.nl>
To: Marco Felsch <m.felsch@pengutronix.de>,
mchehab@kernel.org, sakari.ailus@linux.intel.com,
hans.verkuil@cisco.com, jacopo+renesas@jmondi.org,
robh+dt@kernel.org, laurent.pinchart@ideasonboard.com
Cc: linux-media@vger.kernel.org, devicetree@vger.kernel.org,
kernel@pengutronix.de, Rob Herring <robh@kernel.org>
Subject: Re: [PATCH v7 01/13] dt-bindings: connector: analog: add tv norms property
Date: Fri, 16 Aug 2019 13:11:45 +0200 [thread overview]
Message-ID: <76aeaa4e-4a29-5abe-1af6-fc82958e9530@xs4all.nl> (raw)
In-Reply-To: <20190815115747.24018-2-m.felsch@pengutronix.de>
On 8/15/19 1:57 PM, Marco Felsch wrote:
> Some connectors no matter if in- or output supports only a limited
> range of tv norms. It doesn't matter if the hardware behind that
> connector supports more than the listed formats since the users are
> restriced by a label e.g. to plug only a camera into this connector
> which uses the PAL format.
>
> This patch adds the capability to describe such limitation within the
> firmware. There are no format restrictions if the property isn't
> present, so it's completely backward compatible.
>
> Signed-off-by: Marco Felsch <m.felsch@pengutronix.de>
> Reviewed-by: Rob Herring <robh@kernel.org>
> ---
> [1] https://patchwork.kernel.org/cover/10794703/
>
> v7:
> I kept Robs r b tag because I only changed the example and extended
> TVNORM_* macros.
>
> - fix some style issues
> - add TVNORM_NTSC, TVNORM_525_60 and TVNORM_625_50
>
> v6:
> - tvnorms.h: use tabs instead of spaces
> - tvnorms.h: add TVNORM_PAL and TVNORM_SECAM
> - tvnorms.h: drop rarely used TVNORM_ATSC_* norms
>
> v2-v4:
> - nothing since the patch was squashed from series [1] into this
> series.
> ---
> .../display/connector/analog-tv-connector.txt | 4 ++
> include/dt-bindings/media/tvnorms.h | 72 +++++++++++++++++++
> 2 files changed, 76 insertions(+)
> create mode 100644 include/dt-bindings/media/tvnorms.h
>
> diff --git a/Documentation/devicetree/bindings/display/connector/analog-tv-connector.txt b/Documentation/devicetree/bindings/display/connector/analog-tv-connector.txt
> index 0c0970c210ab..434e8aa0398b 100644
> --- a/Documentation/devicetree/bindings/display/connector/analog-tv-connector.txt
> +++ b/Documentation/devicetree/bindings/display/connector/analog-tv-connector.txt
> @@ -6,6 +6,9 @@ Required properties:
>
> Optional properties:
> - label: a symbolic name for the connector
> +- tvnorms: limit the supported tv norms on a connector to the given ones else
tv -> TV
> + all tv norms are allowed. Possible video standards are defined in
tv -> TV
And a more high-level question: I think tvnorm is a very vague name. It's a term
used in media, but what does 'norm' mean anyway? 'tv_standards' or 'video_standards'
would be a lot more descriptive.
'tvnorm' is, I think, a term used only internally in the media subsystem for no
clear reason. In the V4L2 spec it talks about 'video standard'.
Sorry for being so late with raising this issue.
> + include/dt-bindings/media/tvnorms.h.
>
> Required nodes:
> - Video port for TV input
> @@ -16,6 +19,7 @@ Example
> tv: connector {
> compatible = "composite-video-connector";
> label = "tv";
> + tvnorms = <(TVNORM_PAL | TVNORM_NTSC)>;
>
> port {
> tv_connector_in: endpoint {
> diff --git a/include/dt-bindings/media/tvnorms.h b/include/dt-bindings/media/tvnorms.h
> new file mode 100644
> index 000000000000..e1275673c4d6
> --- /dev/null
> +++ b/include/dt-bindings/media/tvnorms.h
> @@ -0,0 +1,72 @@
> +/* SPDX-License-Identifier: GPL-2.0-only or X11 */
> +/*
> + * Copyright 2019 Pengutronix, Marco Felsch <kernel@pengutronix.de>
> + */
> +
> +#ifndef _DT_BINDINGS_MEDIA_TVNORMS_H
> +#define _DT_BINDINGS_MEDIA_TVNORMS_H
> +
> +/* One bit for each standard */
I would add a comment here and in videodev2.h where you mention that
the two headers should remain in sync.
> +#define TVNORM_PAL_B 0x00000001
> +#define TVNORM_PAL_B1 0x00000002
> +#define TVNORM_PAL_G 0x00000004
> +#define TVNORM_PAL_H 0x00000008
> +#define TVNORM_PAL_I 0x00000010
> +#define TVNORM_PAL_D 0x00000020
> +#define TVNORM_PAL_D1 0x00000040
> +#define TVNORM_PAL_K 0x00000080
> +
> +#define TVNORM_PAL (TVNORM_PAL_B | \
> + TVNORM_PAL_B1 | \
> + TVNORM_PAL_G | \
> + TVNORM_PAL_H | \
> + TVNORM_PAL_I | \
> + TVNORM_PAL_D | \
> + TVNORM_PAL_D1 | \
> + TVNORM_PAL_K)
> +
> +#define TVNORM_PAL_M 0x00000100
> +#define TVNORM_PAL_N 0x00000200
> +#define TVNORM_PAL_Nc 0x00000400
> +#define TVNORM_PAL_60 0x00000800
> +
> +#define TVNORM_NTSC_M 0x00001000 /* BTSC */
> +#define TVNORM_NTSC_M_JP 0x00002000 /* EIA-J */
> +#define TVNORM_NTSC_443 0x00004000
> +#define TVNORM_NTSC_M_KR 0x00008000 /* FM A2 */
> +
> +#define TVNORM_NTSC (TVNORM_NTSC_M |\
> + TVNORM_NTSC_M_JP |\
Add space before \
> + TVNORM_NTSC_M_KR)
> +
> +#define TVNORM_SECAM_B 0x00010000
> +#define TVNORM_SECAM_D 0x00020000
> +#define TVNORM_SECAM_G 0x00040000
> +#define TVNORM_SECAM_H 0x00080000
> +#define TVNORM_SECAM_K 0x00100000
> +#define TVNORM_SECAM_K1 0x00200000
> +#define TVNORM_SECAM_L 0x00400000
> +#define TVNORM_SECAM_LC 0x00800000
> +
> +#define TVNORM_SECAM (TVNORM_SECAM_B | \
> + TVNORM_SECAM_D | \
> + TVNORM_SECAM_G | \
> + TVNORM_SECAM_H | \
> + TVNORM_SECAM_K | \
> + TVNORM_SECAM_K1 | \
> + TVNORM_SECAM_L | \
> + TVNORM_SECAM_LC)
> +
> +/* Standards for Countries with 60Hz Line frequency */
> +#define TVNORM_525_60 (TVNORM_PAL_M | \
> + TVNORM_PAL_60 | \
> + TVNORM_NTSC | \
> + TVNORM_NTSC_443)
> +
> +/* Standards for Countries with 50Hz Line frequency */
> +#define TVNORM_625_50 (TVNORM_PAL |\
> + TVNORM_PAL_N |\
> + TVNORM_PAL_Nc |\
Add space before \
> + TVNORM_SECAM)
> +
> +#endif /* _DT_BINDINGS_MEDIA_TVNORMS_H */
>
I was also wondering if this header shouldn't be in include/dt-bindings/display/
since the bindings are also described in 'display'.
Regards,
Hans
next prev parent reply other threads:[~2019-08-16 11:11 UTC|newest]
Thread overview: 30+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-08-15 11:57 [PATCH v7 00/13] Add TVP5150 features Marco Felsch
2019-08-15 11:57 ` [PATCH v7 01/13] dt-bindings: connector: analog: add tv norms property Marco Felsch
2019-08-16 11:11 ` Hans Verkuil [this message]
2019-08-19 8:09 ` Marco Felsch
2019-08-19 8:18 ` Marco Felsch
2019-08-19 8:41 ` Hans Verkuil
2019-08-19 8:39 ` Hans Verkuil
2019-08-19 9:01 ` Marco Felsch
2019-08-19 9:06 ` Hans Verkuil
2019-08-15 11:57 ` [PATCH v7 02/13] media: v4l2-fwnode: add v4l2_fwnode_connector Marco Felsch
2019-08-16 10:59 ` Hans Verkuil
2019-08-19 9:17 ` Marco Felsch
2019-08-19 9:18 ` Hans Verkuil
2019-08-15 11:57 ` [PATCH v7 03/13] media: v4l2-fwnode: add initial connector parsing support Marco Felsch
2019-08-15 11:57 ` [PATCH v7 04/13] partial revert of "[media] tvp5150: add HW input connectors support" Marco Felsch
2019-08-15 11:57 ` [PATCH v7 05/13] media: tvp5150: add input source selection of_graph support Marco Felsch
2019-08-19 6:20 ` Marco Felsch
2019-08-15 11:57 ` [PATCH v7 06/13] media: dt-bindings: tvp5150: Add input port connectors DT bindings Marco Felsch
2019-08-16 21:01 ` Rob Herring
2019-08-15 11:57 ` [PATCH v7 07/13] media: tvp5150: add FORMAT_TRY support for get/set selection handlers Marco Felsch
2019-08-16 11:27 ` Hans Verkuil
2019-08-19 10:40 ` Marco Felsch
2019-08-19 10:41 ` Hans Verkuil
2019-08-15 11:57 ` [PATCH v7 08/13] media: tvp5150: initialize subdev before parsing device tree Marco Felsch
2019-08-15 11:57 ` [PATCH v7 09/13] media: tvp5150: add s_power callback Marco Felsch
2019-08-15 11:57 ` [PATCH v7 10/13] media: dt-bindings: tvp5150: cleanup bindings stlye Marco Felsch
2019-08-16 11:28 ` Hans Verkuil
2019-08-15 11:57 ` [PATCH v7 11/13] media: dt-bindings: tvp5150: add optional tvnorms documentation Marco Felsch
2019-08-15 11:57 ` [PATCH v7 12/13] media: tvp5150: add support to limit tv norms on connector Marco Felsch
2019-08-15 11:57 ` [PATCH v7 13/13] media: tvp5150: make debug output more readable Marco Felsch
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=76aeaa4e-4a29-5abe-1af6-fc82958e9530@xs4all.nl \
--to=hverkuil@xs4all.nl \
--cc=devicetree@vger.kernel.org \
--cc=hans.verkuil@cisco.com \
--cc=jacopo+renesas@jmondi.org \
--cc=kernel@pengutronix.de \
--cc=laurent.pinchart@ideasonboard.com \
--cc=linux-media@vger.kernel.org \
--cc=m.felsch@pengutronix.de \
--cc=mchehab@kernel.org \
--cc=robh+dt@kernel.org \
--cc=robh@kernel.org \
--cc=sakari.ailus@linux.intel.com \
/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).