include/linux/mdio.h

1 /* SPDX-License-Identifier: GPL-2.0-only */
4  * Copyright 2006-2009 Solarflare Communications Inc.
38 	/* Bus address of the MDIO device (0-31) */
69 	 * up device-specific structures, if any
86 	dev_set_drvdata(&mdio->dev, data);  in mdiodev_set_drvdata()
91 	return dev_get_drvdata(&mdio->dev);  in mdiodev_get_drvdata()
105 	get_device(&mdiodev->dev);  in mdio_device_get()
129  * struct mdio_if_info - Ethernet controller MDIO interface
131  * @mmds: Mask of MMDs expected to be present in the PHY.  This must be
132  *	non-zero unless @prtad = %MDIO_PRTAD_NONE.
139  * @mdio_read: Register read function; returns value or negative error code
140  * @mdio_write: Register write function; returns 0 or negative error code
154 #define MDIO_PRTAD_NONE			(-1)
155 #define MDIO_DEVAD_NONE			(-1)
164 			 int prtad, int devad, u16 addr, int mask,
177  * mdio45_ethtool_gset - get settings for ETHTOOL_GSET
181  * Since the CSRs for auto-negotiation using next pages are not fully
182  * standardised, this function does not attempt to decode them.  Use
193  * mdio45_ethtool_ksettings_get - get settings for ETHTOOL_GLINKSETTINGS
197  * Since the CSRs for auto-negotiation using next pages are not fully
198  * standardised, this function does not attempt to decode them.  Use
216  * A small helper function that translates MMD EEE Capability (3.20) bits
243  * A small helper function that translates the MMD EEE Advertisment (7.60)
271  * A small helper function that translates ethtool advertisement settings
299  * A small helper function that translates linkmode advertisement
301  * 10GBASE-T AN CONTROL (7.32) register.
323  * @lpa: value of the C45 10GBASE-T AN STATUS register
325  * A small helper function that translates C45 10GBASE-T AN STATUS register bits
342  * @lpa: value of the BASE-T1 Autonegotiation Advertisement [15:0] Register
344  * A small helper function that translates BASE-T1 Autonegotiation
359  * @lpa: value of the BASE-T1 Autonegotiation Advertisement [31:16] Register
361  * A small helper function that translates BASE-T1 Autonegotiation
379  * A small helper function that translates linkmode advertisement
381  * BASE-T1 Autonegotiation Advertisement [15:0] Register.
399  * A small helper function that translates linkmode advertisement
401  * BASE-T1 Autonegotiation Advertisement [31:16] Register.
422  * A function that translates value of following registers to the linkmode:
423  * IEEE 802.3-2018 45.2.3.10 "EEE control and capability 1" register (3.20)
424  * IEEE 802.3-2018 45.2.7.13 "EEE advertisement 1" register (7.60)
425  * IEEE 802.3-2018 45.2.7.14 "EEE link partner ability 1" register (7.61)
448  * A function that translates value of following registers to the linkmode:
449  * IEEE 802.3-2022 45.2.3.11 "EEE control and capability 2" register (3.21)
464  * A function that translates value of following registers to the linkmode:
465  * IEEE 802.3-2022 45.2.7.16 "EEE advertisement 2" register (7.62)
466  * IEEE 802.3-2022 45.2.7.17 "EEE link partner ability 2" register (7.63)
467  * Note: Currently this function is the same as mii_eee_cap2_mod_linkmode_sup_t.
483  * A function that translates linkmode to value for IEEE 802.3-2018 45.2.7.13
510  * A function that translates linkmode to value for IEEE 802.3-2022 45.2.7.16
530  * A function that translates IEEE 802.3cg-2019 45.2.7.26 "10BASE-T1 AN status"
543  * A function that translates the linkmode to IEEE 802.3cg-2019 45.2.7.25
544  * "10BASE-T1 AN control" register (7.526) value.
557  * mii_c73_mod_linkmode - convert a Clause 73 advertisement to linkmodes
597 int __mdiobus_modify(struct mii_bus *bus, int addr, u32 regnum, u16 mask,
600 			     u16 mask, u16 set);
606 int mdiobus_modify(struct mii_bus *bus, int addr, u32 regnum, u16 mask,
609 			   u16 mask, u16 set);
621 		       u16 mask, u16 set);
624 			       u32 regnum, u16 mask, u16 set);
628 	return __mdiobus_read(mdiodev->bus, mdiodev->addr, regnum);  in __mdiodev_read()
634 	return __mdiobus_write(mdiodev->bus, mdiodev->addr, regnum, val);  in __mdiodev_write()
638 				   u16 mask, u16 set)  in __mdiodev_modify()  argument
640 	return __mdiobus_modify(mdiodev->bus, mdiodev->addr, regnum, mask, set);  in __mdiodev_modify()
644 					   u32 regnum, u16 mask, u16 set)  in __mdiodev_modify_changed()  argument
646 	return __mdiobus_modify_changed(mdiodev->bus, mdiodev->addr, regnum,  in __mdiodev_modify_changed()
647 					mask, set);  in __mdiodev_modify_changed()
652 	return mdiobus_read(mdiodev->bus, mdiodev->addr, regnum);  in mdiodev_read()
658 	return mdiobus_write(mdiodev->bus, mdiodev->addr, regnum, val);  in mdiodev_write()
662 				 u16 mask, u16 set)  in mdiodev_modify()  argument
664 	return mdiobus_modify(mdiodev->bus, mdiodev->addr, regnum, mask, set);  in mdiodev_modify()
668 					 u32 regnum, u16 mask, u16 set)  in mdiodev_modify_changed()  argument
670 	return mdiobus_modify_changed(mdiodev->bus, mdiodev->addr, regnum,  in mdiodev_modify_changed()
671 				      mask, set);  in mdiodev_modify_changed()
675 				     u32 regnum, u16 mask, u16 set)  in mdiodev_c45_modify()  argument
677 	return mdiobus_c45_modify(mdiodev->bus, mdiodev->addr, devad, regnum,  in mdiodev_c45_modify()
678 				  mask, set);  in mdiodev_c45_modify()
682 					     int devad, u32 regnum, u16 mask,  in mdiodev_c45_modify_changed()  argument
685 	return mdiobus_c45_modify_changed(mdiodev->bus, mdiodev->addr, devad,  in mdiodev_c45_modify_changed()
686 					  regnum, mask, set);  in mdiodev_c45_modify_changed()
692 	return mdiobus_c45_read(mdiodev->bus, mdiodev->addr, devad, regnum);  in mdiodev_c45_read()
698 	return mdiobus_c45_write(mdiodev->bus, mdiodev->addr, devad, regnum,  in mdiodev_c45_write()
708  * mdio_module_driver() - Helper macro for registering mdio drivers