Commit | Line | Data |
---|---|---|
02d320c3 | 1 | /* MDIO Bus interface |
00db8189 AF |
2 | * |
3 | * Author: Andy Fleming | |
4 | * | |
5 | * Copyright (c) 2004 Freescale Semiconductor, Inc. | |
6 | * | |
7 | * This program is free software; you can redistribute it and/or modify it | |
8 | * under the terms of the GNU General Public License as published by the | |
9 | * Free Software Foundation; either version 2 of the License, or (at your | |
10 | * option) any later version. | |
11 | * | |
12 | */ | |
8d242488 JP |
13 | |
14 | #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt | |
15 | ||
00db8189 | 16 | #include <linux/kernel.h> |
00db8189 AF |
17 | #include <linux/string.h> |
18 | #include <linux/errno.h> | |
19 | #include <linux/unistd.h> | |
20 | #include <linux/slab.h> | |
21 | #include <linux/interrupt.h> | |
22 | #include <linux/init.h> | |
23 | #include <linux/delay.h> | |
3d1e4db2 | 24 | #include <linux/device.h> |
69226896 RQ |
25 | #include <linux/gpio.h> |
26 | #include <linux/gpio/consumer.h> | |
a30e2c18 | 27 | #include <linux/of_device.h> |
4085a7f0 | 28 | #include <linux/of_mdio.h> |
69226896 | 29 | #include <linux/of_gpio.h> |
00db8189 AF |
30 | #include <linux/netdevice.h> |
31 | #include <linux/etherdevice.h> | |
32 | #include <linux/skbuff.h> | |
33 | #include <linux/spinlock.h> | |
34 | #include <linux/mm.h> | |
35 | #include <linux/module.h> | |
00db8189 AF |
36 | #include <linux/mii.h> |
37 | #include <linux/ethtool.h> | |
38 | #include <linux/phy.h> | |
02d320c3 SS |
39 | #include <linux/io.h> |
40 | #include <linux/uaccess.h> | |
00db8189 | 41 | |
00db8189 | 42 | #include <asm/irq.h> |
00db8189 | 43 | |
e22e996b UKK |
44 | #define CREATE_TRACE_POINTS |
45 | #include <trace/events/mdio.h> | |
46 | ||
648ea013 FF |
47 | #include "mdio-boardinfo.h" |
48 | ||
7f854420 AL |
49 | int mdiobus_register_device(struct mdio_device *mdiodev) |
50 | { | |
51 | if (mdiodev->bus->mdio_map[mdiodev->addr]) | |
52 | return -EBUSY; | |
53 | ||
54 | mdiodev->bus->mdio_map[mdiodev->addr] = mdiodev; | |
55 | ||
56 | return 0; | |
57 | } | |
58 | EXPORT_SYMBOL(mdiobus_register_device); | |
59 | ||
60 | int mdiobus_unregister_device(struct mdio_device *mdiodev) | |
61 | { | |
62 | if (mdiodev->bus->mdio_map[mdiodev->addr] != mdiodev) | |
63 | return -EINVAL; | |
64 | ||
65 | mdiodev->bus->mdio_map[mdiodev->addr] = NULL; | |
66 | ||
67 | return 0; | |
68 | } | |
69 | EXPORT_SYMBOL(mdiobus_unregister_device); | |
70 | ||
71 | struct phy_device *mdiobus_get_phy(struct mii_bus *bus, int addr) | |
72 | { | |
73 | struct mdio_device *mdiodev = bus->mdio_map[addr]; | |
74 | ||
75 | if (!mdiodev) | |
76 | return NULL; | |
77 | ||
78 | if (!(mdiodev->flags & MDIO_DEVICE_FLAG_PHY)) | |
79 | return NULL; | |
80 | ||
81 | return container_of(mdiodev, struct phy_device, mdio); | |
82 | } | |
83 | EXPORT_SYMBOL(mdiobus_get_phy); | |
84 | ||
85 | bool mdiobus_is_registered_device(struct mii_bus *bus, int addr) | |
86 | { | |
87 | return bus->mdio_map[addr]; | |
88 | } | |
89 | EXPORT_SYMBOL(mdiobus_is_registered_device); | |
90 | ||
298cf9be | 91 | /** |
eb8a54a7 | 92 | * mdiobus_alloc_size - allocate a mii_bus structure |
af58f1d6 RD |
93 | * @size: extra amount of memory to allocate for private storage. |
94 | * If non-zero, then bus->priv is points to that memory. | |
298cf9be LB |
95 | * |
96 | * Description: called by a bus driver to allocate an mii_bus | |
97 | * structure to fill in. | |
98 | */ | |
eb8a54a7 | 99 | struct mii_bus *mdiobus_alloc_size(size_t size) |
298cf9be | 100 | { |
46abc021 | 101 | struct mii_bus *bus; |
eb8a54a7 TT |
102 | size_t aligned_size = ALIGN(sizeof(*bus), NETDEV_ALIGN); |
103 | size_t alloc_size; | |
e7f4dc35 | 104 | int i; |
eb8a54a7 TT |
105 | |
106 | /* If we alloc extra space, it should be aligned */ | |
107 | if (size) | |
108 | alloc_size = aligned_size + size; | |
109 | else | |
110 | alloc_size = sizeof(*bus); | |
46abc021 | 111 | |
eb8a54a7 | 112 | bus = kzalloc(alloc_size, GFP_KERNEL); |
db9107b4 DC |
113 | if (!bus) |
114 | return NULL; | |
115 | ||
116 | bus->state = MDIOBUS_ALLOCATED; | |
117 | if (size) | |
118 | bus->priv = (void *)bus + aligned_size; | |
46abc021 | 119 | |
e7f4dc35 AL |
120 | /* Initialise the interrupts to polling */ |
121 | for (i = 0; i < PHY_MAX_ADDR; i++) | |
122 | bus->irq[i] = PHY_POLL; | |
123 | ||
46abc021 | 124 | return bus; |
298cf9be | 125 | } |
eb8a54a7 | 126 | EXPORT_SYMBOL(mdiobus_alloc_size); |
298cf9be | 127 | |
6d48f44b GS |
128 | static void _devm_mdiobus_free(struct device *dev, void *res) |
129 | { | |
130 | mdiobus_free(*(struct mii_bus **)res); | |
131 | } | |
132 | ||
133 | static int devm_mdiobus_match(struct device *dev, void *res, void *data) | |
134 | { | |
135 | struct mii_bus **r = res; | |
136 | ||
137 | if (WARN_ON(!r || !*r)) | |
138 | return 0; | |
139 | ||
140 | return *r == data; | |
141 | } | |
142 | ||
143 | /** | |
144 | * devm_mdiobus_alloc_size - Resource-managed mdiobus_alloc_size() | |
145 | * @dev: Device to allocate mii_bus for | |
146 | * @sizeof_priv: Space to allocate for private structure. | |
147 | * | |
148 | * Managed mdiobus_alloc_size. mii_bus allocated with this function is | |
149 | * automatically freed on driver detach. | |
150 | * | |
151 | * If an mii_bus allocated with this function needs to be freed separately, | |
152 | * devm_mdiobus_free() must be used. | |
153 | * | |
154 | * RETURNS: | |
155 | * Pointer to allocated mii_bus on success, NULL on failure. | |
156 | */ | |
157 | struct mii_bus *devm_mdiobus_alloc_size(struct device *dev, int sizeof_priv) | |
158 | { | |
159 | struct mii_bus **ptr, *bus; | |
160 | ||
161 | ptr = devres_alloc(_devm_mdiobus_free, sizeof(*ptr), GFP_KERNEL); | |
162 | if (!ptr) | |
163 | return NULL; | |
164 | ||
165 | /* use raw alloc_dr for kmalloc caller tracing */ | |
166 | bus = mdiobus_alloc_size(sizeof_priv); | |
167 | if (bus) { | |
168 | *ptr = bus; | |
169 | devres_add(dev, ptr); | |
170 | } else { | |
171 | devres_free(ptr); | |
172 | } | |
173 | ||
174 | return bus; | |
175 | } | |
93dccc59 | 176 | EXPORT_SYMBOL_GPL(devm_mdiobus_alloc_size); |
6d48f44b GS |
177 | |
178 | /** | |
179 | * devm_mdiobus_free - Resource-managed mdiobus_free() | |
180 | * @dev: Device this mii_bus belongs to | |
181 | * @bus: the mii_bus associated with the device | |
182 | * | |
183 | * Free mii_bus allocated with devm_mdiobus_alloc_size(). | |
184 | */ | |
185 | void devm_mdiobus_free(struct device *dev, struct mii_bus *bus) | |
186 | { | |
187 | int rc; | |
188 | ||
189 | rc = devres_release(dev, _devm_mdiobus_free, | |
190 | devm_mdiobus_match, bus); | |
191 | WARN_ON(rc); | |
192 | } | |
193 | EXPORT_SYMBOL_GPL(devm_mdiobus_free); | |
194 | ||
46abc021 LB |
195 | /** |
196 | * mdiobus_release - mii_bus device release callback | |
78c36b15 | 197 | * @d: the target struct device that contains the mii_bus |
46abc021 LB |
198 | * |
199 | * Description: called when the last reference to an mii_bus is | |
200 | * dropped, to free the underlying memory. | |
201 | */ | |
202 | static void mdiobus_release(struct device *d) | |
203 | { | |
204 | struct mii_bus *bus = to_mii_bus(d); | |
161c8d2f KH |
205 | BUG_ON(bus->state != MDIOBUS_RELEASED && |
206 | /* for compatibility with error handling in drivers */ | |
207 | bus->state != MDIOBUS_ALLOCATED); | |
46abc021 LB |
208 | kfree(bus); |
209 | } | |
210 | ||
211 | static struct class mdio_bus_class = { | |
212 | .name = "mdio_bus", | |
213 | .dev_release = mdiobus_release, | |
214 | }; | |
215 | ||
b943fbb0 | 216 | #if IS_ENABLED(CONFIG_OF_MDIO) |
25106022 | 217 | /* Helper function for of_mdio_find_bus */ |
9f3b795a | 218 | static int of_mdio_bus_match(struct device *dev, const void *mdio_bus_np) |
25106022 DD |
219 | { |
220 | return dev->of_node == mdio_bus_np; | |
221 | } | |
222 | /** | |
223 | * of_mdio_find_bus - Given an mii_bus node, find the mii_bus. | |
f41ef2e7 | 224 | * @mdio_bus_np: Pointer to the mii_bus. |
25106022 | 225 | * |
a1364421 RK |
226 | * Returns a reference to the mii_bus, or NULL if none found. The |
227 | * embedded struct device will have its reference count incremented, | |
228 | * and this must be put once the bus is finished with. | |
25106022 DD |
229 | * |
230 | * Because the association of a device_node and mii_bus is made via | |
231 | * of_mdiobus_register(), the mii_bus cannot be found before it is | |
232 | * registered with of_mdiobus_register(). | |
233 | * | |
234 | */ | |
235 | struct mii_bus *of_mdio_find_bus(struct device_node *mdio_bus_np) | |
236 | { | |
237 | struct device *d; | |
238 | ||
239 | if (!mdio_bus_np) | |
240 | return NULL; | |
241 | ||
242 | d = class_find_device(&mdio_bus_class, NULL, mdio_bus_np, | |
243 | of_mdio_bus_match); | |
244 | ||
245 | return d ? to_mii_bus(d) : NULL; | |
246 | } | |
247 | EXPORT_SYMBOL(of_mdio_find_bus); | |
d9daa247 | 248 | |
f03bc4ae AL |
249 | /* Walk the list of subnodes of a mdio bus and look for a node that |
250 | * matches the mdio device's address with its 'reg' property. If | |
251 | * found, set the of_node pointer for the mdio device. This allows | |
252 | * auto-probed phy devices to be supplied with information passed in | |
253 | * via DT. | |
d9daa247 | 254 | */ |
f03bc4ae AL |
255 | static void of_mdiobus_link_mdiodev(struct mii_bus *bus, |
256 | struct mdio_device *mdiodev) | |
d9daa247 | 257 | { |
f03bc4ae | 258 | struct device *dev = &mdiodev->dev; |
d9daa247 DM |
259 | struct device_node *child; |
260 | ||
e5a03bfd | 261 | if (dev->of_node || !bus->dev.of_node) |
d9daa247 DM |
262 | return; |
263 | ||
e5a03bfd | 264 | for_each_available_child_of_node(bus->dev.of_node, child) { |
d9daa247 | 265 | int addr; |
d9daa247 | 266 | |
d0a65400 JM |
267 | addr = of_mdio_parse_addr(dev, child); |
268 | if (addr < 0) | |
d9daa247 | 269 | continue; |
d9daa247 | 270 | |
f03bc4ae | 271 | if (addr == mdiodev->addr) { |
d9daa247 DM |
272 | dev->of_node = child; |
273 | return; | |
274 | } | |
275 | } | |
276 | } | |
277 | #else /* !IS_ENABLED(CONFIG_OF_MDIO) */ | |
f03bc4ae AL |
278 | static inline void of_mdiobus_link_mdiodev(struct mii_bus *mdio, |
279 | struct mdio_device *mdiodev) | |
d9daa247 DM |
280 | { |
281 | } | |
25106022 DD |
282 | #endif |
283 | ||
d0281a56 FF |
284 | /** |
285 | * mdiobus_create_device_from_board_info - create a full MDIO device given | |
286 | * a mdio_board_info structure | |
287 | * @bus: MDIO bus to create the devices on | |
288 | * @bi: mdio_board_info structure describing the devices | |
289 | * | |
290 | * Returns 0 on success or < 0 on error. | |
291 | */ | |
292 | static int mdiobus_create_device(struct mii_bus *bus, | |
293 | struct mdio_board_info *bi) | |
294 | { | |
295 | struct mdio_device *mdiodev; | |
296 | int ret = 0; | |
297 | ||
298 | mdiodev = mdio_device_create(bus, bi->mdio_addr); | |
299 | if (IS_ERR(mdiodev)) | |
300 | return -ENODEV; | |
301 | ||
302 | strncpy(mdiodev->modalias, bi->modalias, | |
303 | sizeof(mdiodev->modalias)); | |
304 | mdiodev->bus_match = mdio_device_bus_match; | |
305 | mdiodev->dev.platform_data = (void *)bi->platform_data; | |
306 | ||
307 | ret = mdio_device_register(mdiodev); | |
308 | if (ret) | |
309 | mdio_device_free(mdiodev); | |
310 | ||
311 | return ret; | |
312 | } | |
313 | ||
b3df0da8 | 314 | /** |
59f06978 | 315 | * __mdiobus_register - bring up all the PHYs on a given bus and attach them to bus |
b3df0da8 | 316 | * @bus: target mii_bus |
59f06978 | 317 | * @owner: module containing bus accessor functions |
e1393456 | 318 | * |
b3df0da8 | 319 | * Description: Called by a bus driver to bring up all the PHYs |
59f06978 RK |
320 | * on a given bus, and attach them to the bus. Drivers should use |
321 | * mdiobus_register() rather than __mdiobus_register() unless they | |
f89df3f3 AL |
322 | * need to pass a specific owner module. MDIO devices which are not |
323 | * PHYs will not be brought up by this function. They are expected to | |
324 | * to be explicitly listed in DT and instantiated by of_mdiobus_register(). | |
b3df0da8 RD |
325 | * |
326 | * Returns 0 on success or < 0 on error. | |
e1393456 | 327 | */ |
3e3aaf64 | 328 | int __mdiobus_register(struct mii_bus *bus, struct module *owner) |
e1393456 | 329 | { |
711fdba3 | 330 | struct mdio_device *mdiodev; |
161c8d2f | 331 | int i, err; |
69226896 | 332 | struct gpio_desc *gpiod; |
e1393456 | 333 | |
e1393456 | 334 | if (NULL == bus || NULL == bus->name || |
02d320c3 | 335 | NULL == bus->read || NULL == bus->write) |
e1393456 AF |
336 | return -EINVAL; |
337 | ||
46abc021 LB |
338 | BUG_ON(bus->state != MDIOBUS_ALLOCATED && |
339 | bus->state != MDIOBUS_UNREGISTERED); | |
340 | ||
3e3aaf64 | 341 | bus->owner = owner; |
46abc021 LB |
342 | bus->dev.parent = bus->parent; |
343 | bus->dev.class = &mdio_bus_class; | |
344 | bus->dev.groups = NULL; | |
036b6687 | 345 | dev_set_name(&bus->dev, "%s", bus->id); |
46abc021 LB |
346 | |
347 | err = device_register(&bus->dev); | |
348 | if (err) { | |
8d242488 | 349 | pr_err("mii_bus %s failed to register\n", bus->id); |
0c692d07 | 350 | put_device(&bus->dev); |
46abc021 LB |
351 | return -EINVAL; |
352 | } | |
353 | ||
d1e7fe4d AB |
354 | mutex_init(&bus->mdio_lock); |
355 | ||
d396e84c | 356 | /* de-assert bus level PHY GPIO reset */ |
fe0e4052 | 357 | gpiod = devm_gpiod_get_optional(&bus->dev, "reset", GPIOD_OUT_LOW); |
d396e84c | 358 | if (IS_ERR(gpiod)) { |
fe0e4052 SS |
359 | dev_err(&bus->dev, "mii_bus %s couldn't get reset GPIO\n", |
360 | bus->id); | |
361 | return PTR_ERR(gpiod); | |
362 | } else if (gpiod) { | |
d396e84c SS |
363 | bus->reset_gpiod = gpiod; |
364 | ||
365 | gpiod_set_value_cansleep(gpiod, 1); | |
366 | udelay(bus->reset_delay_us); | |
367 | gpiod_set_value_cansleep(gpiod, 0); | |
69226896 RQ |
368 | } |
369 | ||
df0c8d91 FF |
370 | if (bus->reset) |
371 | bus->reset(bus); | |
372 | ||
e1393456 | 373 | for (i = 0; i < PHY_MAX_ADDR; i++) { |
4fd5f812 LB |
374 | if ((bus->phy_mask & (1 << i)) == 0) { |
375 | struct phy_device *phydev; | |
e1393456 | 376 | |
4fd5f812 | 377 | phydev = mdiobus_scan(bus, i); |
70e927b9 | 378 | if (IS_ERR(phydev) && (PTR_ERR(phydev) != -ENODEV)) { |
4fd5f812 | 379 | err = PTR_ERR(phydev); |
161c8d2f KH |
380 | goto error; |
381 | } | |
64b1c2b4 | 382 | } |
e1393456 AF |
383 | } |
384 | ||
d0281a56 | 385 | mdiobus_setup_mdiodev_from_board_info(bus, mdiobus_create_device); |
648ea013 | 386 | |
161c8d2f | 387 | bus->state = MDIOBUS_REGISTERED; |
e1393456 | 388 | pr_info("%s: probed\n", bus->name); |
161c8d2f | 389 | return 0; |
e1393456 | 390 | |
161c8d2f KH |
391 | error: |
392 | while (--i >= 0) { | |
711fdba3 AL |
393 | mdiodev = bus->mdio_map[i]; |
394 | if (!mdiodev) | |
395 | continue; | |
396 | ||
397 | mdiodev->device_remove(mdiodev); | |
398 | mdiodev->device_free(mdiodev); | |
161c8d2f | 399 | } |
69226896 RQ |
400 | |
401 | /* Put PHYs in RESET to save power */ | |
95b80bf3 | 402 | gpiod_set_value_cansleep(bus->reset_gpiod, 1); |
69226896 | 403 | |
161c8d2f | 404 | device_del(&bus->dev); |
e1393456 AF |
405 | return err; |
406 | } | |
3e3aaf64 | 407 | EXPORT_SYMBOL(__mdiobus_register); |
e1393456 AF |
408 | |
409 | void mdiobus_unregister(struct mii_bus *bus) | |
410 | { | |
a9049e0c | 411 | struct mdio_device *mdiodev; |
e1393456 AF |
412 | int i; |
413 | ||
46abc021 LB |
414 | BUG_ON(bus->state != MDIOBUS_REGISTERED); |
415 | bus->state = MDIOBUS_UNREGISTERED; | |
416 | ||
e1393456 | 417 | for (i = 0; i < PHY_MAX_ADDR; i++) { |
a9049e0c AL |
418 | mdiodev = bus->mdio_map[i]; |
419 | if (!mdiodev) | |
420 | continue; | |
421 | ||
711fdba3 AL |
422 | mdiodev->device_remove(mdiodev); |
423 | mdiodev->device_free(mdiodev); | |
e1393456 | 424 | } |
69226896 RQ |
425 | |
426 | /* Put PHYs in RESET to save power */ | |
95b80bf3 | 427 | gpiod_set_value_cansleep(bus->reset_gpiod, 1); |
69226896 | 428 | |
b6c6aedc | 429 | device_del(&bus->dev); |
e1393456 AF |
430 | } |
431 | EXPORT_SYMBOL(mdiobus_unregister); | |
432 | ||
298cf9be LB |
433 | /** |
434 | * mdiobus_free - free a struct mii_bus | |
435 | * @bus: mii_bus to free | |
436 | * | |
46abc021 LB |
437 | * This function releases the reference to the underlying device |
438 | * object in the mii_bus. If this is the last reference, the mii_bus | |
439 | * will be freed. | |
298cf9be LB |
440 | */ |
441 | void mdiobus_free(struct mii_bus *bus) | |
442 | { | |
02d320c3 | 443 | /* For compatibility with error handling in drivers. */ |
46abc021 LB |
444 | if (bus->state == MDIOBUS_ALLOCATED) { |
445 | kfree(bus); | |
446 | return; | |
447 | } | |
448 | ||
449 | BUG_ON(bus->state != MDIOBUS_UNREGISTERED); | |
450 | bus->state = MDIOBUS_RELEASED; | |
451 | ||
452 | put_device(&bus->dev); | |
298cf9be LB |
453 | } |
454 | EXPORT_SYMBOL(mdiobus_free); | |
455 | ||
f89df3f3 AL |
456 | /** |
457 | * mdiobus_scan - scan a bus for MDIO devices. | |
458 | * @bus: mii_bus to scan | |
459 | * @addr: address on bus to scan | |
460 | * | |
461 | * This function scans the MDIO bus, looking for devices which can be | |
462 | * identified using a vendor/product ID in registers 2 and 3. Not all | |
463 | * MDIO devices have such registers, but PHY devices typically | |
464 | * do. Hence this function assumes anything found is a PHY, or can be | |
465 | * treated as a PHY. Other MDIO devices, such as switches, will | |
466 | * probably not be found during the scan. | |
467 | */ | |
4fd5f812 LB |
468 | struct phy_device *mdiobus_scan(struct mii_bus *bus, int addr) |
469 | { | |
470 | struct phy_device *phydev; | |
471 | int err; | |
472 | ||
ac28b9f8 | 473 | phydev = get_phy_device(bus, addr, false); |
66c239e7 | 474 | if (IS_ERR(phydev)) |
4fd5f812 LB |
475 | return phydev; |
476 | ||
86f6cf41 DM |
477 | /* |
478 | * For DT, see if the auto-probed phy has a correspoding child | |
479 | * in the bus node, and set the of_node pointer in this case. | |
480 | */ | |
f03bc4ae | 481 | of_mdiobus_link_mdiodev(bus, &phydev->mdio); |
86f6cf41 | 482 | |
4dea547f | 483 | err = phy_device_register(phydev); |
4fd5f812 | 484 | if (err) { |
4fd5f812 | 485 | phy_device_free(phydev); |
e98a3aab | 486 | return ERR_PTR(-ENODEV); |
4fd5f812 LB |
487 | } |
488 | ||
4fd5f812 LB |
489 | return phydev; |
490 | } | |
491 | EXPORT_SYMBOL(mdiobus_scan); | |
492 | ||
21dd19fe NA |
493 | /** |
494 | * mdiobus_read_nested - Nested version of the mdiobus_read function | |
495 | * @bus: the mii_bus struct | |
496 | * @addr: the phy address | |
497 | * @regnum: register number to read | |
498 | * | |
499 | * In case of nested MDIO bus access avoid lockdep false positives by | |
500 | * using mutex_lock_nested(). | |
501 | * | |
502 | * NOTE: MUST NOT be called from interrupt context, | |
503 | * because the bus read/write functions may wait for an interrupt | |
504 | * to conclude the operation. | |
505 | */ | |
506 | int mdiobus_read_nested(struct mii_bus *bus, int addr, u32 regnum) | |
507 | { | |
508 | int retval; | |
509 | ||
510 | BUG_ON(in_interrupt()); | |
511 | ||
9a6f2b01 | 512 | mutex_lock_nested(&bus->mdio_lock, MDIO_MUTEX_NESTED); |
21dd19fe NA |
513 | retval = bus->read(bus, addr, regnum); |
514 | mutex_unlock(&bus->mdio_lock); | |
515 | ||
e22e996b UKK |
516 | trace_mdio_access(bus, 1, addr, regnum, retval, retval); |
517 | ||
21dd19fe NA |
518 | return retval; |
519 | } | |
520 | EXPORT_SYMBOL(mdiobus_read_nested); | |
521 | ||
2e888103 LB |
522 | /** |
523 | * mdiobus_read - Convenience function for reading a given MII mgmt register | |
524 | * @bus: the mii_bus struct | |
525 | * @addr: the phy address | |
526 | * @regnum: register number to read | |
527 | * | |
528 | * NOTE: MUST NOT be called from interrupt context, | |
529 | * because the bus read/write functions may wait for an interrupt | |
530 | * to conclude the operation. | |
531 | */ | |
abf35df2 | 532 | int mdiobus_read(struct mii_bus *bus, int addr, u32 regnum) |
2e888103 LB |
533 | { |
534 | int retval; | |
535 | ||
536 | BUG_ON(in_interrupt()); | |
537 | ||
538 | mutex_lock(&bus->mdio_lock); | |
539 | retval = bus->read(bus, addr, regnum); | |
540 | mutex_unlock(&bus->mdio_lock); | |
541 | ||
e22e996b UKK |
542 | trace_mdio_access(bus, 1, addr, regnum, retval, retval); |
543 | ||
2e888103 LB |
544 | return retval; |
545 | } | |
546 | EXPORT_SYMBOL(mdiobus_read); | |
547 | ||
21dd19fe NA |
548 | /** |
549 | * mdiobus_write_nested - Nested version of the mdiobus_write function | |
550 | * @bus: the mii_bus struct | |
551 | * @addr: the phy address | |
552 | * @regnum: register number to write | |
553 | * @val: value to write to @regnum | |
554 | * | |
555 | * In case of nested MDIO bus access avoid lockdep false positives by | |
556 | * using mutex_lock_nested(). | |
557 | * | |
558 | * NOTE: MUST NOT be called from interrupt context, | |
559 | * because the bus read/write functions may wait for an interrupt | |
560 | * to conclude the operation. | |
561 | */ | |
562 | int mdiobus_write_nested(struct mii_bus *bus, int addr, u32 regnum, u16 val) | |
563 | { | |
564 | int err; | |
565 | ||
566 | BUG_ON(in_interrupt()); | |
567 | ||
9a6f2b01 | 568 | mutex_lock_nested(&bus->mdio_lock, MDIO_MUTEX_NESTED); |
21dd19fe NA |
569 | err = bus->write(bus, addr, regnum, val); |
570 | mutex_unlock(&bus->mdio_lock); | |
571 | ||
e22e996b UKK |
572 | trace_mdio_access(bus, 0, addr, regnum, val, err); |
573 | ||
21dd19fe NA |
574 | return err; |
575 | } | |
576 | EXPORT_SYMBOL(mdiobus_write_nested); | |
577 | ||
2e888103 LB |
578 | /** |
579 | * mdiobus_write - Convenience function for writing a given MII mgmt register | |
580 | * @bus: the mii_bus struct | |
581 | * @addr: the phy address | |
582 | * @regnum: register number to write | |
583 | * @val: value to write to @regnum | |
584 | * | |
585 | * NOTE: MUST NOT be called from interrupt context, | |
586 | * because the bus read/write functions may wait for an interrupt | |
587 | * to conclude the operation. | |
588 | */ | |
abf35df2 | 589 | int mdiobus_write(struct mii_bus *bus, int addr, u32 regnum, u16 val) |
2e888103 LB |
590 | { |
591 | int err; | |
592 | ||
593 | BUG_ON(in_interrupt()); | |
594 | ||
595 | mutex_lock(&bus->mdio_lock); | |
596 | err = bus->write(bus, addr, regnum, val); | |
597 | mutex_unlock(&bus->mdio_lock); | |
598 | ||
e22e996b UKK |
599 | trace_mdio_access(bus, 0, addr, regnum, val, err); |
600 | ||
2e888103 LB |
601 | return err; |
602 | } | |
603 | EXPORT_SYMBOL(mdiobus_write); | |
604 | ||
b3df0da8 | 605 | /** |
e76a4957 AL |
606 | * mdio_bus_match - determine if given MDIO driver supports the given |
607 | * MDIO device | |
608 | * @dev: target MDIO device | |
609 | * @drv: given MDIO driver | |
00db8189 | 610 | * |
e76a4957 AL |
611 | * Description: Given a MDIO device, and a MDIO driver, return 1 if |
612 | * the driver supports the device. Otherwise, return 0. This may | |
613 | * require calling the devices own match function, since different classes | |
614 | * of MDIO devices have different match criteria. | |
00db8189 AF |
615 | */ |
616 | static int mdio_bus_match(struct device *dev, struct device_driver *drv) | |
617 | { | |
e76a4957 | 618 | struct mdio_device *mdio = to_mdio_device(dev); |
00db8189 | 619 | |
a30e2c18 DD |
620 | if (of_driver_match_device(dev, drv)) |
621 | return 1; | |
622 | ||
e76a4957 AL |
623 | if (mdio->bus_match) |
624 | return mdio->bus_match(dev, drv); | |
a30e2c18 | 625 | |
e76a4957 | 626 | return 0; |
00db8189 AF |
627 | } |
628 | ||
1b8f8694 RK |
629 | static int mdio_uevent(struct device *dev, struct kobj_uevent_env *env) |
630 | { | |
631 | int rc; | |
632 | ||
633 | /* Some devices have extra OF data and an OF-style MODALIAS */ | |
634 | rc = of_device_uevent_modalias(dev, env); | |
635 | if (rc != -ENODEV) | |
636 | return rc; | |
637 | ||
638 | return 0; | |
639 | } | |
640 | ||
2f5cb434 | 641 | #ifdef CONFIG_PM |
2f5cb434 | 642 | static int mdio_bus_suspend(struct device *dev) |
00db8189 | 643 | { |
bc87922f | 644 | struct mdio_device *mdio = to_mdio_device(dev); |
00db8189 | 645 | |
bc87922f AL |
646 | if (mdio->pm_ops && mdio->pm_ops->suspend) |
647 | return mdio->pm_ops->suspend(dev); | |
541cd3ee | 648 | |
bc87922f | 649 | return 0; |
00db8189 AF |
650 | } |
651 | ||
2f5cb434 | 652 | static int mdio_bus_resume(struct device *dev) |
00db8189 | 653 | { |
bc87922f | 654 | struct mdio_device *mdio = to_mdio_device(dev); |
541cd3ee | 655 | |
bc87922f AL |
656 | if (mdio->pm_ops && mdio->pm_ops->resume) |
657 | return mdio->pm_ops->resume(dev); | |
541cd3ee AV |
658 | |
659 | return 0; | |
00db8189 AF |
660 | } |
661 | ||
2f5cb434 AV |
662 | static int mdio_bus_restore(struct device *dev) |
663 | { | |
bc87922f | 664 | struct mdio_device *mdio = to_mdio_device(dev); |
2f5cb434 | 665 | |
bc87922f AL |
666 | if (mdio->pm_ops && mdio->pm_ops->restore) |
667 | return mdio->pm_ops->restore(dev); | |
2f5cb434 AV |
668 | |
669 | return 0; | |
670 | } | |
671 | ||
02d320c3 | 672 | static const struct dev_pm_ops mdio_bus_pm_ops = { |
2f5cb434 AV |
673 | .suspend = mdio_bus_suspend, |
674 | .resume = mdio_bus_resume, | |
675 | .freeze = mdio_bus_suspend, | |
676 | .thaw = mdio_bus_resume, | |
677 | .restore = mdio_bus_restore, | |
678 | }; | |
679 | ||
680 | #define MDIO_BUS_PM_OPS (&mdio_bus_pm_ops) | |
681 | ||
682 | #else | |
683 | ||
684 | #define MDIO_BUS_PM_OPS NULL | |
685 | ||
686 | #endif /* CONFIG_PM */ | |
687 | ||
00db8189 AF |
688 | struct bus_type mdio_bus_type = { |
689 | .name = "mdio_bus", | |
690 | .match = mdio_bus_match, | |
1b8f8694 | 691 | .uevent = mdio_uevent, |
2f5cb434 | 692 | .pm = MDIO_BUS_PM_OPS, |
00db8189 | 693 | }; |
11b0bacd | 694 | EXPORT_SYMBOL(mdio_bus_type); |
00db8189 | 695 | |
67c4f3fa | 696 | int __init mdio_bus_init(void) |
00db8189 | 697 | { |
46abc021 LB |
698 | int ret; |
699 | ||
700 | ret = class_register(&mdio_bus_class); | |
701 | if (!ret) { | |
702 | ret = bus_register(&mdio_bus_type); | |
703 | if (ret) | |
704 | class_unregister(&mdio_bus_class); | |
705 | } | |
706 | ||
707 | return ret; | |
00db8189 | 708 | } |
90eff909 | 709 | EXPORT_SYMBOL_GPL(mdio_bus_init); |
00db8189 | 710 | |
90eff909 | 711 | #if IS_ENABLED(CONFIG_PHYLIB) |
dc85dec6 | 712 | void mdio_bus_exit(void) |
e1393456 | 713 | { |
46abc021 | 714 | class_unregister(&mdio_bus_class); |
e1393456 AF |
715 | bus_unregister(&mdio_bus_type); |
716 | } | |
90eff909 FF |
717 | EXPORT_SYMBOL_GPL(mdio_bus_exit); |
718 | #else | |
719 | module_init(mdio_bus_init); | |
720 | /* no module_exit, intentional */ | |
721 | MODULE_LICENSE("GPL"); | |
722 | MODULE_DESCRIPTION("MDIO bus/device layer"); | |
723 | #endif |