1 /*
2  * OF helpers for the MDIO (Ethernet PHY) API
3  *
4  * Copyright (c) 2009 Secret Lab Technologies, Ltd.
5  *
6  * This file is released under the GPLv2
7  */
8 
9 #ifndef __LINUX_OF_MDIO_H
10 #define __LINUX_OF_MDIO_H
11 
12 #include <linux/phy.h>
13 #include <linux/of.h>
14 
15 #if IS_ENABLED(CONFIG_OF_MDIO)
16 extern int of_mdiobus_register(struct mii_bus *mdio, struct device_node *np);
17 extern struct phy_device *of_phy_find_device(struct device_node *phy_np);
18 extern struct phy_device *of_phy_connect(struct net_device *dev,
19 					 struct device_node *phy_np,
20 					 void (*hndlr)(struct net_device *),
21 					 u32 flags, phy_interface_t iface);
22 extern struct phy_device *
23 of_phy_get_and_connect(struct net_device *dev, struct device_node *np,
24 		       void (*hndlr)(struct net_device *));
25 struct phy_device *of_phy_attach(struct net_device *dev,
26 				 struct device_node *phy_np, u32 flags,
27 				 phy_interface_t iface);
28 
29 extern struct mii_bus *of_mdio_find_bus(struct device_node *mdio_np);
30 extern int of_phy_register_fixed_link(struct device_node *np);
31 extern void of_phy_deregister_fixed_link(struct device_node *np);
32 extern bool of_phy_is_fixed_link(struct device_node *np);
33 
34 
of_mdio_parse_addr(struct device * dev,const struct device_node * np)35 static inline int of_mdio_parse_addr(struct device *dev,
36 				     const struct device_node *np)
37 {
38 	u32 addr;
39 	int ret;
40 
41 	ret = of_property_read_u32(np, "reg", &addr);
42 	if (ret < 0) {
43 		dev_err(dev, "%s has invalid PHY address\n", np->full_name);
44 		return ret;
45 	}
46 
47 	/* A PHY must have a reg property in the range [0-31] */
48 	if (addr >= PHY_MAX_ADDR) {
49 		dev_err(dev, "%s PHY address %i is too large\n",
50 			np->full_name, addr);
51 		return -EINVAL;
52 	}
53 
54 	return addr;
55 }
56 
57 #else /* CONFIG_OF_MDIO */
of_mdiobus_register(struct mii_bus * mdio,struct device_node * np)58 static inline int of_mdiobus_register(struct mii_bus *mdio, struct device_node *np)
59 {
60 	/*
61 	 * Fall back to the non-DT function to register a bus.
62 	 * This way, we don't have to keep compat bits around in drivers.
63 	 */
64 
65 	return mdiobus_register(mdio);
66 }
67 
of_phy_find_device(struct device_node * phy_np)68 static inline struct phy_device *of_phy_find_device(struct device_node *phy_np)
69 {
70 	return NULL;
71 }
72 
of_phy_connect(struct net_device * dev,struct device_node * phy_np,void (* hndlr)(struct net_device *),u32 flags,phy_interface_t iface)73 static inline struct phy_device *of_phy_connect(struct net_device *dev,
74 						struct device_node *phy_np,
75 						void (*hndlr)(struct net_device *),
76 						u32 flags, phy_interface_t iface)
77 {
78 	return NULL;
79 }
80 
81 static inline struct phy_device *
of_phy_get_and_connect(struct net_device * dev,struct device_node * np,void (* hndlr)(struct net_device *))82 of_phy_get_and_connect(struct net_device *dev, struct device_node *np,
83 		       void (*hndlr)(struct net_device *))
84 {
85 	return NULL;
86 }
87 
of_phy_attach(struct net_device * dev,struct device_node * phy_np,u32 flags,phy_interface_t iface)88 static inline struct phy_device *of_phy_attach(struct net_device *dev,
89 					       struct device_node *phy_np,
90 					       u32 flags, phy_interface_t iface)
91 {
92 	return NULL;
93 }
94 
of_mdio_find_bus(struct device_node * mdio_np)95 static inline struct mii_bus *of_mdio_find_bus(struct device_node *mdio_np)
96 {
97 	return NULL;
98 }
99 
of_mdio_parse_addr(struct device * dev,const struct device_node * np)100 static inline int of_mdio_parse_addr(struct device *dev,
101 				     const struct device_node *np)
102 {
103 	return -ENOSYS;
104 }
of_phy_register_fixed_link(struct device_node * np)105 static inline int of_phy_register_fixed_link(struct device_node *np)
106 {
107 	return -ENOSYS;
108 }
of_phy_deregister_fixed_link(struct device_node * np)109 static inline void of_phy_deregister_fixed_link(struct device_node *np)
110 {
111 }
of_phy_is_fixed_link(struct device_node * np)112 static inline bool of_phy_is_fixed_link(struct device_node *np)
113 {
114 	return false;
115 }
116 #endif
117 
118 
119 #endif /* __LINUX_OF_MDIO_H */
120