Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
tjh.dev
kernel
os
linux
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)
16bool of_mdiobus_child_is_phy(struct device_node *child);
17int of_mdiobus_register(struct mii_bus *mdio, struct device_node *np);
18int devm_of_mdiobus_register(struct device *dev, struct mii_bus *mdio,
19 struct device_node *np);
20struct mdio_device *of_mdio_find_device(struct device_node *np);
21struct phy_device *of_phy_find_device(struct device_node *phy_np);
22struct phy_device *
23of_phy_connect(struct net_device *dev, struct device_node *phy_np,
24 void (*hndlr)(struct net_device *), u32 flags,
25 phy_interface_t iface);
26struct phy_device *
27of_phy_get_and_connect(struct net_device *dev, struct device_node *np,
28 void (*hndlr)(struct net_device *));
29struct phy_device *
30of_phy_attach(struct net_device *dev, struct device_node *phy_np,
31 u32 flags, phy_interface_t iface);
32
33struct mii_bus *of_mdio_find_bus(struct device_node *mdio_np);
34int of_phy_register_fixed_link(struct device_node *np);
35void of_phy_deregister_fixed_link(struct device_node *np);
36bool of_phy_is_fixed_link(struct device_node *np);
37int of_mdiobus_phy_device_register(struct mii_bus *mdio, struct phy_device *phy,
38 struct device_node *child, u32 addr);
39
40static 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 */
63static inline bool of_mdiobus_child_is_phy(struct device_node *child)
64{
65 return false;
66}
67
68static 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
78static inline struct mdio_device *of_mdio_find_device(struct device_node *np)
79{
80 return NULL;
81}
82
83static inline struct phy_device *of_phy_find_device(struct device_node *phy_np)
84{
85 return NULL;
86}
87
88static inline struct phy_device *of_phy_connect(struct net_device *dev,
89 struct device_node *phy_np,
90 void (*hndlr)(struct net_device *),
91 u32 flags, phy_interface_t iface)
92{
93 return NULL;
94}
95
96static inline struct phy_device *
97of_phy_get_and_connect(struct net_device *dev, struct device_node *np,
98 void (*hndlr)(struct net_device *))
99{
100 return NULL;
101}
102
103static inline struct phy_device *of_phy_attach(struct net_device *dev,
104 struct device_node *phy_np,
105 u32 flags, phy_interface_t iface)
106{
107 return NULL;
108}
109
110static inline struct mii_bus *of_mdio_find_bus(struct device_node *mdio_np)
111{
112 return NULL;
113}
114
115static inline int of_mdio_parse_addr(struct device *dev,
116 const struct device_node *np)
117{
118 return -ENOSYS;
119}
120static inline int of_phy_register_fixed_link(struct device_node *np)
121{
122 return -ENOSYS;
123}
124static inline void of_phy_deregister_fixed_link(struct device_node *np)
125{
126}
127static inline bool of_phy_is_fixed_link(struct device_node *np)
128{
129 return false;
130}
131
132static inline int of_mdiobus_phy_device_register(struct mii_bus *mdio,
133 struct phy_device *phy,
134 struct device_node *child, u32 addr)
135{
136 return -ENOSYS;
137}
138#endif
139
140
141#endif /* __LINUX_OF_MDIO_H */