Home | History | Annotate | Line # | Download | only in ic
ncr53c9xvar.h revision 1.35.8.1
      1 /*	$NetBSD: ncr53c9xvar.h,v 1.35.8.1 2002/08/29 05:22:31 gehenna Exp $	*/
      2 
      3 /*-
      4  * Copyright (c) 1997 The NetBSD Foundation, Inc.
      5  * All rights reserved.
      6  *
      7  * This code is derived from software contributed to The NetBSD Foundation
      8  * by Jason R. Thorpe of the Numerical Aerospace Simulation Facility,
      9  * NASA Ames Research Center.
     10  *
     11  * Redistribution and use in source and binary forms, with or without
     12  * modification, are permitted provided that the following conditions
     13  * are met:
     14  * 1. Redistributions of source code must retain the above copyright
     15  *    notice, 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. All advertising materials mentioning features or use of this software
     20  *    must display the following acknowledgement:
     21  *	This product includes software developed by the NetBSD
     22  *	Foundation, Inc. and its contributors.
     23  * 4. Neither the name of The NetBSD Foundation nor the names of its
     24  *    contributors may be used to endorse or promote products derived
     25  *    from this software without specific prior written permission.
     26  *
     27  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     28  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     29  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     30  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     31  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     32  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     33  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     34  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     35  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     36  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     37  * POSSIBILITY OF SUCH DAMAGE.
     38  */
     39 
     40 /*
     41  * Copyright (c) 1994 Peter Galbavy.  All rights reserved.
     42  *
     43  * Redistribution and use in source and binary forms, with or without
     44  * modification, are permitted provided that the following conditions
     45  * are met:
     46  * 1. Redistributions of source code must retain the above copyright
     47  *    notice, this list of conditions and the following disclaimer.
     48  * 2. Redistributions in binary form must reproduce the above copyright
     49  *    notice, this list of conditions and the following disclaimer in the
     50  *    documentation and/or other materials provided with the distribution.
     51  * 3. All advertising materials mentioning features or use of this software
     52  *    must display the following acknowledgement:
     53  *	This product includes software developed by Peter Galbavy.
     54  * 4. The name of the author may not be used to endorse or promote products
     55  *    derived from this software without specific prior written permission.
     56  *
     57  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
     58  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
     59  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
     60  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
     61  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
     62  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
     63  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
     64  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
     65  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
     66  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
     67  */
     68 
     69 /* Set this to 1 for normal debug, or 2 for per-target tracing. */
     70 /* #define NCR53C9X_DEBUG		1 */
     71 
     72 /* Wide or differential can have 16 targets */
     73 #define NCR_NTARG		8
     74 #define NCR_NLUN		8
     75 
     76 #define	NCR_ABORT_TIMEOUT	2000	/* time to wait for abort */
     77 #define	NCR_SENSE_TIMEOUT	1000	/* time to wait for sense */
     78 
     79 #define FREQTOCCF(freq)	(((freq + 4) / 5))
     80 
     81 /*
     82  * NCR 53c9x variants.  Note, these values are used as indexes into
     83  * a table; don't modify them unless you know what you're doing.
     84  */
     85 #define	NCR_VARIANT_ESP100		0
     86 #define	NCR_VARIANT_ESP100A		1
     87 #define	NCR_VARIANT_ESP200		2
     88 #define	NCR_VARIANT_NCR53C94		3
     89 #define	NCR_VARIANT_NCR53C96		4
     90 #define	NCR_VARIANT_ESP406		5
     91 #define	NCR_VARIANT_FAS408		6
     92 #define	NCR_VARIANT_FAS216		7
     93 #define	NCR_VARIANT_AM53C974		8
     94 #define	NCR_VARIANT_FAS366		9
     95 #define	NCR_VARIANT_NCR53C90_86C01	10
     96 #define	NCR_VARIANT_MAX			11
     97 
     98 /*
     99  * ECB. Holds additional information for each SCSI command Comments: We
    100  * need a separate scsi command block because we may need to overwrite it
    101  * with a request sense command.  Basicly, we refrain from fiddling with
    102  * the scsipi_xfer struct (except do the expected updating of return values).
    103  * We'll generally update: xs->{flags,resid,error,sense,status} and
    104  * occasionally xs->retries.
    105  */
    106 struct ncr53c9x_ecb {
    107 	TAILQ_ENTRY(ncr53c9x_ecb) chain;
    108 	struct scsipi_xfer *xs;	/* SCSI xfer ctrl block from above */
    109 	int flags;
    110 #define	ECB_ALLOC		0x01
    111 #define	ECB_READY		0x02
    112 #define	ECB_SENSE		0x04
    113 #define	ECB_ABORT		0x40
    114 #define	ECB_RESET		0x80
    115 #define	ECB_TENTATIVE_DONE	0x100
    116 	int timeout;
    117 
    118 	struct {
    119 		u_char	msg[3];			/* Selection Id msg and tags */
    120 		struct scsi_generic cmd;	/* SCSI command block */
    121 	} cmd;
    122 	char	*daddr;		/* Saved data pointer */
    123 	int	 clen;		/* Size of command in cmd.cmd */
    124 	int	 dleft;		/* Residue */
    125 	u_char 	 stat;		/* SCSI status byte */
    126 	u_char	 tag[2];	/* TAG bytes */
    127 	u_char	 pad[1];
    128 
    129 #if NCR53C9X_DEBUG > 1
    130 	char trace[1000];
    131 #endif
    132 };
    133 #if NCR53C9X_DEBUG > 1
    134 #define ECB_TRACE(ecb, msg, a, b) do { \
    135 	const char *f = "[" msg "]"; \
    136 	int n = strlen((ecb)->trace); \
    137 	if (n < (sizeof((ecb)->trace)-100)) \
    138 		sprintf((ecb)->trace + n, f,  a, b); \
    139 } while(0)
    140 #else
    141 #define ECB_TRACE(ecb, msg, a, b)
    142 #endif
    143 
    144 /*
    145  * Some info about each (possible) target and LUN on the SCSI bus.
    146  *
    147  * SCSI I and II devices can have up to 8 LUNs, each with up to 256
    148  * outstanding tags.  SCSI III devices have 64-bit LUN identifiers
    149  * that can be sparsely allocated.
    150  *
    151  * Since SCSI II devices can have up to 8 LUNs, we use an array
    152  * of 8 pointers to ncr53c9x_linfo structures for fast lookup.
    153  * Longer LUNs need to traverse the linked list.
    154  */
    155 
    156 struct ncr53c9x_linfo {
    157 	int64_t			lun;
    158 	LIST_ENTRY(ncr53c9x_linfo) link;
    159 	time_t			last_used;
    160 	unsigned char		used;	/* # slots in use */
    161 	unsigned char		avail;	/* where to start scanning */
    162 	unsigned char		busy;
    163 	struct ncr53c9x_ecb	*untagged;
    164 	struct ncr53c9x_ecb	*queued[256];
    165 };
    166 
    167 struct ncr53c9x_tinfo {
    168 	int	cmds;		/* # of commands processed */
    169 	int	dconns;		/* # of disconnects */
    170 	int	touts;		/* # of timeouts */
    171 	int	perrs;		/* # of parity errors */
    172 	int	senses;		/* # of request sense commands sent */
    173 	u_char  flags;
    174 #define T_NEGOTIATE	0x02	/* (Re)Negotiate synchronous options */
    175 #define T_SYNCMODE	0x08	/* SYNC mode has been negotiated */
    176 #define T_SYNCHOFF	0x10	/* SYNC mode for is permanently off */
    177 #define T_RSELECTOFF	0x20	/* RE-SELECT mode is off */
    178 #define T_TAG		0x40	/* Turn on TAG QUEUEs */
    179 #define T_WIDE		0x80	/* Negotiate wide options */
    180 #define T_WDTRSENT	0x04	/* WDTR message has been sent to */
    181 	u_char  period;		/* Period suggestion */
    182 	u_char  offset;		/* Offset suggestion */
    183 	u_char  cfg3;		/* per target config 3  */
    184 	u_char	nextag;		/* Next available tag */
    185 	u_char  width;		/* width suggesion */
    186 	LIST_HEAD(lun_list, ncr53c9x_linfo) luns;
    187 	struct ncr53c9x_linfo *lun[NCR_NLUN]; /* For speedy lookups */
    188 };
    189 
    190 /* Look up a lun in a tinfo */
    191 #define TINFO_LUN(t, l) (					\
    192 	(((l) < NCR_NLUN) && (((t)->lun[(l)]) != NULL))		\
    193 		? ((t)->lun[(l)])				\
    194 		: ncr53c9x_lunsearch((t), (int64_t)(l))		\
    195 )
    196 
    197 /* Register a linenumber (for debugging) */
    198 #define LOGLINE(p)
    199 
    200 #define NCR_SHOWECBS	0x01
    201 #define NCR_SHOWINTS	0x02
    202 #define NCR_SHOWCMDS	0x04
    203 #define NCR_SHOWMISC	0x08
    204 #define NCR_SHOWTRAC	0x10
    205 #define NCR_SHOWSTART	0x20
    206 #define NCR_SHOWPHASE	0x40
    207 #define NCR_SHOWDMA	0x80
    208 #define NCR_SHOWCCMDS	0x100
    209 #define NCR_SHOWMSGS	0x200
    210 
    211 #ifdef NCR53C9X_DEBUG
    212 extern int ncr53c9x_debug;
    213 #define NCR_ECBS(str)	\
    214 	do {if (ncr53c9x_debug & NCR_SHOWECBS) printf str;} while (0)
    215 #define NCR_MISC(str)	\
    216 	do {if (ncr53c9x_debug & NCR_SHOWMISC) printf str;} while (0)
    217 #define NCR_INTS(str)	\
    218 	do {if (ncr53c9x_debug & NCR_SHOWINTS) printf str;} while (0)
    219 #define NCR_TRACE(str)	\
    220 	do {if (ncr53c9x_debug & NCR_SHOWTRAC) printf str;} while (0)
    221 #define NCR_CMDS(str)	\
    222 	do {if (ncr53c9x_debug & NCR_SHOWCMDS) printf str;} while (0)
    223 #define NCR_START(str)	\
    224 	do {if (ncr53c9x_debug & NCR_SHOWSTART) printf str;}while (0)
    225 #define NCR_PHASE(str)	\
    226 	do {if (ncr53c9x_debug & NCR_SHOWPHASE) printf str;}while (0)
    227 #define NCR_DMA(str)	\
    228 	do {if (ncr53c9x_debug & NCR_SHOWDMA) printf str;}while (0)
    229 #define NCR_MSGS(str)	\
    230 	do {if (ncr53c9x_debug & NCR_SHOWMSGS) printf str;}while (0)
    231 #else
    232 #define NCR_ECBS(str)
    233 #define NCR_MISC(str)
    234 #define NCR_INTS(str)
    235 #define NCR_TRACE(str)
    236 #define NCR_CMDS(str)
    237 #define NCR_START(str)
    238 #define NCR_PHASE(str)
    239 #define NCR_DMA(str)
    240 #define NCR_MSGS(str)
    241 #endif
    242 
    243 #define NCR_MAX_MSG_LEN 8
    244 
    245 struct ncr53c9x_softc;
    246 
    247 /*
    248  * Function switch used as glue to MD code.
    249  */
    250 struct ncr53c9x_glue {
    251 	/* Mandatory entry points. */
    252 	u_char	(*gl_read_reg)(struct ncr53c9x_softc *, int);
    253 	void	(*gl_write_reg)(struct ncr53c9x_softc *, int, u_char);
    254 	int	(*gl_dma_isintr)(struct ncr53c9x_softc *);
    255 	void	(*gl_dma_reset)(struct ncr53c9x_softc *);
    256 	int	(*gl_dma_intr)(struct ncr53c9x_softc *);
    257 	int	(*gl_dma_setup)(struct ncr53c9x_softc *,
    258 		    caddr_t *, size_t *, int, size_t *);
    259 	void	(*gl_dma_go)(struct ncr53c9x_softc *);
    260 	void	(*gl_dma_stop)(struct ncr53c9x_softc *);
    261 	int	(*gl_dma_isactive)(struct ncr53c9x_softc *);
    262 
    263 	/* Optional entry points. */
    264 	void	(*gl_clear_latched_intr)(struct ncr53c9x_softc *);
    265 };
    266 
    267 struct ncr53c9x_softc {
    268 	struct device sc_dev;			/* us as a device */
    269 
    270 	struct evcnt sc_intrcnt;		/* intr count */
    271 	struct scsipi_adapter sc_adapter;	/* out scsipi adapter */
    272 	struct scsipi_channel sc_channel;	/* our scsipi channel */
    273 	struct device *sc_child;		/* attached scsibus, if any */
    274 	struct callout sc_watchdog;		/* periodic timer */
    275 
    276 	struct ncr53c9x_glue *sc_glue;		/* glue to MD code */
    277 
    278 	int	sc_cfflags;			/* Copy of config flags */
    279 
    280 	/* register defaults */
    281 	u_char	sc_cfg1;			/* Config 1 */
    282 	u_char	sc_cfg2;			/* Config 2, not ESP100 */
    283 	u_char	sc_cfg3;			/* Config 3, only ESP200 */
    284 	u_char	sc_cfg3_fscsi;			/* Chip-specific FSCSI bit */
    285 	u_char	sc_cfg4;			/* Config 3, only ESP200 */
    286 	u_char	sc_cfg5;			/* Config 3, only ESP200 */
    287 	u_char	sc_ccf;				/* Clock Conversion */
    288 	u_char	sc_timeout;
    289 
    290 	/* register copies, see espreadregs() */
    291 	u_char	sc_espintr;
    292 	u_char	sc_espstat;
    293 	u_char	sc_espstep;
    294 	u_char  sc_espstat2;
    295 	u_char	sc_espfflags;
    296 
    297 	/* Lists of command blocks */
    298 	TAILQ_HEAD(ecb_list, ncr53c9x_ecb)
    299 		ready_list;
    300 
    301 	struct ncr53c9x_ecb *sc_nexus;		/* Current command */
    302 	struct ncr53c9x_tinfo sc_tinfo[NCR_NTARG];
    303 
    304 	/* Data about the current nexus (updated for every cmd switch) */
    305 	caddr_t	sc_dp;		/* Current data pointer */
    306 	ssize_t	sc_dleft;	/* Data left to transfer */
    307 
    308 	/* Adapter state */
    309 	int	sc_phase;	/* Copy of what bus phase we are in */
    310 	int	sc_prevphase;	/* Copy of what bus phase we were in */
    311 	u_char	sc_state;	/* State applicable to the adapter */
    312 	u_char	sc_flags;	/* See below */
    313 	u_char	sc_selid;
    314 	u_char	sc_lastcmd;
    315 
    316 	/* Message stuff */
    317 	u_short sc_msgify;	/* IDENTIFY message associated with this nexus */
    318 	u_short	sc_msgout;	/* What message is on its way out? */
    319 	u_short	sc_msgpriq;	/* One or more messages to send (encoded) */
    320 	u_short	sc_msgoutq;	/* What messages have been sent so far? */
    321 
    322 	u_char	*sc_omess;	/* MSGOUT buffer */
    323 	caddr_t	sc_omp;		/* Message pointer (for multibyte messages) */
    324 	size_t	sc_omlen;
    325 	u_char	*sc_imess;	/* MSGIN buffer */
    326 	caddr_t	sc_imp;		/* Message pointer (for multibyte messages) */
    327 	size_t	sc_imlen;
    328 
    329 	caddr_t	sc_cmdp;	/* Command pointer (for DMAed commands) */
    330 	size_t	sc_cmdlen;	/* Size of command in transit */
    331 
    332 	/* Hardware attributes */
    333 	int sc_freq;		/* SCSI bus frequency in MHz */
    334 	int sc_id;		/* Our SCSI id */
    335 	int sc_rev;		/* Chip revision */
    336 	int sc_features;	/* Chip features */
    337 	int sc_minsync;		/* Minimum sync period / 4 */
    338 	int sc_maxxfer;		/* Maximum transfer size */
    339 };
    340 
    341 /* values for sc_state */
    342 #define NCR_IDLE	1	/* waiting for something to do */
    343 #define NCR_SELECTING	2	/* SCSI command is arbiting  */
    344 #define NCR_RESELECTED	3	/* Has been reselected */
    345 #define NCR_IDENTIFIED	4	/* Has gotten IFY but not TAG */
    346 #define NCR_CONNECTED	5	/* Actively using the SCSI bus */
    347 #define	NCR_DISCONNECT	6	/* MSG_DISCONNECT received */
    348 #define	NCR_CMDCOMPLETE	7	/* MSG_CMDCOMPLETE received */
    349 #define	NCR_CLEANING	8
    350 #define NCR_SBR		9	/* Expect a SCSI RST because we commanded it */
    351 
    352 /* values for sc_flags */
    353 #define NCR_DROP_MSGI	0x01	/* Discard all msgs (parity err detected) */
    354 #define NCR_ABORTING	0x02	/* Bailing out */
    355 #define NCR_DOINGDMA	0x04	/* The FIFO data path is active! */
    356 #define NCR_SYNCHNEGO	0x08	/* Synch negotiation in progress. */
    357 #define NCR_ICCS	0x10	/* Expect status phase results */
    358 #define NCR_WAITI	0x20	/* Waiting for non-DMA data to arrive */
    359 #define	NCR_ATN		0x40	/* ATN asserted */
    360 #define	NCR_EXPECT_ILLCMD	0x80	/* Expect Illegal Command Interrupt */
    361 
    362 /* values for sc_features */
    363 #define	NCR_F_HASCFG3	0x01	/* chip has CFG3 register */
    364 #define	NCR_F_FASTSCSI	0x02	/* chip supports Fast mode */
    365 #define	NCR_F_DMASELECT 0x04	/*      can do dmaselect */
    366 #define	NCR_F_SELATN3	0x08	/* chip supports SELATN3 command */
    367 
    368 /* values for sc_msgout */
    369 #define SEND_DEV_RESET		0x0001
    370 #define SEND_PARITY_ERROR	0x0002
    371 #define SEND_INIT_DET_ERR	0x0004
    372 #define SEND_REJECT		0x0008
    373 #define SEND_IDENTIFY  		0x0010
    374 #define SEND_ABORT		0x0020
    375 #define SEND_WDTR		0x0040
    376 #define SEND_SDTR		0x0080
    377 #define SEND_TAG		0x0100
    378 
    379 /* SCSI Status codes */
    380 #define ST_MASK			0x3e /* bit 0,6,7 is reserved */
    381 
    382 /* phase bits */
    383 #define IOI			0x01
    384 #define CDI			0x02
    385 #define MSGI			0x04
    386 
    387 /* Information transfer phases */
    388 #define DATA_OUT_PHASE		(0)
    389 #define DATA_IN_PHASE		(IOI)
    390 #define COMMAND_PHASE		(CDI)
    391 #define STATUS_PHASE		(CDI|IOI)
    392 #define MESSAGE_OUT_PHASE	(MSGI|CDI)
    393 #define MESSAGE_IN_PHASE	(MSGI|CDI|IOI)
    394 
    395 #define PHASE_MASK		(MSGI|CDI|IOI)
    396 
    397 /* Some pseudo phases for getphase()*/
    398 #define BUSFREE_PHASE		0x100	/* Re/Selection no longer valid */
    399 #define INVALID_PHASE		0x101	/* Re/Selection valid, but no REQ yet */
    400 #define PSEUDO_PHASE		0x100	/* "pseudo" bit */
    401 
    402 /*
    403  * Macros to read and write the chip's registers.
    404  */
    405 #define	NCR_READ_REG(sc, reg)		\
    406 	(*(sc)->sc_glue->gl_read_reg)((sc), (reg))
    407 #define	NCR_WRITE_REG(sc, reg, val)	\
    408 	(*(sc)->sc_glue->gl_write_reg)((sc), (reg), (val))
    409 
    410 #ifdef NCR53C9X_DEBUG
    411 #define	NCRCMD(sc, cmd) do {						\
    412 	if ((ncr53c9x_debug & NCR_SHOWCCMDS) != 0)			\
    413 		printf("<CMD:0x%x %d>", (unsigned)cmd, __LINE__);	\
    414 	sc->sc_lastcmd = cmd;						\
    415 	NCR_WRITE_REG(sc, NCR_CMD, cmd);				\
    416 } while (0)
    417 #else
    418 #define	NCRCMD(sc, cmd)		NCR_WRITE_REG(sc, NCR_CMD, cmd)
    419 #endif
    420 
    421 /*
    422  * DMA macros for NCR53c9x
    423  */
    424 #define	NCRDMA_ISINTR(sc)	(*(sc)->sc_glue->gl_dma_isintr)((sc))
    425 #define	NCRDMA_RESET(sc)	(*(sc)->sc_glue->gl_dma_reset)((sc))
    426 #define	NCRDMA_INTR(sc)		(*(sc)->sc_glue->gl_dma_intr)((sc))
    427 #define	NCRDMA_SETUP(sc, addr, len, datain, dmasize)	\
    428      (*(sc)->sc_glue->gl_dma_setup)((sc), (addr), (len), (datain), (dmasize))
    429 #define	NCRDMA_GO(sc)		(*(sc)->sc_glue->gl_dma_go)((sc))
    430 #define	NCRDMA_ISACTIVE(sc)	(*(sc)->sc_glue->gl_dma_isactive)((sc))
    431 
    432 /*
    433  * Macro to convert the chip register Clock Per Byte value to
    434  * Sunchronous Transfer Period.
    435  */
    436 #define	ncr53c9x_cpb2stp(sc, cpb)	\
    437 	((250 * (cpb)) / (sc)->sc_freq)
    438 
    439 void	ncr53c9x_attach __P((struct ncr53c9x_softc *));
    440 int	ncr53c9x_detach __P((struct ncr53c9x_softc *, int));
    441 void	ncr53c9x_scsipi_request __P((struct scsipi_channel *chan,
    442 	    scsipi_adapter_req_t req, void *));
    443 void	ncr53c9x_reset __P((struct ncr53c9x_softc *));
    444 int	ncr53c9x_intr __P((void *));
    445 void	ncr53c9x_init __P((struct ncr53c9x_softc *, int));
    446