123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583 |
- /* SPDX-License-Identifier: GPL-2.0 */
- /*
- * linux/mii.h: definitions for MII-compatible transceivers
- * Originally drivers/net/sunhme.h.
- *
- * Copyright (C) 1996, 1999, 2001 David S. Miller ([email protected])
- */
- #ifndef __LINUX_MII_H__
- #define __LINUX_MII_H__
- #include <linux/if.h>
- #include <linux/linkmode.h>
- #include <uapi/linux/mii.h>
- struct ethtool_cmd;
- struct mii_if_info {
- int phy_id;
- int advertising;
- int phy_id_mask;
- int reg_num_mask;
- unsigned int full_duplex : 1; /* is full duplex? */
- unsigned int force_media : 1; /* is autoneg. disabled? */
- unsigned int supports_gmii : 1; /* are GMII registers supported? */
- struct net_device *dev;
- int (*mdio_read) (struct net_device *dev, int phy_id, int location);
- void (*mdio_write) (struct net_device *dev, int phy_id, int location, int val);
- };
- extern int mii_link_ok (struct mii_if_info *mii);
- extern int mii_nway_restart (struct mii_if_info *mii);
- extern void mii_ethtool_gset(struct mii_if_info *mii, struct ethtool_cmd *ecmd);
- extern void mii_ethtool_get_link_ksettings(
- struct mii_if_info *mii, struct ethtool_link_ksettings *cmd);
- extern int mii_ethtool_sset(struct mii_if_info *mii, struct ethtool_cmd *ecmd);
- extern int mii_ethtool_set_link_ksettings(
- struct mii_if_info *mii, const struct ethtool_link_ksettings *cmd);
- extern int mii_check_gmii_support(struct mii_if_info *mii);
- extern void mii_check_link (struct mii_if_info *mii);
- extern unsigned int mii_check_media (struct mii_if_info *mii,
- unsigned int ok_to_print,
- unsigned int init_media);
- extern int generic_mii_ioctl(struct mii_if_info *mii_if,
- struct mii_ioctl_data *mii_data, int cmd,
- unsigned int *duplex_changed);
- static inline struct mii_ioctl_data *if_mii(struct ifreq *rq)
- {
- return (struct mii_ioctl_data *) &rq->ifr_ifru;
- }
- /**
- * mii_nway_result
- * @negotiated: value of MII ANAR and'd with ANLPAR
- *
- * Given a set of MII abilities, check each bit and returns the
- * currently supported media, in the priority order defined by
- * IEEE 802.3u. We use LPA_xxx constants but note this is not the
- * value of LPA solely, as described above.
- *
- * The one exception to IEEE 802.3u is that 100baseT4 is placed
- * between 100T-full and 100T-half. If your phy does not support
- * 100T4 this is fine. If your phy places 100T4 elsewhere in the
- * priority order, you will need to roll your own function.
- */
- static inline unsigned int mii_nway_result (unsigned int negotiated)
- {
- unsigned int ret;
- if (negotiated & LPA_100FULL)
- ret = LPA_100FULL;
- else if (negotiated & LPA_100BASE4)
- ret = LPA_100BASE4;
- else if (negotiated & LPA_100HALF)
- ret = LPA_100HALF;
- else if (negotiated & LPA_10FULL)
- ret = LPA_10FULL;
- else
- ret = LPA_10HALF;
- return ret;
- }
- /**
- * mii_duplex
- * @duplex_lock: Non-zero if duplex is locked at full
- * @negotiated: value of MII ANAR and'd with ANLPAR
- *
- * A small helper function for a common case. Returns one
- * if the media is operating or locked at full duplex, and
- * returns zero otherwise.
- */
- static inline unsigned int mii_duplex (unsigned int duplex_lock,
- unsigned int negotiated)
- {
- if (duplex_lock)
- return 1;
- if (mii_nway_result(negotiated) & LPA_DUPLEX)
- return 1;
- return 0;
- }
- /**
- * ethtool_adv_to_mii_adv_t
- * @ethadv: the ethtool advertisement settings
- *
- * A small helper function that translates ethtool advertisement
- * settings to phy autonegotiation advertisements for the
- * MII_ADVERTISE register.
- */
- static inline u32 ethtool_adv_to_mii_adv_t(u32 ethadv)
- {
- u32 result = 0;
- if (ethadv & ADVERTISED_10baseT_Half)
- result |= ADVERTISE_10HALF;
- if (ethadv & ADVERTISED_10baseT_Full)
- result |= ADVERTISE_10FULL;
- if (ethadv & ADVERTISED_100baseT_Half)
- result |= ADVERTISE_100HALF;
- if (ethadv & ADVERTISED_100baseT_Full)
- result |= ADVERTISE_100FULL;
- if (ethadv & ADVERTISED_Pause)
- result |= ADVERTISE_PAUSE_CAP;
- if (ethadv & ADVERTISED_Asym_Pause)
- result |= ADVERTISE_PAUSE_ASYM;
- return result;
- }
- /**
- * linkmode_adv_to_mii_adv_t
- * @advertising: the linkmode advertisement settings
- *
- * A small helper function that translates linkmode advertisement
- * settings to phy autonegotiation advertisements for the
- * MII_ADVERTISE register.
- */
- static inline u32 linkmode_adv_to_mii_adv_t(unsigned long *advertising)
- {
- u32 result = 0;
- if (linkmode_test_bit(ETHTOOL_LINK_MODE_10baseT_Half_BIT, advertising))
- result |= ADVERTISE_10HALF;
- if (linkmode_test_bit(ETHTOOL_LINK_MODE_10baseT_Full_BIT, advertising))
- result |= ADVERTISE_10FULL;
- if (linkmode_test_bit(ETHTOOL_LINK_MODE_100baseT_Half_BIT, advertising))
- result |= ADVERTISE_100HALF;
- if (linkmode_test_bit(ETHTOOL_LINK_MODE_100baseT_Full_BIT, advertising))
- result |= ADVERTISE_100FULL;
- if (linkmode_test_bit(ETHTOOL_LINK_MODE_Pause_BIT, advertising))
- result |= ADVERTISE_PAUSE_CAP;
- if (linkmode_test_bit(ETHTOOL_LINK_MODE_Asym_Pause_BIT, advertising))
- result |= ADVERTISE_PAUSE_ASYM;
- return result;
- }
- /**
- * mii_adv_to_ethtool_adv_t
- * @adv: value of the MII_ADVERTISE register
- *
- * A small helper function that translates MII_ADVERTISE bits
- * to ethtool advertisement settings.
- */
- static inline u32 mii_adv_to_ethtool_adv_t(u32 adv)
- {
- u32 result = 0;
- if (adv & ADVERTISE_10HALF)
- result |= ADVERTISED_10baseT_Half;
- if (adv & ADVERTISE_10FULL)
- result |= ADVERTISED_10baseT_Full;
- if (adv & ADVERTISE_100HALF)
- result |= ADVERTISED_100baseT_Half;
- if (adv & ADVERTISE_100FULL)
- result |= ADVERTISED_100baseT_Full;
- if (adv & ADVERTISE_PAUSE_CAP)
- result |= ADVERTISED_Pause;
- if (adv & ADVERTISE_PAUSE_ASYM)
- result |= ADVERTISED_Asym_Pause;
- return result;
- }
- /**
- * ethtool_adv_to_mii_ctrl1000_t
- * @ethadv: the ethtool advertisement settings
- *
- * A small helper function that translates ethtool advertisement
- * settings to phy autonegotiation advertisements for the
- * MII_CTRL1000 register when in 1000T mode.
- */
- static inline u32 ethtool_adv_to_mii_ctrl1000_t(u32 ethadv)
- {
- u32 result = 0;
- if (ethadv & ADVERTISED_1000baseT_Half)
- result |= ADVERTISE_1000HALF;
- if (ethadv & ADVERTISED_1000baseT_Full)
- result |= ADVERTISE_1000FULL;
- return result;
- }
- /**
- * linkmode_adv_to_mii_ctrl1000_t
- * @advertising: the linkmode advertisement settings
- *
- * A small helper function that translates linkmode advertisement
- * settings to phy autonegotiation advertisements for the
- * MII_CTRL1000 register when in 1000T mode.
- */
- static inline u32 linkmode_adv_to_mii_ctrl1000_t(unsigned long *advertising)
- {
- u32 result = 0;
- if (linkmode_test_bit(ETHTOOL_LINK_MODE_1000baseT_Half_BIT,
- advertising))
- result |= ADVERTISE_1000HALF;
- if (linkmode_test_bit(ETHTOOL_LINK_MODE_1000baseT_Full_BIT,
- advertising))
- result |= ADVERTISE_1000FULL;
- return result;
- }
- /**
- * mii_ctrl1000_to_ethtool_adv_t
- * @adv: value of the MII_CTRL1000 register
- *
- * A small helper function that translates MII_CTRL1000
- * bits, when in 1000Base-T mode, to ethtool
- * advertisement settings.
- */
- static inline u32 mii_ctrl1000_to_ethtool_adv_t(u32 adv)
- {
- u32 result = 0;
- if (adv & ADVERTISE_1000HALF)
- result |= ADVERTISED_1000baseT_Half;
- if (adv & ADVERTISE_1000FULL)
- result |= ADVERTISED_1000baseT_Full;
- return result;
- }
- /**
- * mii_lpa_to_ethtool_lpa_t
- * @adv: value of the MII_LPA register
- *
- * A small helper function that translates MII_LPA
- * bits, when in 1000Base-T mode, to ethtool
- * LP advertisement settings.
- */
- static inline u32 mii_lpa_to_ethtool_lpa_t(u32 lpa)
- {
- u32 result = 0;
- if (lpa & LPA_LPACK)
- result |= ADVERTISED_Autoneg;
- return result | mii_adv_to_ethtool_adv_t(lpa);
- }
- /**
- * mii_stat1000_to_ethtool_lpa_t
- * @adv: value of the MII_STAT1000 register
- *
- * A small helper function that translates MII_STAT1000
- * bits, when in 1000Base-T mode, to ethtool
- * advertisement settings.
- */
- static inline u32 mii_stat1000_to_ethtool_lpa_t(u32 lpa)
- {
- u32 result = 0;
- if (lpa & LPA_1000HALF)
- result |= ADVERTISED_1000baseT_Half;
- if (lpa & LPA_1000FULL)
- result |= ADVERTISED_1000baseT_Full;
- return result;
- }
- /**
- * mii_stat1000_mod_linkmode_lpa_t
- * @advertising: target the linkmode advertisement settings
- * @adv: value of the MII_STAT1000 register
- *
- * A small helper function that translates MII_STAT1000 bits, when in
- * 1000Base-T mode, to linkmode advertisement settings. Other bits in
- * advertising are not changes.
- */
- static inline void mii_stat1000_mod_linkmode_lpa_t(unsigned long *advertising,
- u32 lpa)
- {
- linkmode_mod_bit(ETHTOOL_LINK_MODE_1000baseT_Half_BIT,
- advertising, lpa & LPA_1000HALF);
- linkmode_mod_bit(ETHTOOL_LINK_MODE_1000baseT_Full_BIT,
- advertising, lpa & LPA_1000FULL);
- }
- /**
- * ethtool_adv_to_mii_adv_x
- * @ethadv: the ethtool advertisement settings
- *
- * A small helper function that translates ethtool advertisement
- * settings to phy autonegotiation advertisements for the
- * MII_CTRL1000 register when in 1000Base-X mode.
- */
- static inline u32 ethtool_adv_to_mii_adv_x(u32 ethadv)
- {
- u32 result = 0;
- if (ethadv & ADVERTISED_1000baseT_Half)
- result |= ADVERTISE_1000XHALF;
- if (ethadv & ADVERTISED_1000baseT_Full)
- result |= ADVERTISE_1000XFULL;
- if (ethadv & ADVERTISED_Pause)
- result |= ADVERTISE_1000XPAUSE;
- if (ethadv & ADVERTISED_Asym_Pause)
- result |= ADVERTISE_1000XPSE_ASYM;
- return result;
- }
- /**
- * mii_adv_to_ethtool_adv_x
- * @adv: value of the MII_CTRL1000 register
- *
- * A small helper function that translates MII_CTRL1000
- * bits, when in 1000Base-X mode, to ethtool
- * advertisement settings.
- */
- static inline u32 mii_adv_to_ethtool_adv_x(u32 adv)
- {
- u32 result = 0;
- if (adv & ADVERTISE_1000XHALF)
- result |= ADVERTISED_1000baseT_Half;
- if (adv & ADVERTISE_1000XFULL)
- result |= ADVERTISED_1000baseT_Full;
- if (adv & ADVERTISE_1000XPAUSE)
- result |= ADVERTISED_Pause;
- if (adv & ADVERTISE_1000XPSE_ASYM)
- result |= ADVERTISED_Asym_Pause;
- return result;
- }
- /**
- * mii_adv_mod_linkmode_adv_t
- * @advertising:pointer to destination link mode.
- * @adv: value of the MII_ADVERTISE register
- *
- * A small helper function that translates MII_ADVERTISE bits to
- * linkmode advertisement settings. Leaves other bits unchanged.
- */
- static inline void mii_adv_mod_linkmode_adv_t(unsigned long *advertising,
- u32 adv)
- {
- linkmode_mod_bit(ETHTOOL_LINK_MODE_10baseT_Half_BIT,
- advertising, adv & ADVERTISE_10HALF);
- linkmode_mod_bit(ETHTOOL_LINK_MODE_10baseT_Full_BIT,
- advertising, adv & ADVERTISE_10FULL);
- linkmode_mod_bit(ETHTOOL_LINK_MODE_100baseT_Half_BIT,
- advertising, adv & ADVERTISE_100HALF);
- linkmode_mod_bit(ETHTOOL_LINK_MODE_100baseT_Full_BIT,
- advertising, adv & ADVERTISE_100FULL);
- linkmode_mod_bit(ETHTOOL_LINK_MODE_Pause_BIT, advertising,
- adv & ADVERTISE_PAUSE_CAP);
- linkmode_mod_bit(ETHTOOL_LINK_MODE_Asym_Pause_BIT,
- advertising, adv & ADVERTISE_PAUSE_ASYM);
- }
- /**
- * mii_adv_to_linkmode_adv_t
- * @advertising:pointer to destination link mode.
- * @adv: value of the MII_ADVERTISE register
- *
- * A small helper function that translates MII_ADVERTISE bits
- * to linkmode advertisement settings. Clears the old value
- * of advertising.
- */
- static inline void mii_adv_to_linkmode_adv_t(unsigned long *advertising,
- u32 adv)
- {
- linkmode_zero(advertising);
- mii_adv_mod_linkmode_adv_t(advertising, adv);
- }
- /**
- * mii_lpa_to_linkmode_lpa_t
- * @adv: value of the MII_LPA register
- *
- * A small helper function that translates MII_LPA bits, when in
- * 1000Base-T mode, to linkmode LP advertisement settings. Clears the
- * old value of advertising
- */
- static inline void mii_lpa_to_linkmode_lpa_t(unsigned long *lp_advertising,
- u32 lpa)
- {
- mii_adv_to_linkmode_adv_t(lp_advertising, lpa);
- if (lpa & LPA_LPACK)
- linkmode_set_bit(ETHTOOL_LINK_MODE_Autoneg_BIT,
- lp_advertising);
- }
- /**
- * mii_lpa_mod_linkmode_lpa_t
- * @adv: value of the MII_LPA register
- *
- * A small helper function that translates MII_LPA bits, when in
- * 1000Base-T mode, to linkmode LP advertisement settings. Leaves
- * other bits unchanged.
- */
- static inline void mii_lpa_mod_linkmode_lpa_t(unsigned long *lp_advertising,
- u32 lpa)
- {
- mii_adv_mod_linkmode_adv_t(lp_advertising, lpa);
- linkmode_mod_bit(ETHTOOL_LINK_MODE_Autoneg_BIT,
- lp_advertising, lpa & LPA_LPACK);
- }
- static inline void mii_ctrl1000_mod_linkmode_adv_t(unsigned long *advertising,
- u32 ctrl1000)
- {
- linkmode_mod_bit(ETHTOOL_LINK_MODE_1000baseT_Half_BIT, advertising,
- ctrl1000 & ADVERTISE_1000HALF);
- linkmode_mod_bit(ETHTOOL_LINK_MODE_1000baseT_Full_BIT, advertising,
- ctrl1000 & ADVERTISE_1000FULL);
- }
- /**
- * linkmode_adv_to_lcl_adv_t
- * @advertising:pointer to linkmode advertising
- *
- * A small helper function that translates linkmode advertising to LVL
- * pause capabilities.
- */
- static inline u32 linkmode_adv_to_lcl_adv_t(unsigned long *advertising)
- {
- u32 lcl_adv = 0;
- if (linkmode_test_bit(ETHTOOL_LINK_MODE_Pause_BIT,
- advertising))
- lcl_adv |= ADVERTISE_PAUSE_CAP;
- if (linkmode_test_bit(ETHTOOL_LINK_MODE_Asym_Pause_BIT,
- advertising))
- lcl_adv |= ADVERTISE_PAUSE_ASYM;
- return lcl_adv;
- }
- /**
- * mii_lpa_mod_linkmode_x - decode the link partner's config_reg to linkmodes
- * @linkmodes: link modes array
- * @lpa: config_reg word from link partner
- * @fd_bit: link mode for 1000XFULL bit
- */
- static inline void mii_lpa_mod_linkmode_x(unsigned long *linkmodes, u16 lpa,
- int fd_bit)
- {
- linkmode_mod_bit(ETHTOOL_LINK_MODE_Autoneg_BIT, linkmodes,
- lpa & LPA_LPACK);
- linkmode_mod_bit(ETHTOOL_LINK_MODE_Pause_BIT, linkmodes,
- lpa & LPA_1000XPAUSE);
- linkmode_mod_bit(ETHTOOL_LINK_MODE_Asym_Pause_BIT, linkmodes,
- lpa & LPA_1000XPAUSE_ASYM);
- linkmode_mod_bit(fd_bit, linkmodes,
- lpa & LPA_1000XFULL);
- }
- /**
- * linkmode_adv_to_mii_adv_x - encode a linkmode to config_reg
- * @linkmodes: linkmodes
- * @fd_bit: full duplex bit
- */
- static inline u16 linkmode_adv_to_mii_adv_x(const unsigned long *linkmodes,
- int fd_bit)
- {
- u16 adv = 0;
- if (linkmode_test_bit(fd_bit, linkmodes))
- adv |= ADVERTISE_1000XFULL;
- if (linkmode_test_bit(ETHTOOL_LINK_MODE_Pause_BIT, linkmodes))
- adv |= ADVERTISE_1000XPAUSE;
- if (linkmode_test_bit(ETHTOOL_LINK_MODE_Asym_Pause_BIT, linkmodes))
- adv |= ADVERTISE_1000XPSE_ASYM;
- return adv;
- }
- /**
- * mii_advertise_flowctrl - get flow control advertisement flags
- * @cap: Flow control capabilities (FLOW_CTRL_RX, FLOW_CTRL_TX or both)
- */
- static inline u16 mii_advertise_flowctrl(int cap)
- {
- u16 adv = 0;
- if (cap & FLOW_CTRL_RX)
- adv = ADVERTISE_PAUSE_CAP | ADVERTISE_PAUSE_ASYM;
- if (cap & FLOW_CTRL_TX)
- adv ^= ADVERTISE_PAUSE_ASYM;
- return adv;
- }
- /**
- * mii_resolve_flowctrl_fdx
- * @lcladv: value of MII ADVERTISE register
- * @rmtadv: value of MII LPA register
- *
- * Resolve full duplex flow control as per IEEE 802.3-2005 table 28B-3
- */
- static inline u8 mii_resolve_flowctrl_fdx(u16 lcladv, u16 rmtadv)
- {
- u8 cap = 0;
- if (lcladv & rmtadv & ADVERTISE_PAUSE_CAP) {
- cap = FLOW_CTRL_TX | FLOW_CTRL_RX;
- } else if (lcladv & rmtadv & ADVERTISE_PAUSE_ASYM) {
- if (lcladv & ADVERTISE_PAUSE_CAP)
- cap = FLOW_CTRL_RX;
- else if (rmtadv & ADVERTISE_PAUSE_CAP)
- cap = FLOW_CTRL_TX;
- }
- return cap;
- }
- /**
- * mii_bmcr_encode_fixed - encode fixed speed/duplex settings to a BMCR value
- * @speed: a SPEED_* value
- * @duplex: a DUPLEX_* value
- *
- * Encode the speed and duplex to a BMCR value. 2500, 1000, 100 and 10 Mbps are
- * supported. 2500Mbps is encoded to 1000Mbps. Other speeds are encoded as 10
- * Mbps. Unknown duplex values are encoded to half-duplex.
- */
- static inline u16 mii_bmcr_encode_fixed(int speed, int duplex)
- {
- u16 bmcr;
- switch (speed) {
- case SPEED_2500:
- case SPEED_1000:
- bmcr = BMCR_SPEED1000;
- break;
- case SPEED_100:
- bmcr = BMCR_SPEED100;
- break;
- case SPEED_10:
- default:
- bmcr = BMCR_SPEED10;
- break;
- }
- if (duplex == DUPLEX_FULL)
- bmcr |= BMCR_FULLDPLX;
- return bmcr;
- }
- #endif /* __LINUX_MII_H__ */
|