]> CyberLeo.Net >> Repos - FreeBSD/releng/7.2.git/blob - sys/dev/isp/isp_target.h
Create releng/7.2 from stable/7 in preparation for 7.2-RELEASE.
[FreeBSD/releng/7.2.git] / sys / dev / isp / isp_target.h
1 /* $FreeBSD$ */
2 /*-
3  *  Copyright (c) 1997-2007 by Matthew Jacob
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  * 
10  *  1. Redistributions of source code must retain the above copyright
11  *     notice, this list of conditions and the following disclaimer.
12  *  2. Redistributions in binary form must reproduce the above copyright
13  *     notice, this list of conditions and the following disclaimer in the
14  *     documentation and/or other materials provided with the distribution.
15  * 
16  *  THIS SOFTWARE IS PROVIDED BY AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17  *  ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18  *  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19  *  ARE DISCLAIMED.  IN NO EVENT SHALL AUTHOR OR CONTRIBUTORS BE LIABLE
20  *  FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21  *  DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22  *  OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23  *  HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24  *  LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25  *  OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26  *  SUCH DAMAGE.
27  */
28 /*
29  * Qlogic Target Mode Structure and Flag Definitions
30  */
31 #ifndef _ISP_TARGET_H
32 #define _ISP_TARGET_H
33
34 #define QLTM_SENSELEN   18      /* non-FC cards only */
35 #define QLTM_SVALID     0x80
36
37 /*
38  * Structure for Enable Lun and Modify Lun queue entries
39  */
40 typedef struct {
41         isphdr_t        le_header;
42         uint32_t        le_reserved;
43         uint8_t         le_lun;
44         uint8_t         le_rsvd;
45         uint8_t         le_ops;         /* Modify LUN only */
46         uint8_t         le_tgt;         /* Not for FC */
47         uint32_t        le_flags;       /* Not for FC */
48         uint8_t         le_status;
49         uint8_t         le_reserved2;
50         uint8_t         le_cmd_count;
51         uint8_t         le_in_count;
52         uint8_t         le_cdb6len;     /* Not for FC */
53         uint8_t         le_cdb7len;     /* Not for FC */
54         uint16_t        le_timeout;
55         uint16_t        le_reserved3[20];
56 } lun_entry_t;
57
58 /*
59  * le_flags values
60  */
61 #define LUN_TQAE        0x00000002      /* bit1  Tagged Queue Action Enable */
62 #define LUN_DSSM        0x01000000      /* bit24 Disable Sending SDP Message */
63 #define LUN_DISAD       0x02000000      /* bit25 Disable autodisconnect */
64 #define LUN_DM          0x40000000      /* bit30 Disconnects Mandatory */
65
66 /*
67  * le_ops values
68  */
69 #define LUN_CCINCR      0x01    /* increment command count */
70 #define LUN_CCDECR      0x02    /* decrement command count */
71 #define LUN_ININCR      0x40    /* increment immed. notify count */
72 #define LUN_INDECR      0x80    /* decrement immed. notify count */
73
74 /*
75  * le_status values
76  */
77 #define LUN_OK          0x01    /* we be rockin' */
78 #define LUN_ERR         0x04    /* request completed with error */
79 #define LUN_INVAL       0x06    /* invalid request */
80 #define LUN_NOCAP       0x16    /* can't provide requested capability */
81 #define LUN_ENABLED     0x3E    /* LUN already enabled */
82
83 /*
84  * Immediate Notify Entry structure
85  */
86 #define IN_MSGLEN       8       /* 8 bytes */
87 #define IN_RSVDLEN      8       /* 8 words */
88 typedef struct {
89         isphdr_t        in_header;
90         uint32_t        in_reserved;
91         uint8_t         in_lun;         /* lun */
92         uint8_t         in_iid;         /* initiator */
93         uint8_t         in_reserved2;
94         uint8_t         in_tgt;         /* target */
95         uint32_t        in_flags;
96         uint8_t         in_status;
97         uint8_t         in_rsvd2;
98         uint8_t         in_tag_val;     /* tag value */
99         uint8_t         in_tag_type;    /* tag type */
100         uint16_t        in_seqid;       /* sequence id */
101         uint8_t         in_msg[IN_MSGLEN];      /* SCSI message bytes */
102         uint16_t        in_reserved3[IN_RSVDLEN];
103         uint8_t         in_sense[QLTM_SENSELEN];/* suggested sense data */
104 } in_entry_t;
105
106 typedef struct {
107         isphdr_t        in_header;
108         uint32_t        in_reserved;
109         uint8_t         in_lun;         /* lun */
110         uint8_t         in_iid;         /* initiator */
111         uint16_t        in_scclun;
112         uint32_t        in_reserved2;
113         uint16_t        in_status;
114         uint16_t        in_task_flags;
115         uint16_t        in_seqid;       /* sequence id */
116 } in_fcentry_t;
117
118 typedef struct {
119         isphdr_t        in_header;
120         uint32_t        in_reserved;
121         uint16_t        in_iid;         /* initiator */
122         uint16_t        in_scclun;
123         uint32_t        in_reserved2;
124         uint16_t        in_status;
125         uint16_t        in_task_flags;
126         uint16_t        in_seqid;       /* sequence id */
127 } in_fcentry_e_t;
128
129 /*
130  * Values for the in_status field
131  */
132 #define IN_REJECT       0x0D    /* Message Reject message received */
133 #define IN_RESET        0x0E    /* Bus Reset occurred */
134 #define IN_NO_RCAP      0x16    /* requested capability not available */
135 #define IN_IDE_RECEIVED 0x33    /* Initiator Detected Error msg received */
136 #define IN_RSRC_UNAVAIL 0x34    /* resource unavailable */
137 #define IN_MSG_RECEIVED 0x36    /* SCSI message received */
138 #define IN_ABORT_TASK   0x20    /* task named in RX_ID is being aborted (FC) */
139 #define IN_PORT_LOGOUT  0x29    /* port has logged out (FC) */
140 #define IN_PORT_CHANGED 0x2A    /* port changed */
141 #define IN_GLOBAL_LOGO  0x2E    /* all ports logged out */
142 #define IN_NO_NEXUS     0x3B    /* Nexus not established */
143
144 /*
145  * Values for the in_task_flags field- should only get one at a time!
146  */
147 #define TASK_FLAGS_RESERVED_MASK        (0xe700)
148 #define TASK_FLAGS_CLEAR_ACA            (1<<14)
149 #define TASK_FLAGS_TARGET_RESET         (1<<13)
150 #define TASK_FLAGS_LUN_RESET            (1<<12)
151 #define TASK_FLAGS_CLEAR_TASK_SET       (1<<10)
152 #define TASK_FLAGS_ABORT_TASK_SET       (1<<9)
153
154 /*
155  * ISP24XX Immediate Notify
156  */
157 typedef struct {
158         isphdr_t        in_header;
159         uint32_t        in_reserved;
160         uint16_t        in_nphdl;
161         uint16_t        in_reserved1;
162         uint16_t        in_flags;
163         uint16_t        in_srr_rxid;
164         uint16_t        in_status;
165         uint8_t         in_status_subcode;
166         uint8_t         in_reserved2;
167         uint32_t        in_rxid;
168         uint16_t        in_srr_reloff_lo;
169         uint16_t        in_srr_reloff_hi;
170         uint16_t        in_srr_iu;
171         uint16_t        in_srr_oxid;
172         uint8_t         in_reserved3[18];
173         uint8_t         in_reserved4;
174         uint8_t         in_vpindex;
175         uint32_t        in_reserved5;
176         uint16_t        in_portid_lo;
177         uint8_t         in_portid_hi;
178         uint8_t         in_reserved6;
179         uint16_t        in_reserved7;
180         uint16_t        in_oxid;
181 } in_fcentry_24xx_t;
182
183 #define IN24XX_FLAG_PUREX_IOCB          0x1
184 #define IN24XX_FLAG_GLOBAL_LOGOUT       0x2
185
186 #define IN24XX_LIP_RESET        0x0E
187 #define IN24XX_LINK_RESET       0x0F
188 #define IN24XX_PORT_LOGOUT      0x29
189 #define IN24XX_PORT_CHANGED     0x2A
190 #define IN24XX_LINK_FAILED      0x2E
191 #define IN24XX_SRR_RCVD         0x45
192 #define IN24XX_ELS_RCVD         0x46    /*
193                                          * login-affectin ELS received- check
194                                          * subcode for specific opcode
195                                          */
196 /*
197  * Notify Acknowledge Entry structure
198  */
199 #define NA_RSVDLEN      22
200 typedef struct {
201         isphdr_t        na_header;
202         uint32_t        na_reserved;
203         uint8_t         na_lun;         /* lun */
204         uint8_t         na_iid;         /* initiator */
205         uint8_t         na_reserved2;
206         uint8_t         na_tgt;         /* target */
207         uint32_t        na_flags;
208         uint8_t         na_status;
209         uint8_t         na_event;
210         uint16_t        na_seqid;       /* sequence id */
211         uint16_t        na_reserved3[NA_RSVDLEN];
212 } na_entry_t;
213
214 /*
215  * Value for the na_event field
216  */
217 #define NA_RST_CLRD     0x80    /* Clear an async event notification */
218 #define NA_OK           0x01    /* Notify Acknowledge Succeeded */
219 #define NA_INVALID      0x06    /* Invalid Notify Acknowledge */
220
221 #define NA2_RSVDLEN     21
222 typedef struct {
223         isphdr_t        na_header;
224         uint32_t        na_reserved;
225         uint8_t         na_reserved1;
226         uint8_t         na_iid;         /* initiator loop id */
227         uint16_t        na_response;
228         uint16_t        na_flags;
229         uint16_t        na_reserved2;
230         uint16_t        na_status;
231         uint16_t        na_task_flags;
232         uint16_t        na_seqid;       /* sequence id */
233         uint16_t        na_reserved3[NA2_RSVDLEN];
234 } na_fcentry_t;
235
236 typedef struct {
237         isphdr_t        na_header;
238         uint32_t        na_reserved;
239         uint16_t        na_iid;         /* initiator loop id */
240         uint16_t        na_response;    /* response code */
241         uint16_t        na_flags;
242         uint16_t        na_reserved2;
243         uint16_t        na_status;
244         uint16_t        na_task_flags;
245         uint16_t        na_seqid;       /* sequence id */
246         uint16_t        na_reserved3[NA2_RSVDLEN];
247 } na_fcentry_e_t;
248
249 #define NAFC_RCOUNT     0x80    /* increment resource count */
250 #define NAFC_RST_CLRD   0x20    /* Clear LIP Reset */
251 #define NAFC_TVALID     0x10    /* task mangement response code is valid */
252
253 /*
254  * ISP24XX Notify Acknowledge
255  */
256
257 typedef struct {
258         isphdr_t        na_header;
259         uint32_t        na_handle;
260         uint16_t        na_nphdl;
261         uint16_t        na_reserved1;
262         uint16_t        na_flags;
263         uint16_t        na_srr_rxid;
264         uint16_t        na_status;
265         uint8_t         na_status_subcode;
266         uint8_t         na_reserved2;
267         uint32_t        na_rxid;
268         uint16_t        na_srr_reloff_lo;
269         uint16_t        na_srr_reloff_hi;
270         uint16_t        na_srr_iu;
271         uint16_t        na_srr_flags;
272         uint8_t         na_reserved3[18];
273         uint8_t         na_reserved4;
274         uint8_t         na_vpindex;
275         uint8_t         na_srr_reject_vunique;
276         uint8_t         na_srr_reject_explanation;
277         uint8_t         na_srr_reject_code;
278         uint8_t         na_reserved5;
279         uint8_t         na_reserved6[6];
280         uint16_t        na_oxid;
281 } na_fcentry_24xx_t;
282
283 /*
284  * Accept Target I/O Entry structure
285  */
286 #define ATIO_CDBLEN     26
287
288 typedef struct {
289         isphdr_t        at_header;
290         uint16_t        at_reserved;
291         uint16_t        at_handle;
292         uint8_t         at_lun;         /* lun */
293         uint8_t         at_iid;         /* initiator */
294         uint8_t         at_cdblen;      /* cdb length */
295         uint8_t         at_tgt;         /* target */
296         uint32_t        at_flags;
297         uint8_t         at_status;      /* firmware status */
298         uint8_t         at_scsi_status; /* scsi status */
299         uint8_t         at_tag_val;     /* tag value */
300         uint8_t         at_tag_type;    /* tag type */
301         uint8_t         at_cdb[ATIO_CDBLEN];    /* received CDB */
302         uint8_t         at_sense[QLTM_SENSELEN];/* suggested sense data */
303 } at_entry_t;
304
305 /*
306  * at_flags values
307  */
308 #define AT_NODISC       0x00008000      /* disconnect disabled */
309 #define AT_TQAE         0x00000002      /* Tagged Queue Action enabled */
310
311 /*
312  * at_status values
313  */
314 #define AT_PATH_INVALID 0x07    /* ATIO sent to firmware for disabled lun */
315 #define AT_RESET        0x0E    /* SCSI Bus Reset Occurred */
316 #define AT_PHASE_ERROR  0x14    /* Bus phase sequence error */
317 #define AT_NOCAP        0x16    /* Requested capability not available */
318 #define AT_BDR_MSG      0x17    /* Bus Device Reset msg received */
319 #define AT_CDB          0x3D    /* CDB received */
320 /*
321  * Macros to create and fetch and test concatenated handle and tag value macros
322  */
323
324 #define AT_MAKE_TAGID(tid, bus, inst, aep)                              \
325         tid = aep->at_handle;                                           \
326         if (aep->at_flags & AT_TQAE) {                                  \
327                 tid |= (aep->at_tag_val << 16);                         \
328                 tid |= (1 << 24);                                       \
329         }                                                               \
330         tid |= (bus << 25);                                             \
331         tid |= (inst << 26)
332
333 #define CT_MAKE_TAGID(tid, bus, inst, ct)                               \
334         tid = ct->ct_fwhandle;                                          \
335         if (ct->ct_flags & CT_TQAE) {                                   \
336                 tid |= (ct->ct_tag_val << 16);                          \
337                 tid |= (1 << 24);                                       \
338         }                                                               \
339         tid |= ((bus & 0x1) << 25);                                     \
340         tid |= (inst << 26)
341
342 #define AT_HAS_TAG(val)         ((val) & (1 << 24))
343 #define AT_GET_TAG(val)         (((val) >> 16) & 0xff)
344 #define AT_GET_INST(val)        (((val) >> 26) & 0x3f)
345 #define AT_GET_BUS(val)         (((val) >> 25) & 0x1)
346 #define AT_GET_HANDLE(val)      ((val) & 0xffff)
347
348 #define IN_MAKE_TAGID(tid, bus, inst, inp)                              \
349         tid = inp->in_seqid;                                            \
350         tid |= (inp->in_tag_val << 16);                                 \
351         tid |= (1 << 24);                                               \
352         tid |= (bus << 25);                                             \
353         tid |= (inst << 26)
354
355 #define TAG_INSERT_INST(tid, inst)                                      \
356         tid &= ~(0x3ffffff);                                            \
357         tid |= (inst << 26)
358
359 #define TAG_INSERT_BUS(tid, bus)                                        \
360         tid &= ~(1 << 25);                                              \
361         tid |= (bus << 25)
362
363 /*
364  * Accept Target I/O Entry structure, Type 2
365  */
366 #define ATIO2_CDBLEN    16
367
368 typedef struct {
369         isphdr_t        at_header;
370         uint32_t        at_reserved;
371         uint8_t         at_lun;         /* lun or reserved */
372         uint8_t         at_iid;         /* initiator */
373         uint16_t        at_rxid;        /* response ID */
374         uint16_t        at_flags;
375         uint16_t        at_status;      /* firmware status */
376         uint8_t         at_crn;         /* command reference number */
377         uint8_t         at_taskcodes;
378         uint8_t         at_taskflags;
379         uint8_t         at_execodes;
380         uint8_t         at_cdb[ATIO2_CDBLEN];   /* received CDB */
381         uint32_t        at_datalen;             /* allocated data len */
382         uint16_t        at_scclun;              /* SCC Lun or reserved */
383         uint16_t        at_wwpn[4];             /* WWPN of initiator */
384         uint16_t        at_reserved2[6];
385         uint16_t        at_oxid;
386 } at2_entry_t;
387
388 typedef struct {
389         isphdr_t        at_header;
390         uint32_t        at_reserved;
391         uint16_t        at_iid;         /* initiator */
392         uint16_t        at_rxid;        /* response ID */
393         uint16_t        at_flags;
394         uint16_t        at_status;      /* firmware status */
395         uint8_t         at_crn;         /* command reference number */
396         uint8_t         at_taskcodes;
397         uint8_t         at_taskflags;
398         uint8_t         at_execodes;
399         uint8_t         at_cdb[ATIO2_CDBLEN];   /* received CDB */
400         uint32_t        at_datalen;             /* allocated data len */
401         uint16_t        at_scclun;              /* SCC Lun or reserved */
402         uint16_t        at_wwpn[4];             /* WWPN of initiator */
403         uint16_t        at_reserved2[6];
404         uint16_t        at_oxid;
405 } at2e_entry_t;
406
407 #define ATIO2_WWPN_OFFSET       0x2A
408 #define ATIO2_OXID_OFFSET       0x3E
409
410 #define ATIO2_TC_ATTR_MASK      0x7
411 #define ATIO2_TC_ATTR_SIMPLEQ   0
412 #define ATIO2_TC_ATTR_HEADOFQ   1
413 #define ATIO2_TC_ATTR_ORDERED   2
414 #define ATIO2_TC_ATTR_ACAQ      4
415 #define ATIO2_TC_ATTR_UNTAGGED  5
416
417 #define ATIO2_EX_WRITE          0x1
418 #define ATIO2_EX_READ           0x2
419 /*
420  * Macros to create and fetch and test concatenated handle and tag value macros
421  */
422 #define AT2_MAKE_TAGID(tid, bus, inst, aep)                             \
423         tid = aep->at_rxid;                                             \
424         tid |= (((uint64_t)inst) << 32);                                \
425         tid |= (((uint64_t)bus) << 48)
426
427 #define CT2_MAKE_TAGID(tid, bus, inst, ct)                              \
428         tid = ct->ct_rxid;                                              \
429         tid |= (((uint64_t)inst) << 32);                                \
430         tid |= (((uint64_t)(bus & 0xff)) << 48)
431
432 #define AT2_HAS_TAG(val)        1
433 #define AT2_GET_TAG(val)        ((val) & 0xffffffff)
434 #define AT2_GET_INST(val)       ((val) >> 32)
435 #define AT2_GET_HANDLE          AT2_GET_TAG
436 #define AT2_GET_BUS(val)        (((val) >> 48) & 0xff)
437
438 #define FC_HAS_TAG      AT2_HAS_TAG
439 #define FC_GET_TAG      AT2_GET_TAG
440 #define FC_GET_INST     AT2_GET_INST
441 #define FC_GET_HANDLE   AT2_GET_HANDLE
442
443 #define IN_FC_MAKE_TAGID(tid, bus, inst, seqid)                         \
444         tid = seqid;                                                    \
445         tid |= (((uint64_t)inst) << 32);                                \
446         tid |= (((uint64_t)(bus & 0xff)) << 48)
447
448 #define FC_TAG_INSERT_INST(tid, inst)                                   \
449         tid &= ~0xffff00000000ull;                                      \
450         tid |= (((uint64_t)inst) << 32)
451
452 /*
453  * 24XX ATIO Definition
454  *
455  * This is *quite* different from other entry types.
456  * First of all, it has its own queue it comes in on.
457  *
458  * Secondly, it doesn't have a normal header.
459  *
460  * Thirdly, it's just a passthru of the FCP CMND IU
461  * which is recorded in big endian mode.
462  */
463 typedef struct {
464         uint8_t         at_type;
465         uint8_t         at_count;
466         /*
467          * Task attribute in high four bits,
468          * the rest is the FCP CMND IU Length.
469          * NB: the command can extend past the
470          * length for a single queue entry.
471          */
472         uint16_t        at_ta_len;
473         uint32_t        at_rxid;
474         fc_hdr_t        at_hdr;
475         fcp_cmnd_iu_t   at_cmnd;
476 } at7_entry_t;
477
478
479 /*
480  * Continue Target I/O Entry structure
481  * Request from driver. The response from the
482  * ISP firmware is the same except that the last 18
483  * bytes are overwritten by suggested sense data if
484  * the 'autosense valid' bit is set in the status byte.
485  */
486 typedef struct {
487         isphdr_t        ct_header;
488         uint16_t        ct_syshandle;
489         uint16_t        ct_fwhandle;    /* required by f/w */
490         uint8_t         ct_lun; /* lun */
491         uint8_t         ct_iid; /* initiator id */
492         uint8_t         ct_reserved2;
493         uint8_t         ct_tgt; /* our target id */
494         uint32_t        ct_flags;
495         uint8_t         ct_status;      /* isp status */
496         uint8_t         ct_scsi_status; /* scsi status */
497         uint8_t         ct_tag_val;     /* tag value */
498         uint8_t         ct_tag_type;    /* tag type */
499         uint32_t        ct_xfrlen;      /* transfer length */
500         uint32_t        ct_resid;       /* residual length */
501         uint16_t        ct_timeout;
502         uint16_t        ct_seg_count;
503         ispds_t         ct_dataseg[ISP_RQDSEG];
504 } ct_entry_t;
505
506 /*
507  * For some of the dual port SCSI adapters, port (bus #) is reported
508  * in the MSbit of ct_iid. Bit fields are a bit too awkward here.
509  *
510  * Note that this does not apply to FC adapters at all which can and
511  * do report IIDs between 0x81 && 0xfe (or 0x7ff) which represent devices
512  * that have logged in across a SCSI fabric.
513  */
514 #define GET_IID_VAL(x)          (x & 0x3f)
515 #define GET_BUS_VAL(x)          ((x >> 7) & 0x1)
516 #define SET_IID_VAL(y, x)       y = ((y & ~0x3f) | (x & 0x3f))
517 #define SET_BUS_VAL(y, x)       y = ((y & 0x3f) | ((x & 0x1) << 7))
518
519 /*
520  * ct_flags values
521  */
522 #define CT_TQAE         0x00000002      /* bit  1, Tagged Queue Action enable */
523 #define CT_DATA_IN      0x00000040      /* bits 6&7, Data direction */
524 #define CT_DATA_OUT     0x00000080      /* bits 6&7, Data direction */
525 #define CT_NO_DATA      0x000000C0      /* bits 6&7, Data direction */
526 #define CT_CCINCR       0x00000100      /* bit 8, autoincrement atio count */
527 #define CT_DATAMASK     0x000000C0      /* bits 6&7, Data direction */
528 #define CT_INISYNCWIDE  0x00004000      /* bit 14, Do Sync/Wide Negotiation */
529 #define CT_NODISC       0x00008000      /* bit 15, Disconnects disabled */
530 #define CT_DSDP         0x01000000      /* bit 24, Disable Save Data Pointers */
531 #define CT_SENDRDP      0x04000000      /* bit 26, Send Restore Pointers msg */
532 #define CT_SENDSTATUS   0x80000000      /* bit 31, Send SCSI status byte */
533
534 /*
535  * ct_status values
536  * - set by the firmware when it returns the CTIO
537  */
538 #define CT_OK           0x01    /* completed without error */
539 #define CT_ABORTED      0x02    /* aborted by host */
540 #define CT_ERR          0x04    /* see sense data for error */
541 #define CT_INVAL        0x06    /* request for disabled lun */
542 #define CT_NOPATH       0x07    /* invalid ITL nexus */
543 #define CT_INVRXID      0x08    /* (FC only) Invalid RX_ID */
544 #define CT_DATA_OVER    0x09    /* (FC only) Data Overrun */
545 #define CT_RSELTMO      0x0A    /* reselection timeout after 2 tries */
546 #define CT_TIMEOUT      0x0B    /* timed out */
547 #define CT_RESET        0x0E    /* SCSI Bus Reset occurred */
548 #define CT_PARITY       0x0F    /* Uncorrectable Parity Error */
549 #define CT_BUS_ERROR    0x10    /* (FC Only) DMA PCI Error */
550 #define CT_PANIC        0x13    /* Unrecoverable Error */
551 #define CT_PHASE_ERROR  0x14    /* Bus phase sequence error */
552 #define CT_DATA_UNDER   0x15    /* (FC only) Data Underrun */
553 #define CT_BDR_MSG      0x17    /* Bus Device Reset msg received */
554 #define CT_TERMINATED   0x19    /* due to Terminate Transfer mbox cmd */
555 #define CT_PORTUNAVAIL  0x28    /* port not available */
556 #define CT_LOGOUT       0x29    /* port logout */
557 #define CT_PORTCHANGED  0x2A    /* port changed */
558 #define CT_IDE          0x33    /* Initiator Detected Error */
559 #define CT_NOACK        0x35    /* Outstanding Immed. Notify. entry */
560 #define CT_SRR          0x45    /* SRR Received */
561 #define CT_LUN_RESET    0x48    /* Lun Reset Received */
562
563 /*
564  * When the firmware returns a CTIO entry, it may overwrite the last
565  * part of the structure with sense data. This starts at offset 0x2E
566  * into the entry, which is in the middle of ct_dataseg[1]. Rather
567  * than define a new struct for this, I'm just using the sense data
568  * offset.
569  */
570 #define CTIO_SENSE_OFFSET       0x2E
571
572 /*
573  * Entry length in u_longs. All entries are the same size so
574  * any one will do as the numerator.
575  */
576 #define UINT32_ENTRY_SIZE       (sizeof(at_entry_t)/sizeof(uint32_t))
577
578 /*
579  * QLA2100 CTIO (type 2) entry
580  */
581 #define MAXRESPLEN      26
582 typedef struct {
583         isphdr_t        ct_header;
584         uint32_t        ct_syshandle;
585         uint8_t         ct_lun;         /* lun */
586         uint8_t         ct_iid;         /* initiator id */
587         uint16_t        ct_rxid;        /* response ID */
588         uint16_t        ct_flags;
589         uint16_t        ct_status;      /* isp status */
590         uint16_t        ct_timeout;
591         uint16_t        ct_seg_count;
592         uint32_t        ct_reloff;      /* relative offset */
593         int32_t         ct_resid;       /* residual length */
594         union {
595                 /*
596                  * The three different modes that the target driver
597                  * can set the CTIO{2,3,4} up as.
598                  *
599                  * The first is for sending FCP_DATA_IUs as well as
600                  * (optionally) sending a terminal SCSI status FCP_RSP_IU.
601                  *
602                  * The second is for sending SCSI sense data in an FCP_RSP_IU.
603                  * Note that no FCP_DATA_IUs will be sent.
604                  *
605                  * The third is for sending FCP_RSP_IUs as built specifically
606                  * in system memory as located by the isp_dataseg.
607                  */
608                 struct {
609                         uint32_t _reserved;
610                         uint16_t _reserved2;
611                         uint16_t ct_scsi_status;
612                         uint32_t ct_xfrlen;
613                         union {
614                                 ispds_t ct_dataseg[ISP_RQDSEG_T2];
615                                 ispds64_t ct_dataseg64[ISP_RQDSEG_T3];
616                                 ispdslist_t ct_dslist;
617                         } u;
618                 } m0;
619                 struct {
620                         uint16_t _reserved;
621                         uint16_t _reserved2;
622                         uint16_t ct_senselen;
623                         uint16_t ct_scsi_status;
624                         uint16_t ct_resplen;
625                         uint8_t  ct_resp[MAXRESPLEN];
626                 } m1;
627                 struct {
628                         uint32_t _reserved;
629                         uint16_t _reserved2;
630                         uint16_t _reserved3;
631                         uint32_t ct_datalen;
632                         ispds_t ct_fcp_rsp_iudata;
633                 } m2;
634         } rsp;
635 } ct2_entry_t;
636
637 typedef struct {
638         isphdr_t        ct_header;
639         uint32_t        ct_syshandle;
640         uint16_t        ct_iid;         /* initiator id */
641         uint16_t        ct_rxid;        /* response ID */
642         uint16_t        ct_flags;
643         uint16_t        ct_status;      /* isp status */
644         uint16_t        ct_timeout;
645         uint16_t        ct_seg_count;
646         uint32_t        ct_reloff;      /* relative offset */
647         int32_t         ct_resid;       /* residual length */
648         union {
649                 struct {
650                         uint32_t _reserved;
651                         uint16_t _reserved2;
652                         uint16_t ct_scsi_status;
653                         uint32_t ct_xfrlen;
654                         union {
655                                 ispds_t ct_dataseg[ISP_RQDSEG_T2];
656                                 ispds64_t ct_dataseg64[ISP_RQDSEG_T3];
657                                 ispdslist_t ct_dslist;
658                         } u;
659                 } m0;
660                 struct {
661                         uint16_t _reserved;
662                         uint16_t _reserved2;
663                         uint16_t ct_senselen;
664                         uint16_t ct_scsi_status;
665                         uint16_t ct_resplen;
666                         uint8_t  ct_resp[MAXRESPLEN];
667                 } m1;
668                 struct {
669                         uint32_t _reserved;
670                         uint16_t _reserved2;
671                         uint16_t _reserved3;
672                         uint32_t ct_datalen;
673                         ispds_t ct_fcp_rsp_iudata;
674                 } m2;
675         } rsp;
676 } ct2e_entry_t;
677
678 /*
679  * ct_flags values for CTIO2
680  */
681 #define CT2_FLAG_MODE0  0x0000
682 #define CT2_FLAG_MODE1  0x0001
683 #define CT2_FLAG_MODE2  0x0002
684 #define         CT2_FLAG_MMASK  0x0003
685 #define CT2_DATA_IN     0x0040
686 #define CT2_DATA_OUT    0x0080
687 #define CT2_NO_DATA     0x00C0
688 #define         CT2_DATAMASK    0x00C0
689 #define CT2_CCINCR      0x0100
690 #define CT2_FASTPOST    0x0200
691 #define CT2_CONFIRM     0x2000
692 #define CT2_TERMINATE   0x4000
693 #define CT2_SENDSTATUS  0x8000
694
695 /*
696  * ct_status values are (mostly) the same as that for ct_entry.
697  */
698
699 /*
700  * ct_scsi_status values- the low 8 bits are the normal SCSI status
701  * we know and love. The upper 8 bits are validity markers for FCP_RSP_IU
702  * fields.
703  */
704 #define CT2_RSPLEN_VALID        0x0100
705 #define CT2_SNSLEN_VALID        0x0200
706 #define CT2_DATA_OVER           0x0400
707 #define CT2_DATA_UNDER          0x0800
708
709 /*
710  * ISP24XX CTIO
711  */
712 #define MAXRESPLEN_24XX 24
713 typedef struct {
714         isphdr_t        ct_header;
715         uint32_t        ct_syshandle;
716         uint16_t        ct_nphdl;       /* status on returned CTIOs */
717         uint16_t        ct_timeout;
718         uint16_t        ct_seg_count;
719         uint8_t         ct_vpindex;
720         uint8_t         ct_xflags;
721         uint16_t        ct_iid_lo;      /* low 16 bits of portid */
722         uint8_t         ct_iid_hi;      /* hi 8 bits of portid */
723         uint8_t         ct_reserved;
724         uint32_t        ct_rxid;
725         uint16_t        ct_senselen;    /* mode 0 only */
726         uint16_t        ct_flags;
727         int32_t         ct_resid;       /* residual length */
728         uint16_t        ct_oxid;
729         uint16_t        ct_scsi_status; /* modes 0 && 1 only */
730         union {
731                 struct {
732                         uint32_t        reloff;
733                         uint32_t        reserved0;
734                         uint32_t        ct_xfrlen;
735                         uint32_t        reserved1;
736                         ispds64_t       ds;
737                 } m0;
738                 struct {
739                         uint16_t ct_resplen;
740                         uint16_t reserved;
741                         uint8_t  ct_resp[MAXRESPLEN_24XX];
742                 } m1;
743                 struct {
744                         uint32_t reserved0;
745                         uint32_t ct_datalen;
746                         uint32_t reserved1;
747                         ispds64_t ct_fcp_rsp_iudata;
748                 } m2;
749         } rsp;
750 } ct7_entry_t;
751
752 /*
753  * ct_flags values for CTIO7
754  */
755 #define CT7_DATA_IN     0x0002
756 #define CT7_DATA_OUT    0x0001
757 #define CT7_NO_DATA     0x0000
758 #define         CT7_DATAMASK    0x003
759 #define CT7_DSD_ENABLE  0x0004
760 #define CT7_CONF_STSFD  0x0010
761 #define CT7_EXPLCT_CONF 0x0020
762 #define CT7_FLAG_MODE0  0x0000
763 #define CT7_FLAG_MODE1  0x0040
764 #define CT7_FLAG_MODE7  0x0080
765 #define         CT7_FLAG_MMASK  0x00C0
766 #define CT7_FASTPOST    0x0100
767 #define CT7_ATTR_MASK   0x1e00  /* task attributes from atio7 */
768 #define CT7_CONFIRM     0x2000
769 #define CT7_TERMINATE   0x4000
770 #define CT7_SENDSTATUS  0x8000
771
772 /*
773  * Type 7 CTIO status codes
774  */
775 #define CT7_OK          0x01    /* completed without error */
776 #define CT7_ABORTED     0x02    /* aborted by host */
777 #define CT7_ERR         0x04    /* see sense data for error */
778 #define CT7_INVAL       0x06    /* request for disabled lun */
779 #define CT7_INVRXID     0x08    /* (FC only) Invalid RX_ID */
780 #define CT7_DATA_OVER   0x09    /* (FC only) Data Overrun */
781 #define CT7_TIMEOUT     0x0B    /* timed out */
782 #define CT7_RESET       0x0E    /* LIP Rset Received */
783 #define CT7_BUS_ERROR   0x10    /* DMA PCI Error */
784 #define CT7_REASSY_ERR  0x11    /* DMA reassembly error */
785 #define CT7_DATA_UNDER  0x15    /* (FC only) Data Underrun */
786 #define CT7_PORTUNAVAIL 0x28    /* port not available */
787 #define CT7_LOGOUT      0x29    /* port logout */
788 #define CT7_PORTCHANGED 0x2A    /* port changed */
789 #define CT7_SRR         0x45    /* SRR Received */
790
791 /*
792  * Other 24XX related target IOCBs
793  */
794
795 /*
796  * ABTS Received
797  */
798 typedef struct {
799         isphdr_t        abts_header;
800         uint8_t         abts_reserved0[6];
801         uint16_t        abts_nphdl;
802         uint16_t        abts_reserved1;
803         uint16_t        abts_sof;
804         uint32_t        abts_rxid_abts;
805         uint16_t        abts_did_lo;
806         uint8_t         abts_did_hi;
807         uint8_t         abts_r_ctl;
808         uint16_t        abts_sid_lo;
809         uint8_t         abts_sid_hi;
810         uint8_t         abts_cs_ctl;
811         uint16_t        abts_fs_ctl;
812         uint8_t         abts_f_ctl;
813         uint8_t         abts_type;
814         uint16_t        abts_seq_cnt;
815         uint8_t         abts_df_ctl;
816         uint8_t         abts_seq_id;
817         uint16_t        abts_rx_id;
818         uint16_t        abts_ox_id;
819         uint32_t        abts_param;
820         uint8_t         abts_reserved2[16];
821         uint32_t        abts_rxid_task;
822 } abts_t;
823
824 typedef struct {
825         isphdr_t        abts_rsp_header;
826         uint32_t        abts_rsp_handle;
827         uint16_t        abts_rsp_status;
828         uint16_t        abts_rsp_nphdl;
829         uint16_t        abts_rsp_ctl_flags;
830         uint16_t        abts_rsp_sof;
831         uint32_t        abts_rsp_rxid_abts;
832         uint16_t        abts_rsp_did_lo;
833         uint8_t         abts_rsp_did_hi;
834         uint8_t         abts_rsp_r_ctl;
835         uint16_t        abts_rsp_sid_lo;
836         uint8_t         abts_rsp_sid_hi;
837         uint8_t         abts_rsp_cs_ctl;
838         uint16_t        abts_rsp_f_ctl_lo;
839         uint8_t         abts_rsp_f_ctl_hi;
840         uint8_t         abts_rsp_type;
841         uint16_t        abts_rsp_seq_cnt;
842         uint8_t         abts_rsp_df_ctl;
843         uint8_t         abts_rsp_seq_id;
844         uint16_t        abts_rsp_rx_id;
845         uint16_t        abts_rsp_ox_id;
846         uint32_t        abts_rsp_param;
847         union {
848                 struct {
849                         uint16_t reserved;
850                         uint8_t last_seq_id;
851                         uint8_t seq_id_valid;
852                         uint16_t aborted_rx_id;
853                         uint16_t aborted_ox_id;
854                         uint16_t high_seq_cnt;
855                         uint16_t low_seq_cnt;
856                         uint8_t reserved2[4];
857                 } ba_acc;
858                 struct {
859                         uint8_t vendor_unique;
860                         uint8_t explanation;
861                         uint8_t reason;
862                         uint8_t reserved;
863                         uint8_t reserved2[12];
864                 } ba_rjt;
865                 struct {
866                         uint8_t reserved[8];
867                         uint32_t subcode1;
868                         uint32_t subcode2;
869                 } rsp;
870                 uint8_t reserved[16];
871         } abts_rsp_payload;
872         uint32_t        abts_rsp_rxid_task;
873 } abts_rsp_t;
874
875 /* terminate this ABTS exchange */
876 #define ISP24XX_ABTS_RSP_TERMINATE      0x01
877
878 #define ISP24XX_ABTS_RSP_COMPLETE       0x00
879 #define ISP24XX_ABTS_RSP_RESET          0x04
880 #define ISP24XX_ABTS_RSP_ABORTED        0x05
881 #define ISP24XX_ABTS_RSP_TIMEOUT        0x06
882 #define ISP24XX_ABTS_RSP_INVXID         0x08
883 #define ISP24XX_ABTS_RSP_LOGOUT         0x29
884 #define ISP24XX_ABTS_RSP_SUBCODE        0x31
885
886 /*
887  * Debug macros
888  */
889
890 #define ISP_TDQE(isp, msg, idx, arg)    \
891     if (isp->isp_dblev & ISP_LOGTDEBUG2) isp_print_qentry(isp, msg, idx, arg)
892
893 #ifndef ISP_TOOLS
894 /*
895  * The functions below are for the publicly available
896  * target mode functions that are internal to the Qlogic driver.
897  */
898
899 /*
900  * This function handles new response queue entry appropriate for target mode.
901  */
902 int isp_target_notify(ispsoftc_t *, void *, uint32_t *);
903
904 /*
905  * This function externalizes the ability to acknowledge an Immediate Notify
906  * request.
907  */
908 void isp_notify_ack(ispsoftc_t *, void *);
909
910 /*
911  * Enable/Disable/Modify a logical unit.
912  * (softc, cmd, bus, tgt, lun, cmd_cnt, inotify_cnt, opaque)
913  */
914 #define DFLT_CMND_CNT   0xfe    /* unmonitored */
915 #define DFLT_INOT_CNT   0xfe    /* unmonitored */
916 int isp_lun_cmd(ispsoftc_t *, int, int, int, int, int, int, uint32_t);
917
918 /*
919  * General request queue 'put' routine for target mode entries.
920  */
921 int isp_target_put_entry(ispsoftc_t *isp, void *);
922
923 /*
924  * General routine to put back an ATIO entry-
925  * used for replenishing f/w resource counts.
926  * The argument is a pointer to a source ATIO
927  * or ATIO2.
928  */
929 int isp_target_put_atio(ispsoftc_t *, void *);
930
931 /*
932  * General routine to send a final CTIO for a command- used mostly for
933  * local responses.
934  */
935 int isp_endcmd(ispsoftc_t *, void *, uint32_t, uint32_t);
936 #define ECMD_SVALID     0x100
937
938 /*
939  * Handle an asynchronous event
940  *
941  * Return nonzero if the interrupt that generated this event has been dismissed.
942  */
943 int isp_target_async(ispsoftc_t *, int, int);
944 #endif
945 #endif  /* _ISP_TARGET_H */