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