xref: /freebsd/sys/dev/isp/isp_freebsd.h (revision a01f5aeb09f50aa15a7ee86af08360df40ebaa99)
1c3aac50fSPeter Wemm /* $FreeBSD$ */
2098ca2bdSWarner Losh /*-
33910362aSMatt Jacob  * Qlogic ISP SCSI Host Adapter FreeBSD Wrapper Definitions
4e5265237SMatt Jacob  *
52df76c16SMatt Jacob  * Copyright (c) 1997-2008 by Matthew Jacob
6e5265237SMatt Jacob  * All rights reserved.
76054c3f6SMatt Jacob  *
86054c3f6SMatt Jacob  * Redistribution and use in source and binary forms, with or without
96054c3f6SMatt Jacob  * modification, are permitted provided that the following conditions
106054c3f6SMatt Jacob  * are met:
116054c3f6SMatt Jacob  * 1. Redistributions of source code must retain the above copyright
126054c3f6SMatt Jacob  *    notice immediately at the beginning of the file, without modification,
136054c3f6SMatt Jacob  *    this list of conditions, and the following disclaimer.
14aa57fd6fSMatt Jacob  * 2. The name of the author may not be used to endorse or promote products
15aa57fd6fSMatt Jacob  *    derived from this software without specific prior written permission.
166054c3f6SMatt Jacob  *
176054c3f6SMatt Jacob  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
186054c3f6SMatt Jacob  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
196054c3f6SMatt Jacob  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
206054c3f6SMatt Jacob  * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
216054c3f6SMatt Jacob  * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
226054c3f6SMatt Jacob  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
236054c3f6SMatt Jacob  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
246054c3f6SMatt Jacob  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
256054c3f6SMatt Jacob  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
266054c3f6SMatt Jacob  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
276054c3f6SMatt Jacob  * SUCH DAMAGE.
286054c3f6SMatt Jacob  */
296054c3f6SMatt Jacob #ifndef	_ISP_FREEBSD_H
306054c3f6SMatt Jacob #define	_ISP_FREEBSD_H
316054c3f6SMatt Jacob 
323dd37e43SMatt Jacob #include <sys/param.h>
336054c3f6SMatt Jacob #include <sys/systm.h>
34a30d4b32SMike Barcroft #include <sys/endian.h>
35f34fa851SJohn Baldwin #include <sys/lock.h>
369cd7268eSMatt Jacob #include <sys/kernel.h>
379cd7268eSMatt Jacob #include <sys/queue.h>
3805914a3fSMatt Jacob #include <sys/malloc.h>
3935e0e5b3SJohn Baldwin #include <sys/mutex.h>
405d571944SMatt Jacob #include <sys/condvar.h>
419cd7268eSMatt Jacob 
42df9d46b6SMatt Jacob #include <sys/proc.h>
43c9a6d60bSMatt Jacob #include <sys/bus.h>
446054c3f6SMatt Jacob 
45b460c5c9SMatt Jacob #include <machine/bus.h>
46df9d46b6SMatt Jacob #include <machine/cpu.h>
472df76c16SMatt Jacob #include <machine/stdarg.h>
4857c801f5SMatt Jacob 
49b460c5c9SMatt Jacob #include <cam/cam.h>
50b460c5c9SMatt Jacob #include <cam/cam_debug.h>
51b460c5c9SMatt Jacob #include <cam/cam_ccb.h>
52b460c5c9SMatt Jacob #include <cam/cam_sim.h>
53b460c5c9SMatt Jacob #include <cam/cam_xpt.h>
54b460c5c9SMatt Jacob #include <cam/cam_xpt_sim.h>
55b460c5c9SMatt Jacob #include <cam/cam_debug.h>
56b460c5c9SMatt Jacob #include <cam/scsi/scsi_all.h>
57b460c5c9SMatt Jacob #include <cam/scsi/scsi_message.h>
58bc3dacd6SMatt Jacob 
5967b6f02bSMatt Jacob #include "opt_ddb.h"
60b460c5c9SMatt Jacob #include "opt_isp.h"
61a11af9c9SMatt Jacob 
622df76c16SMatt Jacob #define	ISP_PLATFORM_VERSION_MAJOR	7
632df76c16SMatt Jacob #define	ISP_PLATFORM_VERSION_MINOR	0
64452de53aSMatt Jacob 
654fd13c1bSMatt Jacob /*
664fd13c1bSMatt Jacob  * Efficiency- get rid of SBus code && tests unless we need them.
674fd13c1bSMatt Jacob  */
68f4e98881SRuslan Ermilov #ifdef __sparc64__
694fd13c1bSMatt Jacob #define	ISP_SBUS_SUPPORTED	1
704fd13c1bSMatt Jacob #else
714fd13c1bSMatt Jacob #define	ISP_SBUS_SUPPORTED	0
724fd13c1bSMatt Jacob #endif
73b460c5c9SMatt Jacob 
740a70657fSMatt Jacob #define	ISP_IFLAGS	INTR_TYPE_CAM | INTR_ENTROPY | INTR_MPSAFE
758070de63SMatt Jacob 
7640b27503SMatt Jacob #ifdef	ISP_TARGET_MODE
774fd13c1bSMatt Jacob #define	ISP_TARGET_FUNCTIONS	1
782df76c16SMatt Jacob #define	ATPDPSIZE	4096
792df76c16SMatt Jacob 
802df76c16SMatt Jacob #include <dev/isp/isp_target.h>
812df76c16SMatt Jacob 
8253036e92SMatt Jacob typedef struct {
832df76c16SMatt Jacob 	void *		next;
841dae40ebSMatt Jacob 	uint32_t	orig_datalen;
851dae40ebSMatt Jacob 	uint32_t	bytes_xfered;
861dae40ebSMatt Jacob 	uint32_t	last_xframt;
872df76c16SMatt Jacob 	uint32_t	tag;
882df76c16SMatt Jacob 	uint32_t	lun;
892df76c16SMatt Jacob 	uint32_t	nphdl;
902df76c16SMatt Jacob 	uint32_t	sid;
912df76c16SMatt Jacob 	uint32_t	portid;
922df76c16SMatt Jacob 	uint32_t
932df76c16SMatt Jacob 			oxid	: 16,
942df76c16SMatt Jacob 			cdb0	: 8,
952df76c16SMatt Jacob 				: 1,
962df76c16SMatt Jacob 			dead	: 1,
972df76c16SMatt Jacob 			tattr	: 3,
98759981f4SMatt Jacob 			state	: 3;
9953036e92SMatt Jacob } atio_private_data_t;
100759981f4SMatt Jacob #define	ATPD_STATE_FREE			0
101759981f4SMatt Jacob #define	ATPD_STATE_ATIO			1
102759981f4SMatt Jacob #define	ATPD_STATE_CAM			2
103759981f4SMatt Jacob #define	ATPD_STATE_CTIO			3
104759981f4SMatt Jacob #define	ATPD_STATE_LAST_CTIO		4
105759981f4SMatt Jacob #define	ATPD_STATE_PDON			5
10653036e92SMatt Jacob 
1072df76c16SMatt Jacob typedef union inot_private_data inot_private_data_t;
1082df76c16SMatt Jacob union inot_private_data {
1092df76c16SMatt Jacob 	inot_private_data_t *next;
1102df76c16SMatt Jacob 	struct {
1112df76c16SMatt Jacob 		isp_notify_t nt;	/* must be first! */
1122df76c16SMatt Jacob 		uint8_t data[64];	/* sb QENTRY_LEN, but order of definitions is wrong */
1132df76c16SMatt Jacob 		uint32_t tag_id, seq_id;
1142df76c16SMatt Jacob 	} rd;
1152df76c16SMatt Jacob };
1162df76c16SMatt Jacob 
11740b27503SMatt Jacob typedef struct tstate {
1182df76c16SMatt Jacob 	SLIST_ENTRY(tstate) next;
11940b27503SMatt Jacob 	struct cam_path *owner;
12040b27503SMatt Jacob 	struct ccb_hdr_slist atios;
12140b27503SMatt Jacob 	struct ccb_hdr_slist inots;
1221dae40ebSMatt Jacob 	uint32_t hold;
123759981f4SMatt Jacob 	int atio_count;
1242cd44270SMatt Jacob 	int inot_count;
1252df76c16SMatt Jacob 	inot_private_data_t *	restart_queue;
1262df76c16SMatt Jacob 	inot_private_data_t *	ntfree;
1272df76c16SMatt Jacob 	inot_private_data_t	ntpool[ATPDPSIZE];
1282df76c16SMatt Jacob 	atio_private_data_t *	atfree;
1292df76c16SMatt Jacob 	atio_private_data_t	atpool[ATPDPSIZE];
13040b27503SMatt Jacob } tstate_t;
13140b27503SMatt Jacob 
13240b27503SMatt Jacob #define	LUN_HASH_SIZE		32
1332df76c16SMatt Jacob #define	LUN_HASH_FUNC(lun)	((lun) & (LUN_HASH_SIZE - 1))
1342df76c16SMatt Jacob 
13540b27503SMatt Jacob #endif
13640b27503SMatt Jacob 
1370a70657fSMatt Jacob /*
1380a70657fSMatt Jacob  * Per command info.
1390a70657fSMatt Jacob  */
1400a70657fSMatt Jacob struct isp_pcmd {
1410a70657fSMatt Jacob 	struct isp_pcmd *	next;
1420a70657fSMatt Jacob 	bus_dmamap_t 		dmap;	/* dma map for this command */
1430a70657fSMatt Jacob 	struct ispsoftc *	isp;	/* containing isp */
1440a70657fSMatt Jacob 	struct callout		wdog;	/* watchdog timer */
1450a70657fSMatt Jacob };
1460a70657fSMatt Jacob #define	ISP_PCMD(ccb)		(ccb)->ccb_h.spriv_ptr1
1470a70657fSMatt Jacob #define	PISP_PCMD(ccb)		((struct isp_pcmd *)ISP_PCMD(ccb))
1480a70657fSMatt Jacob 
1492df76c16SMatt Jacob /*
1502df76c16SMatt Jacob  * Per channel information
1512df76c16SMatt Jacob  */
1522df76c16SMatt Jacob SLIST_HEAD(tslist, tstate);
1532df76c16SMatt Jacob 
1542df76c16SMatt Jacob struct isp_fc {
155b460c5c9SMatt Jacob 	struct cam_sim *sim;
156b460c5c9SMatt Jacob 	struct cam_path *path;
1572df76c16SMatt Jacob 	struct ispsoftc *isp;
1582df76c16SMatt Jacob 	struct proc *kproc;
1592df76c16SMatt Jacob 	bus_dma_tag_t tdmat;
1602df76c16SMatt Jacob 	bus_dmamap_t tdmap;
1612df76c16SMatt Jacob 	uint64_t def_wwpn;
1622df76c16SMatt Jacob 	uint64_t def_wwnn;
163f7c631bcSMatt Jacob 	uint32_t loop_down_time;
164f7c631bcSMatt Jacob 	uint32_t loop_down_limit;
165f7c631bcSMatt Jacob 	uint32_t gone_device_time;
1662df76c16SMatt Jacob 	uint32_t
1672df76c16SMatt Jacob #ifdef	ISP_TARGET_MODE
1682df76c16SMatt Jacob #ifdef	ISP_INTERNAL_TARGET
1692df76c16SMatt Jacob 		proc_active	: 1,
1702df76c16SMatt Jacob #endif
1712df76c16SMatt Jacob 		tm_luns_enabled	: 1,
1722df76c16SMatt Jacob 		tm_enable_defer	: 1,
1732df76c16SMatt Jacob 		tm_enabled	: 1,
1742df76c16SMatt Jacob #endif
17510365e5aSMatt Jacob 		simqfrozen	: 3,
1762df76c16SMatt Jacob 		default_id	: 8,
17710365e5aSMatt Jacob 		hysteresis	: 8,
1782df76c16SMatt Jacob 		role		: 2,
179f7c631bcSMatt Jacob 		gdt_running	: 1,
1802df76c16SMatt Jacob 		loop_dead	: 1,
181a01f5aebSMatt Jacob 		fcbsy		: 1,
182a01f5aebSMatt Jacob 		ready		: 1;
1830a70657fSMatt Jacob 	struct callout ldt;	/* loop down timer */
1840a70657fSMatt Jacob 	struct callout gdt;	/* gone device timer */
1852df76c16SMatt Jacob #ifdef	ISP_TARGET_MODE
1862df76c16SMatt Jacob 	struct tslist lun_hash[LUN_HASH_SIZE];
1872df76c16SMatt Jacob #ifdef	ISP_INTERNAL_TARGET
1882df76c16SMatt Jacob 	struct proc *		target_proc;
1899cd7268eSMatt Jacob #endif
1902df76c16SMatt Jacob #endif
1912df76c16SMatt Jacob };
1922df76c16SMatt Jacob 
1932df76c16SMatt Jacob struct isp_spi {
1942df76c16SMatt Jacob 	struct cam_sim *sim;
1952df76c16SMatt Jacob 	struct cam_path *path;
1962df76c16SMatt Jacob 	uint32_t
1972df76c16SMatt Jacob #ifdef	ISP_TARGET_MODE
1982df76c16SMatt Jacob #ifdef	ISP_INTERNAL_TARGET
1992df76c16SMatt Jacob 		proc_active	: 1,
2002df76c16SMatt Jacob #endif
2012df76c16SMatt Jacob 		tm_luns_enabled	: 1,
2022df76c16SMatt Jacob 		tm_enable_defer	: 1,
2032df76c16SMatt Jacob 		tm_enabled	: 1,
2042df76c16SMatt Jacob #endif
2052df76c16SMatt Jacob 		simqfrozen	: 3,
2062df76c16SMatt Jacob 		role		: 3,
2072df76c16SMatt Jacob 		iid		: 4;
2082df76c16SMatt Jacob #ifdef	ISP_TARGET_MODE
2092df76c16SMatt Jacob 	struct tslist lun_hash[LUN_HASH_SIZE];
2102df76c16SMatt Jacob #ifdef	ISP_INTERNAL_TARGET
2112df76c16SMatt Jacob 	struct proc *		target_proc;
2122df76c16SMatt Jacob #endif
2132df76c16SMatt Jacob #endif
2142df76c16SMatt Jacob };
2152df76c16SMatt Jacob 
2162df76c16SMatt Jacob struct isposinfo {
2172df76c16SMatt Jacob 	/*
2182df76c16SMatt Jacob 	 * Linkage, locking, and identity
2192df76c16SMatt Jacob 	 */
2202df76c16SMatt Jacob 	struct mtx		lock;
2212df76c16SMatt Jacob 	device_t		dev;
2222df76c16SMatt Jacob 	struct cdev *		cdev;
2232df76c16SMatt Jacob 	struct intr_config_hook	ehook;
2242df76c16SMatt Jacob 	struct cam_devq *	devq;
2252df76c16SMatt Jacob 
2262df76c16SMatt Jacob 	/*
2272df76c16SMatt Jacob 	 * Firmware pointer
2282df76c16SMatt Jacob 	 */
2292df76c16SMatt Jacob 	const struct firmware *	fw;
2302df76c16SMatt Jacob 
2312df76c16SMatt Jacob 	/*
2322df76c16SMatt Jacob 	 * DMA related sdtuff
2332df76c16SMatt Jacob 	 */
2342df76c16SMatt Jacob 	bus_space_tag_t		bus_tag;
2352df76c16SMatt Jacob 	bus_dma_tag_t		dmat;
2362df76c16SMatt Jacob 	bus_space_handle_t	bus_handle;
2371923f739SMatt Jacob 	bus_dma_tag_t		cdmat;
2381923f739SMatt Jacob 	bus_dmamap_t		cdmap;
2392df76c16SMatt Jacob 
2400a70657fSMatt Jacob 	/*
2412df76c16SMatt Jacob 	 * Command and transaction related related stuff
2420a70657fSMatt Jacob 	 */
2430a70657fSMatt Jacob 	struct isp_pcmd *	pcmd_pool;
2440a70657fSMatt Jacob 	struct isp_pcmd *	pcmd_free;
2450a70657fSMatt Jacob 
2462df76c16SMatt Jacob 	uint32_t
24740b27503SMatt Jacob #ifdef	ISP_TARGET_MODE
2482df76c16SMatt Jacob 		tmwanted	: 1,
2492df76c16SMatt Jacob 		tmbusy		: 1,
2502df76c16SMatt Jacob #else
2512df76c16SMatt Jacob 				: 2,
25240b27503SMatt Jacob #endif
2532df76c16SMatt Jacob 		forcemulti	: 1,
2542df76c16SMatt Jacob 		timer_active	: 1,
2552df76c16SMatt Jacob 		autoconf	: 1,
2562df76c16SMatt Jacob 		ehook_active	: 1,
2572df76c16SMatt Jacob 		disabled	: 1,
2582df76c16SMatt Jacob 		mbox_sleeping	: 1,
2592df76c16SMatt Jacob 		mbox_sleep_ok	: 1,
2602df76c16SMatt Jacob 		mboxcmd_done	: 1,
2612df76c16SMatt Jacob 		mboxbsy		: 1;
2622df76c16SMatt Jacob 
2632df76c16SMatt Jacob 	struct callout		tmo;	/* general timer */
2642df76c16SMatt Jacob 
2652df76c16SMatt Jacob 	/*
2662df76c16SMatt Jacob 	 * misc- needs to be sorted better XXXXXX
2672df76c16SMatt Jacob 	 */
2682df76c16SMatt Jacob 	int			framesize;
2692df76c16SMatt Jacob 	int			exec_throttle;
2702df76c16SMatt Jacob 	int			cont_max;
2712df76c16SMatt Jacob 
2722df76c16SMatt Jacob #ifdef	ISP_TARGET_MODE
2732df76c16SMatt Jacob 	cam_status *		rptr;
2742df76c16SMatt Jacob #endif
2752df76c16SMatt Jacob 
2762df76c16SMatt Jacob 	/*
2772df76c16SMatt Jacob 	 * Per-type private storage...
2782df76c16SMatt Jacob 	 */
2792df76c16SMatt Jacob 	union {
2802df76c16SMatt Jacob 		struct isp_fc *fc;
2812df76c16SMatt Jacob 		struct isp_spi *spi;
2822df76c16SMatt Jacob 		void *ptr;
2832df76c16SMatt Jacob 	} pc;
2846054c3f6SMatt Jacob };
2852df76c16SMatt Jacob #define	ISP_FC_PC(isp, chan)	(&(isp)->isp_osinfo.pc.fc[(chan)])
2862df76c16SMatt Jacob #define	ISP_SPI_PC(isp, chan)	(&(isp)->isp_osinfo.pc.spi[(chan)])
2872df76c16SMatt Jacob #define	ISP_GET_PC(isp, chan, tag, rslt)		\
2882df76c16SMatt Jacob 	if (IS_SCSI(isp)) {				\
2892df76c16SMatt Jacob 		rslt = ISP_SPI_PC(isp, chan)-> tag;	\
2902df76c16SMatt Jacob 	} else {					\
2912df76c16SMatt Jacob 		rslt = ISP_FC_PC(isp, chan)-> tag;	\
2922df76c16SMatt Jacob 	}
2932df76c16SMatt Jacob #define	ISP_GET_PC_ADDR(isp, chan, tag, rp)		\
2942df76c16SMatt Jacob 	if (IS_SCSI(isp)) {				\
2952df76c16SMatt Jacob 		rp = &ISP_SPI_PC(isp, chan)-> tag;	\
2962df76c16SMatt Jacob 	} else {					\
2972df76c16SMatt Jacob 		rp = &ISP_FC_PC(isp, chan)-> tag;	\
2982df76c16SMatt Jacob 	}
2992df76c16SMatt Jacob #define	ISP_SET_PC(isp, chan, tag, val)			\
3002df76c16SMatt Jacob 	if (IS_SCSI(isp)) {				\
3012df76c16SMatt Jacob 		ISP_SPI_PC(isp, chan)-> tag = val;	\
3022df76c16SMatt Jacob 	} else {					\
3032df76c16SMatt Jacob 		ISP_FC_PC(isp, chan)-> tag = val;	\
3042df76c16SMatt Jacob 	}
30518ccaecdSMatt Jacob 
3065d571944SMatt Jacob #define	isp_lock	isp_osinfo.lock
3076a7d12e1SMatt Jacob #define	isp_bus_tag	isp_osinfo.bus_tag
3086a7d12e1SMatt Jacob #define	isp_bus_handle	isp_osinfo.bus_handle
3095d571944SMatt Jacob 
31018ccaecdSMatt Jacob /*
311e5f2f488SMatt Jacob  * Locking macros...
312e5f2f488SMatt Jacob  */
3130a70657fSMatt Jacob #define	ISP_LOCK(isp)	mtx_lock(&isp->isp_osinfo.lock)
3140a70657fSMatt Jacob #define	ISP_UNLOCK(isp)	mtx_unlock(&isp->isp_osinfo.lock)
315e5f2f488SMatt Jacob 
316e5f2f488SMatt Jacob /*
31718ccaecdSMatt Jacob  * Required Macros/Defines
31818ccaecdSMatt Jacob  */
31918ccaecdSMatt Jacob 
3202df76c16SMatt Jacob #define	ISP_FC_SCRLEN		0x1000
32118ccaecdSMatt Jacob 
3222df76c16SMatt Jacob #define	ISP_MEMZERO(a, b)	memset(a, 0, b)
3232df76c16SMatt Jacob #define	ISP_MEMCPY		memcpy
3242df76c16SMatt Jacob #define	ISP_SNPRINTF		snprintf
3252df76c16SMatt Jacob #define	ISP_DELAY		DELAY
3262df76c16SMatt Jacob #define	ISP_SLEEP(isp, x)	DELAY(x)
3272df76c16SMatt Jacob 
3282df76c16SMatt Jacob #ifndef	DIAGNOSTIC
3292df76c16SMatt Jacob #define	ISP_INLINE		__inline
3302df76c16SMatt Jacob #else
3312df76c16SMatt Jacob #define	ISP_INLINE
3322df76c16SMatt Jacob #endif
33318ccaecdSMatt Jacob 
33418ccaecdSMatt Jacob #define	NANOTIME_T		struct timespec
33518ccaecdSMatt Jacob #define	GET_NANOTIME		nanotime
33618ccaecdSMatt Jacob #define	GET_NANOSEC(x)		((x)->tv_sec * 1000000000 + (x)->tv_nsec)
337f7c631bcSMatt Jacob #define	NANOTIME_SUB		isp_nanotime_sub
33818ccaecdSMatt Jacob 
339fdeb9f2fSMatt Jacob #define	MAXISPREQUEST(isp)	((IS_FC(isp) || IS_ULTRA2(isp))? 1024 : 256)
34018ccaecdSMatt Jacob 
34171793c0dSMatt Jacob #define	MEMORYBARRIER(isp, type, offset, size)			\
3421923f739SMatt Jacob switch (type) {							\
3431923f739SMatt Jacob case SYNC_SFORDEV:						\
3441923f739SMatt Jacob case SYNC_REQUEST:						\
3452df76c16SMatt Jacob 	bus_dmamap_sync(isp->isp_osinfo.cdmat,			\
3462df76c16SMatt Jacob 	   isp->isp_osinfo.cdmap, 				\
3471923f739SMatt Jacob 	   BUS_DMASYNC_PREREAD | BUS_DMASYNC_PREWRITE);		\
3481923f739SMatt Jacob 	break;							\
3491923f739SMatt Jacob case SYNC_SFORCPU:						\
3501923f739SMatt Jacob case SYNC_RESULT:						\
3512df76c16SMatt Jacob 	bus_dmamap_sync(isp->isp_osinfo.cdmat, 			\
3522df76c16SMatt Jacob 	   isp->isp_osinfo.cdmap,				\
3531923f739SMatt Jacob 	   BUS_DMASYNC_POSTREAD | BUS_DMASYNC_POSTWRITE);	\
3541923f739SMatt Jacob 	break;							\
3556a7d12e1SMatt Jacob case SYNC_REG:							\
3562df76c16SMatt Jacob 	bus_space_barrier(isp->isp_osinfo.bus_tag,		\
3572df76c16SMatt Jacob 	    isp->isp_osinfo.bus_handle, offset, size,		\
3586a7d12e1SMatt Jacob 	    BUS_SPACE_BARRIER_READ);				\
3596a7d12e1SMatt Jacob 	break;							\
3601923f739SMatt Jacob default:							\
3611923f739SMatt Jacob 	break;							\
3621923f739SMatt Jacob }
36318ccaecdSMatt Jacob 
36410365e5aSMatt Jacob #define	MBOX_ACQUIRE			isp_mbox_acquire
36518ccaecdSMatt Jacob #define	MBOX_WAIT_COMPLETE		isp_mbox_wait_complete
366f7c631bcSMatt Jacob #define	MBOX_NOTIFY_COMPLETE		isp_mbox_notify_done
36710365e5aSMatt Jacob #define	MBOX_RELEASE			isp_mbox_release
36818ccaecdSMatt Jacob 
3692df76c16SMatt Jacob #define	FC_SCRATCH_ACQUIRE		isp_fc_scratch_acquire
3702df76c16SMatt Jacob #define	FC_SCRATCH_RELEASE(isp, chan)	isp->isp_osinfo.pc.fc[chan].fcbsy = 0
37175c1e828SMatt Jacob 
37218ccaecdSMatt Jacob #ifndef	SCSI_GOOD
37318ccaecdSMatt Jacob #define	SCSI_GOOD	SCSI_STATUS_OK
37418ccaecdSMatt Jacob #endif
37518ccaecdSMatt Jacob #ifndef	SCSI_CHECK
37618ccaecdSMatt Jacob #define	SCSI_CHECK	SCSI_STATUS_CHECK_COND
37718ccaecdSMatt Jacob #endif
37818ccaecdSMatt Jacob #ifndef	SCSI_BUSY
37918ccaecdSMatt Jacob #define	SCSI_BUSY	SCSI_STATUS_BUSY
38018ccaecdSMatt Jacob #endif
38118ccaecdSMatt Jacob #ifndef	SCSI_QFULL
38218ccaecdSMatt Jacob #define	SCSI_QFULL	SCSI_STATUS_QUEUE_FULL
38318ccaecdSMatt Jacob #endif
38418ccaecdSMatt Jacob 
38518ccaecdSMatt Jacob #define	XS_T			struct ccb_scsiio
3861dae40ebSMatt Jacob #define	XS_DMA_ADDR_T		bus_addr_t
3872df76c16SMatt Jacob #define XS_GET_DMA64_SEG(a, b, c)		\
3882df76c16SMatt Jacob {						\
3892df76c16SMatt Jacob 	ispds64_t *d = a;			\
3902df76c16SMatt Jacob 	bus_dma_segment_t *e = b;		\
3912df76c16SMatt Jacob 	uint32_t f = c;				\
3922df76c16SMatt Jacob 	e += f;					\
3932df76c16SMatt Jacob         d->ds_base = DMA_LO32(e->ds_addr);	\
3942df76c16SMatt Jacob         d->ds_basehi = DMA_HI32(e->ds_addr);	\
3952df76c16SMatt Jacob         d->ds_count = e->ds_len;		\
3962df76c16SMatt Jacob }
3972df76c16SMatt Jacob #define XS_GET_DMA_SEG(a, b, c)			\
3982df76c16SMatt Jacob {						\
3992df76c16SMatt Jacob 	ispds_t *d = a;				\
4002df76c16SMatt Jacob 	bus_dma_segment_t *e = b;		\
4012df76c16SMatt Jacob 	uint32_t f = c;				\
4022df76c16SMatt Jacob 	e += f;					\
4032df76c16SMatt Jacob         d->ds_base = DMA_LO32(e->ds_addr);	\
4042df76c16SMatt Jacob         d->ds_count = e->ds_len;		\
4052df76c16SMatt Jacob }
4060a70657fSMatt Jacob #define	XS_ISP(ccb)		cam_sim_softc(xpt_path_sim((ccb)->ccb_h.path))
40718ccaecdSMatt Jacob #define	XS_CHANNEL(ccb)		cam_sim_bus(xpt_path_sim((ccb)->ccb_h.path))
40818ccaecdSMatt Jacob #define	XS_TGT(ccb)		(ccb)->ccb_h.target_id
40918ccaecdSMatt Jacob #define	XS_LUN(ccb)		(ccb)->ccb_h.target_lun
41018ccaecdSMatt Jacob 
41118ccaecdSMatt Jacob #define	XS_CDBP(ccb)	\
41218ccaecdSMatt Jacob 	(((ccb)->ccb_h.flags & CAM_CDB_POINTER)? \
41318ccaecdSMatt Jacob 	 (ccb)->cdb_io.cdb_ptr : (ccb)->cdb_io.cdb_bytes)
41418ccaecdSMatt Jacob 
41518ccaecdSMatt Jacob #define	XS_CDBLEN(ccb)		(ccb)->cdb_len
41618ccaecdSMatt Jacob #define	XS_XFRLEN(ccb)		(ccb)->dxfer_len
41718ccaecdSMatt Jacob #define	XS_TIME(ccb)		(ccb)->ccb_h.timeout
4182df76c16SMatt Jacob #define	XS_GET_RESID(ccb)	(ccb)->resid
4192df76c16SMatt Jacob #define	XS_SET_RESID(ccb, r)	(ccb)->resid = r
42018ccaecdSMatt Jacob #define	XS_STSP(ccb)		(&(ccb)->scsi_status)
42118ccaecdSMatt Jacob #define	XS_SNSP(ccb)		(&(ccb)->sense_data)
42218ccaecdSMatt Jacob 
42318ccaecdSMatt Jacob #define	XS_SNSLEN(ccb)		\
42418ccaecdSMatt Jacob 	imin((sizeof((ccb)->sense_data)), ccb->sense_len)
42518ccaecdSMatt Jacob 
42618ccaecdSMatt Jacob #define	XS_SNSKEY(ccb)		((ccb)->sense_data.flags & 0xf)
42718ccaecdSMatt Jacob #define	XS_TAG_P(ccb)	\
42818ccaecdSMatt Jacob 	(((ccb)->ccb_h.flags & CAM_TAG_ACTION_VALID) && \
42918ccaecdSMatt Jacob 	 (ccb)->tag_action != CAM_TAG_ACTION_NONE)
43018ccaecdSMatt Jacob 
43118ccaecdSMatt Jacob #define	XS_TAG_TYPE(ccb)	\
43218ccaecdSMatt Jacob 	((ccb->tag_action == MSG_SIMPLE_Q_TAG)? REQFLAG_STAG : \
43318ccaecdSMatt Jacob 	 ((ccb->tag_action == MSG_HEAD_OF_Q_TAG)? REQFLAG_HTAG : REQFLAG_OTAG))
43418ccaecdSMatt Jacob 
43518ccaecdSMatt Jacob 
43618ccaecdSMatt Jacob #define	XS_SETERR(ccb, v)	(ccb)->ccb_h.status &= ~CAM_STATUS_MASK, \
43718ccaecdSMatt Jacob 				(ccb)->ccb_h.status |= v, \
43818ccaecdSMatt Jacob 				(ccb)->ccb_h.spriv_field0 |= ISP_SPRIV_ERRSET
43918ccaecdSMatt Jacob 
44018ccaecdSMatt Jacob #	define	HBA_NOERROR		CAM_REQ_INPROG
44118ccaecdSMatt Jacob #	define	HBA_BOTCH		CAM_UNREC_HBA_ERROR
44218ccaecdSMatt Jacob #	define	HBA_CMDTIMEOUT		CAM_CMD_TIMEOUT
44318ccaecdSMatt Jacob #	define	HBA_SELTIMEOUT		CAM_SEL_TIMEOUT
44418ccaecdSMatt Jacob #	define	HBA_TGTBSY		CAM_SCSI_STATUS_ERROR
44518ccaecdSMatt Jacob #	define	HBA_BUSRESET		CAM_SCSI_BUS_RESET
44618ccaecdSMatt Jacob #	define	HBA_ABORTED		CAM_REQ_ABORTED
44718ccaecdSMatt Jacob #	define	HBA_DATAOVR		CAM_DATA_RUN_ERR
44818ccaecdSMatt Jacob #	define	HBA_ARQFAIL		CAM_AUTOSENSE_FAIL
44918ccaecdSMatt Jacob 
45018ccaecdSMatt Jacob 
45118ccaecdSMatt Jacob #define	XS_ERR(ccb)		((ccb)->ccb_h.status & CAM_STATUS_MASK)
45218ccaecdSMatt Jacob 
45318ccaecdSMatt Jacob #define	XS_NOERR(ccb)		\
45418ccaecdSMatt Jacob 	(((ccb)->ccb_h.spriv_field0 & ISP_SPRIV_ERRSET) == 0 || \
45518ccaecdSMatt Jacob 	 ((ccb)->ccb_h.status & CAM_STATUS_MASK) == CAM_REQ_INPROG)
45618ccaecdSMatt Jacob 
45718ccaecdSMatt Jacob #define	XS_INITERR(ccb)		\
45818ccaecdSMatt Jacob 	XS_SETERR(ccb, CAM_REQ_INPROG), (ccb)->ccb_h.spriv_field0 = 0
45918ccaecdSMatt Jacob 
460f7c631bcSMatt Jacob #define	XS_SAVE_SENSE(xs, sense_ptr, sense_len)		\
461f7c631bcSMatt Jacob 	(xs)->ccb_h.status |= CAM_AUTOSNS_VALID;	\
462f7c631bcSMatt Jacob 	memcpy(&(xs)->sense_data, sense_ptr, imin(XS_SNSLEN(xs), sense_len))
46318ccaecdSMatt Jacob 
46418ccaecdSMatt Jacob #define	XS_SET_STATE_STAT(a, b, c)
46518ccaecdSMatt Jacob 
4662df76c16SMatt Jacob #define	DEFAULT_FRAMESIZE(isp)		isp->isp_osinfo.framesize
4672df76c16SMatt Jacob #define	DEFAULT_EXEC_THROTTLE(isp)	isp->isp_osinfo.exec_throttle
46818ccaecdSMatt Jacob 
4692df76c16SMatt Jacob #define	GET_DEFAULT_ROLE(isp, chan)	\
4702df76c16SMatt Jacob 	(IS_FC(isp)? ISP_FC_PC(isp, chan)->role : ISP_SPI_PC(isp, chan)->role)
4712df76c16SMatt Jacob #define	SET_DEFAULT_ROLE(isp, chan, val)		\
4722df76c16SMatt Jacob 	if (IS_FC(isp)) { 				\
4732df76c16SMatt Jacob 		ISP_FC_PC(isp, chan)->role = val;	\
4742df76c16SMatt Jacob 	} else {					\
4752df76c16SMatt Jacob 		ISP_SPI_PC(isp, chan)->role = val;	\
4762df76c16SMatt Jacob 	}
47770273f90SMatt Jacob 
4782df76c16SMatt Jacob #define	DEFAULT_IID(isp, chan)		isp->isp_osinfo.pc.spi[chan].iid
4792df76c16SMatt Jacob 
4802df76c16SMatt Jacob #define	DEFAULT_LOOPID(x, chan)		isp->isp_osinfo.pc.fc[chan].default_id
4812df76c16SMatt Jacob 
4822df76c16SMatt Jacob #define DEFAULT_NODEWWN(isp, chan)  	isp_default_wwn(isp, chan, 0, 1)
4832df76c16SMatt Jacob #define DEFAULT_PORTWWN(isp, chan)  	isp_default_wwn(isp, chan, 0, 0)
4842df76c16SMatt Jacob #define ACTIVE_NODEWWN(isp, chan)   	isp_default_wwn(isp, chan, 1, 1)
4852df76c16SMatt Jacob #define ACTIVE_PORTWWN(isp, chan)   	isp_default_wwn(isp, chan, 1, 0)
4862df76c16SMatt Jacob 
48770273f90SMatt Jacob 
4884fd13c1bSMatt Jacob #if	BYTE_ORDER == BIG_ENDIAN
4894fd13c1bSMatt Jacob #ifdef	ISP_SBUS_SUPPORTED
4904fd13c1bSMatt Jacob #define	ISP_IOXPUT_8(isp, s, d)		*(d) = s
4914fd13c1bSMatt Jacob #define	ISP_IOXPUT_16(isp, s, d)				\
4924fd13c1bSMatt Jacob 	*(d) = (isp->isp_bustype == ISP_BT_SBUS)? s : bswap16(s)
4934fd13c1bSMatt Jacob #define	ISP_IOXPUT_32(isp, s, d)				\
4944fd13c1bSMatt Jacob 	*(d) = (isp->isp_bustype == ISP_BT_SBUS)? s : bswap32(s)
4951dae40ebSMatt Jacob #define	ISP_IOXGET_8(isp, s, d)		d = (*((uint8_t *)s))
4964fd13c1bSMatt Jacob #define	ISP_IOXGET_16(isp, s, d)				\
4974fd13c1bSMatt Jacob 	d = (isp->isp_bustype == ISP_BT_SBUS)?			\
4981dae40ebSMatt Jacob 	*((uint16_t *)s) : bswap16(*((uint16_t *)s))
4994fd13c1bSMatt Jacob #define	ISP_IOXGET_32(isp, s, d)				\
5004fd13c1bSMatt Jacob 	d = (isp->isp_bustype == ISP_BT_SBUS)?			\
5011dae40ebSMatt Jacob 	*((uint32_t *)s) : bswap32(*((uint32_t *)s))
50210365e5aSMatt Jacob 
50310365e5aSMatt Jacob #else	/* ISP_SBUS_SUPPORTED */
5044fd13c1bSMatt Jacob #define	ISP_IOXPUT_8(isp, s, d)		*(d) = s
5054fd13c1bSMatt Jacob #define	ISP_IOXPUT_16(isp, s, d)	*(d) = bswap16(s)
5064fd13c1bSMatt Jacob #define	ISP_IOXPUT_32(isp, s, d)	*(d) = bswap32(s)
5071dae40ebSMatt Jacob #define	ISP_IOXGET_8(isp, s, d)		d = (*((uint8_t *)s))
5081dae40ebSMatt Jacob #define	ISP_IOXGET_16(isp, s, d)	d = bswap16(*((uint16_t *)s))
5091dae40ebSMatt Jacob #define	ISP_IOXGET_32(isp, s, d)	d = bswap32(*((uint32_t *)s))
5104fd13c1bSMatt Jacob #endif
5114fd13c1bSMatt Jacob #define	ISP_SWIZZLE_NVRAM_WORD(isp, rp)	*rp = bswap16(*rp)
5124607e8eeSMatt Jacob #define	ISP_SWIZZLE_NVRAM_LONG(isp, rp)	*rp = bswap32(*rp)
51310365e5aSMatt Jacob 
51410365e5aSMatt Jacob #define	ISP_IOZGET_8(isp, s, d)		d = (*((uint8_t *)s))
51510365e5aSMatt Jacob #define	ISP_IOZGET_16(isp, s, d)	d = (*((uint16_t *)s))
51610365e5aSMatt Jacob #define	ISP_IOZGET_32(isp, s, d)	d = (*((uint32_t *)s))
51710365e5aSMatt Jacob #define	ISP_IOZPUT_8(isp, s, d)		*(d) = s
51810365e5aSMatt Jacob #define	ISP_IOZPUT_16(isp, s, d)	*(d) = s
51910365e5aSMatt Jacob #define	ISP_IOZPUT_32(isp, s, d)	*(d) = s
52010365e5aSMatt Jacob 
52110365e5aSMatt Jacob 
5224fd13c1bSMatt Jacob #else
5234fd13c1bSMatt Jacob #define	ISP_IOXPUT_8(isp, s, d)		*(d) = s
5244fd13c1bSMatt Jacob #define	ISP_IOXPUT_16(isp, s, d)	*(d) = s
5254fd13c1bSMatt Jacob #define	ISP_IOXPUT_32(isp, s, d)	*(d) = s
5264fd13c1bSMatt Jacob #define	ISP_IOXGET_8(isp, s, d)		d = *(s)
5274fd13c1bSMatt Jacob #define	ISP_IOXGET_16(isp, s, d)	d = *(s)
5284fd13c1bSMatt Jacob #define	ISP_IOXGET_32(isp, s, d)	d = *(s)
5294fd13c1bSMatt Jacob #define	ISP_SWIZZLE_NVRAM_WORD(isp, rp)
5304607e8eeSMatt Jacob #define	ISP_SWIZZLE_NVRAM_LONG(isp, rp)
53110365e5aSMatt Jacob 
53210365e5aSMatt Jacob #define	ISP_IOZPUT_8(isp, s, d)		*(d) = s
53310365e5aSMatt Jacob #define	ISP_IOZPUT_16(isp, s, d)	*(d) = bswap16(s)
53410365e5aSMatt Jacob #define	ISP_IOZPUT_32(isp, s, d)	*(d) = bswap32(s)
53510365e5aSMatt Jacob 
53610365e5aSMatt Jacob #define	ISP_IOZGET_8(isp, s, d)		d = (*((uint8_t *)(s)))
53710365e5aSMatt Jacob #define	ISP_IOZGET_16(isp, s, d)	d = bswap16(*((uint16_t *)(s)))
53810365e5aSMatt Jacob #define	ISP_IOZGET_32(isp, s, d)	d = bswap32(*((uint32_t *)(s)))
53910365e5aSMatt Jacob 
5404fd13c1bSMatt Jacob #endif
54118ccaecdSMatt Jacob 
5424607e8eeSMatt Jacob #define	ISP_SWAP16(isp, s)	bswap16(s)
5434607e8eeSMatt Jacob #define	ISP_SWAP32(isp, s)	bswap32(s)
5444607e8eeSMatt Jacob 
54518ccaecdSMatt Jacob /*
54618ccaecdSMatt Jacob  * Includes of common header files
54718ccaecdSMatt Jacob  */
54818ccaecdSMatt Jacob 
54918ccaecdSMatt Jacob #include <dev/isp/ispreg.h>
55018ccaecdSMatt Jacob #include <dev/isp/ispvar.h>
55118ccaecdSMatt Jacob #include <dev/isp/ispmbox.h>
55218ccaecdSMatt Jacob 
55318ccaecdSMatt Jacob /*
55418ccaecdSMatt Jacob  * isp_osinfo definiitions && shorthand
55518ccaecdSMatt Jacob  */
556b460c5c9SMatt Jacob #define	SIMQFRZ_RESOURCE	0x1
557b460c5c9SMatt Jacob #define	SIMQFRZ_LOOPDOWN	0x2
5581a43c1fcSMatt Jacob #define	SIMQFRZ_TIMED		0x4
559b460c5c9SMatt Jacob 
560c9a6d60bSMatt Jacob #define	isp_dev		isp_osinfo.dev
561b460c5c9SMatt Jacob 
56218ccaecdSMatt Jacob /*
56318ccaecdSMatt Jacob  * prototypes for isp_pci && isp_freebsd to share
56418ccaecdSMatt Jacob  */
5652df76c16SMatt Jacob extern int isp_attach(ispsoftc_t *);
5662df76c16SMatt Jacob extern void isp_detach(ispsoftc_t *);
5679cd7268eSMatt Jacob extern void isp_uninit(ispsoftc_t *);
5682df76c16SMatt Jacob extern uint64_t isp_default_wwn(ispsoftc_t *, int, int, int);
569478f8a96SJustin T. Gibbs 
57018ccaecdSMatt Jacob /*
57173030e03SMatt Jacob  * driver global data
57273030e03SMatt Jacob  */
57373030e03SMatt Jacob extern int isp_announced;
57410365e5aSMatt Jacob extern int isp_fabric_hysteresis;
57510365e5aSMatt Jacob extern int isp_loop_down_limit;
576f7c631bcSMatt Jacob extern int isp_gone_device_time;
57710365e5aSMatt Jacob extern int isp_quickboot_time;
5782df76c16SMatt Jacob extern int isp_autoconfig;
57973030e03SMatt Jacob 
58073030e03SMatt Jacob /*
58118ccaecdSMatt Jacob  * Platform private flags
582478f8a96SJustin T. Gibbs  */
583cc287907SMatt Jacob #define	ISP_SPRIV_ERRSET	0x1
584cc287907SMatt Jacob #define	ISP_SPRIV_DONE		0x8
585cc287907SMatt Jacob 
586cc287907SMatt Jacob #define	XS_CMD_S_DONE(sccb)	(sccb)->ccb_h.spriv_field0 |= ISP_SPRIV_DONE
587cc287907SMatt Jacob #define	XS_CMD_C_DONE(sccb)	(sccb)->ccb_h.spriv_field0 &= ~ISP_SPRIV_DONE
588cc287907SMatt Jacob #define	XS_CMD_DONE_P(sccb)	((sccb)->ccb_h.spriv_field0 & ISP_SPRIV_DONE)
589cc287907SMatt Jacob 
590cc287907SMatt Jacob #define	XS_CMD_S_CLEAR(sccb)	(sccb)->ccb_h.spriv_field0 = 0
59153af7d22SMatt Jacob 
592478f8a96SJustin T. Gibbs /*
593f7c631bcSMatt Jacob  * Platform Library Functions
594f7c631bcSMatt Jacob  */
595f7c631bcSMatt Jacob void isp_prt(ispsoftc_t *, int level, const char *, ...) __printflike(3, 4);
596f7c631bcSMatt Jacob uint64_t isp_nanotime_sub(struct timespec *, struct timespec *);
597f7c631bcSMatt Jacob int isp_mbox_acquire(ispsoftc_t *);
598f7c631bcSMatt Jacob void isp_mbox_wait_complete(ispsoftc_t *, mbreg_t *);
599f7c631bcSMatt Jacob void isp_mbox_notify_done(ispsoftc_t *);
600f7c631bcSMatt Jacob void isp_mbox_release(ispsoftc_t *);
6012df76c16SMatt Jacob int isp_fc_scratch_acquire(ispsoftc_t *, int);
602f7c631bcSMatt Jacob int isp_mstohz(int);
6030a70657fSMatt Jacob void isp_platform_intr(void *);
6040a70657fSMatt Jacob void isp_common_dmateardown(ispsoftc_t *, struct ccb_scsiio *, uint32_t);
605f7c631bcSMatt Jacob 
606f7c631bcSMatt Jacob /*
6070a70657fSMatt Jacob  * Platform Version specific defines
608f9734398SMatt Jacob  */
6090a70657fSMatt Jacob #define	BUS_DMA_ROOTARG(x)	bus_get_dma_tag(x)
6100a70657fSMatt Jacob #define	isp_dma_tag_create(a, b, c, d, e, f, g, h, i, j, k, z)	\
6110a70657fSMatt Jacob 	bus_dma_tag_create(a, b, c, d, e, f, g, h, i, j, k, \
6120a70657fSMatt Jacob 	busdma_lock_mutex, &isp->isp_osinfo.lock, z)
6130a70657fSMatt Jacob 
6145f538376SMatt Jacob #define	isp_setup_intr	bus_setup_intr
615f9734398SMatt Jacob 
6160a70657fSMatt Jacob #define	isp_sim_alloc(a, b, c, d, e, f, g, h)	\
6170a70657fSMatt Jacob 	cam_sim_alloc(a, b, c, d, e, &(d)->isp_osinfo.lock, f, g, h)
6180a70657fSMatt Jacob 
619f9734398SMatt Jacob /* Should be BUS_SPACE_MAXSIZE, but MAXPHYS is larger than BUS_SPACE_MAXSIZE */
6202df76c16SMatt Jacob #define ISP_NSEGS ((MAXPHYS / PAGE_SIZE) + 1)
6212df76c16SMatt Jacob 
6222df76c16SMatt Jacob #define	ISP_PATH_PRT(i, l, p, ...)					\
6232df76c16SMatt Jacob 	if ((l) == ISP_LOGALL || ((l)& (i)->isp_dblev) != 0) {		\
6242df76c16SMatt Jacob                 xpt_print(p, __VA_ARGS__);				\
6252df76c16SMatt Jacob         }
626f9734398SMatt Jacob 
627f9734398SMatt Jacob /*
62818ccaecdSMatt Jacob  * Platform specific inline functions
629478f8a96SJustin T. Gibbs  */
63057c801f5SMatt Jacob 
63118ccaecdSMatt Jacob /*
632f7c631bcSMatt Jacob  * ISP General Library functions
63318ccaecdSMatt Jacob  */
63457c801f5SMatt Jacob 
63553af7d22SMatt Jacob #include <dev/isp/isp_library.h>
63653af7d22SMatt Jacob 
6376054c3f6SMatt Jacob #endif	/* _ISP_FREEBSD_H */
638