1 /*
2  *  QLogic FCoE Offload Driver
3  *  Copyright (c) 2016-2018 Cavium Inc.
4  *
5  *  This software is available under the terms of the GNU General Public License
6  *  (GPL) Version 2, available from the file COPYING in the main directory of
7  *  this source tree.
8  */
9 #ifndef __QEDF_HSI__
10 #define __QEDF_HSI__
11 /*
12  * Add include to common target
13  */
14 #include <linux/qed/common_hsi.h>
15 
16 /*
17  * Add include to common storage target
18  */
19 #include <linux/qed/storage_common.h>
20 
21 /*
22  * Add include to common fcoe target for both eCore and protocol driver
23  */
24 #include <linux/qed/fcoe_common.h>
25 
26 
27 /*
28  * FCoE CQ element ABTS information
29  */
30 struct fcoe_abts_info {
31 	u8 r_ctl /* R_CTL in the ABTS response frame */;
32 	u8 reserved0;
33 	__le16 rx_id;
34 	__le32 reserved2[2];
35 	__le32 fc_payload[3] /* ABTS FC payload response frame */;
36 };
37 
38 
39 /*
40  * FCoE class type
41  */
42 enum fcoe_class_type {
43 	FCOE_TASK_CLASS_TYPE_3,
44 	FCOE_TASK_CLASS_TYPE_2,
45 	MAX_FCOE_CLASS_TYPE
46 };
47 
48 
49 /*
50  * FCoE CMDQ element control information
51  */
52 struct fcoe_cmdqe_control {
53 	__le16 conn_id;
54 	u8 num_additional_cmdqes;
55 	u8 cmdType;
56 	/* true for ABTS request cmdqe. used in Target mode */
57 #define FCOE_CMDQE_CONTROL_ABTSREQCMD_MASK  0x1
58 #define FCOE_CMDQE_CONTROL_ABTSREQCMD_SHIFT 0
59 #define FCOE_CMDQE_CONTROL_RESERVED1_MASK   0x7F
60 #define FCOE_CMDQE_CONTROL_RESERVED1_SHIFT  1
61 	u8 reserved2[4];
62 };
63 
64 /*
65  * FCoE control + payload CMDQ element
66  */
67 struct fcoe_cmdqe {
68 	struct fcoe_cmdqe_control hdr;
69 	u8 fc_header[24];
70 	__le32 fcp_cmd_payload[8];
71 };
72 
73 
74 
75 /*
76  * FCP RSP flags
77  */
78 struct fcoe_fcp_rsp_flags {
79 	u8 flags;
80 #define FCOE_FCP_RSP_FLAGS_FCP_RSP_LEN_VALID_MASK  0x1
81 #define FCOE_FCP_RSP_FLAGS_FCP_RSP_LEN_VALID_SHIFT 0
82 #define FCOE_FCP_RSP_FLAGS_FCP_SNS_LEN_VALID_MASK  0x1
83 #define FCOE_FCP_RSP_FLAGS_FCP_SNS_LEN_VALID_SHIFT 1
84 #define FCOE_FCP_RSP_FLAGS_FCP_RESID_OVER_MASK     0x1
85 #define FCOE_FCP_RSP_FLAGS_FCP_RESID_OVER_SHIFT    2
86 #define FCOE_FCP_RSP_FLAGS_FCP_RESID_UNDER_MASK    0x1
87 #define FCOE_FCP_RSP_FLAGS_FCP_RESID_UNDER_SHIFT   3
88 #define FCOE_FCP_RSP_FLAGS_FCP_CONF_REQ_MASK       0x1
89 #define FCOE_FCP_RSP_FLAGS_FCP_CONF_REQ_SHIFT      4
90 #define FCOE_FCP_RSP_FLAGS_FCP_BIDI_FLAGS_MASK     0x7
91 #define FCOE_FCP_RSP_FLAGS_FCP_BIDI_FLAGS_SHIFT    5
92 };
93 
94 /*
95  * FCoE CQ element response information
96  */
97 struct fcoe_cqe_rsp_info {
98 	struct fcoe_fcp_rsp_flags rsp_flags;
99 	u8 scsi_status_code;
100 	__le16 retry_delay_timer;
101 	__le32 fcp_resid;
102 	__le32 fcp_sns_len;
103 	__le32 fcp_rsp_len;
104 	__le16 rx_id;
105 	u8 fw_error_flags;
106 #define FCOE_CQE_RSP_INFO_FW_UNDERRUN_MASK  0x1 /* FW detected underrun */
107 #define FCOE_CQE_RSP_INFO_FW_UNDERRUN_SHIFT 0
108 #define FCOE_CQE_RSP_INFO_RESREVED_MASK     0x7F
109 #define FCOE_CQE_RSP_INFO_RESREVED_SHIFT    1
110 	u8 reserved;
111 	__le32 fw_residual /* Residual bytes calculated by FW */;
112 };
113 
114 /*
115  * FCoE CQ element Target completion information
116  */
117 struct fcoe_cqe_target_info {
118 	__le16 rx_id;
119 	__le16 reserved0;
120 	__le32 reserved1[5];
121 };
122 
123 /*
124  * FCoE error/warning reporting entry
125  */
126 struct fcoe_err_report_entry {
127 	__le32 err_warn_bitmap_lo /* Error bitmap lower 32 bits */;
128 	__le32 err_warn_bitmap_hi /* Error bitmap higher 32 bits */;
129 	/* Buffer offset the beginning of the Sequence last transmitted */
130 	__le32 tx_buf_off;
131 	/* Buffer offset from the beginning of the Sequence last received */
132 	__le32 rx_buf_off;
133 	__le16 rx_id /* RX_ID of the associated task */;
134 	__le16 reserved1;
135 	__le32 reserved2;
136 };
137 
138 /*
139  * FCoE CQ element middle path information
140  */
141 struct fcoe_cqe_midpath_info {
142 	__le32 data_placement_size;
143 	__le16 rx_id;
144 	__le16 reserved0;
145 	__le32 reserved1[4];
146 };
147 
148 /*
149  * FCoE CQ element unsolicited information
150  */
151 struct fcoe_unsolic_info {
152 	/* BD information: Physical address and opaque data */
153 	struct scsi_bd bd_info;
154 	__le16 conn_id /* Connection ID the frame is associated to */;
155 	__le16 pkt_len /* Packet length */;
156 	u8 reserved1[4];
157 };
158 
159 /*
160  * FCoE warning reporting entry
161  */
162 struct fcoe_warning_report_entry {
163 	/* BD information: Physical address and opaque data */
164 	struct scsi_bd bd_info;
165 	/* Buffer offset the beginning of the Sequence last transmitted */
166 	__le32 buf_off;
167 	__le16 rx_id /* RX_ID of the associated task */;
168 	__le16 reserved1;
169 };
170 
171 /*
172  * FCoE CQ element information
173  */
174 union fcoe_cqe_info {
175 	struct fcoe_cqe_rsp_info rsp_info /* Response completion information */;
176 	/* Target completion information */
177 	struct fcoe_cqe_target_info target_info;
178 	/* Error completion information */
179 	struct fcoe_err_report_entry err_info;
180 	struct fcoe_abts_info abts_info /* ABTS completion information */;
181 	/* Middle path completion information */
182 	struct fcoe_cqe_midpath_info midpath_info;
183 	/* Unsolicited packet completion information */
184 	struct fcoe_unsolic_info unsolic_info;
185 	/* Warning completion information (Rec Tov expiration) */
186 	struct fcoe_warning_report_entry warn_info;
187 };
188 
189 /*
190  * FCoE CQ element
191  */
192 struct fcoe_cqe {
193 	__le32 cqe_data;
194 	/* The task identifier (OX_ID) to be completed */
195 #define FCOE_CQE_TASK_ID_MASK    0xFFFF
196 #define FCOE_CQE_TASK_ID_SHIFT   0
197 	/*
198 	 * The CQE type: 0x0 Indicating on a pending work request completion.
199 	 * 0x1 - Indicating on an unsolicited event notification. use enum
200 	 * fcoe_cqe_type  (use enum fcoe_cqe_type)
201 	 */
202 #define FCOE_CQE_CQE_TYPE_MASK   0xF
203 #define FCOE_CQE_CQE_TYPE_SHIFT  16
204 #define FCOE_CQE_RESERVED0_MASK  0xFFF
205 #define FCOE_CQE_RESERVED0_SHIFT 20
206 	__le16 reserved1;
207 	__le16 fw_cq_prod;
208 	union fcoe_cqe_info cqe_info;
209 };
210 
211 /*
212  * FCoE CQE type
213  */
214 enum fcoe_cqe_type {
215 	/* solicited response on a R/W or middle-path SQE */
216 	FCOE_GOOD_COMPLETION_CQE_TYPE,
217 	FCOE_UNSOLIC_CQE_TYPE /* unsolicited packet, RQ consumed */,
218 	FCOE_ERROR_DETECTION_CQE_TYPE /* timer expiration, validation error */,
219 	FCOE_WARNING_CQE_TYPE /* rec_tov or rr_tov timer expiration */,
220 	FCOE_EXCH_CLEANUP_CQE_TYPE /* task cleanup completed */,
221 	FCOE_ABTS_CQE_TYPE /* ABTS received and task cleaned */,
222 	FCOE_DUMMY_CQE_TYPE /* just increment SQ CONS */,
223 	/* Task was completed wight after sending a pkt to the target */
224 	FCOE_LOCAL_COMP_CQE_TYPE,
225 	MAX_FCOE_CQE_TYPE
226 };
227 
228 /*
229  * FCoE fast path error codes
230  */
231 enum fcoe_fp_error_warning_code {
232 	FCOE_ERROR_CODE_XFER_OOO_RO /* XFER error codes */,
233 	FCOE_ERROR_CODE_XFER_RO_NOT_ALIGNED,
234 	FCOE_ERROR_CODE_XFER_NULL_BURST_LEN,
235 	FCOE_ERROR_CODE_XFER_RO_GREATER_THAN_DATA2TRNS,
236 	FCOE_ERROR_CODE_XFER_INVALID_PAYLOAD_SIZE,
237 	FCOE_ERROR_CODE_XFER_TASK_TYPE_NOT_WRITE,
238 	FCOE_ERROR_CODE_XFER_PEND_XFER_SET,
239 	FCOE_ERROR_CODE_XFER_OPENED_SEQ,
240 	FCOE_ERROR_CODE_XFER_FCTL,
241 	FCOE_ERROR_CODE_FCP_RSP_BIDI_FLAGS_SET /* FCP RSP error codes */,
242 	FCOE_ERROR_CODE_FCP_RSP_INVALID_LENGTH_FIELD,
243 	FCOE_ERROR_CODE_FCP_RSP_INVALID_SNS_FIELD,
244 	FCOE_ERROR_CODE_FCP_RSP_INVALID_PAYLOAD_SIZE,
245 	FCOE_ERROR_CODE_FCP_RSP_PEND_XFER_SET,
246 	FCOE_ERROR_CODE_FCP_RSP_OPENED_SEQ,
247 	FCOE_ERROR_CODE_FCP_RSP_FCTL,
248 	FCOE_ERROR_CODE_FCP_RSP_LAST_SEQ_RESET,
249 	FCOE_ERROR_CODE_FCP_RSP_CONF_REQ_NOT_SUPPORTED_YET,
250 	FCOE_ERROR_CODE_DATA_OOO_RO /* FCP DATA error codes */,
251 	FCOE_ERROR_CODE_DATA_EXCEEDS_DEFINED_MAX_FRAME_SIZE,
252 	FCOE_ERROR_CODE_DATA_EXCEEDS_DATA2TRNS,
253 	FCOE_ERROR_CODE_DATA_SOFI3_SEQ_ACTIVE_SET,
254 	FCOE_ERROR_CODE_DATA_SOFN_SEQ_ACTIVE_RESET,
255 	FCOE_ERROR_CODE_DATA_EOFN_END_SEQ_SET,
256 	FCOE_ERROR_CODE_DATA_EOFT_END_SEQ_RESET,
257 	FCOE_ERROR_CODE_DATA_TASK_TYPE_NOT_READ,
258 	FCOE_ERROR_CODE_DATA_FCTL_INITIATIR,
259 	FCOE_ERROR_CODE_MIDPATH_INVALID_TYPE /* Middle path error codes */,
260 	FCOE_ERROR_CODE_MIDPATH_SOFI3_SEQ_ACTIVE_SET,
261 	FCOE_ERROR_CODE_MIDPATH_SOFN_SEQ_ACTIVE_RESET,
262 	FCOE_ERROR_CODE_MIDPATH_EOFN_END_SEQ_SET,
263 	FCOE_ERROR_CODE_MIDPATH_EOFT_END_SEQ_RESET,
264 	FCOE_ERROR_CODE_MIDPATH_REPLY_FCTL,
265 	FCOE_ERROR_CODE_MIDPATH_INVALID_REPLY,
266 	FCOE_ERROR_CODE_MIDPATH_ELS_REPLY_RCTL,
267 	FCOE_ERROR_CODE_COMMON_MIDDLE_FRAME_WITH_PAD /* Common error codes */,
268 	FCOE_ERROR_CODE_COMMON_SEQ_INIT_IN_TCE,
269 	FCOE_ERROR_CODE_COMMON_FC_HDR_RX_ID_MISMATCH,
270 	FCOE_ERROR_CODE_COMMON_INCORRECT_SEQ_CNT,
271 	FCOE_ERROR_CODE_COMMON_DATA_FC_HDR_FCP_TYPE_MISMATCH,
272 	FCOE_ERROR_CODE_COMMON_DATA_NO_MORE_SGES,
273 	FCOE_ERROR_CODE_COMMON_OPTIONAL_FC_HDR,
274 	FCOE_ERROR_CODE_COMMON_READ_TCE_OX_ID_TOO_BIG,
275 	FCOE_ERROR_CODE_COMMON_DATA_WAS_NOT_TRANSMITTED,
276 	FCOE_ERROR_CODE_COMMON_TASK_DDF_RCTL_INFO_FIELD,
277 	FCOE_ERROR_CODE_COMMON_TASK_INVALID_RCTL,
278 	FCOE_ERROR_CODE_COMMON_TASK_RCTL_GENERAL_MISMATCH,
279 	FCOE_ERROR_CODE_E_D_TOV_TIMER_EXPIRATION /* Timer error codes */,
280 	FCOE_WARNING_CODE_REC_TOV_TIMER_EXPIRATION /* Timer error codes */,
281 	FCOE_ERROR_CODE_RR_TOV_TIMER_EXPIRATION /* Timer error codes */,
282 	/* ABTSrsp pckt arrived unexpected */
283 	FCOE_ERROR_CODE_ABTS_REPLY_UNEXPECTED,
284 	FCOE_ERROR_CODE_TARGET_MODE_FCP_RSP,
285 	FCOE_ERROR_CODE_TARGET_MODE_FCP_XFER,
286 	FCOE_ERROR_CODE_TARGET_MODE_DATA_TASK_TYPE_NOT_WRITE,
287 	FCOE_ERROR_CODE_DATA_FCTL_TARGET,
288 	FCOE_ERROR_CODE_TARGET_DATA_SIZE_NO_MATCH_XFER,
289 	FCOE_ERROR_CODE_TARGET_DIF_CRC_CHECKSUM_ERROR,
290 	FCOE_ERROR_CODE_TARGET_DIF_REF_TAG_ERROR,
291 	FCOE_ERROR_CODE_TARGET_DIF_APP_TAG_ERROR,
292 	MAX_FCOE_FP_ERROR_WARNING_CODE
293 };
294 
295 
296 /*
297  * FCoE RESPQ element
298  */
299 struct fcoe_respqe {
300 	__le16 ox_id /* OX_ID that is located in the FCP_RSP FC header */;
301 	__le16 rx_id /* RX_ID that is located in the FCP_RSP FC header */;
302 	__le32 additional_info;
303 /* PARAM that is located in the FCP_RSP FC header */
304 #define FCOE_RESPQE_PARAM_MASK            0xFFFFFF
305 #define FCOE_RESPQE_PARAM_SHIFT           0
306 /* Indication whther its Target-auto-rsp mode or not */
307 #define FCOE_RESPQE_TARGET_AUTO_RSP_MASK  0xFF
308 #define FCOE_RESPQE_TARGET_AUTO_RSP_SHIFT 24
309 };
310 
311 
312 /*
313  * FCoE slow path error codes
314  */
315 enum fcoe_sp_error_code {
316 	/* Error codes for Error Reporting in slow path flows */
317 	FCOE_ERROR_CODE_SLOW_PATH_TOO_MANY_FUNCS,
318 	FCOE_ERROR_SLOW_PATH_CODE_NO_LICENSE,
319 	MAX_FCOE_SP_ERROR_CODE
320 };
321 
322 /*
323  * FCoE task TX state
324  */
325 enum fcoe_task_tx_state {
326 	/* Initiate state after driver has initialized the task */
327 	FCOE_TASK_TX_STATE_NORMAL,
328 	/* Updated by TX path after complete transmitting unsolicited packet */
329 	FCOE_TASK_TX_STATE_UNSOLICITED_COMPLETED,
330 	/*
331 	 * Updated by TX path after start processing the task requesting the
332 	 * cleanup/abort operation
333 	 */
334 	FCOE_TASK_TX_STATE_CLEAN_REQ,
335 	FCOE_TASK_TX_STATE_ABTS /* Updated by TX path during abort procedure */,
336 	/* Updated by TX path during exchange cleanup procedure */
337 	FCOE_TASK_TX_STATE_EXCLEANUP,
338 	/*
339 	 * Updated by TX path during exchange cleanup continuation task
340 	 * procedure
341 	 */
342 	FCOE_TASK_TX_STATE_EXCLEANUP_TARGET_WRITE_CONT,
343 	/* Updated by TX path during exchange cleanup first xfer procedure */
344 	FCOE_TASK_TX_STATE_EXCLEANUP_TARGET_WRITE,
345 	/* Updated by TX path during exchange cleanup read task in Target */
346 	FCOE_TASK_TX_STATE_EXCLEANUP_TARGET_READ_OR_RSP,
347 	/* Updated by TX path during target exchange cleanup procedure */
348 	FCOE_TASK_TX_STATE_EXCLEANUP_TARGET_WRITE_LAST_CYCLE,
349 	/* Updated by TX path during sequence recovery procedure */
350 	FCOE_TASK_TX_STATE_SEQRECOVERY,
351 	MAX_FCOE_TASK_TX_STATE
352 };
353 
354 #endif /* __QEDF_HSI__ */
355