1 // SPDX-License-Identifier: GPL-2.0+
3 * Marvell 10G 88x3310 PHY driver
5 * Based upon the ID registers, this PHY appears to be a mixture of IPs
6 * from two different companies.
8 * There appears to be several different data paths through the PHY which
9 * are automatically managed by the PHY. The following has been determined
10 * via observation and experimentation for a setup using single-lane Serdes:
12 * SGMII PHYXS -- BASE-T PCS -- 10G PMA -- AN -- Copper (for <= 1G)
13 * 10GBASE-KR PHYXS -- BASE-T PCS -- 10G PMA -- AN -- Copper (for 10G)
14 * 10GBASE-KR PHYXS -- BASE-R PCS -- Fiber
16 * With XAUI, observation shows:
18 * XAUI PHYXS -- <appropriate PCS as above>
20 * and no switching of the host interface mode occurs.
22 * If both the fiber and copper ports are connected, the first to gain
23 * link takes priority and the other port is completely locked out.
25 #include <linux/ctype.h>
26 #include <linux/hwmon.h>
27 #include <linux/marvell_phy.h>
28 #include <linux/phy.h>
29 #include <linux/sfp.h>
31 #define MV_PHY_ALASKA_NBT_QUIRK_MASK 0xfffffffe
32 #define MV_PHY_ALASKA_NBT_QUIRK_REV (MARVELL_PHY_ID_88X3310 | 0xa)
36 MV_PMA_BOOT_FATAL
= BIT(0),
38 MV_PCS_BASE_T
= 0x0000,
39 MV_PCS_BASE_R
= 0x1000,
40 MV_PCS_1000BASEX
= 0x2000,
42 MV_PCS_PAIRSWAP
= 0x8182,
43 MV_PCS_PAIRSWAP_MASK
= 0x0003,
44 MV_PCS_PAIRSWAP_AB
= 0x0002,
45 MV_PCS_PAIRSWAP_NONE
= 0x0003,
47 /* These registers appear at 0x800X and 0xa00X - the 0xa00X control
48 * registers appear to set themselves to the 0x800X when AN is
49 * restarted, but status registers appear readable from either.
51 MV_AN_CTRL1000
= 0x8000, /* 1000base-T control register */
52 MV_AN_STAT1000
= 0x8001, /* 1000base-T status register */
54 /* Vendor2 MMD registers */
55 MV_V2_PORT_CTRL
= 0xf001,
56 MV_V2_PORT_CTRL_PWRDOWN
= 0x0800,
57 MV_V2_TEMP_CTRL
= 0xf08a,
58 MV_V2_TEMP_CTRL_MASK
= 0xc000,
59 MV_V2_TEMP_CTRL_SAMPLE
= 0x0000,
60 MV_V2_TEMP_CTRL_DISABLE
= 0xc000,
62 MV_V2_TEMP_UNKNOWN
= 0x9600, /* unknown function */
66 struct device
*hwmon_dev
;
71 static umode_t
mv3310_hwmon_is_visible(const void *data
,
72 enum hwmon_sensor_types type
,
73 u32 attr
, int channel
)
75 if (type
== hwmon_chip
&& attr
== hwmon_chip_update_interval
)
77 if (type
== hwmon_temp
&& attr
== hwmon_temp_input
)
82 static int mv3310_hwmon_read(struct device
*dev
, enum hwmon_sensor_types type
,
83 u32 attr
, int channel
, long *value
)
85 struct phy_device
*phydev
= dev_get_drvdata(dev
);
88 if (type
== hwmon_chip
&& attr
== hwmon_chip_update_interval
) {
89 *value
= MSEC_PER_SEC
;
93 if (type
== hwmon_temp
&& attr
== hwmon_temp_input
) {
94 temp
= phy_read_mmd(phydev
, MDIO_MMD_VEND2
, MV_V2_TEMP
);
98 *value
= ((temp
& 0xff) - 75) * 1000;
106 static const struct hwmon_ops mv3310_hwmon_ops
= {
107 .is_visible
= mv3310_hwmon_is_visible
,
108 .read
= mv3310_hwmon_read
,
111 static u32 mv3310_hwmon_chip_config
[] = {
112 HWMON_C_REGISTER_TZ
| HWMON_C_UPDATE_INTERVAL
,
116 static const struct hwmon_channel_info mv3310_hwmon_chip
= {
118 .config
= mv3310_hwmon_chip_config
,
121 static u32 mv3310_hwmon_temp_config
[] = {
126 static const struct hwmon_channel_info mv3310_hwmon_temp
= {
128 .config
= mv3310_hwmon_temp_config
,
131 static const struct hwmon_channel_info
*mv3310_hwmon_info
[] = {
137 static const struct hwmon_chip_info mv3310_hwmon_chip_info
= {
138 .ops
= &mv3310_hwmon_ops
,
139 .info
= mv3310_hwmon_info
,
142 static int mv3310_hwmon_config(struct phy_device
*phydev
, bool enable
)
147 ret
= phy_write_mmd(phydev
, MDIO_MMD_VEND2
, MV_V2_TEMP
,
152 val
= enable
? MV_V2_TEMP_CTRL_SAMPLE
: MV_V2_TEMP_CTRL_DISABLE
;
154 return phy_modify_mmd(phydev
, MDIO_MMD_VEND2
, MV_V2_TEMP_CTRL
,
155 MV_V2_TEMP_CTRL_MASK
, val
);
158 static void mv3310_hwmon_disable(void *data
)
160 struct phy_device
*phydev
= data
;
162 mv3310_hwmon_config(phydev
, false);
165 static int mv3310_hwmon_probe(struct phy_device
*phydev
)
167 struct device
*dev
= &phydev
->mdio
.dev
;
168 struct mv3310_priv
*priv
= dev_get_drvdata(&phydev
->mdio
.dev
);
171 priv
->hwmon_name
= devm_kstrdup(dev
, dev_name(dev
), GFP_KERNEL
);
172 if (!priv
->hwmon_name
)
175 for (i
= j
= 0; priv
->hwmon_name
[i
]; i
++) {
176 if (isalnum(priv
->hwmon_name
[i
])) {
178 priv
->hwmon_name
[j
] = priv
->hwmon_name
[i
];
182 priv
->hwmon_name
[j
] = '\0';
184 ret
= mv3310_hwmon_config(phydev
, true);
188 ret
= devm_add_action_or_reset(dev
, mv3310_hwmon_disable
, phydev
);
192 priv
->hwmon_dev
= devm_hwmon_device_register_with_info(dev
,
193 priv
->hwmon_name
, phydev
,
194 &mv3310_hwmon_chip_info
, NULL
);
196 return PTR_ERR_OR_ZERO(priv
->hwmon_dev
);
199 static inline int mv3310_hwmon_config(struct phy_device
*phydev
, bool enable
)
204 static int mv3310_hwmon_probe(struct phy_device
*phydev
)
210 static int mv3310_sfp_insert(void *upstream
, const struct sfp_eeprom_id
*id
)
212 struct phy_device
*phydev
= upstream
;
213 __ETHTOOL_DECLARE_LINK_MODE_MASK(support
) = { 0, };
214 phy_interface_t iface
;
216 sfp_parse_support(phydev
->sfp_bus
, id
, support
);
217 iface
= sfp_select_interface(phydev
->sfp_bus
, support
);
219 if (iface
!= PHY_INTERFACE_MODE_10GBASER
) {
220 dev_err(&phydev
->mdio
.dev
, "incompatible SFP module inserted\n");
226 static const struct sfp_upstream_ops mv3310_sfp_ops
= {
227 .attach
= phy_sfp_attach
,
228 .detach
= phy_sfp_detach
,
229 .module_insert
= mv3310_sfp_insert
,
232 static int mv3310_probe(struct phy_device
*phydev
)
234 struct mv3310_priv
*priv
;
235 u32 mmd_mask
= MDIO_DEVS_PMAPMD
| MDIO_DEVS_AN
;
238 if (!phydev
->is_c45
||
239 (phydev
->c45_ids
.devices_in_package
& mmd_mask
) != mmd_mask
)
242 ret
= phy_read_mmd(phydev
, MDIO_MMD_PMAPMD
, MV_PMA_BOOT
);
246 if (ret
& MV_PMA_BOOT_FATAL
) {
247 dev_warn(&phydev
->mdio
.dev
,
248 "PHY failed to boot firmware, status=%04x\n", ret
);
252 priv
= devm_kzalloc(&phydev
->mdio
.dev
, sizeof(*priv
), GFP_KERNEL
);
256 dev_set_drvdata(&phydev
->mdio
.dev
, priv
);
258 ret
= mv3310_hwmon_probe(phydev
);
262 return phy_sfp_probe(phydev
, &mv3310_sfp_ops
);
265 static int mv3310_suspend(struct phy_device
*phydev
)
267 return phy_set_bits_mmd(phydev
, MDIO_MMD_VEND2
, MV_V2_PORT_CTRL
,
268 MV_V2_PORT_CTRL_PWRDOWN
);
271 static int mv3310_resume(struct phy_device
*phydev
)
275 ret
= phy_clear_bits_mmd(phydev
, MDIO_MMD_VEND2
, MV_V2_PORT_CTRL
,
276 MV_V2_PORT_CTRL_PWRDOWN
);
280 return mv3310_hwmon_config(phydev
, true);
283 /* Some PHYs in the Alaska family such as the 88X3310 and the 88E2010
284 * don't set bit 14 in PMA Extended Abilities (1.11), although they do
285 * support 2.5GBASET and 5GBASET. For these models, we can still read their
286 * 2.5G/5G extended abilities register (1.21). We detect these models based on
287 * the PMA device identifier, with a mask matching models known to have this
290 static bool mv3310_has_pma_ngbaset_quirk(struct phy_device
*phydev
)
292 if (!(phydev
->c45_ids
.devices_in_package
& MDIO_DEVS_PMAPMD
))
295 /* Only some revisions of the 88X3310 family PMA seem to be impacted */
296 return (phydev
->c45_ids
.device_ids
[MDIO_MMD_PMAPMD
] &
297 MV_PHY_ALASKA_NBT_QUIRK_MASK
) == MV_PHY_ALASKA_NBT_QUIRK_REV
;
300 static int mv3310_config_init(struct phy_device
*phydev
)
302 /* Check that the PHY interface type is compatible */
303 if (phydev
->interface
!= PHY_INTERFACE_MODE_SGMII
&&
304 phydev
->interface
!= PHY_INTERFACE_MODE_2500BASEX
&&
305 phydev
->interface
!= PHY_INTERFACE_MODE_XAUI
&&
306 phydev
->interface
!= PHY_INTERFACE_MODE_RXAUI
&&
307 phydev
->interface
!= PHY_INTERFACE_MODE_10GBASER
)
313 static int mv3310_get_features(struct phy_device
*phydev
)
317 ret
= genphy_c45_pma_read_abilities(phydev
);
321 if (mv3310_has_pma_ngbaset_quirk(phydev
)) {
322 val
= phy_read_mmd(phydev
, MDIO_MMD_PMAPMD
,
323 MDIO_PMA_NG_EXTABLE
);
327 linkmode_mod_bit(ETHTOOL_LINK_MODE_2500baseT_Full_BIT
,
329 val
& MDIO_PMA_NG_EXTABLE_2_5GBT
);
331 linkmode_mod_bit(ETHTOOL_LINK_MODE_5000baseT_Full_BIT
,
333 val
& MDIO_PMA_NG_EXTABLE_5GBT
);
339 static int mv3310_config_aneg(struct phy_device
*phydev
)
341 bool changed
= false;
345 /* We don't support manual MDI control */
346 phydev
->mdix_ctrl
= ETH_TP_MDI_AUTO
;
348 if (phydev
->autoneg
== AUTONEG_DISABLE
)
349 return genphy_c45_pma_setup_forced(phydev
);
351 ret
= genphy_c45_an_config_aneg(phydev
);
357 /* Clause 45 has no standardized support for 1000BaseT, therefore
358 * use vendor registers for this mode.
360 reg
= linkmode_adv_to_mii_ctrl1000_t(phydev
->advertising
);
361 ret
= phy_modify_mmd_changed(phydev
, MDIO_MMD_AN
, MV_AN_CTRL1000
,
362 ADVERTISE_1000FULL
| ADVERTISE_1000HALF
, reg
);
368 return genphy_c45_check_and_restart_aneg(phydev
, changed
);
371 static int mv3310_aneg_done(struct phy_device
*phydev
)
375 val
= phy_read_mmd(phydev
, MDIO_MMD_PCS
, MV_PCS_BASE_R
+ MDIO_STAT1
);
379 if (val
& MDIO_STAT1_LSTATUS
)
382 return genphy_c45_aneg_done(phydev
);
385 static void mv3310_update_interface(struct phy_device
*phydev
)
387 if ((phydev
->interface
== PHY_INTERFACE_MODE_SGMII
||
388 phydev
->interface
== PHY_INTERFACE_MODE_2500BASEX
||
389 phydev
->interface
== PHY_INTERFACE_MODE_10GBASER
) &&
391 /* The PHY automatically switches its serdes interface (and
392 * active PHYXS instance) between Cisco SGMII, 10GBase-R and
393 * 2500BaseX modes according to the speed. Florian suggests
394 * setting phydev->interface to communicate this to the MAC.
395 * Only do this if we are already in one of the above modes.
397 switch (phydev
->speed
) {
399 phydev
->interface
= PHY_INTERFACE_MODE_10GBASER
;
402 phydev
->interface
= PHY_INTERFACE_MODE_2500BASEX
;
407 phydev
->interface
= PHY_INTERFACE_MODE_SGMII
;
415 /* 10GBASE-ER,LR,LRM,SR do not support autonegotiation. */
416 static int mv3310_read_10gbr_status(struct phy_device
*phydev
)
419 phydev
->speed
= SPEED_10000
;
420 phydev
->duplex
= DUPLEX_FULL
;
422 mv3310_update_interface(phydev
);
427 static int mv3310_read_status(struct phy_device
*phydev
)
431 phydev
->speed
= SPEED_UNKNOWN
;
432 phydev
->duplex
= DUPLEX_UNKNOWN
;
433 linkmode_zero(phydev
->lp_advertising
);
436 phydev
->asym_pause
= 0;
439 val
= phy_read_mmd(phydev
, MDIO_MMD_PCS
, MV_PCS_BASE_R
+ MDIO_STAT1
);
443 if (val
& MDIO_STAT1_LSTATUS
)
444 return mv3310_read_10gbr_status(phydev
);
446 val
= genphy_c45_read_link(phydev
);
450 val
= phy_read_mmd(phydev
, MDIO_MMD_AN
, MDIO_STAT1
);
454 if (val
& MDIO_AN_STAT1_COMPLETE
) {
455 val
= genphy_c45_read_lpa(phydev
);
459 /* Read the link partner's 1G advertisement */
460 val
= phy_read_mmd(phydev
, MDIO_MMD_AN
, MV_AN_STAT1000
);
464 mii_stat1000_mod_linkmode_lpa_t(phydev
->lp_advertising
, val
);
466 if (phydev
->autoneg
== AUTONEG_ENABLE
)
467 phy_resolve_aneg_linkmode(phydev
);
470 if (phydev
->autoneg
!= AUTONEG_ENABLE
) {
471 val
= genphy_c45_read_pma(phydev
);
476 if (phydev
->speed
== SPEED_10000
) {
477 val
= genphy_c45_read_mdix(phydev
);
481 val
= phy_read_mmd(phydev
, MDIO_MMD_PCS
, MV_PCS_PAIRSWAP
);
485 switch (val
& MV_PCS_PAIRSWAP_MASK
) {
486 case MV_PCS_PAIRSWAP_AB
:
487 phydev
->mdix
= ETH_TP_MDI_X
;
489 case MV_PCS_PAIRSWAP_NONE
:
490 phydev
->mdix
= ETH_TP_MDI
;
493 phydev
->mdix
= ETH_TP_MDI_INVALID
;
498 mv3310_update_interface(phydev
);
503 static struct phy_driver mv3310_drivers
[] = {
505 .phy_id
= MARVELL_PHY_ID_88X3310
,
506 .phy_id_mask
= MARVELL_PHY_ID_MASK
,
508 .get_features
= mv3310_get_features
,
509 .soft_reset
= genphy_no_soft_reset
,
510 .config_init
= mv3310_config_init
,
511 .probe
= mv3310_probe
,
512 .suspend
= mv3310_suspend
,
513 .resume
= mv3310_resume
,
514 .config_aneg
= mv3310_config_aneg
,
515 .aneg_done
= mv3310_aneg_done
,
516 .read_status
= mv3310_read_status
,
519 .phy_id
= MARVELL_PHY_ID_88E2110
,
520 .phy_id_mask
= MARVELL_PHY_ID_MASK
,
522 .probe
= mv3310_probe
,
523 .suspend
= mv3310_suspend
,
524 .resume
= mv3310_resume
,
525 .soft_reset
= genphy_no_soft_reset
,
526 .config_init
= mv3310_config_init
,
527 .config_aneg
= mv3310_config_aneg
,
528 .aneg_done
= mv3310_aneg_done
,
529 .read_status
= mv3310_read_status
,
533 module_phy_driver(mv3310_drivers
);
535 static struct mdio_device_id __maybe_unused mv3310_tbl
[] = {
536 { MARVELL_PHY_ID_88X3310
, MARVELL_PHY_ID_MASK
},
537 { MARVELL_PHY_ID_88E2110
, MARVELL_PHY_ID_MASK
},
540 MODULE_DEVICE_TABLE(mdio
, mv3310_tbl
);
541 MODULE_DESCRIPTION("Marvell Alaska X 10Gigabit Ethernet PHY driver (MV88X3310)");
542 MODULE_LICENSE("GPL");