xref: /freebsd/sys/dev/mpr/mpr_sas_lsi.c (revision c697fb7f)
1 /*-
2  * Copyright (c) 2011-2015 LSI Corp.
3  * Copyright (c) 2013-2016 Avago Technologies
4  * Copyright 2000-2020 Broadcom Inc.
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26  * SUCH DAMAGE.
27  *
28  * Broadcom Inc. (LSI) MPT-Fusion Host Adapter FreeBSD
29  */
30 
31 #include <sys/cdefs.h>
32 __FBSDID("$FreeBSD$");
33 
34 /* Communications core for Avago Technologies (LSI) MPT3 */
35 
36 /* TODO Move headers to mprvar */
37 #include <sys/types.h>
38 #include <sys/param.h>
39 #include <sys/systm.h>
40 #include <sys/kernel.h>
41 #include <sys/selinfo.h>
42 #include <sys/module.h>
43 #include <sys/bus.h>
44 #include <sys/conf.h>
45 #include <sys/bio.h>
46 #include <sys/malloc.h>
47 #include <sys/uio.h>
48 #include <sys/sysctl.h>
49 #include <sys/endian.h>
50 #include <sys/proc.h>
51 #include <sys/queue.h>
52 #include <sys/kthread.h>
53 #include <sys/taskqueue.h>
54 #include <sys/sbuf.h>
55 #include <sys/reboot.h>
56 
57 #include <machine/bus.h>
58 #include <machine/resource.h>
59 #include <sys/rman.h>
60 
61 #include <machine/stdarg.h>
62 
63 #include <cam/cam.h>
64 #include <cam/cam_ccb.h>
65 #include <cam/cam_debug.h>
66 #include <cam/cam_sim.h>
67 #include <cam/cam_xpt_sim.h>
68 #include <cam/cam_xpt_periph.h>
69 #include <cam/cam_periph.h>
70 #include <cam/scsi/scsi_all.h>
71 #include <cam/scsi/scsi_message.h>
72 
73 #include <dev/mpr/mpi/mpi2_type.h>
74 #include <dev/mpr/mpi/mpi2.h>
75 #include <dev/mpr/mpi/mpi2_ioc.h>
76 #include <dev/mpr/mpi/mpi2_sas.h>
77 #include <dev/mpr/mpi/mpi2_pci.h>
78 #include <dev/mpr/mpi/mpi2_cnfg.h>
79 #include <dev/mpr/mpi/mpi2_init.h>
80 #include <dev/mpr/mpi/mpi2_raid.h>
81 #include <dev/mpr/mpi/mpi2_tool.h>
82 #include <dev/mpr/mpr_ioctl.h>
83 #include <dev/mpr/mprvar.h>
84 #include <dev/mpr/mpr_table.h>
85 #include <dev/mpr/mpr_sas.h>
86 
87 /* For Hashed SAS Address creation for SATA Drives */
88 #define MPT2SAS_SN_LEN 20
89 #define MPT2SAS_MN_LEN 40
90 
91 struct mpr_fw_event_work {
92 	u16			event;
93 	void			*event_data;
94 	TAILQ_ENTRY(mpr_fw_event_work)	ev_link;
95 };
96 
97 union _sata_sas_address {
98 	u8 wwid[8];
99 	struct {
100 		u32 high;
101 		u32 low;
102 	} word;
103 };
104 
105 /*
106  * define the IDENTIFY DEVICE structure
107  */
108 struct _ata_identify_device_data {
109 	u16 reserved1[10];	/* 0-9 */
110 	u16 serial_number[10];	/* 10-19 */
111 	u16 reserved2[7];	/* 20-26 */
112 	u16 model_number[20];	/* 27-46*/
113 	u16 reserved3[170];	/* 47-216 */
114 	u16 rotational_speed;	/* 217 */
115 	u16 reserved4[38];	/* 218-255 */
116 };
117 static u32 event_count;
118 static void mprsas_fw_work(struct mpr_softc *sc,
119     struct mpr_fw_event_work *fw_event);
120 static void mprsas_fw_event_free(struct mpr_softc *,
121     struct mpr_fw_event_work *);
122 static int mprsas_add_device(struct mpr_softc *sc, u16 handle, u8 linkrate);
123 static int mprsas_add_pcie_device(struct mpr_softc *sc, u16 handle,
124     u8 linkrate);
125 static int mprsas_get_sata_identify(struct mpr_softc *sc, u16 handle,
126     Mpi2SataPassthroughReply_t *mpi_reply, char *id_buffer, int sz,
127     u32 devinfo);
128 static void mprsas_ata_id_timeout(struct mpr_softc *, struct mpr_command *);
129 int mprsas_get_sas_address_for_sata_disk(struct mpr_softc *sc,
130     u64 *sas_address, u16 handle, u32 device_info, u8 *is_SATA_SSD);
131 static int mprsas_volume_add(struct mpr_softc *sc,
132     u16 handle);
133 static void mprsas_SSU_to_SATA_devices(struct mpr_softc *sc, int howto);
134 static void mprsas_stop_unit_done(struct cam_periph *periph,
135     union ccb *done_ccb);
136 
137 void
138 mprsas_evt_handler(struct mpr_softc *sc, uintptr_t data,
139     MPI2_EVENT_NOTIFICATION_REPLY *event)
140 {
141 	struct mpr_fw_event_work *fw_event;
142 	u16 sz;
143 
144 	mpr_dprint(sc, MPR_TRACE, "%s\n", __func__);
145 	MPR_DPRINT_EVENT(sc, sas, event);
146 	mprsas_record_event(sc, event);
147 
148 	fw_event = malloc(sizeof(struct mpr_fw_event_work), M_MPR,
149 	     M_ZERO|M_NOWAIT);
150 	if (!fw_event) {
151 		printf("%s: allocate failed for fw_event\n", __func__);
152 		return;
153 	}
154 	sz = le16toh(event->EventDataLength) * 4;
155 	fw_event->event_data = malloc(sz, M_MPR, M_ZERO|M_NOWAIT);
156 	if (!fw_event->event_data) {
157 		printf("%s: allocate failed for event_data\n", __func__);
158 		free(fw_event, M_MPR);
159 		return;
160 	}
161 
162 	bcopy(event->EventData, fw_event->event_data, sz);
163 	fw_event->event = event->Event;
164 	if ((event->Event == MPI2_EVENT_SAS_TOPOLOGY_CHANGE_LIST ||
165 	    event->Event == MPI2_EVENT_PCIE_TOPOLOGY_CHANGE_LIST ||
166 	    event->Event == MPI2_EVENT_SAS_ENCL_DEVICE_STATUS_CHANGE ||
167 	    event->Event == MPI2_EVENT_IR_CONFIGURATION_CHANGE_LIST) &&
168 	    sc->track_mapping_events)
169 		sc->pending_map_events++;
170 
171 	/*
172 	 * When wait_for_port_enable flag is set, make sure that all the events
173 	 * are processed. Increment the startup_refcount and decrement it after
174 	 * events are processed.
175 	 */
176 	if ((event->Event == MPI2_EVENT_SAS_TOPOLOGY_CHANGE_LIST ||
177 	    event->Event == MPI2_EVENT_PCIE_TOPOLOGY_CHANGE_LIST ||
178 	    event->Event == MPI2_EVENT_IR_CONFIGURATION_CHANGE_LIST) &&
179 	    sc->wait_for_port_enable)
180 		mprsas_startup_increment(sc->sassc);
181 
182 	TAILQ_INSERT_TAIL(&sc->sassc->ev_queue, fw_event, ev_link);
183 	taskqueue_enqueue(sc->sassc->ev_tq, &sc->sassc->ev_task);
184 }
185 
186 static void
187 mprsas_fw_event_free(struct mpr_softc *sc, struct mpr_fw_event_work *fw_event)
188 {
189 
190 	free(fw_event->event_data, M_MPR);
191 	free(fw_event, M_MPR);
192 }
193 
194 /**
195  * _mpr_fw_work - delayed task for processing firmware events
196  * @sc: per adapter object
197  * @fw_event: The fw_event_work object
198  * Context: user.
199  *
200  * Return nothing.
201  */
202 static void
203 mprsas_fw_work(struct mpr_softc *sc, struct mpr_fw_event_work *fw_event)
204 {
205 	struct mprsas_softc *sassc;
206 	sassc = sc->sassc;
207 
208 	mpr_dprint(sc, MPR_EVENT, "(%d)->(%s) Working on  Event: [%x]\n",
209 	    event_count++, __func__, fw_event->event);
210 	switch (fw_event->event) {
211 	case MPI2_EVENT_SAS_TOPOLOGY_CHANGE_LIST:
212 	{
213 		MPI2_EVENT_DATA_SAS_TOPOLOGY_CHANGE_LIST *data;
214 		MPI2_EVENT_SAS_TOPO_PHY_ENTRY *phy;
215 		uint8_t i;
216 
217 		data = (MPI2_EVENT_DATA_SAS_TOPOLOGY_CHANGE_LIST *)
218 		    fw_event->event_data;
219 
220 		mpr_mapping_topology_change_event(sc, fw_event->event_data);
221 
222 		for (i = 0; i < data->NumEntries; i++) {
223 			phy = &data->PHY[i];
224 			switch (phy->PhyStatus & MPI2_EVENT_SAS_TOPO_RC_MASK) {
225 			case MPI2_EVENT_SAS_TOPO_RC_TARG_ADDED:
226 				if (mprsas_add_device(sc,
227 				    le16toh(phy->AttachedDevHandle),
228 				    phy->LinkRate)) {
229 					mpr_dprint(sc, MPR_ERROR, "%s: "
230 					    "failed to add device with handle "
231 					    "0x%x\n", __func__,
232 					    le16toh(phy->AttachedDevHandle));
233 					mprsas_prepare_remove(sassc, le16toh(
234 					    phy->AttachedDevHandle));
235 				}
236 				break;
237 			case MPI2_EVENT_SAS_TOPO_RC_TARG_NOT_RESPONDING:
238 				mprsas_prepare_remove(sassc, le16toh(
239 				    phy->AttachedDevHandle));
240 				break;
241 			case MPI2_EVENT_SAS_TOPO_RC_PHY_CHANGED:
242 			case MPI2_EVENT_SAS_TOPO_RC_NO_CHANGE:
243 			case MPI2_EVENT_SAS_TOPO_RC_DELAY_NOT_RESPONDING:
244 			default:
245 				break;
246 			}
247 		}
248 		/*
249 		 * refcount was incremented for this event in
250 		 * mprsas_evt_handler.  Decrement it here because the event has
251 		 * been processed.
252 		 */
253 		mprsas_startup_decrement(sassc);
254 		break;
255 	}
256 	case MPI2_EVENT_SAS_DISCOVERY:
257 	{
258 		MPI2_EVENT_DATA_SAS_DISCOVERY *data;
259 
260 		data = (MPI2_EVENT_DATA_SAS_DISCOVERY *)fw_event->event_data;
261 
262 		if (data->ReasonCode & MPI2_EVENT_SAS_DISC_RC_STARTED)
263 			mpr_dprint(sc, MPR_TRACE,"SAS discovery start event\n");
264 		if (data->ReasonCode & MPI2_EVENT_SAS_DISC_RC_COMPLETED) {
265 			mpr_dprint(sc, MPR_TRACE,"SAS discovery stop event\n");
266 			sassc->flags &= ~MPRSAS_IN_DISCOVERY;
267 			mprsas_discovery_end(sassc);
268 		}
269 		break;
270 	}
271 	case MPI2_EVENT_SAS_ENCL_DEVICE_STATUS_CHANGE:
272 	{
273 		Mpi2EventDataSasEnclDevStatusChange_t *data;
274 		data = (Mpi2EventDataSasEnclDevStatusChange_t *)
275 		    fw_event->event_data;
276 		mpr_mapping_enclosure_dev_status_change_event(sc,
277 		    fw_event->event_data);
278 		break;
279 	}
280 	case MPI2_EVENT_IR_CONFIGURATION_CHANGE_LIST:
281 	{
282 		Mpi2EventIrConfigElement_t *element;
283 		int i;
284 		u8 foreign_config, reason;
285 		u16 elementType;
286 		Mpi2EventDataIrConfigChangeList_t *event_data;
287 		struct mprsas_target *targ;
288 		unsigned int id;
289 
290 		event_data = fw_event->event_data;
291 		foreign_config = (le32toh(event_data->Flags) &
292 		    MPI2_EVENT_IR_CHANGE_FLAGS_FOREIGN_CONFIG) ? 1 : 0;
293 
294 		element =
295 		    (Mpi2EventIrConfigElement_t *)&event_data->ConfigElement[0];
296 		id = mpr_mapping_get_raid_tid_from_handle(sc,
297 		    element->VolDevHandle);
298 
299 		mpr_mapping_ir_config_change_event(sc, event_data);
300 		for (i = 0; i < event_data->NumElements; i++, element++) {
301 			reason = element->ReasonCode;
302 			elementType = le16toh(element->ElementFlags) &
303 			    MPI2_EVENT_IR_CHANGE_EFLAGS_ELEMENT_TYPE_MASK;
304 			/*
305 			 * check for element type of Phys Disk or Hot Spare
306 			 */
307 			if ((elementType !=
308 			    MPI2_EVENT_IR_CHANGE_EFLAGS_VOLPHYSDISK_ELEMENT)
309 			    && (elementType !=
310 			    MPI2_EVENT_IR_CHANGE_EFLAGS_HOTSPARE_ELEMENT))
311 				// do next element
312 				goto skip_fp_send;
313 
314 			/*
315 			 * check for reason of Hide, Unhide, PD Created, or PD
316 			 * Deleted
317 			 */
318 			if ((reason != MPI2_EVENT_IR_CHANGE_RC_HIDE) &&
319 			    (reason != MPI2_EVENT_IR_CHANGE_RC_UNHIDE) &&
320 			    (reason != MPI2_EVENT_IR_CHANGE_RC_PD_CREATED) &&
321 			    (reason != MPI2_EVENT_IR_CHANGE_RC_PD_DELETED))
322 				goto skip_fp_send;
323 
324 			// check for a reason of Hide or PD Created
325 			if ((reason == MPI2_EVENT_IR_CHANGE_RC_HIDE) ||
326 			    (reason == MPI2_EVENT_IR_CHANGE_RC_PD_CREATED))
327 			{
328 				// build RAID Action message
329 				Mpi2RaidActionRequest_t	*action;
330 				Mpi2RaidActionReply_t *reply = NULL;
331 				struct mpr_command *cm;
332 				int error = 0;
333 				if ((cm = mpr_alloc_command(sc)) == NULL) {
334 					printf("%s: command alloc failed\n",
335 					    __func__);
336 					return;
337 				}
338 
339 				mpr_dprint(sc, MPR_EVENT, "Sending FP action "
340 				    "from "
341 				    "MPI2_EVENT_IR_CONFIGURATION_CHANGE_LIST "
342 				    ":\n");
343 				action = (MPI2_RAID_ACTION_REQUEST *)cm->cm_req;
344 				action->Function = MPI2_FUNCTION_RAID_ACTION;
345 				action->Action =
346 				    MPI2_RAID_ACTION_PHYSDISK_HIDDEN;
347 				action->PhysDiskNum = element->PhysDiskNum;
348 				cm->cm_desc.Default.RequestFlags =
349 				    MPI2_REQ_DESCRIPT_FLAGS_DEFAULT_TYPE;
350 				error = mpr_request_polled(sc, &cm);
351 				if (cm != NULL)
352 					reply = (Mpi2RaidActionReply_t *)
353 					    cm->cm_reply;
354 				if (error || (reply == NULL)) {
355 					/* FIXME */
356 					/*
357 					 * If the poll returns error then we
358 					 * need to do diag reset
359 					 */
360 					printf("%s: poll for page completed "
361 					    "with error %d", __func__, error);
362 				}
363 				if (reply && (le16toh(reply->IOCStatus) &
364 				    MPI2_IOCSTATUS_MASK) !=
365 				    MPI2_IOCSTATUS_SUCCESS) {
366 					mpr_dprint(sc, MPR_ERROR, "%s: error "
367 					    "sending RaidActionPage; "
368 					    "iocstatus = 0x%x\n", __func__,
369 					    le16toh(reply->IOCStatus));
370 				}
371 
372 				if (cm)
373 					mpr_free_command(sc, cm);
374 			}
375 skip_fp_send:
376 			mpr_dprint(sc, MPR_EVENT, "Received "
377 			    "MPI2_EVENT_IR_CONFIGURATION_CHANGE_LIST Reason "
378 			    "code %x:\n", element->ReasonCode);
379 			switch (element->ReasonCode) {
380 			case MPI2_EVENT_IR_CHANGE_RC_VOLUME_CREATED:
381 			case MPI2_EVENT_IR_CHANGE_RC_ADDED:
382 				if (!foreign_config) {
383 					if (mprsas_volume_add(sc,
384 					    le16toh(element->VolDevHandle))) {
385 						printf("%s: failed to add RAID "
386 						    "volume with handle 0x%x\n",
387 						    __func__, le16toh(element->
388 						    VolDevHandle));
389 					}
390 				}
391 				break;
392 			case MPI2_EVENT_IR_CHANGE_RC_VOLUME_DELETED:
393 			case MPI2_EVENT_IR_CHANGE_RC_REMOVED:
394 				/*
395 				 * Rescan after volume is deleted or removed.
396 				 */
397 				if (!foreign_config) {
398 					if (id == MPR_MAP_BAD_ID) {
399 						printf("%s: could not get ID "
400 						    "for volume with handle "
401 						    "0x%04x\n", __func__,
402 						    le16toh(element->
403 						    VolDevHandle));
404 						break;
405 					}
406 
407 					targ = &sassc->targets[id];
408 					targ->handle = 0x0;
409 					targ->encl_slot = 0x0;
410 					targ->encl_handle = 0x0;
411 					targ->encl_level_valid = 0x0;
412 					targ->encl_level = 0x0;
413 					targ->connector_name[0] = ' ';
414 					targ->connector_name[1] = ' ';
415 					targ->connector_name[2] = ' ';
416 					targ->connector_name[3] = ' ';
417 					targ->exp_dev_handle = 0x0;
418 					targ->phy_num = 0x0;
419 					targ->linkrate = 0x0;
420 					mprsas_rescan_target(sc, targ);
421 					printf("RAID target id 0x%x removed\n",
422 					    targ->tid);
423 				}
424 				break;
425 			case MPI2_EVENT_IR_CHANGE_RC_PD_CREATED:
426 			case MPI2_EVENT_IR_CHANGE_RC_HIDE:
427 				/*
428 				 * Phys Disk of a volume has been created.  Hide
429 				 * it from the OS.
430 				 */
431 				targ = mprsas_find_target_by_handle(sassc, 0,
432 				    element->PhysDiskDevHandle);
433 				if (targ == NULL)
434 					break;
435 				targ->flags |= MPR_TARGET_FLAGS_RAID_COMPONENT;
436 				mprsas_rescan_target(sc, targ);
437 				break;
438 			case MPI2_EVENT_IR_CHANGE_RC_PD_DELETED:
439 				/*
440 				 * Phys Disk of a volume has been deleted.
441 				 * Expose it to the OS.
442 				 */
443 				if (mprsas_add_device(sc,
444 				    le16toh(element->PhysDiskDevHandle), 0)) {
445 					printf("%s: failed to add device with "
446 					    "handle 0x%x\n", __func__,
447 					    le16toh(element->
448 					    PhysDiskDevHandle));
449 					mprsas_prepare_remove(sassc,
450 					    le16toh(element->
451 					    PhysDiskDevHandle));
452 				}
453 				break;
454 			}
455 		}
456 		/*
457 		 * refcount was incremented for this event in
458 		 * mprsas_evt_handler.  Decrement it here because the event has
459 		 * been processed.
460 		 */
461 		mprsas_startup_decrement(sassc);
462 		break;
463 	}
464 	case MPI2_EVENT_IR_VOLUME:
465 	{
466 		Mpi2EventDataIrVolume_t *event_data = fw_event->event_data;
467 
468 		/*
469 		 * Informational only.
470 		 */
471 		mpr_dprint(sc, MPR_EVENT, "Received IR Volume event:\n");
472 		switch (event_data->ReasonCode) {
473 		case MPI2_EVENT_IR_VOLUME_RC_SETTINGS_CHANGED:
474   			mpr_dprint(sc, MPR_EVENT, "   Volume Settings "
475   			    "changed from 0x%x to 0x%x for Volome with "
476  			    "handle 0x%x", le32toh(event_data->PreviousValue),
477  			    le32toh(event_data->NewValue),
478  			    le16toh(event_data->VolDevHandle));
479 			break;
480 		case MPI2_EVENT_IR_VOLUME_RC_STATUS_FLAGS_CHANGED:
481   			mpr_dprint(sc, MPR_EVENT, "   Volume Status "
482   			    "changed from 0x%x to 0x%x for Volome with "
483  			    "handle 0x%x", le32toh(event_data->PreviousValue),
484  			    le32toh(event_data->NewValue),
485  			    le16toh(event_data->VolDevHandle));
486 			break;
487 		case MPI2_EVENT_IR_VOLUME_RC_STATE_CHANGED:
488   			mpr_dprint(sc, MPR_EVENT, "   Volume State "
489   			    "changed from 0x%x to 0x%x for Volome with "
490  			    "handle 0x%x", le32toh(event_data->PreviousValue),
491  			    le32toh(event_data->NewValue),
492  			    le16toh(event_data->VolDevHandle));
493 				u32 state;
494 				struct mprsas_target *targ;
495 				state = le32toh(event_data->NewValue);
496 				switch (state) {
497 				case MPI2_RAID_VOL_STATE_MISSING:
498 				case MPI2_RAID_VOL_STATE_FAILED:
499 					mprsas_prepare_volume_remove(sassc,
500 					    event_data->VolDevHandle);
501 					break;
502 
503 				case MPI2_RAID_VOL_STATE_ONLINE:
504 				case MPI2_RAID_VOL_STATE_DEGRADED:
505 				case MPI2_RAID_VOL_STATE_OPTIMAL:
506 					targ =
507 					    mprsas_find_target_by_handle(sassc,
508 					    0, event_data->VolDevHandle);
509 					if (targ) {
510 						printf("%s %d: Volume handle "
511 						    "0x%x is already added \n",
512 						    __func__, __LINE__,
513 						    event_data->VolDevHandle);
514 						break;
515 					}
516 					if (mprsas_volume_add(sc,
517 					    le16toh(event_data->
518 					    VolDevHandle))) {
519 						printf("%s: failed to add RAID "
520 						    "volume with handle 0x%x\n",
521 						    __func__, le16toh(
522 						    event_data->VolDevHandle));
523 					}
524 					break;
525 				default:
526 					break;
527 				}
528 			break;
529 		default:
530 			break;
531 		}
532 		break;
533 	}
534 	case MPI2_EVENT_IR_PHYSICAL_DISK:
535 	{
536 		Mpi2EventDataIrPhysicalDisk_t *event_data =
537 		    fw_event->event_data;
538 		struct mprsas_target *targ;
539 
540 		/*
541 		 * Informational only.
542 		 */
543 		mpr_dprint(sc, MPR_EVENT, "Received IR Phys Disk event:\n");
544 		switch (event_data->ReasonCode) {
545 		case MPI2_EVENT_IR_PHYSDISK_RC_SETTINGS_CHANGED:
546   			mpr_dprint(sc, MPR_EVENT, "   Phys Disk Settings "
547   			    "changed from 0x%x to 0x%x for Phys Disk Number "
548   			    "%d and handle 0x%x at Enclosure handle 0x%x, Slot "
549  			    "%d", le32toh(event_data->PreviousValue),
550  			    le32toh(event_data->NewValue),
551 			    event_data->PhysDiskNum,
552  			    le16toh(event_data->PhysDiskDevHandle),
553  			    le16toh(event_data->EnclosureHandle),
554 			    le16toh(event_data->Slot));
555 			break;
556 		case MPI2_EVENT_IR_PHYSDISK_RC_STATUS_FLAGS_CHANGED:
557   			mpr_dprint(sc, MPR_EVENT, "   Phys Disk Status changed "
558   			    "from 0x%x to 0x%x for Phys Disk Number %d and "
559   			    "handle 0x%x at Enclosure handle 0x%x, Slot %d",
560  			    le32toh(event_data->PreviousValue),
561  			    le32toh(event_data->NewValue),
562 			    event_data->PhysDiskNum,
563  			    le16toh(event_data->PhysDiskDevHandle),
564  			    le16toh(event_data->EnclosureHandle),
565 			    le16toh(event_data->Slot));
566 			break;
567 		case MPI2_EVENT_IR_PHYSDISK_RC_STATE_CHANGED:
568   			mpr_dprint(sc, MPR_EVENT, "   Phys Disk State changed "
569   			    "from 0x%x to 0x%x for Phys Disk Number %d and "
570   			    "handle 0x%x at Enclosure handle 0x%x, Slot %d",
571  			    le32toh(event_data->PreviousValue),
572  			    le32toh(event_data->NewValue),
573 			    event_data->PhysDiskNum,
574  			    le16toh(event_data->PhysDiskDevHandle),
575  			    le16toh(event_data->EnclosureHandle),
576 			    le16toh(event_data->Slot));
577 			switch (event_data->NewValue) {
578 				case MPI2_RAID_PD_STATE_ONLINE:
579 				case MPI2_RAID_PD_STATE_DEGRADED:
580 				case MPI2_RAID_PD_STATE_REBUILDING:
581 				case MPI2_RAID_PD_STATE_OPTIMAL:
582 				case MPI2_RAID_PD_STATE_HOT_SPARE:
583 					targ = mprsas_find_target_by_handle(
584 					    sassc, 0,
585 					    event_data->PhysDiskDevHandle);
586 					if (targ) {
587 						targ->flags |=
588 						    MPR_TARGET_FLAGS_RAID_COMPONENT;
589 						printf("%s %d: Found Target "
590 						    "for handle 0x%x.\n",
591 						    __func__, __LINE__ ,
592 						    event_data->
593 						    PhysDiskDevHandle);
594 					}
595 				break;
596 				case MPI2_RAID_PD_STATE_OFFLINE:
597 				case MPI2_RAID_PD_STATE_NOT_CONFIGURED:
598 				case MPI2_RAID_PD_STATE_NOT_COMPATIBLE:
599 				default:
600 					targ = mprsas_find_target_by_handle(
601 					    sassc, 0,
602 					    event_data->PhysDiskDevHandle);
603 					if (targ) {
604 						targ->flags |=
605 					    ~MPR_TARGET_FLAGS_RAID_COMPONENT;
606 						printf("%s %d: Found Target "
607 						    "for handle 0x%x.  \n",
608 						    __func__, __LINE__ ,
609 						    event_data->
610 						    PhysDiskDevHandle);
611 					}
612 				break;
613 			}
614 		default:
615 			break;
616 		}
617 		break;
618 	}
619 	case MPI2_EVENT_IR_OPERATION_STATUS:
620 	{
621 		Mpi2EventDataIrOperationStatus_t *event_data =
622 		    fw_event->event_data;
623 
624 		/*
625 		 * Informational only.
626 		 */
627 		mpr_dprint(sc, MPR_EVENT, "Received IR Op Status event:\n");
628 		mpr_dprint(sc, MPR_EVENT, "   RAID Operation of %d is %d "
629 		    "percent complete for Volume with handle 0x%x",
630 		    event_data->RAIDOperation, event_data->PercentComplete,
631 		    le16toh(event_data->VolDevHandle));
632 		break;
633 	}
634 	case MPI2_EVENT_TEMP_THRESHOLD:
635 	{
636 		pMpi2EventDataTemperature_t	temp_event;
637 
638 		temp_event = (pMpi2EventDataTemperature_t)fw_event->event_data;
639 
640 		/*
641 		 * The Temp Sensor Count must be greater than the event's Sensor
642 		 * Num to be valid.  If valid, print the temp thresholds that
643 		 * have been exceeded.
644 		 */
645 		if (sc->iounit_pg8.NumSensors > temp_event->SensorNum) {
646 			mpr_dprint(sc, MPR_FAULT, "Temperature Threshold flags "
647 			    "%s %s %s %s exceeded for Sensor: %d !!!\n",
648 			    ((temp_event->Status & 0x01) == 1) ? "0 " : " ",
649 			    ((temp_event->Status & 0x02) == 2) ? "1 " : " ",
650 			    ((temp_event->Status & 0x04) == 4) ? "2 " : " ",
651 			    ((temp_event->Status & 0x08) == 8) ? "3 " : " ",
652 			    temp_event->SensorNum);
653 			mpr_dprint(sc, MPR_FAULT, "Current Temp in Celsius: "
654 			    "%d\n", temp_event->CurrentTemperature);
655 		}
656 		break;
657 	}
658 	case MPI2_EVENT_ACTIVE_CABLE_EXCEPTION:
659 	{
660 		pMpi26EventDataActiveCableExcept_t	ace_event_data;
661 		ace_event_data =
662 		    (pMpi26EventDataActiveCableExcept_t)fw_event->event_data;
663 
664 		switch(ace_event_data->ReasonCode) {
665 		case MPI26_EVENT_ACTIVE_CABLE_INSUFFICIENT_POWER:
666 		{
667 			mpr_printf(sc, "Currently a cable with "
668 			    "ReceptacleID %d cannot be powered and device "
669 			    "connected to this active cable will not be seen. "
670 			    "This active cable requires %d mW of power.\n",
671 			    ace_event_data->ReceptacleID,
672 			    ace_event_data->ActiveCablePowerRequirement);
673 			break;
674 		}
675 		case MPI26_EVENT_ACTIVE_CABLE_DEGRADED:
676 		{
677 			mpr_printf(sc, "Currently a cable with "
678 			    "ReceptacleID %d is not running at optimal speed "
679 			    "(12 Gb/s rate)\n", ace_event_data->ReceptacleID);
680 			break;
681 		}
682 		default:
683 			break;
684 		}
685 		break;
686 	}
687 	case MPI2_EVENT_PCIE_DEVICE_STATUS_CHANGE:
688 	{
689 		pMpi26EventDataPCIeDeviceStatusChange_t	pcie_status_event_data;
690 		pcie_status_event_data =
691 		   (pMpi26EventDataPCIeDeviceStatusChange_t)fw_event->event_data;
692 
693 		switch (pcie_status_event_data->ReasonCode) {
694 		case MPI26_EVENT_PCIDEV_STAT_RC_PCIE_HOT_RESET_FAILED:
695 		{
696 			mpr_printf(sc, "PCIe Host Reset failed on DevHandle "
697 			    "0x%x\n", pcie_status_event_data->DevHandle);
698 			break;
699 		}
700 		default:
701 			break;
702 		}
703 		break;
704 	}
705 	case MPI2_EVENT_SAS_DEVICE_DISCOVERY_ERROR:
706 	{
707 		pMpi25EventDataSasDeviceDiscoveryError_t discovery_error_data;
708 		uint64_t sas_address;
709 
710 		discovery_error_data =
711 		    (pMpi25EventDataSasDeviceDiscoveryError_t)
712 		    fw_event->event_data;
713 
714 		sas_address = discovery_error_data->SASAddress.High;
715 		sas_address = (sas_address << 32) |
716 		    discovery_error_data->SASAddress.Low;
717 
718 		switch(discovery_error_data->ReasonCode) {
719 		case MPI25_EVENT_SAS_DISC_ERR_SMP_FAILED:
720 		{
721 			mpr_printf(sc, "SMP command failed during discovery "
722 			    "for expander with SAS Address %jx and "
723 			    "handle 0x%x.\n", sas_address,
724 			    discovery_error_data->DevHandle);
725 			break;
726 		}
727 		case MPI25_EVENT_SAS_DISC_ERR_SMP_TIMEOUT:
728 		{
729 			mpr_printf(sc, "SMP command timed out during "
730 			    "discovery for expander with SAS Address %jx and "
731 			    "handle 0x%x.\n", sas_address,
732 			    discovery_error_data->DevHandle);
733 			break;
734 		}
735 		default:
736 			break;
737 		}
738 		break;
739 	}
740 	case MPI2_EVENT_PCIE_TOPOLOGY_CHANGE_LIST:
741 	{
742 		MPI26_EVENT_DATA_PCIE_TOPOLOGY_CHANGE_LIST *data;
743 		MPI26_EVENT_PCIE_TOPO_PORT_ENTRY *port_entry;
744 		uint8_t i, link_rate;
745 		uint16_t handle;
746 
747 		data = (MPI26_EVENT_DATA_PCIE_TOPOLOGY_CHANGE_LIST *)
748 		    fw_event->event_data;
749 
750 		mpr_mapping_pcie_topology_change_event(sc,
751 		    fw_event->event_data);
752 
753 		for (i = 0; i < data->NumEntries; i++) {
754 			port_entry = &data->PortEntry[i];
755 			handle = le16toh(port_entry->AttachedDevHandle);
756 			link_rate = port_entry->CurrentPortInfo &
757 			    MPI26_EVENT_PCIE_TOPO_PI_RATE_MASK;
758 			switch (port_entry->PortStatus) {
759 			case MPI26_EVENT_PCIE_TOPO_PS_DEV_ADDED:
760 				if (link_rate <
761 				    MPI26_EVENT_PCIE_TOPO_PI_RATE_2_5) {
762 					mpr_dprint(sc, MPR_ERROR, "%s: Cannot "
763 					    "add PCIe device with handle 0x%x "
764 					    "with unknown link rate.\n",
765 					    __func__, handle);
766 					break;
767 				}
768 				if (mprsas_add_pcie_device(sc, handle,
769 				    link_rate)) {
770 					mpr_dprint(sc, MPR_ERROR, "%s: failed "
771 					    "to add PCIe device with handle "
772 					    "0x%x\n", __func__, handle);
773 					mprsas_prepare_remove(sassc, handle);
774 				}
775 				break;
776 			case MPI26_EVENT_PCIE_TOPO_PS_NOT_RESPONDING:
777 				mprsas_prepare_remove(sassc, handle);
778 				break;
779 			case MPI26_EVENT_PCIE_TOPO_PS_PORT_CHANGED:
780 			case MPI26_EVENT_PCIE_TOPO_PS_NO_CHANGE:
781 			case MPI26_EVENT_PCIE_TOPO_PS_DELAY_NOT_RESPONDING:
782 			default:
783 				break;
784 			}
785 		}
786 		/*
787 		 * refcount was incremented for this event in
788 		 * mprsas_evt_handler.  Decrement it here because the event has
789 		 * been processed.
790 		 */
791 		mprsas_startup_decrement(sassc);
792 		break;
793 	}
794 	case MPI2_EVENT_SAS_DEVICE_STATUS_CHANGE:
795 	case MPI2_EVENT_SAS_BROADCAST_PRIMITIVE:
796 	default:
797 		mpr_dprint(sc, MPR_TRACE,"Unhandled event 0x%0X\n",
798 		    fw_event->event);
799 		break;
800 
801 	}
802 	mpr_dprint(sc, MPR_EVENT, "(%d)->(%s) Event Free: [%x]\n", event_count,
803 	    __func__, fw_event->event);
804 	mprsas_fw_event_free(sc, fw_event);
805 }
806 
807 void
808 mprsas_firmware_event_work(void *arg, int pending)
809 {
810 	struct mpr_fw_event_work *fw_event;
811 	struct mpr_softc *sc;
812 
813 	sc = (struct mpr_softc *)arg;
814 	mpr_lock(sc);
815 	while ((fw_event = TAILQ_FIRST(&sc->sassc->ev_queue)) != NULL) {
816 		TAILQ_REMOVE(&sc->sassc->ev_queue, fw_event, ev_link);
817 		mprsas_fw_work(sc, fw_event);
818 	}
819 	mpr_unlock(sc);
820 }
821 
822 static int
823 mprsas_add_device(struct mpr_softc *sc, u16 handle, u8 linkrate)
824 {
825 	char devstring[80];
826 	struct mprsas_softc *sassc;
827 	struct mprsas_target *targ;
828 	Mpi2ConfigReply_t mpi_reply;
829 	Mpi2SasDevicePage0_t config_page;
830 	uint64_t sas_address, parent_sas_address = 0;
831 	u32 device_info, parent_devinfo = 0;
832 	unsigned int id;
833 	int ret = 1, error = 0, i;
834 	struct mprsas_lun *lun;
835 	u8 is_SATA_SSD = 0;
836 	struct mpr_command *cm;
837 
838 	sassc = sc->sassc;
839 	mprsas_startup_increment(sassc);
840 	if (mpr_config_get_sas_device_pg0(sc, &mpi_reply, &config_page,
841 	    MPI2_SAS_DEVICE_PGAD_FORM_HANDLE, handle) != 0) {
842 		mpr_dprint(sc, MPR_INFO|MPR_MAPPING|MPR_FAULT,
843 		    "Error reading SAS device %#x page0, iocstatus= 0x%x\n",
844 		    handle, mpi_reply.IOCStatus);
845 		error = ENXIO;
846 		goto out;
847 	}
848 
849 	device_info = le32toh(config_page.DeviceInfo);
850 
851 	if (((device_info & MPI2_SAS_DEVICE_INFO_SMP_TARGET) == 0)
852 	    && (le16toh(config_page.ParentDevHandle) != 0)) {
853 		Mpi2ConfigReply_t tmp_mpi_reply;
854 		Mpi2SasDevicePage0_t parent_config_page;
855 
856 		if (mpr_config_get_sas_device_pg0(sc, &tmp_mpi_reply,
857 		    &parent_config_page, MPI2_SAS_DEVICE_PGAD_FORM_HANDLE,
858 		    le16toh(config_page.ParentDevHandle)) != 0) {
859 			mpr_dprint(sc, MPR_MAPPING|MPR_FAULT,
860 			    "Error reading parent SAS device %#x page0, "
861 			    "iocstatus= 0x%x\n",
862 			    le16toh(config_page.ParentDevHandle),
863 			    tmp_mpi_reply.IOCStatus);
864 		} else {
865 			parent_sas_address = parent_config_page.SASAddress.High;
866 			parent_sas_address = (parent_sas_address << 32) |
867 			    parent_config_page.SASAddress.Low;
868 			parent_devinfo = le32toh(parent_config_page.DeviceInfo);
869 		}
870 	}
871 	/* TODO Check proper endianness */
872 	sas_address = config_page.SASAddress.High;
873 	sas_address = (sas_address << 32) | config_page.SASAddress.Low;
874 	mpr_dprint(sc, MPR_MAPPING, "Handle 0x%04x SAS Address from SAS device "
875 	    "page0 = %jx\n", handle, sas_address);
876 
877 	/*
878 	 * Always get SATA Identify information because this is used to
879 	 * determine if Start/Stop Unit should be sent to the drive when the
880 	 * system is shutdown.
881 	 */
882 	if (device_info & MPI2_SAS_DEVICE_INFO_SATA_DEVICE) {
883 		ret = mprsas_get_sas_address_for_sata_disk(sc, &sas_address,
884 		    handle, device_info, &is_SATA_SSD);
885 		if (ret) {
886 			mpr_dprint(sc, MPR_MAPPING|MPR_ERROR,
887 			    "%s: failed to get disk type (SSD or HDD) for SATA "
888 			    "device with handle 0x%04x\n",
889 			    __func__, handle);
890 		} else {
891 			mpr_dprint(sc, MPR_MAPPING, "Handle 0x%04x SAS Address "
892 			    "from SATA device = %jx\n", handle, sas_address);
893 		}
894 	}
895 
896 	/*
897 	 * use_phynum:
898 	 *  1 - use the PhyNum field as a fallback to the mapping logic
899 	 *  0 - never use the PhyNum field
900 	 * -1 - only use the PhyNum field
901 	 *
902 	 * Note that using the Phy number to map a device can cause device adds
903 	 * to fail if multiple enclosures/expanders are in the topology. For
904 	 * example, if two devices are in the same slot number in two different
905 	 * enclosures within the topology, only one of those devices will be
906 	 * added. PhyNum mapping should not be used if multiple enclosures are
907 	 * in the topology.
908 	 */
909 	id = MPR_MAP_BAD_ID;
910 	if (sc->use_phynum != -1)
911 		id = mpr_mapping_get_tid(sc, sas_address, handle);
912 	if (id == MPR_MAP_BAD_ID) {
913 		if ((sc->use_phynum == 0) ||
914 		    ((id = config_page.PhyNum) > sassc->maxtargets)) {
915 			mpr_dprint(sc, MPR_INFO, "failure at %s:%d/%s()! "
916 			    "Could not get ID for device with handle 0x%04x\n",
917 			    __FILE__, __LINE__, __func__, handle);
918 			error = ENXIO;
919 			goto out;
920 		}
921 	}
922 	mpr_dprint(sc, MPR_MAPPING, "%s: Target ID for added device is %d.\n",
923 	    __func__, id);
924 
925 	/*
926 	 * Only do the ID check and reuse check if the target is not from a
927 	 * RAID Component. For Physical Disks of a Volume, the ID will be reused
928 	 * when a volume is deleted because the mapping entry for the PD will
929 	 * still be in the mapping table. The ID check should not be done here
930 	 * either since this PD is already being used.
931 	 */
932 	targ = &sassc->targets[id];
933 	if (!(targ->flags & MPR_TARGET_FLAGS_RAID_COMPONENT)) {
934 		if (mprsas_check_id(sassc, id) != 0) {
935 			mpr_dprint(sc, MPR_MAPPING|MPR_INFO,
936 			    "Excluding target id %d\n", id);
937 			error = ENXIO;
938 			goto out;
939 		}
940 
941 		if (targ->handle != 0x0) {
942 			mpr_dprint(sc, MPR_MAPPING, "Attempting to reuse "
943 			    "target id %d handle 0x%04x\n", id, targ->handle);
944 			error = ENXIO;
945 			goto out;
946 		}
947 	}
948 
949 	targ->devinfo = device_info;
950 	targ->devname = le32toh(config_page.DeviceName.High);
951 	targ->devname = (targ->devname << 32) |
952 	    le32toh(config_page.DeviceName.Low);
953 	targ->encl_handle = le16toh(config_page.EnclosureHandle);
954 	targ->encl_slot = le16toh(config_page.Slot);
955 	targ->encl_level = config_page.EnclosureLevel;
956 	targ->connector_name[0] = config_page.ConnectorName[0];
957 	targ->connector_name[1] = config_page.ConnectorName[1];
958 	targ->connector_name[2] = config_page.ConnectorName[2];
959 	targ->connector_name[3] = config_page.ConnectorName[3];
960 	targ->handle = handle;
961 	targ->parent_handle = le16toh(config_page.ParentDevHandle);
962 	targ->sasaddr = mpr_to_u64(&config_page.SASAddress);
963 	targ->parent_sasaddr = le64toh(parent_sas_address);
964 	targ->parent_devinfo = parent_devinfo;
965 	targ->tid = id;
966 	targ->linkrate = (linkrate>>4);
967 	targ->flags = 0;
968 	if (is_SATA_SSD) {
969 		targ->flags = MPR_TARGET_IS_SATA_SSD;
970 	}
971 	if ((le16toh(config_page.Flags) &
972 	    MPI25_SAS_DEVICE0_FLAGS_ENABLED_FAST_PATH) &&
973 	    (le16toh(config_page.Flags) &
974 	    MPI25_SAS_DEVICE0_FLAGS_FAST_PATH_CAPABLE)) {
975 		targ->scsi_req_desc_type =
976 		    MPI25_REQ_DESCRIPT_FLAGS_FAST_PATH_SCSI_IO;
977 	}
978 	if (le16toh(config_page.Flags) &
979 	    MPI2_SAS_DEVICE0_FLAGS_ENCL_LEVEL_VALID) {
980 		targ->encl_level_valid = TRUE;
981 	}
982 	TAILQ_INIT(&targ->commands);
983 	TAILQ_INIT(&targ->timedout_commands);
984 	while (!SLIST_EMPTY(&targ->luns)) {
985 		lun = SLIST_FIRST(&targ->luns);
986 		SLIST_REMOVE_HEAD(&targ->luns, lun_link);
987 		free(lun, M_MPR);
988 	}
989 	SLIST_INIT(&targ->luns);
990 
991 	mpr_describe_devinfo(targ->devinfo, devstring, 80);
992 	mpr_dprint(sc, (MPR_INFO|MPR_MAPPING), "Found device <%s> <%s> "
993 	    "handle<0x%04x> enclosureHandle<0x%04x> slot %d\n", devstring,
994 	    mpr_describe_table(mpr_linkrate_names, targ->linkrate),
995 	    targ->handle, targ->encl_handle, targ->encl_slot);
996 	if (targ->encl_level_valid) {
997 		mpr_dprint(sc, (MPR_INFO|MPR_MAPPING), "At enclosure level %d "
998 		    "and connector name (%4s)\n", targ->encl_level,
999 		    targ->connector_name);
1000 	}
1001 	mprsas_rescan_target(sc, targ);
1002 	mpr_dprint(sc, MPR_MAPPING, "Target id 0x%x added\n", targ->tid);
1003 
1004 	/*
1005 	 * Check all commands to see if the SATA_ID_TIMEOUT flag has been set.
1006 	 * If so, send a Target Reset TM to the target that was just created.
1007 	 * An Abort Task TM should be used instead of a Target Reset, but that
1008 	 * would be much more difficult because targets have not been fully
1009 	 * discovered yet, and LUN's haven't been setup.  So, just reset the
1010 	 * target instead of the LUN.
1011 	 */
1012 	for (i = 1; i < sc->num_reqs; i++) {
1013 		cm = &sc->commands[i];
1014 		if (cm->cm_flags & MPR_CM_FLAGS_SATA_ID_TIMEOUT) {
1015 			targ->timeouts++;
1016 			cm->cm_flags |= MPR_CM_FLAGS_TIMEDOUT;
1017 
1018 			if ((targ->tm = mprsas_alloc_tm(sc)) != NULL) {
1019 				mpr_dprint(sc, MPR_INFO, "%s: sending Target "
1020 				    "Reset for stuck SATA identify command "
1021 				    "(cm = %p)\n", __func__, cm);
1022 				targ->tm->cm_targ = targ;
1023 				mprsas_send_reset(sc, targ->tm,
1024 				    MPI2_SCSITASKMGMT_TASKTYPE_TARGET_RESET);
1025 			} else {
1026 				mpr_dprint(sc, MPR_ERROR, "Failed to allocate "
1027 				    "tm for Target Reset after SATA ID command "
1028 				    "timed out (cm %p)\n", cm);
1029 			}
1030 			/*
1031 			 * No need to check for more since the target is
1032 			 * already being reset.
1033 			 */
1034 			break;
1035 		}
1036 	}
1037 out:
1038 	/*
1039 	 * Free the commands that may not have been freed from the SATA ID call
1040 	 */
1041 	for (i = 1; i < sc->num_reqs; i++) {
1042 		cm = &sc->commands[i];
1043 		if (cm->cm_flags & MPR_CM_FLAGS_SATA_ID_TIMEOUT) {
1044 			free(cm->cm_data, M_MPR);
1045 			mpr_free_command(sc, cm);
1046 		}
1047 	}
1048 	mprsas_startup_decrement(sassc);
1049 	return (error);
1050 }
1051 
1052 int
1053 mprsas_get_sas_address_for_sata_disk(struct mpr_softc *sc,
1054     u64 *sas_address, u16 handle, u32 device_info, u8 *is_SATA_SSD)
1055 {
1056 	Mpi2SataPassthroughReply_t mpi_reply;
1057 	int i, rc, try_count;
1058 	u32 *bufferptr;
1059 	union _sata_sas_address hash_address;
1060 	struct _ata_identify_device_data ata_identify;
1061 	u8 buffer[MPT2SAS_MN_LEN + MPT2SAS_SN_LEN];
1062 	u32 ioc_status;
1063 	u8 sas_status;
1064 
1065 	memset(&ata_identify, 0, sizeof(ata_identify));
1066 	memset(&mpi_reply, 0, sizeof(mpi_reply));
1067 	try_count = 0;
1068 	do {
1069 		rc = mprsas_get_sata_identify(sc, handle, &mpi_reply,
1070 		    (char *)&ata_identify, sizeof(ata_identify), device_info);
1071 		try_count++;
1072 		ioc_status = le16toh(mpi_reply.IOCStatus)
1073 		    & MPI2_IOCSTATUS_MASK;
1074 		sas_status = mpi_reply.SASStatus;
1075 		switch (ioc_status) {
1076 		case MPI2_IOCSTATUS_SUCCESS:
1077 			break;
1078 		case MPI2_IOCSTATUS_SCSI_PROTOCOL_ERROR:
1079 			/* No sense sleeping.  this error won't get better */
1080 			break;
1081 		default:
1082 			if (sc->spinup_wait_time > 0) {
1083 				mpr_dprint(sc, MPR_INFO, "Sleeping %d seconds "
1084 				    "after SATA ID error to wait for spinup\n",
1085 				    sc->spinup_wait_time);
1086 				msleep(&sc->msleep_fake_chan, &sc->mpr_mtx, 0,
1087 				    "mprid", sc->spinup_wait_time * hz);
1088 			}
1089 		}
1090 	} while (((rc && (rc != EWOULDBLOCK)) ||
1091 	    (ioc_status && (ioc_status != MPI2_IOCSTATUS_SCSI_PROTOCOL_ERROR))
1092 	    || sas_status) && (try_count < 5));
1093 
1094 	if (rc == 0 && !ioc_status && !sas_status) {
1095 		mpr_dprint(sc, MPR_MAPPING, "%s: got SATA identify "
1096 		    "successfully for handle = 0x%x with try_count = %d\n",
1097 		    __func__, handle, try_count);
1098 	} else {
1099 		mpr_dprint(sc, MPR_MAPPING, "%s: handle = 0x%x failed\n",
1100 		    __func__, handle);
1101 		return -1;
1102 	}
1103 	/* Copy & byteswap the 40 byte model number to a buffer */
1104 	for (i = 0; i < MPT2SAS_MN_LEN; i += 2) {
1105 		buffer[i] = ((u8 *)ata_identify.model_number)[i + 1];
1106 		buffer[i + 1] = ((u8 *)ata_identify.model_number)[i];
1107 	}
1108 	/* Copy & byteswap the 20 byte serial number to a buffer */
1109 	for (i = 0; i < MPT2SAS_SN_LEN; i += 2) {
1110 		buffer[MPT2SAS_MN_LEN + i] =
1111 		    ((u8 *)ata_identify.serial_number)[i + 1];
1112 		buffer[MPT2SAS_MN_LEN + i + 1] =
1113 		    ((u8 *)ata_identify.serial_number)[i];
1114 	}
1115 	bufferptr = (u32 *)buffer;
1116 	/* There are 60 bytes to hash down to 8. 60 isn't divisible by 8,
1117 	 * so loop through the first 56 bytes (7*8),
1118 	 * and then add in the last dword.
1119 	 */
1120 	hash_address.word.low  = 0;
1121 	hash_address.word.high = 0;
1122 	for (i = 0; (i < ((MPT2SAS_MN_LEN+MPT2SAS_SN_LEN)/8)); i++) {
1123 		hash_address.word.low += *bufferptr;
1124 		bufferptr++;
1125 		hash_address.word.high += *bufferptr;
1126 		bufferptr++;
1127 	}
1128 	/* Add the last dword */
1129 	hash_address.word.low += *bufferptr;
1130 	/* Make sure the hash doesn't start with 5, because it could clash
1131 	 * with a SAS address. Change 5 to a D.
1132 	 */
1133 	if ((hash_address.word.high & 0x000000F0) == (0x00000050))
1134 		hash_address.word.high |= 0x00000080;
1135 	*sas_address = (u64)hash_address.wwid[0] << 56 |
1136 	    (u64)hash_address.wwid[1] << 48 | (u64)hash_address.wwid[2] << 40 |
1137 	    (u64)hash_address.wwid[3] << 32 | (u64)hash_address.wwid[4] << 24 |
1138 	    (u64)hash_address.wwid[5] << 16 | (u64)hash_address.wwid[6] <<  8 |
1139 	    (u64)hash_address.wwid[7];
1140 	if (ata_identify.rotational_speed == 1) {
1141 		*is_SATA_SSD = 1;
1142 	}
1143 
1144 	return 0;
1145 }
1146 
1147 static int
1148 mprsas_get_sata_identify(struct mpr_softc *sc, u16 handle,
1149     Mpi2SataPassthroughReply_t *mpi_reply, char *id_buffer, int sz, u32 devinfo)
1150 {
1151 	Mpi2SataPassthroughRequest_t *mpi_request;
1152 	Mpi2SataPassthroughReply_t *reply;
1153 	struct mpr_command *cm;
1154 	char *buffer;
1155 	int error = 0;
1156 
1157 	buffer = malloc( sz, M_MPR, M_NOWAIT | M_ZERO);
1158 	if (!buffer)
1159 		return ENOMEM;
1160 
1161 	if ((cm = mpr_alloc_command(sc)) == NULL) {
1162 		free(buffer, M_MPR);
1163 		return (EBUSY);
1164 	}
1165 	mpi_request = (MPI2_SATA_PASSTHROUGH_REQUEST *)cm->cm_req;
1166 	bzero(mpi_request,sizeof(MPI2_SATA_PASSTHROUGH_REQUEST));
1167 	mpi_request->Function = MPI2_FUNCTION_SATA_PASSTHROUGH;
1168 	mpi_request->VF_ID = 0;
1169 	mpi_request->DevHandle = htole16(handle);
1170 	mpi_request->PassthroughFlags = (MPI2_SATA_PT_REQ_PT_FLAGS_PIO |
1171 	    MPI2_SATA_PT_REQ_PT_FLAGS_READ);
1172 	mpi_request->DataLength = htole32(sz);
1173 	mpi_request->CommandFIS[0] = 0x27;
1174 	mpi_request->CommandFIS[1] = 0x80;
1175 	mpi_request->CommandFIS[2] =  (devinfo &
1176 	    MPI2_SAS_DEVICE_INFO_ATAPI_DEVICE) ? 0xA1 : 0xEC;
1177 	cm->cm_sge = &mpi_request->SGL;
1178 	cm->cm_sglsize = sizeof(MPI2_SGE_IO_UNION);
1179 	cm->cm_flags = MPR_CM_FLAGS_DATAIN;
1180 	cm->cm_desc.Default.RequestFlags = MPI2_REQ_DESCRIPT_FLAGS_DEFAULT_TYPE;
1181 	cm->cm_data = buffer;
1182 	cm->cm_length = htole32(sz);
1183 
1184 	/*
1185 	 * Use a custom handler to avoid reinit'ing the controller on timeout.
1186 	 * This fixes a problem where the FW does not send a reply sometimes
1187 	 * when a bad disk is in the topology. So, this is used to timeout the
1188 	 * command so that processing can continue normally.
1189 	 */
1190 	cm->cm_timeout_handler = mprsas_ata_id_timeout;
1191 
1192 	error = mpr_wait_command(sc, &cm, MPR_ATA_ID_TIMEOUT, CAN_SLEEP);
1193 
1194 	/* mprsas_ata_id_timeout does not reset controller */
1195 	KASSERT(cm != NULL, ("%s: surprise command freed", __func__));
1196 
1197 	reply = (Mpi2SataPassthroughReply_t *)cm->cm_reply;
1198 	if (error || (reply == NULL)) {
1199 		/* FIXME */
1200 		/*
1201 		 * If the request returns an error then we need to do a diag
1202 		 * reset
1203 		 */
1204 		mpr_dprint(sc, MPR_INFO|MPR_FAULT|MPR_MAPPING,
1205 		    "Request for SATA PASSTHROUGH page completed with error %d\n",
1206 		    error);
1207 		error = ENXIO;
1208 		goto out;
1209 	}
1210 	bcopy(buffer, id_buffer, sz);
1211 	bcopy(reply, mpi_reply, sizeof(Mpi2SataPassthroughReply_t));
1212 	if ((le16toh(reply->IOCStatus) & MPI2_IOCSTATUS_MASK) !=
1213 	    MPI2_IOCSTATUS_SUCCESS) {
1214 		mpr_dprint(sc, MPR_INFO|MPR_MAPPING|MPR_FAULT,
1215 		    "Error reading device %#x SATA PASSTHRU; iocstatus= 0x%x\n",
1216 		    handle, reply->IOCStatus);
1217 		error = ENXIO;
1218 		goto out;
1219 	}
1220 out:
1221 	/*
1222 	 * If the SATA_ID_TIMEOUT flag has been set for this command, don't free
1223 	 * it.  The command and buffer will be freed after sending an Abort
1224 	 * Task TM.
1225 	 */
1226 	if ((cm->cm_flags & MPR_CM_FLAGS_SATA_ID_TIMEOUT) == 0) {
1227 		mpr_free_command(sc, cm);
1228 		free(buffer, M_MPR);
1229 	}
1230 	return (error);
1231 }
1232 
1233 static void
1234 mprsas_ata_id_timeout(struct mpr_softc *sc, struct mpr_command *cm)
1235 {
1236 
1237 	mpr_dprint(sc, MPR_INFO, "%s ATA ID command timeout cm %p sc %p\n",
1238 	    __func__, cm, sc);
1239 
1240 	/*
1241 	 * The Abort Task cannot be sent from here because the driver has not
1242 	 * completed setting up targets.  Instead, the command is flagged so
1243 	 * that special handling will be used to send the abort. Now that
1244 	 * this command has timed out, it's no longer in the queue.
1245 	 */
1246 	cm->cm_flags |= MPR_CM_FLAGS_SATA_ID_TIMEOUT;
1247 	cm->cm_state = MPR_CM_STATE_BUSY;
1248 }
1249 
1250 static int
1251 mprsas_add_pcie_device(struct mpr_softc *sc, u16 handle, u8 linkrate)
1252 {
1253 	char devstring[80];
1254 	struct mprsas_softc *sassc;
1255 	struct mprsas_target *targ;
1256 	Mpi2ConfigReply_t mpi_reply;
1257 	Mpi26PCIeDevicePage0_t config_page;
1258 	Mpi26PCIeDevicePage2_t config_page2;
1259 	uint64_t pcie_wwid, parent_wwid = 0;
1260 	u32 device_info, parent_devinfo = 0;
1261 	unsigned int id;
1262 	int error = 0;
1263 	struct mprsas_lun *lun;
1264 
1265 	sassc = sc->sassc;
1266 	mprsas_startup_increment(sassc);
1267 	if ((mpr_config_get_pcie_device_pg0(sc, &mpi_reply, &config_page,
1268 	     MPI26_PCIE_DEVICE_PGAD_FORM_HANDLE, handle))) {
1269 		printf("%s: error reading PCIe device page0\n", __func__);
1270 		error = ENXIO;
1271 		goto out;
1272 	}
1273 
1274 	device_info = le32toh(config_page.DeviceInfo);
1275 
1276 	if (((device_info & MPI26_PCIE_DEVINFO_PCI_SWITCH) == 0)
1277 	    && (le16toh(config_page.ParentDevHandle) != 0)) {
1278 		Mpi2ConfigReply_t tmp_mpi_reply;
1279 		Mpi26PCIeDevicePage0_t parent_config_page;
1280 
1281 		if ((mpr_config_get_pcie_device_pg0(sc, &tmp_mpi_reply,
1282 		     &parent_config_page, MPI26_PCIE_DEVICE_PGAD_FORM_HANDLE,
1283 		     le16toh(config_page.ParentDevHandle)))) {
1284 			printf("%s: error reading PCIe device %#x page0\n",
1285 			    __func__, le16toh(config_page.ParentDevHandle));
1286 		} else {
1287 			parent_wwid = parent_config_page.WWID.High;
1288 			parent_wwid = (parent_wwid << 32) |
1289 			    parent_config_page.WWID.Low;
1290 			parent_devinfo = le32toh(parent_config_page.DeviceInfo);
1291 		}
1292 	}
1293 	/* TODO Check proper endianness */
1294 	pcie_wwid = config_page.WWID.High;
1295 	pcie_wwid = (pcie_wwid << 32) | config_page.WWID.Low;
1296 	mpr_dprint(sc, MPR_INFO, "PCIe WWID from PCIe device page0 = %jx\n",
1297 	    pcie_wwid);
1298 
1299 	if ((mpr_config_get_pcie_device_pg2(sc, &mpi_reply, &config_page2,
1300 	     MPI26_PCIE_DEVICE_PGAD_FORM_HANDLE, handle))) {
1301 		printf("%s: error reading PCIe device page2\n", __func__);
1302 		error = ENXIO;
1303 		goto out;
1304 	}
1305 
1306 	id = mpr_mapping_get_tid(sc, pcie_wwid, handle);
1307 	if (id == MPR_MAP_BAD_ID) {
1308 		mpr_dprint(sc, MPR_ERROR | MPR_INFO, "failure at %s:%d/%s()! "
1309 		    "Could not get ID for device with handle 0x%04x\n",
1310 		    __FILE__, __LINE__, __func__, handle);
1311 		error = ENXIO;
1312 		goto out;
1313 	}
1314 	mpr_dprint(sc, MPR_MAPPING, "%s: Target ID for added device is %d.\n",
1315 	    __func__, id);
1316 
1317 	if (mprsas_check_id(sassc, id) != 0) {
1318 		mpr_dprint(sc, MPR_MAPPING|MPR_INFO,
1319 		    "Excluding target id %d\n", id);
1320 		error = ENXIO;
1321 		goto out;
1322 	}
1323 
1324 	mpr_dprint(sc, MPR_MAPPING, "WWID from PCIe device page0 = %jx\n",
1325 	    pcie_wwid);
1326 	targ = &sassc->targets[id];
1327 	targ->devinfo = device_info;
1328 	targ->encl_handle = le16toh(config_page.EnclosureHandle);
1329 	targ->encl_slot = le16toh(config_page.Slot);
1330 	targ->encl_level = config_page.EnclosureLevel;
1331 	targ->connector_name[0] = ((char *)&config_page.ConnectorName)[0];
1332 	targ->connector_name[1] = ((char *)&config_page.ConnectorName)[1];
1333 	targ->connector_name[2] = ((char *)&config_page.ConnectorName)[2];
1334 	targ->connector_name[3] = ((char *)&config_page.ConnectorName)[3];
1335 	targ->is_nvme = device_info & MPI26_PCIE_DEVINFO_NVME;
1336 	targ->MDTS = config_page2.MaximumDataTransferSize;
1337 	if (targ->is_nvme)
1338 		targ->controller_reset_timeout = config_page2.ControllerResetTO;
1339 	/*
1340 	 * Assume always TRUE for encl_level_valid because there is no valid
1341 	 * flag for PCIe.
1342 	 */
1343 	targ->encl_level_valid = TRUE;
1344 	targ->handle = handle;
1345 	targ->parent_handle = le16toh(config_page.ParentDevHandle);
1346 	targ->sasaddr = mpr_to_u64(&config_page.WWID);
1347 	targ->parent_sasaddr = le64toh(parent_wwid);
1348 	targ->parent_devinfo = parent_devinfo;
1349 	targ->tid = id;
1350 	targ->linkrate = linkrate;
1351 	targ->flags = 0;
1352 	if ((le16toh(config_page.Flags) &
1353 	    MPI26_PCIEDEV0_FLAGS_ENABLED_FAST_PATH) &&
1354 	    (le16toh(config_page.Flags) &
1355 	    MPI26_PCIEDEV0_FLAGS_FAST_PATH_CAPABLE)) {
1356 		targ->scsi_req_desc_type =
1357 		    MPI25_REQ_DESCRIPT_FLAGS_FAST_PATH_SCSI_IO;
1358 	}
1359 	TAILQ_INIT(&targ->commands);
1360 	TAILQ_INIT(&targ->timedout_commands);
1361 	while (!SLIST_EMPTY(&targ->luns)) {
1362 		lun = SLIST_FIRST(&targ->luns);
1363 		SLIST_REMOVE_HEAD(&targ->luns, lun_link);
1364 		free(lun, M_MPR);
1365 	}
1366 	SLIST_INIT(&targ->luns);
1367 
1368 	mpr_describe_devinfo(targ->devinfo, devstring, 80);
1369 	mpr_dprint(sc, (MPR_INFO|MPR_MAPPING), "Found PCIe device <%s> <%s> "
1370 	    "handle<0x%04x> enclosureHandle<0x%04x> slot %d\n", devstring,
1371 	    mpr_describe_table(mpr_pcie_linkrate_names, targ->linkrate),
1372 	    targ->handle, targ->encl_handle, targ->encl_slot);
1373 	if (targ->encl_level_valid) {
1374 		mpr_dprint(sc, (MPR_INFO|MPR_MAPPING), "At enclosure level %d "
1375 		    "and connector name (%4s)\n", targ->encl_level,
1376 		    targ->connector_name);
1377 	}
1378 	mprsas_rescan_target(sc, targ);
1379 	mpr_dprint(sc, MPR_MAPPING, "Target id 0x%x added\n", targ->tid);
1380 
1381 out:
1382 	mprsas_startup_decrement(sassc);
1383 	return (error);
1384 }
1385 
1386 static int
1387 mprsas_volume_add(struct mpr_softc *sc, u16 handle)
1388 {
1389 	struct mprsas_softc *sassc;
1390 	struct mprsas_target *targ;
1391 	u64 wwid;
1392 	unsigned int id;
1393 	int error = 0;
1394 	struct mprsas_lun *lun;
1395 
1396 	sassc = sc->sassc;
1397 	mprsas_startup_increment(sassc);
1398 	/* wwid is endian safe */
1399 	mpr_config_get_volume_wwid(sc, handle, &wwid);
1400 	if (!wwid) {
1401 		printf("%s: invalid WWID; cannot add volume to mapping table\n",
1402 		    __func__);
1403 		error = ENXIO;
1404 		goto out;
1405 	}
1406 
1407 	id = mpr_mapping_get_raid_tid(sc, wwid, handle);
1408 	if (id == MPR_MAP_BAD_ID) {
1409 		printf("%s: could not get ID for volume with handle 0x%04x and "
1410 		    "WWID 0x%016llx\n", __func__, handle,
1411 		    (unsigned long long)wwid);
1412 		error = ENXIO;
1413 		goto out;
1414 	}
1415 
1416 	targ = &sassc->targets[id];
1417 	targ->tid = id;
1418 	targ->handle = handle;
1419 	targ->devname = wwid;
1420 	TAILQ_INIT(&targ->commands);
1421 	TAILQ_INIT(&targ->timedout_commands);
1422 	while (!SLIST_EMPTY(&targ->luns)) {
1423 		lun = SLIST_FIRST(&targ->luns);
1424 		SLIST_REMOVE_HEAD(&targ->luns, lun_link);
1425 		free(lun, M_MPR);
1426 	}
1427 	SLIST_INIT(&targ->luns);
1428 	mprsas_rescan_target(sc, targ);
1429 	mpr_dprint(sc, MPR_MAPPING, "RAID target id %d added (WWID = 0x%jx)\n",
1430 	    targ->tid, wwid);
1431 out:
1432 	mprsas_startup_decrement(sassc);
1433 	return (error);
1434 }
1435 
1436 /**
1437  * mprsas_SSU_to_SATA_devices
1438  * @sc: per adapter object
1439  *
1440  * Looks through the target list and issues a StartStopUnit SCSI command to each
1441  * SATA direct-access device.  This helps to ensure that data corruption is
1442  * avoided when the system is being shut down.  This must be called after the IR
1443  * System Shutdown RAID Action is sent if in IR mode.
1444  *
1445  * Return nothing.
1446  */
1447 static void
1448 mprsas_SSU_to_SATA_devices(struct mpr_softc *sc, int howto)
1449 {
1450 	struct mprsas_softc *sassc = sc->sassc;
1451 	union ccb *ccb;
1452 	path_id_t pathid = cam_sim_path(sassc->sim);
1453 	target_id_t targetid;
1454 	struct mprsas_target *target;
1455 	char path_str[64];
1456 	int timeout;
1457 
1458 	mpr_lock(sc);
1459 
1460 	/*
1461 	 * For each target, issue a StartStopUnit command to stop the device.
1462 	 */
1463 	sc->SSU_started = TRUE;
1464 	sc->SSU_refcount = 0;
1465 	for (targetid = 0; targetid < sc->max_devices; targetid++) {
1466 		target = &sassc->targets[targetid];
1467 		if (target->handle == 0x0) {
1468 			continue;
1469 		}
1470 
1471 		/*
1472 		 * The stop_at_shutdown flag will be set if this device is
1473 		 * a SATA direct-access end device.
1474 		 */
1475 		if (target->stop_at_shutdown) {
1476 			ccb = xpt_alloc_ccb_nowait();
1477 			if (ccb == NULL) {
1478 				mpr_dprint(sc, MPR_FAULT, "Unable to alloc CCB "
1479 				    "to stop unit.\n");
1480 				return;
1481 			}
1482 
1483 			if (xpt_create_path(&ccb->ccb_h.path, xpt_periph,
1484 			    pathid, targetid, CAM_LUN_WILDCARD) !=
1485 			    CAM_REQ_CMP) {
1486 				mpr_dprint(sc, MPR_ERROR, "Unable to create "
1487 				    "path to stop unit.\n");
1488 				xpt_free_ccb(ccb);
1489 				return;
1490 			}
1491 			xpt_path_string(ccb->ccb_h.path, path_str,
1492 			    sizeof(path_str));
1493 
1494 			mpr_dprint(sc, MPR_INFO, "Sending StopUnit: path %s "
1495 			    "handle %d\n", path_str, target->handle);
1496 
1497 			/*
1498 			 * Issue a START STOP UNIT command for the target.
1499 			 * Increment the SSU counter to be used to count the
1500 			 * number of required replies.
1501 			 */
1502 			mpr_dprint(sc, MPR_INFO, "Incrementing SSU count\n");
1503 			sc->SSU_refcount++;
1504 			ccb->ccb_h.target_id =
1505 			    xpt_path_target_id(ccb->ccb_h.path);
1506 			ccb->ccb_h.ppriv_ptr1 = sassc;
1507 			scsi_start_stop(&ccb->csio,
1508 			    /*retries*/0,
1509 			    mprsas_stop_unit_done,
1510 			    MSG_SIMPLE_Q_TAG,
1511 			    /*start*/FALSE,
1512 			    /*load/eject*/0,
1513 			    /*immediate*/FALSE,
1514 			    MPR_SENSE_LEN,
1515 			    /*timeout*/10000);
1516 			xpt_action(ccb);
1517 		}
1518 	}
1519 
1520 	mpr_unlock(sc);
1521 
1522 	/*
1523 	 * Timeout after 60 seconds by default or 10 seconds if howto has
1524 	 * RB_NOSYNC set which indicates we're likely handling a panic.
1525 	 */
1526 	timeout = 600;
1527 	if (howto & RB_NOSYNC)
1528 		timeout = 100;
1529 
1530 	/*
1531 	 * Wait until all of the SSU commands have completed or time
1532 	 * has expired. Pause for 100ms each time through.  If any
1533 	 * command times out, the target will be reset in the SCSI
1534 	 * command timeout routine.
1535 	 */
1536 	while (sc->SSU_refcount > 0) {
1537 		pause("mprwait", hz/10);
1538 		if (SCHEDULER_STOPPED())
1539 			xpt_sim_poll(sassc->sim);
1540 
1541 		if (--timeout == 0) {
1542 			mpr_dprint(sc, MPR_ERROR, "Time has expired waiting "
1543 			    "for SSU commands to complete.\n");
1544 			break;
1545 		}
1546 	}
1547 }
1548 
1549 static void
1550 mprsas_stop_unit_done(struct cam_periph *periph, union ccb *done_ccb)
1551 {
1552 	struct mprsas_softc *sassc;
1553 	char path_str[64];
1554 
1555 	if (done_ccb == NULL)
1556 		return;
1557 
1558 	sassc = (struct mprsas_softc *)done_ccb->ccb_h.ppriv_ptr1;
1559 
1560 	xpt_path_string(done_ccb->ccb_h.path, path_str, sizeof(path_str));
1561 	mpr_dprint(sassc->sc, MPR_INFO, "Completing stop unit for %s\n",
1562 	    path_str);
1563 
1564 	/*
1565 	 * Nothing more to do except free the CCB and path.  If the command
1566 	 * timed out, an abort reset, then target reset will be issued during
1567 	 * the SCSI Command process.
1568 	 */
1569 	xpt_free_path(done_ccb->ccb_h.path);
1570 	xpt_free_ccb(done_ccb);
1571 }
1572 
1573 /**
1574  * mprsas_ir_shutdown - IR shutdown notification
1575  * @sc: per adapter object
1576  *
1577  * Sending RAID Action to alert the Integrated RAID subsystem of the IOC that
1578  * the host system is shutting down.
1579  *
1580  * Return nothing.
1581  */
1582 void
1583 mprsas_ir_shutdown(struct mpr_softc *sc, int howto)
1584 {
1585 	u16 volume_mapping_flags;
1586 	u16 ioc_pg8_flags = le16toh(sc->ioc_pg8.Flags);
1587 	struct dev_mapping_table *mt_entry;
1588 	u32 start_idx, end_idx;
1589 	unsigned int id, found_volume = 0;
1590 	struct mpr_command *cm;
1591 	Mpi2RaidActionRequest_t	*action;
1592 	target_id_t targetid;
1593 	struct mprsas_target *target;
1594 
1595 	mpr_dprint(sc, MPR_TRACE, "%s\n", __func__);
1596 
1597 	/* is IR firmware build loaded? */
1598 	if (!sc->ir_firmware)
1599 		goto out;
1600 
1601 	/* are there any volumes?  Look at IR target IDs. */
1602 	// TODO-later, this should be looked up in the RAID config structure
1603 	// when it is implemented.
1604 	volume_mapping_flags = le16toh(sc->ioc_pg8.IRVolumeMappingFlags) &
1605 	    MPI2_IOCPAGE8_IRFLAGS_MASK_VOLUME_MAPPING_MODE;
1606 	if (volume_mapping_flags == MPI2_IOCPAGE8_IRFLAGS_LOW_VOLUME_MAPPING) {
1607 		start_idx = 0;
1608 		if (ioc_pg8_flags & MPI2_IOCPAGE8_FLAGS_RESERVED_TARGETID_0)
1609 			start_idx = 1;
1610 	} else
1611 		start_idx = sc->max_devices - sc->max_volumes;
1612 	end_idx = start_idx + sc->max_volumes - 1;
1613 
1614 	for (id = start_idx; id < end_idx; id++) {
1615 		mt_entry = &sc->mapping_table[id];
1616 		if ((mt_entry->physical_id != 0) &&
1617 		    (mt_entry->missing_count == 0)) {
1618 			found_volume = 1;
1619 			break;
1620 		}
1621 	}
1622 
1623 	if (!found_volume)
1624 		goto out;
1625 
1626 	if ((cm = mpr_alloc_command(sc)) == NULL) {
1627 		printf("%s: command alloc failed\n", __func__);
1628 		goto out;
1629 	}
1630 
1631 	action = (MPI2_RAID_ACTION_REQUEST *)cm->cm_req;
1632 	action->Function = MPI2_FUNCTION_RAID_ACTION;
1633 	action->Action = MPI2_RAID_ACTION_SYSTEM_SHUTDOWN_INITIATED;
1634 	cm->cm_desc.Default.RequestFlags = MPI2_REQ_DESCRIPT_FLAGS_DEFAULT_TYPE;
1635 	mpr_lock(sc);
1636 	mpr_wait_command(sc, &cm, 5, CAN_SLEEP);
1637 	mpr_unlock(sc);
1638 
1639 	/*
1640 	 * Don't check for reply, just leave.
1641 	 */
1642 	if (cm)
1643 		mpr_free_command(sc, cm);
1644 
1645 out:
1646 	/*
1647 	 * All of the targets must have the correct value set for
1648 	 * 'stop_at_shutdown' for the current 'enable_ssu' sysctl variable.
1649 	 *
1650 	 * The possible values for the 'enable_ssu' variable are:
1651 	 * 0: disable to SSD and HDD
1652 	 * 1: disable only to HDD (default)
1653 	 * 2: disable only to SSD
1654 	 * 3: enable to SSD and HDD
1655 	 * anything else will default to 1.
1656 	 */
1657 	for (targetid = 0; targetid < sc->max_devices; targetid++) {
1658 		target = &sc->sassc->targets[targetid];
1659 		if (target->handle == 0x0) {
1660 			continue;
1661 		}
1662 
1663 		if (target->supports_SSU) {
1664 			switch (sc->enable_ssu) {
1665 			case MPR_SSU_DISABLE_SSD_DISABLE_HDD:
1666 				target->stop_at_shutdown = FALSE;
1667 				break;
1668 			case MPR_SSU_DISABLE_SSD_ENABLE_HDD:
1669 				target->stop_at_shutdown = TRUE;
1670 				if (target->flags & MPR_TARGET_IS_SATA_SSD) {
1671 					target->stop_at_shutdown = FALSE;
1672 				}
1673 				break;
1674 			case MPR_SSU_ENABLE_SSD_ENABLE_HDD:
1675 				target->stop_at_shutdown = TRUE;
1676 				break;
1677 			case MPR_SSU_ENABLE_SSD_DISABLE_HDD:
1678 			default:
1679 				target->stop_at_shutdown = TRUE;
1680 				if ((target->flags &
1681 				    MPR_TARGET_IS_SATA_SSD) == 0) {
1682 					target->stop_at_shutdown = FALSE;
1683 				}
1684 				break;
1685 			}
1686 		}
1687 	}
1688 	mprsas_SSU_to_SATA_devices(sc, howto);
1689 }
1690