Re: [PATCH v9 01/15] device property: Add fwnode_graph_get_port_by_id()

[sashiko-bot@kernel.org]

Thank you for your contribution! Sashiko AI review found 1 potential issue(s) to consider:
- [Low] device property: missing const on fwnode in fwnode_graph_get_port_by_id()
--

commit 926d6f7fd488c33560eef4ae4903250ddf63b081
Author: Chen-Yu Tsai <wenst@chromium.org>

device property: Add fwnode_graph_get_port_by_id()

This commit introduces a helper function to retrieve a port firmware node
matching a given ID. It is designed to support upcoming USB power sequencing
integration where a USB hub port is tied to its corresponding firmware node.

> diff --git a/drivers/base/property.c b/drivers/base/property.c
> index cceaa3240ca48..576488c151810 100644
> --- a/drivers/base/property.c
> +++ b/drivers/base/property.c

[ ... ]

> @@ -1353,6 +1353,37 @@ int fwnode_graph_parse_endpoint(const struct fwnode_handle *fwnode,
>  }
>  EXPORT_SYMBOL(fwnode_graph_parse_endpoint);
>  
> +/**
> + * fwnode_graph_get_port_by_id - get the port matching a given id
> + * @fwnode: parent fwnode_handle containing the graph
> + * @id: id of the port
> + * @flags: fwnode lookup flags
> + *
> + * The caller is responsible for calling fwnode_handle_put() on the returned
> + * fwnode pointer.
> + *
> + * Does not return ports that belong to disabled devices or endpoints that
> + * are unconnected, unless FWNODE_GRAPH_DEVICE_DISABLED is passed in @flags.
> + *
> + * Does not return ports that have no endpoints.
> + *
> + * Return: A 'port' firmware node pointer with refcount incremented.
> + */
> +struct fwnode_handle *fwnode_graph_get_port_by_id(struct fwnode_handle *fwnode,
> +						  u32 id,
> +						  unsigned long flags)

[Severity: Low]
Could the fwnode parameter be marked const here?

The fwnode pointer is only passed to fwnode_graph_get_endpoint_by_id(), which
already accepts a const struct fwnode_handle pointer. Marking it const here
would improve consistency with the rest of the fwnode graph API and prevent
callers with a const pointer from having to cast it away.

> +{
> +	struct fwnode_handle *ep;
> +
> +	ep = fwnode_graph_get_endpoint_by_id(fwnode, id, 0,
> +					     flags | FWNODE_GRAPH_ENDPOINT_NEXT);
> +	if (!ep)
> +		return NULL;
> +
> +	return fwnode_get_next_parent(ep);
> +}
> +EXPORT_SYMBOL_GPL(fwnode_graph_get_port_by_id);

[ ... ]

> diff --git a/include/linux/property.h b/include/linux/property.h
> index 907c790a3f013..3dbbd01a52d09 100644
> --- a/include/linux/property.h
> +++ b/include/linux/property.h

[ ... ]

> @@ -507,6 +507,8 @@ int fwnode_get_phy_mode(const struct fwnode_handle *fwnode);
>  
>  void __iomem *fwnode_iomap(struct fwnode_handle *fwnode, int index);
>  
> +struct fwnode_handle *fwnode_graph_get_port_by_id(struct fwnode_handle *fwnode, u32 id,
> +						  unsigned long flags);

[Severity: Low]
Would it make sense to update this prototype to accept a const struct 
fwnode_handle if the implementation is adjusted as suggested above?

>  struct fwnode_handle *fwnode_graph_get_next_endpoint(
>  	const struct fwnode_handle *fwnode, struct fwnode_handle *prev);
>  struct fwnode_handle *

-- 
Sashiko AI review · https://sashiko.dev/#/patchset/20260916075745.3549953-1-wenst@chromium.org?part=1