u-boot/arch/mips/mach-octeon/include/mach/cvmx-helper-sfp.h

/* SPDX-License-Identifier: GPL-2.0 */
/*
 * Copyright (C) 2020 Marvell International Ltd.
 *
 * Helper functions to abstract SFP and QSFP connectors
 */

#ifndef __CVMX_HELPER_SFP_H__
#define __CVMX_HELPER_SFP_H__

/**
 * Maximum size for the SFP EEPROM.  Currently only 96 bytes are used.
 */
#define CVMX_SFP_MAX_EEPROM_SIZE 0x100

/**
 * Default address of sfp EEPROM
 */
#define CVMX_SFP_DEFAULT_I2C_ADDR 0x50

/**
 * Default address of SFP diagnostics chip
 */
#define CVMX_SFP_DEFAULT_DIAG_I2C_ADDR 0x51

struct cvmx_fdt_sfp_info;
struct cvmx_fdt_gpio_info;
/**
 * Connector type for module, usually we only see SFP and QSFPP
 */
enum cvmx_phy_sfp_conn_type {
	CVMX_SFP_CONN_GBIC = 0x01,	 /** GBIC */
	CVMX_SFP_CONN_SFP = 0x03,	 /** SFP/SFP+/SFP28 */
	CVMX_SFP_CONN_QSFP = 0x0C,	 /** 1G QSFP (obsolete) */
	CVMX_SFP_CONN_QSFPP = 0x0D,	 /** QSFP+ or later */
	CVMX_SFP_CONN_QSFP28 = 0x11,	 /** QSFP28 (100Gbps) */
	CVMX_SFP_CONN_MICRO_QSFP = 0x17, /** Micro QSFP */
	CVMX_SFP_CONN_QSFP_DD = 0x18,	 /** QSFP-DD Double Density 8X */
	CVMX_SFP_CONN_SFP_DD = 0x1A,	 /** SFP-DD Double Density 2X */
};

/**
 * module type plugged into a SFP/SFP+/QSFP+ port
 */
enum cvmx_phy_sfp_mod_type {
	CVMX_SFP_MOD_UNKNOWN = 0, /** Unknown or unspecified */
	/** Fiber optic module (LC connector) */
	CVMX_SFP_MOD_OPTICAL_LC = 0x7,
	/** Multiple optical */
	CVMX_SFP_MOD_MULTIPLE_OPTICAL = 0x9,
	/** Fiber optic module (pigtail, no connector) */
	CVMX_SFP_MOD_OPTICAL_PIGTAIL = 0xB,
	CVMX_SFP_MOD_COPPER_PIGTAIL = 0x21, /** copper module */
	CVMX_SFP_MOD_RJ45 = 0x22,	    /** RJ45 (i.e. 10GBase-T) */
	/** No separable connector (SFP28/copper) */
	CVMX_SFP_MOD_NO_SEP_CONN = 0x23,
	/** MXC 2X16 */
	CVMX_SFP_MOD_MXC_2X16 = 0x24,
	/** CS optical connector */
	CVMX_SFP_MOD_CS_OPTICAL = 0x25,
	/** Mini CS optical connector */
	CVMX_SFP_MOD_MINI_CS_OPTICAL = 0x26,
	/** Unknown/other module type */
	CVMX_SFP_MOD_OTHER
};

/** Peak rate supported by SFP cable */
enum cvmx_phy_sfp_rate {
	CVMX_SFP_RATE_UNKNOWN, /** Unknown rate */
	CVMX_SFP_RATE_1G,      /** 1Gbps */
	CVMX_SFP_RATE_10G,     /** 10Gbps */
	CVMX_SFP_RATE_25G,     /** 25Gbps */
	CVMX_SFP_RATE_40G,     /** 40Gbps */
	CVMX_SFP_RATE_100G     /** 100Gbps */
};

/**
 * Cable compliance specification
 * See table 4-4 from SFF-8024 for the extended specification compliance codes
 */
