Home | History | Annotate | Line # | Download | only in ic
ispvar.h revision 1.5
      1 /*	$NetBSD: ispvar.h,v 1.5 1997/06/08 06:31:53 thorpej Exp $	*/
      2 
      3 /*
      4  * Soft 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	_ISPVAR_H
     36 #define	_ISPVAR_H
     37 
     38 #include <dev/ic/ispmbox.h>
     39 
     40 /*
     41  * Vector for MD code to provide specific services.
     42  */
     43 struct ispsoftc;
     44 struct ispmdvec {
     45 	u_int16_t	(*dv_rd_reg) __P((struct ispsoftc *, int));
     46 	void		(*dv_wr_reg) __P((struct ispsoftc *, int, u_int16_t));
     47 	int		(*dv_mbxdma) __P((struct ispsoftc *));
     48 	int		(*dv_dmaset) __P((struct ispsoftc *,
     49 		struct scsi_xfer *, ispreq_t *, u_int8_t *, u_int8_t));
     50 	void		(*dv_dmaclr)
     51 		__P((struct ispsoftc *, struct scsi_xfer *, u_int32_t));
     52 	void		(*dv_reset0) __P((struct ispsoftc *));
     53 	void		(*dv_reset1) __P((struct ispsoftc *));
     54 	const u_int16_t *dv_ispfw;	/* ptr to f/w */
     55 	u_int16_t 	dv_fwlen;	/* length of f/w */
     56 	u_int16_t	dv_codeorg;	/* code ORG for f/w */
     57 	/*
     58 	 * Initial values for conf1 register
     59 	 */
     60 	u_int16_t	dv_conf1;
     61 	u_int16_t	dv_clock;	/* clock frequency */
     62 };
     63 
     64 #define	MAX_TARGETS	16
     65 #define	MAX_LUNS	8
     66 
     67 #define	RQUEST_QUEUE_LEN	256
     68 #define	RESULT_QUEUE_LEN	(RQUEST_QUEUE_LEN >> 3)
     69 #define	QENTRY_LEN		64
     70 
     71 #define	ISP_QUEUE_ENTRY(q, idx)	((q) + ((idx) * QENTRY_LEN))
     72 #define	ISP_QUEUE_SIZE(n)	((n) * QENTRY_LEN)
     73 
     74 /*
     75  * Soft Structure per host adapter
     76  */
     77 struct ispsoftc {
     78 	struct device		isp_dev;
     79 	struct ispmdvec *	isp_mdvec;
     80 #define	isp_name	isp_dev.dv_xname
     81 	struct scsi_link	isp_link;
     82 	u_int8_t		isp_max_target;
     83 	u_int8_t		isp_state;
     84 	/*
     85 	 * Host Adapter Parameters, nominally stored in NVRAM
     86 	 */
     87         u_int16_t		isp_adapter_enabled	: 1,
     88         			isp_req_ack_active_neg	: 1,
     89 	        		isp_data_line_active_neg: 1,
     90 				isp_cmd_dma_burst_enable: 1,
     91 				isp_data_dma_burst_enabl: 1,
     92 				isp_fifo_threshold	: 2,
     93 							: 1,
     94 				isp_initiator_id	: 4,
     95         			isp_async_data_setup	: 4;
     96         u_int16_t		isp_selection_timeout;
     97         u_int16_t		isp_max_queue_depth;
     98 	u_int8_t		isp_tag_aging;
     99        	u_int8_t		isp_bus_reset_delay;
    100         u_int8_t		isp_retry_count;
    101         u_int8_t		isp_retry_delay;
    102 	struct {
    103 		u_int8_t	dev_flags;	/* Device Flags - see below */
    104 		u_int8_t	exc_throttle;
    105 		u_int8_t	sync_period;
    106 		u_int8_t	sync_offset	: 4,
    107 				dev_enable	: 1;
    108 	} isp_devparam[MAX_TARGETS];
    109 	/*
    110 	 * Result and Request Queues.
    111 	 */
    112 	volatile u_int8_t	isp_reqidx;	/* index of next request */
    113 	volatile u_int8_t	isp_residx;	/* index of next result */
    114 	volatile u_int8_t	isp_sendmarker;
    115 	volatile u_int8_t	isp_seqno;
    116 	/*
    117 	 * Sheer laziness, but it gets us around the problem
    118 	 * where we don't have a clean way of remembering
    119 	 * which scsi_xfer is bound to which ISP queue entry.
    120 	 *
    121 	 * There are other more clever ways to do this, but,
    122 	 * jeez, so I blow a couple of KB per host adapter...
    123 	 * and it *is* faster.
    124 	 */
    125 	volatile struct scsi_xfer *isp_xflist[RQUEST_QUEUE_LEN];
    126 	/*
    127 	 * request/result queue
    128 	 */
    129 	volatile caddr_t	isp_rquest;
    130 	volatile caddr_t	isp_result;
    131 	u_int32_t		isp_rquest_dma;
    132 	u_int32_t		isp_result_dma;
    133 };
    134 
    135 /*
    136  * ISP States
    137  */
    138 #define	ISP_NILSTATE	0
    139 #define	ISP_RESETSTATE	1
    140 #define	ISP_INITSTATE	2
    141 #define	ISP_RUNSTATE	3
    142 
    143 
    144 /*
    145  * Device Flags
    146  */
    147 #define	DPARM_DISC	0x80
    148 #define	DPARM_PARITY	0x40
    149 #define	DPARM_WIDE	0x20
    150 #define	DPARM_SYNC	0x10
    151 #define	DPARM_TQING	0x08
    152 #define	DPARM_ARQ	0x04
    153 #define	DPARM_QFRZ	0x02
    154 #define	DPARM_RENEG	0x01
    155 
    156 #define	DPARM_DEFAULT	(0xff & ~DPARM_QFRZ)
    157 
    158 
    159 /*
    160  * Macros to read, write ISP registers through MD code
    161  */
    162 
    163 #define	ISP_READ(isp, reg)	\
    164 	(*(isp)->isp_mdvec->dv_rd_reg)((isp), (reg))
    165 
    166 #define	ISP_WRITE(isp, reg, val)	\
    167 	(*(isp)->isp_mdvec->dv_wr_reg)((isp), (reg), (val))
    168 
    169 #define	ISP_MBOXDMASETUP(isp)	\
    170 	(*(isp)->isp_mdvec->dv_mbxdma)((isp))
    171 
    172 #define	ISP_DMASETUP(isp, xs, req, iptrp, optr)	\
    173 	(*(isp)->isp_mdvec->dv_dmaset)((isp), (xs), (req), (iptrp), (optr))
    174 
    175 #define	ISP_DMAFREE(isp, xs, seqno)	\
    176 	if ((isp)->isp_mdvec->dv_dmaclr) \
    177 		 (*(isp)->isp_mdvec->dv_dmaclr)((isp), (xs), (seqno))
    178 
    179 #define	ISP_RESET0(isp)	\
    180 	if ((isp)->isp_mdvec->dv_reset0) (*(isp)->isp_mdvec->dv_reset0)((isp))
    181 #define	ISP_RESET1(isp)	\
    182 	if ((isp)->isp_mdvec->dv_reset1) (*(isp)->isp_mdvec->dv_reset1)((isp))
    183 
    184 
    185 #define	ISP_SETBITS(isp, reg, val)	\
    186  (*(isp)->isp_mdvec->dv_wr_reg)((isp), (reg), ISP_READ((isp), (reg)) | (val))
    187 
    188 #define	ISP_CLRBITS(isp, reg, val)	\
    189  (*(isp)->isp_mdvec->dv_wr_reg)((isp), (reg), ISP_READ((isp), (reg)) & ~(val))
    190 
    191 /*
    192  * Function Prototypes
    193  */
    194 /*
    195  * Reset Hardware.
    196  *
    197  * Only looks at sc_dev.dv_xname, sc_iot and sc_ioh fields.
    198  */
    199 void isp_reset __P((struct ispsoftc *));
    200 
    201 /*
    202  * Initialize Hardware to known state
    203  */
    204 void isp_init __P((struct ispsoftc *));
    205 
    206 /*
    207  * Complete attachment of Hardware
    208  */
    209 void isp_attach __P((struct ispsoftc *));
    210 
    211 /*
    212  * Free any associated resources prior to decommissioning.
    213  */
    214 void isp_uninit __P((struct ispsoftc *));
    215 
    216 /*
    217  * Interrupt Service Routine
    218  */
    219 int isp_intr __P((void *));
    220 
    221 
    222 
    223 
    224 #endif	/* _ISPVAR_H */
    225