xref: /openbmc/linux/include/linux/sfp.h (revision e847c767)
1 #ifndef LINUX_SFP_H
2 #define LINUX_SFP_H
3 
4 #include <linux/phy.h>
5 
6 struct sfp_eeprom_base {
7 	u8 phys_id;
8 	u8 phys_ext_id;
9 	u8 connector;
10 #if defined __BIG_ENDIAN_BITFIELD
11 	u8 e10g_base_er:1;
12 	u8 e10g_base_lrm:1;
13 	u8 e10g_base_lr:1;
14 	u8 e10g_base_sr:1;
15 	u8 if_1x_sx:1;
16 	u8 if_1x_lx:1;
17 	u8 if_1x_copper_active:1;
18 	u8 if_1x_copper_passive:1;
19 
20 	u8 escon_mmf_1310_led:1;
21 	u8 escon_smf_1310_laser:1;
22 	u8 sonet_oc192_short_reach:1;
23 	u8 sonet_reach_bit1:1;
24 	u8 sonet_reach_bit2:1;
25 	u8 sonet_oc48_long_reach:1;
26 	u8 sonet_oc48_intermediate_reach:1;
27 	u8 sonet_oc48_short_reach:1;
28 
29 	u8 unallocated_5_7:1;
30 	u8 sonet_oc12_smf_long_reach:1;
31 	u8 sonet_oc12_smf_intermediate_reach:1;
32 	u8 sonet_oc12_short_reach:1;
33 	u8 unallocated_5_3:1;
34 	u8 sonet_oc3_smf_long_reach:1;
35 	u8 sonet_oc3_smf_intermediate_reach:1;
36 	u8 sonet_oc3_short_reach:1;
37 
38 	u8 e_base_px:1;
39 	u8 e_base_bx10:1;
40 	u8 e100_base_fx:1;
41 	u8 e100_base_lx:1;
42 	u8 e1000_base_t:1;
43 	u8 e1000_base_cx:1;
44 	u8 e1000_base_lx:1;
45 	u8 e1000_base_sx:1;
46 
47 	u8 fc_ll_v:1;
48 	u8 fc_ll_s:1;
49 	u8 fc_ll_i:1;
50 	u8 fc_ll_l:1;
51 	u8 fc_ll_m:1;
52 	u8 fc_tech_sa:1;
53 	u8 fc_tech_lc:1;
54 	u8 fc_tech_electrical_inter_enclosure:1;
55 
56 	u8 fc_tech_electrical_intra_enclosure:1;
57 	u8 fc_tech_sn:1;
58 	u8 fc_tech_sl:1;
59 	u8 fc_tech_ll:1;
60 	u8 sfp_ct_active:1;
61 	u8 sfp_ct_passive:1;
62 	u8 unallocated_8_1:1;
63 	u8 unallocated_8_0:1;
64 
65 	u8 fc_media_tw:1;
66 	u8 fc_media_tp:1;
67 	u8 fc_media_mi:1;
68 	u8 fc_media_tv:1;
69 	u8 fc_media_m6:1;
70 	u8 fc_media_m5:1;
71 	u8 unallocated_9_1:1;
72 	u8 fc_media_sm:1;
73 
74 	u8 fc_speed_1200:1;
75 	u8 fc_speed_800:1;
76 	u8 fc_speed_1600:1;
77 	u8 fc_speed_400:1;
78 	u8 fc_speed_3200:1;
79 	u8 fc_speed_200:1;
80 	u8 unallocated_10_1:1;
81 	u8 fc_speed_100:1;
82 #elif defined __LITTLE_ENDIAN_BITFIELD
83 	u8 if_1x_copper_passive:1;
84 	u8 if_1x_copper_active:1;
85 	u8 if_1x_lx:1;
86 	u8 if_1x_sx:1;
87 	u8 e10g_base_sr:1;
88 	u8 e10g_base_lr:1;
89 	u8 e10g_base_lrm:1;
90 	u8 e10g_base_er:1;
91 
92 	u8 sonet_oc3_short_reach:1;
93 	u8 sonet_oc3_smf_intermediate_reach:1;
94 	u8 sonet_oc3_smf_long_reach:1;
95 	u8 unallocated_5_3:1;
96 	u8 sonet_oc12_short_reach:1;
97 	u8 sonet_oc12_smf_intermediate_reach:1;
98 	u8 sonet_oc12_smf_long_reach:1;
99 	u8 unallocated_5_7:1;
100 
101 	u8 sonet_oc48_short_reach:1;
102 	u8 sonet_oc48_intermediate_reach:1;
103 	u8 sonet_oc48_long_reach:1;
104 	u8 sonet_reach_bit2:1;
105 	u8 sonet_reach_bit1:1;
106 	u8 sonet_oc192_short_reach:1;
107 	u8 escon_smf_1310_laser:1;
108 	u8 escon_mmf_1310_led:1;
109 
110 	u8 e1000_base_sx:1;
111 	u8 e1000_base_lx:1;
112 	u8 e1000_base_cx:1;
113 	u8 e1000_base_t:1;
114 	u8 e100_base_lx:1;
115 	u8 e100_base_fx:1;
116 	u8 e_base_bx10:1;
117 	u8 e_base_px:1;
118 
119 	u8 fc_tech_electrical_inter_enclosure:1;
120 	u8 fc_tech_lc:1;
121 	u8 fc_tech_sa:1;
122 	u8 fc_ll_m:1;
123 	u8 fc_ll_l:1;
124 	u8 fc_ll_i:1;
125 	u8 fc_ll_s:1;
126 	u8 fc_ll_v:1;
127 
128 	u8 unallocated_8_0:1;
129 	u8 unallocated_8_1:1;
130 	u8 sfp_ct_passive:1;
131 	u8 sfp_ct_active:1;
132 	u8 fc_tech_ll:1;
133 	u8 fc_tech_sl:1;
134 	u8 fc_tech_sn:1;
135 	u8 fc_tech_electrical_intra_enclosure:1;
136 
137 	u8 fc_media_sm:1;
138 	u8 unallocated_9_1:1;
139 	u8 fc_media_m5:1;
140 	u8 fc_media_m6:1;
141 	u8 fc_media_tv:1;
142 	u8 fc_media_mi:1;
143 	u8 fc_media_tp:1;
144 	u8 fc_media_tw:1;
145 
146 	u8 fc_speed_100:1;
147 	u8 unallocated_10_1:1;
148 	u8 fc_speed_200:1;
149 	u8 fc_speed_3200:1;
150 	u8 fc_speed_400:1;
151 	u8 fc_speed_1600:1;
152 	u8 fc_speed_800:1;
153 	u8 fc_speed_1200:1;
154 #else
155 #error Unknown Endian
156 #endif
157 	u8 encoding;
158 	u8 br_nominal;
159 	u8 rate_id;
160 	u8 link_len[6];
161 	char vendor_name[16];
162 	u8 extended_cc;
163 	char vendor_oui[3];
164 	char vendor_pn[16];
165 	char vendor_rev[4];
166 	union {
167 		__be16 optical_wavelength;
168 		__be16 cable_compliance;
169 		struct {
170 #if defined __BIG_ENDIAN_BITFIELD
171 			u8 reserved60_2:6;
172 			u8 fc_pi_4_app_h:1;
173 			u8 sff8431_app_e:1;
174 			u8 reserved61:8;
175 #elif defined __LITTLE_ENDIAN_BITFIELD
176 			u8 sff8431_app_e:1;
177 			u8 fc_pi_4_app_h:1;
178 			u8 reserved60_2:6;
179 			u8 reserved61:8;
180 #else
181 #error Unknown Endian
182 #endif
183 		} __packed passive;
184 		struct {
185 #if defined __BIG_ENDIAN_BITFIELD
186 			u8 reserved60_4:4;
187 			u8 fc_pi_4_lim:1;
188 			u8 sff8431_lim:1;
189 			u8 fc_pi_4_app_h:1;
190 			u8 sff8431_app_e:1;
191 			u8 reserved61:8;
192 #elif defined __LITTLE_ENDIAN_BITFIELD
193 			u8 sff8431_app_e:1;
194 			u8 fc_pi_4_app_h:1;
195 			u8 sff8431_lim:1;
196 			u8 fc_pi_4_lim:1;
197 			u8 reserved60_4:4;
198 			u8 reserved61:8;
199 #else
200 #error Unknown Endian
201 #endif
202 		} __packed active;
203 	} __packed;
204 	u8 reserved62;
205 	u8 cc_base;
206 } __packed;
207 
208 struct sfp_eeprom_ext {
209 	__be16 options;
210 	u8 br_max;
211 	u8 br_min;
212 	char vendor_sn[16];
213 	char datecode[8];
214 	u8 diagmon;
215 	u8 enhopts;
216 	u8 sff8472_compliance;
217 	u8 cc_ext;
218 } __packed;
219 
220 /**
221  * struct sfp_eeprom_id - raw SFP module identification information
222  * @base: base SFP module identification structure
223  * @ext: extended SFP module identification structure
224  *
225  * See the SFF-8472 specification and related documents for the definition
226  * of these structure members. This can be obtained from
227  * https://www.snia.org/technology-communities/sff/specifications
228  */
229 struct sfp_eeprom_id {
230 	struct sfp_eeprom_base base;
231 	struct sfp_eeprom_ext ext;
232 } __packed;
233 
234 struct sfp_diag {
235 	__be16 temp_high_alarm;
236 	__be16 temp_low_alarm;
237 	__be16 temp_high_warn;
238 	__be16 temp_low_warn;
239 	__be16 volt_high_alarm;
240 	__be16 volt_low_alarm;
241 	__be16 volt_high_warn;
242 	__be16 volt_low_warn;
243 	__be16 bias_high_alarm;
244 	__be16 bias_low_alarm;
245 	__be16 bias_high_warn;
246 	__be16 bias_low_warn;
247 	__be16 txpwr_high_alarm;
248 	__be16 txpwr_low_alarm;
249 	__be16 txpwr_high_warn;
250 	__be16 txpwr_low_warn;
251 	__be16 rxpwr_high_alarm;
252 	__be16 rxpwr_low_alarm;
253 	__be16 rxpwr_high_warn;
254 	__be16 rxpwr_low_warn;
255 	__be16 laser_temp_high_alarm;
256 	__be16 laser_temp_low_alarm;
257 	__be16 laser_temp_high_warn;
258 	__be16 laser_temp_low_warn;
259 	__be16 tec_cur_high_alarm;
260 	__be16 tec_cur_low_alarm;
261 	__be16 tec_cur_high_warn;
262 	__be16 tec_cur_low_warn;
263 	__be32 cal_rxpwr4;
264 	__be32 cal_rxpwr3;
265 	__be32 cal_rxpwr2;
266 	__be32 cal_rxpwr1;
267 	__be32 cal_rxpwr0;
268 	__be16 cal_txi_slope;
269 	__be16 cal_txi_offset;
270 	__be16 cal_txpwr_slope;
271 	__be16 cal_txpwr_offset;
272 	__be16 cal_t_slope;
273 	__be16 cal_t_offset;
274 	__be16 cal_v_slope;
275 	__be16 cal_v_offset;
276 } __packed;
277 
278 /* SFF8024 defined constants */
279 enum {
280 	SFF8024_ID_UNK			= 0x00,
281 	SFF8024_ID_SFF_8472		= 0x02,
282 	SFF8024_ID_SFP			= 0x03,
283 	SFF8024_ID_DWDM_SFP		= 0x0b,
284 	SFF8024_ID_QSFP_8438		= 0x0c,
285 	SFF8024_ID_QSFP_8436_8636	= 0x0d,
286 	SFF8024_ID_QSFP28_8636		= 0x11,
287 
288 	SFF8024_ENCODING_UNSPEC		= 0x00,
289 	SFF8024_ENCODING_8B10B		= 0x01,
290 	SFF8024_ENCODING_4B5B		= 0x02,
291 	SFF8024_ENCODING_NRZ		= 0x03,
292 	SFF8024_ENCODING_8472_MANCHESTER= 0x04,
293 	SFF8024_ENCODING_8472_SONET	= 0x05,
294 	SFF8024_ENCODING_8472_64B66B	= 0x06,
295 	SFF8024_ENCODING_8436_MANCHESTER= 0x06,
296 	SFF8024_ENCODING_8436_SONET	= 0x04,
297 	SFF8024_ENCODING_8436_64B66B	= 0x05,
298 	SFF8024_ENCODING_256B257B	= 0x07,
299 	SFF8024_ENCODING_PAM4		= 0x08,
300 
301 	SFF8024_CONNECTOR_UNSPEC	= 0x00,
302 	/* codes 01-05 not supportable on SFP, but some modules have single SC */
303 	SFF8024_CONNECTOR_SC		= 0x01,
304 	SFF8024_CONNECTOR_FIBERJACK	= 0x06,
305 	SFF8024_CONNECTOR_LC		= 0x07,
306 	SFF8024_CONNECTOR_MT_RJ		= 0x08,
307 	SFF8024_CONNECTOR_MU		= 0x09,
308 	SFF8024_CONNECTOR_SG		= 0x0a,
309 	SFF8024_CONNECTOR_OPTICAL_PIGTAIL= 0x0b,
310 	SFF8024_CONNECTOR_MPO_1X12	= 0x0c,
311 	SFF8024_CONNECTOR_MPO_2X16	= 0x0d,
312 	SFF8024_CONNECTOR_HSSDC_II	= 0x20,
313 	SFF8024_CONNECTOR_COPPER_PIGTAIL= 0x21,
314 	SFF8024_CONNECTOR_RJ45		= 0x22,
315 	SFF8024_CONNECTOR_NOSEPARATE	= 0x23,
316 	SFF8024_CONNECTOR_MXC_2X16	= 0x24,
317 
318 	SFF8024_ECC_UNSPEC		= 0x00,
319 	SFF8024_ECC_100G_25GAUI_C2M_AOC	= 0x01,
320 	SFF8024_ECC_100GBASE_SR4_25GBASE_SR = 0x02,
321 	SFF8024_ECC_100GBASE_LR4_25GBASE_LR = 0x03,
322 	SFF8024_ECC_100GBASE_ER4_25GBASE_ER = 0x04,
323 	SFF8024_ECC_100GBASE_SR10	= 0x05,
324 	SFF8024_ECC_100GBASE_CR4	= 0x0b,
325 	SFF8024_ECC_25GBASE_CR_S	= 0x0c,
326 	SFF8024_ECC_25GBASE_CR_N	= 0x0d,
327 	SFF8024_ECC_10GBASE_T_SFI	= 0x16,
328 	SFF8024_ECC_10GBASE_T_SR	= 0x1c,
329 	SFF8024_ECC_5GBASE_T		= 0x1d,
330 	SFF8024_ECC_2_5GBASE_T		= 0x1e,
331 };
332 
333 /* SFP EEPROM registers */
334 enum {
335 	SFP_PHYS_ID			= 0,
336 
337 	SFP_PHYS_EXT_ID			= 1,
338 	SFP_PHYS_EXT_ID_SFP		= 0x04,
339 
340 	SFP_CONNECTOR			= 2,
341 	SFP_COMPLIANCE			= 3,
342 	SFP_ENCODING			= 11,
343 	SFP_BR_NOMINAL			= 12,
344 	SFP_RATE_ID			= 13,
345 	SFP_LINK_LEN_SM_KM		= 14,
346 	SFP_LINK_LEN_SM_100M		= 15,
347 	SFP_LINK_LEN_50UM_OM2_10M	= 16,
348 	SFP_LINK_LEN_62_5UM_OM1_10M	= 17,
349 	SFP_LINK_LEN_COPPER_1M		= 18,
350 	SFP_LINK_LEN_50UM_OM4_10M	= 18,
351 	SFP_LINK_LEN_50UM_OM3_10M	= 19,
352 	SFP_VENDOR_NAME			= 20,
353 	SFP_VENDOR_OUI			= 37,
354 	SFP_VENDOR_PN			= 40,
355 	SFP_VENDOR_REV			= 56,
356 	SFP_OPTICAL_WAVELENGTH_MSB	= 60,
357 	SFP_OPTICAL_WAVELENGTH_LSB	= 61,
358 	SFP_CABLE_SPEC			= 60,
359 	SFP_CC_BASE			= 63,
360 
361 	SFP_OPTIONS			= 64,	/* 2 bytes, MSB, LSB */
362 	SFP_OPTIONS_HIGH_POWER_LEVEL	= BIT(13),
363 	SFP_OPTIONS_PAGING_A2		= BIT(12),
364 	SFP_OPTIONS_RETIMER		= BIT(11),
365 	SFP_OPTIONS_COOLED_XCVR		= BIT(10),
366 	SFP_OPTIONS_POWER_DECL		= BIT(9),
367 	SFP_OPTIONS_RX_LINEAR_OUT	= BIT(8),
368 	SFP_OPTIONS_RX_DECISION_THRESH	= BIT(7),
369 	SFP_OPTIONS_TUNABLE_TX		= BIT(6),
370 	SFP_OPTIONS_RATE_SELECT		= BIT(5),
371 	SFP_OPTIONS_TX_DISABLE		= BIT(4),
372 	SFP_OPTIONS_TX_FAULT		= BIT(3),
373 	SFP_OPTIONS_LOS_INVERTED	= BIT(2),
374 	SFP_OPTIONS_LOS_NORMAL		= BIT(1),
375 
376 	SFP_BR_MAX			= 66,
377 	SFP_BR_MIN			= 67,
378 	SFP_VENDOR_SN			= 68,
379 	SFP_DATECODE			= 84,
380 
381 	SFP_DIAGMON			= 92,
382 	SFP_DIAGMON_DDM			= BIT(6),
383 	SFP_DIAGMON_INT_CAL		= BIT(5),
384 	SFP_DIAGMON_EXT_CAL		= BIT(4),
385 	SFP_DIAGMON_RXPWR_AVG		= BIT(3),
386 	SFP_DIAGMON_ADDRMODE		= BIT(2),
387 
388 	SFP_ENHOPTS			= 93,
389 	SFP_ENHOPTS_ALARMWARN		= BIT(7),
390 	SFP_ENHOPTS_SOFT_TX_DISABLE	= BIT(6),
391 	SFP_ENHOPTS_SOFT_TX_FAULT	= BIT(5),
392 	SFP_ENHOPTS_SOFT_RX_LOS		= BIT(4),
393 	SFP_ENHOPTS_SOFT_RATE_SELECT	= BIT(3),
394 	SFP_ENHOPTS_APP_SELECT_SFF8079	= BIT(2),
395 	SFP_ENHOPTS_SOFT_RATE_SFF8431	= BIT(1),
396 
397 	SFP_SFF8472_COMPLIANCE		= 94,
398 	SFP_SFF8472_COMPLIANCE_NONE	= 0x00,
399 	SFP_SFF8472_COMPLIANCE_REV9_3	= 0x01,
400 	SFP_SFF8472_COMPLIANCE_REV9_5	= 0x02,
401 	SFP_SFF8472_COMPLIANCE_REV10_2	= 0x03,
402 	SFP_SFF8472_COMPLIANCE_REV10_4	= 0x04,
403 	SFP_SFF8472_COMPLIANCE_REV11_0	= 0x05,
404 	SFP_SFF8472_COMPLIANCE_REV11_3	= 0x06,
405 	SFP_SFF8472_COMPLIANCE_REV11_4	= 0x07,
406 	SFP_SFF8472_COMPLIANCE_REV12_0	= 0x08,
407 
408 	SFP_CC_EXT			= 95,
409 };
410 
411 /* SFP Diagnostics */
412 enum {
413 	/* Alarm and warnings stored MSB at lower address then LSB */
414 	SFP_TEMP_HIGH_ALARM		= 0,
415 	SFP_TEMP_LOW_ALARM		= 2,
416 	SFP_TEMP_HIGH_WARN		= 4,
417 	SFP_TEMP_LOW_WARN		= 6,
418 	SFP_VOLT_HIGH_ALARM		= 8,
419 	SFP_VOLT_LOW_ALARM		= 10,
420 	SFP_VOLT_HIGH_WARN		= 12,
421 	SFP_VOLT_LOW_WARN		= 14,
422 	SFP_BIAS_HIGH_ALARM		= 16,
423 	SFP_BIAS_LOW_ALARM		= 18,
424 	SFP_BIAS_HIGH_WARN		= 20,
425 	SFP_BIAS_LOW_WARN		= 22,
426 	SFP_TXPWR_HIGH_ALARM		= 24,
427 	SFP_TXPWR_LOW_ALARM		= 26,
428 	SFP_TXPWR_HIGH_WARN		= 28,
429 	SFP_TXPWR_LOW_WARN		= 30,
430 	SFP_RXPWR_HIGH_ALARM		= 32,
431 	SFP_RXPWR_LOW_ALARM		= 34,
432 	SFP_RXPWR_HIGH_WARN		= 36,
433 	SFP_RXPWR_LOW_WARN		= 38,
434 	SFP_LASER_TEMP_HIGH_ALARM	= 40,
435 	SFP_LASER_TEMP_LOW_ALARM	= 42,
436 	SFP_LASER_TEMP_HIGH_WARN	= 44,
437 	SFP_LASER_TEMP_LOW_WARN		= 46,
438 	SFP_TEC_CUR_HIGH_ALARM		= 48,
439 	SFP_TEC_CUR_LOW_ALARM		= 50,
440 	SFP_TEC_CUR_HIGH_WARN		= 52,
441 	SFP_TEC_CUR_LOW_WARN		= 54,
442 	SFP_CAL_RXPWR4			= 56,
443 	SFP_CAL_RXPWR3			= 60,
444 	SFP_CAL_RXPWR2			= 64,
445 	SFP_CAL_RXPWR1			= 68,
446 	SFP_CAL_RXPWR0			= 72,
447 	SFP_CAL_TXI_SLOPE		= 76,
448 	SFP_CAL_TXI_OFFSET		= 78,
449 	SFP_CAL_TXPWR_SLOPE		= 80,
450 	SFP_CAL_TXPWR_OFFSET		= 82,
451 	SFP_CAL_T_SLOPE			= 84,
452 	SFP_CAL_T_OFFSET		= 86,
453 	SFP_CAL_V_SLOPE			= 88,
454 	SFP_CAL_V_OFFSET		= 90,
455 	SFP_CHKSUM			= 95,
456 
457 	SFP_TEMP			= 96,
458 	SFP_VCC				= 98,
459 	SFP_TX_BIAS			= 100,
460 	SFP_TX_POWER			= 102,
461 	SFP_RX_POWER			= 104,
462 	SFP_LASER_TEMP			= 106,
463 	SFP_TEC_CUR			= 108,
464 
465 	SFP_STATUS			= 110,
466 	SFP_STATUS_TX_DISABLE		= BIT(7),
467 	SFP_STATUS_TX_DISABLE_FORCE	= BIT(6),
468 	SFP_STATUS_TX_FAULT		= BIT(2),
469 	SFP_STATUS_RX_LOS		= BIT(1),
470 	SFP_ALARM0			= 112,
471 	SFP_ALARM0_TEMP_HIGH		= BIT(7),
472 	SFP_ALARM0_TEMP_LOW		= BIT(6),
473 	SFP_ALARM0_VCC_HIGH		= BIT(5),
474 	SFP_ALARM0_VCC_LOW		= BIT(4),
475 	SFP_ALARM0_TX_BIAS_HIGH		= BIT(3),
476 	SFP_ALARM0_TX_BIAS_LOW		= BIT(2),
477 	SFP_ALARM0_TXPWR_HIGH		= BIT(1),
478 	SFP_ALARM0_TXPWR_LOW		= BIT(0),
479 
480 	SFP_ALARM1			= 113,
481 	SFP_ALARM1_RXPWR_HIGH		= BIT(7),
482 	SFP_ALARM1_RXPWR_LOW		= BIT(6),
483 
484 	SFP_WARN0			= 116,
485 	SFP_WARN0_TEMP_HIGH		= BIT(7),
486 	SFP_WARN0_TEMP_LOW		= BIT(6),
487 	SFP_WARN0_VCC_HIGH		= BIT(5),
488 	SFP_WARN0_VCC_LOW		= BIT(4),
489 	SFP_WARN0_TX_BIAS_HIGH		= BIT(3),
490 	SFP_WARN0_TX_BIAS_LOW		= BIT(2),
491 	SFP_WARN0_TXPWR_HIGH		= BIT(1),
492 	SFP_WARN0_TXPWR_LOW		= BIT(0),
493 
494 	SFP_WARN1			= 117,
495 	SFP_WARN1_RXPWR_HIGH		= BIT(7),
496 	SFP_WARN1_RXPWR_LOW		= BIT(6),
497 
498 	SFP_EXT_STATUS			= 118,
499 	SFP_EXT_STATUS_PWRLVL_SELECT	= BIT(0),
500 
501 	SFP_VSL				= 120,
502 	SFP_PAGE			= 127,
503 };
504 
505 struct fwnode_handle;
506 struct ethtool_eeprom;
507 struct ethtool_modinfo;
508 struct sfp_bus;
509 
510 /**
511  * struct sfp_upstream_ops - upstream operations structure
512  * @attach: called when the sfp socket driver is bound to the upstream
513  *   (mandatory).
514  * @detach: called when the sfp socket driver is unbound from the upstream
515  *   (mandatory).
516  * @module_insert: called after a module has been detected to determine
517  *   whether the module is supported for the upstream device.
518  * @module_remove: called after the module has been removed.
519  * @module_start: called after the PHY probe step
520  * @module_stop: called before the PHY is removed
521  * @link_down: called when the link is non-operational for whatever
522  *   reason.
523  * @link_up: called when the link is operational.
524  * @connect_phy: called when an I2C accessible PHY has been detected
525  *   on the module.
526  * @disconnect_phy: called when a module with an I2C accessible PHY has
527  *   been removed.
528  */
529 struct sfp_upstream_ops {
530 	void (*attach)(void *priv, struct sfp_bus *bus);
531 	void (*detach)(void *priv, struct sfp_bus *bus);
532 	int (*module_insert)(void *priv, const struct sfp_eeprom_id *id);
533 	void (*module_remove)(void *priv);
534 	int (*module_start)(void *priv);
535 	void (*module_stop)(void *priv);
536 	void (*link_down)(void *priv);
537 	void (*link_up)(void *priv);
538 	int (*connect_phy)(void *priv, struct phy_device *);
539 	void (*disconnect_phy)(void *priv);
540 };
541 
542 #if IS_ENABLED(CONFIG_SFP)
543 int sfp_parse_port(struct sfp_bus *bus, const struct sfp_eeprom_id *id,
544 		   unsigned long *support);
545 bool sfp_may_have_phy(struct sfp_bus *bus, const struct sfp_eeprom_id *id);
546 void sfp_parse_support(struct sfp_bus *bus, const struct sfp_eeprom_id *id,
547 		       unsigned long *support, unsigned long *interfaces);
548 phy_interface_t sfp_select_interface(struct sfp_bus *bus,
549 				     unsigned long *link_modes);
550 
551 int sfp_get_module_info(struct sfp_bus *bus, struct ethtool_modinfo *modinfo);
552 int sfp_get_module_eeprom(struct sfp_bus *bus, struct ethtool_eeprom *ee,
553 			  u8 *data);
554 int sfp_get_module_eeprom_by_page(struct sfp_bus *bus,
555 				  const struct ethtool_module_eeprom *page,
556 				  struct netlink_ext_ack *extack);
557 void sfp_upstream_start(struct sfp_bus *bus);
558 void sfp_upstream_stop(struct sfp_bus *bus);
559 void sfp_bus_put(struct sfp_bus *bus);
560 struct sfp_bus *sfp_bus_find_fwnode(const struct fwnode_handle *fwnode);
561 int sfp_bus_add_upstream(struct sfp_bus *bus, void *upstream,
562 			 const struct sfp_upstream_ops *ops);
563 void sfp_bus_del_upstream(struct sfp_bus *bus);
564 #else
565 static inline int sfp_parse_port(struct sfp_bus *bus,
566 				 const struct sfp_eeprom_id *id,
567 				 unsigned long *support)
568 {
569 	return PORT_OTHER;
570 }
571 
572 static inline bool sfp_may_have_phy(struct sfp_bus *bus,
573 				    const struct sfp_eeprom_id *id)
574 {
575 	return false;
576 }
577 
578 static inline void sfp_parse_support(struct sfp_bus *bus,
579 				     const struct sfp_eeprom_id *id,
580 				     unsigned long *support,
581 				     unsigned long *interfaces)
582 {
583 }
584 
585 static inline phy_interface_t sfp_select_interface(struct sfp_bus *bus,
586 						   unsigned long *link_modes)
587 {
588 	return PHY_INTERFACE_MODE_NA;
589 }
590 
591 static inline int sfp_get_module_info(struct sfp_bus *bus,
592 				      struct ethtool_modinfo *modinfo)
593 {
594 	return -EOPNOTSUPP;
595 }
596 
597 static inline int sfp_get_module_eeprom(struct sfp_bus *bus,
598 					struct ethtool_eeprom *ee, u8 *data)
599 {
600 	return -EOPNOTSUPP;
601 }
602 
603 static inline int sfp_get_module_eeprom_by_page(struct sfp_bus *bus,
604 						const struct ethtool_module_eeprom *page,
605 						struct netlink_ext_ack *extack)
606 {
607 	return -EOPNOTSUPP;
608 }
609 
610 static inline void sfp_upstream_start(struct sfp_bus *bus)
611 {
612 }
613 
614 static inline void sfp_upstream_stop(struct sfp_bus *bus)
615 {
616 }
617 
618 static inline void sfp_bus_put(struct sfp_bus *bus)
619 {
620 }
621 
622 static inline struct sfp_bus *
623 sfp_bus_find_fwnode(const struct fwnode_handle *fwnode)
624 {
625 	return NULL;
626 }
627 
628 static inline int sfp_bus_add_upstream(struct sfp_bus *bus, void *upstream,
629 				       const struct sfp_upstream_ops *ops)
630 {
631 	return 0;
632 }
633 
634 static inline void sfp_bus_del_upstream(struct sfp_bus *bus)
635 {
636 }
637 #endif
638 
639 #endif
640