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 DM |
265 | int addr; |
266 | int ret; | |
267 | ||
268 | ret = of_property_read_u32(child, "reg", &addr); | |
269 | if (ret < 0) { | |
f03bc4ae | 270 | dev_err(dev, "%s has invalid MDIO address\n", |
d9daa247 DM |
271 | child->full_name); |
272 | continue; | |
273 | } | |
274 | ||
f03bc4ae | 275 | /* A MDIO device must have a reg property in the range [0-31] */ |
d9daa247 | 276 | if (addr >= PHY_MAX_ADDR) { |
f03bc4ae | 277 | dev_err(dev, "%s MDIO address %i is too large\n", |
d9daa247 DM |
278 | child->full_name, addr); |
279 | continue; | |
280 | } | |
281 | ||
f03bc4ae | 282 | if (addr == mdiodev->addr) { |
d9daa247 DM |
283 | dev->of_node = child; |
284 | return; | |
285 | } | |
286 | } | |
287 | } | |
288 | #else /* !IS_ENABLED(CONFIG_OF_MDIO) */ | |
f03bc4ae AL |
289 | static inline void of_mdiobus_link_mdiodev(struct mii_bus *mdio, |
290 | struct mdio_device *mdiodev) | |
d9daa247 DM |
291 | { |
292 | } | |
25106022 DD |
293 | #endif |
294 | ||
d0281a56 FF |
295 | /** |
296 | * mdiobus_create_device_from_board_info - create a full MDIO device given | |
297 | * a mdio_board_info structure | |
298 | * @bus: MDIO bus to create the devices on | |
299 | * @bi: mdio_board_info structure describing the devices | |
300 | * | |
301 | * Returns 0 on success or < 0 on error. | |
302 | */ | |
303 | static int mdiobus_create_device(struct mii_bus *bus, | |
304 | struct mdio_board_info *bi) | |
305 | { | |
306 | struct mdio_device *mdiodev; | |
307 | int ret = 0; | |
308 | ||
309 | mdiodev = mdio_device_create(bus, bi->mdio_addr); | |
310 | if (IS_ERR(mdiodev)) | |
311 | return -ENODEV; | |
312 | ||
313 | strncpy(mdiodev->modalias, bi->modalias, | |
314 | sizeof(mdiodev->modalias)); | |
315 | mdiodev->bus_match = mdio_device_bus_match; | |
316 | mdiodev->dev.platform_data = (void *)bi->platform_data; | |
317 | ||
318 | ret = mdio_device_register(mdiodev); | |
319 | if (ret) | |
320 | mdio_device_free(mdiodev); | |
321 | ||
322 | return ret; | |
323 | } | |
324 | ||
b3df0da8 | 325 | /** |
59f06978 | 326 | * __mdiobus_register - bring up all the PHYs on a given bus and attach them to bus |
b3df0da8 | 327 | * @bus: target mii_bus |
59f06978 | 328 | * @owner: module containing bus accessor functions |
e1393456 | 329 | * |
b3df0da8 | 330 | * Description: Called by a bus driver to bring up all the PHYs |
59f06978 RK |
331 | * on a given bus, and attach them to the bus. Drivers should use |
332 | * mdiobus_register() rather than __mdiobus_register() unless they | |
f89df3f3 AL |
333 | * need to pass a specific owner module. MDIO devices which are not |
334 | * PHYs will not be brought up by this function. They are expected to | |
335 | * to be explicitly listed in DT and instantiated by of_mdiobus_register(). | |
b3df0da8 RD |
336 | * |
337 | * Returns 0 on success or < 0 on error. | |
e1393456 | 338 | */ |
3e3aaf64 | 339 | int __mdiobus_register(struct mii_bus *bus, struct module *owner) |
e1393456 | 340 | { |
711fdba3 | 341 | struct mdio_device *mdiodev; |
161c8d2f | 342 | int i, err; |
69226896 | 343 | struct gpio_desc *gpiod; |
e1393456 | 344 | |
e1393456 | 345 | if (NULL == bus || NULL == bus->name || |
02d320c3 | 346 | NULL == bus->read || NULL == bus->write) |
e1393456 AF |
347 | return -EINVAL; |
348 | ||
46abc021 LB |
349 | BUG_ON(bus->state != MDIOBUS_ALLOCATED && |
350 | bus->state != MDIOBUS_UNREGISTERED); | |
351 | ||
3e3aaf64 | 352 | bus->owner = owner; |
46abc021 LB |
353 | bus->dev.parent = bus->parent; |
354 | bus->dev.class = &mdio_bus_class; | |
355 | bus->dev.groups = NULL; | |
036b6687 | 356 | dev_set_name(&bus->dev, "%s", bus->id); |
46abc021 LB |
357 | |
358 | err = device_register(&bus->dev); | |
359 | if (err) { | |
8d242488 | 360 | pr_err("mii_bus %s failed to register\n", bus->id); |
0c692d07 | 361 | put_device(&bus->dev); |
46abc021 LB |
362 | return -EINVAL; |
363 | } | |
364 | ||
d1e7fe4d AB |
365 | mutex_init(&bus->mdio_lock); |
366 | ||
69226896 RQ |
367 | /* de-assert bus level PHY GPIO resets */ |
368 | if (bus->num_reset_gpios > 0) { | |
369 | bus->reset_gpiod = devm_kcalloc(&bus->dev, | |
370 | bus->num_reset_gpios, | |
371 | sizeof(struct gpio_desc *), | |
372 | GFP_KERNEL); | |
373 | if (!bus->reset_gpiod) | |
374 | return -ENOMEM; | |
375 | } | |
376 | ||
377 | for (i = 0; i < bus->num_reset_gpios; i++) { | |
378 | gpiod = devm_gpiod_get_index(&bus->dev, "reset", i, | |
379 | GPIOD_OUT_LOW); | |
380 | if (IS_ERR(gpiod)) { | |
381 | err = PTR_ERR(gpiod); | |
382 | if (err != -ENOENT) { | |
383 | dev_err(&bus->dev, | |
384 | "mii_bus %s couldn't get reset GPIO\n", | |
385 | bus->id); | |
386 | return err; | |
387 | } | |
388 | } else { | |
389 | bus->reset_gpiod[i] = gpiod; | |
390 | gpiod_set_value_cansleep(gpiod, 1); | |
391 | udelay(bus->reset_delay_us); | |
392 | gpiod_set_value_cansleep(gpiod, 0); | |
393 | } | |
394 | } | |
395 | ||
df0c8d91 FF |
396 | if (bus->reset) |
397 | bus->reset(bus); | |
398 | ||
e1393456 | 399 | for (i = 0; i < PHY_MAX_ADDR; i++) { |
4fd5f812 LB |
400 | if ((bus->phy_mask & (1 << i)) == 0) { |
401 | struct phy_device *phydev; | |
e1393456 | 402 | |
4fd5f812 | 403 | phydev = mdiobus_scan(bus, i); |
70e927b9 | 404 | if (IS_ERR(phydev) && (PTR_ERR(phydev) != -ENODEV)) { |
4fd5f812 | 405 | err = PTR_ERR(phydev); |
161c8d2f KH |
406 | goto error; |
407 | } | |
64b1c2b4 | 408 | } |
e1393456 AF |
409 | } |
410 | ||
d0281a56 | 411 | mdiobus_setup_mdiodev_from_board_info(bus, mdiobus_create_device); |
648ea013 | 412 | |
161c8d2f | 413 | bus->state = MDIOBUS_REGISTERED; |
e1393456 | 414 | pr_info("%s: probed\n", bus->name); |
161c8d2f | 415 | return 0; |
e1393456 | 416 | |
161c8d2f KH |
417 | error: |
418 | while (--i >= 0) { | |
711fdba3 AL |
419 | mdiodev = bus->mdio_map[i]; |
420 | if (!mdiodev) | |
421 | continue; | |
422 | ||
423 | mdiodev->device_remove(mdiodev); | |
424 | mdiodev->device_free(mdiodev); | |
161c8d2f | 425 | } |
69226896 RQ |
426 | |
427 | /* Put PHYs in RESET to save power */ | |
428 | for (i = 0; i < bus->num_reset_gpios; i++) { | |
429 | if (bus->reset_gpiod[i]) | |
430 | gpiod_set_value_cansleep(bus->reset_gpiod[i], 1); | |
431 | } | |
432 | ||
161c8d2f | 433 | device_del(&bus->dev); |
e1393456 AF |
434 | return err; |
435 | } | |
3e3aaf64 | 436 | EXPORT_SYMBOL(__mdiobus_register); |
e1393456 AF |
437 | |
438 | void mdiobus_unregister(struct mii_bus *bus) | |
439 | { | |
a9049e0c | 440 | struct mdio_device *mdiodev; |
e1393456 AF |
441 | int i; |
442 | ||
46abc021 LB |
443 | BUG_ON(bus->state != MDIOBUS_REGISTERED); |
444 | bus->state = MDIOBUS_UNREGISTERED; | |
445 | ||
e1393456 | 446 | for (i = 0; i < PHY_MAX_ADDR; i++) { |
a9049e0c AL |
447 | mdiodev = bus->mdio_map[i]; |
448 | if (!mdiodev) | |
449 | continue; | |
450 | ||
711fdba3 AL |
451 | mdiodev->device_remove(mdiodev); |
452 | mdiodev->device_free(mdiodev); | |
e1393456 | 453 | } |
69226896 RQ |
454 | |
455 | /* Put PHYs in RESET to save power */ | |
456 | for (i = 0; i < bus->num_reset_gpios; i++) { | |
457 | if (bus->reset_gpiod[i]) | |
458 | gpiod_set_value_cansleep(bus->reset_gpiod[i], 1); | |
459 | } | |
460 | ||
b6c6aedc | 461 | device_del(&bus->dev); |
e1393456 AF |
462 | } |
463 | EXPORT_SYMBOL(mdiobus_unregister); | |
464 | ||
298cf9be LB |
465 | /** |
466 | * mdiobus_free - free a struct mii_bus | |
467 | * @bus: mii_bus to free | |
468 | * | |
46abc021 LB |
469 | * This function releases the reference to the underlying device |
470 | * object in the mii_bus. If this is the last reference, the mii_bus | |
471 | * will be freed. | |
298cf9be LB |
472 | */ |
473 | void mdiobus_free(struct mii_bus *bus) | |
474 | { | |
02d320c3 | 475 | /* For compatibility with error handling in drivers. */ |
46abc021 LB |
476 | if (bus->state == MDIOBUS_ALLOCATED) { |
477 | kfree(bus); | |
478 | return; | |
479 | } | |
480 | ||
481 | BUG_ON(bus->state != MDIOBUS_UNREGISTERED); | |
482 | bus->state = MDIOBUS_RELEASED; | |
483 | ||
484 | put_device(&bus->dev); | |
298cf9be LB |
485 | } |
486 | EXPORT_SYMBOL(mdiobus_free); | |
487 | ||
f89df3f3 AL |
488 | /** |
489 | * mdiobus_scan - scan a bus for MDIO devices. | |
490 | * @bus: mii_bus to scan | |
491 | * @addr: address on bus to scan | |
492 | * | |
493 | * This function scans the MDIO bus, looking for devices which can be | |
494 | * identified using a vendor/product ID in registers 2 and 3. Not all | |
495 | * MDIO devices have such registers, but PHY devices typically | |
496 | * do. Hence this function assumes anything found is a PHY, or can be | |
497 | * treated as a PHY. Other MDIO devices, such as switches, will | |
498 | * probably not be found during the scan. | |
499 | */ | |
4fd5f812 LB |
500 | struct phy_device *mdiobus_scan(struct mii_bus *bus, int addr) |
501 | { | |
502 | struct phy_device *phydev; | |
503 | int err; | |
504 | ||
ac28b9f8 | 505 | phydev = get_phy_device(bus, addr, false); |
66c239e7 | 506 | if (IS_ERR(phydev)) |
4fd5f812 LB |
507 | return phydev; |
508 | ||
86f6cf41 DM |
509 | /* |
510 | * For DT, see if the auto-probed phy has a correspoding child | |
511 | * in the bus node, and set the of_node pointer in this case. | |
512 | */ | |
f03bc4ae | 513 | of_mdiobus_link_mdiodev(bus, &phydev->mdio); |
86f6cf41 | 514 | |
4dea547f | 515 | err = phy_device_register(phydev); |
4fd5f812 | 516 | if (err) { |
4fd5f812 | 517 | phy_device_free(phydev); |
e98a3aab | 518 | return ERR_PTR(-ENODEV); |
4fd5f812 LB |
519 | } |
520 | ||
4fd5f812 LB |
521 | return phydev; |
522 | } | |
523 | EXPORT_SYMBOL(mdiobus_scan); | |
524 | ||
21dd19fe NA |
525 | /** |
526 | * mdiobus_read_nested - Nested version of the mdiobus_read function | |
527 | * @bus: the mii_bus struct | |
528 | * @addr: the phy address | |
529 | * @regnum: register number to read | |
530 | * | |
531 | * In case of nested MDIO bus access avoid lockdep false positives by | |
532 | * using mutex_lock_nested(). | |
533 | * | |
534 | * NOTE: MUST NOT be called from interrupt context, | |
535 | * because the bus read/write functions may wait for an interrupt | |
536 | * to conclude the operation. | |
537 | */ | |
538 | int mdiobus_read_nested(struct mii_bus *bus, int addr, u32 regnum) | |
539 | { | |
540 | int retval; | |
541 | ||
542 | BUG_ON(in_interrupt()); | |
543 | ||
9a6f2b01 | 544 | mutex_lock_nested(&bus->mdio_lock, MDIO_MUTEX_NESTED); |
21dd19fe NA |
545 | retval = bus->read(bus, addr, regnum); |
546 | mutex_unlock(&bus->mdio_lock); | |
547 | ||
e22e996b UKK |
548 | trace_mdio_access(bus, 1, addr, regnum, retval, retval); |
549 | ||
21dd19fe NA |
550 | return retval; |
551 | } | |
552 | EXPORT_SYMBOL(mdiobus_read_nested); | |
553 | ||
2e888103 LB |
554 | /** |
555 | * mdiobus_read - Convenience function for reading a given MII mgmt register | |
556 | * @bus: the mii_bus struct | |
557 | * @addr: the phy address | |
558 | * @regnum: register number to read | |
559 | * | |
560 | * NOTE: MUST NOT be called from interrupt context, | |
561 | * because the bus read/write functions may wait for an interrupt | |
562 | * to conclude the operation. | |
563 | */ | |
abf35df2 | 564 | int mdiobus_read(struct mii_bus *bus, int addr, u32 regnum) |
2e888103 LB |
565 | { |
566 | int retval; | |
567 | ||
568 | BUG_ON(in_interrupt()); | |
569 | ||
570 | mutex_lock(&bus->mdio_lock); | |
571 | retval = bus->read(bus, addr, regnum); | |
572 | mutex_unlock(&bus->mdio_lock); | |
573 | ||
e22e996b UKK |
574 | trace_mdio_access(bus, 1, addr, regnum, retval, retval); |
575 | ||
2e888103 LB |
576 | return retval; |
577 | } | |
578 | EXPORT_SYMBOL(mdiobus_read); | |
579 | ||
21dd19fe NA |
580 | /** |
581 | * mdiobus_write_nested - Nested version of the mdiobus_write function | |
582 | * @bus: the mii_bus struct | |
583 | * @addr: the phy address | |
584 | * @regnum: register number to write | |
585 | * @val: value to write to @regnum | |
586 | * | |
587 | * In case of nested MDIO bus access avoid lockdep false positives by | |
588 | * using mutex_lock_nested(). | |
589 | * | |
590 | * NOTE: MUST NOT be called from interrupt context, | |
591 | * because the bus read/write functions may wait for an interrupt | |
592 | * to conclude the operation. | |
593 | */ | |
594 | int mdiobus_write_nested(struct mii_bus *bus, int addr, u32 regnum, u16 val) | |
595 | { | |
596 | int err; | |
597 | ||
598 | BUG_ON(in_interrupt()); | |
599 | ||
9a6f2b01 | 600 | mutex_lock_nested(&bus->mdio_lock, MDIO_MUTEX_NESTED); |
21dd19fe NA |
601 | err = bus->write(bus, addr, regnum, val); |
602 | mutex_unlock(&bus->mdio_lock); | |
603 | ||
e22e996b UKK |
604 | trace_mdio_access(bus, 0, addr, regnum, val, err); |
605 | ||
21dd19fe NA |
606 | return err; |
607 | } | |
608 | EXPORT_SYMBOL(mdiobus_write_nested); | |
609 | ||
2e888103 LB |
610 | /** |
611 | * mdiobus_write - Convenience function for writing a given MII mgmt register | |
612 | * @bus: the mii_bus struct | |
613 | * @addr: the phy address | |
614 | * @regnum: register number to write | |
615 | * @val: value to write to @regnum | |
616 | * | |
617 | * NOTE: MUST NOT be called from interrupt context, | |
618 | * because the bus read/write functions may wait for an interrupt | |
619 | * to conclude the operation. | |
620 | */ | |
abf35df2 | 621 | int mdiobus_write(struct mii_bus *bus, int addr, u32 regnum, u16 val) |
2e888103 LB |
622 | { |
623 | int err; | |
624 | ||
625 | BUG_ON(in_interrupt()); | |
626 | ||
627 | mutex_lock(&bus->mdio_lock); | |
628 | err = bus->write(bus, addr, regnum, val); | |
629 | mutex_unlock(&bus->mdio_lock); | |
630 | ||
e22e996b UKK |
631 | trace_mdio_access(bus, 0, addr, regnum, val, err); |
632 | ||
2e888103 LB |
633 | return err; |
634 | } | |
635 | EXPORT_SYMBOL(mdiobus_write); | |
636 | ||
b3df0da8 | 637 | /** |
e76a4957 AL |
638 | * mdio_bus_match - determine if given MDIO driver supports the given |
639 | * MDIO device | |
640 | * @dev: target MDIO device | |
641 | * @drv: given MDIO driver | |
00db8189 | 642 | * |
e76a4957 AL |
643 | * Description: Given a MDIO device, and a MDIO driver, return 1 if |
644 | * the driver supports the device. Otherwise, return 0. This may | |
645 | * require calling the devices own match function, since different classes | |
646 | * of MDIO devices have different match criteria. | |
00db8189 AF |
647 | */ |
648 | static int mdio_bus_match(struct device *dev, struct device_driver *drv) | |
649 | { | |
e76a4957 | 650 | struct mdio_device *mdio = to_mdio_device(dev); |
00db8189 | 651 | |
a30e2c18 DD |
652 | if (of_driver_match_device(dev, drv)) |
653 | return 1; | |
654 | ||
e76a4957 AL |
655 | if (mdio->bus_match) |
656 | return mdio->bus_match(dev, drv); | |
a30e2c18 | 657 | |
e76a4957 | 658 | return 0; |
00db8189 AF |
659 | } |
660 | ||
2f5cb434 | 661 | #ifdef CONFIG_PM |
2f5cb434 | 662 | static int mdio_bus_suspend(struct device *dev) |
00db8189 | 663 | { |
bc87922f | 664 | struct mdio_device *mdio = to_mdio_device(dev); |
00db8189 | 665 | |
bc87922f AL |
666 | if (mdio->pm_ops && mdio->pm_ops->suspend) |
667 | return mdio->pm_ops->suspend(dev); | |
541cd3ee | 668 | |
bc87922f | 669 | return 0; |
00db8189 AF |
670 | } |
671 | ||
2f5cb434 | 672 | static int mdio_bus_resume(struct device *dev) |
00db8189 | 673 | { |
bc87922f | 674 | struct mdio_device *mdio = to_mdio_device(dev); |
541cd3ee | 675 | |
bc87922f AL |
676 | if (mdio->pm_ops && mdio->pm_ops->resume) |
677 | return mdio->pm_ops->resume(dev); | |
541cd3ee AV |
678 | |
679 | return 0; | |
00db8189 AF |
680 | } |
681 | ||
2f5cb434 AV |
682 | static int mdio_bus_restore(struct device *dev) |
683 | { | |
bc87922f | 684 | struct mdio_device *mdio = to_mdio_device(dev); |
2f5cb434 | 685 | |
bc87922f AL |
686 | if (mdio->pm_ops && mdio->pm_ops->restore) |
687 | return mdio->pm_ops->restore(dev); | |
2f5cb434 AV |
688 | |
689 | return 0; | |
690 | } | |
691 | ||
02d320c3 | 692 | static const struct dev_pm_ops mdio_bus_pm_ops = { |
2f5cb434 AV |
693 | .suspend = mdio_bus_suspend, |
694 | .resume = mdio_bus_resume, | |
695 | .freeze = mdio_bus_suspend, | |
696 | .thaw = mdio_bus_resume, | |
697 | .restore = mdio_bus_restore, | |
698 | }; | |
699 | ||
700 | #define MDIO_BUS_PM_OPS (&mdio_bus_pm_ops) | |
701 | ||
702 | #else | |
703 | ||
704 | #define MDIO_BUS_PM_OPS NULL | |
705 | ||
706 | #endif /* CONFIG_PM */ | |
707 | ||
00db8189 AF |
708 | struct bus_type mdio_bus_type = { |
709 | .name = "mdio_bus", | |
710 | .match = mdio_bus_match, | |
2f5cb434 | 711 | .pm = MDIO_BUS_PM_OPS, |
00db8189 | 712 | }; |
11b0bacd | 713 | EXPORT_SYMBOL(mdio_bus_type); |
00db8189 | 714 | |
67c4f3fa | 715 | int __init mdio_bus_init(void) |
00db8189 | 716 | { |
46abc021 LB |
717 | int ret; |
718 | ||
719 | ret = class_register(&mdio_bus_class); | |
720 | if (!ret) { | |
721 | ret = bus_register(&mdio_bus_type); | |
722 | if (ret) | |
723 | class_unregister(&mdio_bus_class); | |
724 | } | |
725 | ||
726 | return ret; | |
00db8189 | 727 | } |
90eff909 | 728 | EXPORT_SYMBOL_GPL(mdio_bus_init); |
00db8189 | 729 | |
90eff909 | 730 | #if IS_ENABLED(CONFIG_PHYLIB) |
dc85dec6 | 731 | void mdio_bus_exit(void) |
e1393456 | 732 | { |
46abc021 | 733 | class_unregister(&mdio_bus_class); |
e1393456 AF |
734 | bus_unregister(&mdio_bus_type); |
735 | } | |
90eff909 FF |
736 | EXPORT_SYMBOL_GPL(mdio_bus_exit); |
737 | #else | |
738 | module_init(mdio_bus_init); | |
739 | /* no module_exit, intentional */ | |
740 | MODULE_LICENSE("GPL"); | |
741 | MODULE_DESCRIPTION("MDIO bus/device layer"); | |
742 | #endif |