xref: /freebsd/sys/dev/isp/isp_freebsd.h (revision b0b1dbdd)
1 /* $FreeBSD$ */
2 /*-
3  * Qlogic ISP SCSI Host Adapter FreeBSD Wrapper Definitions
4  *
5  * Copyright (c) 1997-2008 by Matthew Jacob
6  * All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice immediately at the beginning of the file, without modification,
13  *    this list of conditions, and the following disclaimer.
14  * 2. The name of the author may not be used to endorse or promote products
15  *    derived from this software without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
18  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20  * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
21  * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27  * SUCH DAMAGE.
28  */
29 #ifndef	_ISP_FREEBSD_H
30 #define	_ISP_FREEBSD_H
31 
32 #include <sys/param.h>
33 #include <sys/systm.h>
34 #include <sys/endian.h>
35 #include <sys/jail.h>
36 #include <sys/lock.h>
37 #include <sys/kernel.h>
38 #include <sys/queue.h>
39 #include <sys/malloc.h>
40 #include <sys/mutex.h>
41 #include <sys/condvar.h>
42 #include <sys/rman.h>
43 #include <sys/sysctl.h>
44 
45 #include <sys/proc.h>
46 #include <sys/bus.h>
47 #include <sys/taskqueue.h>
48 
49 #include <machine/bus.h>
50 #include <machine/cpu.h>
51 #include <machine/stdarg.h>
52 
53 #include <cam/cam.h>
54 #include <cam/cam_debug.h>
55 #include <cam/cam_ccb.h>
56 #include <cam/cam_sim.h>
57 #include <cam/cam_xpt.h>
58 #include <cam/cam_xpt_sim.h>
59 #include <cam/cam_debug.h>
60 #include <cam/scsi/scsi_all.h>
61 #include <cam/scsi/scsi_message.h>
62 
63 #include "opt_ddb.h"
64 #include "opt_isp.h"
65 
66 #define	ISP_PLATFORM_VERSION_MAJOR	7
67 #define	ISP_PLATFORM_VERSION_MINOR	10
68 
69 /*
70  * Efficiency- get rid of SBus code && tests unless we need them.
71  */
72 #ifdef __sparc64__
73 #define	ISP_SBUS_SUPPORTED	1
74 #else
75 #define	ISP_SBUS_SUPPORTED	0
76 #endif
77 
78 #define	ISP_IFLAGS	INTR_TYPE_CAM | INTR_ENTROPY | INTR_MPSAFE
79 
80 #define	N_XCMDS		64
81 #define	XCMD_SIZE	512
82 struct ispsoftc;
83 typedef union isp_ecmd {
84 	union isp_ecmd *	next;
85 	uint8_t			data[XCMD_SIZE];
86 } isp_ecmd_t;
87 isp_ecmd_t *	isp_get_ecmd(struct ispsoftc *);
88 void		isp_put_ecmd(struct ispsoftc *, isp_ecmd_t *);
89 
90 #ifdef	ISP_TARGET_MODE
91 #define	ATPDPSIZE	4096
92 #define	ATPDPHASHSIZE	32
93 #define	ATPDPHASH(x)	((((x) >> 24) ^ ((x) >> 16) ^ ((x) >> 8) ^ (x)) &  \
94 			    ((ATPDPHASHSIZE) - 1))
95 
96 #include <dev/isp/isp_target.h>
97 typedef struct atio_private_data {
98 	LIST_ENTRY(atio_private_data)	next;
99 	uint32_t	orig_datalen;
100 	uint32_t	bytes_xfered;
101 	uint32_t	bytes_in_transit;
102 	uint32_t	tag;		/* typically f/w RX_ID */
103 	lun_id_t	lun;
104 	uint32_t	nphdl;
105 	uint32_t	sid;
106 	uint32_t	did;
107 	uint16_t	rxid;	/* wire rxid */
108 	uint16_t	oxid;	/* wire oxid */
109 	uint16_t	word3;	/* PRLI word3 params */
110 	uint16_t	ctcnt;	/* number of CTIOs currently active */
111 	uint8_t		seqno;	/* CTIO sequence number */
112 	uint32_t
113 			srr_notify_rcvd	: 1,
114 			cdb0		: 8,
115 			sendst		: 1,
116 			dead		: 1,
117 			tattr		: 3,
118 			state		: 3;
119 	void *		ests;
120 	/*
121 	 * The current SRR notify copy
122 	 */
123 	uint8_t		srr[64];	/*  sb QENTRY_LEN, but order of definitions is wrong */
124 	void *		srr_ccb;
125 	uint32_t	nsrr;
126 } atio_private_data_t;
127 #define	ATPD_STATE_FREE			0
128 #define	ATPD_STATE_ATIO			1
129 #define	ATPD_STATE_CAM			2
130 #define	ATPD_STATE_CTIO			3
131 #define	ATPD_STATE_LAST_CTIO		4
132 #define	ATPD_STATE_PDON			5
133 
134 #define	ATPD_CCB_OUTSTANDING		16
135 
136 #define	ATPD_SEQ_MASK			0x7f
137 #define	ATPD_SEQ_NOTIFY_CAM		0x80
138 #define	ATPD_SET_SEQNO(hdrp, atp)	((isphdr_t *)hdrp)->rqs_seqno &= ~ATPD_SEQ_MASK, ((isphdr_t *)hdrp)->rqs_seqno |= (atp)->seqno
139 #define	ATPD_GET_SEQNO(hdrp)		(((isphdr_t *)hdrp)->rqs_seqno & ATPD_SEQ_MASK)
140 #define	ATPD_GET_NCAM(hdrp)		((((isphdr_t *)hdrp)->rqs_seqno & ATPD_SEQ_NOTIFY_CAM) != 0)
141 
142 typedef struct inot_private_data inot_private_data_t;
143 struct inot_private_data {
144 	STAILQ_ENTRY(inot_private_data)	next;
145 	isp_notify_t nt;
146 	uint8_t data[64];	/* sb QENTRY_LEN, but order of definitions is wrong */
147 	uint32_t tag_id, seq_id;
148 };
149 typedef struct isp_timed_notify_ack {
150 	void *isp;
151 	void *not;
152 	uint8_t data[64];	 /* sb QENTRY_LEN, but order of definitions is wrong */
153 	struct callout timer;
154 } isp_tna_t;
155 
156 STAILQ_HEAD(ntpdlist, inot_private_data);
157 typedef struct tstate {
158 	SLIST_ENTRY(tstate)	next;
159 	lun_id_t		ts_lun;
160 	struct ccb_hdr_slist	atios;
161 	struct ccb_hdr_slist	inots;
162 	struct ntpdlist		restart_queue;
163 	uint16_t		atio_count;
164 	uint16_t		inot_count;
165 } tstate_t;
166 
167 #define	LUN_HASH_SIZE		32
168 #define	LUN_HASH_FUNC(lun)	((lun) & (LUN_HASH_SIZE - 1))
169 
170 #endif
171 
172 /*
173  * Per command info.
174  */
175 struct isp_pcmd {
176 	struct isp_pcmd *	next;
177 	bus_dmamap_t 		dmap;		/* dma map for this command */
178 	struct ispsoftc *	isp;		/* containing isp */
179 	struct callout		wdog;		/* watchdog timer */
180 	uint32_t		datalen;	/* data length for this command (target mode only) */
181 	uint8_t			totslen;	/* sense length on status response */
182 	uint8_t			cumslen;	/* sense length on status response */
183 	uint8_t 		crn;		/* command reference number */
184 };
185 #define	ISP_PCMD(ccb)		(ccb)->ccb_h.spriv_ptr1
186 #define	PISP_PCMD(ccb)		((struct isp_pcmd *)ISP_PCMD(ccb))
187 
188 /*
189  * Per nexus info.
190  */
191 struct isp_nexus {
192 	uint64_t lun;			/* LUN for target */
193 	uint32_t tgt;			/* TGT for target */
194 	uint8_t crnseed;		/* next command reference number */
195 	struct isp_nexus *next;
196 };
197 #define	NEXUS_HASH_WIDTH	32
198 #define	INITIAL_NEXUS_COUNT	MAX_FC_TARG
199 #define	NEXUS_HASH(tgt, lun)	((tgt + lun) % NEXUS_HASH_WIDTH)
200 
201 /*
202  * Per channel information
203  */
204 SLIST_HEAD(tslist, tstate);
205 TAILQ_HEAD(isp_ccbq, ccb_hdr);
206 LIST_HEAD(atpdlist, atio_private_data);
207 
208 struct isp_fc {
209 	struct cam_sim *sim;
210 	struct cam_path *path;
211 	struct ispsoftc *isp;
212 	struct proc *kproc;
213 	bus_dmamap_t scmap;
214 	uint64_t def_wwpn;
215 	uint64_t def_wwnn;
216 	time_t loop_down_time;
217 	int loop_down_limit;
218 	int gone_device_time;
219 	/*
220 	 * Per target/lun info- just to keep a per-ITL nexus crn count
221 	 */
222 	struct isp_nexus *nexus_hash[NEXUS_HASH_WIDTH];
223 	struct isp_nexus *nexus_free_list;
224 	uint32_t
225 		simqfrozen	: 3,
226 		default_id	: 8,
227 		def_role	: 2,	/* default role */
228 		loop_seen_once	: 1,
229 		fcbsy		: 1,
230 		ready		: 1;
231 	struct callout gdt;	/* gone device timer */
232 	struct task gtask;
233 #ifdef	ISP_TARGET_MODE
234 	struct tslist		lun_hash[LUN_HASH_SIZE];
235 	struct isp_ccbq		waitq;		/* waiting CCBs */
236 	struct ntpdlist		ntfree;
237 	inot_private_data_t	ntpool[ATPDPSIZE];
238 	struct atpdlist		atfree;
239 	struct atpdlist		atused[ATPDPHASHSIZE];
240 	atio_private_data_t	atpool[ATPDPSIZE];
241 #if defined(DEBUG)
242 	unsigned int inject_lost_data_frame;
243 #endif
244 #endif
245 	int			num_threads;
246 };
247 
248 struct isp_spi {
249 	struct cam_sim *sim;
250 	struct cam_path *path;
251 	uint32_t
252 		simqfrozen	: 3,
253 		iid		: 4;
254 #ifdef	ISP_TARGET_MODE
255 	struct tslist		lun_hash[LUN_HASH_SIZE];
256 	struct isp_ccbq		waitq;		/* waiting CCBs */
257 	struct ntpdlist		ntfree;
258 	inot_private_data_t	ntpool[ATPDPSIZE];
259 	struct atpdlist		atfree;
260 	struct atpdlist		atused[ATPDPHASHSIZE];
261 	atio_private_data_t	atpool[ATPDPSIZE];
262 #endif
263 	int			num_threads;
264 };
265 
266 struct isposinfo {
267 	/*
268 	 * Linkage, locking, and identity
269 	 */
270 	struct mtx		lock;
271 	device_t		dev;
272 	struct cdev *		cdev;
273 	struct cam_devq *	devq;
274 
275 	/*
276 	 * Firmware pointer
277 	 */
278 	const struct firmware *	fw;
279 
280 	/*
281 	 * DMA related stuff
282 	 */
283 	struct resource *	regs;
284 	struct resource *	regs2;
285 	bus_dma_tag_t		dmat;
286 	bus_dma_tag_t		reqdmat;
287 	bus_dma_tag_t		respdmat;
288 	bus_dma_tag_t		atiodmat;
289 	bus_dma_tag_t		iocbdmat;
290 	bus_dma_tag_t		scdmat;
291 	bus_dmamap_t		reqmap;
292 	bus_dmamap_t		respmap;
293 	bus_dmamap_t		atiomap;
294 	bus_dmamap_t		iocbmap;
295 
296 	/*
297 	 * Command and transaction related related stuff
298 	 */
299 	struct isp_pcmd *	pcmd_pool;
300 	struct isp_pcmd *	pcmd_free;
301 
302 	uint32_t
303 #ifdef	ISP_TARGET_MODE
304 		tmwanted	: 1,
305 		tmbusy		: 1,
306 #else
307 				: 2,
308 #endif
309 		sixtyfourbit	: 1,	/* sixtyfour bit platform */
310 		timer_active	: 1,
311 		autoconf	: 1;
312 	int			mbox_sleeping;
313 	int			mbox_sleep_ok;
314 	int			mboxbsy;
315 	int			mboxcmd_done;
316 
317 	struct callout		tmo;	/* general timer */
318 
319 	/*
320 	 * misc- needs to be sorted better XXXXXX
321 	 */
322 	int			framesize;
323 	int			exec_throttle;
324 	int			cont_max;
325 
326 	bus_addr_t		ecmd_dma;
327 	isp_ecmd_t *		ecmd_base;
328 	isp_ecmd_t *		ecmd_free;
329 
330 	/*
331 	 * Per-type private storage...
332 	 */
333 	union {
334 		struct isp_fc *fc;
335 		struct isp_spi *spi;
336 		void *ptr;
337 	} pc;
338 
339 	int			is_exiting;
340 };
341 #define	ISP_FC_PC(isp, chan)	(&(isp)->isp_osinfo.pc.fc[(chan)])
342 #define	ISP_SPI_PC(isp, chan)	(&(isp)->isp_osinfo.pc.spi[(chan)])
343 #define	ISP_GET_PC(isp, chan, tag, rslt)		\
344 	if (IS_SCSI(isp)) {				\
345 		rslt = ISP_SPI_PC(isp, chan)-> tag;	\
346 	} else {					\
347 		rslt = ISP_FC_PC(isp, chan)-> tag;	\
348 	}
349 #define	ISP_GET_PC_ADDR(isp, chan, tag, rp)		\
350 	if (IS_SCSI(isp)) {				\
351 		rp = &ISP_SPI_PC(isp, chan)-> tag;	\
352 	} else {					\
353 		rp = &ISP_FC_PC(isp, chan)-> tag;	\
354 	}
355 #define	ISP_SET_PC(isp, chan, tag, val)			\
356 	if (IS_SCSI(isp)) {				\
357 		ISP_SPI_PC(isp, chan)-> tag = val;	\
358 	} else {					\
359 		ISP_FC_PC(isp, chan)-> tag = val;	\
360 	}
361 
362 #define	FCP_NEXT_CRN	isp_fcp_next_crn
363 #define	isp_lock	isp_osinfo.lock
364 #define	isp_regs	isp_osinfo.regs
365 #define	isp_regs2	isp_osinfo.regs2
366 
367 /*
368  * Locking macros...
369  */
370 #define	ISP_LOCK(isp)	mtx_lock(&(isp)->isp_osinfo.lock)
371 #define	ISP_UNLOCK(isp)	mtx_unlock(&(isp)->isp_osinfo.lock)
372 #define	ISP_ASSERT_LOCKED(isp)	mtx_assert(&(isp)->isp_osinfo.lock, MA_OWNED)
373 
374 /*
375  * Required Macros/Defines
376  */
377 #define	ISP_FC_SCRLEN		0x1000
378 
379 #define	ISP_MEMZERO(a, b)	memset(a, 0, b)
380 #define	ISP_MEMCPY		memcpy
381 #define	ISP_SNPRINTF		snprintf
382 #define	ISP_DELAY(x)		DELAY(x)
383 #define	ISP_SLEEP(isp, x)	msleep_sbt(&(isp)->isp_osinfo.is_exiting, \
384     &(isp)->isp_osinfo.lock, 0, "isp_sleep", (x) * SBT_1US, 0, 0)
385 
386 #define	ISP_MIN			imin
387 
388 #ifndef	DIAGNOSTIC
389 #define	ISP_INLINE		__inline
390 #else
391 #define	ISP_INLINE
392 #endif
393 
394 #define	NANOTIME_T		struct timespec
395 #define	GET_NANOTIME		nanotime
396 #define	GET_NANOSEC(x)		((x)->tv_sec * 1000000000 + (x)->tv_nsec)
397 #define	NANOTIME_SUB		isp_nanotime_sub
398 
399 #define	MAXISPREQUEST(isp)	((IS_FC(isp) || IS_ULTRA2(isp))? 1024 : 256)
400 
401 #define	MEMORYBARRIER(isp, type, offset, size, chan)		\
402 switch (type) {							\
403 case SYNC_REQUEST:						\
404 	bus_dmamap_sync(isp->isp_osinfo.reqdmat,		\
405 	   isp->isp_osinfo.reqmap, BUS_DMASYNC_PREWRITE);	\
406 	break;							\
407 case SYNC_RESULT:						\
408 	bus_dmamap_sync(isp->isp_osinfo.respdmat, 		\
409 	   isp->isp_osinfo.respmap, BUS_DMASYNC_POSTREAD);	\
410 	break;							\
411 case SYNC_SFORDEV:						\
412 {								\
413 	struct isp_fc *fc = ISP_FC_PC(isp, chan);		\
414 	bus_dmamap_sync(isp->isp_osinfo.scdmat, fc->scmap,	\
415 	   BUS_DMASYNC_PREREAD | BUS_DMASYNC_PREWRITE);		\
416 	break;							\
417 }								\
418 case SYNC_SFORCPU:						\
419 {								\
420 	struct isp_fc *fc = ISP_FC_PC(isp, chan);		\
421 	bus_dmamap_sync(isp->isp_osinfo.scdmat, fc->scmap,	\
422 	   BUS_DMASYNC_POSTREAD | BUS_DMASYNC_POSTWRITE);	\
423 	break;							\
424 }								\
425 case SYNC_REG:							\
426 	bus_barrier(isp->isp_osinfo.regs, offset, size,		\
427 	    BUS_SPACE_BARRIER_READ | BUS_SPACE_BARRIER_WRITE);	\
428 	break;							\
429 case SYNC_ATIOQ:						\
430 	bus_dmamap_sync(isp->isp_osinfo.atiodmat, 		\
431 	   isp->isp_osinfo.atiomap, BUS_DMASYNC_POSTREAD);	\
432 	break;							\
433 case SYNC_IFORDEV:						\
434 	bus_dmamap_sync(isp->isp_osinfo.iocbdmat, isp->isp_osinfo.iocbmap, \
435 	   BUS_DMASYNC_PREREAD | BUS_DMASYNC_PREWRITE);		\
436 	break;							\
437 case SYNC_IFORCPU:						\
438 	bus_dmamap_sync(isp->isp_osinfo.iocbdmat, isp->isp_osinfo.iocbmap, \
439 	   BUS_DMASYNC_POSTREAD | BUS_DMASYNC_POSTWRITE);	\
440 	break;							\
441 default:							\
442 	break;							\
443 }
444 
445 #define	MEMORYBARRIERW(isp, type, offset, size, chan)		\
446 switch (type) {							\
447 case SYNC_REQUEST:						\
448 	bus_dmamap_sync(isp->isp_osinfo.reqdmat,		\
449 	   isp->isp_osinfo.reqmap, BUS_DMASYNC_PREWRITE);	\
450 	break;							\
451 case SYNC_SFORDEV:						\
452 {								\
453 	struct isp_fc *fc = ISP_FC_PC(isp, chan);		\
454 	bus_dmamap_sync(isp->isp_osinfo.scdmat, fc->scmap,	\
455 	   BUS_DMASYNC_PREWRITE);				\
456 	break;							\
457 }								\
458 case SYNC_SFORCPU:						\
459 {								\
460 	struct isp_fc *fc = ISP_FC_PC(isp, chan);		\
461 	bus_dmamap_sync(isp->isp_osinfo.scdmat, fc->scmap,	\
462 	   BUS_DMASYNC_POSTWRITE);				\
463 	break;							\
464 }								\
465 case SYNC_REG:							\
466 	bus_barrier(isp->isp_osinfo.regs, offset, size,		\
467 	    BUS_SPACE_BARRIER_WRITE);				\
468 	break;							\
469 case SYNC_IFORDEV:						\
470 	bus_dmamap_sync(isp->isp_osinfo.iocbdmat, isp->isp_osinfo.iocbmap, \
471 	   BUS_DMASYNC_PREWRITE);				\
472 	break;							\
473 case SYNC_IFORCPU:						\
474 	bus_dmamap_sync(isp->isp_osinfo.iocbdmat, isp->isp_osinfo.iocbmap, \
475 	   BUS_DMASYNC_POSTWRITE);				\
476 	break;							\
477 default:							\
478 	break;							\
479 }
480 
481 #define	MBOX_ACQUIRE			isp_mbox_acquire
482 #define	MBOX_WAIT_COMPLETE		isp_mbox_wait_complete
483 #define	MBOX_NOTIFY_COMPLETE		isp_mbox_notify_done
484 #define	MBOX_RELEASE			isp_mbox_release
485 
486 #define	FC_SCRATCH_ACQUIRE		isp_fc_scratch_acquire
487 #define	FC_SCRATCH_RELEASE(isp, chan)	isp->isp_osinfo.pc.fc[chan].fcbsy = 0
488 
489 #ifndef	SCSI_GOOD
490 #define	SCSI_GOOD	SCSI_STATUS_OK
491 #endif
492 #ifndef	SCSI_CHECK
493 #define	SCSI_CHECK	SCSI_STATUS_CHECK_COND
494 #endif
495 #ifndef	SCSI_BUSY
496 #define	SCSI_BUSY	SCSI_STATUS_BUSY
497 #endif
498 #ifndef	SCSI_QFULL
499 #define	SCSI_QFULL	SCSI_STATUS_QUEUE_FULL
500 #endif
501 
502 #define	XS_T			struct ccb_scsiio
503 #define	XS_DMA_ADDR_T		bus_addr_t
504 #define XS_GET_DMA64_SEG(a, b, c)		\
505 {						\
506 	ispds64_t *d = a;			\
507 	bus_dma_segment_t *e = b;		\
508 	uint32_t f = c;				\
509 	e += f;					\
510         d->ds_base = DMA_LO32(e->ds_addr);	\
511         d->ds_basehi = DMA_HI32(e->ds_addr);	\
512         d->ds_count = e->ds_len;		\
513 }
514 #define XS_GET_DMA_SEG(a, b, c)			\
515 {						\
516 	ispds_t *d = a;				\
517 	bus_dma_segment_t *e = b;		\
518 	uint32_t f = c;				\
519 	e += f;					\
520         d->ds_base = DMA_LO32(e->ds_addr);	\
521         d->ds_count = e->ds_len;		\
522 }
523 #define	XS_ISP(ccb)		cam_sim_softc(xpt_path_sim((ccb)->ccb_h.path))
524 #define	XS_CHANNEL(ccb)		cam_sim_bus(xpt_path_sim((ccb)->ccb_h.path))
525 #define	XS_TGT(ccb)		(ccb)->ccb_h.target_id
526 #define	XS_LUN(ccb)		(ccb)->ccb_h.target_lun
527 
528 #define	XS_CDBP(ccb)	\
529 	(((ccb)->ccb_h.flags & CAM_CDB_POINTER)? \
530 	 (ccb)->cdb_io.cdb_ptr : (ccb)->cdb_io.cdb_bytes)
531 
532 #define	XS_CDBLEN(ccb)		(ccb)->cdb_len
533 #define	XS_XFRLEN(ccb)		(ccb)->dxfer_len
534 #define	XS_TIME(ccb)		(ccb)->ccb_h.timeout
535 #define	XS_GET_RESID(ccb)	(ccb)->resid
536 #define	XS_SET_RESID(ccb, r)	(ccb)->resid = r
537 #define	XS_STSP(ccb)		(&(ccb)->scsi_status)
538 #define	XS_SNSP(ccb)		(&(ccb)->sense_data)
539 
540 #define	XS_TOT_SNSLEN(ccb)	ccb->sense_len
541 #define	XS_CUR_SNSLEN(ccb)	(ccb->sense_len - ccb->sense_resid)
542 
543 #define	XS_SNSKEY(ccb)		(scsi_get_sense_key(&(ccb)->sense_data, \
544 				 ccb->sense_len - ccb->sense_resid, 1))
545 
546 #define	XS_SNSASC(ccb)		(scsi_get_asc(&(ccb)->sense_data,	\
547 				 ccb->sense_len - ccb->sense_resid, 1))
548 
549 #define	XS_SNSASCQ(ccb)		(scsi_get_ascq(&(ccb)->sense_data,	\
550 				 ccb->sense_len - ccb->sense_resid, 1))
551 #define	XS_TAG_P(ccb)	\
552 	(((ccb)->ccb_h.flags & CAM_TAG_ACTION_VALID) && \
553 	 (ccb)->tag_action != CAM_TAG_ACTION_NONE)
554 
555 #define	XS_TAG_TYPE(ccb)	\
556 	((ccb->tag_action == MSG_SIMPLE_Q_TAG)? REQFLAG_STAG : \
557 	 ((ccb->tag_action == MSG_HEAD_OF_Q_TAG)? REQFLAG_HTAG : REQFLAG_OTAG))
558 
559 
560 #define	XS_SETERR(ccb, v)	(ccb)->ccb_h.status &= ~CAM_STATUS_MASK, \
561 				(ccb)->ccb_h.status |= v
562 
563 #	define	HBA_NOERROR		CAM_REQ_INPROG
564 #	define	HBA_BOTCH		CAM_UNREC_HBA_ERROR
565 #	define	HBA_CMDTIMEOUT		CAM_CMD_TIMEOUT
566 #	define	HBA_SELTIMEOUT		CAM_SEL_TIMEOUT
567 #	define	HBA_TGTBSY		CAM_SCSI_STATUS_ERROR
568 #	define	HBA_REQINVAL		CAM_REQ_INVALID
569 #	define	HBA_BUSRESET		CAM_SCSI_BUS_RESET
570 #	define	HBA_ABORTED		CAM_REQ_ABORTED
571 #	define	HBA_DATAOVR		CAM_DATA_RUN_ERR
572 #	define	HBA_ARQFAIL		CAM_AUTOSENSE_FAIL
573 
574 
575 #define	XS_ERR(ccb)		((ccb)->ccb_h.status & CAM_STATUS_MASK)
576 
577 #define	XS_NOERR(ccb)		(((ccb)->ccb_h.status & CAM_STATUS_MASK) == CAM_REQ_INPROG)
578 
579 #define	XS_INITERR(ccb)		XS_SETERR(ccb, CAM_REQ_INPROG), ccb->sense_resid = ccb->sense_len
580 
581 #define	XS_SAVE_SENSE(xs, sense_ptr, totslen, slen)	do {			\
582 		uint32_t tlen = slen;						\
583 		if (tlen > (xs)->sense_len)					\
584 			tlen = (xs)->sense_len;					\
585 		PISP_PCMD(xs)->totslen = imin((xs)->sense_len, totslen);	\
586 		PISP_PCMD(xs)->cumslen = tlen;					\
587 		memcpy(&(xs)->sense_data, sense_ptr, tlen);			\
588 		(xs)->sense_resid = (xs)->sense_len - tlen;			\
589 		(xs)->ccb_h.status |= CAM_AUTOSNS_VALID;			\
590 	} while (0)
591 
592 #define	XS_SENSE_APPEND(xs, xsnsp, xsnsl)	do {				\
593 		uint32_t off = PISP_PCMD(xs)->cumslen;				\
594 		uint8_t *ptr = &((uint8_t *)(&(xs)->sense_data))[off];		\
595 		uint32_t amt = imin(xsnsl, PISP_PCMD(xs)->totslen - off);	\
596 		if (amt) {							\
597 			memcpy(ptr, xsnsp, amt);				\
598 			(xs)->sense_resid -= amt;				\
599 			PISP_PCMD(xs)->cumslen += amt;				\
600 		}								\
601 	} while (0)
602 
603 #define	XS_SENSE_VALID(xs)	(((xs)->ccb_h.status & CAM_AUTOSNS_VALID) != 0)
604 
605 #define	DEFAULT_FRAMESIZE(isp)		isp->isp_osinfo.framesize
606 #define	DEFAULT_EXEC_THROTTLE(isp)	isp->isp_osinfo.exec_throttle
607 
608 #define	DEFAULT_ROLE(isp, chan)	\
609 	(IS_FC(isp)? ISP_FC_PC(isp, chan)->def_role : ISP_ROLE_INITIATOR)
610 
611 #define	DEFAULT_IID(isp, chan)		isp->isp_osinfo.pc.spi[chan].iid
612 
613 #define	DEFAULT_LOOPID(x, chan)		isp->isp_osinfo.pc.fc[chan].default_id
614 
615 #define DEFAULT_NODEWWN(isp, chan)  	isp_default_wwn(isp, chan, 0, 1)
616 #define DEFAULT_PORTWWN(isp, chan)  	isp_default_wwn(isp, chan, 0, 0)
617 #define ACTIVE_NODEWWN(isp, chan)   	isp_default_wwn(isp, chan, 1, 1)
618 #define ACTIVE_PORTWWN(isp, chan)   	isp_default_wwn(isp, chan, 1, 0)
619 
620 
621 #if	BYTE_ORDER == BIG_ENDIAN
622 #ifdef	ISP_SBUS_SUPPORTED
623 #define	ISP_IOXPUT_8(isp, s, d)		*(d) = s
624 #define	ISP_IOXPUT_16(isp, s, d)				\
625 	*(d) = (isp->isp_bustype == ISP_BT_SBUS)? s : bswap16(s)
626 #define	ISP_IOXPUT_32(isp, s, d)				\
627 	*(d) = (isp->isp_bustype == ISP_BT_SBUS)? s : bswap32(s)
628 #define	ISP_IOXGET_8(isp, s, d)		d = (*((uint8_t *)s))
629 #define	ISP_IOXGET_16(isp, s, d)				\
630 	d = (isp->isp_bustype == ISP_BT_SBUS)?			\
631 	*((uint16_t *)s) : bswap16(*((uint16_t *)s))
632 #define	ISP_IOXGET_32(isp, s, d)				\
633 	d = (isp->isp_bustype == ISP_BT_SBUS)?			\
634 	*((uint32_t *)s) : bswap32(*((uint32_t *)s))
635 
636 #else	/* ISP_SBUS_SUPPORTED */
637 #define	ISP_IOXPUT_8(isp, s, d)		*(d) = s
638 #define	ISP_IOXPUT_16(isp, s, d)	*(d) = bswap16(s)
639 #define	ISP_IOXPUT_32(isp, s, d)	*(d) = bswap32(s)
640 #define	ISP_IOXGET_8(isp, s, d)		d = (*((uint8_t *)s))
641 #define	ISP_IOXGET_16(isp, s, d)	d = bswap16(*((uint16_t *)s))
642 #define	ISP_IOXGET_32(isp, s, d)	d = bswap32(*((uint32_t *)s))
643 #endif
644 #define	ISP_SWIZZLE_NVRAM_WORD(isp, rp)	*rp = bswap16(*rp)
645 #define	ISP_SWIZZLE_NVRAM_LONG(isp, rp)	*rp = bswap32(*rp)
646 
647 #define	ISP_IOZGET_8(isp, s, d)		d = (*((uint8_t *)s))
648 #define	ISP_IOZGET_16(isp, s, d)	d = (*((uint16_t *)s))
649 #define	ISP_IOZGET_32(isp, s, d)	d = (*((uint32_t *)s))
650 #define	ISP_IOZPUT_8(isp, s, d)		*(d) = s
651 #define	ISP_IOZPUT_16(isp, s, d)	*(d) = s
652 #define	ISP_IOZPUT_32(isp, s, d)	*(d) = s
653 
654 
655 #else
656 #define	ISP_IOXPUT_8(isp, s, d)		*(d) = s
657 #define	ISP_IOXPUT_16(isp, s, d)	*(d) = s
658 #define	ISP_IOXPUT_32(isp, s, d)	*(d) = s
659 #define	ISP_IOXGET_8(isp, s, d)		d = *(s)
660 #define	ISP_IOXGET_16(isp, s, d)	d = *(s)
661 #define	ISP_IOXGET_32(isp, s, d)	d = *(s)
662 #define	ISP_SWIZZLE_NVRAM_WORD(isp, rp)
663 #define	ISP_SWIZZLE_NVRAM_LONG(isp, rp)
664 
665 #define	ISP_IOZPUT_8(isp, s, d)		*(d) = s
666 #define	ISP_IOZPUT_16(isp, s, d)	*(d) = bswap16(s)
667 #define	ISP_IOZPUT_32(isp, s, d)	*(d) = bswap32(s)
668 
669 #define	ISP_IOZGET_8(isp, s, d)		d = (*((uint8_t *)(s)))
670 #define	ISP_IOZGET_16(isp, s, d)	d = bswap16(*((uint16_t *)(s)))
671 #define	ISP_IOZGET_32(isp, s, d)	d = bswap32(*((uint32_t *)(s)))
672 
673 #endif
674 
675 #define	ISP_SWAP16(isp, s)	bswap16(s)
676 #define	ISP_SWAP32(isp, s)	bswap32(s)
677 
678 /*
679  * Includes of common header files
680  */
681 
682 #include <dev/isp/ispreg.h>
683 #include <dev/isp/ispvar.h>
684 #include <dev/isp/ispmbox.h>
685 
686 /*
687  * isp_osinfo definiitions && shorthand
688  */
689 #define	SIMQFRZ_RESOURCE	0x1
690 #define	SIMQFRZ_LOOPDOWN	0x2
691 #define	SIMQFRZ_TIMED		0x4
692 
693 #define	isp_dev		isp_osinfo.dev
694 
695 /*
696  * prototypes for isp_pci && isp_freebsd to share
697  */
698 extern int isp_attach(ispsoftc_t *);
699 extern int isp_detach(ispsoftc_t *);
700 extern uint64_t isp_default_wwn(ispsoftc_t *, int, int, int);
701 
702 /*
703  * driver global data
704  */
705 extern int isp_announced;
706 extern int isp_loop_down_limit;
707 extern int isp_gone_device_time;
708 extern int isp_quickboot_time;
709 
710 /*
711  * Platform private flags
712  */
713 
714 /*
715  * Platform Library Functions
716  */
717 void isp_prt(ispsoftc_t *, int level, const char *, ...) __printflike(3, 4);
718 void isp_xs_prt(ispsoftc_t *, XS_T *, int level, const char *, ...) __printflike(4, 5);
719 uint64_t isp_nanotime_sub(struct timespec *, struct timespec *);
720 int isp_mbox_acquire(ispsoftc_t *);
721 void isp_mbox_wait_complete(ispsoftc_t *, mbreg_t *);
722 void isp_mbox_notify_done(ispsoftc_t *);
723 void isp_mbox_release(ispsoftc_t *);
724 int isp_fc_scratch_acquire(ispsoftc_t *, int);
725 int isp_mstohz(int);
726 void isp_platform_intr(void *);
727 void isp_common_dmateardown(ispsoftc_t *, struct ccb_scsiio *, uint32_t);
728 void isp_fcp_reset_crn(ispsoftc_t *, int, uint32_t, int);
729 int isp_fcp_next_crn(ispsoftc_t *, uint8_t *, XS_T *);
730 
731 /*
732  * Platform Version specific defines
733  */
734 #define	BUS_DMA_ROOTARG(x)	bus_get_dma_tag(x)
735 #define	isp_dma_tag_create(a, b, c, d, e, f, g, h, i, j, k, z)	\
736 	bus_dma_tag_create(a, b, c, d, e, f, g, h, i, j, k, \
737 	busdma_lock_mutex, &isp->isp_osinfo.lock, z)
738 
739 #define	isp_setup_intr	bus_setup_intr
740 
741 #define	isp_sim_alloc(a, b, c, d, e, f, g, h)	\
742 	cam_sim_alloc(a, b, c, d, e, &(d)->isp_osinfo.lock, f, g, h)
743 
744 #define	ISP_PATH_PRT(i, l, p, ...)					\
745 	if ((l) == ISP_LOGALL || ((l)& (i)->isp_dblev) != 0) {		\
746                 xpt_print(p, __VA_ARGS__);				\
747         }
748 
749 /*
750  * Platform specific inline functions
751  */
752 
753 /*
754  * ISP General Library functions
755  */
756 
757 #include <dev/isp/isp_library.h>
758 
759 #endif	/* _ISP_FREEBSD_H */
760