be_main.h 28 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030
  1. /* SPDX-License-Identifier: GPL-2.0-only */
  2. /*
  3. * Copyright 2017 Broadcom. All Rights Reserved.
  4. * The term "Broadcom" refers to Broadcom Limited and/or its subsidiaries.
  5. *
  6. * Contact Information:
  7. * [email protected]
  8. */
  9. #ifndef _BEISCSI_MAIN_
  10. #define _BEISCSI_MAIN_
  11. #include <linux/kernel.h>
  12. #include <linux/pci.h>
  13. #include <linux/if_ether.h>
  14. #include <linux/in.h>
  15. #include <linux/ctype.h>
  16. #include <linux/module.h>
  17. #include <linux/aer.h>
  18. #include <scsi/scsi.h>
  19. #include <scsi/scsi_cmnd.h>
  20. #include <scsi/scsi_device.h>
  21. #include <scsi/scsi_host.h>
  22. #include <scsi/iscsi_proto.h>
  23. #include <scsi/libiscsi.h>
  24. #include <scsi/scsi_transport_iscsi.h>
  25. #define DRV_NAME "be2iscsi"
  26. #define BUILD_STR "11.4.0.1"
  27. #define BE_NAME "Emulex OneConnect" \
  28. "Open-iSCSI Driver version" BUILD_STR
  29. #define DRV_DESC BE_NAME " " "Driver"
  30. #define BE_VENDOR_ID 0x19A2
  31. #define ELX_VENDOR_ID 0x10DF
  32. /* DEVICE ID's for BE2 */
  33. #define BE_DEVICE_ID1 0x212
  34. #define OC_DEVICE_ID1 0x702
  35. #define OC_DEVICE_ID2 0x703
  36. /* DEVICE ID's for BE3 */
  37. #define BE_DEVICE_ID2 0x222
  38. #define OC_DEVICE_ID3 0x712
  39. /* DEVICE ID for SKH */
  40. #define OC_SKH_ID1 0x722
  41. #define BE2_IO_DEPTH 1024
  42. #define BE2_MAX_SESSIONS 256
  43. #define BE2_TMFS 16
  44. #define BE2_NOPOUT_REQ 16
  45. #define BE2_SGE 32
  46. #define BE2_DEFPDU_HDR_SZ 64
  47. #define BE2_DEFPDU_DATA_SZ 8192
  48. #define BE2_MAX_NUM_CQ_PROC 512
  49. #define MAX_CPUS 64U
  50. #define BEISCSI_MAX_NUM_CPUS 7
  51. #define BEISCSI_VER_STRLEN 32
  52. #define BEISCSI_SGLIST_ELEMENTS 30
  53. /**
  54. * BE_INVLDT_CMD_TBL_SZ is 128 which is total number commands that can
  55. * be invalidated at a time, consider it before changing the value of
  56. * BEISCSI_CMD_PER_LUN.
  57. */
  58. #define BEISCSI_CMD_PER_LUN 128 /* scsi_host->cmd_per_lun */
  59. #define BEISCSI_MAX_SECTORS 1024 /* scsi_host->max_sectors */
  60. #define BEISCSI_TEMPLATE_HDR_PER_CXN_SIZE 128 /* Template size per cxn */
  61. #define BEISCSI_MAX_CMD_LEN 16 /* scsi_host->max_cmd_len */
  62. #define BEISCSI_NUM_MAX_LUN 256 /* scsi_host->max_lun */
  63. #define BEISCSI_MAX_FRAGS_INIT 192
  64. #define BE_SENSE_INFO_SIZE 258
  65. #define BE_ISCSI_PDU_HEADER_SIZE 64
  66. #define BE_MIN_MEM_SIZE 16384
  67. #define MAX_CMD_SZ 65536
  68. #define IIOC_SCSI_DATA 0x05 /* Write Operation */
  69. /**
  70. * hardware needs the async PDU buffers to be posted in multiples of 8
  71. * So have atleast 8 of them by default
  72. */
  73. #define HWI_GET_ASYNC_PDU_CTX(phwi, ulp_num) \
  74. (phwi->phwi_ctxt->pasync_ctx[ulp_num])
  75. /********* Memory BAR register ************/
  76. #define PCICFG_MEMBAR_CTRL_INT_CTRL_OFFSET 0xfc
  77. /**
  78. * Host Interrupt Enable, if set interrupts are enabled although "PCI Interrupt
  79. * Disable" may still globally block interrupts in addition to individual
  80. * interrupt masks; a mechanism for the device driver to block all interrupts
  81. * atomically without having to arbitrate for the PCI Interrupt Disable bit
  82. * with the OS.
  83. */
  84. #define MEMBAR_CTRL_INT_CTRL_HOSTINTR_MASK (1 << 29) /* bit 29 */
  85. /********* ISR0 Register offset **********/
  86. #define CEV_ISR0_OFFSET 0xC18
  87. #define CEV_ISR_SIZE 4
  88. /**
  89. * Macros for reading/writing a protection domain or CSR registers
  90. * in BladeEngine.
  91. */
  92. #define DB_TXULP0_OFFSET 0x40
  93. #define DB_RXULP0_OFFSET 0xA0
  94. /********* Event Q door bell *************/
  95. #define DB_EQ_OFFSET DB_CQ_OFFSET
  96. #define DB_EQ_RING_ID_LOW_MASK 0x1FF /* bits 0 - 8 */
  97. /* Clear the interrupt for this eq */
  98. #define DB_EQ_CLR_SHIFT (9) /* bit 9 */
  99. /* Must be 1 */
  100. #define DB_EQ_EVNT_SHIFT (10) /* bit 10 */
  101. /* Higher Order EQ_ID bit */
  102. #define DB_EQ_RING_ID_HIGH_MASK 0x1F /* bits 11 - 15 */
  103. #define DB_EQ_HIGH_SET_SHIFT 11
  104. #define DB_EQ_HIGH_FEILD_SHIFT 9
  105. /* Number of event entries processed */
  106. #define DB_EQ_NUM_POPPED_SHIFT (16) /* bits 16 - 28 */
  107. /* Rearm bit */
  108. #define DB_EQ_REARM_SHIFT (29) /* bit 29 */
  109. /********* Compl Q door bell *************/
  110. #define DB_CQ_OFFSET 0x120
  111. #define DB_CQ_RING_ID_LOW_MASK 0x3FF /* bits 0 - 9 */
  112. /* Higher Order CQ_ID bit */
  113. #define DB_CQ_RING_ID_HIGH_MASK 0x1F /* bits 11 - 15 */
  114. #define DB_CQ_HIGH_SET_SHIFT 11
  115. #define DB_CQ_HIGH_FEILD_SHIFT 10
  116. /* Number of event entries processed */
  117. #define DB_CQ_NUM_POPPED_SHIFT (16) /* bits 16 - 28 */
  118. /* Rearm bit */
  119. #define DB_CQ_REARM_SHIFT (29) /* bit 29 */
  120. #define GET_HWI_CONTROLLER_WS(pc) (pc->phwi_ctrlr)
  121. #define HWI_GET_DEF_BUFQ_ID(pc, ulp_num) (((struct hwi_controller *)\
  122. (GET_HWI_CONTROLLER_WS(pc)))->default_pdu_data[ulp_num].id)
  123. #define HWI_GET_DEF_HDRQ_ID(pc, ulp_num) (((struct hwi_controller *)\
  124. (GET_HWI_CONTROLLER_WS(pc)))->default_pdu_hdr[ulp_num].id)
  125. #define PAGES_REQUIRED(x) \
  126. ((x < PAGE_SIZE) ? 1 : ((x + PAGE_SIZE - 1) / PAGE_SIZE))
  127. #define MEM_DESCR_OFFSET 8
  128. #define BEISCSI_DEFQ_HDR 1
  129. #define BEISCSI_DEFQ_DATA 0
  130. enum be_mem_enum {
  131. HWI_MEM_ADDN_CONTEXT,
  132. HWI_MEM_WRB,
  133. HWI_MEM_WRBH,
  134. HWI_MEM_SGLH,
  135. HWI_MEM_SGE,
  136. HWI_MEM_TEMPLATE_HDR_ULP0,
  137. HWI_MEM_ASYNC_HEADER_BUF_ULP0, /* 6 */
  138. HWI_MEM_ASYNC_DATA_BUF_ULP0,
  139. HWI_MEM_ASYNC_HEADER_RING_ULP0,
  140. HWI_MEM_ASYNC_DATA_RING_ULP0,
  141. HWI_MEM_ASYNC_HEADER_HANDLE_ULP0,
  142. HWI_MEM_ASYNC_DATA_HANDLE_ULP0, /* 11 */
  143. HWI_MEM_ASYNC_PDU_CONTEXT_ULP0,
  144. HWI_MEM_TEMPLATE_HDR_ULP1,
  145. HWI_MEM_ASYNC_HEADER_BUF_ULP1, /* 14 */
  146. HWI_MEM_ASYNC_DATA_BUF_ULP1,
  147. HWI_MEM_ASYNC_HEADER_RING_ULP1,
  148. HWI_MEM_ASYNC_DATA_RING_ULP1,
  149. HWI_MEM_ASYNC_HEADER_HANDLE_ULP1,
  150. HWI_MEM_ASYNC_DATA_HANDLE_ULP1, /* 19 */
  151. HWI_MEM_ASYNC_PDU_CONTEXT_ULP1,
  152. ISCSI_MEM_GLOBAL_HEADER,
  153. SE_MEM_MAX
  154. };
  155. struct be_bus_address32 {
  156. unsigned int address_lo;
  157. unsigned int address_hi;
  158. };
  159. struct be_bus_address64 {
  160. unsigned long long address;
  161. };
  162. struct be_bus_address {
  163. union {
  164. struct be_bus_address32 a32;
  165. struct be_bus_address64 a64;
  166. } u;
  167. };
  168. struct mem_array {
  169. struct be_bus_address bus_address; /* Bus address of location */
  170. void *virtual_address; /* virtual address to the location */
  171. unsigned int size; /* Size required by memory block */
  172. };
  173. struct be_mem_descriptor {
  174. unsigned int size_in_bytes; /* Size required by memory block */
  175. unsigned int num_elements;
  176. struct mem_array *mem_array;
  177. };
  178. struct sgl_handle {
  179. unsigned int sgl_index;
  180. unsigned int type;
  181. unsigned int cid;
  182. struct iscsi_task *task;
  183. struct iscsi_sge *pfrag;
  184. };
  185. struct hba_parameters {
  186. unsigned int ios_per_ctrl;
  187. unsigned int cxns_per_ctrl;
  188. unsigned int icds_per_ctrl;
  189. unsigned int num_sge_per_io;
  190. unsigned int defpdu_hdr_sz;
  191. unsigned int defpdu_data_sz;
  192. unsigned int num_cq_entries;
  193. unsigned int num_eq_entries;
  194. unsigned int wrbs_per_cxn;
  195. unsigned int hwi_ws_sz;
  196. };
  197. #define BEISCSI_GET_ULP_FROM_CRI(phwi_ctrlr, cri) \
  198. (phwi_ctrlr->wrb_context[cri].ulp_num)
  199. struct hwi_wrb_context {
  200. spinlock_t wrb_lock;
  201. struct wrb_handle **pwrb_handle_base;
  202. struct wrb_handle **pwrb_handle_basestd;
  203. struct iscsi_wrb *plast_wrb;
  204. unsigned short alloc_index;
  205. unsigned short free_index;
  206. unsigned short wrb_handles_available;
  207. unsigned short cid;
  208. uint8_t ulp_num; /* ULP to which CID binded */
  209. uint32_t doorbell_offset;
  210. };
  211. struct ulp_cid_info {
  212. unsigned short *cid_array;
  213. unsigned short avlbl_cids;
  214. unsigned short cid_alloc;
  215. unsigned short cid_free;
  216. };
  217. #include "be.h"
  218. #define chip_be2(phba) (phba->generation == BE_GEN2)
  219. #define chip_be3_r(phba) (phba->generation == BE_GEN3)
  220. #define is_chip_be2_be3r(phba) (chip_be3_r(phba) || (chip_be2(phba)))
  221. #define BEISCSI_ULP0 0
  222. #define BEISCSI_ULP1 1
  223. #define BEISCSI_ULP_COUNT 2
  224. #define BEISCSI_ULP0_LOADED 0x01
  225. #define BEISCSI_ULP1_LOADED 0x02
  226. #define BEISCSI_ULP_AVLBL_CID(phba, ulp_num) \
  227. (((struct ulp_cid_info *)phba->cid_array_info[ulp_num])->avlbl_cids)
  228. #define BEISCSI_ULP0_AVLBL_CID(phba) \
  229. BEISCSI_ULP_AVLBL_CID(phba, BEISCSI_ULP0)
  230. #define BEISCSI_ULP1_AVLBL_CID(phba) \
  231. BEISCSI_ULP_AVLBL_CID(phba, BEISCSI_ULP1)
  232. struct beiscsi_hba {
  233. struct hba_parameters params;
  234. struct hwi_controller *phwi_ctrlr;
  235. unsigned int mem_req[SE_MEM_MAX];
  236. /* PCI BAR mapped addresses */
  237. u8 __iomem *csr_va; /* CSR */
  238. u8 __iomem *db_va; /* Door Bell */
  239. u8 __iomem *pci_va; /* PCI Config */
  240. /* PCI representation of our HBA */
  241. struct pci_dev *pcidev;
  242. unsigned int num_cpus;
  243. unsigned int nxt_cqid;
  244. char *msi_name[MAX_CPUS];
  245. struct be_mem_descriptor *init_mem;
  246. unsigned short io_sgl_alloc_index;
  247. unsigned short io_sgl_free_index;
  248. unsigned short io_sgl_hndl_avbl;
  249. struct sgl_handle **io_sgl_hndl_base;
  250. unsigned short eh_sgl_alloc_index;
  251. unsigned short eh_sgl_free_index;
  252. unsigned short eh_sgl_hndl_avbl;
  253. struct sgl_handle **eh_sgl_hndl_base;
  254. spinlock_t io_sgl_lock;
  255. spinlock_t mgmt_sgl_lock;
  256. spinlock_t async_pdu_lock;
  257. struct list_head hba_queue;
  258. #define BE_MAX_SESSION 2048
  259. #define BE_INVALID_CID 0xffff
  260. #define BE_SET_CID_TO_CRI(cri_index, cid) \
  261. (phba->cid_to_cri_map[cid] = cri_index)
  262. #define BE_GET_CRI_FROM_CID(cid) (phba->cid_to_cri_map[cid])
  263. unsigned short cid_to_cri_map[BE_MAX_SESSION];
  264. struct ulp_cid_info *cid_array_info[BEISCSI_ULP_COUNT];
  265. struct iscsi_endpoint **ep_array;
  266. struct beiscsi_conn **conn_table;
  267. struct Scsi_Host *shost;
  268. struct iscsi_iface *ipv4_iface;
  269. struct iscsi_iface *ipv6_iface;
  270. struct {
  271. /**
  272. * group together since they are used most frequently
  273. * for cid to cri conversion
  274. */
  275. #define BEISCSI_PHYS_PORT_MAX 4
  276. unsigned int phys_port;
  277. /* valid values of phys_port id are 0, 1, 2, 3 */
  278. unsigned int eqid_count;
  279. unsigned int cqid_count;
  280. unsigned int iscsi_cid_start[BEISCSI_ULP_COUNT];
  281. #define BEISCSI_GET_CID_COUNT(phba, ulp_num) \
  282. (phba->fw_config.iscsi_cid_count[ulp_num])
  283. unsigned int iscsi_cid_count[BEISCSI_ULP_COUNT];
  284. unsigned int iscsi_icd_count[BEISCSI_ULP_COUNT];
  285. unsigned int iscsi_icd_start[BEISCSI_ULP_COUNT];
  286. unsigned int iscsi_chain_start[BEISCSI_ULP_COUNT];
  287. unsigned int iscsi_chain_count[BEISCSI_ULP_COUNT];
  288. unsigned short iscsi_features;
  289. uint16_t dual_ulp_aware;
  290. unsigned long ulp_supported;
  291. } fw_config;
  292. unsigned long state;
  293. #define BEISCSI_HBA_ONLINE 0
  294. #define BEISCSI_HBA_LINK_UP 1
  295. #define BEISCSI_HBA_BOOT_FOUND 2
  296. #define BEISCSI_HBA_BOOT_WORK 3
  297. #define BEISCSI_HBA_UER_SUPP 4
  298. #define BEISCSI_HBA_PCI_ERR 5
  299. #define BEISCSI_HBA_FW_TIMEOUT 6
  300. #define BEISCSI_HBA_IN_UE 7
  301. #define BEISCSI_HBA_IN_TPE 8
  302. /* error bits */
  303. #define BEISCSI_HBA_IN_ERR ((1 << BEISCSI_HBA_PCI_ERR) | \
  304. (1 << BEISCSI_HBA_FW_TIMEOUT) | \
  305. (1 << BEISCSI_HBA_IN_UE) | \
  306. (1 << BEISCSI_HBA_IN_TPE))
  307. u8 optic_state;
  308. struct delayed_work eqd_update;
  309. /* update EQ delay timer every 1000ms */
  310. #define BEISCSI_EQD_UPDATE_INTERVAL 1000
  311. struct timer_list hw_check;
  312. /* check for UE every 1000ms */
  313. #define BEISCSI_UE_DETECT_INTERVAL 1000
  314. u32 ue2rp;
  315. struct delayed_work recover_port;
  316. struct work_struct sess_work;
  317. bool mac_addr_set;
  318. u8 mac_address[ETH_ALEN];
  319. u8 port_name;
  320. u8 port_speed;
  321. char fw_ver_str[BEISCSI_VER_STRLEN];
  322. struct workqueue_struct *wq; /* The actuak work queue */
  323. struct be_ctrl_info ctrl;
  324. unsigned int generation;
  325. unsigned int interface_handle;
  326. struct be_aic_obj aic_obj[MAX_CPUS];
  327. unsigned int attr_log_enable;
  328. int (*iotask_fn)(struct iscsi_task *,
  329. struct scatterlist *sg,
  330. uint32_t num_sg, uint32_t xferlen,
  331. uint32_t writedir);
  332. struct boot_struct {
  333. int retry;
  334. unsigned int tag;
  335. unsigned int s_handle;
  336. struct be_dma_mem nonemb_cmd;
  337. enum {
  338. BEISCSI_BOOT_REOPEN_SESS = 1,
  339. BEISCSI_BOOT_GET_SHANDLE,
  340. BEISCSI_BOOT_GET_SINFO,
  341. BEISCSI_BOOT_LOGOUT_SESS,
  342. BEISCSI_BOOT_CREATE_KSET,
  343. } action;
  344. struct mgmt_session_info boot_sess;
  345. struct iscsi_boot_kset *boot_kset;
  346. } boot_struct;
  347. struct work_struct boot_work;
  348. };
  349. #define beiscsi_hba_in_error(phba) ((phba)->state & BEISCSI_HBA_IN_ERR)
  350. #define beiscsi_hba_is_online(phba) \
  351. (!beiscsi_hba_in_error((phba)) && \
  352. test_bit(BEISCSI_HBA_ONLINE, &phba->state))
  353. struct beiscsi_session {
  354. struct dma_pool *bhs_pool;
  355. };
  356. /**
  357. * struct beiscsi_conn - iscsi connection structure
  358. */
  359. struct beiscsi_conn {
  360. struct iscsi_conn *conn;
  361. struct beiscsi_hba *phba;
  362. u32 exp_statsn;
  363. u32 doorbell_offset;
  364. u32 beiscsi_conn_cid;
  365. struct beiscsi_endpoint *ep;
  366. unsigned short login_in_progress;
  367. struct wrb_handle *plogin_wrb_handle;
  368. struct sgl_handle *plogin_sgl_handle;
  369. struct beiscsi_session *beiscsi_sess;
  370. struct iscsi_task *task;
  371. };
  372. /* This structure is used by the chip */
  373. struct pdu_data_out {
  374. u32 dw[12];
  375. };
  376. /**
  377. * Pseudo amap definition in which each bit of the actual structure is defined
  378. * as a byte: used to calculate offset/shift/mask of each field
  379. */
  380. struct amap_pdu_data_out {
  381. u8 opcode[6]; /* opcode */
  382. u8 rsvd0[2]; /* should be 0 */
  383. u8 rsvd1[7];
  384. u8 final_bit; /* F bit */
  385. u8 rsvd2[16];
  386. u8 ahs_length[8]; /* no AHS */
  387. u8 data_len_hi[8];
  388. u8 data_len_lo[16]; /* DataSegmentLength */
  389. u8 lun[64];
  390. u8 itt[32]; /* ITT; initiator task tag */
  391. u8 ttt[32]; /* TTT; valid for R2T or 0xffffffff */
  392. u8 rsvd3[32];
  393. u8 exp_stat_sn[32];
  394. u8 rsvd4[32];
  395. u8 data_sn[32];
  396. u8 buffer_offset[32];
  397. u8 rsvd5[32];
  398. };
  399. struct be_cmd_bhs {
  400. struct iscsi_scsi_req iscsi_hdr;
  401. unsigned char pad1[16];
  402. struct pdu_data_out iscsi_data_pdu;
  403. unsigned char pad2[BE_SENSE_INFO_SIZE -
  404. sizeof(struct pdu_data_out)];
  405. };
  406. struct beiscsi_io_task {
  407. struct wrb_handle *pwrb_handle;
  408. struct sgl_handle *psgl_handle;
  409. struct beiscsi_conn *conn;
  410. struct scsi_cmnd *scsi_cmnd;
  411. int num_sg;
  412. struct hwi_wrb_context *pwrb_context;
  413. itt_t libiscsi_itt;
  414. struct be_cmd_bhs *cmd_bhs;
  415. struct be_bus_address bhs_pa;
  416. unsigned short bhs_len;
  417. dma_addr_t mtask_addr;
  418. uint32_t mtask_data_count;
  419. uint8_t wrb_type;
  420. };
  421. struct be_nonio_bhs {
  422. struct iscsi_hdr iscsi_hdr;
  423. unsigned char pad1[16];
  424. struct pdu_data_out iscsi_data_pdu;
  425. unsigned char pad2[BE_SENSE_INFO_SIZE -
  426. sizeof(struct pdu_data_out)];
  427. };
  428. struct be_status_bhs {
  429. struct iscsi_scsi_req iscsi_hdr;
  430. unsigned char pad1[16];
  431. /**
  432. * The plus 2 below is to hold the sense info length that gets
  433. * DMA'ed by RxULP
  434. */
  435. unsigned char sense_info[BE_SENSE_INFO_SIZE];
  436. };
  437. struct iscsi_sge {
  438. u32 dw[4];
  439. };
  440. /**
  441. * Pseudo amap definition in which each bit of the actual structure is defined
  442. * as a byte: used to calculate offset/shift/mask of each field
  443. */
  444. struct amap_iscsi_sge {
  445. u8 addr_hi[32];
  446. u8 addr_lo[32];
  447. u8 sge_offset[22]; /* DWORD 2 */
  448. u8 rsvd0[9]; /* DWORD 2 */
  449. u8 last_sge; /* DWORD 2 */
  450. u8 len[17]; /* DWORD 3 */
  451. u8 rsvd1[15]; /* DWORD 3 */
  452. };
  453. struct beiscsi_offload_params {
  454. u32 dw[6];
  455. };
  456. #define OFFLD_PARAMS_ERL 0x00000003
  457. #define OFFLD_PARAMS_DDE 0x00000004
  458. #define OFFLD_PARAMS_HDE 0x00000008
  459. #define OFFLD_PARAMS_IR2T 0x00000010
  460. #define OFFLD_PARAMS_IMD 0x00000020
  461. #define OFFLD_PARAMS_DATA_SEQ_INORDER 0x00000040
  462. #define OFFLD_PARAMS_PDU_SEQ_INORDER 0x00000080
  463. #define OFFLD_PARAMS_MAX_R2T 0x00FFFF00
  464. /**
  465. * Pseudo amap definition in which each bit of the actual structure is defined
  466. * as a byte: used to calculate offset/shift/mask of each field
  467. */
  468. struct amap_beiscsi_offload_params {
  469. u8 max_burst_length[32];
  470. u8 max_send_data_segment_length[32];
  471. u8 first_burst_length[32];
  472. u8 erl[2];
  473. u8 dde[1];
  474. u8 hde[1];
  475. u8 ir2t[1];
  476. u8 imd[1];
  477. u8 data_seq_inorder[1];
  478. u8 pdu_seq_inorder[1];
  479. u8 max_r2t[16];
  480. u8 pad[8];
  481. u8 exp_statsn[32];
  482. u8 max_recv_data_segment_length[32];
  483. };
  484. struct hd_async_handle {
  485. struct list_head link;
  486. struct be_bus_address pa;
  487. void *pbuffer;
  488. u32 buffer_len;
  489. u16 index;
  490. u16 cri;
  491. u8 is_header;
  492. u8 is_final;
  493. u8 in_use;
  494. };
  495. #define BEISCSI_ASYNC_HDQ_SIZE(phba, ulp) \
  496. (BEISCSI_GET_CID_COUNT((phba), (ulp)) * 2)
  497. /**
  498. * This has list of async PDUs that are waiting to be processed.
  499. * Buffers live in this list for a brief duration before they get
  500. * processed and posted back to hardware.
  501. * Note that we don't really need one cri_wait_queue per async_entry.
  502. * We need one cri_wait_queue per CRI. Its easier to manage if this
  503. * is tagged along with the async_entry.
  504. */
  505. struct hd_async_entry {
  506. struct cri_wait_queue {
  507. unsigned short hdr_len;
  508. unsigned int bytes_received;
  509. unsigned int bytes_needed;
  510. struct list_head list;
  511. } wq;
  512. /* handles posted to FW resides here */
  513. struct hd_async_handle *header;
  514. struct hd_async_handle *data;
  515. };
  516. struct hd_async_buf_context {
  517. struct be_bus_address pa_base;
  518. void *va_base;
  519. void *ring_base;
  520. struct hd_async_handle *handle_base;
  521. u32 buffer_size;
  522. u16 pi;
  523. };
  524. /**
  525. * hd_async_context is declared for each ULP supporting iSCSI function.
  526. */
  527. struct hd_async_context {
  528. struct hd_async_buf_context async_header;
  529. struct hd_async_buf_context async_data;
  530. u16 num_entries;
  531. /**
  532. * When unsol PDU is in, it needs to be chained till all the bytes are
  533. * received and then processing is done. hd_async_entry is created
  534. * based on the cid_count for each ULP. When unsol PDU comes in based
  535. * on the conn_id it needs to be added to the correct async_entry wq.
  536. * Below defined cid_to_async_cri_map is used to reterive the
  537. * async_cri_map for a particular connection.
  538. *
  539. * This array is initialized after beiscsi_create_wrb_rings returns.
  540. *
  541. * - this method takes more memory space, fixed to 2K
  542. * - any support for connections greater than this the array size needs
  543. * to be incremented
  544. */
  545. #define BE_GET_ASYNC_CRI_FROM_CID(cid) (pasync_ctx->cid_to_async_cri_map[cid])
  546. unsigned short cid_to_async_cri_map[BE_MAX_SESSION];
  547. /**
  548. * This is a variable size array. Don`t add anything after this field!!
  549. */
  550. struct hd_async_entry *async_entry;
  551. };
  552. struct i_t_dpdu_cqe {
  553. u32 dw[4];
  554. } __packed;
  555. /**
  556. * Pseudo amap definition in which each bit of the actual structure is defined
  557. * as a byte: used to calculate offset/shift/mask of each field
  558. */
  559. struct amap_i_t_dpdu_cqe {
  560. u8 db_addr_hi[32];
  561. u8 db_addr_lo[32];
  562. u8 code[6];
  563. u8 cid[10];
  564. u8 dpl[16];
  565. u8 index[16];
  566. u8 num_cons[10];
  567. u8 rsvd0[4];
  568. u8 final;
  569. u8 valid;
  570. } __packed;
  571. struct amap_i_t_dpdu_cqe_v2 {
  572. u8 db_addr_hi[32]; /* DWORD 0 */
  573. u8 db_addr_lo[32]; /* DWORD 1 */
  574. u8 code[6]; /* DWORD 2 */
  575. u8 num_cons; /* DWORD 2*/
  576. u8 rsvd0[8]; /* DWORD 2 */
  577. u8 dpl[17]; /* DWORD 2 */
  578. u8 index[16]; /* DWORD 3 */
  579. u8 cid[13]; /* DWORD 3 */
  580. u8 rsvd1; /* DWORD 3 */
  581. u8 final; /* DWORD 3 */
  582. u8 valid; /* DWORD 3 */
  583. } __packed;
  584. #define CQE_VALID_MASK 0x80000000
  585. #define CQE_CODE_MASK 0x0000003F
  586. #define CQE_CID_MASK 0x0000FFC0
  587. #define EQE_VALID_MASK 0x00000001
  588. #define EQE_MAJORCODE_MASK 0x0000000E
  589. #define EQE_RESID_MASK 0xFFFF0000
  590. struct be_eq_entry {
  591. u32 dw[1];
  592. } __packed;
  593. /**
  594. * Pseudo amap definition in which each bit of the actual structure is defined
  595. * as a byte: used to calculate offset/shift/mask of each field
  596. */
  597. struct amap_eq_entry {
  598. u8 valid; /* DWORD 0 */
  599. u8 major_code[3]; /* DWORD 0 */
  600. u8 minor_code[12]; /* DWORD 0 */
  601. u8 resource_id[16]; /* DWORD 0 */
  602. } __packed;
  603. struct cq_db {
  604. u32 dw[1];
  605. } __packed;
  606. /**
  607. * Pseudo amap definition in which each bit of the actual structure is defined
  608. * as a byte: used to calculate offset/shift/mask of each field
  609. */
  610. struct amap_cq_db {
  611. u8 qid[10];
  612. u8 event[1];
  613. u8 rsvd0[5];
  614. u8 num_popped[13];
  615. u8 rearm[1];
  616. u8 rsvd1[2];
  617. } __packed;
  618. void beiscsi_process_eq(struct beiscsi_hba *phba);
  619. struct iscsi_wrb {
  620. u32 dw[16];
  621. } __packed;
  622. #define WRB_TYPE_MASK 0xF0000000
  623. #define SKH_WRB_TYPE_OFFSET 27
  624. #define BE_WRB_TYPE_OFFSET 28
  625. #define ADAPTER_SET_WRB_TYPE(pwrb, wrb_type, type_offset) \
  626. (pwrb->dw[0] |= (wrb_type << type_offset))
  627. /**
  628. * Pseudo amap definition in which each bit of the actual structure is defined
  629. * as a byte: used to calculate offset/shift/mask of each field
  630. */
  631. struct amap_iscsi_wrb {
  632. u8 lun[14]; /* DWORD 0 */
  633. u8 lt; /* DWORD 0 */
  634. u8 invld; /* DWORD 0 */
  635. u8 wrb_idx[8]; /* DWORD 0 */
  636. u8 dsp; /* DWORD 0 */
  637. u8 dmsg; /* DWORD 0 */
  638. u8 undr_run; /* DWORD 0 */
  639. u8 over_run; /* DWORD 0 */
  640. u8 type[4]; /* DWORD 0 */
  641. u8 ptr2nextwrb[8]; /* DWORD 1 */
  642. u8 r2t_exp_dtl[24]; /* DWORD 1 */
  643. u8 sgl_icd_idx[12]; /* DWORD 2 */
  644. u8 rsvd0[20]; /* DWORD 2 */
  645. u8 exp_data_sn[32]; /* DWORD 3 */
  646. u8 iscsi_bhs_addr_hi[32]; /* DWORD 4 */
  647. u8 iscsi_bhs_addr_lo[32]; /* DWORD 5 */
  648. u8 cmdsn_itt[32]; /* DWORD 6 */
  649. u8 dif_ref_tag[32]; /* DWORD 7 */
  650. u8 sge0_addr_hi[32]; /* DWORD 8 */
  651. u8 sge0_addr_lo[32]; /* DWORD 9 */
  652. u8 sge0_offset[22]; /* DWORD 10 */
  653. u8 pbs; /* DWORD 10 */
  654. u8 dif_mode[2]; /* DWORD 10 */
  655. u8 rsvd1[6]; /* DWORD 10 */
  656. u8 sge0_last; /* DWORD 10 */
  657. u8 sge0_len[17]; /* DWORD 11 */
  658. u8 dif_meta_tag[14]; /* DWORD 11 */
  659. u8 sge0_in_ddr; /* DWORD 11 */
  660. u8 sge1_addr_hi[32]; /* DWORD 12 */
  661. u8 sge1_addr_lo[32]; /* DWORD 13 */
  662. u8 sge1_r2t_offset[22]; /* DWORD 14 */
  663. u8 rsvd2[9]; /* DWORD 14 */
  664. u8 sge1_last; /* DWORD 14 */
  665. u8 sge1_len[17]; /* DWORD 15 */
  666. u8 ref_sgl_icd_idx[12]; /* DWORD 15 */
  667. u8 rsvd3[2]; /* DWORD 15 */
  668. u8 sge1_in_ddr; /* DWORD 15 */
  669. } __packed;
  670. struct amap_iscsi_wrb_v2 {
  671. u8 r2t_exp_dtl[25]; /* DWORD 0 */
  672. u8 rsvd0[2]; /* DWORD 0*/
  673. u8 type[5]; /* DWORD 0 */
  674. u8 ptr2nextwrb[8]; /* DWORD 1 */
  675. u8 wrb_idx[8]; /* DWORD 1 */
  676. u8 lun[16]; /* DWORD 1 */
  677. u8 sgl_idx[16]; /* DWORD 2 */
  678. u8 ref_sgl_icd_idx[16]; /* DWORD 2 */
  679. u8 exp_data_sn[32]; /* DWORD 3 */
  680. u8 iscsi_bhs_addr_hi[32]; /* DWORD 4 */
  681. u8 iscsi_bhs_addr_lo[32]; /* DWORD 5 */
  682. u8 cq_id[16]; /* DWORD 6 */
  683. u8 rsvd1[16]; /* DWORD 6 */
  684. u8 cmdsn_itt[32]; /* DWORD 7 */
  685. u8 sge0_addr_hi[32]; /* DWORD 8 */
  686. u8 sge0_addr_lo[32]; /* DWORD 9 */
  687. u8 sge0_offset[24]; /* DWORD 10 */
  688. u8 rsvd2[7]; /* DWORD 10 */
  689. u8 sge0_last; /* DWORD 10 */
  690. u8 sge0_len[17]; /* DWORD 11 */
  691. u8 rsvd3[7]; /* DWORD 11 */
  692. u8 diff_enbl; /* DWORD 11 */
  693. u8 u_run; /* DWORD 11 */
  694. u8 o_run; /* DWORD 11 */
  695. u8 invld; /* DWORD 11 */
  696. u8 dsp; /* DWORD 11 */
  697. u8 dmsg; /* DWORD 11 */
  698. u8 rsvd4; /* DWORD 11 */
  699. u8 lt; /* DWORD 11 */
  700. u8 sge1_addr_hi[32]; /* DWORD 12 */
  701. u8 sge1_addr_lo[32]; /* DWORD 13 */
  702. u8 sge1_r2t_offset[24]; /* DWORD 14 */
  703. u8 rsvd5[7]; /* DWORD 14 */
  704. u8 sge1_last; /* DWORD 14 */
  705. u8 sge1_len[17]; /* DWORD 15 */
  706. u8 rsvd6[15]; /* DWORD 15 */
  707. } __packed;
  708. struct wrb_handle *alloc_wrb_handle(struct beiscsi_hba *phba, unsigned int cid,
  709. struct hwi_wrb_context **pcontext);
  710. void
  711. free_mgmt_sgl_handle(struct beiscsi_hba *phba, struct sgl_handle *psgl_handle);
  712. void beiscsi_free_mgmt_task_handles(struct beiscsi_conn *beiscsi_conn,
  713. struct iscsi_task *task);
  714. void hwi_ring_cq_db(struct beiscsi_hba *phba,
  715. unsigned int id, unsigned int num_processed,
  716. unsigned char rearm);
  717. unsigned int beiscsi_process_cq(struct be_eq_obj *pbe_eq, int budget);
  718. void beiscsi_process_mcc_cq(struct beiscsi_hba *phba);
  719. struct pdu_nop_out {
  720. u32 dw[12];
  721. };
  722. /**
  723. * Pseudo amap definition in which each bit of the actual structure is defined
  724. * as a byte: used to calculate offset/shift/mask of each field
  725. */
  726. struct amap_pdu_nop_out {
  727. u8 opcode[6]; /* opcode 0x00 */
  728. u8 i_bit; /* I Bit */
  729. u8 x_bit; /* reserved; should be 0 */
  730. u8 fp_bit_filler1[7];
  731. u8 f_bit; /* always 1 */
  732. u8 reserved1[16];
  733. u8 ahs_length[8]; /* no AHS */
  734. u8 data_len_hi[8];
  735. u8 data_len_lo[16]; /* DataSegmentLength */
  736. u8 lun[64];
  737. u8 itt[32]; /* initiator id for ping or 0xffffffff */
  738. u8 ttt[32]; /* target id for ping or 0xffffffff */
  739. u8 cmd_sn[32];
  740. u8 exp_stat_sn[32];
  741. u8 reserved5[128];
  742. };
  743. #define PDUBASE_OPCODE_MASK 0x0000003F
  744. #define PDUBASE_DATALENHI_MASK 0x0000FF00
  745. #define PDUBASE_DATALENLO_MASK 0xFFFF0000
  746. struct pdu_base {
  747. u32 dw[16];
  748. } __packed;
  749. /**
  750. * Pseudo amap definition in which each bit of the actual structure is defined
  751. * as a byte: used to calculate offset/shift/mask of each field
  752. */
  753. struct amap_pdu_base {
  754. u8 opcode[6];
  755. u8 i_bit; /* immediate bit */
  756. u8 x_bit; /* reserved, always 0 */
  757. u8 reserved1[24]; /* opcode-specific fields */
  758. u8 ahs_length[8]; /* length units is 4 byte words */
  759. u8 data_len_hi[8];
  760. u8 data_len_lo[16]; /* DatasegmentLength */
  761. u8 lun[64]; /* lun or opcode-specific fields */
  762. u8 itt[32]; /* initiator task tag */
  763. u8 reserved4[224];
  764. };
  765. struct iscsi_target_context_update_wrb {
  766. u32 dw[16];
  767. } __packed;
  768. /**
  769. * Pseudo amap definition in which each bit of the actual structure is defined
  770. * as a byte: used to calculate offset/shift/mask of each field
  771. */
  772. #define BE_TGT_CTX_UPDT_CMD 0x07
  773. struct amap_iscsi_target_context_update_wrb {
  774. u8 lun[14]; /* DWORD 0 */
  775. u8 lt; /* DWORD 0 */
  776. u8 invld; /* DWORD 0 */
  777. u8 wrb_idx[8]; /* DWORD 0 */
  778. u8 dsp; /* DWORD 0 */
  779. u8 dmsg; /* DWORD 0 */
  780. u8 undr_run; /* DWORD 0 */
  781. u8 over_run; /* DWORD 0 */
  782. u8 type[4]; /* DWORD 0 */
  783. u8 ptr2nextwrb[8]; /* DWORD 1 */
  784. u8 max_burst_length[19]; /* DWORD 1 */
  785. u8 rsvd0[5]; /* DWORD 1 */
  786. u8 rsvd1[15]; /* DWORD 2 */
  787. u8 max_send_data_segment_length[17]; /* DWORD 2 */
  788. u8 first_burst_length[14]; /* DWORD 3 */
  789. u8 rsvd2[2]; /* DWORD 3 */
  790. u8 tx_wrbindex_drv_msg[8]; /* DWORD 3 */
  791. u8 rsvd3[5]; /* DWORD 3 */
  792. u8 session_state[3]; /* DWORD 3 */
  793. u8 rsvd4[16]; /* DWORD 4 */
  794. u8 tx_jumbo; /* DWORD 4 */
  795. u8 hde; /* DWORD 4 */
  796. u8 dde; /* DWORD 4 */
  797. u8 erl[2]; /* DWORD 4 */
  798. u8 domain_id[5]; /* DWORD 4 */
  799. u8 mode; /* DWORD 4 */
  800. u8 imd; /* DWORD 4 */
  801. u8 ir2t; /* DWORD 4 */
  802. u8 notpredblq[2]; /* DWORD 4 */
  803. u8 compltonack; /* DWORD 4 */
  804. u8 stat_sn[32]; /* DWORD 5 */
  805. u8 pad_buffer_addr_hi[32]; /* DWORD 6 */
  806. u8 pad_buffer_addr_lo[32]; /* DWORD 7 */
  807. u8 pad_addr_hi[32]; /* DWORD 8 */
  808. u8 pad_addr_lo[32]; /* DWORD 9 */
  809. u8 rsvd5[32]; /* DWORD 10 */
  810. u8 rsvd6[32]; /* DWORD 11 */
  811. u8 rsvd7[32]; /* DWORD 12 */
  812. u8 rsvd8[32]; /* DWORD 13 */
  813. u8 rsvd9[32]; /* DWORD 14 */
  814. u8 rsvd10[32]; /* DWORD 15 */
  815. } __packed;
  816. #define BEISCSI_MAX_RECV_DATASEG_LEN (64 * 1024)
  817. #define BEISCSI_MAX_CXNS 1
  818. struct amap_iscsi_target_context_update_wrb_v2 {
  819. u8 max_burst_length[24]; /* DWORD 0 */
  820. u8 rsvd0[3]; /* DWORD 0 */
  821. u8 type[5]; /* DWORD 0 */
  822. u8 ptr2nextwrb[8]; /* DWORD 1 */
  823. u8 wrb_idx[8]; /* DWORD 1 */
  824. u8 rsvd1[16]; /* DWORD 1 */
  825. u8 max_send_data_segment_length[24]; /* DWORD 2 */
  826. u8 rsvd2[8]; /* DWORD 2 */
  827. u8 first_burst_length[24]; /* DWORD 3 */
  828. u8 rsvd3[8]; /* DOWRD 3 */
  829. u8 max_r2t[16]; /* DWORD 4 */
  830. u8 rsvd4; /* DWORD 4 */
  831. u8 hde; /* DWORD 4 */
  832. u8 dde; /* DWORD 4 */
  833. u8 erl[2]; /* DWORD 4 */
  834. u8 rsvd5[6]; /* DWORD 4 */
  835. u8 imd; /* DWORD 4 */
  836. u8 ir2t; /* DWORD 4 */
  837. u8 rsvd6[3]; /* DWORD 4 */
  838. u8 stat_sn[32]; /* DWORD 5 */
  839. u8 rsvd7[32]; /* DWORD 6 */
  840. u8 rsvd8[32]; /* DWORD 7 */
  841. u8 max_recv_dataseg_len[24]; /* DWORD 8 */
  842. u8 rsvd9[8]; /* DWORD 8 */
  843. u8 rsvd10[32]; /* DWORD 9 */
  844. u8 rsvd11[32]; /* DWORD 10 */
  845. u8 max_cxns[16]; /* DWORD 11 */
  846. u8 rsvd12[11]; /* DWORD 11*/
  847. u8 invld; /* DWORD 11 */
  848. u8 rsvd13;/* DWORD 11*/
  849. u8 dmsg; /* DWORD 11 */
  850. u8 data_seq_inorder; /* DWORD 11 */
  851. u8 pdu_seq_inorder; /* DWORD 11 */
  852. u8 rsvd14[32]; /*DWORD 12 */
  853. u8 rsvd15[32]; /* DWORD 13 */
  854. u8 rsvd16[32]; /* DWORD 14 */
  855. u8 rsvd17[32]; /* DWORD 15 */
  856. } __packed;
  857. struct be_ring {
  858. u32 pages; /* queue size in pages */
  859. u32 id; /* queue id assigned by beklib */
  860. u32 num; /* number of elements in queue */
  861. u32 cidx; /* consumer index */
  862. u32 pidx; /* producer index -- not used by most rings */
  863. u32 item_size; /* size in bytes of one object */
  864. u8 ulp_num; /* ULP to which CID binded */
  865. u16 register_set;
  866. u16 doorbell_format;
  867. u32 doorbell_offset;
  868. void *va; /* The virtual address of the ring. This
  869. * should be last to allow 32 & 64 bit debugger
  870. * extensions to work.
  871. */
  872. };
  873. struct hwi_controller {
  874. struct hwi_wrb_context *wrb_context;
  875. struct be_ring default_pdu_hdr[BEISCSI_ULP_COUNT];
  876. struct be_ring default_pdu_data[BEISCSI_ULP_COUNT];
  877. struct hwi_context_memory *phwi_ctxt;
  878. };
  879. enum hwh_type_enum {
  880. HWH_TYPE_IO = 1,
  881. HWH_TYPE_LOGOUT = 2,
  882. HWH_TYPE_TMF = 3,
  883. HWH_TYPE_NOP = 4,
  884. HWH_TYPE_IO_RD = 5,
  885. HWH_TYPE_LOGIN = 11,
  886. HWH_TYPE_INVALID = 0xFFFFFFFF
  887. };
  888. struct wrb_handle {
  889. unsigned short wrb_index;
  890. struct iscsi_task *pio_handle;
  891. struct iscsi_wrb *pwrb;
  892. };
  893. struct hwi_context_memory {
  894. struct be_eq_obj be_eq[MAX_CPUS];
  895. struct be_queue_info be_cq[MAX_CPUS - 1];
  896. struct be_queue_info *be_wrbq;
  897. /**
  898. * Create array of ULP number for below entries as DEFQ
  899. * will be created for both ULP if iSCSI Protocol is
  900. * loaded on both ULP.
  901. */
  902. struct be_queue_info be_def_hdrq[BEISCSI_ULP_COUNT];
  903. struct be_queue_info be_def_dataq[BEISCSI_ULP_COUNT];
  904. struct hd_async_context *pasync_ctx[BEISCSI_ULP_COUNT];
  905. };
  906. void beiscsi_start_boot_work(struct beiscsi_hba *phba, unsigned int s_handle);
  907. /* Logging related definitions */
  908. #define BEISCSI_LOG_INIT 0x0001 /* Initialization events */
  909. #define BEISCSI_LOG_MBOX 0x0002 /* Mailbox Events */
  910. #define BEISCSI_LOG_MISC 0x0004 /* Miscllaneous Events */
  911. #define BEISCSI_LOG_EH 0x0008 /* Error Handler */
  912. #define BEISCSI_LOG_IO 0x0010 /* IO Code Path */
  913. #define BEISCSI_LOG_CONFIG 0x0020 /* CONFIG Code Path */
  914. #define BEISCSI_LOG_ISCSI 0x0040 /* SCSI/iSCSI Protocol related Logs */
  915. #define __beiscsi_log(phba, level, fmt, arg...) \
  916. shost_printk(level, phba->shost, fmt, __LINE__, ##arg)
  917. #define beiscsi_log(phba, level, mask, fmt, arg...) \
  918. do { \
  919. uint32_t log_value = phba->attr_log_enable; \
  920. if (((mask) & log_value) || (level[1] <= '3')) \
  921. __beiscsi_log(phba, level, fmt, ##arg); \
  922. } while (0);
  923. #endif