On 4/5/19 8:03 AM, 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.fel...@pengutronix.de>
> Reviewed-by: Rob Herring <r...@kernel.org>
> ---
> .../display/connector/analog-tv-connector.txt | 4 ++
> include/dt-bindings/media/tvnorms.h | 42 +++++++++++++++++++
> 2 files changed, 46 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..346f8937a0b7 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
> + all tv norms are allowed. Possible video standards are defined in
> + 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_M | TVNORM_NTSC_M)>;
>
> 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..ec3b414a7a00
> --- /dev/null
> +++ b/include/dt-bindings/media/tvnorms.h
> @@ -0,0 +1,42 @@
> +/* SPDX-License-Identifier: GPL-2.0-only or X11 */
> +/*
> + * Copyright 2019 Pengutronix, Marco Felsch <ker...@pengutronix.de>
> + */
> +
> +#ifndef _DT_BINDINGS_MEDIA_TVNORMS_H
> +#define _DT_BINDINGS_MEDIA_TVNORMS_H
> +
> +/* one bit for each */
> +#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
I would add a TVNORM_PAL here as well that is the OR of the previous defines.
> +
> +#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_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
Same here for SECAM.
> +
> +/* ATSC/HDTV */
> +#define TVNORM_ATSC_8_VSB 0x01000000
> +#define TVNORM_ATSC_16_VSB 0x02000000
I would drop these. The only driver using this is pvrusb2, and I am not
convinced that's right. And in any case, that driver doesn't use the DT.
Regards,
Hans
> +
> +#endif /* _DT_BINDINGS_MEDIA_TVNORMS_H */
>