enum cvmx_phy_sfp_cable_ext_compliance {
	CVMX_SFP_CABLE_UNSPEC = 0,
	CVMX_SFP_CABLE_100G_25GAUI_C2M_AOC_HIGH_BER = 0x01, /** Active optical cable */
	CVMX_SFP_CABLE_100G_SR4_25G_SR = 0x2,
	CVMX_SFP_CABLE_100G_LR4_25G_LR = 0x3,
	CVMX_SFP_CABLE_100G_ER4_25G_ER = 0x4,
	CVMX_SFP_CABLE_100G_SR10 = 0x5,
	CVMX_SFP_CABLE_100G_CWDM4_MSA = 0x6,
	CVMX_SFP_CABLE_100G_PSM4 = 0x7,
	CVMX_SFP_CABLE_100G_25GAUI_C2M_ACC_HIGH_BER = 0x8,
	CVMX_SFP_CABLE_100G_CWDM4 = 0x9,
	CVMX_SFP_CABLE_100G_CR4_25G_CR_CA_L = 0xB,
	CVMX_SFP_CABLE_25G_CR_CA_S = 0xC,
	CVMX_SFP_CABLE_25G_CR_CA_N = 0xD,
	CVMX_SFP_CABLE_40G_ER4 = 0x10,
	CVMX_SFP_CABLE_4X10G_SR = 0x11,
	CVMX_SFP_CABLE_40G_PSM4 = 0x12,
	CVMX_SFP_CABLE_G959_1_P1I1_2D1 = 0x13,
	CVMX_SFP_CABLE_G959_1_P1S1_2D2 = 0x14,
	CVMX_SFP_CABLE_G959_1_P1L1_2D2 = 0x15,
	CVMX_SFP_CABLE_10GBASE_T = 0x16,
	CVMX_SFP_CABLE_100G_CLR4 = 0x17,
	CVMX_SFP_CABLE_100G_25GAUI_C2M_AOC_LOW_BER = 0x18,
	CVMX_SFP_CABLE_100G_25GAUI_C2M_ACC_LOW_BER = 0x19,
	CVMX_SFP_CABLE_100G_2_LAMBDA_DWDM = 0x1a,
	CVMX_SFP_CABLE_100G_1550NM_WDM = 0x1b,
	CVMX_SFP_CABLE_10GBASE_T_SR = 0x1c,
	CVMX_SFP_CABLE_5GBASE_T = 0x1d,
	CVMX_SFP_CABLE_2_5GBASE_T = 0x1e,
	CVMX_SFP_CABLE_40G_SWDM4 = 0x1f,
	CVMX_SFP_CABLE_100G_SWDM4 = 0x20,
	CVMX_SFP_CABLE_100G_PAM4_BIDI = 0x21,
	CVMX_SFP_CABLE_100G_4WDM_10_FEC_HOST = 0x22,
	CVMX_SFP_CABLE_100G_4WDM_20_FEC_HOST = 0x23,
	CVMX_SFP_CABLE_100G_4WDM_40_FEC_HOST = 0x24,
	CVMX_SFP_CABLE_100GBASE_DR_CAUI4_NO_FEC = 0x25,
	CVMX_SFP_CABLE_100G_FR_CAUI4_NO_FEC = 0x26,
	CVMX_SFP_CABLE_100G_LR_CAUI4_NO_FEC = 0x27,
	CVMX_SFP_CABLE_ACTIVE_COPPER_50_100_200GAUI_LOW_BER = 0x30,
	CVMX_SFP_CABLE_ACTIVE_OPTICAL_50_100_200GAUI_LOW_BER = 0x31,
	CVMX_SFP_CABLE_ACTIVE_COPPER_50_100_200GAUI_HI_BER = 0x32,
	CVMX_SFP_CABLE_ACTIVE_OPTICAL_50_100_200GAUI_HI_BER = 0x33,
	CVMX_SFP_CABLE_50_100_200G_CR = 0x40,
	CVMX_SFP_CABLE_50_100_200G_SR = 0x41,
	CVMX_SFP_CABLE_50GBASE_FR_200GBASE_DR4 = 0x42,
	CVMX_SFP_CABLE_200GBASE_FR4 = 0x43,
	CVMX_SFP_CABLE_200G_1550NM_PSM4 = 0x44,
	CVMX_SFP_CABLE_50GBASE_LR = 0x45,
	CVMX_SFP_CABLE_200GBASE_LR4 = 0x46,
	CVMX_SFP_CABLE_64GFC_EA = 0x50,
	CVMX_SFP_CABLE_64GFC_SW = 0x51,
	CVMX_SFP_CABLE_64GFC_LW = 0x52,
	CVMX_SFP_CABLE_128GFC_EA = 0x53,
	CVMX_SFP_CABLE_128GFC_SW = 0x54,
	CVMX_SFP_CABLE_128GFC_LW = 0x55,

};

