/* $NetBSD: isp_target.h,v 1.1 2000/01/05 19:50:06 mjacob Exp $ */ /* * Qlogic Target Mode Structure and Flag Definitions * * Copyright (c) 1997, 1998 * Patrick Stirling * pms@psconsult.com * All rights reserved. * * Additional Copyright (c) 1999 * Matthew Jacob * mjacob@feral.com * All rights reserved. * * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * 1. Redistributions of source code must retain the above copyright * notice immediately at the beginning of the file, without modification, * this list of conditions, and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * 3. The name of the author may not be used to endorse or promote products * derived from this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF * SUCH DAMAGE. * */ #ifndef _ISPTARGET_H #define _ISPTARGET_H /* * Defines for all entry types */ #define QLTM_SVALID 0x80 #define QLTM_SENSELEN 18 /* * Structure for Enable Lun and Modify Lun queue entries */ typedef struct { isphdr_t le_header; u_int32_t le_reserved; u_int8_t le_lun; u_int8_t le_rsvd; u_int8_t le_ops; /* Modify LUN only */ u_int8_t le_tgt; /* Not for FC */ u_int32_t le_flags; /* Not for FC */ u_int8_t le_status; u_int8_t le_reserved2; u_int8_t le_cmd_count; u_int8_t le_in_count; u_int8_t le_cdb6len; /* Not for FC */ u_int8_t le_cdb7len; /* Not for FC */ u_int16_t le_timeout; u_int16_t le_reserved3[20]; } lun_entry_t; /* * le_flags values */ #define LUN_TQAE 0x00000001 /* bit1 Tagged Queue Action Enable */ #define LUN_DSSM 0x01000000 /* bit24 Disable Sending SDP Message */ #define LUN_DM 0x40000000 /* bit30 Disconnects Mandatory */ /* * le_ops values */ #define LUN_CCINCR 0x01 /* increment command count */ #define LUN_CCDECR 0x02 /* decrement command count */ #define LUN_ININCR 0x40 /* increment immed. notify count */ #define LUN_INDECR 0x80 /* decrement immed. notify count */ /* * le_status values */ #define LUN_OK 0x01 /* we be rockin' */ #define LUN_ERR 0x04 /* request completed with error */ #define LUN_INVAL 0x06 /* invalid request */ #define LUN_NOCAP 0x16 /* can't provide requested capability */ #define LUN_ENABLED 0x3E /* LUN already enabled */ /* * Immediate Notify Entry structure */ #define IN_MSGLEN 8 /* 8 bytes */ #define IN_RSVDLEN 8 /* 8 words */ typedef struct { isphdr_t in_header; u_int32_t in_reserved; u_int8_t in_lun; /* lun */ u_int8_t in_iid; /* initiator */ u_int8_t in_reserved2; u_int8_t in_tgt; /* target */ u_int32_t in_flags; u_int8_t in_status; u_int8_t in_rsvd2; u_int8_t in_tag_val; /* tag value */ u_int8_t in_tag_type; /* tag type */ u_int16_t in_seqid; /* sequence id */ u_int8_t in_msg[IN_MSGLEN]; /* SCSI message bytes */ u_int16_t in_reserved3[IN_RSVDLEN]; u_int8_t in_sense[QLTM_SENSELEN];/* suggested sense data */ } in_entry_t; typedef struct { isphdr_t in_header; u_int32_t in_reserved; u_int8_t in_lun; /* lun */ u_int8_t in_iid; /* initiator */ u_int16_t in_scclun; u_int32_t in_reserved2; u_int16_t in_status; u_int16_t in_task_flags; u_int16_t in_seqid; /* sequence id */ } in_fcentry_t; /* * Values for the in_status field */ #define IN_RESET 0x0E /* Bus Reset occurred */ #define IN_NO_RCAP 0x16 /* requested capability not available */ #define IN_IDE_RECEIVED 0x33 /* Initiator Detected Error msg received */ #define IN_RSRC_UNAVAIL 0x34 /* resource unavailable */ #define IN_MSG_RECEIVED 0x36 /* SCSI message received */ #define IN_ABORT_TASK 0x20 /* task named in RX_ID is being aborted (FC) */ #define IN_PORT_LOGOUT 0x29 /* port has logged out (FC) */ #define IN_PORT_CHANGED 0x2A /* port changed */ #define IN_GLOBAL_LOGO 0x2E /* all ports logged out */ /* * Values for the in_task_flags field- should only get one at a time! */ #define TASK_FLAGS_ABORT_TASK (1<<9) #define TASK_FLAGS_CLEAR_TASK_SET (1<<10) #define TASK_FLAGS_TARGET_RESET (1<<13) #define TASK_FLAGS_CLEAR_ACA (1<<14) #define TASK_FLAGS_TERMINATE_TASK (1<<15) #ifndef MSG_ABORT_TAG #define MSG_ABORT_TAG 0x06 #endif #ifndef MSG_CLEAR_QUEUE #define MSG_CLEAR_QUEUE 0x0e #endif #ifndef MSG_BUS_DEV_RESET #define MSG_BUS_DEV_RESET 0x0b #endif #ifndef MSG_REL_RECOVERY #define MSG_REL_RECOVERY 0x10 #endif #ifndef MSG_TERM_IO_PROC #define MSG_TERM_IO_PROC 0x11 #endif /* * Notify Acknowledge Entry structure */ #define NA_RSVDLEN 22 typedef struct { isphdr_t na_header; u_int32_t na_reserved; u_int8_t na_lun; /* lun */ u_int8_t na_iid; /* initiator */ u_int8_t na_reserved2; u_int8_t na_tgt; /* target */ u_int32_t na_flags; u_int8_t na_status; u_int8_t na_event; u_int16_t na_seqid; /* sequence id */ u_int16_t na_reserved3[NA_RSVDLEN]; } na_entry_t; /* * Value for the na_event field */ #define NA_RST_CLRD 0x80 /* Clear an async event notification */ #define NA2_RSVDLEN 21 typedef struct { isphdr_t na_header; u_int32_t na_reserved; u_int8_t na_lun; /* lun */ u_int8_t na_iid; /* initiator */ u_int16_t na_scclun; u_int16_t na_flags; u_int16_t na_reserved2; u_int16_t na_status; u_int16_t na_task_flags; u_int16_t na_seqid; /* sequence id */ u_int16_t na_reserved3[NA2_RSVDLEN]; } na_fcentry_t; #define NAFC_RCOUNT 0x80 /* increment resource count */ #define NAFC_RST_CLRD 0x20 /* Clear LIP Reset */ /* * Accept Target I/O Entry structure */ #define ATIO_CDBLEN 26 typedef struct { isphdr_t at_header; u_int32_t at_reserved; u_int8_t at_lun; /* lun */ u_int8_t at_iid; /* initiator */ u_int8_t at_cdblen; /* cdb length */ u_int8_t at_tgt; /* target */ u_int32_t at_flags; u_int8_t at_status; /* firmware status */ u_int8_t at_scsi_status; /* scsi status */ u_int8_t at_tag_val; /* tag value */ u_int8_t at_tag_type; /* tag type */ u_int8_t at_cdb[ATIO_CDBLEN]; /* received CDB */ u_int8_t at_sense[QLTM_SENSELEN];/* suggested sense data */ } at_entry_t; /* * at_flags values */ #define AT_NODISC 0x00008000 /* disconnect disabled */ #define AT_TQAE 0x00000001 /* Tagged Queue Action enabled */ /* * at_status values */ #define AT_PATH_INVALID 0x07 /* ATIO sent to firmware for disabled lun */ #define AT_RESET 0x0E /* SCSI Bus Reset Occurred */ #define AT_PHASE_ERROR 0x14 /* Bus phase sequence error */ #define AT_NOCAP 0x16 /* Requested capability not available */ #define AT_BDR_MSG 0x17 /* Bus Device Reset msg received */ #define AT_CDB 0x3D /* CDB received */ /* * Accept Target I/O Entry structure, Type 2 */ #define ATIO2_CDBLEN 16 typedef struct { isphdr_t at_header; u_int32_t at_reserved; u_int8_t at_lun; /* lun or reserved */ u_int8_t at_iid; /* initiator */ u_int16_t at_rxid; /* response ID */ u_int16_t at_flags; u_int16_t at_status; /* firmware status */ u_int8_t at_reserved1; u_int8_t at_taskcodes; u_int8_t at_taskflags; u_int8_t at_execodes; u_int8_t at_cdb[ATIO2_CDBLEN]; /* received CDB */ u_int32_t at_datalen; /* allocated data len */ u_int16_t at_scclun; /* SCC Lun or reserved */ u_int16_t at_reserved2; u_int16_t at_scsi_status; u_int8_t at_sense[QLTM_SENSELEN]; } at2_entry_t; #define ATIO2_TC_ATTR_MASK 0x7 #define ATIO2_TC_ATTR_SIMPLEQ 0 #define ATIO2_TC_ATTR_HEADOFQ 1 #define ATIO2_TC_ATTR_ORDERED 2 #define ATIO2_TC_ATTR_ACAQ 4 #define ATIO2_TC_ATTR_UNTAGGED 5 /* * Continue Target I/O Entry structure * Request from driver. The response from the * ISP firmware is the same except that the last 18 * bytes are overwritten by suggested sense data if * the 'autosense valid' bit is set in the status byte. */ typedef struct { isphdr_t ct_header; u_int32_t ct_reserved; u_int8_t ct_lun; /* lun */ u_int8_t ct_iid; /* initiator id */ u_int8_t ct_reserved2; u_int8_t ct_tgt; /* our target id */ u_int32_t ct_flags; u_int8_t ct_status; /* isp status */ u_int8_t ct_scsi_status; /* scsi status */ u_int8_t ct_tag_val; /* tag value */ u_int8_t ct_tag_type; /* tag type */ u_int32_t ct_xfrlen; /* transfer length */ u_int32_t ct_resid; /* residual length */ u_int16_t ct_timeout; u_int16_t ct_seg_count; ispds_t ct_dataseg[ISP_RQDSEG]; } ct_entry_t; /* * ct_flags values */ #define CT_TQAE 0x00000001 /* bit 1, Tagged Queue Action enable */ #define CT_DATA_IN 0x00000040 /* bits 6&7, Data direction */ #define CT_DATA_OUT 0x00000080 /* bits 6&7, Data direction */ #define CT_NO_DATA 0x000000C0 /* bits 6&7, Data direction */ #define CT_CCINCR 0x00000100 /* bit 8, autoincrement atio count */ #define CT_DATAMASK 0x000000C0 /* bits 6&7, Data direction */ #define CT_NODISC 0x00008000 /* bit 15, Disconnects disabled */ #define CT_DSDP 0x01000000 /* bit 24, Disable Save Data Pointers */ #define CT_SENDRDP 0x04000000 /* bit 26, Send Restore Pointers msg */ #define CT_SENDSTATUS 0x80000000 /* bit 31, Send SCSI status byte */ /* * ct_status values * - set by the firmware when it returns the CTIO */ #define CT_OK 0x01 /* completed without error */ #define CT_ABORTED 0x02 /* aborted by host */ #define CT_ERR 0x04 /* see sense data for error */ #define CT_INVAL 0x06 /* request for disabled lun */ #define CT_NOPATH 0x07 /* invalid ITL nexus */ #define CT_INVRXID 0x08 /* (FC only) Invalid RX_ID */ #define CT_RSELTMO 0x0A /* reselection timeout after 2 tries */ #define CT_TIMEOUT 0x0B /* timed out */ #define CT_RESET 0x0E /* SCSI Bus Reset occurred */ #define CT_PHASE_ERROR 0x14 /* Bus phase sequence error */ #define CT_BDR_MSG 0x17 /* Bus Device Reset msg received */ #define CT_TERMINATED 0x19 /* due to Terminate Transfer mbox cmd */ #define CT_PORTNOTAVAIL 0x28 /* port not available */ #define CT_LOGOUT 0x29 /* port logout */ #define CT_PORTCHANGED 0x2A /* port changed */ #define CT_NOACK 0x35 /* Outstanding Immed. Notify. entry */ /* * When the firmware returns a CTIO entry, it may overwrite the last * part of the structure with sense data. This starts at offset 0x2E * into the entry, which is in the middle of ct_dataseg[1]. Rather * than define a new struct for this, I'm just using the sense data * offset. */ #define CTIO_SENSE_OFFSET 0x2E /* * Entry length in u_longs. All entries are the same size so * any one will do as the numerator. */ #define UINT32_ENTRY_SIZE (sizeof(at_entry_t)/sizeof(u_int32_t)) /* * QLA2100 CTIO (type 2) entry */ #define MAXRESPLEN 26 typedef struct { isphdr_t ct_header; u_int32_t ct_reserved; u_int8_t ct_lun; /* lun */ u_int8_t ct_iid; /* initiator id */ u_int16_t ct_rxid; /* response ID */ u_int16_t ct_flags; u_int16_t ct_status; /* isp status */ u_int16_t ct_timeout; u_int16_t ct_seg_count; u_int32_t ct_reloff; /* relative offset */ u_int32_t ct_resid; /* residual length */ union { /* * The three different modes that the target driver * can set the CTIO2 up as. * * The first is for sending FCP_DATA_IUs as well as * (optionally) sending a terminal SCSI status FCP_RSP_IU. * * The second is for sending SCSI sense data in an FCP_RSP_IU. * Note that no FCP_DATA_IUs will be sent. * * The third is for sending FCP_RSP_IUs as built specifically * in system memory as located by the isp_dataseg. */ struct { u_int32_t _reserved; u_int16_t _reserved2; u_int16_t ct_scsi_status; u_int32_t ct_xfrlen; ispds_t ct_dataseg[ISP_RQDSEG_T2]; } m0; struct { u_int16_t _reserved; u_int16_t _reserved2; u_int16_t ct_senselen; u_int16_t ct_scsi_status; u_int16_t ct_resplen; u_int8_t ct_resp[MAXRESPLEN]; } m1; struct { u_int32_t _reserved; u_int16_t _reserved2; u_int16_t _reserved3; u_int32_t ct_datalen; ispds_t ct_fcp_rsp_iudata; } m2; /* * CTIO2 returned from F/W... */ struct { u_int32_t _reserved[4]; u_int16_t ct_scsi_status; u_int8_t ct_sense[QLTM_SENSELEN]; } fw; } rsp; } ct2_entry_t; /* * ct_flags values for CTIO2 */ #define CT2_FLAG_MMASK 0x0003 #define CT2_FLAG_MODE0 0x0000 #define CT2_FLAG_MODE1 0x0001 #define CT2_FLAG_MODE2 0x0002 #define CT2_DATA_IN CT_DATA_IN #define CT2_DATA_OUT CT_DATA_OUT #define CT2_NO_DATA CT_NO_DATA #define CT2_DATAMASK CT_DATAMASK #define CT2_CCINCR 0x0100 #define CT2_FASTPOST 0x0200 #define CT2_SENDSTATUS 0x8000 /* * ct_status values are (mostly) the same as that for ct_entry. */ /* * ct_scsi_status values- the low 8 bits are the normal SCSI status * we know and love. The upper 8 bits are validity markers for FCP_RSP_IU * fields. */ #define CT2_RSPLEN_VALID 0x0100 #define CT2_SNSLEN_VALID 0x0200 #define CT2_DATA_OVER 0x0400 #define CT2_DATA_UNDER 0x0800 /* * Macros for packing/unpacking the above structures */ #ifdef __sparc__ #define ISP_SBUS_SWOZZLE(isp, src, dest, taga, tagb) \ if (isp->isp_bus == ISP_SBUS) { \ source -> taga = dest -> tagb; \ source -> tagb = dest -> taga; \ } else { \ source -> taga = dest -> taga; \ source -> tagb = dest -> taga; \ } #else #define ISP_SBUS_SWOZZLE(isp, src, dest, taga, tagb) \ source -> taga = dest -> taga; \ source -> tagb = dest -> taga; #endif /* This is really only for SBus cards on a sparc */ #ifdef __sparc__ #define ISP_SWIZ_ATIO(isp, dest, vsrc) \ { \ at_entry_t *source = (at_entry_t *) vsrc; \ dest->at_header = source->at_header; \ dest->at_reserved2 = source->at_reserved2; \ ISP_SBUS_SWOZZLE(isp, source, dest, at_lun, at_iid); \ ISP_SBUS_SWOZZLE(isp, source, dest, at_cdblen, at_tgt); \ dest->at_flags = source->at_flags; \ ISP_SBUS_SWOZZLE(isp, source, dest, at_status, at_scsi_status); \ ISP_SBUS_SWOZZLE(isp, source, dest, at_tag_val, at_tag_type); \ MEMCPY(dest->at_cdb, source->at_cdb, ATIO_CDBLEN); \ MEMCPY(dest->at_sense, source->at_sense, QLTM_SENSELEN); \ } #define ISP_SWIZ_CTIO(isp, dest, vsrc) \ { \ ct_entry_t *source = (ct_entry-t *) vsrc; \ dest->ct_header = source->ct_header; \ dest->ct_reserved = source->ct_reserved; \ ISP_SBUS_SWOZZLE(isp, source, dest, ct_lun, ct_iid); \ ISP_SBUS_SWOZZLE(isp, source, dest, ct_rsvd, ct_tgt); \ dest->ct_flags = source->ct_flags; \ ISP_SBUS_SWOZZLE(isp, source, dest, ct_status, ct_scsi_status); \ ISP_SBUS_SWOZZLE(isp, source, dest, ct_tag_val, ct_tag_type); \ dest->ct_xfrlen = source->ct_xfrlen; \ dest->ct_resid = source->ct_resid; \ dest->ct_timeout = source->ct_timeout; \ dest->ct_seg_count = source->ct_seg_count; \ MEMCPY(dest->ct_cdb, source->ct_cdb, ATIO_CDBLEN); \ MEMCPY(dest->ct_sense, source->ct_sense, QLTM_SENSELEN); \ dest->ct_dataseg = source->ct_dataseg; \ } #define ISP_SWIZ_ENABLE_LUN(isp, dest, vsrc) \ { \ lun_entry_t *source = (lun_entry_t *)vsrc; \ dest->le_header = source->le_header; \ dest->le_reserved2 = source->le_reserved2; \ ISP_SBUS_SWOZZLE(isp, source, dest, le_lun, le_rsvd); \ ISP_SBUS_SWOZZLE(isp, source, dest, le_ops, le_tgt); \ dest->le_flags = source->le_flags; \ ISP_SBUS_SWOZZLE(isp, source, dest, le_status, le_rsvd2); \ ISP_SBUS_SWOZZLE(isp, source, dest, le_cmd_count, le_in_count); \ ISP_SBUS_SWOZZLE(isp, source, dest, le_cdb6len, le_cdb7len); \ dest->le_timeout = source->le_timeout; \ dest->le_reserved = source->le_reserved; \ } #define ISP_SWIZ_NOTIFY(isp, dest, vsrc) \ { \ in_entry_type *source = (in_entry_t *)vsrc; \ dest->in_header = source->in_header; \ dest->in_reserved2 = source->in_reserved2; \ ISP_SBUS_SWOZZLE(isp, source, dest, in_lun, in_iid); \ ISP_SBUS_SWOZZLE(isp, source, dest, in_rsvd, in_tgt); \ dest->in_flags = source->in_flags; \ ISP_SBUS_SWOZZLE(isp, source, dest, in_status, in_rsvd2); \ ISP_SBUS_SWOZZLE(isp, source, dest, in_tag_val, in_tag_type); \ dest->in_seqid = source->in_seqid; \ MEMCPY(dest->in_msg, source->in_msg, IN_MSGLEN); \ MEMCPY(dest->in_reserved, source->in_reserved, IN_RESERVED); \ MEMCPY(dest->in_sense, source->in_sense, QLTM_SENSELEN); \ } #define ISP_SWIZ_NOT_ACK(isp, dest) \ { \ na_entry_t *source = (na_entry_t *)vsrc; \ dest->na_header = source->na_header; \ dest->na_reserved2 = source->na_reserved2; \ ISP_SBUS_SWOZZLE(isp, source, dest, na_lun, na_iid); \ ISP_SBUS_SWOZZLE(isp, source, dest, na_rsvd, na_tgt); \ dest->na_flags = source->na_flags; \ ISP_SBUS_SWOZZLE(isp, source, dest, na_status, na_event); \ dest->na_seqid = source->na_seqid; \ MEMCPY(dest->na_reserved, source->na_reserved, NA_RSVDLEN); \ } #define ISP_SWIZ_NOT_ACK_FC(isp, d, s) MEMCPY((void *)d, (void *)s, QENTRY_LEN) #else #define ISP_SWIZ_ATIO(isp, d, s) MEMCPY((void *)d, (void *)s, QENTRY_LEN) #define ISP_SWIZ_CTIO(isp, d, s) MEMCPY((void *)d, (void *)s, QENTRY_LEN) #define ISP_SWIZ_ENABLE_LUN(isp, d, s) MEMCPY((void *)d, (void *)s, QENTRY_LEN) #define ISP_SWIZ_NOTIFY(isp, d, s) MEMCPY((void *)d, (void *)s, QENTRY_LEN) #define ISP_SWIZ_NOT_ACK(isp, d, s) MEMCPY((void *)d, (void *)s, QENTRY_LEN) #define ISP_SWIZ_NOT_ACK_FC(isp, d, s) MEMCPY((void *)d, (void *)s, QENTRY_LEN) #endif #define ISP_SWIZ_ATIO2(isp, d, s) MEMCPY((void *)d, (void *)s, QENTRY_LEN) #define ISP_SWIZ_CTIO2(isp, d, s) MEMCPY((void *)d, (void *)s, QENTRY_LEN) /* * Debug macros */ extern int isp_tdebug; #define ISP_TDQE(isp, msg, idx, arg) \ if (isp_tdebug > 3) isp_print_qentry(isp, msg, idx, arg) #define ITDEBUG(level, msg) if (level > isp_tdebug) PRINTF msg /* * Common (for all platfoms) software SCSI msg/event structures. */ typedef struct { u_int8_t nt_iid; /* inititator id */ u_int8_t nt_tgt; /* target id */ u_int16_t nt_lun; /* logical unit */ u_int8_t nt_bus; /* bus */ u_int8_t nt_tagtype; /* tag type */ u_int16_t nt_tagval; /* tag value */ u_int8_t nt_msg[IN_MSGLEN]; /* message content */ } tmd_msg_t; typedef struct { u_int16_t ev_bus; /* bus */ u_int16_t ev_event; /* type of async event */ } tmd_event_t; /* * Target Mode functions */ /* * This function handles new response queue entry appropriate for target mode. */ int isp_target_notify __P((struct ispsoftc *, void *, u_int16_t *)); /* * Enable/Disable/Modify a logical unit. */ #define DFLT_CMD_CNT (RESULT_QUEUE_LEN >> 1) #define DFLT_INOTIFY (4) int isp_lun_cmd __P((struct ispsoftc *isp, int, int, int, int, u_int32_t)); /* * General request queue 'put' routine for target mode entries. */ int isp_target_put_entry __P((struct ispsoftc *isp, void *)); /* * General routine to put back an ATIO entry- * used for replenishing f/w resource counts. */ int isp_target_put_atio __P((struct ispsoftc *isp, int, int, int, int, int)); /* * General routine to send a final CTIO for a command- used mostly for * local responses. */ int isp_endcmd __P((struct ispsoftc *isp, void *, u_int32_t, u_int32_t)); /* * Handle an asynchronous event */ void isp_target_async __P((struct ispsoftc *, int, int)); #endif /* _ISPTARGET_H */