Home | History | Annotate | Line # | Download | only in pci
      1 /*	$NetBSD: mlyreg.h,v 1.9 2024/02/10 09:21:53 andvar Exp $	*/
      2 
      3 /*-
      4  * Copyright (c) 2001 The NetBSD Foundation, Inc.
      5  * All rights reserved.
      6  *
      7  * This code is derived from software contributed to The NetBSD Foundation
      8  * by Andrew Doran, Thor Lancelot Simon, and Eric Haszlakiewicz.
      9  *
     10  * Redistribution and use in source and binary forms, with or without
     11  * modification, are permitted provided that the following conditions
     12  * are met:
     13  * 1. Redistributions of source code must retain the above copyright
     14  *    notice, this list of conditions and the following disclaimer.
     15  * 2. Redistributions in binary form must reproduce the above copyright
     16  *    notice, this list of conditions and the following disclaimer in the
     17  *    documentation and/or other materials provided with the distribution.
     18  *
     19  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     20  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     21  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     22  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     23  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     24  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     25  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     26  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     27  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     28  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     29  * POSSIBILITY OF SUCH DAMAGE.
     30  */
     31 
     32 /*-
     33  * Copyright (c) 2000 Michael Smith
     34  * Copyright (c) 2000 BSDi
     35  * All rights reserved.
     36  *
     37  * Redistribution and use in source and binary forms, with or without
     38  * modification, are permitted provided that the following conditions
     39  * are met:
     40  * 1. Redistributions of source code must retain the above copyright
     41  *    notice, this list of conditions and the following disclaimer.
     42  * 2. Redistributions in binary form must reproduce the above copyright
     43  *    notice, this list of conditions and the following disclaimer in the
     44  *    documentation and/or other materials provided with the distribution.
     45  *
     46  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
     47  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     48  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     49  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
     50  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     51  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     52  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     53  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     54  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     55  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     56  * SUCH DAMAGE.
     57  *
     58  * from FreeBSD: mlyreg.h,v 1.1 2000/08/23 03:22:39 msmith Exp
     59  */
     60 
     61 /*
     62  * Section numbers in this document refer to the Mylex "Firmware Software Interface"
     63  * document ('FSI'), revision 0.11 04/11/00 unless otherwise qualified.
     64  *
     65  * Reference is made to the Mylex "Programming Guide for 6.x Controllers" document
     66  * ('PG6'), document #771242 revision 0.02, 04/11/00
     67  *
     68  * Note that fields marked N/A are not supported by the PCI controllers, but are
     69  * defined here to hold place in datastructures that are shared with the SCSI
     70  * controllers.  Items not relevant to PCI controllers are not described here.
     71  *
     72  * Ordering of items in this file is a little odd due to the constraints of
     73  * nested declarations.
     74  */
     75 
     76 #ifndef _PCI_MLYREG_H_
     77 #define	_PCI_MLYREG_H_
     78 
     79 /*
     80  * 2.1 (Scatter Gather List Format)
     81  */
     82 struct mly_sg_entry {
     83 	u_int64_t	physaddr;
     84 	u_int64_t	length;
     85 } __packed;
     86 
     87 /*
     88  * 5.2 System Device Access
     89  *
     90  * This is corroborated by the layout of the MDACIOCTL_GETCONTROLLERINFO data
     91  * in 21.8
     92  */
     93 #define	MLY_MAX_CHANNELS	6
     94 #define	MLY_MAX_TARGETS		16
     95 #define	MLY_MAX_LUNS		1
     96 
     97 /*
     98  * 8.1 Different Device States
     99  */
    100 #define	MLY_DEVICE_STATE_OFFLINE	0x08	/* DEAD/OFFLINE */
    101 #define	MLY_DEVICE_STATE_UNCONFIGURED	0x00
    102 #define	MLY_DEVICE_STATE_ONLINE		0x01
    103 #define	MLY_DEVICE_STATE_CRITICAL	0x09
    104 #define	MLY_DEVICE_STATE_WRITEONLY	0x03
    105 #define	MLY_DEVICE_STATE_STANDBY	0x21
    106 #define	MLY_DEVICE_STATE_MISSING	0x04	/* or-ed with (ONLINE or WRITEONLY or STANDBY) */
    107 
    108 /*
    109  * 8.2 Device Type Field definitions
    110  */
    111 #define	MLY_DEVICE_TYPE_RAID0		0x0	/* RAID 0 */
    112 #define	MLY_DEVICE_TYPE_RAID1		0x1	/* RAID 1 */
    113 #define	MLY_DEVICE_TYPE_RAID3		0x3	/* RAID 3 right asymmetric parity */
    114 #define	MLY_DEVICE_TYPE_RAID5		0x5	/* RAID 5 right asymmetric parity */
    115 #define	MLY_DEVICE_TYPE_RAID6		0x6	/* RAID 6 (Mylex RAID 6) */
    116 #define	MLY_DEVICE_TYPE_RAID7		0x7	/* RAID 7 (JBOD) */
    117 #define	MLY_DEVICE_TYPE_NEWSPAN		0x8	/* New Mylex SPAN */
    118 #define	MLY_DEVICE_TYPE_RAID3F		0x9	/* RAID 3 fixed parity */
    119 #define	MLY_DEVICE_TYPE_RAID3L		0xb	/* RAID 3 left symmetric parity */
    120 #define	MLY_DEVICE_TYPE_SPAN		0xc	/* current spanning implementation */
    121 #define	MLY_DEVICE_TYPE_RAID5L		0xd	/* RAID 5 left symmetric parity */
    122 #define	MLY_DEVICE_TYPE_RAIDE		0xe	/* RAID E (concatenation) */
    123 #define	MLY_DEVICE_TYPE_PHYSICAL	0xf	/* physical device */
    124 
    125 /*
    126  * 8.3 Stripe Size
    127  */
    128 #define	MLY_STRIPE_ZERO		0x0	/* no stripe (RAID 1, RAID 7, etc) */
    129 #define	MLY_STRIPE_512b		0x1
    130 #define	MLY_STRIPE_1k		0x2
    131 #define	MLY_STRIPE_2k		0x3
    132 #define	MLY_STRIPE_4k		0x4
    133 #define	MLY_STRIPE_8k		0x5
    134 #define	MLY_STRIPE_16k		0x6
    135 #define	MLY_STRIPE_32k		0x7
    136 #define	MLY_STRIPE_64k		0x8
    137 #define	MLY_STRIPE_128k		0x9
    138 #define	MLY_STRIPE_256k		0xa
    139 #define	MLY_STRIPE_512k		0xb
    140 #define	MLY_STRIPE_1m		0xc
    141 
    142 /*
    143  * 8.4 Cacheline Size
    144  */
    145 #define	MLY_CACHELINE_ZERO	0x0	/* caching cannot be enabled */
    146 #define	MLY_CACHELINE_512b	0x1
    147 #define	MLY_CACHELINE_1k	0x2
    148 #define	MLY_CACHELINE_2k	0x3
    149 #define	MLY_CACHELINE_4k	0x4
    150 #define	MLY_CACHELINE_8k	0x5
    151 #define	MLY_CACHELINE_16k	0x6
    152 #define	MLY_CACHELINE_32k	0x7
    153 #define	MLY_CACHELINE_64k	0x8
    154 
    155 /*
    156  * 8.5 Read/Write control
    157  */
    158 #define	MLY_RWCtl_INITTED	(1<<7)	/* if set, the logical device is initialised */
    159 			/* write control */
    160 #define	MLY_RWCtl_WCD		(0)	/* write cache disabled */
    161 #define	MLY_RWCtl_WDISABLE	(1<<3)	/* writing disabled */
    162 #define	MLY_RWCtl_WCE		(2<<3)	/* write cache enabled */
    163 #define	MLY_RWCtl_IWCE		(3<<3)	/* intelligent write cache enabled */
    164 			/* read control */
    165 #define	MLY_RWCtl_RCD		(0)	/* read cache is disabled */
    166 #define	MLY_RWCtl_RCE		(1)	/* read cache enabled */
    167 #define	MLY_RWCtl_RAHEAD	(2)	/* readahead enabled */
    168 #define	MLY_RWCtl_IRAHEAD	(3)	/* intelligent readahead enabled */
    169 
    170 /*
    171  * 9.0 LUN Map Format
    172  */
    173 struct mly_lun_map {
    174 	u_int8_t	res1:4;
    175 	u_int8_t	host_port_mapped:1;	/* this system drive visibile to host on this controller/port combination */
    176 	u_int8_t	tid_valid:1;		/* target ID valid */
    177 	u_int8_t	hid_valid:1;		/* host ID valid */
    178 	u_int8_t	lun_valid:1;		/* LUN valid */
    179 	u_int8_t	res2;
    180 	u_int8_t	lun;			/* LUN */
    181 	u_int8_t	tid;			/* TID */
    182 	u_int8_t	hid[32];		/* HID (one bit for each host) */
    183 } __packed;
    184 
    185 /*
    186  * 10.1 Controller Parameters
    187  */
    188 struct mly_param_controller {
    189 	u_int8_t	rdahen:1;				/* N/A */
    190 	u_int8_t	bilodly:1;				/* N/A */
    191 	u_int8_t   	fua_disable:1;
    192 	u_int8_t	reass1s:1;				/* N/A */
    193 	u_int8_t	truvrfy:1;				/* N/A */
    194 	u_int8_t	dwtvrfy:1;				/* N/A */
    195 	u_int8_t	background_initialisation:1;
    196 	u_int8_t	clustering:1;				/* N/A */
    197 
    198 	u_int8_t	bios_disable:1;
    199 	u_int8_t   	boot_from_cdrom:1;
    200 	u_int8_t	drive_coercion:1;
    201 	u_int8_t	write_same_disable:1;
    202 	u_int8_t	hba_mode:1;				/* N/A */
    203 	u_int8_t	bios_geometry:2;
    204 #define	MLY_BIOSGEOM_2G	0x0
    205 #define	MLY_BIOSGEOM_8G	0x1
    206 	u_int8_t	res1:1;					/* N/A */
    207 
    208 	u_int8_t	res2[2];				/* N/A */
    209 
    210 	u_int8_t	v_dec:1;
    211 	u_int8_t	safte:1;				/* N/A */
    212 	u_int8_t	ses:1;					/* N/A */
    213 	u_int8_t	res3:2;					/* N/A */
    214 	u_int8_t	v_arm:1;
    215 	u_int8_t	v_ofm:1;
    216 	u_int8_t	res4:1;					/* N/A */
    217 
    218 	u_int8_t	rebuild_check_rate;
    219 	u_int8_t	cache_line_size;			/* see 8.4 */
    220 	u_int8_t	oem_code;
    221 #define	MLY_OEM_MYLEX	0x00
    222 #define	MLY_OEM_IBM	0x08
    223 #define	MLY_OEM_HP	0x0a
    224 #define	MLY_OEM_DEC	0x0c
    225 #define	MLY_OEM_SIEMENS	0x10
    226 #define	MLY_OEM_INTEL	0x12
    227 	u_int8_t	spinup_mode;
    228 #define	MLY_SPIN_AUTO		0
    229 #define	MLY_SPIN_PWRSPIN	1
    230 #define	MLY_SPIN_WSSUSPIN	2
    231 	u_int8_t	spinup_devices;
    232 	u_int8_t	spinup_interval;
    233 	u_int8_t	spinup_wait_time;
    234 
    235 	u_int8_t	res5:3;					/* N/A */
    236 	u_int8_t	vutursns:1;				/* N/A */
    237 	u_int8_t	dccfil:1;				/* N/A */
    238 	u_int8_t	nopause:1;				/* N/A */
    239 	u_int8_t	disqfull:1;				/* N/A */
    240 	u_int8_t	disbusy:1;				/* N/A */
    241 
    242 	u_int8_t	res6:2;					/* N/A */
    243 	u_int8_t	failover_node_name;			/* N/A */
    244 	u_int8_t	res7:1;					/* N/A */
    245 	u_int8_t	ftopo:3;				/* N/A */
    246 	u_int8_t	disable_ups:1;				/* N/A */
    247 
    248 	u_int8_t	res8:1;					/* N/A */
    249 	u_int8_t	propagate_reset:1;			/* N/A */
    250 	u_int8_t	nonstd_mp_reset:1;			/* N/A */
    251 	u_int8_t	res9:5;					/* N/A */
    252 
    253 	u_int8_t	res10;					/* N/A */
    254 	u_int8_t	serial_port_baud_rate;			/* N/A */
    255 	u_int8_t	serial_port_control;			/* N/A */
    256 	u_int8_t	change_stripe_ok_developer_flag_only;	/* N/A */
    257 
    258 	u_int8_t	small_large_host_transfers:2;		/* N/A */
    259 	u_int8_t	frame_control:2;			/* N/A */
    260 	u_int8_t	pci_latency_control:2;			/* N/A */
    261 	u_int8_t	treat_lip_as_reset:1;			/* N/A */
    262 	u_int8_t	res11:1;				/* N/A */
    263 
    264 	u_int8_t	ms_autorest:1;				/* N/A */
    265 	u_int8_t	res12:7;				/* N/A */
    266 
    267 	u_int8_t	ms_aa_fsim:1;				/* N/A */
    268 	u_int8_t	ms_aa_ccach:1;				/* N/A */
    269 	u_int8_t	ms_aa_fault_signals:1;			/* N/A */
    270 	u_int8_t	ms_aa_c4_faults:1;			/* N/A */
    271 	u_int8_t	ms_aa_host_reset_delay_mask:4;		/* N/A */
    272 
    273 	u_int8_t	ms_flg_simplex_no_rstcom:1;		/* N/A */
    274 	u_int8_t	res13:7;				/* N/A */
    275 
    276 	u_int8_t	res14;					/* N/A */
    277 	u_int8_t	hardloopid[2][2];			/* N/A */
    278 	u_int8_t	ctrlname[2][16+1];			/* N/A */
    279 	u_int8_t	initiator_id;
    280 	u_int8_t	startup_option;
    281 #define	MLY_STARTUP_IF_NO_CHANGE	0x0
    282 #define	MLY_STARTUP_IF_NO_LUN_CHANGE	0x1
    283 #define	MLY_STARTUP_IF_NO_LUN_OFFLINE	0x2
    284 #define	MLY_STARTUP_IF_LUN0_NO_CHANGE	0x3
    285 #define	MLY_STARTUP_IF_LUN0_NOT_OFFLINE	0x4
    286 #define	MLY_STARTUP_ALWAYS		0x5
    287 
    288 	u_int8_t	res15[62];
    289 } __packed;
    290 
    291 /*
    292  * 10.2 Physical Device Parameters
    293  */
    294 struct mly_param_physical_device {
    295 	u_int16_t	tags;
    296 	u_int16_t	speed;
    297 	u_int8_t	width;
    298 	u_int8_t	combing:1;
    299 	u_int8_t	res1:7;
    300 	u_int8_t	res2[3];
    301 } __packed;
    302 
    303 /*
    304  * 10.3 Logical Device Parameters
    305  */
    306 struct mly_param_logical_device {
    307 	u_int8_t	type;			/* see 8.2 */
    308 	u_int8_t	state;			/* see 8.1 */
    309 	u_int16_t	raid_device;
    310 	u_int8_t	res1;
    311 	u_int8_t	bios_geometry;		/* BIOS control word? */
    312 	u_int8_t	stripe_size;		/* see 8.3 */
    313 	u_int8_t	read_write_control;	/* see 8.5 */
    314 	u_int8_t	res2[8];
    315 } __packed;
    316 
    317 /*
    318  * 12.3 Health Status Buffer
    319  *
    320  * Pad to 128 bytes.
    321  */
    322 struct mly_health_status {
    323 	u_int32_t	uptime_us;				/* N/A */
    324 	u_int32_t	uptime_ms;				/* N/A */
    325 	u_int32_t	realtime;				/* N/A */
    326 	u_int32_t	res1;					/* N/A */
    327 	u_int32_t	change_counter;
    328 	u_int32_t	res2;					/* N/A */
    329 	u_int32_t	debug_message_index;			/* N/A */
    330 	u_int32_t	bios_message_index;			/* N/A */
    331 	u_int32_t	trace_page;				/* N/A */
    332 	u_int32_t	profiler_page;				/* N/A */
    333 	u_int32_t	next_event;
    334 	u_int8_t	res3[4 + 16 + 64];			/* N/A */
    335 } __packed;
    336 
    337 /*
    338  * 14.2 Timeout Bit Format
    339  */
    340 #define	MLY_TIMEOUT_SECONDS	0x00
    341 #define	MLY_TIMEOUT_MINUTES	0x40
    342 #define	MLY_TIMEOUT_HOURS	0x80
    343 
    344 /*
    345  * 14.3 Operation Device
    346  */
    347 #define	MLY_OPDEVICE_PHYSICAL_DEVICE		0x0
    348 #define	MLY_OPDEVICE_RAID_DEVICE		0x1
    349 #define	MLY_OPDEVICE_PHYSICAL_CHANNEL		0x2
    350 #define	MLY_OPDEVICE_RAID_CHANNEL		0x3
    351 #define	MLY_OPDEVICE_PHYSICAL_CONTROLLER	0x4
    352 #define	MLY_OPDEVICE_RAID_CONTROLLER		0x5
    353 #define	MLY_OPDEVICE_CONFIGURATION_GROUP	0x10
    354 
    355 /*
    356  * 14.4 Status Bit Format
    357  *
    358  * AKA Status Mailbox Format
    359  *
    360  * XXX format conflict between FSI and PG6 over the ordering of the
    361  * status and sense length fields.
    362  */
    363 struct mly_status {
    364 	u_int16_t	command_id;
    365 	u_int8_t	status;
    366 	u_int8_t	sense_length;
    367 	int32_t		residue;
    368 } __packed;
    369 
    370 /*
    371  * 14.5 Command Control Bit (CCB) format
    372  *
    373  * This byte is unfortunately named.
    374  */
    375 #define	MLY_CMDCTL_FORCE_UNIT_ACCESS	0x01
    376 #define	MLY_CMDCTL_DISABLE_PAGE_OUT	0x02
    377 #define	MLY_CMDCTL_EXTENDED_SG_TABLE	0x08
    378 #define	MLY_CMDCTL_DATA_DIRECTION	0x10
    379 #define	MLY_CMDCTL_NO_AUTO_SENSE	0x40
    380 #define	MLY_CMDCTL_DISABLE_DISCONNECT	0x80
    381 
    382 /*
    383  * 15.0 Commands
    384  *
    385  * We use the command names as given by Mylex
    386  */
    387 #define	MDACMD_MEMCOPY		0x1	/* memory to memory copy */
    388 #define	MDACMD_SCSIPT		0x2	/* SCSI passthrough (small command) */
    389 #define	MDACMD_SCSILCPT		0x3	/* SCSI passthrough (large command) */
    390 #define	MDACMD_SCSI		0x4	/* SCSI command for logical/physical device (small command) */
    391 #define	MDACMD_SCSILC		0x5	/* SCSI command for logical/physical device (large command) */
    392 #define	MDACMD_IOCTL		0x20	/* Management command */
    393 #define	MDACMD_IOCTLCHECK	0x23	/* Validate management command (not implemented) */
    394 
    395 /*
    396  * 16.0 IOCTL command
    397  *
    398  * We use the IOCTL names as given by Mylex
    399  * Note that only ioctls supported by the PCI controller family are listed
    400  */
    401 #define	MDACIOCTL_GETCONTROLLERINFO		0x1
    402 #define	MDACIOCTL_GETLOGDEVINFOVALID		0x3
    403 #define	MDACIOCTL_GETPHYSDEVINFOVALID		0x5
    404 #define	MDACIOCTL_GETCONTROLLERSTATISTICS	0xb
    405 #define	MDACIOCTL_GETLOGDEVSTATISTICS		0xd
    406 #define	MDACIOCTL_GETPHYSDEVSTATISTICS		0xf
    407 #define	MDACIOCTL_GETHEALTHSTATUS		0x11
    408 #define	MDACIOCTL_GETEVENT			0x15
    409 /* flash update */
    410 #define	MDACIOCTL_STOREIMAGE			0x2c
    411 #define	MDACIOCTL_READIMAGE			0x2d
    412 #define	MDACIOCTL_FLASHIMAGES			0x2e
    413 /* battery backup unit */
    414 #define	MDACIOCTL_GET_SUBSYSTEM_DATA		0x70
    415 #define	MDACIOCTL_SET_SUBSYSTEM_DATA		0x71
    416 /* non-data commands */
    417 #define	MDACIOCTL_STARTDISOCVERY		0x81
    418 #define	MDACIOCTL_SETRAIDDEVSTATE		0x82
    419 #define	MDACIOCTL_INITPHYSDEVSTART		0x84
    420 #define	MDACIOCTL_INITPHYSDEVSTOP		0x85
    421 #define	MDACIOCTL_INITRAIDDEVSTART		0x86
    422 #define	MDACIOCTL_INITRAIDDEVSTOP		0x87
    423 #define	MDACIOCTL_REBUILDRAIDDEVSTART		0x88
    424 #define	MDACIOCTL_REBUILDRAIDDEVSTOP		0x89
    425 #define	MDACIOCTL_MAKECONSISTENTDATASTART	0x8a
    426 #define	MDACIOCTL_MAKECONSISTENTDATASTOP	0x8b
    427 #define	MDACIOCTL_CONSISTENCYCHECKSTART		0x8c
    428 #define	MDACIOCTL_CONSISTENCYCHECKSTOP		0x8d
    429 #define	MDACIOCTL_SETMEMORYMAILBOX		0x8e
    430 #define	MDACIOCTL_RESETDEVICE			0x90
    431 #define	MDACIOCTL_FLUSHDEVICEDATA		0x91
    432 #define	MDACIOCTL_PAUSEDEVICE			0x92
    433 #define	MDACIOCTL_UNPAUSEDEVICE			0x93
    434 #define	MDACIOCTL_LOCATEDEVICE			0x94
    435 #define	MDACIOCTL_SETMASTERSLAVEMODE		0x95
    436 #define	MDACIOCTL_SETREALTIMECLOCK		0xac
    437 /* RAID configuration */
    438 #define	MDACIOCTL_CREATENEWCONF			0xc0
    439 #define	MDACIOCTL_DELETERAIDDEV			0xc1
    440 #define	MDACIOCTL_REPLACEINTERNALDEV		0xc2
    441 #define	MDACIOCTL_RENAMERAIDDEV			0xc3
    442 #define	MDACIOCTL_ADDNEWCONF			0xc4
    443 #define	MDACIOCTL_XLATEPHYSDEVTORAIDDEV		0xc5
    444 #define	MDACIOCTL_MORE				0xc6
    445 #define	MDACIOCTL_SETPHYSDEVPARAMETER		0xc8
    446 #define	MDACIOCTL_GETPHYSDEVPARAMETER		0xc9
    447 #define	MDACIOCTL_CLEARCONF			0xca
    448 #define	MDACIOCTL_GETDEVCONFINFO		0xcb
    449 #define	MDACIOCTL_GETGROUPCONFINFO		0xcc
    450 #define	MDACIOCTL_GETFREESPACELIST		0xcd
    451 #define	MDACIOCTL_GETLOGDEVPARAMETER		0xce
    452 #define	MDACIOCTL_SETLOGDEVPARAMETER		0xcf
    453 #define	MDACIOCTL_GETCONTROLLERPARAMETER	0xd0
    454 #define	MDACIOCTL_SETCONTRLLERPARAMETER		0xd1
    455 #define	MDACIOCTL_CLEARCONFSUSPMODE		0xd2
    456 #define	MDACIOCTL_GETBDT_FOR_SYSDRIVE		0xe0
    457 
    458 /*
    459  * 17.1.4 Data Transfer Memory Address Without SG List
    460  */
    461 struct mly_short_transfer {
    462 	struct mly_sg_entry	sg[2];
    463 } __packed;
    464 
    465 /*
    466  * 17.1.5 Data Transfer Memory Address With SG List
    467  *
    468  * Note that only the first s/g table is currently used.
    469  */
    470 struct mly_sg_transfer {
    471 	u_int16_t	entries[3];
    472 	u_int16_t	res1;
    473 	u_int64_t	table_physaddr[3];
    474 } __packed;
    475 
    476 /*
    477  * 17.1.3 Data Transfer Memory Address Format
    478  */
    479 union mly_cmd_transfer {
    480 	struct mly_short_transfer	direct;
    481 	struct mly_sg_transfer	indirect;
    482 };
    483 
    484 /*
    485  * 21.1  MDACIOCTL_SETREALTIMECLOCK
    486  * 21.7  MDACIOCTL_GETHEALTHSTATUS
    487  * 21.8  MDACIOCTL_GETCONTROLLERINFO
    488  * 21.9  MDACIOCTL_GETLOGDEVINFOVALID
    489  * 21.10 MDACIOCTL_GETPHYSDEVINFOVALID
    490  * 21.11 MDACIOCTL_GETPHYSDEVSTATISTICS
    491  * 21.12 MDACIOCTL_GETLOGDEVSTATISTICS
    492  * 21.13 MDACIOCTL_GETCONTROLLERSTATISTICS
    493  * 21.27 MDACIOCTL_GETBDT_FOR_SYSDRIVE
    494  * 23.4  MDACIOCTL_CREATENEWCONF
    495  * 23.5  MDACIOCTL_ADDNEWCONF
    496  * 23.8  MDACIOCTL_GETDEVCONFINFO
    497  * 23.9  MDACIOCTL_GETFREESPACELIST
    498  * 24.1  MDACIOCTL_MORE
    499  * 25.1  MDACIOCTL_GETPHYSDEVPARAMETER
    500  * 25.2  MDACIOCTL_SETPHYSDEVPARAMETER
    501  * 25.3  MDACIOCTL_GETLOGDEVPARAMETER
    502  * 25.4  MDACIOCTL_SETLOGDEVPARAMETER
    503  * 25.5  MDACIOCTL_GETCONTROLLERPARAMETER
    504  * 25.6  MDACIOCTL_SETCONTROLLERPARAMETER
    505  *
    506  * These commands just transfer data
    507  */
    508 struct mly_ioctl_param_data {
    509 	u_int8_t	param[10];
    510 	union mly_cmd_transfer	transfer;
    511 } __packed;
    512 
    513 /*
    514  * 21.2 MDACIOCTL_SETMEMORYMAILBOX
    515  */
    516 struct mly_ioctl_param_setmemorymailbox {
    517 	u_int8_t	health_buffer_size;
    518 	u_int8_t	res1;
    519 	u_int64_t	health_buffer_physaddr;
    520 	u_int64_t	command_mailbox_physaddr;
    521 	u_int64_t	status_mailbox_physaddr;
    522 	u_int64_t	res2[2];
    523 } __packed;
    524 
    525 /*
    526  * 21.8.2 MDACIOCTL_GETCONTROLLERINFO: Data Format
    527  */
    528 struct mly_ioctl_getcontrollerinfo {
    529 	u_int8_t	res1;					/* N/A */
    530 	u_int8_t	interface_type;
    531 	u_int8_t	controller_type;
    532 	u_int8_t	res2;					/* N/A */
    533 	u_int16_t	interface_speed;
    534 	u_int8_t	interface_width;
    535 	u_int8_t	res3[9];				/* N/A */
    536 	char		interface_name[16];
    537 	char		controller_name[16];
    538 	u_int8_t	res4[16];				/* N/A */
    539 	/* firmware release information */
    540 	u_int8_t	fw_major;
    541 	u_int8_t	fw_minor;
    542 	u_int8_t	fw_turn;
    543 	u_int8_t	fw_build;
    544 	u_int8_t	fw_day;
    545 	u_int8_t	fw_month;
    546 	u_int8_t	fw_century;
    547 	u_int8_t	fw_year;
    548 	/* hardware release information */
    549 	u_int8_t	hw_revision;				/* N/A */
    550 	u_int8_t	res5[3];				/* N/A */
    551 	u_int8_t	hw_release_day;				/* N/A */
    552 	u_int8_t	hw_release_month;			/* N/A */
    553 	u_int8_t	hw_release_century;			/* N/A */
    554 	u_int8_t	hw_release_year;			/* N/A */
    555 	/* hardware manufacturing information */
    556 	u_int8_t	batch_number;				/* N/A */
    557 	u_int8_t	res6;					/* N/A */
    558 	u_int8_t	plant_number;
    559 	u_int8_t	res7;
    560 	u_int8_t	hw_manuf_day;
    561 	u_int8_t	hw_manuf_month;
    562 	u_int8_t	hw_manuf_century;
    563 	u_int8_t	hw_manuf_year;
    564 	u_int8_t	max_pdd_per_xldd;
    565 	u_int8_t	max_ildd_per_xldd;
    566 	u_int16_t	nvram_size;
    567 	u_int8_t	max_number_of_xld;			/* N/A */
    568 	u_int8_t	res8[3];				/* N/A */
    569 	/* unique information per controller */
    570 	char		serial_number[16];
    571 	u_int8_t	res9[16];				/* N/A */
    572 	/* vendor information */
    573 	u_int8_t	res10[3];				/* N/A */
    574 	u_int8_t	oem_information;
    575 	char		vendor_name[16];			/* N/A */
    576 	/* other physical/controller/operation information */
    577 	u_int8_t	bbu_present:1;
    578 	u_int8_t	active_clustering:1;
    579 	u_int8_t	res11:6;				/* N/A */
    580 	u_int8_t	res12[3];				/* N/A */
    581 	/* physical device scan information */
    582 	u_int8_t	physical_scan_active:1;
    583 	u_int8_t	res13:7;				/* N/A */
    584 	u_int8_t	physical_scan_channel;
    585 	u_int8_t	physical_scan_target;
    586 	u_int8_t	physical_scan_lun;
    587 	/* maximum command data transfer size */
    588 	u_int16_t	maximum_block_count;
    589 	u_int16_t	maximum_sg_entries;
    590 	/* logical/physical device counts */
    591 	u_int16_t	logical_devices_present;
    592 	u_int16_t	logical_devices_critical;
    593 	u_int16_t	logical_devices_offline;
    594 	u_int16_t	physical_devices_present;
    595 	u_int16_t	physical_disks_present;
    596 	u_int16_t	physical_disks_critical;		/* N/A */
    597 	u_int16_t	physical_disks_offline;
    598 	u_int16_t	maximum_parallel_commands;
    599 	/* channel and target ID information */
    600 	u_int8_t	physical_channels_present;
    601 	u_int8_t	virtual_channels_present;
    602 	u_int8_t	physical_channels_possible;
    603 	u_int8_t	virtual_channels_possible;
    604 	u_int8_t	maximum_targets_possible[16];		/* N/A (6 and up) */
    605 	u_int8_t	res14[12];				/* N/A */
    606 	/* memory/cache information */
    607 	u_int16_t	memory_size;
    608 	u_int16_t	cache_size;
    609 	u_int32_t	valid_cache_size;			/* N/A */
    610 	u_int32_t	dirty_cache_size;			/* N/A */
    611 	u_int16_t	memory_speed;
    612 	u_int8_t	memory_width;
    613 	u_int8_t	memory_type:5;
    614 	u_int8_t	res15:1;				/* N/A */
    615 	u_int8_t	memory_parity:1;
    616 	u_int8_t	memory_ecc:1;
    617 	char		memory_information[16];			/* N/A */
    618 	/* execution memory information */
    619 	u_int16_t	exmemory_size;
    620 	u_int16_t	l2cache_size;				/* N/A */
    621 	u_int8_t	res16[8];				/* N/A */
    622 	u_int16_t	exmemory_speed;
    623 	u_int8_t	exmemory_width;
    624 	u_int8_t	exmemory_type:5;
    625 	u_int8_t	res17:1;				/* N/A */
    626 	u_int8_t	exmemory_parity:1;
    627 	u_int8_t	exmemory_ecc:1;
    628 	char		exmemory_name[16];			/* N/A */
    629 	/* CPU information */
    630 	struct {
    631 		u_int16_t	speed;
    632 		u_int8_t	type;
    633 		u_int8_t	number;
    634 		u_int8_t	res1[12];			/* N/A */
    635 		char		name[16];			/* N/A */
    636 	} cpu[2] __packed;
    637 	/* debugging/profiling/command time tracing information */
    638 	u_int16_t	profiling_page;				/* N/A */
    639 	u_int16_t	profiling_programs;			/* N/A */
    640 	u_int16_t	time_trace_page;			/* N/A */
    641 	u_int16_t	time_trace_programs;			/* N/A */
    642 	u_int8_t	res18[8];				/* N/A */
    643 	/* error counters on physical devices */
    644 	u_int16_t	physical_device_bus_resets;		/* N/A */
    645 	u_int16_t	physical_device_parity_errors;		/* N/A */
    646 	u_int16_t	physical_device_soft_errors;		/* N/A */
    647 	u_int16_t	physical_device_commands_failed;	/* N/A */
    648 	u_int16_t	physical_device_miscellaneous_errors;	/* N/A */
    649 	u_int16_t	physical_device_command_timeouts;	/* N/A */
    650 	u_int16_t	physical_device_selection_timeouts;	/* N/A */
    651 	u_int16_t	physical_device_retries;		/* N/A */
    652 	u_int16_t	physical_device_aborts;			/* N/A */
    653 	u_int16_t	physical_device_host_command_aborts;	/* N/A */
    654 	u_int16_t	physical_device_PFAs_detected;		/* N/A */
    655 	u_int16_t	physical_device_host_commands_failed;	/* N/A */
    656 	u_int8_t	res19[8];				/* N/A */
    657 	/* error counters on logical devices */
    658 	u_int16_t	logical_device_soft_errors;		/* N/A */
    659 	u_int16_t	logical_device_commands_failed;		/* N/A */
    660 	u_int16_t	logical_device_host_command_aborts;	/* N/A */
    661 	u_int16_t	res20;					/* N/A */
    662 	/* error counters on controller */
    663 	u_int16_t	controller_parity_ecc_errors;
    664 	u_int16_t	controller_host_command_aborts;		/* N/A */
    665 	u_int8_t	res21[4];				/* N/A */
    666 	/* long duration activity information */
    667 	u_int16_t	background_inits_active;
    668 	u_int16_t	logical_inits_active;
    669 	u_int16_t	physical_inits_active;
    670 	u_int16_t	consistency_checks_active;
    671 	u_int16_t	rebuilds_active;
    672 	u_int16_t	MORE_active;
    673 	u_int16_t	patrol_active;				/* N/A */
    674 	u_int8_t	long_operation_status;			/* N/A */
    675 	u_int8_t	res22;					/* N/A */
    676 	/* flash ROM information */
    677 	u_int8_t	flash_type;				/* N/A */
    678 	u_int8_t	res23;					/* N/A */
    679 	u_int16_t	flash_size;
    680 	u_int32_t	flash_maximum_age;
    681 	u_int32_t	flash_age;
    682 	u_int8_t	res24[4];				/* N/A */
    683 	char		flash_name[16];				/* N/A */
    684 	/* firmware runtime information */
    685 	u_int8_t	rebuild_rate;
    686 	u_int8_t	background_init_rate;
    687 	u_int8_t	init_rate;
    688 	u_int8_t	consistency_check_rate;
    689 	u_int8_t	res25[4];				/* N/A */
    690 	u_int32_t	maximum_dp;
    691 	u_int32_t	free_dp;
    692 	u_int32_t	maximum_iop;
    693 	u_int32_t	free_iop;
    694 	u_int16_t	maximum_comb_length;
    695 	u_int16_t	maximum_configuration_groups;
    696 	u_int8_t	installation_abort:1;
    697 	u_int8_t	maintenance:1;
    698 	u_int8_t	res26:6;				/* N/A */
    699 	u_int8_t	res27[3];				/* N/A */
    700 	u_int8_t	res28[32 + 512];			/* N/A */
    701 } __packed;
    702 
    703 /*
    704  * 21.9.2 MDACIOCTL_GETLOGDEVINFOVALID
    705  */
    706 struct mly_ioctl_getlogdevinfovalid {
    707 	u_int8_t	res1;					/* N/A */
    708 	u_int8_t	channel;
    709 	u_int8_t	target;
    710 	u_int8_t	lun;
    711 	u_int8_t	state;					/* see 8.1 */
    712 	u_int8_t	raid_level;				/* see 8.2 */
    713 	u_int8_t	stripe_size;				/* see 8.3 */
    714 	u_int8_t	cache_line_size;			/* see 8.4 */
    715 	u_int8_t	read_write_control;			/* see 8.5 */
    716 	u_int8_t	consistency_check:1;
    717 	u_int8_t	rebuild:1;
    718 	u_int8_t	make_consistent:1;
    719 	u_int8_t	initialisation:1;
    720 	u_int8_t	migration:1;
    721 	u_int8_t	patrol:1;
    722 	u_int8_t	res2:2;					/* N/A */
    723 	u_int8_t	ar5_limit;
    724 	u_int8_t	ar5_algo;
    725 	u_int16_t	logical_device_number;
    726 	u_int16_t	bios_control;
    727 	/* error counters */
    728 	u_int16_t	soft_errors;				/* N/A */
    729 	u_int16_t	commands_failed;			/* N/A */
    730 	u_int16_t	host_command_aborts;			/* N/A */
    731 	u_int16_t	deferred_write_errors;			/* N/A */
    732 	u_int8_t	res3[8];				/* N/A */
    733 	/* device size information */
    734 	u_int8_t	res4[2];				/* N/A */
    735 	u_int16_t	device_block_size;
    736 	u_int32_t	original_device_size;			/* N/A */
    737 	u_int32_t	device_size;		/* XXX "blocks or MB" Huh? */
    738 	u_int8_t	res5[4];				/* N/A */
    739 	char		device_name[32];			/* N/A */
    740 	u_int8_t	inquiry[36];
    741 	u_int8_t	res6[12];				/* N/A */
    742 	u_int64_t	last_read_block;			/* N/A */
    743 	u_int64_t	last_written_block;			/* N/A */
    744 	u_int64_t	consistency_check_block;
    745 	u_int64_t	rebuild_block;
    746 	u_int64_t	make_consistent_block;
    747 	u_int64_t	initialisation_block;
    748 	u_int64_t	migration_block;
    749 	u_int64_t	patrol_block;				/* N/A */
    750 	u_int8_t	res7[64];				/* N/A */
    751 } __packed;
    752 
    753 /*
    754  * 21.10.2 MDACIOCTL_GETPHYSDEVINFOVALID: Data Format
    755  */
    756 struct mly_ioctl_getphysdevinfovalid {
    757 	u_int8_t	res1;
    758 	u_int8_t	channel;
    759 	u_int8_t	target;
    760 	u_int8_t	lun;
    761 	u_int8_t	raid_ft:1;			/* configuration status */
    762 	u_int8_t	res2:1;					/* N/A */
    763 	u_int8_t	local:1;
    764 	u_int8_t	res3:5;
    765 	u_int8_t	host_dead:1;			/* multiple host/controller status *//* N/A */
    766 	u_int8_t	host_connection_dead:1;			/* N/A */
    767 	u_int8_t	res4:6;					/* N/A */
    768 	u_int8_t	state;				/* see 8.1 */
    769 	u_int8_t	width;
    770 	u_int16_t	speed;
    771 	/* multiported physical device information */
    772 	u_int8_t	ports_available;			/* N/A */
    773 	u_int8_t	ports_inuse;				/* N/A */
    774 	u_int8_t	res5[4];
    775 	u_int8_t	ether_address[16];			/* N/A */
    776 	u_int16_t	command_tags;
    777 	u_int8_t	consistency_check:1;			/* N/A */
    778 	u_int8_t	rebuild:1;				/* N/A */
    779 	u_int8_t	make_consistent:1;			/* N/A */
    780 	u_int8_t	initialisation:1;
    781 	u_int8_t	migration:1;				/* N/A */
    782 	u_int8_t	patrol:1;				/* N/A */
    783 	u_int8_t	res6:2;
    784 	u_int8_t	long_operation_status;			/* N/A */
    785 	u_int8_t	parity_errors;
    786 	u_int8_t	soft_errors;
    787 	u_int8_t	hard_errors;
    788 	u_int8_t	miscellaneous_errors;
    789 	u_int8_t	command_timeouts;			/* N/A */
    790 	u_int8_t	retries;				/* N/A */
    791 	u_int8_t	aborts;					/* N/A */
    792 	u_int8_t	PFAs_detected;				/* N/A */
    793 	u_int8_t	res7[6];
    794 	u_int16_t	block_size;
    795 	u_int32_t	original_device_size;		/* XXX "blocks or MB" Huh? */
    796 	u_int32_t	device_size;			/* XXX "blocks or MB" Huh? */
    797 	u_int8_t	res8[4];
    798 	char		name[16];				/* N/A */
    799 	u_int8_t	res9[16 + 32];
    800 	u_int8_t	inquiry[36];
    801 	u_int8_t	res10[12 + 16];
    802 	u_int64_t	last_read_block;			/* N/A */
    803 	u_int64_t	last_written_block;			/* N/A */
    804 	u_int64_t	consistency_check_block;		/* N/A */
    805 	u_int64_t	rebuild_block;				/* N/A */
    806 	u_int64_t	make_consistent_block;			/* N/A */
    807 	u_int64_t	initialisation_block;			/* N/A */
    808 	u_int64_t	migration_block;			/* N/A */
    809 	u_int64_t	patrol_block;				/* N/A */
    810 	u_int8_t	res11[256];
    811 } __packed;
    812 
    813 union mly_devinfo {
    814 	struct mly_ioctl_getlogdevinfovalid	logdev;
    815 	struct mly_ioctl_getphysdevinfovalid	physdev;
    816 };
    817 
    818 /*
    819  * 21.11.2 MDACIOCTL_GETPHYSDEVSTATISTICS: Data Format
    820  * 21.12.2 MDACIOCTL_GETLOGDEVSTATISTICS: Data Format
    821  */
    822 struct mly_ioctl_getdevstatistics {
    823 	u_int32_t	uptime_ms;			/* getphysedevstatistics only */
    824 	u_int8_t	res1[5];				/* N/A */
    825 	u_int8_t	channel;
    826 	u_int8_t	target;
    827 	u_int8_t	lun;
    828 	u_int16_t	raid_device;			/* getlogdevstatistics only */
    829 	u_int8_t	res2[2];				/* N/A */
    830 	/* total read/write performance including cache data */
    831 	u_int32_t	total_reads;
    832 	u_int32_t	total_writes;
    833 	u_int32_t	total_read_size;
    834 	u_int32_t	total_write_size;
    835 	/* cache read/write performance */
    836 	u_int32_t	cache_reads;				/* N/A */
    837 	u_int32_t	cache_writes;				/* N/A */
    838 	u_int32_t	cache_read_size;			/* N/A */
    839 	u_int32_t	cache_write_size;			/* N/A */
    840 	/* commands active/wait information */
    841 	u_int32_t	command_waits_done;			/* N/A */
    842 	u_int16_t	active_commands;			/* N/A */
    843 	u_int16_t	waiting_commands;			/* N/A */
    844 	u_int8_t	res3[8];				/* N/A */
    845 } __packed;
    846 
    847 /*
    848  * 21.13.2 MDACIOCTL_GETCONTROLLERSTATISTICS: Data Format
    849  */
    850 struct mly_ioctl_getcontrollerstatistics {
    851 	u_int32_t	uptime_ms;				/* N/A */
    852 	u_int8_t	res1[12];				/* N/A */
    853 	/* target physical device performance data information */
    854 	u_int32_t	target_physical_device_interrupts;	/* N/A */
    855 	u_int32_t	target_physical_device_stray_interrupts;/* N/A */
    856 	u_int8_t	res2[8];				/* N/A */
    857 	u_int32_t	target_physical_device_reads;		/* N/A */
    858 	u_int32_t	target_physical_device_writes;		/* N/A */
    859 	u_int32_t	target_physical_device_read_size;	/* N/A */
    860 	u_int32_t	target_physical_device_write_size;	/* N/A */
    861 	/* host system performance data information */
    862 	u_int32_t	host_system_interrupts;			/* N/A */
    863 	u_int32_t	host_system_stray_interrupts;		/* N/A */
    864 	u_int32_t	host_system_sent_interrupts;		/* N/A */
    865 	u_int8_t	res3[4];				/* N/A */
    866 	u_int32_t	physical_device_reads;			/* N/A */
    867 	u_int32_t	physical_device_writes;			/* N/A */
    868 	u_int32_t	physical_device_read_size;		/* N/A */
    869 	u_int32_t	physical_device_write_size;		/* N/A */
    870 	u_int32_t	physical_device_cache_reads;		/* N/A */
    871 	u_int32_t	physical_device_cache_writes;		/* N/A */
    872 	u_int32_t	physical_device_cache_read_size;	/* N/A */
    873 	u_int32_t	physical_device_cache_write_size;	/* N/A */
    874 	u_int32_t	logical_device_reads;			/* N/A */
    875 	u_int32_t	logical_device_writes;			/* N/A */
    876 	u_int32_t	logical_device_read_size;		/* N/A */
    877 	u_int32_t	logical_device_write_size;		/* N/A */
    878 	u_int32_t	logical_device_cache_reads;		/* N/A */
    879 	u_int32_t	logical_device_cache_writes;		/* N/A */
    880 	u_int32_t	logical_device_cache_read_size;		/* N/A */
    881 	u_int32_t	logical_device_cache_write_size;	/* N/A */
    882 	u_int16_t	target_physical_device_commands_active;	/* N/A */
    883 	u_int16_t	target_physical_device_commands_waiting;/* N/A */
    884 	u_int16_t	host_system_commands_active;		/* N/A */
    885 	u_int16_t	host_system_commands_waiting;		/* N/A */
    886 	u_int8_t	res4[48 + 64];				/* N/A */
    887 } __packed;
    888 
    889 /*
    890  * 21.2 MDACIOCTL_SETRAIDDEVSTATE
    891  */
    892 struct mly_ioctl_param_setraiddevstate {
    893 	u_int8_t	state;
    894 } __packed;
    895 
    896 /*
    897  * 21.27.2 MDACIOCTL_GETBDT_FOR_SYSDRIVE: Data Format
    898  */
    899 #define	MLY_MAX_BDT_ENTRIES	1022
    900 struct mly_ioctl_getbdt_for_sysdrive {
    901 	u_int32_t	num_of_bdt_entries;
    902 	u_int32_t	bad_data_block_address[MLY_MAX_BDT_ENTRIES];
    903 } __packed;
    904 
    905 /*
    906  * 22.1 Physical Device Definition (PDD)
    907  */
    908 struct mly_pdd {
    909 	u_int8_t	type;				/* see 8.2 */
    910 	u_int8_t	state;				/* see 8.1 */
    911 	u_int16_t	raid_device;
    912 	u_int32_t	device_size;			/* XXX "block or MB" Huh? */
    913 	u_int8_t	controller;
    914 	u_int8_t	channel;
    915 	u_int8_t	target;
    916 	u_int8_t	lun;
    917 	u_int32_t	start_address;
    918 } __packed;
    919 
    920 /*
    921  * 22.2 RAID Device Use Definition (UDD)
    922  */
    923 struct mly_udd {
    924 	u_int8_t	res1;
    925 	u_int8_t	state;				/* see 8.1 */
    926 	u_int16_t	raid_device;
    927 	u_int32_t	start_address;
    928 } __packed;
    929 
    930 /*
    931  * RAID Device Definition (LDD)
    932  */
    933 struct mly_ldd {
    934 	u_int8_t	type;				/* see 8.2 */
    935 	u_int8_t	state;				/* see 8.1 */
    936 	u_int16_t	raid_device;
    937 	u_int32_t	device_size;			/* XXX "block or MB" Huh? */
    938 	u_int8_t	devices_used_count;
    939 	u_int8_t	stripe_size;			/* see 8.3 */
    940 	u_int8_t	cache_line_size;		/* see 8.4 */
    941 	u_int8_t	read_write_control;		/* see 8.5 */
    942 	u_int32_t	devices_used_size;		/* XXX "block or MB" Huh? */
    943 	u_int16_t	devices_used[32];		/* XXX actual size of this field unknown! */
    944 } __packed;
    945 
    946 /*
    947  * Define a datastructure giving the smallest allocation that will hold
    948  * a PDD, UDD or LDD for MDACIOCTL_GETDEVCONFINFO.
    949  */
    950 struct mly_devconf_hdr {
    951 	u_int8_t	type;				/* see 8.2 */
    952 	u_int8_t	state;				/* see 8.1 */
    953 	u_int16_t	raid_device;
    954 };
    955 
    956 union mly_ioctl_devconfinfo {
    957 	struct mly_pdd		pdd;
    958 	struct mly_udd		udd;
    959 	struct mly_ldd		ldd;
    960 	struct mly_devconf_hdr	hdr;
    961 };
    962 
    963 /*
    964  * 22.3 MDACIOCTL_RENAMERAIDDEV
    965  *
    966  * XXX this command is listed as transferring data, but does not define the data.
    967  */
    968 struct mly_ioctl_param_renameraiddev {
    969 	u_int8_t	new_raid_device;
    970 } __packed;
    971 
    972 /*
    973  * 23.6.2 MDACIOCTL_XLATEPHYSDEVTORAIDDEV
    974  *
    975  * XXX documentation suggests this format will change
    976  */
    977 struct mly_ioctl_param_xlatephysdevtoraiddev {
    978 	u_int16_t	raid_device;
    979 	u_int8_t	res1[2];
    980 	u_int8_t	controller;
    981 	u_int8_t	channel;
    982 	u_int8_t	target;
    983 	u_int8_t	lun;
    984 } __packed;
    985 
    986 /*
    987  * 23.7 MDACIOCTL_GETGROUPCONFINFO
    988  */
    989 struct mly_ioctl_param_getgroupconfinfo {
    990 	u_int16_t			group;
    991 	u_int8_t			res1[8];
    992 	union mly_cmd_transfer	transfer;
    993 } __packed;
    994 
    995 /*
    996  * 23.9.2 MDACIOCTL_GETFREESPACELIST: Data Format
    997  *
    998  * The controller will populate as much of this structure as is provided,
    999  * or as is required to fully list the free space available.
   1000  */
   1001 struct mly_ioctl_getfreespacelist_entry {
   1002 	u_int16_t	raid_device;
   1003 	u_int8_t	res1[6];
   1004 	u_int32_t	address;		/* XXX "blocks or MB" Huh? */
   1005 	u_int32_t	size;			/* XXX "blocks or MB" Huh? */
   1006 } __packed;
   1007 
   1008 struct mly_ioctl_getfrespacelist {
   1009 	u_int16_t	returned_entries;
   1010 	u_int16_t	total_entries;
   1011 	u_int8_t	res1[12];
   1012 	struct mly_ioctl_getfreespacelist_entry space[];	/* expand to suit */
   1013 } __packed;
   1014 
   1015 /*
   1016  * 27.1 MDACIOCTL_GETSUBSYSTEMDATA
   1017  * 27.2 MDACIOCTL_SETSUBSYSTEMDATA
   1018  *
   1019  * PCI controller only supports a limited subset of the possible operations.
   1020  *
   1021  * XXX where does the status end up? (the command transfers no data)
   1022  */
   1023 struct mly_ioctl_param_subsystemdata {
   1024 	u_int8_t	operation:4;
   1025 #define	MLY_BBU_GETSTATUS	0x00
   1026 #define	MLY_BBU_SET_THRESHOLD	0x00	/* minutes in param[0,1] */
   1027 	u_int8_t	subsystem:4;
   1028 #define	MLY_SUBSYSTEM_BBU	0x01
   1029 	u_int	parameter[3];		/* only for SETSUBSYSTEMDATA */
   1030 } __packed;
   1031 
   1032 struct mly_ioctl_getsubsystemdata_bbustatus {
   1033 	u_int16_t	current_power;
   1034 	u_int16_t	maximum_power;
   1035 	u_int16_t	power_threshold;
   1036 	u_int8_t	charge_level;
   1037 	u_int8_t	hardware_version;
   1038 	u_int8_t	battery_type;
   1039 #define	MLY_BBU_TYPE_UNKNOWN	0x00
   1040 #define	MLY_BBU_TYPE_NICAD	0x01
   1041 #define	MLY_BBU_TYPE_MISSING	0xfe
   1042 	u_int8_t	res1;
   1043 	u_int8_t	operation_status;
   1044 #define	MLY_BBU_STATUS_NO_SYNC		0x01
   1045 #define	MLY_BBU_STATUS_OUT_OF_SYNC	0x02
   1046 #define	MLY_BBU_STATUS_FIRST_WARNING	0x04
   1047 #define	MLY_BBU_STATUS_SECOND_WARNING	0x08
   1048 #define	MLY_BBU_STATUS_RECONDITIONING	0x10
   1049 #define	MLY_BBU_STATUS_DISCHARGING	0x20
   1050 #define	MLY_BBU_STATUS_FASTCHARGING	0x40
   1051 	u_int8_t	res2;
   1052 } __packed;
   1053 
   1054 /*
   1055  * 28.9  MDACIOCTL_RESETDEVICE
   1056  * 28.10 MDACIOCTL_FLUSHDEVICEDATA
   1057  * 28.11 MDACIOCTL_PAUSEDEVICE
   1058  * 28.12 MDACIOCTL_UNPAUSEDEVICE
   1059  */
   1060 struct mly_ioctl_param_deviceoperation {
   1061 	u_int8_t	operation_device;		/* see 14.3 */
   1062 } __packed;
   1063 
   1064 /*
   1065  * 31.1 Event Data Format
   1066  */
   1067 struct mly_event {
   1068 	u_int32_t	sequence_number;
   1069 	u_int32_t	timestamp;
   1070 	u_int32_t	code;
   1071 	u_int8_t	controller;
   1072 	u_int8_t	channel;
   1073 	u_int8_t	target;				/* also enclosure */
   1074 	u_int8_t	lun;				/* also enclosure unit */
   1075 	u_int8_t   	res1[4];
   1076 	u_int32_t	param;
   1077 	u_int8_t	sense[40];
   1078 } __packed;
   1079 
   1080 /*
   1081  * 31.2 MDACIOCTL_GETEVENT
   1082  */
   1083 struct mly_ioctl_param_getevent {
   1084 	u_int16_t		sequence_number_low;
   1085 	u_int8_t		res1[8];
   1086 	union mly_cmd_transfer	transfer;
   1087 } __packed;
   1088 
   1089 union mly_ioctl_param {
   1090 	struct mly_ioctl_param_data			data;
   1091 	struct mly_ioctl_param_setmemorymailbox		setmemorymailbox;
   1092 	struct mly_ioctl_param_setraiddevstate		setraiddevstate;
   1093 	struct mly_ioctl_param_renameraiddev		renameraiddev;
   1094 	struct mly_ioctl_param_xlatephysdevtoraiddev	xlatephysdevtoraiddev;
   1095 	struct mly_ioctl_param_getgroupconfinfo		getgroupconfinfo;
   1096 	struct mly_ioctl_param_subsystemdata		subsystemdata;
   1097 	struct mly_ioctl_param_deviceoperation		deviceoperation;
   1098 	struct mly_ioctl_param_getevent			getevent;
   1099 };
   1100 
   1101 /*
   1102  * 19 SCSI Command Format
   1103  */
   1104 #define	MLY_PHYADDR(c, b, t, l)	\
   1105 	((l) | ((t) << 8) | ((b) << 16) | ((c) << 19))
   1106 #define	MLY_LOGADDR(c, u)	\
   1107 	((u) | ((c) << 19))
   1108 
   1109 #define	MLY_LOGADDR_DEV(a)		(a & 0xffff)
   1110 #define	MLY_LOGADDR_CTLR(a)		(a >> 19)
   1111 
   1112 #define	MLY_PHYADDR_LUN(a)		(a & 0xff)
   1113 #define	MLY_PHYADDR_TARGET(a)		((a >> 8) & 0xff)
   1114 #define	MLY_PHYADDR_CHANNEL(a)		((a >> 16) & 0x07)
   1115 #define	MLY_PHYADDR_CTLR(a)		((a >> 19) & 0x1f)
   1116 
   1117 /*
   1118  * struct mly_cmd_address_physical {
   1119  *	u_int8_t			lun;
   1120  *	u_int8_t			target;
   1121  *	u_int8_t			channel:3;
   1122  *	u_int8_t			controller:5;
   1123  * } __packed;
   1124  *
   1125  * struct mly_cmd_address_logical {
   1126  *	u_int16_t			logdev;
   1127  *	u_int8_t			res1:3;
   1128  *	u_int8_t			controller:5;
   1129  * } __packed;
   1130  */
   1131 
   1132 struct mly_cmd_generic {
   1133 	u_int16_t			command_id;
   1134 	u_int8_t			opcode;
   1135 	u_int8_t			command_control;
   1136 	u_int32_t			data_size;
   1137 	u_int64_t			sense_buffer_address;
   1138 	u_int8_t			addr[3];
   1139 	u_int8_t			timeout;
   1140 	u_int8_t			maximum_sense_size;
   1141 	u_int8_t			res1[11];
   1142 	union mly_cmd_transfer	transfer;
   1143 } __packed;
   1144 
   1145 
   1146 /*
   1147  * 19.1 MDACMD_SCSI & MDACMD_SCSIPT
   1148  */
   1149 #define	MLY_CMD_SCSI_SMALL_CDB	10
   1150 struct mly_cmd_scsi_small {
   1151 	u_int16_t			command_id;
   1152 	u_int8_t			opcode;
   1153 	u_int8_t			command_control;
   1154 	u_int32_t			data_size;
   1155 	u_int64_t			sense_buffer_address;
   1156 	u_int8_t			addr[3];
   1157 	u_int8_t			timeout;
   1158 	u_int8_t			maximum_sense_size;
   1159 	u_int8_t			cdb_length;
   1160 	u_int8_t			cdb[MLY_CMD_SCSI_SMALL_CDB];
   1161 	union mly_cmd_transfer	transfer;
   1162 } __packed;
   1163 
   1164 /*
   1165  * 19.2 MDACMD_SCSILC & MDACMD_SCSILCPT
   1166  */
   1167 struct mly_cmd_scsi_large {
   1168 	u_int16_t			command_id;
   1169 	u_int8_t			opcode;
   1170 	u_int8_t			command_control;
   1171 	u_int32_t			data_size;
   1172 	u_int64_t			sense_buffer_address;
   1173 	u_int8_t			addr[3];
   1174 	u_int8_t			timeout;
   1175 	u_int8_t			maximum_sense_size;
   1176 	u_int8_t			cdb_length;
   1177 	u_int16_t			res1;
   1178 	u_int64_t			cdb_physaddr;
   1179 	union mly_cmd_transfer	transfer;
   1180 } __packed;
   1181 
   1182 /*
   1183  * 20.1 IOCTL Command Format: Internal Bus
   1184  */
   1185 struct mly_cmd_ioctl {
   1186 	u_int16_t			command_id;
   1187 	u_int8_t			opcode;
   1188 	u_int8_t			command_control;
   1189 	u_int32_t			data_size;
   1190 	u_int64_t			sense_buffer_address;
   1191 	u_int8_t			addr[3];
   1192 	u_int8_t			timeout;
   1193 	u_int8_t			maximum_sense_size;
   1194 	u_int8_t			sub_ioctl;
   1195 	union mly_ioctl_param		param;
   1196 } __packed;
   1197 
   1198 /*
   1199  * PG6: 8.2.2
   1200  */
   1201 struct mly_cmd_mmbox {
   1202 	u_int32_t			flag;
   1203 	u_int8_t			data[60];
   1204 } __packed;
   1205 
   1206 union mly_cmd_packet {
   1207 	struct mly_cmd_generic		generic;
   1208 	struct mly_cmd_scsi_small	scsi_small;
   1209 	struct mly_cmd_scsi_large	scsi_large;
   1210 	struct mly_cmd_ioctl		ioctl;
   1211 	struct mly_cmd_mmbox		mmbox;
   1212 };
   1213 
   1214 /*
   1215  * PG6: 5.3
   1216  */
   1217 #define	MLY_I960RX_COMMAND_MAILBOX	0x10
   1218 #define	MLY_I960RX_STATUS_MAILBOX	0x18
   1219 #define	MLY_I960RX_IDBR			0x20
   1220 #define	MLY_I960RX_ODBR			0x2c
   1221 #define	MLY_I960RX_ERROR_STATUS		0x2e
   1222 #define	MLY_I960RX_INTERRUPT_STATUS	0x30
   1223 #define	MLY_I960RX_INTERRUPT_MASK	0x34
   1224 
   1225 #define	MLY_STRONGARM_COMMAND_MAILBOX	0x50
   1226 #define	MLY_STRONGARM_STATUS_MAILBOX	0x58
   1227 #define	MLY_STRONGARM_IDBR		0x60
   1228 #define	MLY_STRONGARM_ODBR		0x61
   1229 #define	MLY_STRONGARM_ERROR_STATUS	0x63
   1230 #define	MLY_STRONGARM_INTERRUPT_STATUS	0x30
   1231 #define	MLY_STRONGARM_INTERRUPT_MASK	0x34
   1232 
   1233 /*
   1234  * PG6: 5.4.3 Doorbell 0
   1235  */
   1236 #define	MLY_HM_CMDSENT			(1<<0)
   1237 #define	MLY_HM_STSACK			(1<<1)
   1238 #define	MLY_SOFT_RST			(1<<3)
   1239 #define	MLY_AM_CMDSENT			(1<<4)
   1240 
   1241 /*
   1242  * PG6: 5.4.4 Doorbell 1
   1243  *
   1244  * Note that the documentation claims that these bits are set when the
   1245  * status queue(s) are empty, whereas the Linux driver and experience
   1246  * suggest they are set when there is status available.
   1247  */
   1248 #define	MLY_HM_STSREADY			(1<<0)
   1249 #define	MLY_AM_STSREADY			(1<<1)
   1250 
   1251 /*
   1252  * PG6: 5.4.6 Doorbell 3
   1253  */
   1254 #define	MLY_MSG_EMPTY			(1<<3)
   1255 #define	MLY_MSG_SPINUP			0x08
   1256 #define	MLY_MSG_RACE_RECOVERY_FAIL	0x60
   1257 #define	MLY_MSG_RACE_IN_PROGRESS	0x70
   1258 #define	MLY_MSG_RACE_ON_CRITICAL	0xb0
   1259 #define	MLY_MSG_PARITY_ERROR		0xf0
   1260 
   1261 /*
   1262  * PG6: 5.4.8 Outbound Interrupt Mask
   1263  */
   1264 #define	MLY_INTERRUPT_MASK_DISABLE	0xff
   1265 #define	MLY_INTERRUPT_MASK_ENABLE	(0xff & ~(1<<2))
   1266 
   1267 /*
   1268  * PG6: 8.2 Advanced Mailbox Scheme
   1269  *
   1270  * Note that this must be allocated on a 4k boundary, and all internal
   1271  * fields must also reside on a 4k boundary.
   1272  * We could dynamically size this structure, but the extra effort
   1273  * is probably unjustified.  Note that these buffers do not need to be
   1274  * adjacent - we just group them to simplify allocation of the bus-visible
   1275  * buffer.
   1276  *
   1277  * XXX Note that for some reason, if MLY_MMBOX_COMMANDS is > 64, the controller
   1278  * fails to respond to the command at (MLY_MMBOX_COMMANDS - 64).  It's not
   1279  * wrapping to 0 at this point (determined by experimentation).  This is not
   1280  * consistent with the Linux driver's implementation.
   1281  * Whilst it's handy to have lots of room for status returns in case we end up
   1282  * being slow getting back to completed commands, it seems unlikely that we
   1283  * would get 64 commands ahead of the controller on the submissions side, so
   1284  * the current workaround is to simply limit the command ring to 64 entries.
   1285  */
   1286 union mly_status_packet {
   1287 	 struct mly_status		status;
   1288 	 struct {
   1289 		 u_int32_t		flag;
   1290 		 u_int8_t		data[4];
   1291 	 } __packed mmbox;
   1292 };
   1293 union mly_health_region {
   1294 	struct mly_health_status	status;
   1295 	u_int8_t			pad[1024];
   1296 };
   1297 
   1298 #define	MLY_MMBOX_COMMANDS		64
   1299 #define	MLY_MMBOX_STATUS		512
   1300 struct mly_mmbox {
   1301 	union mly_cmd_packet	mmm_command[MLY_MMBOX_COMMANDS];
   1302 	union mly_status_packet	mmm_status[MLY_MMBOX_STATUS];
   1303 	union mly_health_region	mmm_health;
   1304 } __packed;
   1305 
   1306 #endif	/* !defined _PCI_MLYREG_H_ */
   1307