Home | History | Annotate | Line # | Download | only in ic
ncr53c9xvar.h revision 1.35.10.1
      1 /*	$NetBSD: ncr53c9xvar.h,v 1.35.10.1 2002/11/22 17:50:23 tron 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_NLUN		8
     74 
     75 #define	NCR_ABORT_TIMEOUT	2000	/* time to wait for abort */
     76 #define	NCR_SENSE_TIMEOUT	1000	/* time to wait for sense */
     77 
     78 #define FREQTOCCF(freq)	(((freq + 4) / 5))
     79 
     80 /*
     81  * NCR 53c9x variants.  Note, these values are used as indexes into
     82  * a table; don't modify them unless you know what you're doing.
     83  */
     84 #define	NCR_VARIANT_ESP100		0
     85 #define	NCR_VARIANT_ESP100A		1
     86 #define	NCR_VARIANT_ESP200		2
     87 #define	NCR_VARIANT_NCR53C94		3
     88 #define	NCR_VARIANT_NCR53C96		4
     89 #define	NCR_VARIANT_ESP406		5
     90 #define	NCR_VARIANT_FAS408		6
     91 #define	NCR_VARIANT_FAS216		7
     92 #define	NCR_VARIANT_AM53C974		8
     93 #define	NCR_VARIANT_FAS366		9
     94 #define	NCR_VARIANT_NCR53C90_86C01	10
     95 #define	NCR_VARIANT_MAX			11
     96 
     97 /*
     98  * ECB. Holds additional information for each SCSI command Comments: We
     99  * need a separate scsi command block because we may need to overwrite it
    100  * with a request sense command.  Basicly, we refrain from fiddling with
    101  * the scsipi_xfer struct (except do the expected updating of return values).
    102  * We'll generally update: xs->{flags,resid,error,sense,status} and
    103  * occasionally xs->retries.
    104  */
    105 struct ncr53c9x_ecb {
    106 	TAILQ_ENTRY(ncr53c9x_ecb) chain;
    107 	struct scsipi_xfer *xs;	/* SCSI xfer ctrl block from above */
    108 	int flags;
    109 #define	ECB_ALLOC		0x01
    110 #define	ECB_READY		0x02
    111 #define	ECB_SENSE		0x04
    112 #define	ECB_ABORT		0x40
    113 #define	ECB_RESET		0x80
    114 #define	ECB_TENTATIVE_DONE	0x100
    115 	int timeout;
    116 
    117 	struct {
    118 		u_char	msg[3];			/* Selection Id msg and tags */
    119 		struct scsi_generic cmd;	/* SCSI command block */
    120 	} cmd;
    121 	char	*daddr;		/* Saved data pointer */
    122 	int	 clen;		/* Size of command in cmd.cmd */
    123 	int	 dleft;		/* Residue */
    124 	u_char 	 stat;		/* SCSI status byte */
    125 	u_char	 tag[2];	/* TAG bytes */
    126 	u_char	 pad[1];
    127 
    128 #if NCR53C9X_DEBUG > 1
    129 	char trace[1000];
    130 #endif
    131 };
    132 #if NCR53C9X_DEBUG > 1
    133 #define ECB_TRACE(ecb, msg, a, b) do { \
    134 	const char *f = "[" msg "]"; \
    135 	int n = strlen((ecb)->trace); \
    136 	if (n < (sizeof((ecb)->trace)-100)) \
    137 		sprintf((ecb)->trace + n, f,  a, b); \
    138 } while(0)
    139 #else
    140 #define ECB_TRACE(ecb, msg, a, b)
    141 #endif
    142 
    143 /*
    144  * Some info about each (possible) target and LUN on the SCSI bus.
    145  *
    146  * SCSI I and II devices can have up to 8 LUNs, each with up to 256
    147  * outstanding tags.  SCSI III devices have 64-bit LUN identifiers
    148  * that can be sparsely allocated.
    149  *
    150  * Since SCSI II devices can have up to 8 LUNs, we use an array
    151  * of 8 pointers to ncr53c9x_linfo structures for fast lookup.
    152  * Longer LUNs need to traverse the linked list.
    153  */
    154 
    155 struct ncr53c9x_linfo {
    156 	int64_t			lun;
    157 	LIST_ENTRY(ncr53c9x_linfo) link;
    158 	time_t			last_used;
    159 	unsigned char		used;	/* # slots in use */
    160 	unsigned char		avail;	/* where to start scanning */
    161 	unsigned char		busy;
    162 	struct ncr53c9x_ecb	*untagged;
    163 	struct ncr53c9x_ecb	*queued[256];
    164 };
    165 
    166 struct ncr53c9x_tinfo {
    167 	int	cmds;		/* # of commands processed */
    168 	int	dconns;		/* # of disconnects */
    169 	int	touts;		/* # of timeouts */
    170 	int	perrs;		/* # of parity errors */
    171 	int	senses;		/* # of request sense commands sent */
    172 	u_char  flags;
    173 #define T_NEGOTIATE	0x02	/* (Re)Negotiate synchronous options */
    174 #define T_SYNCMODE	0x08	/* SYNC mode has been negotiated */
    175 #define T_SYNCHOFF	0x10	/* SYNC mode for is permanently off */
    176 #define T_RSELECTOFF	0x20	/* RE-SELECT mode is off */
    177 #define T_TAG		0x40	/* Turn on TAG QUEUEs */
    178 #define T_WIDE		0x80	/* Negotiate wide options */
    179 #define T_WDTRSENT	0x04	/* WDTR message has been sent to */
    180 	u_char  period;		/* Period suggestion */
    181 	u_char  offset;		/* Offset suggestion */
    182 	u_char  cfg3;		/* per target config 3  */
    183 	u_char	nextag;		/* Next available tag */
    184 	u_char  width;		/* width suggesion */
    185 	LIST_HEAD(lun_list, ncr53c9x_linfo) luns;
    186 	struct ncr53c9x_linfo *lun[NCR_NLUN]; /* For speedy lookups */
    187 };
    188 
    189 /* Look up a lun in a tinfo */
    190 #define TINFO_LUN(t, l) (					\
    191 	(((l) < NCR_NLUN) && (((t)->lun[(l)]) != NULL))		\
    192 		? ((t)->lun[(l)])				\
    193 		: ncr53c9x_lunsearch((t), (int64_t)(l))		\
    194 )
    195 
    196 /* Register a linenumber (for debugging) */
    197 #define LOGLINE(p)
    198 
    199 #define NCR_SHOWECBS	0x01
    200 #define NCR_SHOWINTS	0x02
    201 #define NCR_SHOWCMDS	0x04
    202 #define NCR_SHOWMISC	0x08
    203 #define NCR_SHOWTRAC	0x10
    204 #define NCR_SHOWSTART	0x20
    205 #define NCR_SHOWPHASE	0x40
    206 #define NCR_SHOWDMA	0x80
    207 #define NCR_SHOWCCMDS	0x100
    208 #define NCR_SHOWMSGS	0x200
    209 
    210 #ifdef NCR53C9X_DEBUG
    211 extern int ncr53c9x_debug;
    212 #define NCR_ECBS(str)	\
    213 	do {if (ncr53c9x_debug & NCR_SHOWECBS) printf str;} while (0)
    214 #define NCR_MISC(str)	\
    215 	do {if (ncr53c9x_debug & NCR_SHOWMISC) printf str;} while (0)
    216 #define NCR_INTS(str)	\
    217 	do {if (ncr53c9x_debug & NCR_SHOWINTS) printf str;} while (0)
    218 #define NCR_TRACE(str)	\
    219 	do {if (ncr53c9x_debug & NCR_SHOWTRAC) printf str;} while (0)
    220 #define NCR_CMDS(str)	\
    221 	do {if (ncr53c9x_debug & NCR_SHOWCMDS) printf str;} while (0)
    222 #define NCR_START(str)	\
    223 	do {if (ncr53c9x_debug & NCR_SHOWSTART) printf str;}while (0)
    224 #define NCR_PHASE(str)	\
    225 	do {if (ncr53c9x_debug & NCR_SHOWPHASE) printf str;}while (0)
    226 #define NCR_DMA(str)	\
    227 	do {if (ncr53c9x_debug & NCR_SHOWDMA) printf str;}while (0)
    228 #define NCR_MSGS(str)	\
    229 	do {if (ncr53c9x_debug & NCR_SHOWMSGS) printf str;}while (0)
    230 #else
    231 #define NCR_ECBS(str)
    232 #define NCR_MISC(str)
    233 #define NCR_INTS(str)
    234 #define NCR_TRACE(str)
    235 #define NCR_CMDS(str)
    236 #define NCR_START(str)
    237 #define NCR_PHASE(str)
    238 #define NCR_DMA(str)
    239 #define NCR_MSGS(str)
    240 #endif
    241 
    242 #define NCR_MAX_MSG_LEN 8
    243 
    244 struct ncr53c9x_softc;
    245 
    246 /*
    247  * Function switch used as glue to MD code.
    248  */
    249 struct ncr53c9x_glue {
    250 	/* Mandatory entry points. */
    251 	u_char	(*gl_read_reg)(struct ncr53c9x_softc *, int);
    252 	void	(*gl_write_reg)(struct ncr53c9x_softc *, int, u_char);
    253 	int	(*gl_dma_isintr)(struct ncr53c9x_softc *);
    254 	void	(*gl_dma_reset)(struct ncr53c9x_softc *);
    255 	int	(*gl_dma_intr)(struct ncr53c9x_softc *);
    256 	int	(*gl_dma_setup)(struct ncr53c9x_softc *,
    257 		    caddr_t *, size_t *, int, size_t *);
    258 	void	(*gl_dma_go)(struct ncr53c9x_softc *);
    259 	void	(*gl_dma_stop)(struct ncr53c9x_softc *);
    260 	int	(*gl_dma_isactive)(struct ncr53c9x_softc *);
    261 
    262 	/* Optional entry points. */
    263 	void	(*gl_clear_latched_intr)(struct ncr53c9x_softc *);
    264 };
    265 
    266 struct ncr53c9x_softc {
    267 	struct device sc_dev;			/* us as a device */
    268 
    269 	struct evcnt sc_intrcnt;		/* intr count */
    270 	struct scsipi_adapter sc_adapter;	/* out scsipi adapter */
    271 	struct scsipi_channel sc_channel;	/* our scsipi channel */
    272 	struct device *sc_child;		/* attached scsibus, if any */
    273 	struct callout sc_watchdog;		/* periodic timer */
    274 
    275 	struct ncr53c9x_glue *sc_glue;		/* glue to MD code */
    276 
    277 	int	sc_cfflags;			/* Copy of config flags */
    278 
    279 	/* register defaults */
    280 	u_char	sc_cfg1;			/* Config 1 */
    281 	u_char	sc_cfg2;			/* Config 2, not ESP100 */
    282 	u_char	sc_cfg3;			/* Config 3, ESP200,FAS */
    283 	u_char	sc_cfg3_fscsi;			/* Chip-specific FSCSI bit */
    284 	u_char	sc_cfg4;			/* Config 4, only ESP200 */
    285 	u_char	sc_cfg5;			/* Config 5, only ESP200 */
    286 	u_char	sc_ccf;				/* Clock Conversion */
    287 	u_char	sc_timeout;
    288 
    289 	/* register copies, see espreadregs() */
    290 	u_char	sc_espintr;
    291 	u_char	sc_espstat;
    292 	u_char	sc_espstep;
    293 	u_char  sc_espstat2;
    294 	u_char	sc_espfflags;
    295 
    296 	/* Lists of command blocks */
    297 	TAILQ_HEAD(ecb_list, ncr53c9x_ecb)
    298 		ready_list;
    299 
    300 	struct ncr53c9x_ecb *sc_nexus;		/* Current command */
    301 	int	sc_ntarg;
    302 	struct ncr53c9x_tinfo *sc_tinfo;
    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