From: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
To: Marco Felsch <m.felsch@pengutronix.de>
Cc: Hans Verkuil <hverkuil@xs4all.nl>,
Mauro Carvalho Chehab <mchehab@kernel.org>,
sakari.ailus@linux.intel.com, hans.verkuil@cisco.com,
jacopo+renesas@jmondi.org, robh+dt@kernel.org,
linux-media@vger.kernel.org, devicetree@vger.kernel.org,
kernel@pengutronix.de, Jacopo Mondi <jacopo@jmondi.org>
Subject: Re: [PATCH v6 03/13] media: v4l2-fwnode: add initial connector parsing support
Date: Thu, 16 May 2019 19:51:14 +0300 [thread overview]
Message-ID: <20190516165114.GP14820@pendragon.ideasonboard.com> (raw)
In-Reply-To: <20190514152004.30d7838b@coco.lan>
Hello Marco,
Thank you for the patch.
On Tue, May 14, 2019 at 03:20:04PM -0300, Mauro Carvalho Chehab wrote:
> Em Mon, 6 May 2019 12:10:41 +0200 Hans Verkuil escreveu:
> > On 4/15/19 2:44 PM, Marco Felsch wrote:
> > > The patch adds the initial connector parsing code, so we can move from a
> > > driver specific parsing code to a generic one. Currently only the
> > > generic fields and the analog-connector specific fields are parsed. Parsing
> > > the other connector specific fields can be added by a simple callbacks.
> > >
> > > Signed-off-by: Marco Felsch <m.felsch@pengutronix.de>
> > > Reviewed-by: Jacopo Mondi <jacopo@jmondi.org>
> > > ---
> > > [1] https://patchwork.kernel.org/cover/10794703/
> > >
> > > v6:
> > > - use 'unsigned int' count var
> > > - fix comment and style issues
> > > - place '/* fall through */' to correct places
> > > - fix error handling and cleanup by releasing fwnode
> > > - drop vga and dvi parsing support as those connectors are rarely used
> > > these days
> > >
> > > v5:
> > > - s/strlcpy/strscpy/
> > >
> > > v2-v4:
> > > - nothing since the patch was squashed from series [1] into this
> > > series.
> > >
> > > drivers/media/v4l2-core/v4l2-fwnode.c | 111 ++++++++++++++++++++++++++
> > > include/media/v4l2-fwnode.h | 16 ++++
> > > 2 files changed, 127 insertions(+)
> > >
> > > diff --git a/drivers/media/v4l2-core/v4l2-fwnode.c b/drivers/media/v4l2-core/v4l2-fwnode.c
> > > index 20571846e636..f1cca95c8fef 100644
> > > --- a/drivers/media/v4l2-core/v4l2-fwnode.c
> > > +++ b/drivers/media/v4l2-core/v4l2-fwnode.c
> > > @@ -592,6 +592,117 @@ void v4l2_fwnode_put_link(struct v4l2_fwnode_link *link)
> > > }
> > > EXPORT_SYMBOL_GPL(v4l2_fwnode_put_link);
> > >
> > > +static const struct v4l2_fwnode_connector_conv {
> > > + enum v4l2_connector_type type;
> > > + const char *name;
Maybe compatible instead of name ?
> > > +} connectors[] = {
> > > + {
> > > + .type = V4L2_CON_COMPOSITE,
> > > + .name = "composite-video-connector",
> > > + }, {
> > > + .type = V4L2_CON_SVIDEO,
> > > + .name = "svideo-connector",
> > > + }, {
> > > + .type = V4L2_CON_HDMI,
> > > + .name = "hdmi-connector",
> > > + },
> > > +};
> > > +
> > > +static enum v4l2_connector_type
> > > +v4l2_fwnode_string_to_connector_type(const char *con_str)
> > > +{
> > > + unsigned int i;
> > > +
> > > + for (i = 0; i < ARRAY_SIZE(connectors); i++)
> > > + if (!strcmp(con_str, connectors[i].name))
> > > + return connectors[i].type;
> > > +
> > > + /* no valid connector found */
The usual comment style in this file is to start with a capital letter
and end sentences with a period. I would however drop this comment, it's
not very useful. The other comments should be updated accordingly.
> > > + return V4L2_CON_UNKNOWN;
> > > +}
> > > +
> > > +static int
> > > +v4l2_fwnode_connector_parse_analog(struct fwnode_handle *fwnode,
> > > + struct v4l2_fwnode_connector *vc)
> > > +{
> > > + u32 tvnorms;
> > > + int ret;
> > > +
> > > + ret = fwnode_property_read_u32(fwnode, "tvnorms", &tvnorms);
> > > +
> > > + /* tvnorms is optional */
> > > + vc->connector.analog.supported_tvnorms = ret ? V4L2_STD_ALL : tvnorms;
> > > +
> > > + return 0;
> > > +}
> > > +
Please document all exported functions with kerneldoc.
> > > +int v4l2_fwnode_parse_connector(struct fwnode_handle *__fwnode,
> > > + struct v4l2_fwnode_connector *connector)
> > > +{
> > > + struct fwnode_handle *fwnode;
> > > + struct fwnode_endpoint __ep;
> > > + const char *c_type_str, *label;
> > > + int ret;
> > > +
> > > + memset(connector, 0, sizeof(*connector));
> > > +
> > > + fwnode = fwnode_graph_get_remote_port_parent(__fwnode);
I would rename the argument __fwnode to fwnode, and rename the fwnode
variable to remote (or similar) to make this clearer.
> > > + if (!fwnode)
> > > + return -EINVAL;
Is EINVAL the right error here ? Wouldn't it be useful for the caller to
differentiate between unconnected connector nodes and invalid ones ?
> > > +
> > > + /* parse all common properties first */
> > > + /* connector-type is stored within the compatible string */
> > > + ret = fwnode_property_read_string(fwnode, "compatible", &c_type_str);
Prefixing or postfixing names with types is usually frowned upon. You
could rename this to type_name for instance.
> > > + if (ret) {
> > > + fwnode_handle_put(fwnode);
> > > + return -EINVAL;
> > > + }
> > > +
> > > + connector->type = v4l2_fwnode_string_to_connector_type(c_type_str);
> > > +
> > > + fwnode_graph_parse_endpoint(__fwnode, &__ep);
> > > + connector->remote_port = __ep.port;
> > > + connector->remote_id = __ep.id;
> > > +
> > > + ret = fwnode_property_read_string(fwnode, "label", &label);
> > > + if (!ret) {
> > > + /* ensure label doesn't exceed V4L2_CONNECTOR_MAX_LABEL size */
> > > + strscpy(connector->label, label, V4L2_CONNECTOR_MAX_LABEL);
> > > + } else {
> > > + /*
> > > + * labels are optional, if none is given create one:
> > > + * <connector-type-string>@port<endpoint_port>/ep<endpoint_id>
> > > + */
> > > + snprintf(connector->label, V4L2_CONNECTOR_MAX_LABEL,
> > > + "%s@port%u/ep%u", c_type_str, connector->remote_port,
> > > + connector->remote_id);
Should we really try to create labels when none is available ? If so
this needs much more careful thoughts, we need to think about what the
label will be used for, and create a good naming scheme accordingly. If
the label will be displayed to the end-user I don't think the above name
would be very useful, it would be best to leave it empty and let
applications create a name based on the connector type and other
information they have at their disposal.
> > > + }
> > > +
> > > + /* now parse the connector specific properties */
> > > + switch (connector->type) {
> > > + case V4L2_CON_COMPOSITE:
> > > + /* fall through */
I don't think you need a fall-through comment when the two cases are
adjacent with no line in-between.
> > > + case V4L2_CON_SVIDEO:
> > > + ret = v4l2_fwnode_connector_parse_analog(fwnode, connector);
> > > + break;
> > > + case V4L2_CON_HDMI:
> > > + pr_warn("Connector specific parsing is currently not supported for %s\n",
> > > + c_type_str);
> >
> > Why warn? Just drop this.
>
> good point. I would prefer to have some warning here, in order to warn a
> developer that might be using it that this part of the code would require
> some change.
>
> perhaps pr_warn_once()?
>
> > > + ret = 0;
> > > + break;
If it's not supported we should warn and return an error. Otherwise we
should be silent and return success. Combining a warning with success
isn't a good idea, this is either a normal case or an error, not both.
> > > + case V4L2_CON_UNKNOWN:
> > > + /* fall through */
> > > + default:
> > > + pr_err("Unknown connector type\n");
> > > + ret = -EINVAL;
> > > + };
> > > +
> > > + fwnode_handle_put(fwnode);
> > > +
> > > + return ret;
> > > +}
> > > +EXPORT_SYMBOL_GPL(v4l2_fwnode_parse_connector);
> > > +
> > > static int
> > > v4l2_async_notifier_fwnode_parse_endpoint(struct device *dev,
> > > struct v4l2_async_notifier *notifier,
> > > diff --git a/include/media/v4l2-fwnode.h b/include/media/v4l2-fwnode.h
> > > index f4df1b95c5ef..e072f2915ddb 100644
> > > --- a/include/media/v4l2-fwnode.h
> > > +++ b/include/media/v4l2-fwnode.h
> > > @@ -269,6 +269,22 @@ int v4l2_fwnode_parse_link(struct fwnode_handle *fwnode,
> > > */
> > > void v4l2_fwnode_put_link(struct v4l2_fwnode_link *link);
> > >
And I see here that the function is documented. One more reason to move
kerneldoc to the .c files...
> > > +/**
> > > + * v4l2_fwnode_parse_connector() - parse the connector on endpoint
> > > + * @fwnode: pointer to the endpoint's fwnode handle where the connector is
> > > + * connected to
This is very unclear, I would interpret that as the remote endpoint, not
the local endpoint. Could you please try to clarify the documentation ?
> > > + * @connector: pointer to the V4L2 fwnode connector data structure
> > > + *
> > > + * Fill the connector data structure with the connector type, label and the
> > > + * endpoint id and port where the connector belongs to. If no label is present
> > > + * a unique one will be created. Labels with more than 40 characters are cut.
> > > + *
> > > + * Return: %0 on success or a negative error code on failure:
> > > + * %-EINVAL on parsing failure
> > > + */
> > > +int v4l2_fwnode_parse_connector(struct fwnode_handle *fwnode,
> > > + struct v4l2_fwnode_connector *connector);
> > > +
> > > /**
> > > * typedef parse_endpoint_func - Driver's callback function to be called on
> > > * each V4L2 fwnode endpoint.
--
Regards,
Laurent Pinchart
next prev parent reply other threads:[~2019-05-16 16:51 UTC|newest]
Thread overview: 70+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-04-15 12:44 [PATCH v6 00/13] TVP5150 new features Marco Felsch
2019-04-15 12:44 ` [PATCH v6 01/13] dt-bindings: connector: analog: add tv norms property Marco Felsch
2019-05-06 10:01 ` Hans Verkuil
2019-05-06 10:06 ` Hans Verkuil
2019-05-14 18:11 ` Mauro Carvalho Chehab
2019-08-09 6:00 ` Marco Felsch
2019-05-16 16:27 ` Laurent Pinchart
2019-08-09 5:58 ` Marco Felsch
2019-08-15 12:33 ` Laurent Pinchart
2019-08-15 12:50 ` Marco Felsch
2019-08-15 13:02 ` Laurent Pinchart
2019-08-15 13:35 ` Marco Felsch
2019-04-15 12:44 ` [PATCH v6 02/13] media: v4l2-fwnode: add v4l2_fwnode_connector Marco Felsch
2019-05-06 9:50 ` Hans Verkuil
2019-05-14 18:17 ` Mauro Carvalho Chehab
2019-08-09 7:20 ` Marco Felsch
2019-05-16 16:36 ` Laurent Pinchart
2019-08-09 7:55 ` Marco Felsch
2019-08-15 12:38 ` Laurent Pinchart
2019-08-15 13:04 ` Marco Felsch
2019-08-15 13:10 ` Laurent Pinchart
2019-08-15 13:37 ` Marco Felsch
2019-04-15 12:44 ` [PATCH v6 03/13] media: v4l2-fwnode: add initial connector parsing support Marco Felsch
2019-05-06 10:10 ` Hans Verkuil
2019-05-14 18:20 ` Mauro Carvalho Chehab
2019-05-16 16:51 ` Laurent Pinchart [this message]
2019-08-09 12:16 ` Marco Felsch
2019-08-15 12:48 ` Laurent Pinchart
2019-08-15 13:14 ` Marco Felsch
2019-08-09 8:59 ` Marco Felsch
2019-04-15 12:44 ` [PATCH v6 04/13] partial revert of "[media] tvp5150: add HW input connectors support" Marco Felsch
2019-04-15 12:44 ` [PATCH v6 05/13] media: tvp5150: add input source selection of_graph support Marco Felsch
2019-05-06 10:09 ` Jacopo Mondi
2019-05-14 18:25 ` Mauro Carvalho Chehab
2019-05-16 18:03 ` Laurent Pinchart
2019-08-13 8:54 ` Marco Felsch
2019-08-15 12:51 ` Laurent Pinchart
2019-08-15 13:22 ` Marco Felsch
2019-08-15 13:26 ` Laurent Pinchart
2019-04-15 12:44 ` [PATCH v6 06/13] media: dt-bindings: tvp5150: Add input port connectors DT bindings Marco Felsch
2019-05-14 18:27 ` Mauro Carvalho Chehab
2019-05-16 18:05 ` Laurent Pinchart
2019-08-13 8:56 ` Marco Felsch
2019-04-15 12:44 ` [PATCH v6 07/13] media: tvp5150: add FORMAT_TRY support for get/set selection handlers Marco Felsch
2019-05-06 13:36 ` Jacopo Mondi
2019-08-09 5:33 ` Marco Felsch
2019-05-14 18:48 ` Mauro Carvalho Chehab
2019-08-09 5:34 ` Marco Felsch
2019-04-15 12:44 ` [PATCH v6 08/13] media: tvp5150: initialize subdev before parsing device tree Marco Felsch
2019-05-14 20:20 ` Mauro Carvalho Chehab
2019-08-09 5:42 ` Marco Felsch
2019-04-15 12:44 ` [PATCH v6 09/13] media: tvp5150: add s_power callback Marco Felsch
2019-05-14 20:13 ` Mauro Carvalho Chehab
2019-08-09 5:39 ` Marco Felsch
2019-04-15 12:44 ` [PATCH v6 10/13] media: dt-bindings: tvp5150: cleanup bindings stlye Marco Felsch
2019-04-15 12:44 ` [PATCH v6 11/13] media: dt-bindings: tvp5150: add optional tvnorms documentation Marco Felsch
2019-04-15 12:44 ` [PATCH v6 12/13] media: tvp5150: add support to limit tv norms on connector Marco Felsch
2019-05-16 18:07 ` Laurent Pinchart
2019-08-13 9:10 ` Marco Felsch
2019-08-15 12:53 ` Laurent Pinchart
2019-08-15 13:26 ` Marco Felsch
2019-04-15 12:44 ` [PATCH v6 13/13] media: tvp5150: make debug output more readable Marco Felsch
2019-05-06 13:39 ` Jacopo Mondi
2019-05-14 20:18 ` Mauro Carvalho Chehab
2019-08-09 5:42 ` Marco Felsch
2019-05-06 5:47 ` [PATCH v6 00/13] TVP5150 new features Marco Felsch
2019-05-14 17:18 ` Mauro Carvalho Chehab
2019-05-14 20:20 ` Mauro Carvalho Chehab
2019-05-14 20:58 ` Marco Felsch
2019-05-14 23:41 ` Mauro Carvalho Chehab
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=20190516165114.GP14820@pendragon.ideasonboard.com \
--to=laurent.pinchart@ideasonboard.com \
--cc=devicetree@vger.kernel.org \
--cc=hans.verkuil@cisco.com \
--cc=hverkuil@xs4all.nl \
--cc=jacopo+renesas@jmondi.org \
--cc=jacopo@jmondi.org \
--cc=kernel@pengutronix.de \
--cc=linux-media@vger.kernel.org \
--cc=m.felsch@pengutronix.de \
--cc=mchehab@kernel.org \
--cc=robh+dt@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).