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