1 // SPDX-License-Identifier: GPL-2.0
3 * Copyright (c) 2020 Synopsys, Inc. and/or its affiliates.
4 * Synopsys DesignWare XPCS helpers
10 #include <linux/delay.h>
11 #include <linux/pcs/pcs-xpcs.h>
12 #include <linux/mdio.h>
13 #include <linux/phy.h>
14 #include <linux/phylink.h>
15 #include <linux/property.h>
19 #define phylink_pcs_to_xpcs(pl_pcs) \
20 container_of((pl_pcs), struct dw_xpcs, pcs)
22 static const int xpcs_usxgmii_features[] = {
23 ETHTOOL_LINK_MODE_Pause_BIT,
24 ETHTOOL_LINK_MODE_Asym_Pause_BIT,
25 ETHTOOL_LINK_MODE_Autoneg_BIT,
26 ETHTOOL_LINK_MODE_1000baseKX_Full_BIT,
27 ETHTOOL_LINK_MODE_10000baseKX4_Full_BIT,
28 ETHTOOL_LINK_MODE_10000baseKR_Full_BIT,
29 ETHTOOL_LINK_MODE_2500baseX_Full_BIT,
30 __ETHTOOL_LINK_MODE_MASK_NBITS,
33 static const int xpcs_10gkr_features[] = {
34 ETHTOOL_LINK_MODE_Pause_BIT,
35 ETHTOOL_LINK_MODE_Asym_Pause_BIT,
36 ETHTOOL_LINK_MODE_10000baseKR_Full_BIT,
37 __ETHTOOL_LINK_MODE_MASK_NBITS,
40 static const int xpcs_xlgmii_features[] = {
41 ETHTOOL_LINK_MODE_Pause_BIT,
42 ETHTOOL_LINK_MODE_Asym_Pause_BIT,
43 ETHTOOL_LINK_MODE_25000baseCR_Full_BIT,
44 ETHTOOL_LINK_MODE_25000baseKR_Full_BIT,
45 ETHTOOL_LINK_MODE_25000baseSR_Full_BIT,
46 ETHTOOL_LINK_MODE_40000baseKR4_Full_BIT,
47 ETHTOOL_LINK_MODE_40000baseCR4_Full_BIT,
48 ETHTOOL_LINK_MODE_40000baseSR4_Full_BIT,
49 ETHTOOL_LINK_MODE_40000baseLR4_Full_BIT,
50 ETHTOOL_LINK_MODE_50000baseCR2_Full_BIT,
51 ETHTOOL_LINK_MODE_50000baseKR2_Full_BIT,
52 ETHTOOL_LINK_MODE_50000baseSR2_Full_BIT,
53 ETHTOOL_LINK_MODE_50000baseKR_Full_BIT,
54 ETHTOOL_LINK_MODE_50000baseSR_Full_BIT,
55 ETHTOOL_LINK_MODE_50000baseCR_Full_BIT,
56 ETHTOOL_LINK_MODE_50000baseLR_ER_FR_Full_BIT,
57 ETHTOOL_LINK_MODE_50000baseDR_Full_BIT,
58 ETHTOOL_LINK_MODE_100000baseKR4_Full_BIT,
59 ETHTOOL_LINK_MODE_100000baseSR4_Full_BIT,
60 ETHTOOL_LINK_MODE_100000baseCR4_Full_BIT,
61 ETHTOOL_LINK_MODE_100000baseLR4_ER4_Full_BIT,
62 ETHTOOL_LINK_MODE_100000baseKR2_Full_BIT,
63 ETHTOOL_LINK_MODE_100000baseSR2_Full_BIT,
64 ETHTOOL_LINK_MODE_100000baseCR2_Full_BIT,
65 ETHTOOL_LINK_MODE_100000baseLR2_ER2_FR2_Full_BIT,
66 ETHTOOL_LINK_MODE_100000baseDR2_Full_BIT,
67 __ETHTOOL_LINK_MODE_MASK_NBITS,
70 static const int xpcs_10gbaser_features[] = {
71 ETHTOOL_LINK_MODE_Pause_BIT,
72 ETHTOOL_LINK_MODE_Asym_Pause_BIT,
73 ETHTOOL_LINK_MODE_10000baseSR_Full_BIT,
74 ETHTOOL_LINK_MODE_10000baseLR_Full_BIT,
75 ETHTOOL_LINK_MODE_10000baseLRM_Full_BIT,
76 ETHTOOL_LINK_MODE_10000baseER_Full_BIT,
77 __ETHTOOL_LINK_MODE_MASK_NBITS,
80 static const int xpcs_sgmii_features[] = {
81 ETHTOOL_LINK_MODE_Pause_BIT,
82 ETHTOOL_LINK_MODE_Asym_Pause_BIT,
83 ETHTOOL_LINK_MODE_Autoneg_BIT,
84 ETHTOOL_LINK_MODE_10baseT_Half_BIT,
85 ETHTOOL_LINK_MODE_10baseT_Full_BIT,
86 ETHTOOL_LINK_MODE_100baseT_Half_BIT,
87 ETHTOOL_LINK_MODE_100baseT_Full_BIT,
88 ETHTOOL_LINK_MODE_1000baseT_Half_BIT,
89 ETHTOOL_LINK_MODE_1000baseT_Full_BIT,
90 __ETHTOOL_LINK_MODE_MASK_NBITS,
93 static const int xpcs_1000basex_features[] = {
94 ETHTOOL_LINK_MODE_Pause_BIT,
95 ETHTOOL_LINK_MODE_Asym_Pause_BIT,
96 ETHTOOL_LINK_MODE_Autoneg_BIT,
97 ETHTOOL_LINK_MODE_1000baseX_Full_BIT,
98 __ETHTOOL_LINK_MODE_MASK_NBITS,
101 static const int xpcs_2500basex_features[] = {
102 ETHTOOL_LINK_MODE_Pause_BIT,
103 ETHTOOL_LINK_MODE_Asym_Pause_BIT,
104 ETHTOOL_LINK_MODE_Autoneg_BIT,
105 ETHTOOL_LINK_MODE_2500baseX_Full_BIT,
106 ETHTOOL_LINK_MODE_2500baseT_Full_BIT,
107 __ETHTOOL_LINK_MODE_MASK_NBITS,
110 struct dw_xpcs_compat {
111 phy_interface_t interface;
112 const int *supported;
114 int (*pma_config)(struct dw_xpcs *xpcs);
117 struct dw_xpcs_desc {
120 const struct dw_xpcs_compat *compat;
123 static const struct dw_xpcs_compat *
124 xpcs_find_compat(struct dw_xpcs *xpcs, phy_interface_t interface)
126 const struct dw_xpcs_compat *compat;
128 for (compat = xpcs->desc->compat; compat->supported; compat++)
129 if (compat->interface == interface)
135 struct phylink_pcs *xpcs_to_phylink_pcs(struct dw_xpcs *xpcs)
139 EXPORT_SYMBOL_GPL(xpcs_to_phylink_pcs);
141 int xpcs_get_an_mode(struct dw_xpcs *xpcs, phy_interface_t interface)
143 const struct dw_xpcs_compat *compat;
145 compat = xpcs_find_compat(xpcs, interface);
149 return compat->an_mode;
151 EXPORT_SYMBOL_GPL(xpcs_get_an_mode);
153 static bool __xpcs_linkmode_supported(const struct dw_xpcs_compat *compat,
154 enum ethtool_link_mode_bit_indices linkmode)
158 for (i = 0; compat->supported[i] != __ETHTOOL_LINK_MODE_MASK_NBITS; i++)
159 if (compat->supported[i] == linkmode)
165 #define xpcs_linkmode_supported(compat, mode) \
166 __xpcs_linkmode_supported(compat, ETHTOOL_LINK_MODE_ ## mode ## _BIT)
168 int xpcs_read(struct dw_xpcs *xpcs, int dev, u32 reg)
170 return mdiodev_c45_read(xpcs->mdiodev, dev, reg);
173 int xpcs_write(struct dw_xpcs *xpcs, int dev, u32 reg, u16 val)
175 return mdiodev_c45_write(xpcs->mdiodev, dev, reg, val);
178 int xpcs_modify(struct dw_xpcs *xpcs, int dev, u32 reg, u16 mask, u16 set)
180 return mdiodev_c45_modify(xpcs->mdiodev, dev, reg, mask, set);
183 static int xpcs_modify_changed(struct dw_xpcs *xpcs, int dev, u32 reg,
186 return mdiodev_c45_modify_changed(xpcs->mdiodev, dev, reg, mask, set);
189 static int xpcs_read_vendor(struct dw_xpcs *xpcs, int dev, u32 reg)
191 return xpcs_read(xpcs, dev, DW_VENDOR | reg);
194 static int xpcs_write_vendor(struct dw_xpcs *xpcs, int dev, int reg,
197 return xpcs_write(xpcs, dev, DW_VENDOR | reg, val);
200 static int xpcs_modify_vendor(struct dw_xpcs *xpcs, int dev, int reg, u16 mask,
203 return xpcs_modify(xpcs, dev, DW_VENDOR | reg, mask, set);
206 int xpcs_read_vpcs(struct dw_xpcs *xpcs, int reg)
208 return xpcs_read_vendor(xpcs, MDIO_MMD_PCS, reg);
211 int xpcs_write_vpcs(struct dw_xpcs *xpcs, int reg, u16 val)
213 return xpcs_write_vendor(xpcs, MDIO_MMD_PCS, reg, val);
216 static int xpcs_modify_vpcs(struct dw_xpcs *xpcs, int reg, u16 mask, u16 val)
218 return xpcs_modify_vendor(xpcs, MDIO_MMD_PCS, reg, mask, val);
221 static int xpcs_poll_reset(struct dw_xpcs *xpcs, int dev)
225 ret = read_poll_timeout(xpcs_read, val,
226 val < 0 || !(val & BMCR_RESET),
227 50000, 600000, true, xpcs, dev, MII_BMCR);
234 static int xpcs_soft_reset(struct dw_xpcs *xpcs,
235 const struct dw_xpcs_compat *compat)
239 switch (compat->an_mode) {
244 case DW_AN_C37_SGMII:
246 case DW_AN_C37_1000BASEX:
247 dev = MDIO_MMD_VEND2;
253 ret = xpcs_write(xpcs, dev, MII_BMCR, BMCR_RESET);
257 return xpcs_poll_reset(xpcs, dev);
260 #define xpcs_warn(__xpcs, __state, __args...) \
262 if ((__state)->link) \
263 dev_warn(&(__xpcs)->mdiodev->dev, ##__args); \
266 static int xpcs_read_fault_c73(struct dw_xpcs *xpcs,
267 struct phylink_link_state *state,
272 if (pcs_stat1 & MDIO_STAT1_FAULT) {
273 xpcs_warn(xpcs, state, "Link fault condition detected!\n");
277 ret = xpcs_read(xpcs, MDIO_MMD_PCS, MDIO_STAT2);
281 if (ret & MDIO_STAT2_RXFAULT)
282 xpcs_warn(xpcs, state, "Receiver fault detected!\n");
283 if (ret & MDIO_STAT2_TXFAULT)
284 xpcs_warn(xpcs, state, "Transmitter fault detected!\n");
286 ret = xpcs_read_vendor(xpcs, MDIO_MMD_PCS, DW_VR_XS_PCS_DIG_STS);
290 if (ret & DW_RXFIFO_ERR) {
291 xpcs_warn(xpcs, state, "FIFO fault condition detected!\n");
295 ret = xpcs_read(xpcs, MDIO_MMD_PCS, MDIO_PCS_10GBRT_STAT1);
299 if (!(ret & MDIO_PCS_10GBRT_STAT1_BLKLK))
300 xpcs_warn(xpcs, state, "Link is not locked!\n");
302 ret = xpcs_read(xpcs, MDIO_MMD_PCS, MDIO_PCS_10GBRT_STAT2);
306 if (ret & MDIO_PCS_10GBRT_STAT2_ERR) {
307 xpcs_warn(xpcs, state, "Link has errors!\n");
314 static void xpcs_link_up_usxgmii(struct dw_xpcs *xpcs, int speed)
320 speed_sel = DW_USXGMII_10;
323 speed_sel = DW_USXGMII_100;
326 speed_sel = DW_USXGMII_1000;
329 speed_sel = DW_USXGMII_2500;
332 speed_sel = DW_USXGMII_5000;
335 speed_sel = DW_USXGMII_10000;
338 /* Nothing to do here */
342 ret = xpcs_modify_vpcs(xpcs, MDIO_CTRL1, DW_USXGMII_EN, DW_USXGMII_EN);
346 ret = xpcs_modify(xpcs, MDIO_MMD_VEND2, MII_BMCR, DW_USXGMII_SS_MASK,
347 speed_sel | DW_USXGMII_FULL);
351 ret = xpcs_modify_vpcs(xpcs, MDIO_CTRL1, DW_USXGMII_RST,
359 dev_err(&xpcs->mdiodev->dev, "%s: XPCS access returned %pe\n",
360 __func__, ERR_PTR(ret));
363 static int _xpcs_config_aneg_c73(struct dw_xpcs *xpcs,
364 const struct dw_xpcs_compat *compat)
368 /* By default, in USXGMII mode XPCS operates at 10G baud and
369 * replicates data to achieve lower speeds. Hereby, in this
370 * default configuration we need to advertise all supported
371 * modes and not only the ones we want to use.
376 if (xpcs_linkmode_supported(compat, 2500baseX_Full))
377 adv |= DW_C73_2500KX;
379 /* TODO: 5000baseKR */
381 ret = xpcs_write(xpcs, MDIO_MMD_AN, DW_SR_AN_ADV3, adv);
387 if (xpcs_linkmode_supported(compat, 1000baseKX_Full))
388 adv |= DW_C73_1000KX;
389 if (xpcs_linkmode_supported(compat, 10000baseKX4_Full))
390 adv |= DW_C73_10000KX4;
391 if (xpcs_linkmode_supported(compat, 10000baseKR_Full))
392 adv |= DW_C73_10000KR;
394 ret = xpcs_write(xpcs, MDIO_MMD_AN, DW_SR_AN_ADV2, adv);
399 adv = DW_C73_AN_ADV_SF;
400 if (xpcs_linkmode_supported(compat, Pause))
402 if (xpcs_linkmode_supported(compat, Asym_Pause))
403 adv |= DW_C73_ASYM_PAUSE;
405 return xpcs_write(xpcs, MDIO_MMD_AN, DW_SR_AN_ADV1, adv);
408 static int xpcs_config_aneg_c73(struct dw_xpcs *xpcs,
409 const struct dw_xpcs_compat *compat)
413 ret = _xpcs_config_aneg_c73(xpcs, compat);
417 return xpcs_modify(xpcs, MDIO_MMD_AN, MDIO_CTRL1,
418 MDIO_AN_CTRL1_ENABLE | MDIO_AN_CTRL1_RESTART,
419 MDIO_AN_CTRL1_ENABLE | MDIO_AN_CTRL1_RESTART);
422 static int xpcs_aneg_done_c73(struct dw_xpcs *xpcs,
423 struct phylink_link_state *state,
424 const struct dw_xpcs_compat *compat, u16 an_stat1)
428 if (an_stat1 & MDIO_AN_STAT1_COMPLETE) {
429 ret = xpcs_read(xpcs, MDIO_MMD_AN, MDIO_AN_LPA);
433 /* Check if Aneg outcome is valid */
434 if (!(ret & DW_C73_AN_ADV_SF)) {
435 xpcs_config_aneg_c73(xpcs, compat);
445 static int xpcs_read_lpa_c73(struct dw_xpcs *xpcs,
446 struct phylink_link_state *state, u16 an_stat1)
451 if (!(an_stat1 & MDIO_AN_STAT1_LPABLE)) {
452 phylink_clear(state->lp_advertising, Autoneg);
456 phylink_set(state->lp_advertising, Autoneg);
458 /* Read Clause 73 link partner advertisement */
459 for (i = ARRAY_SIZE(lpa); --i >= 0; ) {
460 ret = xpcs_read(xpcs, MDIO_MMD_AN, MDIO_AN_LPA + i);
467 mii_c73_mod_linkmode(state->lp_advertising, lpa);
472 static int xpcs_get_max_xlgmii_speed(struct dw_xpcs *xpcs,
473 struct phylink_link_state *state)
475 unsigned long *adv = state->advertising;
476 int speed = SPEED_UNKNOWN;
479 for_each_set_bit(bit, adv, __ETHTOOL_LINK_MODE_MASK_NBITS) {
480 int new_speed = SPEED_UNKNOWN;
483 case ETHTOOL_LINK_MODE_25000baseCR_Full_BIT:
484 case ETHTOOL_LINK_MODE_25000baseKR_Full_BIT:
485 case ETHTOOL_LINK_MODE_25000baseSR_Full_BIT:
486 new_speed = SPEED_25000;
488 case ETHTOOL_LINK_MODE_40000baseKR4_Full_BIT:
489 case ETHTOOL_LINK_MODE_40000baseCR4_Full_BIT:
490 case ETHTOOL_LINK_MODE_40000baseSR4_Full_BIT:
491 case ETHTOOL_LINK_MODE_40000baseLR4_Full_BIT:
492 new_speed = SPEED_40000;
494 case ETHTOOL_LINK_MODE_50000baseCR2_Full_BIT:
495 case ETHTOOL_LINK_MODE_50000baseKR2_Full_BIT:
496 case ETHTOOL_LINK_MODE_50000baseSR2_Full_BIT:
497 case ETHTOOL_LINK_MODE_50000baseKR_Full_BIT:
498 case ETHTOOL_LINK_MODE_50000baseSR_Full_BIT:
499 case ETHTOOL_LINK_MODE_50000baseCR_Full_BIT:
500 case ETHTOOL_LINK_MODE_50000baseLR_ER_FR_Full_BIT:
501 case ETHTOOL_LINK_MODE_50000baseDR_Full_BIT:
502 new_speed = SPEED_50000;
504 case ETHTOOL_LINK_MODE_100000baseKR4_Full_BIT:
505 case ETHTOOL_LINK_MODE_100000baseSR4_Full_BIT:
506 case ETHTOOL_LINK_MODE_100000baseCR4_Full_BIT:
507 case ETHTOOL_LINK_MODE_100000baseLR4_ER4_Full_BIT:
508 case ETHTOOL_LINK_MODE_100000baseKR2_Full_BIT:
509 case ETHTOOL_LINK_MODE_100000baseSR2_Full_BIT:
510 case ETHTOOL_LINK_MODE_100000baseCR2_Full_BIT:
511 case ETHTOOL_LINK_MODE_100000baseLR2_ER2_FR2_Full_BIT:
512 case ETHTOOL_LINK_MODE_100000baseDR2_Full_BIT:
513 new_speed = SPEED_100000;
519 if (new_speed > speed)
526 static void xpcs_resolve_pma(struct dw_xpcs *xpcs,
527 struct phylink_link_state *state)
529 state->pause = MLO_PAUSE_TX | MLO_PAUSE_RX;
530 state->duplex = DUPLEX_FULL;
532 switch (state->interface) {
533 case PHY_INTERFACE_MODE_10GKR:
534 state->speed = SPEED_10000;
536 case PHY_INTERFACE_MODE_XLGMII:
537 state->speed = xpcs_get_max_xlgmii_speed(xpcs, state);
540 state->speed = SPEED_UNKNOWN;
545 static int xpcs_validate(struct phylink_pcs *pcs, unsigned long *supported,
546 const struct phylink_link_state *state)
548 __ETHTOOL_DECLARE_LINK_MODE_MASK(xpcs_supported) = { 0, };
549 const struct dw_xpcs_compat *compat;
550 struct dw_xpcs *xpcs;
553 xpcs = phylink_pcs_to_xpcs(pcs);
554 compat = xpcs_find_compat(xpcs, state->interface);
558 /* Populate the supported link modes for this PHY interface type.
559 * FIXME: what about the port modes and autoneg bit? This masks
562 for (i = 0; compat->supported[i] != __ETHTOOL_LINK_MODE_MASK_NBITS; i++)
563 set_bit(compat->supported[i], xpcs_supported);
565 linkmode_and(supported, supported, xpcs_supported);
570 static unsigned int xpcs_inband_caps(struct phylink_pcs *pcs,
571 phy_interface_t interface)
573 struct dw_xpcs *xpcs = phylink_pcs_to_xpcs(pcs);
574 const struct dw_xpcs_compat *compat;
576 compat = xpcs_find_compat(xpcs, interface);
580 switch (compat->an_mode) {
582 return LINK_INBAND_ENABLE;
584 case DW_AN_C37_SGMII:
585 case DW_AN_C37_1000BASEX:
586 return LINK_INBAND_DISABLE | LINK_INBAND_ENABLE;
590 return LINK_INBAND_DISABLE;
597 static void xpcs_get_interfaces(struct dw_xpcs *xpcs, unsigned long *interfaces)
599 const struct dw_xpcs_compat *compat;
601 for (compat = xpcs->desc->compat; compat->supported; compat++)
602 __set_bit(compat->interface, interfaces);
605 int xpcs_config_eee(struct dw_xpcs *xpcs, int mult_fact_100ns, int enable)
610 mask = DW_VR_MII_EEE_LTX_EN | DW_VR_MII_EEE_LRX_EN |
611 DW_VR_MII_EEE_TX_QUIET_EN | DW_VR_MII_EEE_RX_QUIET_EN |
612 DW_VR_MII_EEE_TX_EN_CTRL | DW_VR_MII_EEE_RX_EN_CTRL |
613 DW_VR_MII_EEE_MULT_FACT_100NS;
616 val = DW_VR_MII_EEE_LTX_EN | DW_VR_MII_EEE_LRX_EN |
617 DW_VR_MII_EEE_TX_QUIET_EN | DW_VR_MII_EEE_RX_QUIET_EN |
618 DW_VR_MII_EEE_TX_EN_CTRL | DW_VR_MII_EEE_RX_EN_CTRL |
619 FIELD_PREP(DW_VR_MII_EEE_MULT_FACT_100NS,
624 ret = xpcs_modify(xpcs, MDIO_MMD_VEND2, DW_VR_MII_EEE_MCTRL0, mask,
629 return xpcs_modify(xpcs, MDIO_MMD_VEND2, DW_VR_MII_EEE_MCTRL1,
630 DW_VR_MII_EEE_TRN_LPI,
631 enable ? DW_VR_MII_EEE_TRN_LPI : 0);
633 EXPORT_SYMBOL_GPL(xpcs_config_eee);
635 static void xpcs_pre_config(struct phylink_pcs *pcs, phy_interface_t interface)
637 struct dw_xpcs *xpcs = phylink_pcs_to_xpcs(pcs);
638 const struct dw_xpcs_compat *compat;
641 if (!xpcs->need_reset)
644 compat = xpcs_find_compat(xpcs, interface);
646 dev_err(&xpcs->mdiodev->dev, "unsupported interface %s\n",
647 phy_modes(interface));
651 ret = xpcs_soft_reset(xpcs, compat);
653 dev_err(&xpcs->mdiodev->dev, "soft reset failed: %pe\n",
656 xpcs->need_reset = false;
659 static int xpcs_config_aneg_c37_sgmii(struct dw_xpcs *xpcs,
660 unsigned int neg_mode)
662 int ret, mdio_ctrl, tx_conf;
665 /* For AN for C37 SGMII mode, the settings are :-
666 * 1) VR_MII_MMD_CTRL Bit(12) [AN_ENABLE] = 0b (Disable SGMII AN in case
667 it is already enabled)
668 * 2) VR_MII_AN_CTRL Bit(2:1)[PCS_MODE] = 10b (SGMII AN)
669 * 3) VR_MII_AN_CTRL Bit(3) [TX_CONFIG] = 0b (MAC side SGMII)
670 * DW xPCS used with DW EQoS MAC is always MAC side SGMII.
671 * 4) VR_MII_DIG_CTRL1 Bit(9) [MAC_AUTO_SW] = 1b (Automatic
672 * speed/duplex mode change by HW after SGMII AN complete)
673 * 5) VR_MII_MMD_CTRL Bit(12) [AN_ENABLE] = 1b (Enable SGMII AN)
675 * Note that VR_MII_MMD_CTRL is MII_BMCR.
677 * Note: Since it is MAC side SGMII, there is no need to set
678 * SR_MII_AN_ADV. MAC side SGMII receives AN Tx Config from
679 * PHY about the link state change after C28 AN is completed
680 * between PHY and Link Partner. There is also no need to
681 * trigger AN restart for MAC-side SGMII.
683 mdio_ctrl = xpcs_read(xpcs, MDIO_MMD_VEND2, MII_BMCR);
687 if (mdio_ctrl & BMCR_ANENABLE) {
688 ret = xpcs_write(xpcs, MDIO_MMD_VEND2, MII_BMCR,
689 mdio_ctrl & ~BMCR_ANENABLE);
694 mask = DW_VR_MII_PCS_MODE_MASK | DW_VR_MII_TX_CONFIG_MASK;
695 val = FIELD_PREP(DW_VR_MII_PCS_MODE_MASK,
696 DW_VR_MII_PCS_MODE_C37_SGMII);
698 if (xpcs->info.pma == WX_TXGBE_XPCS_PMA_10G_ID) {
699 mask |= DW_VR_MII_AN_CTRL_8BIT;
700 val |= DW_VR_MII_AN_CTRL_8BIT;
701 /* Hardware requires it to be PHY side SGMII */
702 tx_conf = DW_VR_MII_TX_CONFIG_PHY_SIDE_SGMII;
704 tx_conf = DW_VR_MII_TX_CONFIG_MAC_SIDE_SGMII;
707 val |= FIELD_PREP(DW_VR_MII_TX_CONFIG_MASK, tx_conf);
709 ret = xpcs_modify(xpcs, MDIO_MMD_VEND2, DW_VR_MII_AN_CTRL, mask, val);
714 mask = DW_VR_MII_DIG_CTRL1_2G5_EN | DW_VR_MII_DIG_CTRL1_MAC_AUTO_SW;
716 if (neg_mode == PHYLINK_PCS_NEG_INBAND_ENABLED)
717 val = DW_VR_MII_DIG_CTRL1_MAC_AUTO_SW;
719 if (xpcs->info.pma == WX_TXGBE_XPCS_PMA_10G_ID) {
720 mask |= DW_VR_MII_DIG_CTRL1_PHY_MODE_CTRL;
721 val |= DW_VR_MII_DIG_CTRL1_PHY_MODE_CTRL;
724 ret = xpcs_modify(xpcs, MDIO_MMD_VEND2, DW_VR_MII_DIG_CTRL1, mask, val);
728 if (neg_mode == PHYLINK_PCS_NEG_INBAND_ENABLED)
729 ret = xpcs_write(xpcs, MDIO_MMD_VEND2, MII_BMCR,
730 mdio_ctrl | BMCR_ANENABLE);
735 static int xpcs_config_aneg_c37_1000basex(struct dw_xpcs *xpcs,
736 unsigned int neg_mode,
737 const unsigned long *advertising)
739 phy_interface_t interface = PHY_INTERFACE_MODE_1000BASEX;
740 int ret, mdio_ctrl, adv;
744 /* According to Chap 7.12, to set 1000BASE-X C37 AN, AN must
745 * be disabled first:-
746 * 1) VR_MII_MMD_CTRL Bit(12)[AN_ENABLE] = 0b
747 * 2) VR_MII_AN_CTRL Bit(2:1)[PCS_MODE] = 00b (1000BASE-X C37)
749 * Note that VR_MII_MMD_CTRL is MII_BMCR.
751 mdio_ctrl = xpcs_read(xpcs, MDIO_MMD_VEND2, MII_BMCR);
755 if (mdio_ctrl & BMCR_ANENABLE) {
756 ret = xpcs_write(xpcs, MDIO_MMD_VEND2, MII_BMCR,
757 mdio_ctrl & ~BMCR_ANENABLE);
762 mask = DW_VR_MII_PCS_MODE_MASK;
763 val = FIELD_PREP(DW_VR_MII_PCS_MODE_MASK,
764 DW_VR_MII_PCS_MODE_C37_1000BASEX);
766 if (!xpcs->pcs.poll) {
767 mask |= DW_VR_MII_AN_INTR_EN;
768 val |= DW_VR_MII_AN_INTR_EN;
771 ret = xpcs_modify(xpcs, MDIO_MMD_VEND2, DW_VR_MII_AN_CTRL, mask, val);
775 /* Check for advertising changes and update the C45 MII ADV
776 * register accordingly.
778 adv = phylink_mii_c22_pcs_encode_advertisement(interface,
781 ret = xpcs_modify_changed(xpcs, MDIO_MMD_VEND2,
782 MII_ADVERTISE, 0xffff, adv);
789 /* Clear CL37 AN complete status */
790 ret = xpcs_write(xpcs, MDIO_MMD_VEND2, DW_VR_MII_AN_INTR_STS, 0);
794 if (neg_mode == PHYLINK_PCS_NEG_INBAND_ENABLED) {
795 ret = xpcs_write(xpcs, MDIO_MMD_VEND2, MII_BMCR,
796 mdio_ctrl | BMCR_ANENABLE);
804 static int xpcs_config_2500basex(struct dw_xpcs *xpcs)
808 ret = xpcs_modify(xpcs, MDIO_MMD_VEND2, DW_VR_MII_DIG_CTRL1,
809 DW_VR_MII_DIG_CTRL1_2G5_EN |
810 DW_VR_MII_DIG_CTRL1_MAC_AUTO_SW,
811 DW_VR_MII_DIG_CTRL1_2G5_EN);
815 return xpcs_modify(xpcs, MDIO_MMD_VEND2, MII_BMCR,
816 BMCR_ANENABLE | BMCR_SPEED1000 | BMCR_SPEED100,
820 static int xpcs_do_config(struct dw_xpcs *xpcs, phy_interface_t interface,
821 const unsigned long *advertising,
822 unsigned int neg_mode)
824 const struct dw_xpcs_compat *compat;
827 compat = xpcs_find_compat(xpcs, interface);
831 if (xpcs->info.pma == WX_TXGBE_XPCS_PMA_10G_ID) {
832 ret = txgbe_xpcs_switch_mode(xpcs, interface);
836 /* Wangxun devices need backplane CL37 AN enabled for
837 * SGMII and 1000base-X
839 if (interface == PHY_INTERFACE_MODE_SGMII ||
840 interface == PHY_INTERFACE_MODE_1000BASEX)
841 xpcs_write_vpcs(xpcs, DW_VR_XS_PCS_DIG_CTRL1,
842 DW_CL37_BP | DW_EN_VSMMD1);
845 switch (compat->an_mode) {
849 if (neg_mode == PHYLINK_PCS_NEG_INBAND_ENABLED) {
850 ret = xpcs_config_aneg_c73(xpcs, compat);
855 case DW_AN_C37_SGMII:
856 ret = xpcs_config_aneg_c37_sgmii(xpcs, neg_mode);
860 case DW_AN_C37_1000BASEX:
861 ret = xpcs_config_aneg_c37_1000basex(xpcs, neg_mode,
867 ret = xpcs_config_2500basex(xpcs);
875 if (compat->pma_config) {
876 ret = compat->pma_config(xpcs);
884 static int xpcs_config(struct phylink_pcs *pcs, unsigned int neg_mode,
885 phy_interface_t interface,
886 const unsigned long *advertising,
887 bool permit_pause_to_mac)
889 struct dw_xpcs *xpcs = phylink_pcs_to_xpcs(pcs);
891 return xpcs_do_config(xpcs, interface, advertising, neg_mode);
894 static int xpcs_get_state_c73(struct dw_xpcs *xpcs,
895 struct phylink_link_state *state,
896 const struct dw_xpcs_compat *compat)
903 /* The link status bit is latching-low, so it is important to
904 * avoid unnecessary re-reads of this register to avoid missing
907 pcs_stat1 = xpcs_read(xpcs, MDIO_MMD_PCS, MDIO_STAT1);
913 /* Link needs to be read first ... */
914 state->link = !!(pcs_stat1 & MDIO_STAT1_LSTATUS);
916 /* ... and then we check the faults. */
917 ret = xpcs_read_fault_c73(xpcs, state, pcs_stat1);
919 ret = xpcs_soft_reset(xpcs, compat);
925 return xpcs_do_config(xpcs, state->interface, NULL,
926 PHYLINK_PCS_NEG_INBAND_ENABLED);
929 /* There is no point doing anything else if the link is down. */
933 an_enabled = linkmode_test_bit(ETHTOOL_LINK_MODE_Autoneg_BIT,
936 /* The link status bit is latching-low, so it is important to
937 * avoid unnecessary re-reads of this register to avoid missing
940 an_stat1 = xpcs_read(xpcs, MDIO_MMD_AN, MDIO_STAT1);
946 state->an_complete = xpcs_aneg_done_c73(xpcs, state, compat,
948 if (!state->an_complete) {
953 ret = xpcs_read_lpa_c73(xpcs, state, an_stat1);
959 phylink_resolve_c73(state);
961 xpcs_resolve_pma(xpcs, state);
967 static int xpcs_get_state_c37_sgmii(struct dw_xpcs *xpcs,
968 struct phylink_link_state *state)
972 /* Reset link_state */
974 state->speed = SPEED_UNKNOWN;
975 state->duplex = DUPLEX_UNKNOWN;
978 /* For C37 SGMII mode, we check DW_VR_MII_AN_INTR_STS for link
979 * status, speed and duplex.
981 ret = xpcs_read(xpcs, MDIO_MMD_VEND2, DW_VR_MII_AN_INTR_STS);
985 if (ret & DW_VR_MII_C37_ANSGM_SP_LNKSTS) {
990 speed_value = FIELD_GET(DW_VR_MII_AN_STS_C37_ANSGM_SP, ret);
991 if (speed_value == DW_VR_MII_C37_ANSGM_SP_1000)
992 state->speed = SPEED_1000;
993 else if (speed_value == DW_VR_MII_C37_ANSGM_SP_100)
994 state->speed = SPEED_100;
996 state->speed = SPEED_10;
998 if (ret & DW_VR_MII_AN_STS_C37_ANSGM_FD)
999 state->duplex = DUPLEX_FULL;
1001 state->duplex = DUPLEX_HALF;
1002 } else if (ret == DW_VR_MII_AN_STS_C37_ANCMPLT_INTR) {
1007 speed = xpcs_read(xpcs, MDIO_MMD_VEND2, MII_BMCR);
1011 speed &= BMCR_SPEED100 | BMCR_SPEED1000;
1012 if (speed == BMCR_SPEED1000)
1013 state->speed = SPEED_1000;
1014 else if (speed == BMCR_SPEED100)
1015 state->speed = SPEED_100;
1016 else if (speed == 0)
1017 state->speed = SPEED_10;
1019 duplex = xpcs_read(xpcs, MDIO_MMD_VEND2, MII_ADVERTISE);
1023 if (duplex & ADVERTISE_1000XFULL)
1024 state->duplex = DUPLEX_FULL;
1025 else if (duplex & ADVERTISE_1000XHALF)
1026 state->duplex = DUPLEX_HALF;
1028 xpcs_write(xpcs, MDIO_MMD_VEND2, DW_VR_MII_AN_INTR_STS, 0);
1034 static int xpcs_get_state_c37_1000basex(struct dw_xpcs *xpcs,
1035 unsigned int neg_mode,
1036 struct phylink_link_state *state)
1040 if (linkmode_test_bit(ETHTOOL_LINK_MODE_Autoneg_BIT,
1041 state->advertising)) {
1042 /* Reset link state */
1043 state->link = false;
1045 lpa = xpcs_read(xpcs, MDIO_MMD_VEND2, MII_LPA);
1046 if (lpa < 0 || lpa & LPA_RFAULT)
1049 bmsr = xpcs_read(xpcs, MDIO_MMD_VEND2, MII_BMSR);
1053 /* Clear AN complete interrupt */
1054 if (!xpcs->pcs.poll) {
1057 an_intr = xpcs_read(xpcs, MDIO_MMD_VEND2, DW_VR_MII_AN_INTR_STS);
1058 if (an_intr & DW_VR_MII_AN_STS_C37_ANCMPLT_INTR) {
1059 an_intr &= ~DW_VR_MII_AN_STS_C37_ANCMPLT_INTR;
1060 xpcs_write(xpcs, MDIO_MMD_VEND2, DW_VR_MII_AN_INTR_STS, an_intr);
1064 phylink_mii_c22_pcs_decode_state(state, neg_mode, bmsr, lpa);
1070 static int xpcs_get_state_2500basex(struct dw_xpcs *xpcs,
1071 struct phylink_link_state *state)
1075 ret = xpcs_read(xpcs, MDIO_MMD_VEND2, MII_BMSR);
1081 state->link = !!(ret & BMSR_LSTATUS);
1085 state->speed = SPEED_2500;
1086 state->pause |= MLO_PAUSE_TX | MLO_PAUSE_RX;
1087 state->duplex = DUPLEX_FULL;
1092 static void xpcs_get_state(struct phylink_pcs *pcs, unsigned int neg_mode,
1093 struct phylink_link_state *state)
1095 struct dw_xpcs *xpcs = phylink_pcs_to_xpcs(pcs);
1096 const struct dw_xpcs_compat *compat;
1099 compat = xpcs_find_compat(xpcs, state->interface);
1103 switch (compat->an_mode) {
1105 phylink_mii_c45_pcs_get_state(xpcs->mdiodev, state);
1108 ret = xpcs_get_state_c73(xpcs, state, compat);
1110 dev_err(&xpcs->mdiodev->dev, "%s returned %pe\n",
1111 "xpcs_get_state_c73", ERR_PTR(ret));
1113 case DW_AN_C37_SGMII:
1114 ret = xpcs_get_state_c37_sgmii(xpcs, state);
1116 dev_err(&xpcs->mdiodev->dev, "%s returned %pe\n",
1117 "xpcs_get_state_c37_sgmii", ERR_PTR(ret));
1119 case DW_AN_C37_1000BASEX:
1120 ret = xpcs_get_state_c37_1000basex(xpcs, neg_mode, state);
1122 dev_err(&xpcs->mdiodev->dev, "%s returned %pe\n",
1123 "xpcs_get_state_c37_1000basex", ERR_PTR(ret));
1126 ret = xpcs_get_state_2500basex(xpcs, state);
1128 dev_err(&xpcs->mdiodev->dev, "%s returned %pe\n",
1129 "xpcs_get_state_2500basex", ERR_PTR(ret));
1136 static void xpcs_link_up_sgmii_1000basex(struct dw_xpcs *xpcs,
1137 unsigned int neg_mode,
1138 phy_interface_t interface,
1139 int speed, int duplex)
1143 if (neg_mode == PHYLINK_PCS_NEG_INBAND_ENABLED)
1146 if (interface == PHY_INTERFACE_MODE_1000BASEX) {
1147 if (speed != SPEED_1000) {
1148 dev_err(&xpcs->mdiodev->dev,
1149 "%s: speed %dMbps not supported\n",
1154 if (duplex != DUPLEX_FULL)
1155 dev_err(&xpcs->mdiodev->dev,
1156 "%s: half duplex not supported\n",
1160 ret = xpcs_write(xpcs, MDIO_MMD_VEND2, MII_BMCR,
1161 mii_bmcr_encode_fixed(speed, duplex));
1163 dev_err(&xpcs->mdiodev->dev, "%s: xpcs_write returned %pe\n",
1164 __func__, ERR_PTR(ret));
1167 static void xpcs_link_up(struct phylink_pcs *pcs, unsigned int neg_mode,
1168 phy_interface_t interface, int speed, int duplex)
1170 struct dw_xpcs *xpcs = phylink_pcs_to_xpcs(pcs);
1172 switch (interface) {
1173 case PHY_INTERFACE_MODE_USXGMII:
1174 xpcs_link_up_usxgmii(xpcs, speed);
1177 case PHY_INTERFACE_MODE_SGMII:
1178 case PHY_INTERFACE_MODE_1000BASEX:
1179 xpcs_link_up_sgmii_1000basex(xpcs, neg_mode, interface, speed,
1188 static void xpcs_an_restart(struct phylink_pcs *pcs)
1190 struct dw_xpcs *xpcs = phylink_pcs_to_xpcs(pcs);
1192 xpcs_modify(xpcs, MDIO_MMD_VEND2, MII_BMCR, BMCR_ANRESTART,
1196 static int xpcs_read_ids(struct dw_xpcs *xpcs)
1201 /* First, search C73 PCS using PCS MMD 3. Return ENODEV if communication
1202 * failed indicating that device couldn't be reached.
1204 ret = xpcs_read(xpcs, MDIO_MMD_PCS, MII_PHYSID1);
1210 ret = xpcs_read(xpcs, MDIO_MMD_PCS, MII_PHYSID2);
1216 /* If Device IDs are not all zeros or ones, then 10GBase-X/R or C73
1217 * KR/KX4 PCS found. Otherwise fallback to detecting 1000Base-X or C37
1218 * PCS in MII MMD 31.
1220 if (!id || id == 0xffffffff) {
1221 ret = xpcs_read(xpcs, MDIO_MMD_VEND2, MII_PHYSID1);
1227 ret = xpcs_read(xpcs, MDIO_MMD_VEND2, MII_PHYSID2);
1234 /* Set the PCS ID if it hasn't been pre-initialized */
1235 if (xpcs->info.pcs == DW_XPCS_ID_NATIVE)
1236 xpcs->info.pcs = id;
1238 /* Find out PMA/PMD ID from MMD 1 device ID registers */
1239 ret = xpcs_read(xpcs, MDIO_MMD_PMAPMD, MDIO_DEVID1);
1245 ret = xpcs_read(xpcs, MDIO_MMD_PMAPMD, MDIO_DEVID2);
1249 /* Note the inverted dword order and masked out Model/Revision numbers
1250 * with respect to what is done with the PCS ID...
1252 ret = (ret >> 10) & 0x3F;
1255 /* Set the PMA ID if it hasn't been pre-initialized */
1256 if (xpcs->info.pma == DW_XPCS_PMA_ID_NATIVE)
1257 xpcs->info.pma = id;
1262 static const struct dw_xpcs_compat synopsys_xpcs_compat[] = {
1264 .interface = PHY_INTERFACE_MODE_USXGMII,
1265 .supported = xpcs_usxgmii_features,
1266 .an_mode = DW_AN_C73,
1268 .interface = PHY_INTERFACE_MODE_10GKR,
1269 .supported = xpcs_10gkr_features,
1270 .an_mode = DW_AN_C73,
1272 .interface = PHY_INTERFACE_MODE_XLGMII,
1273 .supported = xpcs_xlgmii_features,
1274 .an_mode = DW_AN_C73,
1276 .interface = PHY_INTERFACE_MODE_10GBASER,
1277 .supported = xpcs_10gbaser_features,
1278 .an_mode = DW_10GBASER,
1280 .interface = PHY_INTERFACE_MODE_SGMII,
1281 .supported = xpcs_sgmii_features,
1282 .an_mode = DW_AN_C37_SGMII,
1284 .interface = PHY_INTERFACE_MODE_1000BASEX,
1285 .supported = xpcs_1000basex_features,
1286 .an_mode = DW_AN_C37_1000BASEX,
1288 .interface = PHY_INTERFACE_MODE_2500BASEX,
1289 .supported = xpcs_2500basex_features,
1290 .an_mode = DW_2500BASEX,
1295 static const struct dw_xpcs_compat nxp_sja1105_xpcs_compat[] = {
1297 .interface = PHY_INTERFACE_MODE_SGMII,
1298 .supported = xpcs_sgmii_features,
1299 .an_mode = DW_AN_C37_SGMII,
1300 .pma_config = nxp_sja1105_sgmii_pma_config,
1305 static const struct dw_xpcs_compat nxp_sja1110_xpcs_compat[] = {
1307 .interface = PHY_INTERFACE_MODE_SGMII,
1308 .supported = xpcs_sgmii_features,
1309 .an_mode = DW_AN_C37_SGMII,
1310 .pma_config = nxp_sja1110_sgmii_pma_config,
1312 .interface = PHY_INTERFACE_MODE_2500BASEX,
1313 .supported = xpcs_2500basex_features,
1314 .an_mode = DW_2500BASEX,
1315 .pma_config = nxp_sja1110_2500basex_pma_config,
1320 static const struct dw_xpcs_desc xpcs_desc_list[] = {
1323 .mask = DW_XPCS_ID_MASK,
1324 .compat = synopsys_xpcs_compat,
1326 .id = NXP_SJA1105_XPCS_ID,
1327 .mask = DW_XPCS_ID_MASK,
1328 .compat = nxp_sja1105_xpcs_compat,
1330 .id = NXP_SJA1110_XPCS_ID,
1331 .mask = DW_XPCS_ID_MASK,
1332 .compat = nxp_sja1110_xpcs_compat,
1336 static const struct phylink_pcs_ops xpcs_phylink_ops = {
1337 .pcs_validate = xpcs_validate,
1338 .pcs_inband_caps = xpcs_inband_caps,
1339 .pcs_pre_config = xpcs_pre_config,
1340 .pcs_config = xpcs_config,
1341 .pcs_get_state = xpcs_get_state,
1342 .pcs_an_restart = xpcs_an_restart,
1343 .pcs_link_up = xpcs_link_up,
1346 static int xpcs_identify(struct dw_xpcs *xpcs)
1350 ret = xpcs_read_ids(xpcs);
1354 for (i = 0; i < ARRAY_SIZE(xpcs_desc_list); i++) {
1355 const struct dw_xpcs_desc *entry = &xpcs_desc_list[i];
1357 if ((xpcs->info.pcs & entry->mask) == entry->id) {
1366 static struct dw_xpcs *xpcs_create_data(struct mdio_device *mdiodev)
1368 struct dw_xpcs *xpcs;
1370 xpcs = kzalloc(sizeof(*xpcs), GFP_KERNEL);
1372 return ERR_PTR(-ENOMEM);
1374 mdio_device_get(mdiodev);
1375 xpcs->mdiodev = mdiodev;
1376 xpcs->pcs.ops = &xpcs_phylink_ops;
1377 xpcs->pcs.neg_mode = true;
1378 xpcs->pcs.poll = true;
1383 static void xpcs_free_data(struct dw_xpcs *xpcs)
1385 mdio_device_put(xpcs->mdiodev);
1389 static int xpcs_init_clks(struct dw_xpcs *xpcs)
1391 static const char *ids[DW_XPCS_NUM_CLKS] = {
1392 [DW_XPCS_CORE_CLK] = "core",
1393 [DW_XPCS_PAD_CLK] = "pad",
1395 struct device *dev = &xpcs->mdiodev->dev;
1398 for (i = 0; i < DW_XPCS_NUM_CLKS; ++i)
1399 xpcs->clks[i].id = ids[i];
1401 ret = clk_bulk_get_optional(dev, DW_XPCS_NUM_CLKS, xpcs->clks);
1403 return dev_err_probe(dev, ret, "Failed to get clocks\n");
1405 ret = clk_bulk_prepare_enable(DW_XPCS_NUM_CLKS, xpcs->clks);
1407 return dev_err_probe(dev, ret, "Failed to enable clocks\n");
1412 static void xpcs_clear_clks(struct dw_xpcs *xpcs)
1414 clk_bulk_disable_unprepare(DW_XPCS_NUM_CLKS, xpcs->clks);
1416 clk_bulk_put(DW_XPCS_NUM_CLKS, xpcs->clks);
1419 static int xpcs_init_id(struct dw_xpcs *xpcs)
1421 const struct dw_xpcs_info *info;
1423 info = dev_get_platdata(&xpcs->mdiodev->dev);
1425 xpcs->info.pcs = DW_XPCS_ID_NATIVE;
1426 xpcs->info.pma = DW_XPCS_PMA_ID_NATIVE;
1431 return xpcs_identify(xpcs);
1434 static struct dw_xpcs *xpcs_create(struct mdio_device *mdiodev)
1436 struct dw_xpcs *xpcs;
1439 xpcs = xpcs_create_data(mdiodev);
1443 ret = xpcs_init_clks(xpcs);
1447 ret = xpcs_init_id(xpcs);
1449 goto out_clear_clks;
1451 xpcs_get_interfaces(xpcs, xpcs->pcs.supported_interfaces);
1453 if (xpcs->info.pma == WX_TXGBE_XPCS_PMA_10G_ID)
1454 xpcs->pcs.poll = false;
1456 xpcs->need_reset = true;
1461 xpcs_clear_clks(xpcs);
1464 xpcs_free_data(xpcs);
1466 return ERR_PTR(ret);
1470 * xpcs_create_mdiodev() - create a DW xPCS instance with the MDIO @addr
1471 * @bus: pointer to the MDIO-bus descriptor for the device to be looked at
1472 * @addr: device MDIO-bus ID
1474 * Return: a pointer to the DW XPCS handle if successful, otherwise -ENODEV if
1475 * the PCS device couldn't be found on the bus and other negative errno related
1476 * to the data allocation and MDIO-bus communications.
1478 struct dw_xpcs *xpcs_create_mdiodev(struct mii_bus *bus, int addr)
1480 struct mdio_device *mdiodev;
1481 struct dw_xpcs *xpcs;
1483 mdiodev = mdio_device_create(bus, addr);
1484 if (IS_ERR(mdiodev))
1485 return ERR_CAST(mdiodev);
1487 xpcs = xpcs_create(mdiodev);
1489 /* xpcs_create() has taken a refcount on the mdiodev if it was
1490 * successful. If xpcs_create() fails, this will free the mdio
1491 * device here. In any case, we don't need to hold our reference
1492 * anymore, and putting it here will allow mdio_device_put() in
1493 * xpcs_destroy() to automatically free the mdio device.
1495 mdio_device_put(mdiodev);
1499 EXPORT_SYMBOL_GPL(xpcs_create_mdiodev);
1501 struct phylink_pcs *xpcs_create_pcs_mdiodev(struct mii_bus *bus, int addr)
1503 struct dw_xpcs *xpcs;
1505 xpcs = xpcs_create_mdiodev(bus, addr);
1507 return ERR_CAST(xpcs);
1511 EXPORT_SYMBOL_GPL(xpcs_create_pcs_mdiodev);
1514 * xpcs_create_fwnode() - Create a DW xPCS instance from @fwnode
1515 * @fwnode: fwnode handle poining to the DW XPCS device
1517 * Return: a pointer to the DW XPCS handle if successful, otherwise -ENODEV if
1518 * the fwnode device is unavailable or the PCS device couldn't be found on the
1519 * bus, -EPROBE_DEFER if the respective MDIO-device instance couldn't be found,
1520 * other negative errno related to the data allocations and MDIO-bus
1523 struct dw_xpcs *xpcs_create_fwnode(struct fwnode_handle *fwnode)
1525 struct mdio_device *mdiodev;
1526 struct dw_xpcs *xpcs;
1528 if (!fwnode_device_is_available(fwnode))
1529 return ERR_PTR(-ENODEV);
1531 mdiodev = fwnode_mdio_find_device(fwnode);
1533 return ERR_PTR(-EPROBE_DEFER);
1535 xpcs = xpcs_create(mdiodev);
1537 /* xpcs_create() has taken a refcount on the mdiodev if it was
1538 * successful. If xpcs_create() fails, this will free the mdio
1539 * device here. In any case, we don't need to hold our reference
1540 * anymore, and putting it here will allow mdio_device_put() in
1541 * xpcs_destroy() to automatically free the mdio device.
1543 mdio_device_put(mdiodev);
1547 EXPORT_SYMBOL_GPL(xpcs_create_fwnode);
1549 void xpcs_destroy(struct dw_xpcs *xpcs)
1554 xpcs_clear_clks(xpcs);
1556 xpcs_free_data(xpcs);
1558 EXPORT_SYMBOL_GPL(xpcs_destroy);
1560 void xpcs_destroy_pcs(struct phylink_pcs *pcs)
1562 xpcs_destroy(phylink_pcs_to_xpcs(pcs));
1564 EXPORT_SYMBOL_GPL(xpcs_destroy_pcs);
1566 MODULE_DESCRIPTION("Synopsys DesignWare XPCS library");
1567 MODULE_LICENSE("GPL v2");