xref: /dragonfly/sys/dev/raid/dpt/dpt.h (revision 606a6e92)
1 /*
2  *       Copyright (c) 1997 by Simon Shapiro
3  *       All Rights Reserved
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions, and the following disclaimer,
10  *    without modification, immediately at the beginning of the file.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  *    notice, this list of conditions and the following disclaimer in the
13  *    documentation and/or other materials provided with the distribution.
14  * 3. 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  */
30 
31 /*
32  *
33  *  dpt.h:	Definitions and constants used by the SCSI side of the DPT
34  *
35  *  credits:	Mike Neuffer;	DPT low level code and in other areas as well.
36  *		Mark Salyzyn; 	Many vital bits of info and diagnostics.
37  *		Justin Gibbs;	FreeBSD API, debugging and style
38  *		Ron McDaniels;	SCSI Software Interrupts
39  *		FreeBSD.ORG;	Great O/S to work on and for.
40  */
41 
42 
43 #ident "$FreeBSD: src/sys/dev/dpt/dpt.h,v 1.8.2.1 2000/08/07 18:48:14 peter Exp $"
44 #ident "$DragonFly: src/sys/dev/raid/dpt/dpt.h,v 1.4 2004/02/16 20:13:26 dillon Exp $"
45 
46 #ifndef _DPT_H
47 #define _DPT_H
48 
49 #include <sys/ioccom.h>
50 
51 #define DPT_CDEV_MAJOR 88
52 
53 #undef DPT_USE_DLM_SWI
54 
55 extern u_long dpt_unit;
56 
57 #define DPT_RELEASE				1
58 #define DPT_VERSION				4
59 #define DPT_PATCH				5
60 #define DPT_MONTH				8
61 #define DPT_DAY					3
62 #define DPT_YEAR				18	/* 1998 - 1980 */
63 
64 #define DPT_CTL_RELEASE			1
65 #define DPT_CTL_VERSION			0
66 #define DPT_CTL_PATCH			6
67 
68 #ifndef PAGESIZ
69 #define PAGESIZ					4096
70 #endif
71 
72 #ifndef physaddr
73 typedef void *physaddr;
74 #endif
75 
76 #undef	DPT_INQUIRE_DEVICES	  /* We have no buyers for this function */
77 #define DPT_SUPPORT_POLLING	  /* Use polled mode at boot (must be ON!) */
78 #define DPT_OPENNINGS		8 /* Commands-in-progress per device */
79 
80 #define DPT_RETRIES		5 /* Times to retry failed commands */
81 #undef	DPT_DISABLE_SG
82 #define DPT_HAS_OPEN
83 
84 /* Arguments to dpt_run_queue() can be: */
85 
86 #define DPT_MAX_TARGET_MODE_BUFFER_SIZE		8192
87 #define DPT_FREE_LIST_INCREMENT			64
88 #define DPT_CMD_LEN	      	 		12
89 
90 /*
91  * How many segments do we want in a Scatter/Gather list?
92  * Some HBA's can  do 16, Some 8192. Since we pre-allocate
93  * them in fixed increments, we need to put a practical limit on
94  * these. A passed parameter (from kernel boot or lkm) would help
95  */
96 #define DPT_MAX_SEGS		      	 	32
97 
98 /* Debug levels */
99 
100 #undef	DPT_DEBUG_PCI
101 #undef	DPT_DEBUG_INIT
102 #undef	DPT_DEBUG_SETUP
103 #undef	DPT_DEBUG_STATES
104 #undef	DPT_DEBUG_CONFIG
105 #undef	DPT_DEBUG_QUEUES
106 #undef	DPT_DEBUG_SCSI_CMD
107 #undef	DPT_DEBUG_SOFTINTR
108 #undef	DPT_DEBUG_HARDINTR
109 #undef	DPT_DEBUG_HEX_DUMPS
110 #undef	DPT_DEBUG_POLLING
111 #undef	DPT_DEBUG_INQUIRE
112 #undef	DPT_DEBUG_COMPLETION
113 #undef	DPT_DEBUG_COMPLETION_ERRORS
114 #define	DPT_DEBUG_MINPHYS
115 #undef	DPT_DEBUG_SG
116 #undef	DPT_DEBUG_SG_SHOW_DATA
117 #undef	DPT_DEBUG_SCSI_CMD_NAME
118 #undef	DPT_DEBUG_CONTROL
119 #undef	DPT_DEBUG_TIMEOUTS
120 #undef	DPT_DEBUG_SHUTDOWN
121 #define	DPT_DEBUG_USER_CMD
122 
123 /*
124  * Misc. definitions
125  */
126 #undef TRUE
127 #undef FALSE
128 #define TRUE	 		1
129 #define FALSE			0
130 
131 #define MAX_CHANNELS	3
132 #define MAX_TARGETS		16
133 #define MAX_LUNS        8
134 
135 /* Map minor numbers to device identity */
136 #define TARGET_MASK			0x000f
137 #define BUS_MASK			0x0030
138 #define HBA_MASK			0x01c0
139 #define LUN_MASK			0x0e00
140 
141 #define minor2target(minor)		( minor & TARGET_MASK )
142 #define minor2bus(minor)		( (minor & BUS_MASK) >> 4 )
143 #define minor2hba(minor)		( (minor & HBA_MASK) >> 6 )
144 #define minor2lun(minor)		( (minor & LUN_MASK) >> 9 )
145 
146 /*
147  * Valid values for cache_type
148  */
149 #define DPT_NO_CACHE		       	0
150 #define DPT_CACHE_WRITETHROUGH		1
151 #define DPT_CACHE_WRITEBACK			-2
152 
153 #define min(a,b) ((a<b)?(a):(b))
154 
155 #define MAXISA			       	4
156 #define MAXEISA			      	16
157 #define MAXPCI		       		16
158 #define MAXIRQ	       			16
159 #define MAXTARGET		      	16
160 
161 #define IS_ISA				'I'
162 #define IS_EISA				'E'
163 #define IS_PCI				'P'
164 
165 #define BROKEN_INQUIRY	1
166 
167 #define BUSMASTER			0xff
168 #define PIO			       	0xfe
169 
170 #define EATA_SIGNATURE			0x41544145 /* little ENDIAN "EATA" */
171 #define	DPT_BLINK_INDICATOR		0x42445054
172 
173 #define DPT_ID1				0x12
174 #define DPT_ID2				0x1
175 #define ATT_ID1				0x06
176 #define ATT_ID2				0x94
177 #define ATT_ID3				0x0
178 
179 #define NEC_ID1				0x38
180 #define NEC_ID2				0xa3
181 #define NEC_ID3				0x82
182 
183 #define MAX_PCI_DEVICES			32 /* Maximum # Of Devices Per Bus */
184 #define MAX_METHOD_2			16 /* Max Devices For Method 2 */
185 #define MAX_PCI_BUS			16 /* Maximum # Of Busses Allowed */
186 
187 #define DPT_MAX_RETRIES			2
188 
189 #define READ		       		0
190 #define WRITE	       			1
191 #define OTHER			       	2
192 
193 #define HD(cmd)	((hostdata *)&(cmd->host->hostdata))
194 #define CD(cmd)	((struct eata_ccb *)(cmd->host_scribble))
195 #define SD(host) ((hostdata *)&(host->hostdata))
196 
197 /*
198  * EATA Command & Register definitions
199  */
200 
201 #define PCI_REG_DPTconfig		       	0x40
202 #define PCI_REG_PumpModeAddress			0x44
203 #define PCI_REG_PumpModeData			0x48
204 #define PCI_REG_ConfigParam1			0x50
205 #define PCI_REG_ConfigParam2			0x54
206 
207 #define EATA_CMD_PIO_SETUPTEST			0xc6
208 #define EATA_CMD_PIO_READ_CONFIG		0xf0
209 #define EATA_CMD_PIO_SET_CONFIG			0xf1
210 #define EATA_CMD_PIO_SEND_CP			0xf2
211 #define EATA_CMD_PIO_RECEIVE_SP			0xf3
212 #define EATA_CMD_PIO_TRUNC		      	0xf4
213 
214 #define EATA_CMD_RESET			       	0xf9
215 #define EATA_COLD_BOOT                          0x06 /* Last resort only! */
216 
217 #define EATA_CMD_IMMEDIATE		       	0xfa
218 
219 #define EATA_CMD_DMA_READ_CONFIG		0xfd
220 #define EATA_CMD_DMA_SET_CONFIG			0xfe
221 #define EATA_CMD_DMA_SEND_CP			0xff
222 
223 #define ECS_EMULATE_SENSE		       	0xd4
224 
225 /*
226  * Immediate Commands
227  * Beware of this enumeration.	Not all commands are in sequence!
228  */
229 
230 enum dpt_immediate_cmd {
231     EATA_GENERIC_ABORT,
232     EATA_SPECIFIC_RESET,
233     EATA_BUS_RESET,
234     EATA_SPECIFIC_ABORT,
235     EATA_QUIET_INTR,
236     EATA_SMART_ROM_DL_EN,
237     EATA_COLD_BOOT_HBA,	/* Only as a last resort	*/
238     EATA_FORCE_IO,
239     EATA_SCSI_BUS_OFFLINE,
240     EATA_RESET_MASKED_BUS,
241     EATA_POWER_OFF_WARN
242 };
243 
244 extern enum dpt_immediate_cmd dpt_immediate_cmd;
245 
246 #define HA_CTRLREG		0x206 /* control register for HBA */
247 #define HA_CTRL_DISINT		0x02  /* CTRLREG: disable interrupts */
248 #define HA_CTRL_RESCPU		0x04  /* CTRLREG: reset processo */
249 #define HA_CTRL_8HEADS		0x08  /*
250 				       * CTRLREG: set for drives with
251 				       * >=8 heads
252 				       * (WD1003 rudimentary :-)
253 				       */
254 
255 #define HA_WCOMMAND		0x07  /* command register offset	*/
256 #define HA_WIFC		       	0x06  /* immediate command offset	*/
257 #define HA_WCODE	       	0x05
258 #define HA_WCODE2	       	0x04
259 #define HA_WDMAADDR		0x02  /* DMA address LSB offset	*/
260 #define HA_RERROR	       	0x01  /* Error Register, offset 1 from base */
261 #define HA_RAUXSTAT		0x08  /* aux status register offset */
262 #define HA_RSTATUS		0x07  /* status register offset	*/
263 #define HA_RDATA	       	0x00  /* data register (16bit)	*/
264 #define HA_WDATA	       	0x00  /* data register (16bit)	*/
265 
266 #define HA_ABUSY	       	0x01  /* aux busy bit		*/
267 #define HA_AIRQ			0x02  /* aux IRQ pending bit	*/
268 #define HA_SERROR	       	0x01  /* pr. command ended in error */
269 #define HA_SMORE	       	0x02  /* more data soon to come	*/
270 #define HA_SCORR	       	0x04  /* datio_addra corrected	*/
271 #define HA_SDRQ		       	0x08  /* data request active	*/
272 #define HA_SSC		       	0x10  /* seek complete		*/
273 #define HA_SFAULT	       	0x20  /* write fault		*/
274 #define HA_SREADY	       	0x40  /* drive ready		*/
275 #define HA_SBUSY	       	0x80  /* drive busy		*/
276 #define HA_SDRDY	       	(HA_SSC|HA_SREADY|HA_SDRQ)
277 
278 /*
279  * Message definitions
280  */
281 
282 enum dpt_message {
283 	HA_NO_ERROR,		/* No Error				*/
284 	HA_ERR_SEL_TO,		/* Selection Timeout			*/
285 	HA_ERR_CMD_TO,		/* Command Timeout			*/
286 	HA_SCSIBUS_RESET,
287 	HA_HBA_POWER_UP,	/* Initial Controller Power-up		*/
288 	HA_UNX_BUSPHASE,	/* Unexpected Bus Phase			*/
289 	HA_UNX_BUS_FREE,	/* Unexpected Bus Free			*/
290 	HA_BUS_PARITY,		/* Bus Parity Error			*/
291 	HA_SCSI_HUNG,		/* SCSI Hung				*/
292 	HA_UNX_MSGRJCT,		/* Unexpected Message Rejected		*/
293 	HA_RESET_STUCK,		/* SCSI Bus Reset Stuck			*/
294 	HA_RSENSE_FAIL,		/* Auto Request-Sense Failed		*/
295 	HA_PARITY_ERR,		/* Controller Ram Parity Error		*/
296 	HA_CP_ABORT_NA,		/* Abort Message sent to non-active cmd */
297 	HA_CP_ABORTED,		/* Abort Message sent to active cmd	*/
298 	HA_CP_RESET_NA,		/* Reset Message sent to non-active cmd */
299 	HA_CP_RESET,		/* Reset Message sent to active cmd	*/
300 	HA_ECC_ERR,		/* Controller Ram ECC Error		*/
301 	HA_PCI_PARITY,		/* PCI Parity Error			*/
302 	HA_PCI_MABORT,		/* PCI Master Abort			*/
303 	HA_PCI_TABORT,		/* PCI Target Abort			*/
304 	HA_PCI_STABORT		/* PCI Signaled Target Abort		*/
305 };
306 
307 extern enum dpt_message dpt_message;
308 
309 #define HA_STATUS_MASK  	0x7F
310 #define HA_IDENTIFY_MSG 	0x80
311 #define HA_DISCO_RECO   	0x40            /* Disconnect/Reconnect         */
312 
313 #define DPT_RW_BUFF_HEART	0X00
314 #define DPT_RW_BUFF_DLM		0x02
315 #define DPT_RW_BUFF_ACCESS	0x03
316 
317 #define HA_INTR_OFF		1
318 #define HA_INTR_ON	       	0
319 
320 /* This is really a one-time shot through some black magic */
321 #define DPT_EATA_REVA 0x1c
322 #define DPT_EATA_REVB 0x1e
323 #define DPT_EATA_REVC 0x22
324 #define DPT_EATA_REVZ 0x24
325 
326 
327 /* IOCTL List */
328 
329 #define DPT_RW_CMD_LEN 			32
330 #define DPT_RW_CMD_DUMP_SOFTC		"dump softc"
331 #define DPT_RW_CMD_DUMP_SYSINFO		"dump sysinfo"
332 #define DPT_RW_CMD_DUMP_METRICS		"dump metrics"
333 #define DPT_RW_CMD_CLEAR_METRICS	"clear metrics"
334 #define DPT_RW_CMD_SHOW_LED		"show LED"
335 
336 #define DPT_IOCTL_INTERNAL_METRICS	_IOR('D',  1, dpt_perf_t)
337 #define DPT_IOCTL_SOFTC		       	_IOR('D',  2, dpt_user_softc_t)
338 #define DPT_IOCTL_SEND		       	_IOWR('D', 3, eata_pt_t)
339 #define SDI_SEND			0x40044444 /* Observed from dptmgr */
340 
341 /*
342  *	Other	definitions
343  */
344 
345 #define DPT_HCP_LENGTH(page)	(ntohs(*(int16_t *)(void *)(&page[2]))+4)
346 #define DPT_HCP_FIRST(page) 	(&page[4])
347 #define DPT_HCP_NEXT(param) 	(&param[3 + param[3] + 1])
348 #define DPT_HCP_CODE(param)	(ntohs(*(int16_t *)(void *)param))
349 
350 
351 /* Possible return values from dpt_register_buffer() */
352 
353 #define SCSI_TM_READ_BUFFER	0x3c
354 #define SCSI_TM_WRITE_BUFFER	0x3b
355 
356 #define SCSI_TM_MODE_MASK	0x07  /* Strip off reserved and LUN */
357 #define SCSI_TM_LUN_MASK	0xe0  /* Strip off reserved and LUN */
358 
359 typedef enum {
360 	SUCCESSFULLY_REGISTERED,
361 	DRIVER_DOWN,
362 	ALREADY_REGISTERED,
363 	REGISTERED_TO_ANOTHER,
364 	NOT_REGISTERED,
365 	INVALID_UNIT,
366 	INVALID_SENDER,
367 	INVALID_CALLBACK,
368 	NO_RESOURCES
369 } dpt_rb_t;
370 
371 typedef enum {
372 	REGISTER_BUFFER,
373 	RELEASE_BUFFER
374 } dpt_rb_op_t;
375 
376 /*
377  * New way for completion routines to reliably copmplete processing.
378  * Should take properly typed dpt_softc_t and dpt_ccb_t,
379  * but interdependencies preclude that.
380  */
381 typedef void (*ccb_callback)(void *dpt, int bus, void *ccb);
382 
383 typedef void (*buff_wr_done)(int unit, u_int8_t channel, u_int8_t target,
384 			     u_int8_t lun, u_int16_t offset, u_int16_t length,
385 			     int result);
386 
387 typedef void (*dpt_rec_buff)(int unit, u_int8_t channel, u_int8_t target,
388 			     u_int8_t lun, void *buffer, u_int16_t offset,
389 			     u_int16_t length);
390 
391 /* HBA's Status port (register) bitmap */
392 typedef struct reg_bit {   /* reading this one will clear the interrupt */
393 	u_int8_t error :1, /* previous command ended in an error */
394 		 more  :1, /* More DATA coming soon Poll BSY & DRQ (PIO) */
395 		 corr  :1, /* data read was successfully corrected with ECC */
396 		 drq   :1, /* data request active */
397 		 sc    :1, /* seek complete */
398 		 fault :1, /* write fault */
399 		 ready :1, /* drive ready */
400 		 busy  :1; /* controller busy */
401 } dpt_status_reg_t;
402 
403 /* HBA's Auxiliary status port (register) bitmap */
404 typedef struct reg_abit {  /* reading this won't clear the interrupt */
405 	u_int8_t abusy :1, /* auxiliary busy */
406 		 irq   :1, /* set when drive interrupt is asserted */
407 		       :6;
408 } dpt_aux_status_t;
409 
410 /* The EATA Register Set as a structure */
411 typedef struct eata_register {
412 	u_int8_t data_reg[2];	/* R, couldn't figure this one out */
413 	u_int8_t cp_addr[4];	/* W, CP address register */
414 	union {
415 		u_int8_t command; /*
416 				   * W, command code:
417 				   * [read|set] conf, send CP
418 				   */
419 		struct	 reg_bit status; /* R, see register_bit1 */
420 		u_int8_t statusbyte;
421 	} ovr;
422 	struct reg_abit aux_stat; /* R, see register_bit2 */
423 } eata_reg_t;
424 
425 /*
426  * Holds the results of a READ_CONFIGURATION command
427  * Beware of data items which are larger than 1 byte.
428  * these come from the DPT in network order.
429  * On an Intel ``CPU'' they will be upside down and backwards!
430  * The dpt_get_conf function is normally responsible for flipping
431  * Everything back.
432  */
433 typedef struct get_conf {  /* Read Configuration Array */
434 	union {
435 		struct {
436 			u_int8_t foo_DevType;
437 			u_int8_t foo_PageCode;
438 			u_int8_t foo_Reserved0;
439 			u_int8_t foo_len;
440 		} foo;
441 		u_int32_t foo_length;	/* Should return 0x22, 0x24, etc */
442 	} bar;
443 #define gcs_length	       	bar.foo_length
444 #define gcs_PageCode		bar.foo.foo_DevType
445 #define gcs_reserved0		bar.foo.foo_Reserved0
446 #define gcs_len		       	bar.foo.foo_len
447 
448 	u_int32_t signature;	/* Signature MUST be "EATA".	ntohl()`ed */
449 
450 	u_int8_t  version2 :4,
451 		  version  :4;	/* EATA Version level */
452 
453 	u_int8_t  OCS_enabled :1, /* Overlap Command Support enabled */
454 		  TAR_support :1, /* SCSI Target Mode supported */
455 		  TRNXFR      :1, /* Truncate Transfer Cmd Used in PIO Mode */
456 		  MORE_support:1, /* MORE supported (PIO Mode Only) */
457 		  DMA_support :1, /* DMA supported */
458 		  DMA_valid   :1, /* DRQ value in Byte 30 is valid */
459 		  ATA	      :1, /* ATA device connected (not supported) */
460 		  HAA_valid   :1; /* Hostadapter Address is valid */
461 
462 	u_int16_t cppadlen; /*
463 			     * Number of pad bytes send after CD data set
464 			     * to zero for DMA commands. Ntohl()`ed
465 			     */
466 	u_int8_t  scsi_idS; /* SCSI ID of controller 2-0 Byte 0 res. */
467 	u_int8_t  scsi_id2; /* If not, zero is returned */
468 	u_int8_t  scsi_id1;
469 	u_int8_t  scsi_id0;
470 	u_int32_t cplen;    /* CP length: number of valid cp bytes */
471 
472 	u_int32_t splen;    /* Returned bytes for a received SP command */
473 	u_int16_t queuesiz; /* max number of queueable CPs */
474 
475 	u_int16_t dummy;
476 	u_int16_t SGsiz;	/* max number of SG table entrie */
477 
478 	u_int8_t  IRQ	     :4,/* IRQ used this HBA */
479 		  IRQ_TR     :1,/* IRQ Trigger: 0=edge, 1=level	 */
480 		  SECOND     :1,/* This is a secondary controller */
481 		  DMA_channel:2;/* DRQ index, DRQ is 2comp of DRQX */
482 
483 	u_int8_t  sync;		/* 0-7 sync active bitmask (deprecated) */
484 	u_int8_t  DSBLE   :1,	/* ISA i/o addressing is disabled */
485 		  FORCADR :1,	/* i/o address has been forced */
486 		  SG_64K  :1,
487 		  SG_UAE  :1,
488 			  :4;
489 
490 	u_int8_t  MAX_ID   :5,	/* Max number of SCSI target IDs */
491 		  MAX_CHAN :3;	/* Number of SCSI busses on HBA	 */
492 
493 	u_int8_t  MAX_LUN;	/* Max number of LUNs */
494 	u_int8_t	  :3,
495 		  AUTOTRM :1,
496 		  M1_inst :1,
497 		  ID_qest :1,	/* Raidnum ID is questionable */
498 		  is_PCI  :1,	/* HBA is PCI */
499 		  is_EISA :1;	/* HBA is EISA */
500 
501 	u_int8_t  RAIDNUM;	/* unique HBA identifier */
502 	u_int8_t  unused[4];	/* When doing PIO, you	GET 512 bytes */
503 
504 	/* >>------>>	End of The DPT structure	<<------<< */
505 
506 	u_int32_t length;	/* True length, after ntohl conversion	*/
507 } dpt_conf_t;
508 
509 /* Scatter-Gather list entry */
510 typedef struct dpt_sg_segment {
511 	u_int32_t seg_addr;	/* All fields in network byte order */
512 	u_int32_t seg_len;
513 } dpt_sg_t;
514 
515 
516 /* Status Packet */
517 typedef struct eata_sp {
518 	u_int8_t  hba_stat :7,	/* HBA status */
519 		  EOC	  :1;	/* True if command finished */
520 
521 	u_int8_t  scsi_stat;	/* Target SCSI status */
522 
523 	u_int8_t  reserved[2];
524 
525 	u_int32_t residue_len;	/* Number of bytes not transferred */
526 
527 	u_int32_t ccb_busaddr;
528 
529 	u_int8_t  sp_ID_Message;
530 	u_int8_t  sp_Que_Message;
531 	u_int8_t  sp_Tag_Message;
532 	u_int8_t  msg[9];
533 } dpt_sp_t;
534 
535 /*
536  * A strange collection of O/S-Hardware releated bits and pieces.
537  * Used by the dpt_ioctl() entry point to return DPT_SYSINFO command.
538  */
539 typedef struct dpt_drive_parameters {
540 	u_int16_t cylinders; /* Up to 1024 */
541 	u_int8_t  heads;     /* Up to 255  */
542 	u_int8_t  sectors;   /* Up to 63   */
543 } dpt_drive_t;
544 
545 typedef struct driveParam_S driveParam_T;
546 
547 #define SI_CMOS_Valid           0x0001
548 #define SI_NumDrivesValid       0x0002
549 #define SI_ProcessorValid       0x0004
550 #define SI_MemorySizeValid      0x0008
551 #define SI_DriveParamsValid     0x0010
552 #define SI_SmartROMverValid     0x0020
553 #define SI_OSversionValid       0x0040
554 #define SI_OSspecificValid      0x0080
555 #define SI_BusTypeValid         0x0100
556 
557 #define SI_ALL_VALID        	0x0FFF
558 #define SI_NO_SmartROM     	0x8000
559 
560 #define SI_ISA_BUS	       	0x00
561 #define SI_MCA_BUS        	0x01
562 #define SI_EISA_BUS	       	0x02
563 #define SI_PCI_BUS	       	0x04
564 
565 #define HBA_BUS_ISA		0x00
566 #define HBA_BUS_EISA		0x01
567 #define HBA_BUS_PCI		0x02
568 
569 typedef struct dpt_sysinfo {
570 	u_int8_t    drive0CMOS;			/* CMOS Drive 0 Type */
571 	u_int8_t    drive1CMOS;			/* CMOS Drive 1 Type */
572 	u_int8_t    numDrives;			/* 0040:0075 contents */
573 	u_int8_t    processorFamily;		/* Same as DPTSIG definition */
574 	u_int8_t    processorType;		/* Same as DPTSIG definition */
575 	u_int8_t    smartROMMajorVersion;
576 	u_int8_t    smartROMMinorVersion;	/* SmartROM version */
577 	u_int8_t    smartROMRevision;
578 	u_int16_t   flags;			/* See bit definitions above */
579 	u_int16_t   conventionalMemSize;	/* in KB */
580 	u_int32_t   extendedMemSize;		/* in KB */
581 	u_int32_t   osType;			/* Same as DPTSIG definition */
582 	u_int8_t    osMajorVersion;
583 	u_int8_t    osMinorVersion;		/* The OS version */
584 	u_int8_t    osRevision;
585 	u_int8_t    osSubRevision;
586 	u_int8_t    busType;			/* See defininitions above */
587 	u_int8_t    pad[3];			/* For alignment */
588 	dpt_drive_t drives[16];			/* SmartROM Logical Drives */
589 } dpt_sysinfo_t;
590 
591 /* SEND_COMMAND packet structure */
592 typedef struct eata_ccb {
593 	u_int8_t SCSI_Reset   :1, /* Cause a SCSI Bus reset on the cmd */
594 		 HBA_Init     :1, /* Cause Controller to reinitialize */
595 		 Auto_Req_Sen :1, /* Do Auto Request Sense on errors */
596 		 scatter      :1, /* Data Ptr points to a SG Packet */
597 		 Quick	      :1, /* Set this one for NO Status PAcket */
598 		 Interpret    :1, /* Interpret the SCSI cdb for own use */
599 		 DataOut      :1, /* Data Out phase with command */
600 		 DataIn	      :1; /* Data In phase with command */
601 
602 	u_int8_t reqlen;	  /* Request Sense Length, if Auto_Req_Sen=1 */
603 	u_int8_t unused[3];
604 	u_int8_t FWNEST  :1,	  /* send cmd to phys RAID component */
605 		 unused2 :7;
606 
607 	u_int8_t Phsunit	:1, /* physical unit on mirrored pair */
608 		 I_AT		:1, /* inhibit address translation  */
609 		 Disable_Cache	:1, /* HBA inhibit caching */
610 				:5;
611 
612 	u_int8_t cp_id		:5, /* SCSI Device ID of target */
613 		 cp_channel	:3; /* SCSI Channel # of HBA */
614 
615 	u_int8_t cp_LUN		:5,
616 		 cp_luntar	:1, /* CP is for target ROUTINE */
617 		 cp_dispri	:1, /* Grant disconnect privilege */
618 		 cp_identify	:1; /* Always TRUE */
619 
620 	u_int8_t cp_msg[3];	/* Message bytes 0-3 */
621 
622 	union {
623 		struct {
624 			u_int8_t x_scsi_cmd; /* Partial SCSI CDB def */
625 
626 			u_int8_t x_extent  :1,
627 				 x_bytchk  :1,
628 				 x_reladr  :1,
629 				 x_cmplst  :1,
630 				 x_fmtdata :1,
631 				 x_lun	   :3;
632 
633 			u_int8_t x_page;
634 			u_int8_t reserved4;
635 			u_int8_t x_len;
636 			u_int8_t x_link	   :1;
637 			u_int8_t x_flag	   :1;
638 			u_int8_t reserved5 :4;
639 			u_int8_t x_vendor  :2;
640 		} x;
641 		u_int8_t z[12];	/* Command Descriptor Block (= 12) */
642 	} cp_w;
643 
644 #define cp_cdb		cp_w.z
645 #define cp_scsi_cmd	cp_w.x.x_scsi_cmd
646 #define cp_extent      	cp_w.x.x_extent
647 #define cp_lun 		cp_w.x.x_lun
648 #define cp_page	       	cp_w.x.x_page
649 #define cp_len	       	cp_w.x.x_len
650 
651 #define MULTIFUNCTION_CMD	0x0e	/* SCSI Multi Function Cmd */
652 #define BUS_QUIET		0x04	/* Quite Scsi Bus Code     */
653 #define BUS_UNQUIET		0x05	/* Un Quiet Scsi Bus Code  */
654 
655 	u_int32_t cp_datalen;	/*
656 				 * Data Transfer Length. If scatter=1 len (IN
657 				 * BYTES!) of the S/G array
658 				 */
659 
660 	u_int32_t cp_busaddr;	/* Unique identifier.  Busaddr works well */
661 	u_int32_t cp_dataDMA;	/*
662 				 * Data Address, if scatter=1 then it is the
663 				 * address of scatter packet
664 				 */
665 	u_int32_t cp_statDMA;	/* address for Status Packet */
666 	u_int32_t cp_reqDMA;	/*
667 				 * Request Sense Address, used if CP command
668 				 * ends with error
669 				 */
670 	u_int8_t  CP_OpCode;
671 
672 } eata_ccb_t;
673 
674 /*
675  * DPT Signature Structure.
676  * Used by /dev/dpt to directly pass commands to the HBA
677  * We have more information here than we care for...
678  */
679 
680 /* Current Signature Version - sigBYTE dsSigVersion; */
681 #define SIG_VERSION 1
682 
683 /*
684  * Processor Family - sigBYTE dsProcessorFamily;	DISTINCT VALUE
685  *
686  * What type of processor the file is meant to run on.
687  * This will let us know whether to read sigWORDs as high/low or low/high.
688  */
689 #define PROC_INTEL	0x00	/* Intel 80x86 */
690 #define PROC_MOTOROLA	0x01	/* Motorola 68K */
691 #define PROC_MIPS4000	0x02	/* MIPS RISC 4000 */
692 #define PROC_ALPHA	0x03	/* DEC Alpha */
693 
694 /*
695  * Specific Minimim Processor - sigBYTE dsProcessor; FLAG BITS
696  *
697  * Different bit definitions dependent on processor_family
698  */
699 
700 /* PROC_INTEL: */
701 #define PROC_8086	0x01   	/* Intel 8086 */
702 #define PROC_286	0x02   	/* Intel 80286 */
703 #define PROC_386	0x04	/* Intel 80386 */
704 #define PROC_486	0x08	/* Intel 80486 */
705 #define PROC_PENTIUM	0x10	/* Intel 586 aka P5 aka Pentium */
706 #define PROC_P6		0x20	/* Intel 686 aka P6 */
707 
708 /* PROC_MOTOROLA: */
709 #define PROC_68000	0x01   	/* Motorola 68000 */
710 #define PROC_68020	0x02   	/* Motorola 68020 */
711 #define PROC_68030	0x04   	/* Motorola 68030 */
712 #define PROC_68040	0x08	/* Motorola 68040 */
713 
714 /* Filetype - sigBYTE dsFiletype; DISTINCT VALUES */
715 #define FT_EXECUTABLE	0      	/* Executable Program */
716 #define FT_SCRIPT	1      	/* Script/Batch File??? */
717 #define FT_HBADRVR	2     	/* HBA Driver */
718 #define FT_OTHERDRVR	3	/* Other Driver */
719 #define FT_IFS		4	/* Installable Filesystem Driver */
720 #define FT_ENGINE	5	/* DPT Engine */
721 #define FT_COMPDRVR	6	/* Compressed Driver Disk */
722 #define FT_LANGUAGE	7	/* Foreign Language file */
723 #define FT_FIRMWARE	8	/* Downloadable or actual Firmware */
724 #define FT_COMMMODL	9	/* Communications Module */
725 #define FT_INT13       	10    	/* INT 13 style HBA Driver */
726 #define FT_HELPFILE	11	/* Help file */
727 #define FT_LOGGER	12	/* Event Logger */
728 #define FT_INSTALL	13	/* An Install Program */
729 #define FT_LIBRARY	14	/* Storage Manager Real-Mode Calls */
730 #define FT_RESOURCE	15	/* Storage Manager Resource File */
731 #define FT_MODEM_DB	16	/* Storage Manager Modem Database */
732 
733 /* Filetype flags - sigBYTE dsFiletypeFlags;		FLAG BITS */
734 #define FTF_DLL	       	0x01	/* Dynamic Link Library */
735 #define FTF_NLM		0x02	/* Netware Loadable Module */
736 #define FTF_OVERLAYS	0x04	/* Uses overlays */
737 #define FTF_DEBUG	0x08	/* Debug version */
738 #define FTF_TSR		0x10	/* TSR */
739 #define FTF_SYS		0x20	/* DOS Lodable driver */
740 #define FTF_PROTECTED	0x40	/* Runs in protected mode */
741 #define FTF_APP_SPEC	0x80	/* Application Specific */
742 
743 /* OEM - sigBYTE dsOEM;	DISTINCT VALUES */
744 #define OEM_DPT		0	/* DPT */
745 #define OEM_ATT		1	/* ATT */
746 #define OEM_NEC		2	/* NEC */
747 #define OEM_ALPHA	3	/* Alphatronix */
748 #define OEM_AST		4	/* AST */
749 #define OEM_OLIVETTI	5	/* Olivetti */
750 #define OEM_SNI		6	/* Siemens/Nixdorf */
751 
752 /* Operating System	- sigLONG dsOS;		FLAG BITS */
753 #define OS_DOS			0x00000001 /* PC/MS-DOS */
754 #define OS_WINDOWS		0x00000002 /* Microsoft Windows 3.x */
755 #define OS_WINDOWS_NT		0x00000004 /* Microsoft Windows NT */
756 #define OS_OS2M			0x00000008 /* OS/2 1.2.x,MS 1.3.0,IBM 1.3.x */
757 #define OS_OS2L			0x00000010 /* Microsoft OS/2 1.301 - LADDR */
758 #define OS_OS22x		0x00000020 /* IBM OS/2 2.x */
759 #define OS_NW286		0x00000040 /* Novell NetWare 286 */
760 #define OS_NW386		0x00000080 /* Novell NetWare 386 */
761 #define OS_GEN_UNIX		0x00000100 /* Generic Unix */
762 #define OS_SCO_UNIX		0x00000200 /* SCO Unix */
763 #define OS_ATT_UNIX		0x00000400 /* ATT Unix */
764 #define OS_UNIXWARE		0x00000800 /* UnixWare Unix */
765 #define OS_INT_UNIX		0x00001000 /* Interactive Unix */
766 #define OS_SOLARIS		0x00002000 /* SunSoft Solaris */
767 #define OS_QN			0x00004000 /* QNX for Tom Moch */
768 #define OS_NEXTSTEP		0x00008000 /* NeXTSTEP */
769 #define OS_BANYAN		0x00010000 /* Banyan Vines */
770 #define OS_OLIVETTI_UNIX	0x00020000 /* Olivetti Unix */
771 #define OS_FREEBSD     		0x00040000 /* FreeBSD 2.2 and later */
772 #define OS_OTHER		0x80000000 /* Other */
773 
774 /* Capabilities - sigWORD dsCapabilities; FLAG BITS */
775 #define CAP_RAID0	0x0001	/* RAID-0 */
776 #define CAP_RAID1	0x0002	/* RAID-1 */
777 #define CAP_RAID3	0x0004	/* RAID-3 */
778 #define CAP_RAID5	0x0008	/* RAID-5 */
779 #define CAP_SPAN	0x0010	/* Spanning */
780 #define CAP_PASS	0x0020	/* Provides passthrough */
781 #define CAP_OVERLAP	0x0040	/* Passthrough supports overlapped commands */
782 #define CAP_ASPI	0x0080	/* Supports ASPI Command Requests */
783 #define CAP_ABOVE16MB	0x0100	/* ISA Driver supports greater than 16MB */
784 #define CAP_EXTEND	0x8000	/* Extended info appears after description */
785 
786 /* Devices Supported - sigWORD dsDeviceSupp;		FLAG BITS */
787 #define DEV_DASD	0x0001	/* DASD (hard drives) */
788 #define DEV_TAPE	0x0002	/* Tape drives */
789 #define DEV_PRINTER	0x0004	/* Printers */
790 #define DEV_PROC	0x0008	/* Processors */
791 #define DEV_WORM	0x0010	/* WORM drives */
792 #define DEV_CDROM	0x0020	/* CD-ROM drives */
793 #define DEV_SCANNER	0x0040	/* Scanners */
794 #define DEV_OPTICAL	0x0080	/* Optical Drives */
795 #define DEV_JUKEBOX	0x0100	/* Jukebox */
796 #define DEV_COMM	0x0200	/* Communications Devices */
797 #define DEV_OTHER	0x0400	/* Other Devices */
798 #define DEV_ALL		0xFFFF	/* All SCSI Devices */
799 
800 /* Adapters Families Supported - sigWORD dsAdapterSupp; FLAG BITS */
801 #define ADF_2001	0x0001	/* PM2001 */
802 #define ADF_2012A	0x0002	/* PM2012A */
803 #define ADF_PLUS_ISA	0x0004	/* PM2011,PM2021 */
804 #define ADF_PLUS_EISA	0x0008	/* PM2012B,PM2022 */
805 #define ADF_SC3_ISA	0x0010	/* PM2021 */
806 #define ADF_SC3_EISA	0x0020	/* PM2022,PM2122, etc */
807 #define ADF_SC3_PCI	0x0040	/* SmartCache III PCI */
808 #define ADF_SC4_ISA	0x0080	/* SmartCache IV ISA */
809 #define ADF_SC4_EISA	0x0100	/* SmartCache IV EISA */
810 #define ADF_SC4_PCI	0x0200	/* SmartCache IV PCI */
811 #define ADF_ALL_MASTER	0xFFFE	/* All bus mastering */
812 #define ADF_ALL_CACHE	0xFFFC	/* All caching */
813 #define ADF_ALL		0xFFFF	/* ALL DPT adapters */
814 
815 /* Application - sigWORD dsApplication;				FLAG BITS */
816 #define APP_DPTMGR	0x0001	/* DPT Storage Manager */
817 #define APP_ENGINE	0x0002	/* DPT Engine */
818 #define APP_SYTOS	0x0004	/* Sytron Sytos Plus */
819 #define APP_CHEYENNE	0x0008	/* Cheyenne ARCServe + ARCSolo */
820 #define APP_MSCDEX	0x0010	/* Microsoft CD-ROM extensions */
821 #define APP_NOVABACK	0x0020	/* NovaStor Novaback */
822 #define APP_AIM		0x0040	/* Archive Information Manager */
823 
824 /* Requirements - sigBYTE dsRequirements;	FLAG BITS */
825 #define REQ_SMARTROM	0x01   	/* Requires SmartROM to be present */
826 #define REQ_DPTDDL	0x02   	/* Requires DPTDDL.SYS to be loaded */
827 #define REQ_HBA_DRIVER	0x04   	/* Requires an HBA driver to be loaded	*/
828 #define REQ_ASPI_TRAN	0x08   	/* Requires an ASPI Transport Modules	*/
829 #define REQ_ENGINE	0x10   	/* Requires a DPT Engine to be loaded	*/
830 #define REQ_COMM_ENG	0x20	/* Requires a DPT Communications Engine */
831 
832 typedef struct dpt_sig {
833 	char	  dsSignature[6];  /* ALWAYS "dPtSiG" */
834 	u_int8_t  SigVersion;	   /* signature version (currently 1) */
835 	u_int8_t  ProcessorFamily; /* what type of processor */
836 	u_int8_t  Processor;	   /* precise processor */
837 	u_int8_t  Filetype;	   /* type of file */
838 	u_int8_t  FiletypeFlags;   /* flags to specify load type, etc. */
839 	u_int8_t  OEM;		   /* OEM file was created for */
840 	u_int32_t OS;		   /* which Operating systems */
841 	u_int16_t Capabilities;	   /* RAID levels, etc. */
842 	u_int16_t DeviceSupp;	   /* Types of SCSI devices supported */
843 	u_int16_t AdapterSupp;	   /* DPT adapter families supported */
844 	u_int16_t Application;	   /* applications file is for */
845 	u_int8_t  Requirements;	   /* Other driver dependencies */
846 	u_int8_t  Version;	   /* 1 */
847 	u_int8_t  Revision;	   /* 'J' */
848 	u_int8_t  SubRevision;	   /* '9', ' ' if N/A */
849 	u_int8_t  Month;	   /* creation month */
850 	u_int8_t  Day;		   /* creation day */
851 	u_int8_t  Year;		   /* creation year since 1980  */
852 	char	 *Description;	   /* description (NULL terminated) */
853 } dpt_sig_t;
854 
855 /* 32 bytes minimum - with no description. Put NULL at description[0] */
856 /* 81 bytes maximum - with 49 character description plus NULL. */
857 
858 /* This line added at Roycroft's request */
859 /* Microsoft's NT compiler gets confused if you do a pack and don't */
860 /* restore it. */
861 typedef struct eata_pass_through {
862 	u_int8_t    eataID[4];
863 	u_int32_t   command;
864 
865 #define EATAUSRCMD	(('D'<<8)|65)  	/* EATA PassThrough Command	*/
866 #define DPT_SIGNATURE	(('D'<<8)|67)  	/* Get Signature Structure */
867 #define DPT_NUMCTRLS   	(('D'<<8)|68)	/* Get Number Of DPT Adapters */
868 #define DPT_CTRLINFO   	(('D'<<8)|69)  	/* Get Adapter Info Structure */
869 #define DPT_SYSINFO    	(('D'<<8)|72)  	/* Get System Info Structure	*/
870 #define DPT_BLINKLED   	(('D'<<8)|75)	/* Get The BlinkLED Status */
871 
872 	u_int8_t   *command_buffer;
873 	eata_ccb_t  command_packet;
874 	u_int32_t   timeout;
875 	u_int8_t    host_status;
876 	u_int8_t    target_status;
877 	u_int8_t    retries;
878 } eata_pt_t;
879 
880 typedef enum {
881 	DCCB_FREE		= 0x00,
882 	DCCB_ACTIVE		= 0x01,
883 	DCCB_RELEASE_SIMQ	= 0x02
884 } dccb_state;
885 
886 typedef struct dpt_ccb {
887 	eata_ccb_t	 eata_ccb;
888 	bus_dmamap_t	 dmamap;
889 	dpt_sg_t	*sg_list;
890 	u_int32_t	 sg_busaddr;
891 	dccb_state	 state;
892 	union		 ccb *ccb;
893 	struct		 scsi_sense_data sense_data;
894 	u_int8_t	 tag;
895 	u_int8_t	 retries;
896 	u_int8_t	 status; /* status of this queueslot */
897 	u_int8_t	*cmd;	 /* address of cmd */
898 
899 	u_int32_t	 transaction_id;
900 	u_int32_t	 result;
901 	caddr_t		 data;
902 	SLIST_ENTRY(dpt_ccb) links;
903 
904 #ifdef DPT_MEASURE_PERFORMANCE
905 	u_int32_t	 submitted_time;
906 	struct		 timeval command_started;
907 	struct		 timeval command_ended;
908 #endif
909 } dpt_ccb_t;
910 
911 /*
912  * This is provided for compatibility with UnixWare only.
913  * Some of the fields may be bogus.
914  * Others may have a totally different meaning.
915  */
916 typedef struct dpt_scsi_ha {
917     u_int32_t	 ha_state;		/* Operational state */
918     u_int8_t	 ha_id[MAX_CHANNELS];	/* Host adapter SCSI ids */
919     int32_t	 ha_base;		/* Base I/O address */
920     int		 ha_max_jobs;		/* Max number of Active Jobs */
921     int		 ha_cache:2;		/* Cache parameters */
922     int		 ha_cachesize:30;	/* In meg, only if cache present*/
923     int		 ha_nbus;		/* Number Of Busses on HBA */
924     int		 ha_ntargets;		/* Number Of Targets Supported */
925     int		 ha_nluns;		/* Number Of LUNs Supported */
926     int		 ha_tshift;		/* Shift value for target */
927     int		 ha_bshift;		/* Shift value for bus */
928     int		 ha_npend;		/* # of jobs sent to HBA */
929     int		 ha_active_jobs;	/* Number Of Active Jobs */
930     char	 ha_fw_version[4];	/* Firmware Revision Level */
931     void	*ha_ccb;		/* Controller command blocks */
932     void	*ha_cblist;		/* Command block free list */
933     void	*ha_dev;		/* Logical unit queues */
934     void	*ha_StPkt_lock;		/* Status Packet Lock */
935     void	*ha_ccb_lock;		/* CCB Lock */
936     void	*ha_LuQWaiting;		/* Lu Queue Waiting List */
937     void	*ha_QWait_lock;		/* Device Que Waiting Lock */
938     int		 ha_QWait_opri;		/* Saved Priority Level */
939 #ifdef DPT_TARGET_MODE
940     dpt_ccb_t	*target_ccb[MAX_CHANNELS]; /* Command block waiting writebuf */
941 #endif
942 } dpt_compat_ha_t;
943 
944 /*
945  * Describe the Inquiry Data returned on Page 0 from the Adapter. The
946  * Page C1 Inquiry Data is described in the DptConfig_t structure above.
947  */
948 typedef struct {
949     u_int8_t	deviceType;
950     u_int8_t	rm_dtq;
951     u_int8_t	otherData[6];
952     u_int8_t	vendor[8];
953     u_int8_t	modelNum[16];
954     u_int8_t	firmware[4];
955     u_int8_t	protocol[4];
956 } dpt_inq_t;
957 
958 /*
959  * sp_EOC is not `safe', so I will check sp_Messages[0] instead!
960  */
961 #define DptStat_BUSY(x)	 ((x)->sp_ID_Message)
962 #define DptStat_Reset_BUSY(x)			\
963  ((x)->msg[0] = 0xA5, (x)->EOC = 0,		\
964   (x)->ccb_busaddr = ~0)
965 
966 #ifdef DPT_MEASURE_PERFORMANCE
967 #define BIG_ENOUGH	0x8fffffff
968 typedef struct dpt_metrics {
969 	u_int32_t command_count[256]; /* We assume MAX 256 SCSI commands */
970 	u_int32_t max_command_time[256];
971 	u_int32_t min_command_time[256];
972 
973 	u_int32_t min_intr_time;
974 	u_int32_t max_intr_time;
975 	u_int32_t aborted_interrupts;
976 	u_int32_t spurious_interrupts;
977 
978 	u_int32_t max_waiting_count;
979 	u_int32_t max_submit_count;
980 	u_int32_t max_complete_count;
981 
982 	u_int32_t min_waiting_time;
983 	u_int32_t min_submit_time;
984 	u_int32_t min_complete_time;
985 
986 	u_int32_t max_waiting_time;
987 	u_int32_t max_submit_time;
988 	u_int32_t max_complete_time;
989 
990 	u_int32_t command_collisions;
991 	u_int32_t command_too_busy;
992 	u_int32_t max_eata_tries;
993 	u_int32_t min_eata_tries;
994 
995 	u_int32_t read_by_size_count[10];
996 	u_int32_t write_by_size_count[10];
997 	u_int32_t read_by_size_min_time[10];
998 	u_int32_t read_by_size_max_time[10];
999 	u_int32_t write_by_size_min_time[10];
1000 	u_int32_t write_by_size_max_time[10];
1001 
1002 #define SIZE_512	0
1003 #define SIZE_1K		1
1004 #define SIZE_2K		2
1005 #define SIZE_4K		3
1006 #define SIZE_8K		4
1007 #define SIZE_16K	5
1008 #define SIZE_32K	6
1009 #define SIZE_64K	7
1010 #define SIZE_BIGGER	8
1011 #define SIZE_OTHER	9
1012 
1013 	struct	  timeval intr_started;
1014 
1015 	u_int32_t warm_starts;
1016 	u_int32_t cold_boots;
1017 } dpt_perf_t;
1018 #endif
1019 
1020 struct sg_map_node {
1021 	bus_dmamap_t		 sg_dmamap;
1022 	bus_addr_t		 sg_physaddr;
1023 	dpt_sg_t*		 sg_vaddr;
1024 	SLIST_ENTRY(sg_map_node) links;
1025 };
1026 
1027 /* Main state machine and interface structure */
1028 typedef struct dpt_softc {
1029 	bus_space_tag_t	   tag;
1030 	bus_space_handle_t bsh;
1031 	bus_dma_tag_t	   buffer_dmat;		/* dmat for buffer I/O */
1032 	dpt_ccb_t	  *dpt_dccbs;		/* Array of dpt ccbs */
1033 	bus_addr_t	   dpt_ccb_busbase;	/* phys base address of array */
1034 	bus_addr_t	   dpt_ccb_busend;	/* phys end address of array */
1035 
1036 	u_int32_t handle_interrupts   :1, /* Are we ready for real work? */
1037 		  target_mode_enabled :1,
1038 		  resource_shortage   :1,
1039 		  cache_type	      :2,
1040 		  spare		      :28;
1041 
1042 	int	  total_dccbs;
1043 	int	  free_dccbs;
1044 	int	  pending_ccbs;
1045 	int	  completed_ccbs;
1046 
1047 	SLIST_HEAD(, dpt_ccb)	 free_dccb_list;
1048 	LIST_HEAD(, ccb_hdr)     pending_ccb_list;
1049 
1050 	bus_dma_tag_t		  parent_dmat;
1051 	bus_dma_tag_t		  dccb_dmat;	/* dmat for our ccb array */
1052 	bus_dmamap_t		  dccb_dmamap;
1053 	bus_dma_tag_t		  sg_dmat;	/* dmat for our sg maps */
1054 	SLIST_HEAD(, sg_map_node) sg_maps;
1055 
1056 	struct cam_sim		  *sims[MAX_CHANNELS];
1057 	struct cam_path		  *paths[MAX_CHANNELS];
1058 	u_int32_t commands_processed;
1059 	u_int32_t lost_interrupts;
1060 
1061 	/*
1062 	 * These three parameters can be used to allow for wide scsi, and
1063 	 * for host adapters that support multiple busses. The first two
1064 	 * should be set to 1 more than the actual max id or lun (i.e. 8 for
1065 	 * normal systems).
1066 	 *
1067 	 * There is a FAT assumption here;  We assume that these will never
1068 	 * exceed MAX_CHANNELS, MAX_TARGETS, MAX_LUNS
1069 	 */
1070 	u_int	  channels;	/* # of avail scsi chan. */
1071 	u_int32_t max_id;
1072 	u_int32_t max_lun;
1073 
1074 	u_int8_t  irq;
1075 	u_int8_t  dma_channel;
1076 
1077 	TAILQ_ENTRY(dpt_softc) links;
1078 	int	  unit;
1079 	int	  init_level;
1080 
1081 	/*
1082 	 * Every object on a unit can have a receiver, if it treats
1083 	 * us as a target.  We do that so that separate and independant
1084 	 * clients can consume received buffers.
1085 	 */
1086 
1087 #define DPT_RW_BUFFER_SIZE	(8 * 1024)
1088 	dpt_ccb_t	*target_ccb[MAX_CHANNELS][MAX_TARGETS][MAX_LUNS];
1089 	u_int8_t	*rw_buffer[MAX_CHANNELS][MAX_TARGETS][MAX_LUNS];
1090 	dpt_rec_buff	 buffer_receiver[MAX_CHANNELS][MAX_TARGETS][MAX_LUNS];
1091 
1092 	dpt_inq_t	 board_data;
1093 	u_int8_t	 EATA_revision;
1094 	u_int8_t	 bustype;	/* bustype of HBA	 */
1095 	u_int32_t	 state;		/* state of HBA		 */
1096 
1097 #define DPT_HA_FREE	       	0x00000000
1098 #define DPT_HA_OK	       	0x00000000
1099 #define DPT_HA_NO_TIMEOUT      	0x00000000
1100 #define DPT_HA_BUSY	       	0x00000001
1101 #define DPT_HA_TIMEOUT	       	0x00000002
1102 #define DPT_HA_RESET	       	0x00000004
1103 #define DPT_HA_LOCKED	       	0x00000008
1104 #define DPT_HA_ABORTED	       	0x00000010
1105 #define DPT_HA_CONTROL_ACTIVE  	0x00000020
1106 #define DPT_HA_SHUTDOWN_ACTIVE  0x00000040
1107 #define DPT_HA_COMMAND_ACTIVE  	0x00000080
1108 #define DPT_HA_QUIET            0x00000100
1109 
1110 #ifdef DPT_LOST_IRQ
1111 #define DPT_LOST_IRQ_SET	0x10000000
1112 #define DPT_LOST_IRQ_ACTIVE	0x20000000
1113 #endif
1114 
1115 #ifdef DPT_HANDLE_TIMEOUTS
1116 #define DPT_HA_TIMEOUTS_SET	0x40000000
1117 #define DPT_HA_TIMEOUTS_ACTIVE	0x80000000
1118 #endif
1119 
1120 	u_int8_t  primary;	/* true if primary */
1121 
1122 	u_int8_t  more_support		:1,	/* HBA supports MORE flag */
1123 		  immediate_support	:1,	/* HBA supports IMMEDIATE */
1124 		  broken_INQUIRY	:1,	/* EISA HBA w/broken INQUIRY */
1125 		  spare2		:5;
1126 
1127 	u_int8_t  resetlevel[MAX_CHANNELS];
1128 	u_int32_t last_ccb;	/* Last used ccb */
1129 	u_int32_t cplen;		/* size of CP in words */
1130 	u_int16_t cppadlen;	/* pad length of cp */
1131 	u_int16_t max_dccbs;
1132 	u_int16_t sgsize;		/* Entries in the SG list */
1133 	u_int8_t  hostid[MAX_CHANNELS];	/* SCSI ID of HBA */
1134 	u_int32_t cache_size;
1135 
1136 	volatile   dpt_sp_t *sp;		/* status packet */
1137 	/* Copied from the status packet during interrupt handler */
1138 	u_int8_t   hba_stat;
1139 	u_int8_t   scsi_stat;	/* Target SCSI status */
1140 	u_int32_t  residue_len;	/* Number of bytes not transferred */
1141 	bus_addr_t sp_physaddr;		/* phys address of status packet */
1142 
1143 	/*
1144 	 * We put ALL conditional elements at the tail for the structure.
1145 	 * If we do not, then userland code will crash or trash based on which
1146 	 * kernel it is running with.
1147 	 * This isi most visible with usr/sbin/dpt_softc(8)
1148 	 */
1149 
1150 #ifdef DPT_MEASURE_PERFORMANCE
1151 	dpt_perf_t performance;
1152 #endif
1153 
1154 #ifdef DPT_RESET_HBA
1155 	struct timeval last_contact;
1156 #endif
1157 } dpt_softc_t;
1158 
1159 /*
1160  * This structure is used to pass dpt_softc contents to userland via the
1161  * ioctl DPT_IOCTL_SOFTC.  The reason for this maddness, is that FreeBSD
1162  * (all BSDs ?) chose to actually assign a nasty meaning to the IOCTL word,
1163  * encoding 13 bits of it as size.  As dpt_softc_t is somewhere between
1164  * 8,594 and 8,600 (depends on options), we have to copy the data to
1165  * something less than 4KB long. This siliness also solves the problem of
1166  * varying definition of dpt_softc_t, As the variants are exluded from
1167  * dpt_user_softc.
1168  *
1169  * See dpt_softc_t above for enumerations, comments and such.
1170  */
1171 typedef struct dpt_user_softc {
1172 	int	  unit;
1173 	u_int32_t handle_interrupts   :1, /* Are we ready for real work? */
1174 		  target_mode_enabled :1,
1175 		  spare		      :30;
1176 
1177 	int	  total_ccbs_count;
1178 	int	  free_ccbs_count;
1179 	int	  waiting_ccbs_count;
1180 	int	  submitted_ccbs_count;
1181 	int	  completed_ccbs_count;
1182 
1183 	u_int32_t queue_status;
1184 	u_int32_t free_lock;
1185 	u_int32_t waiting_lock;
1186 	u_int32_t submitted_lock;
1187 	u_int32_t completed_lock;
1188 
1189 	u_int32_t commands_processed;
1190 	u_int32_t lost_interrupts;
1191 
1192 	u_int8_t  channels;
1193 	u_int32_t max_id;
1194 	u_int32_t max_lun;
1195 
1196 	u_int16_t io_base;
1197 	u_int8_t *v_membase;
1198 	u_int8_t *p_membase;
1199 
1200 	u_int8_t  irq;
1201 	u_int8_t  dma_channel;
1202 
1203 	dpt_inq_t board_data;
1204 	u_int8_t  EATA_revision;
1205 	u_int8_t  bustype;
1206 	u_int32_t state;
1207 
1208 	u_int8_t  primary;
1209 	u_int8_t  more_support 	    :1,
1210 		  immediate_support :1,
1211 		  broken_INQUIRY    :1,
1212 		  spare2	    :5;
1213 
1214 	u_int8_t  resetlevel[MAX_CHANNELS];
1215 	u_int32_t last_ccb;
1216 	u_int32_t cplen;
1217 	u_int16_t cppadlen;
1218 	u_int16_t queuesize;
1219 	u_int16_t sgsize;
1220 	u_int8_t  hostid[MAX_CHANNELS];
1221 	u_int32_t cache_type :2,
1222 		  cache_size :30;
1223 } dpt_user_softc_t;
1224 
1225 /*
1226  * Externals:
1227  * These all come from dpt_scsi.c
1228  *
1229  */
1230 #ifdef _KERNEL
1231 /* This function gets the current hi-res time and returns it to the caller */
1232 static __inline struct timeval
1233 dpt_time_now(void)
1234 {
1235 	struct timeval now;
1236 
1237 	microtime(&now);
1238 	return(now);
1239 }
1240 
1241 /*
1242  * Given a minor device number, get its SCSI Unit.
1243  */
1244 static __inline int
1245 dpt_minor2unit(int minor)
1246 {
1247 	return(minor2hba(minor));
1248 }
1249 
1250 dpt_softc_t *dpt_minor2softc(int minor_no);
1251 
1252 #endif /* _KERNEL */
1253 
1254 /*
1255  * This function substracts one timval structure from another,
1256  * Returning the result in usec.
1257  * It assumes that less than 4 billion usecs passed form start to end.
1258  * If times are sensless, ~0 is returned.
1259  */
1260 static __inline u_int32_t
1261 dpt_time_delta(struct timeval start,
1262 	       struct timeval end)
1263 {
1264     if (start.tv_sec > end.tv_sec)
1265 	return(~0);
1266 
1267     if ( (start.tv_sec == end.tv_sec) && (start.tv_usec > end.tv_usec) )
1268 	return(~0);
1269 
1270     return ( (end.tv_sec - start.tv_sec) * 1000000 +
1271 	     (end.tv_usec - start.tv_usec) );
1272 }
1273 
1274 extern TAILQ_HEAD(dpt_softc_list, dpt_softc) dpt_softcs;
1275 
1276 extern int		dpt_controllers_present;
1277 
1278 #ifdef _KERNEL
1279 dpt_softc_t *		dpt_alloc(device_t, bus_space_tag_t, bus_space_handle_t);
1280 #endif
1281 void			dpt_free(struct dpt_softc *dpt);
1282 int			dpt_init(struct dpt_softc *dpt);
1283 int			dpt_attach(dpt_softc_t * dpt);
1284 void			dpt_intr(void *arg);
1285 
1286 dpt_conf_t *		dpt_pio_get_conf(u_int32_t);
1287 
1288 #if 0
1289 extern void		hex_dump(u_char * data, int length,
1290 				 char *name, int no);
1291 extern char		*i2bin(unsigned int no, int length);
1292 extern char		*scsi_cmd_name(u_int8_t cmd);
1293 
1294 extern dpt_conf_t	*dpt_get_conf(dpt_softc_t *dpt, u_int8_t page,
1295 				      u_int8_t target, u_int8_t size,
1296 				      int extent);
1297 
1298 extern int		dpt_setup(dpt_softc_t * dpt, dpt_conf_t * conf);
1299 extern int		dpt_attach(dpt_softc_t * dpt);
1300 extern void		dpt_shutdown(int howto, dpt_softc_t *dpt);
1301 extern void		dpt_detect_cache(dpt_softc_t *dpt);
1302 
1303 extern int		dpt_user_cmd(dpt_softc_t *dpt, eata_pt_t *user_cmd,
1304 				     caddr_t cmdarg, int minor_no);
1305 
1306 extern u_int8_t	dpt_blinking_led(dpt_softc_t *dpt);
1307 
1308 extern dpt_rb_t	dpt_register_buffer(int unit, u_int8_t channel, u_int8_t target,
1309 				    u_int8_t lun, u_int8_t mode,
1310 				    u_int16_t length, u_int16_t offset,
1311 				    dpt_rec_buff callback, dpt_rb_op_t op);
1312 
1313 extern int	dpt_send_buffer(int unit, u_int8_t channel, u_int8_t target,
1314 				u_int8_t lun, u_int8_t mode, u_int16_t length,
1315 				u_int16_t offset, void *data,
1316 				buff_wr_done callback);
1317 
1318 
1319 
1320 void dpt_reset_performance(dpt_softc_t *dpt);
1321 #endif
1322 
1323 #endif /* _DPT_H */
1324