Home | History | Annotate | Line # | Download | only in ic
isp_target.h revision 1.24
      1 /* $NetBSD: isp_target.h,v 1.24 2007/05/24 21:30:43 mjacob Exp $ */
      2 /*
      3  * Copyright (c) 1997-2006 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 */
    946