u-boot.git/include/generic-phy.h, branch v2022.04

doc: replace @return by Return:

2022-01-19T17:11:34+00:00

Sphinx expects Return: and not @return to indicate a return value.

find . -name '*.c' -exec \
sed -i 's/^\(\s\)\*\(\s*\)@return\(\s\)/\1*\2Return:\3/' {} \;

find . -name '*.h' -exec \
sed -i 's/^\(\s\)\*\(\s*\)@return\(\s\)/\1*\2Return:\3/' {} \;

Signed-off-by: Heinrich Schuchardt

WS cleanup: remove SPACE(s) followed by TAB

2021-09-30T13:08:16+00:00

Signed-off-by: Wolfgang Denk

generic-phy: add configure op

2021-02-10T09:00:51+00:00

Add the PHY configure op callback to the generic PHY uclass to permit
configuring the PHY.

It's useful for MIPI DSI PHYs to setup the link timings.

Signed-off-by:Neil Armstrong 
Signed-off-by: Neil Armstrong

phy: Use _nodev naming convention if non-device clients

2020-05-10T20:00:49+00:00

Clients that are requesting some of uclass API's
without a device (with ofnode) usually have _nodev
naming convention.

- clk_get_by_index_nodev
- clk_get_by_name_nodev
- reset_get_by_index_nodev
- gpio_request_by_name_nodev

So, update the same naming convention PHY framework.

This doesn't change the existing functionality.

Cc: Neil Armstrong 
Cc: Tom Rini 
Signed-off-by: Jagan Teki

phy: Fix node description of phy_get_by_node

2020-05-10T20:00:49+00:00

node is most of device related API's are termed as device
node and without device related API's are termed as ofnode.

generic_phy_get_by_node API is without device API, so fixed
the node description as ofnode.

Cc: Neil Armstrong 
Cc: Tom Rini 
Signed-off-by: Jagan Teki

phy: Add API for a bulk of phys

2020-05-02T10:32:28+00:00

This patch adds a "bulk" API to the phy API in order to
get/init/exit/power on/off a group of phys associated
with a device.

The bulk API will avoid adding a copy of the same code to
manage a group of phys in drivers.

Signed-off-by: Chunfeng Yun 
Signed-off-by: Frank Wunderlich 
Reviewed-by: Weijie Gao 
Reviewed-by: Jagan Teki

generic-phy: add generic_phy_get_by_node()

2020-04-20T12:19:10+00:00

Add generic_phy_get_by_node() to get a PHY phandle from a node instead
of a udevice.

Signed-off-by: Neil Armstrong 
Reviewed-by: Tom Rini 
[narmstrong: fixed by including ofnode.h in generic-phy.h]

drivers: phy: Handle gracefully NULL pointers

2019-10-31T11:22:53+00:00

For some controllers PHYs can be optional. Handling NULL pointers without
crashing nor failing, makes it easy to handle optional PHYs.

Signed-off-by: Jean-Jacques Hiblot

phy: Fix warning due to missing definition of structure

2018-08-28T09:00:18+00:00

Fix this sort of warning if generic-phy.h is included:

include/generic-phy.h:52:42: warning: ‘struct ofnode_phandle_args’ declared inside parameter list will not be visible outside of this definition or declaration
  int (*of_xlate)(struct phy *phy, struct ofnode_phandle_args *args);

Signed-off-by: Marek Vasut

SPDX: Convert all of our single license tags to Linux Kernel style

2018-05-07T13:34:12+00:00

When U-Boot started using SPDX tags we were among the early adopters and
there weren't a lot of other examples to borrow from.  So we picked the
area of the file that usually had a full license text and replaced it
with an appropriate SPDX-License-Identifier: entry.  Since then, the
Linux Kernel has adopted SPDX tags and they place it as the very first
line in a file (except where shebangs are used, then it's second line)
and with slightly different comment styles than us.

In part due to community overlap, in part due to better tag visibility
and in part for other minor reasons, switch over to that style.

This commit changes all instances where we have a single declared
license in the tag as both the before and after are identical in tag
contents.  There's also a few places where I found we did not have a tag
and have introduced one.

Signed-off-by: Tom Rini