Home | History | Annotate | Line # | Download | only in ic
ispmbox.h revision 1.2
      1 /*	$NetBSD: ispmbox.h,v 1.2 1997/03/12 21:06:57 cgd Exp $	*/
      2 
      3 /*
      4  * Mailbox and Command Definitions for for Qlogic ISP SCSI adapters.
      5  *
      6  * Copyright (c) 1997 by Matthew Jacob
      7  * NASA/Ames Research Center
      8  * All rights reserved.
      9  *
     10  * Redistribution and use in source and binary forms, with or without
     11  * modification, are permitted provided that the following conditions
     12  * are met:
     13  * 1. Redistributions of source code must retain the above copyright
     14  *    notice immediately at the beginning of the file, without modification,
     15  *    this list of conditions, and the following disclaimer.
     16  * 2. Redistributions in binary form must reproduce the above copyright
     17  *    notice, this list of conditions and the following disclaimer in the
     18  *    documentation and/or other materials provided with the distribution.
     19  * 3. 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	_ISPMBOX_H
     36 #define	_ISPMBOX_H
     37 
     38 /*
     39  * Mailbox Command Opcodes
     40  */
     41 
     42 #define MBOX_NO_OP			0x0000
     43 #define MBOX_LOAD_RAM			0x0001
     44 #define MBOX_EXEC_FIRMWARE		0x0002
     45 #define MBOX_DUMP_RAM			0x0003
     46 #define MBOX_WRITE_RAM_WORD		0x0004
     47 #define MBOX_READ_RAM_WORD		0x0005
     48 #define MBOX_MAILBOX_REG_TEST		0x0006
     49 #define MBOX_VERIFY_CHECKSUM		0x0007
     50 #define MBOX_ABOUT_FIRMWARE		0x0008
     51 					/*   9 */
     52 					/*   a */
     53 					/*   b */
     54 					/*   c */
     55 					/*   d */
     56 #define MBOX_CHECK_FIRMWARE		0x000e
     57 					/*   f */
     58 #define MBOX_INIT_REQ_QUEUE		0x0010
     59 #define MBOX_INIT_RES_QUEUE		0x0011
     60 #define MBOX_EXECUTE_IOCB		0x0012
     61 #define MBOX_WAKE_UP			0x0013
     62 #define MBOX_STOP_FIRMWARE		0x0014
     63 #define MBOX_ABORT			0x0015
     64 #define MBOX_ABORT_DEVICE		0x0016
     65 #define MBOX_ABORT_TARGET		0x0017
     66 #define MBOX_BUS_RESET			0x0018
     67 #define MBOX_STOP_QUEUE			0x0019
     68 #define MBOX_START_QUEUE		0x001a
     69 #define MBOX_SINGLE_STEP_QUEUE		0x001b
     70 #define MBOX_ABORT_QUEUE		0x001c
     71 #define MBOX_GET_DEV_QUEUE_STATUS	0x001d
     72 					/*  1e */
     73 #define MBOX_GET_FIRMWARE_STATUS	0x001f
     74 #define MBOX_GET_INIT_SCSI_ID		0x0020
     75 #define MBOX_GET_SELECT_TIMEOUT		0x0021
     76 #define MBOX_GET_RETRY_COUNT		0x0022
     77 #define MBOX_GET_TAG_AGE_LIMIT		0x0023
     78 #define MBOX_GET_CLOCK_RATE		0x0024
     79 #define MBOX_GET_ACT_NEG_STATE		0x0025
     80 #define MBOX_GET_ASYNC_DATA_SETUP_TIME	0x0026
     81 #define MBOX_GET_SBUS_PARAMS		0x0027
     82 #define MBOX_GET_TARGET_PARAMS		0x0028
     83 #define MBOX_GET_DEV_QUEUE_PARAMS	0x0029
     84 					/*  2a */
     85 					/*  2b */
     86 					/*  2c */
     87 					/*  2d */
     88 					/*  2e */
     89 					/*  2f */
     90 #define MBOX_SET_INIT_SCSI_ID		0x0030
     91 #define MBOX_SET_SELECT_TIMEOUT		0x0031
     92 #define MBOX_SET_RETRY_COUNT		0x0032
     93 #define MBOX_SET_TAG_AGE_LIMIT		0x0033
     94 #define MBOX_SET_CLOCK_RATE		0x0034
     95 #define MBOX_SET_ACTIVE_NEG_STATE	0x0035
     96 #define MBOX_SET_ASYNC_DATA_SETUP_TIME	0x0036
     97 #define MBOX_SET_SBUS_CONTROL_PARAMS	0x0037
     98 #define MBOX_SET_TARGET_PARAMS		0x0038
     99 #define MBOX_SET_DEV_QUEUE_PARAMS	0x0039
    100 					/*  3a */
    101 					/*  3b */
    102 					/*  3c */
    103 					/*  3d */
    104 					/*  3e */
    105 					/*  3f */
    106 #define	MBOX_RETURN_BIOS_BLOCK_ADDR	0x0040
    107 #define	MBOX_WRITE_FOUR_RAM_WORDS	0x0041
    108 #define	MBOX_EXEC_BIOS_IOCB		0x0042
    109 
    110 #define	MBOX_BUSY			0x04
    111 
    112 typedef struct {
    113 	u_int16_t param[6];
    114 } mbreg_t;
    115 
    116 /*
    117  * Command Structure Definitions
    118  */
    119 
    120 typedef struct {
    121 	u_int32_t	ds_base;
    122 	u_int32_t	ds_count;
    123 } ispds_t;
    124 
    125 typedef struct {
    126 #if BYTE_ORDER == BIG_ENDIAN
    127 	u_int8_t	rqs_entry_count;
    128 	u_int8_t	rqs_entry_type;
    129 	u_int8_t	rqs_flags;
    130 	u_int8_t	rqs_seqno;
    131 #else
    132 	u_int8_t	rqs_entry_type;
    133 	u_int8_t	rqs_entry_count;
    134 	u_int8_t	rqs_seqno;
    135 	u_int8_t	rqs_flags;
    136 #endif
    137 } isphdr_t;
    138 
    139 /* RQS Flag definitions */
    140 #define	RQSFLAG_CONTINUATION	0x01
    141 #define	RQSFLAG_FULL		0x02
    142 #define	RQSFLAG_BADHEADER	0x04
    143 #define	RQSFLAG_BADPACKET	0x08
    144 /* RQS entry_type definitions */
    145 #define	RQSTYPE_REQUEST		1
    146 #define	RQSTYPE_DATASEG		2
    147 #define	RQSTYPE_RESPONSE	3
    148 #define	RQSTYPE_MARKER		4
    149 #define	RQSTYPE_CMDONLY		5
    150 
    151 
    152 #define	ISP_RQDSEG	4
    153 typedef struct {
    154 	isphdr_t	req_header;
    155 	u_int32_t	req_handle;
    156 #if BYTE_ORDER == BIG_ENDIAN
    157 	u_int8_t	req_target;
    158 	u_int8_t	req_lun_trn;
    159 #else
    160 	u_int8_t	req_lun_trn;
    161 	u_int8_t	req_target;
    162 #endif
    163 	u_int16_t	req_cdblen;
    164 #define	req_modifier	req_cdblen	/* marker packet */
    165 	u_int16_t	req_flags;
    166 	u_int16_t	_res1;
    167 	u_int16_t	req_time;
    168 	u_int16_t	req_seg_count;
    169 	u_int8_t	req_cdb[12];
    170 	ispds_t		req_dataseg[ISP_RQDSEG];
    171 } ispreq_t;
    172 
    173 /* req_flag values */
    174 #define	REQFLAG_NODISCON	0x0001
    175 #define	REQFLAG_HTAG		0x0002
    176 #define	REQFLAG_OTAG		0x0004
    177 #define	REQFLAG_STAG		0x0008
    178 #define	REQFLAG_TARGET_RTN	0x0010
    179 
    180 #define	REQFLAG_NODATA		0x0000
    181 #define	REQFLAG_DATA_IN		0x0020
    182 #define	REQFLAG_DATA_OUT	0x0040
    183 #define	REQFLAG_DATA_UNKNOWN	0x0060
    184 
    185 #define	REQFLAG_DISARQ		0x0100
    186 
    187 typedef struct {
    188 	isphdr_t	req_header;
    189 	u_int32_t	req_handle;
    190 #if	BYTE_ORDER == BIG_ENDIAN
    191 	u_int8_t	req_target;
    192 	u_int8_t	req_lun_trn;
    193 #else
    194 	u_int8_t	req_lun_trn;
    195 	u_int8_t	req_target;
    196 #endif
    197 	u_int16_t	req_cdblen;
    198 	u_int16_t	req_flags;
    199 	u_int16_t	_res1;
    200 	u_int16_t	req_time;
    201 	u_int16_t	req_seg_count;
    202 	u_int8_t	req_cdb[44];
    203 } ispextreq_t;
    204 
    205 #define	ISP_CDSEG	7
    206 typedef struct {
    207 	isphdr_t	req_header;
    208 	u_int32_t	_res1;
    209 	ispds_t		req_dataseg[ISP_CDSEG];
    210 } ispcontreq_t;
    211 
    212 typedef struct {
    213 	isphdr_t	req_header;
    214 	u_int32_t	_res1;
    215 #if	BYTE_ORDER == BIG_ENDIAN
    216 	u_int8_t	req_target;
    217 	u_int8_t	req_lun_trn;
    218 	u_int8_t	_res2;
    219 	u_int8_t	req_modifier;
    220 #else
    221 	u_int8_t	req_lun_trn;
    222 	u_int8_t	req_target;
    223 	u_int8_t	req_modifier;
    224 	u_int8_t	_res2;
    225 #endif
    226 } ipsmarkreq_t;
    227 
    228 #define SYNC_DEVICE	0
    229 #define SYNC_TARGET	1
    230 #define SYNC_ALL	2
    231 
    232 typedef struct {
    233 	isphdr_t	req_header;
    234 	u_int32_t	req_handle;
    235 	u_int16_t	req_scsi_status;
    236 	u_int16_t	req_completion_status;
    237 	u_int16_t	req_state_flags;
    238 	u_int16_t	req_status_flags;
    239 	u_int16_t	req_time;
    240 	u_int16_t	req_sense_len;
    241 	u_int32_t	req_resid;
    242 	u_int8_t	_res1[8];
    243 	u_int8_t	req_sense_data[32];
    244 } ispstatusreq_t;
    245 
    246 #define RQCS_COMPLETE			0x0000
    247 #define RQCS_INCOMPLETE			0x0001
    248 #define RQCS_DMA_ERROR			0x0002
    249 #define RQCS_TRANSPORT_ERROR		0x0003
    250 #define RQCS_RESET_OCCURRED		0x0004
    251 #define RQCS_ABORTED			0x0005
    252 #define RQCS_TIMEOUT			0x0006
    253 #define RQCS_DATA_OVERRUN		0x0007
    254 #define RQCS_COMMAND_OVERRUN		0x0008
    255 #define RQCS_STATUS_OVERRUN		0x0009
    256 #define RQCS_BAD_MESSAGE		0x000a
    257 #define RQCS_NO_MESSAGE_OUT		0x000b
    258 #define RQCS_EXT_ID_FAILED		0x000c
    259 #define RQCS_IDE_MSG_FAILED		0x000d
    260 #define RQCS_ABORT_MSG_FAILED		0x000e
    261 #define RQCS_REJECT_MSG_FAILED		0x000f
    262 #define RQCS_NOP_MSG_FAILED		0x0010
    263 #define RQCS_PARITY_ERROR_MSG_FAILED	0x0011
    264 #define RQCS_DEVICE_RESET_MSG_FAILED	0x0012
    265 #define RQCS_ID_MSG_FAILED		0x0013
    266 #define RQCS_UNEXP_BUS_FREE		0x0014
    267 #define RQCS_DATA_UNDERRUN		0x0015
    268 
    269 
    270 #define RQSF_GOT_BUS			0x0100
    271 #define RQSF_GOT_TARGET			0x0200
    272 #define RQSF_SENT_CDB			0x0400
    273 #define RQSF_TRANFERRED_DATA		0x0800
    274 #define RQSF_GOT_STATUS			0x1000
    275 #define RQSF_GOT_SENSE			0x2000
    276 
    277 #define RQSTF_DISCONNECT		0x0001
    278 #define RQSTF_SYNCHRONOUS		0x0002
    279 #define RQSTF_PARITY_ERROR		0x0004
    280 #define RQSTF_BUS_RESET			0x0008
    281 #define RQSTF_DEVICE_RESET		0x0010
    282 #define RQSTF_ABORTED			0x0020
    283 #define RQSTF_TIMEOUT			0x0040
    284 #define RQSTF_NEGOTIATION		0x0080
    285 
    286 #endif	/* _ISPMBOX_H */
    287