qedf_hsi.h 10 KB

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