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