diff mbox series

[v2,03/14] media: stm32: Use v4l2_async_notifier_add_fwnode_remote_subdev

Message ID 20210118015258.3993-4-ezequiel@collabora.com
State Superseded
Headers show
Series [v2,01/14] media: v4l2-async: Clean v4l2_async_notifier_add_fwnode_remote_subdev | expand

Commit Message

Ezequiel Garcia Jan. 18, 2021, 1:52 a.m. UTC
The use of v4l2_async_notifier_add_subdev will be discouraged.
Drivers are instead encouraged to use a helper such as
v4l2_async_notifier_add_fwnode_remote_subdev.

This fixes a misuse of the API, as v4l2_async_notifier_add_subdev
should get a kmalloc'ed struct v4l2_async_subdev,
removing some boilerplate code while at it.

Use the appropriate helper v4l2_async_notifier_add_fwnode_remote_subdev,
which handles the needed setup, instead of open-coding it.

This results in removal of the now unneeded driver-specific state
struct dcmi_graph_entity, keeping track of just the source
subdevice.

Signed-off-by: Ezequiel Garcia <ezequiel@collabora.com>
Reviewed-by: Jacopo Mondi <jacopo+renesas@jmondi.org>
---
 drivers/media/platform/stm32/stm32-dcmi.c | 86 ++++++++---------------
 1 file changed, 30 insertions(+), 56 deletions(-)

Comments

Helen Mae Koike Fornazier Jan. 19, 2021, 6:51 p.m. UTC | #1
On 1/17/21 10:52 PM, Ezequiel Garcia wrote:
> The use of v4l2_async_notifier_add_subdev will be discouraged.

> Drivers are instead encouraged to use a helper such as

> v4l2_async_notifier_add_fwnode_remote_subdev.

> 

> This fixes a misuse of the API, as v4l2_async_notifier_add_subdev

> should get a kmalloc'ed struct v4l2_async_subdev,

> removing some boilerplate code while at it.

> 

> Use the appropriate helper v4l2_async_notifier_add_fwnode_remote_subdev,

> which handles the needed setup, instead of open-coding it.

> 

> This results in removal of the now unneeded driver-specific state

> struct dcmi_graph_entity, keeping track of just the source

> subdevice.

> 

> Signed-off-by: Ezequiel Garcia <ezequiel@collabora.com>

> Reviewed-by: Jacopo Mondi <jacopo+renesas@jmondi.org>


Reviewed-by: Helen Koike <helen.koike@collabora.com>


> ---

>  drivers/media/platform/stm32/stm32-dcmi.c | 86 ++++++++---------------

>  1 file changed, 30 insertions(+), 56 deletions(-)

> 

> diff --git a/drivers/media/platform/stm32/stm32-dcmi.c b/drivers/media/platform/stm32/stm32-dcmi.c

> index b745f1342c2e..142f63d07dcd 100644

> --- a/drivers/media/platform/stm32/stm32-dcmi.c

> +++ b/drivers/media/platform/stm32/stm32-dcmi.c

