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