/** Optical modes module is compliant with */
enum cvmx_phy_sfp_10g_eth_compliance {
	CVMX_SFP_CABLE_10GBASE_ER = 0x80,  /** 10G ER */
	CVMX_SFP_CABLE_10GBASE_LRM = 0x40, /** 10G LRM */
	CVMX_SFP_CABLE_10GBASE_LR = 0x20,  /** 10G LR */
	CVMX_SFP_CABLE_10GBASE_SR = 0x10   /** 10G SR */
};

/** Diagnostic ASIC compatibility */
enum cvmx_phy_sfp_sff_8472_diag_rev {
	CVMX_SFP_SFF_8472_NO_DIAG = 0x00,
	CVMX_SFP_SFF_8472_REV_9_3 = 0x01,
	CVMX_SFP_SFF_8472_REV_9_5 = 0x02,
	CVMX_SFP_SFF_8472_REV_10_2 = 0x03,
	CVMX_SFP_SFF_8472_REV_10_4 = 0x04,
	CVMX_SFP_SFF_8472_REV_11_0 = 0x05,
	CVMX_SFP_SFF_8472_REV_11_3 = 0x06,
	CVMX_SFP_SFF_8472_REV_11_4 = 0x07,
	CVMX_SFP_SFF_8472_REV_12_0 = 0x08,
	CVMX_SFP_SFF_8472_REV_UNALLOCATED = 0xff
};

/**
 * Data structure describing the current SFP or QSFP EEPROM
 */
struct cvmx_sfp_mod_info {
	enum cvmx_phy_sfp_conn_type conn_type; /** Connector type */
	enum cvmx_phy_sfp_mod_type mod_type;   /** Module type */
	enum cvmx_phy_sfp_rate rate;	       /** Rate of module */
	/** 10G Ethernet Compliance codes (logical OR) */
	enum cvmx_phy_sfp_10g_eth_compliance eth_comp;
	/** Extended Cable compliance */
	enum cvmx_phy_sfp_cable_ext_compliance cable_comp;
	u8 vendor_name[17]; /** Module vendor name */
	u8 vendor_oui[3];   /** vendor OUI */
	u8 vendor_pn[17];   /** Vendor part number */
	u8 vendor_rev[5];   /** Vendor revision */
	u8 vendor_sn[17];   /** Vendor serial number */
	u8 date_code[9];    /** Date code */
	bool valid;	    /** True if module is valid */
	bool active_cable;  /** False for passive copper */
	bool copper_cable;  /** True if cable is copper */
	/** True if module is limiting (i.e. not passive copper) */
	bool limiting;
	/** Maximum length of copper cable in meters */
	int max_copper_cable_len;
	/** Max single mode cable length in meters */
	int max_single_mode_cable_length;
	/** Max 50um OM2 cable length */
	int max_50um_om2_cable_length;
	/** Max 62.5um OM1 cable length */
	int max_62_5um_om1_cable_length;
	/** Max 50um OM4 cable length */
	int max_50um_om4_cable_length;
	/** Max 50um OM3 cable length */
	int max_50um_om3_cable_length;
	/** Minimum bitrate in Mbps */
	int bitrate_min;
	/** Maximum bitrate in Mbps */
	int bitrate_max;
	/**
	 * Set to true if forward error correction is required,
	 * for example, a 25GBase-CR CA-S cable.
	 *
	 * FEC should only be disabled at 25G with CA-N cables.  FEC is required
	 * with 5M and longer cables.
	 */
	bool fec_required;
	/** True if RX output is linear */
	bool linear_rx_output;
	/** Power level, can be 1, 2 or 3 */
	int power_level;
	/** False if conventional cooling is used, true for active cooling */
	bool cooled_laser;
	/** True if internal retimer or clock and data recovery circuit */
	bool internal_cdr;
	/** True if LoS is implemented */
	bool los_implemented;
	/** True if LoS is inverted from the standard */
	bool los_inverted;
	/** True if TX_FAULT is implemented */
	bool tx_fault_implemented;
	/** True if TX_DISABLE is implemented */
	bool tx_disable_implemented;
	/** True if RATE_SELECT is implemented */
	bool rate_select_implemented;
	/** True if tuneable transmitter technology is used */
	bool tuneable_transmitter;
	/** True if receiver decision threshold is implemented */
	bool rx_decision_threshold_implemented;
	/** True if diagnostic monitoring present */
	bool diag_monitoring;
	/** True if diagnostic address 0x7f is used for selecting the page */
	bool diag_paging;
	/** Diagnostic feature revision */
	enum cvmx_phy_sfp_sff_8472_diag_rev diag_rev;
	/** True if an address change sequence is required for diagnostics */
	bool diag_addr_change_required;
	/** True if RX power is averaged, false if OMA */
	bool diag_rx_power_averaged;
	/** True if diagnostics are externally calibrated */
	bool diag_externally_calibrated;
	/** True if diagnostics are internally calibrated */
	bool diag_internally_calibrated;
	/** True of soft rate select control implemented per SFF-8431 */
	bool diag_soft_rate_select_control;
	/** True if application select control implemented per SFF-8079 */
	bool diag_app_select_control;
	/** True if soft RATE_SELECT control and moonitoring implemented */
	bool diag_soft_rate_select_implemented;
	/** True if soft RX_LOS monitoring implemented */
	bool diag_soft_rx_los_implemented;
	/** True if soft TX_FAULT monitoring implemented */
	bool diag_soft_tx_fault_implemented;
	/** True if soft TX_DISABLE control and monitoring implemented */
	bool diag_soft_tx_disable_implemented;
	/** True if alarm/warning flags implemented */
	bool diag_alarm_warning_flags_implemented;
};

