1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /****************************************************************************
3 * Driver for Solarflare network controllers and boards
4 * Copyright 2007-2013 Solarflare Communications Inc.
5 */
6
7 #ifndef EFX_ENUM_H
8 #define EFX_ENUM_H
9
10 /**
11 * enum efx_loopback_mode - loopback modes
12 * @LOOPBACK_NONE: no loopback
13 * @LOOPBACK_DATA: data path loopback
14 * @LOOPBACK_GMAC: loopback within GMAC
15 * @LOOPBACK_XGMII: loopback after XMAC
16 * @LOOPBACK_XGXS: loopback within BPX after XGXS
17 * @LOOPBACK_XAUI: loopback within BPX before XAUI serdes
18 * @LOOPBACK_GMII: loopback within BPX after GMAC
19 * @LOOPBACK_SGMII: loopback within BPX within SGMII
20 * @LOOPBACK_XGBR: loopback within BPX within XGBR
21 * @LOOPBACK_XFI: loopback within BPX before XFI serdes
22 * @LOOPBACK_XAUI_FAR: loopback within BPX after XAUI serdes
23 * @LOOPBACK_GMII_FAR: loopback within BPX before SGMII
24 * @LOOPBACK_SGMII_FAR: loopback within BPX after SGMII
25 * @LOOPBACK_XFI_FAR: loopback after XFI serdes
26 * @LOOPBACK_GPHY: loopback within 1G PHY at unspecified level
27 * @LOOPBACK_PHYXS: loopback within 10G PHY at PHYXS level
28 * @LOOPBACK_PCS: loopback within 10G PHY at PCS level
29 * @LOOPBACK_PMAPMD: loopback within 10G PHY at PMAPMD level
30 * @LOOPBACK_XPORT: cross port loopback
31 * @LOOPBACK_XGMII_WS: wireside loopback excluding XMAC
32 * @LOOPBACK_XAUI_WS: wireside loopback within BPX within XAUI serdes
33 * @LOOPBACK_XAUI_WS_FAR: wireside loopback within BPX including XAUI serdes
34 * @LOOPBACK_XAUI_WS_NEAR: wireside loopback within BPX excluding XAUI serdes
35 * @LOOPBACK_GMII_WS: wireside loopback excluding GMAC
36 * @LOOPBACK_XFI_WS: wireside loopback excluding XFI serdes
37 * @LOOPBACK_XFI_WS_FAR: wireside loopback including XFI serdes
38 * @LOOPBACK_PHYXS_WS: wireside loopback within 10G PHY at PHYXS level
39 */
40 /* Please keep up-to-date w.r.t the following two #defines */
41 enum efx_loopback_mode {
42 LOOPBACK_NONE = 0,
43 LOOPBACK_DATA = 1,
44 LOOPBACK_GMAC = 2,
45 LOOPBACK_XGMII = 3,
46 LOOPBACK_XGXS = 4,
47 LOOPBACK_XAUI = 5,
48 LOOPBACK_GMII = 6,
49 LOOPBACK_SGMII = 7,
50 LOOPBACK_XGBR = 8,
51 LOOPBACK_XFI = 9,
52 LOOPBACK_XAUI_FAR = 10,
53 LOOPBACK_GMII_FAR = 11,
54 LOOPBACK_SGMII_FAR = 12,
55 LOOPBACK_XFI_FAR = 13,
56 LOOPBACK_GPHY = 14,
57 LOOPBACK_PHYXS = 15,
58 LOOPBACK_PCS = 16,
59 LOOPBACK_PMAPMD = 17,
60 LOOPBACK_XPORT = 18,
61 LOOPBACK_XGMII_WS = 19,
62 LOOPBACK_XAUI_WS = 20,
63 LOOPBACK_XAUI_WS_FAR = 21,
64 LOOPBACK_XAUI_WS_NEAR = 22,
65 LOOPBACK_GMII_WS = 23,
66 LOOPBACK_XFI_WS = 24,
67 LOOPBACK_XFI_WS_FAR = 25,
68 LOOPBACK_PHYXS_WS = 26,
69 LOOPBACK_MAX
70 };
71 #define LOOPBACK_TEST_MAX LOOPBACK_PMAPMD
72
73 /* These loopbacks occur within the controller */
74 #define LOOPBACKS_INTERNAL ((1 << LOOPBACK_DATA) | \
75 (1 << LOOPBACK_GMAC) | \
76 (1 << LOOPBACK_XGMII)| \
77 (1 << LOOPBACK_XGXS) | \
78 (1 << LOOPBACK_XAUI) | \
79 (1 << LOOPBACK_GMII) | \
80 (1 << LOOPBACK_SGMII) | \
81 (1 << LOOPBACK_SGMII) | \
82 (1 << LOOPBACK_XGBR) | \
83 (1 << LOOPBACK_XFI) | \
84 (1 << LOOPBACK_XAUI_FAR) | \
85 (1 << LOOPBACK_GMII_FAR) | \
86 (1 << LOOPBACK_SGMII_FAR) | \
87 (1 << LOOPBACK_XFI_FAR) | \
88 (1 << LOOPBACK_XGMII_WS) | \
89 (1 << LOOPBACK_XAUI_WS) | \
90 (1 << LOOPBACK_XAUI_WS_FAR) | \
91 (1 << LOOPBACK_XAUI_WS_NEAR) | \
92 (1 << LOOPBACK_GMII_WS) | \
93 (1 << LOOPBACK_XFI_WS) | \
94 (1 << LOOPBACK_XFI_WS_FAR))
95
96 #define LOOPBACKS_WS ((1 << LOOPBACK_XGMII_WS) | \
97 (1 << LOOPBACK_XAUI_WS) | \
98 (1 << LOOPBACK_XAUI_WS_FAR) | \
99 (1 << LOOPBACK_XAUI_WS_NEAR) | \
100 (1 << LOOPBACK_GMII_WS) | \
101 (1 << LOOPBACK_XFI_WS) | \
102 (1 << LOOPBACK_XFI_WS_FAR) | \
103 (1 << LOOPBACK_PHYXS_WS))
104
105 #define LOOPBACKS_EXTERNAL(_efx) \
106 ((_efx)->loopback_modes & ~LOOPBACKS_INTERNAL & \
107 ~(1 << LOOPBACK_NONE))
108
109 #define LOOPBACK_MASK(_efx) \
110 (1 << (_efx)->loopback_mode)
111
112 #define LOOPBACK_INTERNAL(_efx) \
113 (!!(LOOPBACKS_INTERNAL & LOOPBACK_MASK(_efx)))
114
115 #define LOOPBACK_EXTERNAL(_efx) \
116 (!!(LOOPBACK_MASK(_efx) & LOOPBACKS_EXTERNAL(_efx)))
117
118 #define LOOPBACK_CHANGED(_from, _to, _mask) \
119 (!!((LOOPBACK_MASK(_from) ^ LOOPBACK_MASK(_to)) & (_mask)))
120
121 #define LOOPBACK_OUT_OF(_from, _to, _mask) \
122 ((LOOPBACK_MASK(_from) & (_mask)) && !(LOOPBACK_MASK(_to) & (_mask)))
123
124 /*****************************************************************************/
125
126 /**
127 * enum reset_type - reset types
128 *
129 * %RESET_TYPE_INVSIBLE, %RESET_TYPE_ALL, %RESET_TYPE_WORLD and
130 * %RESET_TYPE_DISABLE specify the method/scope of the reset. The
131 * other valuesspecify reasons, which efx_schedule_reset() will choose
132 * a method for.
133 *
134 * Reset methods are numbered in order of increasing scope.
135 *
136 * @RESET_TYPE_INVISIBLE: Reset datapath and MAC (Falcon only)
137 * @RESET_TYPE_RECOVER_OR_ALL: Try to recover. Apply RESET_TYPE_ALL
138 * if unsuccessful.
139 * @RESET_TYPE_ALL: Reset datapath, MAC and PHY
140 * @RESET_TYPE_WORLD: Reset as much as possible
141 * @RESET_TYPE_RECOVER_OR_DISABLE: Try to recover. Apply RESET_TYPE_DISABLE if
142 * unsuccessful.
143 * @RESET_TYPE_DATAPATH: Reset datapath only.
144 * @RESET_TYPE_MC_BIST: MC entering BIST mode.
145 * @RESET_TYPE_DISABLE: Reset datapath, MAC and PHY; leave NIC disabled
146 * @RESET_TYPE_TX_WATCHDOG: reset due to TX watchdog
147 * @RESET_TYPE_INT_ERROR: reset due to internal error
148 * @RESET_TYPE_DMA_ERROR: DMA error
149 * @RESET_TYPE_TX_SKIP: hardware completed empty tx descriptors
150 * @RESET_TYPE_MC_FAILURE: MC reboot/assertion
151 * @RESET_TYPE_MCDI_TIMEOUT: MCDI timeout.
152 */
153 enum reset_type {
154 RESET_TYPE_INVISIBLE,
155 RESET_TYPE_RECOVER_OR_ALL,
156 RESET_TYPE_ALL,
157 RESET_TYPE_WORLD,
158 RESET_TYPE_RECOVER_OR_DISABLE,
159 RESET_TYPE_DATAPATH,
160 RESET_TYPE_MC_BIST,
161 RESET_TYPE_DISABLE,
162 RESET_TYPE_MAX_METHOD,
163 RESET_TYPE_TX_WATCHDOG,
164 RESET_TYPE_INT_ERROR,
165 RESET_TYPE_DMA_ERROR,
166 RESET_TYPE_TX_SKIP,
167 RESET_TYPE_MC_FAILURE,
168 /* RESET_TYPE_MCDI_TIMEOUT is actually a method, not just a reason, but
169 * it doesn't fit the scope hierarchy (not well-ordered by inclusion).
170 * We encode this by having its enum value be greater than
171 * RESET_TYPE_MAX_METHOD.
172 */
173 RESET_TYPE_MCDI_TIMEOUT,
174 RESET_TYPE_MAX,
175 };
176
177 #endif /* EFX_ENUM_H */