190 lines
6.0 KiB
C
190 lines
6.0 KiB
C
/*
|
|
* sff-common.h: Implements SFF-8024 Rev 4.0 i.e. Specifcation
|
|
* of pluggable I/O configuration
|
|
*
|
|
* Common utilities across SFF-8436/8636 and SFF-8472/8079
|
|
* are defined in this file
|
|
*
|
|
* Copyright 2010 Solarflare Communications Inc.
|
|
* Aurelien Guillaume <aurelien@iwi.me> (C) 2012
|
|
* Copyright (C) 2014 Cumulus networks Inc.
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Freeoftware Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* Vidya Sagar Ravipati <vidya@cumulusnetworks.com>
|
|
* This implementation is loosely based on current SFP parser
|
|
* and SFF-8024 specs (ftp://ftp.seagate.com/pub/sff/SFF-8024.PDF)
|
|
* by SFF Committee.
|
|
*/
|
|
|
|
#ifndef SFF_COMMON_H__
|
|
#define SFF_COMMON_H__
|
|
|
|
#include <stdio.h>
|
|
#include "internal.h"
|
|
|
|
#define SFF8024_ID_OFFSET 0x00
|
|
#define SFF8024_ID_UNKNOWN 0x00
|
|
#define SFF8024_ID_GBIC 0x01
|
|
#define SFF8024_ID_SOLDERED_MODULE 0x02
|
|
#define SFF8024_ID_SFP 0x03
|
|
#define SFF8024_ID_300_PIN_XBI 0x04
|
|
#define SFF8024_ID_XENPAK 0x05
|
|
#define SFF8024_ID_XFP 0x06
|
|
#define SFF8024_ID_XFF 0x07
|
|
#define SFF8024_ID_XFP_E 0x08
|
|
#define SFF8024_ID_XPAK 0x09
|
|
#define SFF8024_ID_X2 0x0A
|
|
#define SFF8024_ID_DWDM_SFP 0x0B
|
|
#define SFF8024_ID_QSFP 0x0C
|
|
#define SFF8024_ID_QSFP_PLUS 0x0D
|
|
#define SFF8024_ID_CXP 0x0E
|
|
#define SFF8024_ID_HD4X 0x0F
|
|
#define SFF8024_ID_HD8X 0x10
|
|
#define SFF8024_ID_QSFP28 0x11
|
|
#define SFF8024_ID_CXP2 0x12
|
|
#define SFF8024_ID_CDFP 0x13
|
|
#define SFF8024_ID_HD4X_FANOUT 0x14
|
|
#define SFF8024_ID_HD8X_FANOUT 0x15
|
|
#define SFF8024_ID_CDFP_S3 0x16
|
|
#define SFF8024_ID_MICRO_QSFP 0x17
|
|
#define SFF8024_ID_LAST SFF8024_ID_MICRO_QSFP
|
|
#define SFF8024_ID_UNALLOCATED_LAST 0x7F
|
|
#define SFF8024_ID_VENDOR_START 0x80
|
|
#define SFF8024_ID_VENDOR_LAST 0xFF
|
|
|
|
#define SFF8024_CTOR_UNKNOWN 0x00
|
|
#define SFF8024_CTOR_SC 0x01
|
|
#define SFF8024_CTOR_FC_STYLE_1 0x02
|
|
#define SFF8024_CTOR_FC_STYLE_2 0x03
|
|
#define SFF8024_CTOR_BNC_TNC 0x04
|
|
#define SFF8024_CTOR_FC_COAX 0x05
|
|
#define SFF8024_CTOR_FIBER_JACK 0x06
|
|
#define SFF8024_CTOR_LC 0x07
|
|
#define SFF8024_CTOR_MT_RJ 0x08
|
|
#define SFF8024_CTOR_MU 0x09
|
|
#define SFF8024_CTOR_SG 0x0A
|
|
#define SFF8024_CTOR_OPT_PT 0x0B
|
|
#define SFF8024_CTOR_MPO 0x0C
|
|
#define SFF8024_CTOR_MPO_2 0x0D
|
|
/* 0E-1Fh --- Reserved */
|
|
#define SFF8024_CTOR_HSDC_II 0x20
|
|
#define SFF8024_CTOR_COPPER_PT 0x21
|
|
#define SFF8024_CTOR_RJ45 0x22
|
|
#define SFF8024_CTOR_NO_SEPARABLE 0x23
|
|
#define SFF8024_CTOR_MXC_2x16 0x24
|
|
#define SFF8024_CTOR_LAST SFF8024_CTOR_MXC_2x16
|
|
#define SFF8024_CTOR_UNALLOCATED_LAST 0x7F
|
|
#define SFF8024_CTOR_VENDOR_START 0x80
|
|
#define SFF8024_CTOR_VENDOR_LAST 0xFF
|
|
|
|
/* ENCODING Values */
|
|
#define SFF8024_ENCODING_UNSPEC 0x00
|
|
#define SFF8024_ENCODING_8B10B 0x01
|
|
#define SFF8024_ENCODING_4B5B 0x02
|
|
#define SFF8024_ENCODING_NRZ 0x03
|
|
/*
|
|
* Value: 04h
|
|
* SFF-8472 - Manchester
|
|
* SFF-8436/8636 - SONET Scrambled
|
|
*/
|
|
#define SFF8024_ENCODING_4h 0x04
|
|
/*
|
|
* Value: 05h
|
|
* SFF-8472 - SONET Scrambled
|
|
* SFF-8436/8636 - 64B/66B
|
|
*/
|
|
#define SFF8024_ENCODING_5h 0x05
|
|
/*
|
|
* Value: 06h
|
|
* SFF-8472 - 64B/66B
|
|
* SFF-8436/8636 - Manchester
|
|
*/
|
|
#define SFF8024_ENCODING_6h 0x06
|
|
#define SFF8024_ENCODING_256B 0x07
|
|
#define SFF8024_ENCODING_PAM4 0x08
|
|
|
|
/* Most common case: 16-bit unsigned integer in a certain unit */
|
|
#define OFFSET_TO_U16(offset) \
|
|
(id[offset] << 8 | id[(offset) + 1])
|
|
|
|
# define PRINT_xX_PWR(string, var) \
|
|
printf("\t%-41s : %.4f mW / %.2f dBm\n", (string), \
|
|
(double)((var) / 10000.), \
|
|
convert_mw_to_dbm((double)((var) / 10000.)))
|
|
|
|
#define PRINT_BIAS(string, bias_cur) \
|
|
printf("\t%-41s : %.3f mA\n", (string), \
|
|
(double)(bias_cur / 500.))
|
|
|
|
#define PRINT_TEMP(string, temp) \
|
|
printf("\t%-41s : %.2f degrees C / %.2f degrees F\n", \
|
|
(string), (double)(temp / 256.), \
|
|
(double)(temp / 256. * 1.8 + 32.))
|
|
|
|
#define PRINT_VCC(string, sfp_voltage) \
|
|
printf("\t%-41s : %.4f V\n", (string), \
|
|
(double)(sfp_voltage / 10000.))
|
|
|
|
# define PRINT_xX_THRESH_PWR(string, var, index) \
|
|
PRINT_xX_PWR(string, (var)[(index)])
|
|
|
|
/* Channel Monitoring Fields */
|
|
struct sff_channel_diags {
|
|
__u16 bias_cur; /* Measured bias current in 2uA units */
|
|
__u16 rx_power; /* Measured RX Power */
|
|
__u16 tx_power; /* Measured TX Power */
|
|
};
|
|
|
|
/* Module Monitoring Fields */
|
|
struct sff_diags {
|
|
|
|
#define MAX_CHANNEL_NUM 4
|
|
#define LWARN 0
|
|
#define HWARN 1
|
|
#define LALRM 2
|
|
#define HALRM 3
|
|
#define MCURR 4
|
|
|
|
/* Supports DOM */
|
|
__u8 supports_dom;
|
|
/* Supports alarm/warning thold */
|
|
__u8 supports_alarms;
|
|
/* RX Power: 0 = OMA, 1 = Average power */
|
|
__u8 rx_power_type;
|
|
/* TX Power: 0 = Not supported, 1 = Average power */
|
|
__u8 tx_power_type;
|
|
|
|
__u8 calibrated_ext; /* Is externally calibrated */
|
|
/* [5] tables are low/high warn, low/high alarm, current */
|
|
/* SFP voltage in 0.1mV units */
|
|
__u16 sfp_voltage[5];
|
|
/* SFP Temp in 16-bit signed 1/256 Celcius */
|
|
__s16 sfp_temp[5];
|
|
/* Measured bias current in 2uA units */
|
|
__u16 bias_cur[5];
|
|
/* Measured TX Power */
|
|
__u16 tx_power[5];
|
|
/* Measured RX Power */
|
|
__u16 rx_power[5];
|
|
struct sff_channel_diags scd[MAX_CHANNEL_NUM];
|
|
};
|
|
|
|
double convert_mw_to_dbm(double mw);
|
|
void sff_show_value_with_unit(const __u8 *id, unsigned int reg,
|
|
const char *name, unsigned int mult,
|
|
const char *unit);
|
|
void sff_show_ascii(const __u8 *id, unsigned int first_reg,
|
|
unsigned int last_reg, const char *name);
|
|
void sff_show_thresholds(struct sff_diags sd);
|
|
|
|
void sff8024_show_oui(const __u8 *id, int id_offset);
|
|
void sff8024_show_identifier(const __u8 *id, int id_offset);
|
|
void sff8024_show_connector(const __u8 *id, int ctor_offset);
|
|
void sff8024_show_encoding(const __u8 *id, int encoding_offset, int sff_type);
|
|
|
|
#endif /* SFF_COMMON_H__ */
|