/**
 * Reads the SFP EEPROM using the i2c bus
 *
 * @param[out]	buffer		Buffer to store SFP EEPROM data in
 *				The buffer should be SFP_MAX_EEPROM_SIZE bytes.
 * @param	i2c_bus		i2c bus number to read from for SFP port
 * @param	i2c_addr	i2c address to use, 0 for default
 *
 * Return:	-1 if invalid bus or i2c read error, 0 for success
 */
int cvmx_phy_sfp_read_i2c_eeprom(u8 *buffer, int i2c_bus, int i2c_addr);

/**
 * Reads the SFP/SFP+/QSFP EEPROM and outputs the type of module or cable
 * plugged in
 *
 * @param[out]	sfp_info	Info about SFP module
 * @param[in]	buffer		SFP EEPROM buffer to parse
 *
 * Return:	0 on success, -1 if error reading EEPROM or if EEPROM corrupt
 */
int cvmx_phy_sfp_parse_eeprom(struct cvmx_sfp_mod_info *sfp_info, const u8 *buffer);

/**
 * Prints out information about a SFP/QSFP device
 *
 * @param[in]	sfp_info	data structure to print
 */
void cvmx_phy_sfp_print_info(const struct cvmx_sfp_mod_info *sfp_info);

/**
 * Reads and parses SFP/QSFP EEPROM
 *
 * @param	sfp	sfp handle to read
 *
 * Return:	0 for success, -1 on error.
 */
int cvmx_sfp_read_i2c_eeprom(struct cvmx_fdt_sfp_info *sfp);

/**
 * Returns the information about a SFP/QSFP device
 *
 * @param       sfp             sfp handle
 *
 * Return:      sfp_info        Pointer sfp mod info data structure
 */
const struct cvmx_sfp_mod_info *cvmx_phy_get_sfp_mod_info(const struct cvmx_fdt_sfp_info *sfp);

/**
 * Function called to check and return the status of the mod_abs pin or
 * mod_pres pin for QSFPs.
 *
 * @param	sfp	Handle to SFP information.
 * @param	data	User-defined data passed to the function
 *
 * Return:	0 if absent, 1 if present, -1 on error
 */
int cvmx_sfp_check_mod_abs(struct cvmx_fdt_sfp_info *sfp, void *data);

