sff8436.h (8487B) - Raw
1 /*- 2 * Copyright (c) 2014 Yandex LLC. 3 * 4 * All rights reserved. 5 * 6 * Redistribution and use in source and binary forms, with or without 7 * modification, are permitted provided that the following conditions 8 * are met: 9 * 1. Redistributions of source code must retain the above copyright 10 * notice, this list of conditions and the following disclaimer. 11 * 2. Redistributions in binary form must reproduce the above copyright 12 * notice, this list of conditions and the following disclaimer in the 13 * documentation and/or other materials provided with the distribution. 14 * 15 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 16 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 17 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 18 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 19 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 20 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 21 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 22 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 23 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 24 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 25 * SUCH DAMAGE. 26 */ 27 28 /* 29 * The following set of constants are from Document SFF-8436 30 * "QSFP+ 10 Gbs 4X PLUGGABLE TRANSCEIVER" revision 4.8 dated October 31, 2013 31 * 32 * This SFF standard defines the following QSFP+ memory address module: 33 * 34 * 1) 256-byte addressable block and 128-byte pages 35 * 2) Lower 128-bytes addresses always refer to the same page 36 * 3) Upper address space may refer to different pages depending on 37 * "page select" byte value. 38 * 39 * Map description: 40 * 41 * Serial address 0xA02: 42 * 43 * Lower bits 44 * 0-127 Monitoring data & page select byte 45 * 128-255: 46 * 47 * Page 00: 48 * 128-191 Base ID Fields 49 * 191-223 Extended ID 50 * 223-255 Vendor Specific ID 51 * 52 * Page 01 (optional): 53 * 128-255 App-specific data 54 * 55 * Page 02 (optional): 56 * 128-255 User EEPROM Data 57 * 58 * Page 03 (optional for Cable Assmeblies) 59 * 128-223 Thresholds 60 * 225-237 Vendor Specific 61 * 238-253 Channel Controls/Monitor 62 * 254-255 Reserverd 63 * 64 * All these values are read across an I2C (i squared C) bus. 65 */ 66 67 #define SFF_8436_BASE 0xA0 /* Base address for all requests */ 68 69 /* Table 17 - Lower Memory Map */ 70 enum { 71 SFF_8436_MID = 0, /* Copy of SFF_8436_ID field */ 72 SFF_8436_STATUS = 1, /* 2-bytes status (Table 18) */ 73 SFF_8436_INTR_START = 3, /* Interrupt flags (Tables 19-21) */ 74 SFF_8436_INTR_END = 21, 75 SFF_8436_MODMON_START = 22, /* Module monitors (Table 22 */ 76 SFF_8436_TEMP = 22, /* Internally measured module temp */ 77 SFF_8436_VCC = 26, /* Internally mesasure module 78 * supplied voltage */ 79 SFF_8436_MODMON_END = 33, 80 SFF_8436_CHMON_START = 34, /* Channel monitors (Table 23) */ 81 SFF_8436_RX_CH1_MSB = 34, /* Internally measured RX input power */ 82 SFF_8436_RX_CH1_LSB = 35, /* for channel 1 */ 83 SFF_8436_RX_CH2_MSB = 36, /* Internally measured RX input power */ 84 SFF_8436_RX_CH2_LSB = 37, /* for channel 2 */ 85 SFF_8436_RX_CH3_MSB = 38, /* Internally measured RX input power */ 86 SFF_8436_RX_CH3_LSB = 39, /* for channel 3 */ 87 SFF_8436_RX_CH4_MSB = 40, /* Internally measured RX input power */ 88 SFF_8436_RX_CH4_LSB = 41, /* for channel 4 */ 89 SFF_8436_TX_CH1_MSB = 42, /* Internally measured TX bias */ 90 SFF_8436_TX_CH1_LSB = 43, /* for channel 1 */ 91 SFF_8436_TX_CH2_MSB = 44, /* Internally measured TX bias */ 92 SFF_8436_TX_CH2_LSB = 45, /* for channel 2 */ 93 SFF_8436_TX_CH3_MSB = 46, /* Internally measured TX bias */ 94 SFF_8436_TX_CH3_LSB = 47, /* for channel 3 */ 95 SFF_8436_TX_CH4_MSB = 48, /* Internally measured TX bias */ 96 SFF_8436_TX_CH4_LSB = 49, /* for channel 4 */ 97 SFF_8436_CHANMON_END = 81, 98 SFF_8436_CONTROL_START = 86, /* Control (Table 24) */ 99 SFF_8436_CONTROL_END = 97, 100 SFF_8436_MASKS_START = 100, /* Module/channel masks (Table 25) */ 101 SFF_8436_MASKS_END = 106, 102 SFF_8436_CHPASSWORD = 119, /* Password change entry (4 bytes) */ 103 SFF_8436_PASSWORD = 123, /* Password entry area (4 bytes) */ 104 SFF_8436_PAGESEL = 127, /* Page select byte */ 105 }; 106 107 /* Table 18 - Status Indicators bits */ 108 /* Byte 1: all bits reserved */ 109 110 /* Byte 2 bits */ 111 #define SFF_8436_STATUS_FLATMEM (1 << 2) /* Upper memory flat or paged 112 * 0 = paging, 1=Page 0 only */ 113 #define SFF_8436_STATUS_INTL (1 << 1) /* Digital state of the intL 114 * Interrupt output pin */ 115 #define SFF_8436_STATUS_NOTREADY 1 /* Module has not yet achieved 116 * power up and memory data is not 117 * ready. 0=data is ready */ 118 /* 119 * Upper page 0 definitions: 120 * Table 29 - Serial ID: Data fields. 121 * 122 * Note that this table is mostly the same as used in SFF-8472. 123 * The only differenee is address shift: +128 bytes. 124 */ 125 enum { 126 SFF_8436_ID = 128, /* Module Type (defined in sff8472.h) */ 127 SFF_8436_EXT_ID = 129, /* Extended transceiver type 128 * (Table 31) */ 129 SFF_8436_CONNECTOR = 130, /* Connector type (Table 32) */ 130 SFF_8436_TRANS_START = 131, /* Electric or Optical Compatibility 131 * (Table 33) */ 132 SFF_8436_CODE_E1040100G = 131, /* 10/40/100G Ethernet Compliance Code */ 133 SFF_8436_CODE_SONET = 132, /* SONET Compliance codes */ 134 SFF_8436_CODE_SATA = 133, /* SAS/SATA compliance codes */ 135 SFF_8436_CODE_E1G = 134, /* Gigabit Ethernet Compliant codes */ 136 SFF_8436_CODE_FC_START = 135, /* FC link/media/speed */ 137 SFF_8436_CODE_FC_END = 138, 138 SFF_8436_TRANS_END = 138, 139 SFF_8436_ENCODING = 139, /* Encoding Code for high speed 140 * serial encoding algorithm (see 141 * Table 34) */ 142 SFF_8436_BITRATE = 140, /* Nominal signaling rate, units 143 * of 100MBd. */ 144 SFF_8436_RATEID = 141, /* Extended RateSelect Compliance 145 * (see Table 35) */ 146 SFF_8436_LEN_SMF_KM = 142, /* Link length supported for single 147 * mode fiber, units of km */ 148 SFF_8436_LEN_OM3 = 143, /* Link length supported for 850nm 149 * 50um multimode fiber, units of 2 m */ 150 SFF_8436_LEN_OM2 = 144, /* Link length supported for 50 um 151 * OM2 fiber, units of 1 m */ 152 SFF_8436_LEN_OM1 = 145, /* Link length supported for 1310 nm 153 * 50um multi-mode fiber, units of 1m*/ 154 SFF_8436_LEN_ASM = 144, /* Link length of passive cable assembly 155 * Length is specified as in the INF 156 * 8074, units of 1m. 0 means this is 157 * not value assembly. Value of 255 158 * means thet the Module supports length 159 * greater than 254 m. */ 160 SFF_8436_DEV_TECH = 147, /* Device/transmitter technology, 161 * see Table 36/37 */ 162 SFF_8436_VENDOR_START = 148, /* Vendor name, 16 bytes, padded 163 * right with 0x20 */ 164 SFF_8436_VENDOR_END = 163, 165 SFF_8436_EXTMODCODE = 164, /* Extended module code, Table 164 */ 166 SFF_8436_VENDOR_OUI_START = 165 , /* Vendor OUI SFP vendor IEEE 167 * company ID */ 168 SFF_8436_VENDOR_OUI_END = 167, 169 SFF_8436_PN_START = 168, /* Vendor PN, padded right with 0x20 */ 170 SFF_8436_PN_END = 183, 171 SFF_8436_REV_START = 184, /* Vendor Revision, padded right 0x20 */ 172 SFF_8436_REV_END = 185, 173 SFF_8436_WAVELEN_START = 186, /* Wavelength Laser wavelength 174 * (Passive/Active Cable 175 * Specification Compliance) */ 176 SFF_8436_WAVELEN_END = 189, 177 SFF_8436_MAX_CASE_TEMP = 190, /* Allows to specify maximum temp 178 * above 70C. Maximum case temperature is 179 * an 8-bit value in Degrees C. A value 180 *of 0 implies the standard 70C rating.*/ 181 SFF_8436_CC_BASE = 191, /* CC_BASE Check code for Base ID 182 * Fields (first 63 bytes) */ 183 /* Extended ID fields */ 184 SFF_8436_OPTIONS_START = 192, /* Options Indicates which optional 185 * transceiver signals are 186 * implemented (see Table 39) */ 187 SFF_8436_OPTIONS_END = 195, 188 SFF_8436_SN_START = 196, /* Vendor SN, riwght padded with 0x20 */ 189 SFF_8436_SN_END = 211, 190 SFF_8436_DATE_START = 212, /* Vendor’s manufacturing date code 191 * (see Table 40) */ 192 SFF_8436_DATE_END = 219, 193 SFF_8436_DIAG_TYPE = 220, /* Diagnostic Monitoring Type 194 * Indicates which type of 195 * diagnostic monitoring is 196 * implemented (if any) in the 197 * transceiver (see Table 41) */ 198 199 SFF_8436_ENHANCED = 221, /* Enhanced Options Indicates which 200 * optional features are implemented 201 * (if any) in the transceiver 202 * (see Table 42) */ 203 SFF_8636_BITRATE = 222, /* Nominal bit rate per channel, units 204 * of 250 Mbps */ 205 SFF_8436_CC_EXT = 223, /* Check code for the Extended ID 206 * Fields (bytes 192-222 incl) */ 207 SFF_8436_VENDOR_RSRVD_START = 224, 208 SFF_8436_VENDOR_RSRVD_END = 255, 209 };