1/*-
2 * Copyright (c) 2001 Michael Smith
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 * 2. Redistributions in binary form must reproduce the above copyright
11 *    notice, this list of conditions and the following disclaimer in the
12 *    documentation and/or other materials provided with the distribution.
13 *
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24 * SUCH DAMAGE.
25 *
26 *	$FreeBSD$
27 */
28
29/*
30 * Structure and I/O definitions for the Command Interface for SCSI-3 Support.
31 *
32 * Data in command CDBs are in big-endian format.  All other data is little-endian.
33 * This header only supports little-endian hosts at this time.
34 */
35
36union ciss_device_address
37{
38    struct 				/* MODE_PERIPHERAL and MODE_MASK_PERIPHERAL */
39    {
40	u_int32_t	target:24;	/* SCSI target */
41	u_int32_t	bus:6;		/* SCSI bus */
42	u_int32_t	mode:2;		/* CISS_HDR_ADDRESS_MODE_* */
43	u_int32_t	extra_address;	/* SCSI-3 level-2 and level-3 address bytes */
44    } physical;
45    struct 				/* MODE_LOGICAL */
46    {
47	u_int32_t	lun:30;		/* logical device ID */
48	u_int32_t	mode:2;		/* CISS_HDR_ADDRESS_MODE_LOGICAL */
49	u_int32_t	:32;		/* reserved */
50    } logical;
51    struct
52    {
53	u_int32_t	:30;
54	u_int32_t	mode:2;
55	u_int32_t	:32;
56    } mode;
57};
58#define CISS_HDR_ADDRESS_MODE_PERIPHERAL	0x0
59#define CISS_HDR_ADDRESS_MODE_LOGICAL		0x1
60#define CISS_HDR_ADDRESS_MODE_MASK_PERIPHERAL	0x3
61
62#define CISS_EXTRA_MODE2(extra)		((extra & 0xc0000000) >> 30)
63#define CISS_EXTRA_BUS2(extra)		((extra & 0x3f000000) >> 24)
64#define CISS_EXTRA_TARGET2(extra)	((extra & 0x00ff0000) >> 16)
65#define CISS_EXTRA_MODE3(extra)		((extra & 0x0000c000) >> 14)
66#define CISS_EXTRA_BUS3(extra)		((extra & 0x00003f00) >> 8)
67#define CISS_EXTRA_TARGET3(extra)	((extra & 0x000000ff))
68
69struct ciss_header
70{
71    u_int8_t	:8;			/* reserved */
72    u_int8_t	sg_in_list;		/* SG's in the command structure */
73    u_int16_t	sg_total;		/* total count of SGs for this command */
74    u_int32_t	host_tag;		/* host identifier, bits 0&1 must be clear */
75#define CISS_HDR_HOST_TAG_ERROR	(1<<1)
76    u_int32_t	host_tag_zeroes;	/* tag is 64 bits, but interface only supports 32 */
77    union ciss_device_address address;
78} __packed;
79
80struct ciss_cdb
81{
82    u_int8_t	cdb_length;		/* valid CDB bytes */
83    u_int8_t	type:3;
84#define CISS_CDB_TYPE_COMMAND			0
85#define CISS_CDB_TYPE_MESSAGE			1
86    u_int8_t	attribute:3;
87#define CISS_CDB_ATTRIBUTE_UNTAGGED		0
88#define CISS_CDB_ATTRIBUTE_SIMPLE		4
89#define CISS_CDB_ATTRIBUTE_HEAD_OF_QUEUE	5
90#define CISS_CDB_ATTRIBUTE_ORDERED		6
91#define CISS_CDB_ATTRIBUTE_AUTO_CONTINGENT	7
92    u_int8_t	direction:2;
93#define CISS_CDB_DIRECTION_NONE			0
94#define CISS_CDB_DIRECTION_WRITE		1
95#define CISS_CDB_DIRECTION_READ			2
96    u_int16_t	timeout;		/* seconds */
97#define CISS_CDB_BUFFER_SIZE	16
98    u_int8_t	cdb[CISS_CDB_BUFFER_SIZE];
99} __packed;
100
101struct ciss_error_info_pointer
102{
103    u_int64_t	error_info_address;	/* points to ciss_error_info structure */
104    u_int32_t	error_info_length;
105} __packed;
106
107struct ciss_error_info
108{
109    u_int8_t	scsi_status;
110#define CISS_SCSI_STATUS_GOOD			0x00	/* these are scsi-standard values */
111#define CISS_SCSI_STATUS_CHECK_CONDITION	0x02
112#define CISS_SCSI_STATUS_CONDITION_MET		0x04
113#define CISS_SCSI_STATUS_BUSY			0x08
114#define CISS_SCSI_STATUS_INDETERMINATE		0x10
115#define CISS_SCSI_STATUS_INDETERMINATE_CM	0x14
116#define CISS_SCSI_STATUS_RESERVATION_CONFLICT	0x18
117#define CISS_SCSI_STATUS_COMMAND_TERMINATED	0x22
118#define CISS_SCSI_STATUS_QUEUE_FULL		0x28
119#define CISS_SCSI_STATUS_ACA_ACTIVE		0x30
120    u_int8_t	sense_length;
121    u_int16_t	command_status;
122#define CISS_CMD_STATUS_SUCCESS			0
123#define CISS_CMD_STATUS_TARGET_STATUS		1
124#define CISS_CMD_STATUS_DATA_UNDERRUN		2
125#define CISS_CMD_STATUS_DATA_OVERRUN		3
126#define CISS_CMD_STATUS_INVALID_COMMAND		4
127#define CISS_CMD_STATUS_PROTOCOL_ERROR		5
128#define CISS_CMD_STATUS_HARDWARE_ERROR		6
129#define CISS_CMD_STATUS_CONNECTION_LOST		7
130#define CISS_CMD_STATUS_ABORTED			8
131#define CISS_CMD_STATUS_ABORT_FAILED		9
132#define CISS_CMD_STATUS_UNSOLICITED_ABORT	10
133#define CISS_CMD_STATUS_TIMEOUT			11
134#define CISS_CMD_STATUS_UNABORTABLE		12
135    u_int32_t	residual_count;
136    union {
137	struct {
138	    u_int8_t	res1[3];
139	    u_int8_t	type;
140	    u_int32_t	error_info;
141	} __packed common_info;
142	struct {
143	    u_int8_t	res1[2];
144	    u_int8_t	offense_size;
145	    u_int8_t	offense_offset;
146	    u_int32_t	offense_value;
147	} __packed invalid_command;
148    } additional_error_info;
149    u_int8_t	sense_info[0];
150} __packed;
151
152struct ciss_sg_entry
153{
154    u_int64_t	address;
155#define CISS_SG_ADDRESS_BITBUCKET	(~(u_int64_t)0)
156    u_int32_t	length;
157    u_int32_t	:31;
158    u_int32_t	extension:1;		/* address points to another s/g chain */
159} __packed;
160
161struct ciss_command
162{
163    struct ciss_header			header;
164    struct ciss_cdb			cdb;
165    struct ciss_error_info_pointer	error_info;
166    struct ciss_sg_entry		sg[0];
167} __packed;
168
169#define CISS_OPCODE_REPORT_LOGICAL_LUNS		0xc2
170#define CISS_OPCODE_REPORT_PHYSICAL_LUNS	0xc3
171
172struct ciss_lun_report
173{
174    u_int32_t	list_size;		/* big-endian */
175    u_int32_t	:32;
176    union ciss_device_address lun[0];
177} __packed;
178
179#define	CISS_VPD_LOGICAL_DRIVE_GEOMETRY		0xc1
180struct ciss_ldrive_geometry
181{
182    u_int8_t	periph_qualifier:3;
183    u_int8_t	periph_devtype:5;
184    u_int8_t	page_code;
185    u_int8_t	res1;
186    u_int8_t	page_length;
187    u_int16_t	cylinders;		/* big-endian */
188    u_int8_t	heads;
189    u_int8_t	sectors;
190    u_int8_t	fault_tolerance;
191    u_int8_t	res2[3];
192} __attribute__ ((packed));
193
194struct ciss_report_cdb
195{
196    u_int8_t	opcode;
197    u_int8_t	reserved[5];
198    u_int32_t	length;			/* big-endian */
199    u_int8_t	:8;
200    u_int8_t	control;
201} __packed;
202
203/*
204 * Note that it's not clear whether we have to set the detail field to
205 * the tag of the command to be aborted, or the tag field in the command itself;
206 * documentation conflicts on this.
207 */
208#define CISS_OPCODE_MESSAGE_ABORT		0x00
209#define CISS_MESSAGE_ABORT_TASK			0x00
210#define CISS_MESSAGE_ABORT_TASK_SET		0x01
211#define CISS_MESSAGE_ABORT_CLEAR_ACA		0x02
212#define CISS_MESSAGE_ABORT_CLEAR_TASK_SET	0x03
213
214#define CISS_OPCODE_MESSAGE_RESET		0x01
215#define CISS_MESSAGE_RESET_CONTROLLER		0x00
216#define CISS_MESSAGE_RESET_BUS			0x01
217#define CISS_MESSAGE_RESET_TARGET		0x03
218#define CISS_MESSAGE_RESET_LOGICAL_UNIT		0x04
219
220#define CISS_OPCODE_MESSAGE_SCAN		0x02
221#define CISS_MESSAGE_SCAN_CONTROLLER		0x00
222#define CISS_MESSAGE_SCAN_BUS			0x01
223#define CISS_MESSAGE_SCAN_TARGET		0x03
224#define CISS_MESSAGE_SCAN_LOGICAL_UNIT		0x04
225
226#define CISS_OPCODE_MESSAGE_NOP			0x03
227
228struct ciss_message_cdb
229{
230    u_int8_t	opcode;
231    u_int8_t	type;
232    u_int16_t	:16;
233    u_int32_t	abort_tag;					/* XXX endianness? */
234    u_int8_t	reserved[8];
235} __packed;
236
237/*
238 * CISS vendor-specific commands/messages.
239 *
240 * Note that while messages and vendor-specific commands are
241 * differentiated, they are handled in basically the same way and can
242 * be considered to be basically the same thing, as long as the cdb
243 * type field is set correctly.
244 */
245#define CISS_OPCODE_READ		0xc0
246#define CISS_OPCODE_WRITE		0xc1
247#define CISS_COMMAND_NOTIFY_ON_EVENT	0xd0
248#define CISS_COMMAND_ABORT_NOTIFY	0xd1
249
250struct ciss_notify_cdb
251{
252    u_int8_t	opcode;
253    u_int8_t	command;
254    u_int8_t	res1[2];
255    u_int16_t	timeout;		/* seconds, little-endian */
256    u_int8_t	res2;			/* reserved */
257    u_int8_t	synchronous:1;		/* return immediately */
258    u_int8_t	ordered:1;		/* return events in recorded order */
259    u_int8_t	seek_to_oldest:1;	/* reset read counter to oldest event */
260    u_int8_t	new_only:1;		/* ignore any queued events */
261    u_int8_t	:4;
262    u_int32_t	length;			/* must be 512, little-endian */
263#define CISS_NOTIFY_DATA_SIZE	512
264    u_int8_t	control;
265} __packed;
266
267#define CISS_NOTIFY_NOTIFIER		0
268#define CISS_NOTIFY_NOTIFIER_STATUS		0
269#define CISS_NOTIFY_NOTIFIER_PROTOCOL		1
270
271#define CISS_NOTIFY_HOTPLUG		1
272#define CISS_NOTIFY_HOTPLUG_PHYSICAL		0
273#define CISS_NOTIFY_HOTPLUG_POWERSUPPLY		1
274#define CISS_NOTIFY_HOTPLUG_FAN			2
275#define CISS_NOTIFY_HOTPLUG_POWER		3
276#define CISS_NOTIFY_HOTPLUG_REDUNDANT		4
277#define CISS_NOTIFY_HOTPLUG_NONDISK		5
278
279#define CISS_NOTIFY_HARDWARE		2
280#define CISS_NOTIFY_HARDWARE_CABLES		0
281#define CISS_NOTIFY_HARDWARE_MEMORY		1
282#define CISS_NOTIFY_HARDWARE_FAN		2
283#define CISS_NOTIFY_HARDWARE_VRM		3
284
285#define CISS_NOTIFY_ENVIRONMENT		3
286#define CISS_NOTIFY_ENVIRONMENT_TEMPERATURE	0
287#define CISS_NOTIFY_ENVIRONMENT_POWERSUPPLY	1
288#define CISS_NOTIFY_ENVIRONMENT_CHASSIS		2
289#define CISS_NOTIFY_ENVIRONMENT_POWER		3
290
291#define CISS_NOTIFY_PHYSICAL		4
292#define CISS_NOTIFY_PHYSICAL_STATE		0
293
294#define CISS_NOTIFY_LOGICAL		5
295#define CISS_NOTIFY_LOGICAL_STATUS		0
296#define CISS_NOTIFY_LOGICAL_ERROR		1
297#define CISS_NOTIFY_LOGICAL_SURFACE		2
298
299#define CISS_NOTIFY_REDUNDANT		6
300#define CISS_NOTIFY_REDUNDANT_STATUS		0
301
302#define CISS_NOTIFY_CISS		8
303#define CISS_NOTIFY_CISS_REDUNDANT_CHANGE	0
304#define CISS_NOTIFY_CISS_PATH_STATUS		1
305#define CISS_NOTIFY_CISS_HARDWARE_ERROR		2
306#define CISS_NOTIFY_CISS_LOGICAL		3
307
308struct ciss_notify_drive
309{
310    u_int16_t	physical_drive_number;
311    u_int8_t	configured_drive_flag;
312    u_int8_t	spare_drive_flag;
313    u_int8_t	big_physical_drive_number;
314    u_int8_t	enclosure_bay_number;
315} __packed;
316
317struct ciss_notify_locator
318{
319    u_int16_t	port;
320    u_int16_t	id;
321    u_int16_t	box;
322} __packed;
323
324struct ciss_notify_redundant_controller
325{
326    u_int16_t	slot;
327} __packed;
328
329struct ciss_notify_logical_status
330{
331    u_int16_t	logical_drive;
332    u_int8_t	previous_state;
333    u_int8_t	new_state;
334    u_int8_t	spare_state;
335} __packed;
336
337struct ciss_notify_rebuild_aborted
338{
339    u_int16_t	logical_drive;
340    u_int8_t	replacement_drive;
341    u_int8_t	error_drive;
342    u_int8_t	big_replacement_drive;
343    u_int8_t	big_error_drive;
344} __packed;
345
346struct ciss_notify_io_error
347{
348    u_int16_t	logical_drive;
349    u_int32_t	lba;
350    u_int16_t	block_count;
351    u_int8_t	command;
352    u_int8_t	failure_bus;
353    u_int8_t	failure_drive;
354    u_int64_t	big_lba;
355} __packed;
356
357struct ciss_notify_consistency_completed
358{
359    u_int16_t	logical_drive;
360} __packed;
361
362struct ciss_notify
363{
364    u_int32_t	timestamp;		/* seconds since controller power-on */
365    u_int16_t	class;
366    u_int16_t	subclass;
367    u_int16_t	detail;
368    union
369    {
370	struct ciss_notify_drive		drive;
371	struct ciss_notify_locator		location;
372	struct ciss_notify_redundant_controller	redundant_controller;
373	struct ciss_notify_logical_status	logical_status;
374	struct ciss_notify_rebuild_aborted	rebuild_aborted;
375	struct ciss_notify_io_error		io_error;
376	struct ciss_notify_consistency_completed consistency_completed;
377	u_int8_t	data[64];
378    } data;
379    char	message[80];
380    u_int32_t	tag;
381    u_int16_t	date;
382    u_int16_t	year;
383    u_int32_t	time;
384    u_int16_t	pre_power_up_time;
385    union ciss_device_address	device;
386    /* XXX pads to 512 bytes */
387} __packed;
388
389/*
390 * CISS config table, which describes the controller's
391 * supported interface(s) and capabilities.
392 *
393 * This is mapped directly via PCI.
394 */
395struct ciss_config_table
396{
397    char	signature[4];		/* "CISS" */
398    u_int32_t	valence;
399    u_int32_t	supported_methods;
400#define CISS_TRANSPORT_METHOD_READY	(1<<0)
401#define CISS_TRANSPORT_METHOD_SIMPLE	(1<<1)
402#define CISS_TRANSPORT_METHOD_PERF	(1<<2)
403    u_int32_t	active_method;
404    u_int32_t	requested_method;
405    u_int32_t	command_physlimit;
406    u_int32_t	interrupt_coalesce_delay;
407    u_int32_t	interrupt_coalesce_count;
408    u_int32_t	max_outstanding_commands;
409    u_int32_t	bus_types;
410#define CISS_TRANSPORT_BUS_TYPE_ULTRA2	(1<<0)
411#define CISS_TRANSPORT_BUS_TYPE_ULTRA3	(1<<1)
412#define CISS_TRANSPORT_BUS_TYPE_FIBRE1	(1<<8)
413#define CISS_TRANSPORT_BUS_TYPE_FIBRE2	(1<<9)
414    u_int32_t	transport_offset;
415    char	server_name[16];
416    u_int32_t	heartbeat;
417    u_int32_t	host_driver;
418#define CISS_DRIVER_SUPPORT_UNIT_ATTENTION	(1<<0)
419#define CISS_DRIVER_QUICK_INIT			(1<<1)
420#define CISS_DRIVER_INTERRUPT_ON_LOCKUP		(1<<2)
421#define CISS_DRIVER_SUPPORT_MIXED_Q_TAGS	(1<<3)
422#define CISS_DRIVER_HOST_IS_ALPHA		(1<<4)
423#define CISS_DRIVER_MULTI_LUN_SUPPORT		(1<<5)
424#define CISS_DRIVER_MESSAGE_REQUESTS_SUPPORTED	(1<<7)
425#define CISS_DRIVER_DAUGHTER_ATTACHED		(1<<8)
426#define CISS_DRIVER_SCSI_PREFETCH		(1<<9)
427    u_int32_t	max_sg_length;		/* 31 in older firmware */
428/*
429 * these fields appear in OpenCISS Spec 1.06
430 * http://cciss.sourceforge.net/#docs
431 */
432    u_int32_t	max_logical_supported;
433    u_int32_t	max_physical_supported;
434    u_int32_t	max_physical_per_logical;
435    u_int32_t	max_perfomant_mode_cmds;
436    u_int32_t	max_block_fetch_count;
437} __packed;
438
439/*
440 * Configuration table for the Performant transport.  Only 4 request queues
441 * are mentioned in this table, though apparently up to 256 can exist.
442 */
443struct ciss_perf_config {
444    uint32_t	fetch_count[8];
445#define CISS_SG_FETCH_MAX	0
446#define CISS_SG_FETCH_1		1
447#define CISS_SG_FETCH_2		2
448#define CISS_SG_FETCH_4		3
449#define CISS_SG_FETCH_8		4
450#define CISS_SG_FETCH_16	5
451#define CISS_SG_FETCH_32	6
452#define CISS_SG_FETCH_NONE	7
453    uint32_t	rq_size;
454    uint32_t	rq_count;
455    uint32_t	rq_bank_lo;
456    uint32_t	rq_bank_hi;
457    struct {
458	uint32_t	rq_addr_lo;
459	uint32_t	rq_addr_hi;
460    } __packed rq[4];
461} __packed;
462
463/*
464 * In a flagrant violation of what CISS seems to be meant to be about,
465 * Compaq recycle a goodly portion of their previous generation's
466 * command set (and all the legacy baggage related to a design
467 * originally aimed at narrow SCSI) through the Array Controller Read
468 * and Array Controller Write interface.
469 *
470 * Command ID values here can be looked up for in the
471 * publically-available documentation for the older controllers; note
472 * that the command layout is necessarily different to fit within the
473 * CDB.
474 */
475#define CISS_ARRAY_CONTROLLER_READ	0x26
476#define CISS_ARRAY_CONTROLLER_WRITE	0x27
477
478#define CISS_BMIC_ID_LDRIVE		0x10
479#define CISS_BMIC_ID_CTLR		0x11
480#define CISS_BMIC_ID_LSTATUS		0x12
481#define CISS_BMIC_ID_PDRIVE		0x15
482#define CISS_BMIC_BLINK_PDRIVE		0x16
483#define CISS_BMIC_SENSE_BLINK_PDRIVE	0x17
484#define CISS_BMIC_SOFT_RESET		0x40
485#define CISS_BMIC_FLUSH_CACHE		0xc2
486#define CISS_BMIC_ACCEPT_MEDIA		0xe0
487
488/*
489 * When numbering drives, the original design assumed that
490 * drives 0-7 are on the first SCSI bus, 8-15 on the second,
491 * and so forth.  In order to handle modern SCSI configurations,
492 * the MSB is set in the drive ID field, in which case the
493 * modulus changes from 8 to the number of supported drives
494 * per SCSI bus (as obtained from the ID_CTLR command).
495 * This feature is referred to as BIG_MAP support, and we assume
496 * that all CISS controllers support it.
497 */
498
499#define CISS_BIG_MAP_ID(sc, bus, target)		\
500	(0x80 | 					\
501	 ((sc)->ciss_id->drives_per_scsi_bus * (bus)) |	\
502	 (target))
503
504#define CISS_BIG_MAP_BUS(sc, id)			\
505	(((id) & 0x80) ? (((id) & ~0x80) / (sc)->ciss_id->drives_per_scsi_bus) : -1)
506
507#define CISS_BIG_MAP_TARGET(sc, id)			\
508	(((id) & 0x80) ? (((id) & ~0x80) % (sc)->ciss_id->drives_per_scsi_bus) : -1)
509
510#define CISS_BIG_MAP_ENTRIES	128	/* number of entries in a BIG_MAP */
511
512/*
513 * In the device address of a logical volume, the bus number
514 * is encoded into the logical lun volume number starting
515 * at the second byte, with the first byte defining the
516 * logical drive number.
517 */
518#define CISS_LUN_TO_BUS(x)    (((x) >> 16) & 0xFF)
519#define CISS_LUN_TO_TARGET(x) ((x) & 0xFF)
520
521/*
522 * BMIC CDB
523 *
524 * Note that the phys_drive/res1 field is nominally the 32-bit
525 * "block number" field, but the only BMIC command(s) of interest
526 * implemented overload the MSB (note big-endian format here)
527 * to be the physical drive ID, so we define accordingly.
528 */
529struct ciss_bmic_cdb {
530    u_int8_t	opcode;
531    u_int8_t	log_drive;
532    u_int8_t	phys_drive;
533    u_int8_t	res1[3];
534    u_int8_t	bmic_opcode;
535    u_int16_t	size;			/* big-endian */
536    u_int8_t	res2;
537} __packed;
538
539/*
540 * BMIC command command/return structures.
541 */
542
543/* CISS_BMIC_ID_LDRIVE */
544struct ciss_bmic_id_ldrive {
545    u_int16_t	block_size;
546    u_int32_t	blocks_available;
547    u_int8_t	drive_parameter_table[16];	/* XXX define */
548    u_int8_t	fault_tolerance;
549#define CISS_LDRIVE_RAID0	0
550#define CISS_LDRIVE_RAID4	1
551#define CISS_LDRIVE_RAID1	2
552#define CISS_LDRIVE_RAID5	3
553#define CISS_LDRIVE_RAID51	4
554#define CISS_LDRIVE_RAIDADG	5
555    u_int8_t	res1;
556    u_int8_t	bios_disable_flag;
557    u_int8_t	res2;
558    u_int32_t	logical_drive_identifier;
559    char	logical_drive_label[64];
560    u_int64_t	big_blocks_available;
561    u_int8_t	res3[410];
562} __packed;
563
564/* CISS_BMIC_ID_LSTATUS */
565struct ciss_bmic_id_lstatus {
566    u_int8_t	status;
567#define CISS_LSTATUS_OK				0
568#define CISS_LSTATUS_FAILED			1
569#define CISS_LSTATUS_NOT_CONFIGURED		2
570#define CISS_LSTATUS_INTERIM_RECOVERY		3
571#define CISS_LSTATUS_READY_RECOVERY		4
572#define CISS_LSTATUS_RECOVERING			5
573#define CISS_LSTATUS_WRONG_PDRIVE		6
574#define CISS_LSTATUS_MISSING_PDRIVE		7
575#define CISS_LSTATUS_EXPANDING			10
576#define CISS_LSTATUS_BECOMING_READY		11
577#define CISS_LSTATUS_QUEUED_FOR_EXPANSION	12
578    u_int32_t	deprecated_drive_failure_map;
579    u_int8_t	res1[416];
580    u_int32_t	blocks_to_recover;
581    u_int8_t	deprecated_drive_rebuilding;
582    u_int16_t	deprecated_remap_count[32];
583    u_int32_t	deprecated_replacement_map;
584    u_int32_t	deprecated_active_spare_map;
585    u_int8_t	spare_configured:1;
586    u_int8_t	spare_rebuilding:1;
587    u_int8_t	spare_rebuilt:1;
588    u_int8_t	spare_failed:1;
589    u_int8_t	spare_switched:1;
590    u_int8_t	spare_available:1;
591    u_int8_t	res2:2;
592    u_int8_t	deprecated_spare_to_replace_map[32];
593    u_int32_t	deprecated_replaced_marked_ok_map;
594    u_int8_t	media_exchanged;
595    u_int8_t	cache_failure;
596    u_int8_t	expand_failure;
597    u_int8_t	rebuild_read_failure:1;
598    u_int8_t	rebuild_write_failure:1;
599    u_int8_t	res3:6;
600    u_int8_t	drive_failure_map[CISS_BIG_MAP_ENTRIES / 8];
601    u_int16_t	remap_count[CISS_BIG_MAP_ENTRIES];
602    u_int8_t	replacement_map[CISS_BIG_MAP_ENTRIES / 8];
603    u_int8_t	active_spare_map[CISS_BIG_MAP_ENTRIES / 8];
604    u_int8_t	spare_to_replace_map[CISS_BIG_MAP_ENTRIES];
605    u_int8_t	replaced_marked_ok_map[CISS_BIG_MAP_ENTRIES / 8];
606    u_int8_t	drive_rebuilding;
607    u_int64_t	big_blocks_to_recover;
608    u_int8_t	res4[28];
609} __packed;
610
611/* CISS_BMIC_ID_CTLR */
612struct ciss_bmic_id_table {
613    u_int8_t	configured_logical_drives;
614    u_int32_t	config_signature;
615    char	running_firmware_revision[4];
616    char	stored_firmware_revision[4];
617    u_int8_t	hardware_revision;
618    u_int8_t	boot_block_revision[4];
619    u_int32_t	deprecated_drive_present_map;
620    u_int32_t	deprecated_external_drive_present_map;
621    u_int32_t	board_id;
622    u_int8_t	swapped_error_cable;
623    u_int32_t	deprecated_non_disk_map;
624    u_int8_t	bad_host_ram_addr;
625    u_int8_t	cpu_revision;
626    u_int8_t	res3[3];
627    char	marketting_revision;
628    u_int8_t	controller_flags;
629#define	CONTROLLER_FLAGS_FLASH_ROM_INSTALLED	0x01
630#define	CONTROLLER_FLAGS_DIAGS_MODE_BIT		0x02
631#define	CONTROLLER_FLAGS_EXPAND_32MB_FX 	0x04
632#define	CONTROLLER_FLAGS_MORE_THAN_7_SUPPORT 	0x08
633#define	CONTROLLER_FLAGS_DAISY_SUPPORT_BIT 	0x10
634#define	CONTROLLER_FLAGS_RES6 			0x20
635#define	CONTROLLER_FLAGS_RES7 			0x40
636#define	CONTROLLER_FLAGS_BIG_MAP_SUPPORT 	0x80
637    u_int8_t	host_flags;
638#define HOST_FLAGS_SDB_ASIC_WORK_AROUND 	0x01
639#define HOST_FLAGS_PCI_DATA_BUS_PARITY_SUPPORT	0x02
640#define HOST_FLAGS_RES3				0x04
641#define HOST_FLAGS_RES4				0x08
642#define HOST_FLAGS_RES5				0x10
643#define HOST_FLAGS_RES6				0x20
644#define HOST_FLAGS_RES7				0x30
645#define HOST_FLAGS_RES8				0x40
646    u_int8_t	expand_disable_code;
647#define EXPAND_DISABLE_NOT_NEEDED		0x01
648#define EXPAND_DISABLE_MISSING_CACHE_BOARD	0x02
649#define EXPAND_DISABLE_WCXC_FATAL_CACHE_BITS	0x04
650#define EXPAND_DISABLE_CACHE_PERM_DISABLED	0x08
651#define EXPAND_DISABLE_RAM_ALLOCATION_FAILED	0x10
652#define EXPAND_DISABLE_BATTEREIS_DISCHARGED	0x20
653#define EXPAND_DISABLE_RES7			0x40
654#define EXPAND_DISABLE_REBUILD_RUNNING		0x80
655    u_int8_t	scsi_chip_count;
656    u_int32_t	maximum_blocks;
657    u_int32_t	controller_clock;
658    u_int8_t	drives_per_scsi_bus;
659    u_int8_t	big_drive_present_map[CISS_BIG_MAP_ENTRIES / 8];
660    u_int8_t	big_external_drive_present_map[CISS_BIG_MAP_ENTRIES / 8];
661    u_int8_t	big_non_disk_map[CISS_BIG_MAP_ENTRIES / 8];
662
663    u_int16_t	task_flags;		/* used for FW debugging */
664    u_int8_t	ICL_bus_map;		/* Bitmap used for ICL between controllers */
665    u_int8_t	redund_ctlr_modes_support;	/* See REDUNDANT MODE VALUES */
666    u_int8_t	curr_redund_ctlr_mode;
667    u_int8_t	redund_ctlr_status;
668    u_int8_t	redund_op_failure_code;
669
670    u_int8_t	unsupported_nile_bus;
671    u_int8_t	host_i2c_autorev;
672    u_int8_t	cpld_revision;
673    u_int8_t	fibre_chip_count;
674    u_int8_t	daughterboard_type;
675    u_int8_t	more_swapped_config_cable_error;
676
677    u_int8_t	license_key_status;
678    u_int8_t	access_module_status;
679    u_int8_t	features_supported[12];
680    u_int8_t	rec_rom_inact_rev[4];    /* Recovery ROM inactive f/w revision  */
681    u_int8_t	rec_rom_act_status;      /* Recovery ROM flags                  */
682    u_int8_t	pci_to_pci_status;       /* PCI to PCI bridge status            */
683    u_int32_t	redundant_server_info;   /* Reserved for future use             */
684    u_int8_t	percent_write_cache;     /* Percent of memory allocated to write cache */
685    u_int16_t	daughterboard_size_mb;   /* Total size (MB) of cache board      */
686    u_int8_t	cache_batter_count;      /* Number of cache batteries           */
687    u_int16_t	total_controller_mem_mb; /* Total size (MB) of atttached memory */
688    u_int8_t	more_controller_flags;   /* Additional controller flags byte    */
689    u_int8_t	x_board_host_i2c_rev;    /* 2nd byte of 3 byte autorev field    */
690    u_int8_t	battery_pic_rev;         /* BBWC PIC revision                   */
691/*
692 * Below here I have no documentation on the rest of this data structure.  It is
693 * inferred from the opensource cciss_vol_status application.  I assume that this
694 * data strucutre is 512 bytes in total size, do not exceed it.
695 */
696    u_int8_t	bDdffVersion[4];         /* DDFF update engine version          */
697    u_int16_t	usMaxLogicalUnits;       /* Maximum logical units supported */
698    u_int16_t	usExtLogicalUnitCount;   /* Big num configured logical units */
699    u_int16_t	usMaxPhysicalDevices;    /* Maximum physical devices supported */
700    u_int16_t	usMaxPhyDrvPerLogicalUnit; /* Max physical drive per logical unit */
701    u_int8_t	bEnclosureCount;         /* Number of attached enclosures */
702    u_int8_t	bExpanderCount;          /* Number of expanders detected */
703    u_int16_t	usOffsetToEDPbitmap;     /* Offset to extended drive present map*/
704    u_int16_t	usOffsetToEEDPbitmap;    /* Offset to extended external drive present map */
705    u_int16_t	usOffsetToENDbitmap;     /* Offset to extended non-disk map */
706    u_int8_t	bInternalPortStatus[8];  /* Internal port status bytes */
707    u_int8_t	bExternalPortStatus[8];  /* External port status bytes */
708    u_int32_t	uiYetMoreControllerFlags;/* Yet More Controller flags  */
709#define YMORE_CONTROLLER_FLAGS_JBOD_SUPPORTED \
710	( 1 << 25 )			 /* Controller has JBOD support */
711
712    u_int8_t	bLastLockup;              /* Last lockup code */
713    u_int8_t	bSlot;                    /* PCI slot according to option ROM*/
714    u_int16_t	usBuildNum;               /* Build number */
715    u_int32_t	uiMaxSafeFullStripeSize;  /* Maximum safe full stripe size */
716    u_int32_t	uiTotalLength;            /* Total structure length */
717    u_int8_t	bVendorID[8];             /* Vendor ID */
718    u_int8_t	bProductID[16];           /* Product ID */
719/*
720 * These are even more obscure as they seem to only be available in cciss_vol_status
721 */
722    u_int32_t	ExtendedLastLockupCode;
723    u_int16_t	MaxRaid;
724    u_int16_t	MaxParity;
725    u_int16_t	MaxADGStripSize;
726    u_int16_t	YetMoreSwappedCables;
727    u_int8_t	MaxDevicePaths;
728    u_int8_t	PowerUPNvramFlags;
729#define PWR_UP_FLAG_JBOD_ENABLED	0x08	/*JBOD mode is enabled, all RAID features off */
730
731    u_int16_t	ZonedOffset;
732    u_int32_t   FixedFieldsLength;
733    u_int8_t	FWCompileTimeStamp[24];
734    u_int32_t	EvenMoreControllerFlags;
735    u_int8_t	padding[240];
736} __packed;
737
738/* CISS_BMIC_ID_PDRIVE */
739struct ciss_bmic_id_pdrive {
740    u_int8_t	scsi_bus;
741    u_int8_t	scsi_id;
742    u_int16_t	block_size;
743    u_int32_t	total_blocks;
744    u_int32_t	reserved_blocks;
745    char	model[40];
746    char	serial[40];
747    char	revision[8];
748    u_int8_t	inquiry_bits;
749    u_int8_t	res1[2];
750    u_int8_t	drive_present:1;
751    u_int8_t	non_disk:1;
752    u_int8_t	wide:1;
753    u_int8_t	synchronous:1;
754    u_int8_t	narrow:1;
755    u_int8_t	wide_downgraded_to_narrow:1;
756    u_int8_t	ultra:1;
757    u_int8_t	ultra2:1;
758    u_int8_t	SMART:1;
759    u_int8_t	SMART_errors_recorded:1;
760    u_int8_t	SMART_errors_enabled:1;
761    u_int8_t	SMART_errors_detected:1;
762    u_int8_t	external:1;
763    u_int8_t	configured:1;
764    u_int8_t	configured_spare:1;
765    u_int8_t	cache_saved_enabled:1;
766    u_int8_t	res2;
767    u_int8_t	res3:6;
768    u_int8_t	cache_currently_enabled:1;
769    u_int8_t	cache_safe:1;
770    u_int8_t	res4[5];
771    char	connector[2];
772    u_int8_t	res5;
773    u_int8_t	bay;
774    u_int16_t	rpm;
775    u_int8_t	drive_type;
776    u_int8_t	res6[393];
777} __packed;
778
779/* CISS_BMIC_BLINK_PDRIVE */
780/* CISS_BMIC_SENSE_BLINK_PDRIVE */
781struct ciss_bmic_blink_pdrive {
782    u_int32_t	blink_duration;		/* 10ths of a second */
783    u_int32_t	duration_elapsed;	/* only for sense command  */
784    u_int8_t	blinktab[256];
785#define CISS_BMIC_BLINK_ALL	1
786#define CISS_BMIC_BLINK_TIMED	2
787    u_int8_t	res2[248];
788} __packed;
789
790/* CISS_BMIC_FLUSH_CACHE */
791struct ciss_bmic_flush_cache {
792    u_int16_t	flag;
793#define CISS_BMIC_FLUSH_AND_ENABLE	0
794#define CISS_BMIC_FLUSH_AND_DISABLE	1
795    u_int8_t	res1[510];
796} __packed;
797
798#ifdef _KERNEL
799/*
800 * CISS "simple" transport layer.
801 *
802 * Note that there are two slightly different versions of this interface
803 * with different interrupt mask bits.  There's nothing like consistency...
804 */
805#define CISS_TL_SIMPLE_BAR_REGS	0x10	/* BAR pointing to register space */
806#define CISS_TL_SIMPLE_BAR_CFG	0x14	/* BAR pointing to space containing config table */
807
808#define CISS_TL_SIMPLE_IDBR	0x20	/* inbound doorbell register */
809#define CISS_TL_SIMPLE_IDBR_CFG_TABLE	(1<<0)	/* notify controller of config table update */
810
811#define CISS_TL_SIMPLE_ISR	0x30	/* interrupt status register */
812#define CISS_TL_SIMPLE_IMR	0x34	/* interrupt mask register */
813#define CISS_TL_SIMPLE_INTR_OPQ_SA5	(1<<3)	/* OPQ not empty interrupt, SA5 boards */
814#define CISS_TL_SIMPLE_INTR_OPQ_SA5B	(1<<2)	/* OPQ not empty interrupt, SA5B boards */
815
816#define CISS_TL_SIMPLE_IPQ	0x40	/* inbound post queue */
817#define CISS_TL_SIMPLE_OPQ	0x44	/* outbound post queue */
818#define CISS_TL_SIMPLE_OPQ_EMPTY	(~(u_int32_t)0)
819
820#define CISS_TL_SIMPLE_OSR	0x9c	/* outbound status register */
821#define CISS_TL_SIMPLE_ODC	0xa0	/* outbound doorbell clear register */
822#define CISS_TL_SIMPLE_ODC_CLEAR	(0x1)
823
824#define CISS_TL_SIMPLE_CFG_BAR	0xb4	/* should be 0x14 */
825#define CISS_TL_SIMPLE_CFG_OFF	0xb8	/* offset in BAR at which config table is located */
826
827/*
828 * Register access primitives.
829 */
830#define CISS_TL_SIMPLE_READ(sc, ofs) \
831	bus_space_read_4(sc->ciss_regs_btag, sc->ciss_regs_bhandle, ofs)
832#define CISS_TL_SIMPLE_WRITE(sc, ofs, val) \
833	bus_space_write_4(sc->ciss_regs_btag, sc->ciss_regs_bhandle, ofs, val)
834
835#define CISS_TL_SIMPLE_POST_CMD(sc, phys)	CISS_TL_SIMPLE_WRITE(sc, CISS_TL_SIMPLE_IPQ, phys)
836#define CISS_TL_SIMPLE_FETCH_CMD(sc)		CISS_TL_SIMPLE_READ(sc, CISS_TL_SIMPLE_OPQ)
837
838#define CISS_TL_PERF_INTR_OPQ	(CISS_TL_SIMPLE_INTR_OPQ_SA5 | CISS_TL_SIMPLE_INTR_OPQ_SA5B)
839#define CISS_TL_PERF_INTR_MSI	0x01
840
841#define CISS_TL_PERF_POST_CMD(sc, cr)		CISS_TL_SIMPLE_WRITE(sc, CISS_TL_SIMPLE_IPQ, cr->cr_ccphys | (cr)->cr_sg_tag)
842#define CISS_TL_PERF_FLUSH_INT(sc)		CISS_TL_SIMPLE_READ(sc, CISS_TL_SIMPLE_OSR)
843#define CISS_TL_PERF_CLEAR_INT(sc)		CISS_TL_SIMPLE_WRITE(sc, CISS_TL_SIMPLE_ODC, CISS_TL_SIMPLE_ODC_CLEAR)
844#define CISS_CYCLE_MASK		0x00000001
845
846/* Only need one MSI/MSI-X vector */
847#define CISS_MSI_COUNT	1
848
849#define CISS_TL_SIMPLE_DISABLE_INTERRUPTS(sc) \
850	CISS_TL_SIMPLE_WRITE(sc, CISS_TL_SIMPLE_IMR, \
851			     CISS_TL_SIMPLE_READ(sc, CISS_TL_SIMPLE_IMR) | (sc)->ciss_interrupt_mask)
852#define CISS_TL_SIMPLE_ENABLE_INTERRUPTS(sc) \
853	CISS_TL_SIMPLE_WRITE(sc, CISS_TL_SIMPLE_IMR, \
854			     CISS_TL_SIMPLE_READ(sc, CISS_TL_SIMPLE_IMR) & ~(sc)->ciss_interrupt_mask)
855
856
857
858#endif /* _KERNEL */
859