Skip to contentSkip to conversation

phy: Fix node description of phy_get_by_node

PATCH New Jagan Teki 1 participant 4 messages May 1, 2020 – May 7, 2020

Subsystems (4)
lore
Share & tools
lore

Jagan Teki

author
#0 lore raw

PATCH 1/2 phy: Fix node description of phy_get_by_node

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 <[email protected]>
Cc Tom Rini <[email protected]>
---
 include/generic-phy.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
include/generic-phy.h +1 -1
index 73537025c2..e30440d35e 100644
@@ -198,7 +198,7 @@ int generic_phy_get_by_index(struct udevice *user, int index,
 /**
  * generic_phy_get_by_node() - Get a PHY device by integer index on ofnode
  *
- * @node:	the device node
+ * @node:	The client ofnode.
  * @index:	The index in the list of available PHYs
  * @phy:	A pointer to the PHY port
  *
Signature · 1 line
2.17.1
author
#1 lore raw

PATCH 2/2 phy: Use _nodev naming convention if non-device clients

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 <[email protected]>
Cc Tom Rini <[email protected]>
---
 arch/arm/mach-meson/board-gx.c | 3 ++-
 drivers/phy/phy-uclass.c       | 4 ++--
 include/generic-phy.h          | 7 +++++--
 3 files changed, 9 insertions(+), 5 deletions(-)
arch/arm/mach-meson/board-gx.c +2 -1
index 3da99017a5..b591c924ea 100644
@@ -183,7 +183,8 @@ int board_usb_init(int index, enum usb_init_type init)
 
 	/* get the PHYs */
 	for (i = 0; i < 2; i++) {
-		ret = generic_phy_get_by_node(dwc2_node, i, &usb_phys[i]);
+		ret = generic_phy_get_by_index_nodev(dwc2_node, i,
+						     &usb_phys[i]);
 		if (ret && ret != -ENOENT) {
 			pr_err("Failed to get USB PHY%d for %s\n",
 			       i, ofnode_get_name(dwc2_node));
drivers/phy/phy-uclass.c +2 -2
index e463b0b400..8091fc0969 100644
@@ -31,7 +31,7 @@ static int generic_phy_xlate_offs_flags(struct phy *phy,
 	return 0;
 }
 
-int generic_phy_get_by_node(ofnode node, int index, struct phy *phy)
+int generic_phy_get_by_index_nodev(ofnode node, int index, struct phy *phy)
 {
 	struct ofnode_phandle_args args;
 	struct phy_ops *ops;
@@ -93,7 +93,7 @@ err:
 int generic_phy_get_by_index(struct udevice *dev, int index,
 			     struct phy *phy)
 {
-	return generic_phy_get_by_node(dev_ofnode(dev), index, phy);
+	return generic_phy_get_by_index_nodev(dev_ofnode(dev), index, phy);
 }
 
 int generic_phy_get_by_name(struct udevice *dev, const char *phy_name,
include/generic-phy.h +5 -2
index e30440d35e..07e4c6f7a0 100644
@@ -196,12 +196,15 @@ int generic_phy_get_by_index(struct udevice *user, int index,
 			     struct phy *phy);
 
 /**
- * generic_phy_get_by_node() - Get a PHY device by integer index on ofnode
+ * generic_phy_get_by_index_nodev() - Get a PHY device by integer index
+ * without a device
  *
  * @node:	The client ofnode.
  * @index:	The index in the list of available PHYs
  * @phy:	A pointer to the PHY port
  *
+ * This is a version of generic_phy_get_by_index() that does not use a device.
+ *
  * This looks up a PHY device for a client device based on its ofnode and on
  * its position in the list of the possible PHYs.
  *
@@ -220,7 +223,7 @@ int generic_phy_get_by_index(struct udevice *user, int index,
  *
  * @return 0 if OK, or a negative error code
  */
-int generic_phy_get_by_node(ofnode node, int index, struct phy *phy);
+int generic_phy_get_by_index_nodev(ofnode node, int index, struct phy *phy);
 
 /**
  * generic_phy_get_by_name() - Get a PHY device by its name.
Signature · 1 line
2.17.1
author
#2 lore raw

PATCH 2/2 phy: Use _nodev naming convention if non-device clients

Hi Tom,

Quoted 10 lines · Jagan Teki

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

Quoted 8 lines

So, update the same naming convention PHY framework.

This doesn't change the existing functionality.

Cc Neil Armstrong <[email protected]>
Cc Tom Rini <[email protected]>

---

Planning to apply these via spi tree, let me know if you have any questions? thanks!

Jagan.

author
#3 lore raw

PATCH 2/2 phy: Use _nodev naming convention if non-device clients

In reply to Jagan Teki
Quoted 10 lines · Jagan Teki

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

Quoted 8 lines

So, update the same naming convention PHY framework.

This doesn't change the existing functionality.

Cc Neil Armstrong <[email protected]>
Cc Tom Rini <[email protected]>

---

Applied both to u-boot-spi/master