1 /****************************************************************************
2  * Driver for Solarflare network controllers and boards
3  * Copyright 2006-2011 Solarflare Communications Inc.
4  *
5  * This program is free software; you can redistribute it and/or modify it
6  * under the terms of the GNU General Public License version 2 as published
7  * by the Free Software Foundation, incorporated herein by reference.
8  */
9 
10 #ifndef EF4_MDIO_10G_H
11 #define EF4_MDIO_10G_H
12 
13 #include <linux/mdio.h>
14 
15 /*
16  * Helper functions for doing 10G MDIO as specified in IEEE 802.3 clause 45.
17  */
18 
19 #include "efx.h"
20 
21 static inline unsigned ef4_mdio_id_rev(u32 id) { return id & 0xf; }
22 static inline unsigned ef4_mdio_id_model(u32 id) { return (id >> 4) & 0x3f; }
23 unsigned ef4_mdio_id_oui(u32 id);
24 
25 static inline int ef4_mdio_read(struct ef4_nic *efx, int devad, int addr)
26 {
27 	return efx->mdio.mdio_read(efx->net_dev, efx->mdio.prtad, devad, addr);
28 }
29 
30 static inline void
31 ef4_mdio_write(struct ef4_nic *efx, int devad, int addr, int value)
32 {
33 	efx->mdio.mdio_write(efx->net_dev, efx->mdio.prtad, devad, addr, value);
34 }
35 
36 static inline u32 ef4_mdio_read_id(struct ef4_nic *efx, int mmd)
37 {
38 	u16 id_low = ef4_mdio_read(efx, mmd, MDIO_DEVID2);
39 	u16 id_hi = ef4_mdio_read(efx, mmd, MDIO_DEVID1);
40 	return (id_hi << 16) | (id_low);
41 }
42 
43 static inline bool ef4_mdio_phyxgxs_lane_sync(struct ef4_nic *efx)
44 {
45 	int i, lane_status;
46 	bool sync;
47 
48 	for (i = 0; i < 2; ++i)
49 		lane_status = ef4_mdio_read(efx, MDIO_MMD_PHYXS,
50 					    MDIO_PHYXS_LNSTAT);
51 
52 	sync = !!(lane_status & MDIO_PHYXS_LNSTAT_ALIGN);
53 	if (!sync)
54 		netif_dbg(efx, hw, efx->net_dev, "XGXS lane status: %x\n",
55 			  lane_status);
56 	return sync;
57 }
58 
59 const char *ef4_mdio_mmd_name(int mmd);
60 
61 /*
62  * Reset a specific MMD and wait for reset to clear.
63  * Return number of spins left (>0) on success, -%ETIMEDOUT on failure.
64  *
65  * This function will sleep
66  */
67 int ef4_mdio_reset_mmd(struct ef4_nic *efx, int mmd, int spins, int spintime);
68 
69 /* As ef4_mdio_check_mmd but for multiple MMDs */
70 int ef4_mdio_check_mmds(struct ef4_nic *efx, unsigned int mmd_mask);
71 
72 /* Check the link status of specified mmds in bit mask */
73 bool ef4_mdio_links_ok(struct ef4_nic *efx, unsigned int mmd_mask);
74 
75 /* Generic transmit disable support though PMAPMD */
76 void ef4_mdio_transmit_disable(struct ef4_nic *efx);
77 
78 /* Generic part of reconfigure: set/clear loopback bits */
79 void ef4_mdio_phy_reconfigure(struct ef4_nic *efx);
80 
81 /* Set the power state of the specified MMDs */
82 void ef4_mdio_set_mmds_lpower(struct ef4_nic *efx, int low_power,
83 			      unsigned int mmd_mask);
84 
85 /* Set (some of) the PHY settings over MDIO */
86 int ef4_mdio_set_link_ksettings(struct ef4_nic *efx,
87 				const struct ethtool_link_ksettings *cmd);
88 
89 /* Push advertising flags and restart autonegotiation */
90 void ef4_mdio_an_reconfigure(struct ef4_nic *efx);
91 
92 /* Get pause parameters from AN if available (otherwise return
93  * requested pause parameters)
94  */
95 u8 ef4_mdio_get_pause(struct ef4_nic *efx);
96 
97 /* Wait for specified MMDs to exit reset within a timeout */
98 int ef4_mdio_wait_reset_mmds(struct ef4_nic *efx, unsigned int mmd_mask);
99 
100 /* Set or clear flag, debouncing */
101 static inline void
102 ef4_mdio_set_flag(struct ef4_nic *efx, int devad, int addr,
103 		  int mask, bool state)
104 {
105 	mdio_set_flag(&efx->mdio, efx->mdio.prtad, devad, addr, mask, state);
106 }
107 
108 /* Liveness self-test for MDIO PHYs */
109 int ef4_mdio_test_alive(struct ef4_nic *efx);
110 
111 #endif /* EF4_MDIO_10G_H */
112