1 // SPDX-License-Identifier: GPL-2.0+
2 /* MDIO Bus interface
41 #include "mdio-boardinfo.h"
46 	mdiodev->reset_gpio = gpiod_get_optional(&mdiodev->dev,  in mdiobus_register_gpiod()
48 	if (IS_ERR(mdiodev->reset_gpio))  in mdiobus_register_gpiod()
49 		return PTR_ERR(mdiodev->reset_gpio);  in mdiobus_register_gpiod()
51 	if (mdiodev->reset_gpio)  in mdiobus_register_gpiod()
52 		gpiod_set_consumer_name(mdiodev->reset_gpio, "PHY reset");  in mdiobus_register_gpiod()
61 	reset = reset_control_get_optional_exclusive(&mdiodev->dev, "phy");  in mdiobus_register_reset()
65 	mdiodev->reset_ctrl = reset;  in mdiobus_register_reset()
74 	if (mdiodev->bus->mdio_map[mdiodev->addr])  in mdiobus_register_device()
75 		return -EBUSY;  in mdiobus_register_device()
77 	if (mdiodev->flags & MDIO_DEVICE_FLAG_PHY) {  in mdiobus_register_device()
90 	mdiodev->bus->mdio_map[mdiodev->addr] = mdiodev;  in mdiobus_register_device()
98 	if (mdiodev->bus->mdio_map[mdiodev->addr] != mdiodev)  in mdiobus_unregister_device()
99 		return -EINVAL;  in mdiobus_unregister_device()
101 	reset_control_put(mdiodev->reset_ctrl);  in mdiobus_unregister_device()
103 	mdiodev->bus->mdio_map[mdiodev->addr] = NULL;  in mdiobus_unregister_device()
109 struct phy_device *mdiobus_get_phy(struct mii_bus *bus, int addr)  in mdiobus_get_phy()  argument
111 	struct mdio_device *mdiodev = bus->mdio_map[addr];  in mdiobus_get_phy()
116 	if (!(mdiodev->flags & MDIO_DEVICE_FLAG_PHY))  in mdiobus_get_phy()
123 bool mdiobus_is_registered_device(struct mii_bus *bus, int addr)  in mdiobus_is_registered_device()  argument
125 	return bus->mdio_map[addr];  in mdiobus_is_registered_device()
130  * mdiobus_alloc_size - allocate a mii_bus structure
132  * If non-zero, then bus->priv is points to that memory.
134  * Description: called by a bus driver to allocate an mii_bus
139 	struct mii_bus *bus;  in mdiobus_alloc_size()  local
140 	size_t aligned_size = ALIGN(sizeof(*bus), NETDEV_ALIGN);  in mdiobus_alloc_size()
148 		alloc_size = sizeof(*bus);  in mdiobus_alloc_size()
150 	bus = kzalloc(alloc_size, GFP_KERNEL);  in mdiobus_alloc_size()
151 	if (!bus)  in mdiobus_alloc_size()
154 	bus->state = MDIOBUS_ALLOCATED;  in mdiobus_alloc_size()
156 		bus->priv = (void *)bus + aligned_size;  in mdiobus_alloc_size()
158 	/* Initialise the interrupts to polling and 64-bit seqcounts */  in mdiobus_alloc_size()
160 		bus->irq[i] = PHY_POLL;  in mdiobus_alloc_size()
161 		u64_stats_init(&bus->stats[i].syncp);  in mdiobus_alloc_size()
164 	return bus;  in mdiobus_alloc_size()
169  * mdiobus_release - mii_bus device release callback
177 	struct mii_bus *bus = to_mii_bus(d);  in mdiobus_release()  local
179 	WARN(bus->state != MDIOBUS_RELEASED &&  in mdiobus_release()
181 	     bus->state != MDIOBUS_ALLOCATED,  in mdiobus_release()
183 	     bus->id);  in mdiobus_release()
184 	kfree(bus);  in mdiobus_release()
188 	int addr;  member
199 		start = u64_stats_fetch_begin(&s->syncp);  in mdio_bus_get_stat()
201 	} while (u64_stats_fetch_retry(&s->syncp, start));  in mdio_bus_get_stat()
206 static u64 mdio_bus_get_global_stat(struct mii_bus *bus, unsigned int offset)  in mdio_bus_get_global_stat()  argument
212 		val += mdio_bus_get_stat(&bus->stats[i], offset);  in mdio_bus_get_global_stat()
221 	struct mii_bus *bus = to_mii_bus(dev);  in mdio_bus_stat_field_show()  local
227 	sattr = eattr->var;  in mdio_bus_stat_field_show()
229 	if (sattr->addr < 0)  in mdio_bus_stat_field_show()
230 		val = mdio_bus_get_global_stat(bus, sattr->field_offset);  in mdio_bus_stat_field_show()
232 		val = mdio_bus_get_stat(&bus->stats[sattr->addr],  in mdio_bus_stat_field_show()
233 					sattr->field_offset);  in mdio_bus_stat_field_show()
243 	struct mii_bus *bus = mdiodev->bus;  in mdio_bus_device_stat_field_show()  local
246 	int addr = mdiodev->addr;  in mdio_bus_device_stat_field_show()  local
250 	sattr = eattr->var;  in mdio_bus_device_stat_field_show()
252 	val = mdio_bus_get_stat(&bus->stats[addr], sattr->field_offset);  in mdio_bus_device_stat_field_show()
263 		-1, offsetof(struct mdio_bus_stats, field)		\
271 		-1, offsetof(struct mdio_bus_stats, field)		\
283 #define MDIO_BUS_STATS_ADDR_ATTR_DECL(field, addr, file)		\  argument
284 static struct dev_ext_attribute dev_attr_mdio_bus_addr_##field##_##addr = { \
289 		addr, offsetof(struct mdio_bus_stats, field)		\
293 #define MDIO_BUS_STATS_ADDR_ATTR(field, addr)				\  argument
294 	MDIO_BUS_STATS_ADDR_ATTR_DECL(field, addr,			\
295 				 __stringify(field) "_" __stringify(addr))
297 #define MDIO_BUS_STATS_ADDR_ATTR_GROUP_DECL(addr)			\  argument
298 	MDIO_BUS_STATS_ADDR_ATTR(transfers, addr);			\
299 	MDIO_BUS_STATS_ADDR_ATTR(errors, addr);				\
300 	MDIO_BUS_STATS_ADDR_ATTR(writes, addr);				\
301 	MDIO_BUS_STATS_ADDR_ATTR(reads, addr)				\
336 #define MDIO_BUS_STATS_ADDR_ATTR_GROUP(addr)				\  argument
337 	&dev_attr_mdio_bus_addr_transfers_##addr.attr.attr,		\
338 	&dev_attr_mdio_bus_addr_errors_##addr.attr.attr,		\
339 	&dev_attr_mdio_bus_addr_writes_##addr.attr.attr,		\
340 	&dev_attr_mdio_bus_addr_reads_##addr.attr.attr			\
399  * mdio_find_bus - Given the name of a mdiobus, find the mii_bus.
404  * and this must be put_deviced'ed once the bus is finished with.
417  * of_mdio_find_bus - Given an mii_bus node, find the mii_bus.
422  * and this must be put once the bus is finished with.
441 /* Walk the list of subnodes of a mdio bus and look for a node that
444  * auto-probed phy devices to be supplied with information passed in
447 static void of_mdiobus_link_mdiodev(struct mii_bus *bus,  in of_mdiobus_link_mdiodev()  argument
450 	struct device *dev = &mdiodev->dev;  in of_mdiobus_link_mdiodev()
453 	if (dev->of_node || !bus->dev.of_node)  in of_mdiobus_link_mdiodev()
456 	for_each_available_child_of_node(bus->dev.of_node, child) {  in of_mdiobus_link_mdiodev()
457 		int addr;  in of_mdiobus_link_mdiodev()  local
459 		addr = of_mdio_parse_addr(dev, child);  in of_mdiobus_link_mdiodev()
460 		if (addr < 0)  in of_mdiobus_link_mdiodev()
463 		if (addr == mdiodev->addr) {  in of_mdiobus_link_mdiodev()
480  * mdiobus_create_device - create a full MDIO device given
482  * @bus: MDIO bus to create the devices on
487 static int mdiobus_create_device(struct mii_bus *bus,  in mdiobus_create_device()  argument
493 	mdiodev = mdio_device_create(bus, bi->mdio_addr);  in mdiobus_create_device()
495 		return -ENODEV;  in mdiobus_create_device()
497 	strncpy(mdiodev->modalias, bi->modalias,  in mdiobus_create_device()
498 		sizeof(mdiodev->modalias));  in mdiobus_create_device()
499 	mdiodev->bus_match = mdio_device_bus_match;  in mdiobus_create_device()
500 	mdiodev->dev.platform_data = (void *)bi->platform_data;  in mdiobus_create_device()
510  * __mdiobus_register - bring up all the PHYs on a given bus and attach them to bus
511  * @bus: target mii_bus
512  * @owner: module containing bus accessor functions
514  * Description: Called by a bus driver to bring up all the PHYs
515  *   on a given bus, and attach them to the bus. Drivers should use
523 int __mdiobus_register(struct mii_bus *bus, struct module *owner)  in __mdiobus_register()  argument
529 	if (NULL == bus || NULL == bus->name ||  in __mdiobus_register()
530 	    NULL == bus->read || NULL == bus->write)  in __mdiobus_register()
531 		return -EINVAL;  in __mdiobus_register()
533 	if (bus->parent && bus->parent->of_node)  in __mdiobus_register()
534 		bus->parent->of_node->fwnode.flags |=  in __mdiobus_register()
537 	WARN(bus->state != MDIOBUS_ALLOCATED &&  in __mdiobus_register()
538 	     bus->state != MDIOBUS_UNREGISTERED,  in __mdiobus_register()
539 	     "%s: not in ALLOCATED or UNREGISTERED state\n", bus->id);  in __mdiobus_register()
541 	bus->owner = owner;  in __mdiobus_register()
542 	bus->dev.parent = bus->parent;  in __mdiobus_register()
543 	bus->dev.class = &mdio_bus_class;  in __mdiobus_register()
544 	bus->dev.groups = NULL;  in __mdiobus_register()
545 	dev_set_name(&bus->dev, "%s", bus->id);  in __mdiobus_register()
552 	bus->state = MDIOBUS_UNREGISTERED;  in __mdiobus_register()
554 	err = device_register(&bus->dev);  in __mdiobus_register()
556 		pr_err("mii_bus %s failed to register\n", bus->id);  in __mdiobus_register()
557 		return -EINVAL;  in __mdiobus_register()
560 	mutex_init(&bus->mdio_lock);  in __mdiobus_register()
561 	mutex_init(&bus->shared_lock);  in __mdiobus_register()
563 	/* assert bus level PHY GPIO reset */  in __mdiobus_register()
564 	gpiod = devm_gpiod_get_optional(&bus->dev, "reset", GPIOD_OUT_HIGH);  in __mdiobus_register()
566 		err = dev_err_probe(&bus->dev, PTR_ERR(gpiod),  in __mdiobus_register()
568 				    bus->id);  in __mdiobus_register()
569 		device_del(&bus->dev);  in __mdiobus_register()
572 		bus->reset_gpiod = gpiod;  in __mdiobus_register()
573 		fsleep(bus->reset_delay_us);  in __mdiobus_register()
575 		if (bus->reset_post_delay_us > 0)  in __mdiobus_register()
576 			fsleep(bus->reset_post_delay_us);  in __mdiobus_register()
579 	if (bus->reset) {  in __mdiobus_register()
580 		err = bus->reset(bus);  in __mdiobus_register()
586 		if ((bus->phy_mask & BIT(i)) == 0) {  in __mdiobus_register()
589 			phydev = mdiobus_scan(bus, i);  in __mdiobus_register()
590 			if (IS_ERR(phydev) && (PTR_ERR(phydev) != -ENODEV)) {  in __mdiobus_register()
597 	mdiobus_setup_mdiodev_from_board_info(bus, mdiobus_create_device);  in __mdiobus_register()
599 	bus->state = MDIOBUS_REGISTERED;  in __mdiobus_register()
600 	dev_dbg(&bus->dev, "probed\n");  in __mdiobus_register()
604 	while (--i >= 0) {  in __mdiobus_register()
605 		mdiodev = bus->mdio_map[i];  in __mdiobus_register()
609 		mdiodev->device_remove(mdiodev);  in __mdiobus_register()
610 		mdiodev->device_free(mdiodev);  in __mdiobus_register()
614 	if (bus->reset_gpiod)  in __mdiobus_register()
615 		gpiod_set_value_cansleep(bus->reset_gpiod, 1);  in __mdiobus_register()
617 	device_del(&bus->dev);  in __mdiobus_register()
622 void mdiobus_unregister(struct mii_bus *bus)  in mdiobus_unregister()  argument
627 	if (WARN_ON_ONCE(bus->state != MDIOBUS_REGISTERED))  in mdiobus_unregister()
629 	bus->state = MDIOBUS_UNREGISTERED;  in mdiobus_unregister()
632 		mdiodev = bus->mdio_map[i];  in mdiobus_unregister()
636 		if (mdiodev->reset_gpio)  in mdiobus_unregister()
637 			gpiod_put(mdiodev->reset_gpio);  in mdiobus_unregister()
639 		mdiodev->device_remove(mdiodev);  in mdiobus_unregister()
640 		mdiodev->device_free(mdiodev);  in mdiobus_unregister()
644 	if (bus->reset_gpiod)  in mdiobus_unregister()
645 		gpiod_set_value_cansleep(bus->reset_gpiod, 1);  in mdiobus_unregister()
647 	device_del(&bus->dev);  in mdiobus_unregister()
652  * mdiobus_free - free a struct mii_bus
653  * @bus: mii_bus to free
659 void mdiobus_free(struct mii_bus *bus)  in mdiobus_free()  argument
662 	if (bus->state == MDIOBUS_ALLOCATED) {  in mdiobus_free()
663 		kfree(bus);  in mdiobus_free()
667 	WARN(bus->state != MDIOBUS_UNREGISTERED,  in mdiobus_free()
668 	     "%s: not in UNREGISTERED state\n", bus->id);  in mdiobus_free()
669 	bus->state = MDIOBUS_RELEASED;  in mdiobus_free()
671 	put_device(&bus->dev);  in mdiobus_free()
676  * mdiobus_scan - scan a bus for MDIO devices.
677  * @bus: mii_bus to scan
678  * @addr: address on bus to scan
680  * This function scans the MDIO bus, looking for devices which can be
687 struct phy_device *mdiobus_scan(struct mii_bus *bus, int addr)  in mdiobus_scan()  argument
689 	struct phy_device *phydev = ERR_PTR(-ENODEV);  in mdiobus_scan()
692 	switch (bus->probe_capabilities) {  in mdiobus_scan()
695 		phydev = get_phy_device(bus, addr, false);  in mdiobus_scan()
698 		phydev = get_phy_device(bus, addr, true);  in mdiobus_scan()
701 		phydev = get_phy_device(bus, addr, false);  in mdiobus_scan()
703 			phydev = get_phy_device(bus, addr, true);  in mdiobus_scan()
711 	 * For DT, see if the auto-probed phy has a correspoding child  in mdiobus_scan()
712 	 * in the bus node, and set the of_node pointer in this case.  in mdiobus_scan()
714 	of_mdiobus_link_mdiodev(bus, &phydev->mdio);  in mdiobus_scan()
719 		return ERR_PTR(-ENODEV);  in mdiobus_scan()
729 	u64_stats_update_begin(&stats->syncp);  in mdiobus_stats_acct()
731 	u64_stats_inc(&stats->transfers);  in mdiobus_stats_acct()
733 		u64_stats_inc(&stats->errors);  in mdiobus_stats_acct()
738 		u64_stats_inc(&stats->reads);  in mdiobus_stats_acct()
740 		u64_stats_inc(&stats->writes);  in mdiobus_stats_acct()
742 	u64_stats_update_end(&stats->syncp);  in mdiobus_stats_acct()
747  * __mdiobus_read - Unlocked version of the mdiobus_read function
748  * @bus: the mii_bus struct
749  * @addr: the phy address
752  * Read a MDIO bus register. Caller must hold the mdio bus lock.
756 int __mdiobus_read(struct mii_bus *bus, int addr, u32 regnum)  in __mdiobus_read()  argument
760 	lockdep_assert_held_once(&bus->mdio_lock);  in __mdiobus_read()
762 	retval = bus->read(bus, addr, regnum);  in __mdiobus_read()
764 	trace_mdio_access(bus, 1, addr, regnum, retval, retval);  in __mdiobus_read()
765 	mdiobus_stats_acct(&bus->stats[addr], true, retval);  in __mdiobus_read()
772  * __mdiobus_write - Unlocked version of the mdiobus_write function
773  * @bus: the mii_bus struct
774  * @addr: the phy address
778  * Write a MDIO bus register. Caller must hold the mdio bus lock.
782 int __mdiobus_write(struct mii_bus *bus, int addr, u32 regnum, u16 val)  in __mdiobus_write()  argument
786 	lockdep_assert_held_once(&bus->mdio_lock);  in __mdiobus_write()
788 	err = bus->write(bus, addr, regnum, val);  in __mdiobus_write()
790 	trace_mdio_access(bus, 0, addr, regnum, val, err);  in __mdiobus_write()
791 	mdiobus_stats_acct(&bus->stats[addr], false, err);  in __mdiobus_write()
798  * __mdiobus_modify_changed - Unlocked version of the mdiobus_modify function
799  * @bus: the mii_bus struct
800  * @addr: the phy address
810 int __mdiobus_modify_changed(struct mii_bus *bus, int addr, u32 regnum,  in __mdiobus_modify_changed()  argument
815 	ret = __mdiobus_read(bus, addr, regnum);  in __mdiobus_modify_changed()
823 	ret = __mdiobus_write(bus, addr, regnum, new);  in __mdiobus_modify_changed()
830  * mdiobus_read_nested - Nested version of the mdiobus_read function
831  * @bus: the mii_bus struct
832  * @addr: the phy address
835  * In case of nested MDIO bus access avoid lockdep false positives by
839  * because the bus read/write functions may wait for an interrupt
842 int mdiobus_read_nested(struct mii_bus *bus, int addr, u32 regnum)  in mdiobus_read_nested()  argument
846 	mutex_lock_nested(&bus->mdio_lock, MDIO_MUTEX_NESTED);  in mdiobus_read_nested()
847 	retval = __mdiobus_read(bus, addr, regnum);  in mdiobus_read_nested()
848 	mutex_unlock(&bus->mdio_lock);  in mdiobus_read_nested()
855  * mdiobus_read - Convenience function for reading a given MII mgmt register
856  * @bus: the mii_bus struct
857  * @addr: the phy address
861  * because the bus read/write functions may wait for an interrupt
864 int mdiobus_read(struct mii_bus *bus, int addr, u32 regnum)  in mdiobus_read()  argument
868 	mutex_lock(&bus->mdio_lock);  in mdiobus_read()
869 	retval = __mdiobus_read(bus, addr, regnum);  in mdiobus_read()
870 	mutex_unlock(&bus->mdio_lock);  in mdiobus_read()
877  * mdiobus_write_nested - Nested version of the mdiobus_write function
878  * @bus: the mii_bus struct
879  * @addr: the phy address
883  * In case of nested MDIO bus access avoid lockdep false positives by
887  * because the bus read/write functions may wait for an interrupt
890 int mdiobus_write_nested(struct mii_bus *bus, int addr, u32 regnum, u16 val)  in mdiobus_write_nested()  argument
894 	mutex_lock_nested(&bus->mdio_lock, MDIO_MUTEX_NESTED);  in mdiobus_write_nested()
895 	err = __mdiobus_write(bus, addr, regnum, val);  in mdiobus_write_nested()
896 	mutex_unlock(&bus->mdio_lock);  in mdiobus_write_nested()
903  * mdiobus_write - Convenience function for writing a given MII mgmt register
904  * @bus: the mii_bus struct
905  * @addr: the phy address
910  * because the bus read/write functions may wait for an interrupt
913 int mdiobus_write(struct mii_bus *bus, int addr, u32 regnum, u16 val)  in mdiobus_write()  argument
917 	mutex_lock(&bus->mdio_lock);  in mdiobus_write()
918 	err = __mdiobus_write(bus, addr, regnum, val);  in mdiobus_write()
919 	mutex_unlock(&bus->mdio_lock);  in mdiobus_write()
926  * mdiobus_modify - Convenience function for modifying a given mdio device
928  * @bus: the mii_bus struct
929  * @addr: the phy address
934 int mdiobus_modify(struct mii_bus *bus, int addr, u32 regnum, u16 mask, u16 set)  in mdiobus_modify()  argument
938 	mutex_lock(&bus->mdio_lock);  in mdiobus_modify()
939 	err = __mdiobus_modify_changed(bus, addr, regnum, mask, set);  in mdiobus_modify()
940 	mutex_unlock(&bus->mdio_lock);  in mdiobus_modify()
947  * mdiobus_modify_changed - Convenience function for modifying a given mdio
949  * @bus: the mii_bus struct
950  * @addr: the phy address
955 int mdiobus_modify_changed(struct mii_bus *bus, int addr, u32 regnum,  in mdiobus_modify_changed()  argument
960 	mutex_lock(&bus->mdio_lock);  in mdiobus_modify_changed()
961 	err = __mdiobus_modify_changed(bus, addr, regnum, mask, set);  in mdiobus_modify_changed()
962 	mutex_unlock(&bus->mdio_lock);  in mdiobus_modify_changed()
969  * mdio_bus_match - determine if given MDIO driver supports the given
984 	/* Both the driver and device must type-match */  in mdio_bus_match()
985 	if (!(mdiodrv->mdiodrv.flags & MDIO_DEVICE_IS_PHY) !=  in mdio_bus_match()
986 	    !(mdio->flags & MDIO_DEVICE_FLAG_PHY))  in mdio_bus_match()
992 	if (mdio->bus_match)  in mdio_bus_match()
993 		return mdio->bus_match(dev, drv);  in mdio_bus_match()
1002 	/* Some devices have extra OF data and an OF-style MODALIAS */  in mdio_uevent()
1004 	if (rc != -ENODEV)  in mdio_uevent()
1061 MODULE_DESCRIPTION("MDIO bus/device layer");