> @@ -99,13 +99,6 @@ enum state {

>  

>  #define OVERRUN_ERROR_THRESHOLD	3

>  

> -struct dcmi_graph_entity {

> -	struct v4l2_async_subdev asd;

> -

> -	struct device_node *remote_node;

> -	struct v4l2_subdev *source;

> -};

> -

>  struct dcmi_format {

>  	u32	fourcc;

>  	u32	mbus_code;

> @@ -139,7 +132,7 @@ struct stm32_dcmi {

>  	struct v4l2_device		v4l2_dev;

>  	struct video_device		*vdev;

>  	struct v4l2_async_notifier	notifier;

> -	struct dcmi_graph_entity	entity;

> +	struct v4l2_subdev		*source;

>  	struct v4l2_format		fmt;

>  	struct v4l2_rect		crop;

>  	bool				do_crop;

> @@ -610,7 +603,7 @@ static int dcmi_pipeline_s_fmt(struct stm32_dcmi *dcmi,

>  			       struct v4l2_subdev_pad_config *pad_cfg,

>  			       struct v4l2_subdev_format *format)

>  {

> -	struct media_entity *entity = &dcmi->entity.source->entity;

> +	struct media_entity *entity = &dcmi->source->entity;

>  	struct v4l2_subdev *subdev;

>  	struct media_pad *sink_pad = NULL;

>  	struct media_pad *src_pad = NULL;

> @@ -1018,7 +1011,7 @@ static int dcmi_try_fmt(struct stm32_dcmi *dcmi, struct v4l2_format *f,

>  	}

>  

>  	v4l2_fill_mbus_format(&format.format, pix, sd_fmt->mbus_code);

> -	ret = v4l2_subdev_call(dcmi->entity.source, pad, set_fmt,

> +	ret = v4l2_subdev_call(dcmi->source, pad, set_fmt,

>  			       &pad_cfg, &format);

>  	if (ret < 0)

>  		return ret;

> @@ -1152,7 +1145,7 @@ static int dcmi_get_sensor_format(struct stm32_dcmi *dcmi,

>  	};

>  	int ret;

>  

> -	ret = v4l2_subdev_call(dcmi->entity.source, pad, get_fmt, NULL, &fmt);

> +	ret = v4l2_subdev_call(dcmi->source, pad, get_fmt, NULL, &fmt);

>  	if (ret)

>  		return ret;

>  

> @@ -1181,7 +1174,7 @@ static int dcmi_set_sensor_format(struct stm32_dcmi *dcmi,

>  	}

>  

>  	v4l2_fill_mbus_format(&format.format, pix, sd_fmt->mbus_code);

> -	ret = v4l2_subdev_call(dcmi->entity.source, pad, set_fmt,

> +	ret = v4l2_subdev_call(dcmi->source, pad, set_fmt,

>  			       &pad_cfg, &format);

>  	if (ret < 0)

>  		return ret;

> @@ -1204,7 +1197,7 @@ static int dcmi_get_sensor_bounds(struct stm32_dcmi *dcmi,

>  	/*

>  	 * Get sensor bounds first

>  	 */

> -	ret = v4l2_subdev_call(dcmi->entity.source, pad, get_selection,

> +	ret = v4l2_subdev_call(dcmi->source, pad, get_selection,

>  			       NULL, &bounds);

>  	if (!ret)

>  		*r = bounds.r;

> @@ -1385,7 +1378,7 @@ static int dcmi_enum_framesizes(struct file *file, void *fh,

>  

>  	fse.code = sd_fmt->mbus_code;

>  

> -	ret = v4l2_subdev_call(dcmi->entity.source, pad, enum_frame_size,

> +	ret = v4l2_subdev_call(dcmi->source, pad, enum_frame_size,

>  			       NULL, &fse);

>  	if (ret)

>  		return ret;

> @@ -1402,7 +1395,7 @@ static int dcmi_g_parm(struct file *file, void *priv,

>  {

>  	struct stm32_dcmi *dcmi = video_drvdata(file);

>  

> -	return v4l2_g_parm_cap(video_devdata(file), dcmi->entity.source, p);

> +	return v4l2_g_parm_cap(video_devdata(file), dcmi->source, p);

>  }

>  

>  static int dcmi_s_parm(struct file *file, void *priv,

> @@ -1410,7 +1403,7 @@ static int dcmi_s_parm(struct file *file, void *priv,

>  {

>  	struct stm32_dcmi *dcmi = video_drvdata(file);

>  

> -	return v4l2_s_parm_cap(video_devdata(file), dcmi->entity.source, p);

> +	return v4l2_s_parm_cap(video_devdata(file), dcmi->source, p);

>  }

>  

>  static int dcmi_enum_frameintervals(struct file *file, void *fh,

> @@ -1432,7 +1425,7 @@ static int dcmi_enum_frameintervals(struct file *file, void *fh,

>  

>  	fie.code = sd_fmt->mbus_code;

>  

> -	ret = v4l2_subdev_call(dcmi->entity.source, pad,

> +	ret = v4l2_subdev_call(dcmi->source, pad,

>  			       enum_frame_interval, NULL, &fie);

>  	if (ret)

>  		return ret;

> @@ -1452,7 +1445,7 @@ MODULE_DEVICE_TABLE(of, stm32_dcmi_of_match);

>  static int dcmi_open(struct file *file)

>  {

>  	struct stm32_dcmi *dcmi = video_drvdata(file);

> -	struct v4l2_subdev *sd = dcmi->entity.source;

> +	struct v4l2_subdev *sd = dcmi->source;

>  	int ret;

>  

>  	if (mutex_lock_interruptible(&dcmi->lock))

> @@ -1483,7 +1476,7 @@ static int dcmi_open(struct file *file)

>  static int dcmi_release(struct file *file)

>  {

>  	struct stm32_dcmi *dcmi = video_drvdata(file);

> -	struct v4l2_subdev *sd = dcmi->entity.source;

> +	struct v4l2_subdev *sd = dcmi->source;

>  	bool fh_singular;

>  	int ret;

>  

> @@ -1616,7 +1609,7 @@ static int dcmi_formats_init(struct stm32_dcmi *dcmi)

>  {

>  	const struct dcmi_format *sd_fmts[ARRAY_SIZE(dcmi_formats)];

>  	unsigned int num_fmts = 0, i, j;

> -	struct v4l2_subdev *subdev = dcmi->entity.source;

> +	struct v4l2_subdev *subdev = dcmi->source;

>  	struct v4l2_subdev_mbus_code_enum mbus_code = {

>  		.which = V4L2_SUBDEV_FORMAT_ACTIVE,

>  	};

> @@ -1675,7 +1668,7 @@ static int dcmi_formats_init(struct stm32_dcmi *dcmi)

>  static int dcmi_framesizes_init(struct stm32_dcmi *dcmi)

>  {

>  	unsigned int num_fsize = 0;

> -	struct v4l2_subdev *subdev = dcmi->entity.source;

> +	struct v4l2_subdev *subdev = dcmi->source;

>  	struct v4l2_subdev_frame_size_enum fse = {

>  		.which = V4L2_SUBDEV_FORMAT_ACTIVE,

>  		.code = dcmi->sd_format->mbus_code,

> @@ -1727,14 +1720,13 @@ static int dcmi_graph_notify_complete(struct v4l2_async_notifier *notifier)

>  	 * we search for the source subdevice

>  	 * in order to expose it through V4L2 interface

>  	 */

> -	dcmi->entity.source =

> -		media_entity_to_v4l2_subdev(dcmi_find_source(dcmi));

> -	if (!dcmi->entity.source) {

> +	dcmi->source = media_entity_to_v4l2_subdev(dcmi_find_source(dcmi));

> +	if (!dcmi->source) {

>  		dev_err(dcmi->dev, "Source subdevice not found\n");

>  		return -ENODEV;

>  	}

>  

> -	dcmi->vdev->ctrl_handler = dcmi->entity.source->ctrl_handler;

> +	dcmi->vdev->ctrl_handler = dcmi->source->ctrl_handler;

>  

>  	ret = dcmi_formats_init(dcmi);

>  	if (ret) {

> @@ -1813,46 +1805,28 @@ static const struct v4l2_async_notifier_operations dcmi_graph_notify_ops = {

>  	.complete = dcmi_graph_notify_complete,

>  };

>  

> -static int dcmi_graph_parse(struct stm32_dcmi *dcmi, struct device_node *node)

> -{

> -	struct device_node *ep = NULL;

> -	struct device_node *remote;

> -

> -	ep = of_graph_get_next_endpoint(node, ep);

> -	if (!ep)

> -		return -EINVAL;

> -

> -	remote = of_graph_get_remote_port_parent(ep);

> -	of_node_put(ep);

> -	if (!remote)

> -		return -EINVAL;

> -

> -	/* Remote node to connect */

> -	dcmi->entity.remote_node = remote;

> -	dcmi->entity.asd.match_type = V4L2_ASYNC_MATCH_FWNODE;

> -	dcmi->entity.asd.match.fwnode = of_fwnode_handle(remote);

> -	return 0;

> -}

> -

>  static int dcmi_graph_init(struct stm32_dcmi *dcmi)

>  {

> +	struct v4l2_async_subdev *asd;

> +	struct device_node *ep;

>  	int ret;

>  

> -	/* Parse the graph to extract a list of subdevice DT nodes. */

> -	ret = dcmi_graph_parse(dcmi, dcmi->dev->of_node);

> -	if (ret < 0) {

> -		dev_err(dcmi->dev, "Failed to parse graph\n");

> -		return ret;

> +	ep = of_graph_get_next_endpoint(dcmi->dev->of_node, NULL);

> +	if (!ep) {

> +		dev_err(dcmi->dev, "Failed to get next endpoint\n");

> +		return -EINVAL;

>  	}

>  

>  	v4l2_async_notifier_init(&dcmi->notifier);

>  

> -	ret = v4l2_async_notifier_add_subdev(&dcmi->notifier,

> -					     &dcmi->entity.asd);

> -	if (ret) {

> +	asd = v4l2_async_notifier_add_fwnode_remote_subdev(

> +		&dcmi->notifier, of_fwnode_handle(ep), sizeof(*asd));

> +

> +	of_node_put(ep);

> +

> +	if (IS_ERR(asd)) {

>  		dev_err(dcmi->dev, "Failed to add subdev notifier\n");

> -		of_node_put(dcmi->entity.remote_node);

> -		return ret;

> +		return PTR_ERR(asd);

>  	}

>  

>  	dcmi->notifier.ops = &dcmi_graph_notify_ops;

>
diff mbox series

Patch

diff --git a/drivers/media/platform/stm32/stm32-dcmi.c b/drivers/media/platform/stm32/stm32-dcmi.c
index b745f1342c2e..142f63d07dcd 100644
--- a/drivers/media/platform/stm32/stm32-dcmi.c
+++ b/drivers/media/platform/stm32/stm32-dcmi.c
@@ -99,13 +99,6 @@  enum state {
 
 #define OVERRUN_ERROR_THRESHOLD	3
 
-struct dcmi_graph_entity {
-	struct v4l2_async_subdev asd;
-
-	struct device_node *remote_node;
-	struct v4l2_subdev *source;
-};
-
 struct dcmi_format {
 	u32	fourcc;
 	u32	mbus_code;
@@ -139,7 +132,7 @@  struct stm32_dcmi {
 	struct v4l2_device		v4l2_dev;
 	struct video_device		*vdev;
 	struct v4l2_async_notifier	notifier;
-	struct dcmi_graph_entity	entity;
+	struct v4l2_subdev		*source;
 	struct v4l2_format		fmt;
 	struct v4l2_rect		crop;
 	bool				do_crop;
@@ -610,7 +603,7 @@  static int dcmi_pipeline_s_fmt(struct stm32_dcmi *dcmi,
 			       struct v4l2_subdev_pad_config *pad_cfg,
 			       struct v4l2_subdev_format *format)
 {
-	struct media_entity *entity = &dcmi->entity.source->entity;
+	struct media_entity *entity = &dcmi->source->entity;
 	struct v4l2_subdev *subdev;
 	struct media_pad *sink_pad = NULL;
 	struct media_pad *src_pad = NULL;
@@ -1018,7 +1011,7 @@  static int dcmi_try_fmt(struct stm32_dcmi *dcmi, struct v4l2_format *f,
 	}
 
 	v4l2_fill_mbus_format(&format.format, pix, sd_fmt->mbus_code);
-	ret = v4l2_subdev_call(dcmi->entity.source, pad, set_fmt,
+	ret = v4l2_subdev_call(dcmi->source, pad, set_fmt,
 			       &pad_cfg, &format);
 	if (ret < 0)
 		return ret;
@@ -1152,7 +1145,7 @@  static int dcmi_get_sensor_format(struct stm32_dcmi *dcmi,
 	};
 	int ret;
 
-	ret = v4l2_subdev_call(dcmi->entity.source, pad, get_fmt, NULL, &fmt);
+	ret = v4l2_subdev_call(dcmi->source, pad, get_fmt, NULL, &fmt);
 	if (ret)
 		return ret;
 
@@ -1181,7 +1174,7 @@  static int dcmi_set_sensor_format(struct stm32_dcmi *dcmi,
 	}
 
 	v4l2_fill_mbus_format(&format.format, pix, sd_fmt->mbus_code);
-	ret = v4l2_subdev_call(dcmi->entity.source, pad, set_fmt,
+	ret = v4l2_subdev_call(dcmi->source, pad, set_fmt,
 			       &pad_cfg, &format);
 	if (ret < 0)
 		return ret;
@@ -1204,7 +1197,7 @@  static int dcmi_get_sensor_bounds(struct stm32_dcmi *dcmi,
 	/*
 	 * Get sensor bounds first
 	 */
-	ret = v4l2_subdev_call(dcmi->entity.source, pad, get_selection,
+	ret = v4l2_subdev_call(dcmi->source, pad, get_selection,
 			       NULL, &bounds);
 	if (!ret)
 		*r = bounds.r;
@@ -1385,7 +1378,7 @@  static int dcmi_enum_framesizes(struct file *file, void *fh,
 
 	fse.code = sd_fmt->mbus_code;
 
-	ret = v4l2_subdev_call(dcmi->entity.source, pad, enum_frame_size,
+	ret = v4l2_subdev_call(dcmi->source, pad, enum_frame_size,
 			       NULL, &fse);
 	if (ret)
 		return ret;
@@ -1402,7 +1395,7 @@  static int dcmi_g_parm(struct file *file, void *priv,
 {
 	struct stm32_dcmi *dcmi = video_drvdata(file);
 
-	return v4l2_g_parm_cap(video_devdata(file), dcmi->entity.source, p);
+	return v4l2_g_parm_cap(video_devdata(file), dcmi->source, p);
 }
 
 static int dcmi_s_parm(struct file *file, void *priv,
@@ -1410,7 +1403,7 @@  static int dcmi_s_parm(struct file *file, void *priv,
 {
 	struct stm32_dcmi *dcmi = video_drvdata(file);
 
-	return v4l2_s_parm_cap(video_devdata(file), dcmi->entity.source, p);
+	return v4l2_s_parm_cap(video_devdata(file), dcmi->source, p);
 }
 
 static int dcmi_enum_frameintervals(struct file *file, void *fh,
@@ -1432,7 +1425,7 @@  static int dcmi_enum_frameintervals(struct file *file, void *fh,
 
 	fie.code = sd_fmt->mbus_code;
 
-	ret = v4l2_subdev_call(dcmi->entity.source, pad,
+	ret = v4l2_subdev_call(dcmi->source, pad,
 			       enum_frame_interval, NULL, &fie);
 	if (ret)
 		return ret;
@@ -1452,7 +1445,7 @@  MODULE_DEVICE_TABLE(of, stm32_dcmi_of_match);
 static int dcmi_open(struct file *file)
 {
 	struct stm32_dcmi *dcmi = video_drvdata(file);
-	struct v4l2_subdev *sd = dcmi->entity.source;
+	struct v4l2_subdev *sd = dcmi->source;
 	int ret;
 
 	if (mutex_lock_interruptible(&dcmi->lock))
@@ -1483,7 +1476,7 @@  static int dcmi_open(struct file *file)
 static int dcmi_release(struct file *file)
 {
 	struct stm32_dcmi *dcmi = video_drvdata(file);
-	struct v4l2_subdev *sd = dcmi->entity.source;
+	struct v4l2_subdev *sd = dcmi->source;
 	bool fh_singular;
 	int ret;
 
@@ -1616,7 +1609,7 @@  static int dcmi_formats_init(struct stm32_dcmi *dcmi)
 {
 	const struct dcmi_format *sd_fmts[ARRAY_SIZE(dcmi_formats)];
 	unsigned int num_fmts = 0, i, j;
-	struct v4l2_subdev *subdev = dcmi->entity.source;
+	struct v4l2_subdev *subdev = dcmi->source;
 	struct v4l2_subdev_mbus_code_enum mbus_code = {
 		.which = V4L2_SUBDEV_FORMAT_ACTIVE,
 	};
@@ -1675,7 +1668,7 @@  static int dcmi_formats_init(struct stm32_dcmi *dcmi)
 static int dcmi_framesizes_init(struct stm32_dcmi *dcmi)
 {
 	unsigned int num_fsize = 0;
-	struct v4l2_subdev *subdev = dcmi->entity.source;
+	struct v4l2_subdev *subdev = dcmi->source;
 	struct v4l2_subdev_frame_size_enum fse = {
 		.which = V4L2_SUBDEV_FORMAT_ACTIVE,
 		.code = dcmi->sd_format->mbus_code,
@@ -1727,14 +1720,13 @@  static int dcmi_graph_notify_complete(struct v4l2_async_notifier *notifier)
 	 * we search for the source subdevice
 	 * in order to expose it through V4L2 interface
 	 */
-	dcmi->entity.source =
-		media_entity_to_v4l2_subdev(dcmi_find_source(dcmi));
-	if (!dcmi->entity.source) {
+	dcmi->source = media_entity_to_v4l2_subdev(dcmi_find_source(dcmi));
+	if (!dcmi->source) {
 		dev_err(dcmi->dev, "Source subdevice not found\n");
 		return -ENODEV;
 	}
 
-	dcmi->vdev->ctrl_handler = dcmi->entity.source->ctrl_handler;
+	dcmi->vdev->ctrl_handler = dcmi->source->ctrl_handler;
 
 	ret = dcmi_formats_init(dcmi);
 	if (ret) {
@@ -1813,46 +1805,28 @@  static const struct v4l2_async_notifier_operations dcmi_graph_notify_ops = {
 	.complete = dcmi_graph_notify_complete,
 };
 
-static int dcmi_graph_parse(struct stm32_dcmi *dcmi, struct device_node *node)
-{
-	struct device_node *ep = NULL;
-	struct device_node *remote;
-
-	ep = of_graph_get_next_endpoint(node, ep);
-	if (!ep)
-		return -EINVAL;
-
-	remote = of_graph_get_remote_port_parent(ep);
-	of_node_put(ep);
-	if (!remote)
-		return -EINVAL;
-
-	/* Remote node to connect */
-	dcmi->entity.remote_node = remote;
-	dcmi->entity.asd.match_type = V4L2_ASYNC_MATCH_FWNODE;
-	dcmi->entity.asd.match.fwnode = of_fwnode_handle(remote);
-	return 0;
-}
-
 static int dcmi_graph_init(struct stm32_dcmi *dcmi)
 {
+	struct v4l2_async_subdev *asd;
+	struct device_node *ep;
 	int ret;
 
-	/* Parse the graph to extract a list of subdevice DT nodes. */
-	ret = dcmi_graph_parse(dcmi, dcmi->dev->of_node);
-	if (ret < 0) {
-		dev_err(dcmi->dev, "Failed to parse graph\n");
-		return ret;
+	ep = of_graph_get_next_endpoint(dcmi->dev->of_node, NULL);
+	if (!ep) {
+		dev_err(dcmi->dev, "Failed to get next endpoint\n");
+		return -EINVAL;
 	}
 
 	v4l2_async_notifier_init(&dcmi->notifier);
 
-	ret = v4l2_async_notifier_add_subdev(&dcmi->notifier,
-					     &dcmi->entity.asd);
-	if (ret) {
+	asd = v4l2_async_notifier_add_fwnode_remote_subdev(
+		&dcmi->notifier, of_fwnode_handle(ep), sizeof(*asd));
+
+	of_node_put(ep);
+
+	if (IS_ERR(asd)) {
 		dev_err(dcmi->dev, "Failed to add subdev notifier\n");
-		of_node_put(dcmi->entity.remote_node);
-		return ret;
+		return PTR_ERR(asd);
 	}
 
 	dcmi->notifier.ops = &dcmi_graph_notify_ops;