/**
 * Registers a function to be called to check mod_abs/mod_pres for a SFP/QSFP
 * slot.
 *
 * @param	sfp		Handle to SFP data structure
 * @param	check_mod_abs	Function to be called or NULL to remove
 * @param	mod_abs_data	User-defined data to be passed to check_mod_abs
 *
 * Return:	0 for success
 */
int cvmx_sfp_register_check_mod_abs(struct cvmx_fdt_sfp_info *sfp,
				    int (*check_mod_abs)(struct cvmx_fdt_sfp_info *sfp, void *data),
				    void *mod_abs_data);

/**
 * Registers a function to be called whenever the mod_abs/mod_pres signal
 * changes.
 *
 * @param	sfp		Handle to SFP data structure
 * @param	mod_abs_changed	Function called whenever mod_abs is changed
 *				or NULL to remove.
 * @param	mod_abs_changed_data	User-defined data passed to
 *					mod_abs_changed
 *
 * Return:	0 for success
 */
int cvmx_sfp_register_mod_abs_changed(struct cvmx_fdt_sfp_info *sfp,
				      int (*mod_abs_changed)(struct cvmx_fdt_sfp_info *sfp, int val,
							     void *data),
				      void *mod_abs_changed_data);

/**
 * Function called to check and return the status of the tx_fault pin
 *
 * @param	sfp	Handle to SFP information.
 * @param	data	User-defined data passed to the function
 *
 * Return:	0 if signal present, 1 if signal absent, -1 on error
 */
int cvmx_sfp_check_tx_fault(struct cvmx_fdt_sfp_info *sfp, void *data);

/**
 * Function called to check and return the status of the rx_los pin
 *
 * @param	sfp	Handle to SFP information.
 * @param	data	User-defined data passed to the function
 *
 * Return:	0 if signal present, 1 if signal absent, -1 on error
 */
int cvmx_sfp_check_rx_los(struct cvmx_fdt_sfp_info *sfp, void *data);

/**
 * Registers a function to be called whenever rx_los changes
 *
 * @param	sfp		Handle to SFP data structure
 * @param	rx_los_changed	Function to be called when rx_los changes
 *				or NULL to remove the function
 * @param	rx_los_changed_data	User-defined data passed to
 *					rx_los_changed
 *
 * Return:	0 for success
 */
int cvmx_sfp_register_rx_los_changed(struct cvmx_fdt_sfp_info *sfp,
				     int (*rx_los_changed)(struct cvmx_fdt_sfp_info *sfp, int val,
							   void *data),
				     void *rx_los_changed_data);

/**
 * Parses the device tree for SFP and QSFP slots
 *
 * @param	fdt_addr	Address of flat device-tree
 *
 * Return:	0 for success, -1 on error
 */
int cvmx_sfp_parse_device_tree(const void *fdt_addr);

/**
 * Given an IPD port number find the corresponding SFP or QSFP slot
 *
 * @param	ipd_port	IPD port number to search for
 *
 * Return:	pointer to SFP data structure or NULL if not found
 */
struct cvmx_fdt_sfp_info *cvmx_sfp_find_slot_by_port(int ipd_port);

/**
 * Given a fdt node offset find the corresponding SFP or QSFP slot
 *
 * @param	of_offset	flat device tree node offset
 *
 * Return:	pointer to SFP data structure or NULL if not found
 */
struct cvmx_fdt_sfp_info *cvmx_sfp_find_slot_by_fdt_node(int of_offset);

/**
 * Reads the EEPROMs of all SFP modules.
 *
 * Return: 0 for success
 */
int cvmx_sfp_read_all_modules(void);

/**
 * Validates if the module is correct for the specified port
 *
 * @param[in]	sfp	SFP port to check
 * @param	mode	interface mode
 *
 * Return:	true if module is valid, false if invalid
 * NOTE: This will also toggle the error LED, if present
 */
bool cvmx_sfp_validate_module(struct cvmx_fdt_sfp_info *sfp, int mode);

/**
 * Prints information about the SFP module
 *
 * @param[in]	sfp	sfp data structure
 */
void cvmx_sfp_print_info(const struct cvmx_fdt_sfp_info *sfp);

#endif /* __CVMX_HELPER_SFP_H__ */