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 */
70enum {
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 */
125enum {
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};
210