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 */
82struct 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 */
173struct 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 */
188struct 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 */
294struct 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 */
306struct 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 */
322struct 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 */
363struct 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 */
461struct 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 */
470struct 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 */
479union 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 */
508struct 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 */
516struct 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 */
528struct 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 */
706struct 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 */
756struct 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
813union 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 */
822struct 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 */
850struct 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 */
892struct 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
900struct 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 */
908struct 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 */
923struct 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 */
933struct 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 */
950struct 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
956union 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 */
968struct 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 */
977struct 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 */
989struct 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 */
1001struct 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
1008struct 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 */
1023struct 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
1032struct 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 */
1060struct mly_ioctl_param_deviceoperation {
1061 u_int8_t operation_device; /* see 14.3 */
1062} __packed;
1063
1064/*
1065 * 31.1 Event Data Format
1066 */
1067struct 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 */
1083struct 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
1089union 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
1132struct 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
1150struct 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 */
1167struct 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 */
1185struct 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 */
1201struct mly_cmd_mmbox {
1202 u_int32_t flag;
1203 u_int8_t data[60];
1204} __packed;
1205
1206union 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 */
1286union 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};
1293union 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
1300struct 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_ */