3 * Linux MegaRAID device driver
5 * Copyright (c) 2003-2004 LSI Logic Corporation.
7 * This program is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License
9 * as published by the Free Software Foundation; either version
10 * 2 of the License, or (at your option) any later version.
12 * FILE : megaraid_mbox.c
13 * Version : v2.20.4.8 (Apr 11 2006)
16 * Atul Mukker <Atul.Mukker@lsil.com>
17 * Sreenivas Bagalkote <Sreenivas.Bagalkote@lsil.com>
18 * Manoj Jose <Manoj.Jose@lsil.com>
19 * Seokmann Ju <Seokmann.Ju@lsil.com>
21 * List of supported controllers
23 * OEM Product Name VID DID SSVID SSID
24 * --- ------------ --- --- ---- ----
25 * Dell PERC3/QC 101E 1960 1028 0471
26 * Dell PERC3/DC 101E 1960 1028 0493
27 * Dell PERC3/SC 101E 1960 1028 0475
28 * Dell PERC3/Di 1028 1960 1028 0123
29 * Dell PERC4/SC 1000 1960 1028 0520
30 * Dell PERC4/DC 1000 1960 1028 0518
31 * Dell PERC4/QC 1000 0407 1028 0531
32 * Dell PERC4/Di 1028 000F 1028 014A
33 * Dell PERC 4e/Si 1028 0013 1028 016c
34 * Dell PERC 4e/Di 1028 0013 1028 016d
35 * Dell PERC 4e/Di 1028 0013 1028 016e
36 * Dell PERC 4e/Di 1028 0013 1028 016f
37 * Dell PERC 4e/Di 1028 0013 1028 0170
38 * Dell PERC 4e/DC 1000 0408 1028 0002
39 * Dell PERC 4e/SC 1000 0408 1028 0001
42 * LSI MegaRAID SCSI 320-0 1000 1960 1000 A520
43 * LSI MegaRAID SCSI 320-1 1000 1960 1000 0520
44 * LSI MegaRAID SCSI 320-2 1000 1960 1000 0518
45 * LSI MegaRAID SCSI 320-0X 1000 0407 1000 0530
46 * LSI MegaRAID SCSI 320-2X 1000 0407 1000 0532
47 * LSI MegaRAID SCSI 320-4X 1000 0407 1000 0531
48 * LSI MegaRAID SCSI 320-1E 1000 0408 1000 0001
49 * LSI MegaRAID SCSI 320-2E 1000 0408 1000 0002
50 * LSI MegaRAID SATA 150-4 1000 1960 1000 4523
51 * LSI MegaRAID SATA 150-6 1000 1960 1000 0523
52 * LSI MegaRAID SATA 300-4X 1000 0409 1000 3004
53 * LSI MegaRAID SATA 300-8X 1000 0409 1000 3008
55 * INTEL RAID Controller SRCU42X 1000 0407 8086 0532
56 * INTEL RAID Controller SRCS16 1000 1960 8086 0523
57 * INTEL RAID Controller SRCU42E 1000 0408 8086 0002
58 * INTEL RAID Controller SRCZCRX 1000 0407 8086 0530
59 * INTEL RAID Controller SRCS28X 1000 0409 8086 3008
60 * INTEL RAID Controller SROMBU42E 1000 0408 8086 3431
61 * INTEL RAID Controller SROMBU42E 1000 0408 8086 3499
62 * INTEL RAID Controller SRCU51L 1000 1960 8086 0520
64 * FSC MegaRAID PCI Express ROMB 1000 0408 1734 1065
66 * ACER MegaRAID ROMB-2E 1000 0408 1025 004D
68 * NEC MegaRAID PCI Express ROMB 1000 0408 1033 8287
70 * For history of changes, see Documentation/ChangeLog.megaraid
73 #include "megaraid_mbox.h"
75 static int megaraid_init(void);
76 static void megaraid_exit(void);
78 static int megaraid_probe_one(struct pci_dev*, const struct pci_device_id *);
79 static void megaraid_detach_one(struct pci_dev *);
80 static void megaraid_mbox_shutdown(struct pci_dev *);
82 static int megaraid_io_attach(adapter_t *);
83 static void megaraid_io_detach(adapter_t *);
85 static int megaraid_init_mbox(adapter_t *);
86 static void megaraid_fini_mbox(adapter_t *);
88 static int megaraid_alloc_cmd_packets(adapter_t *);
89 static void megaraid_free_cmd_packets(adapter_t *);
91 static int megaraid_mbox_setup_dma_pools(adapter_t *);
92 static void megaraid_mbox_teardown_dma_pools(adapter_t *);
94 static int megaraid_sysfs_alloc_resources(adapter_t *);
95 static void megaraid_sysfs_free_resources(adapter_t *);
97 static int megaraid_abort_handler(struct scsi_cmnd *);
98 static int megaraid_reset_handler(struct scsi_cmnd *);
100 static int mbox_post_sync_cmd(adapter_t *, uint8_t []);
101 static int mbox_post_sync_cmd_fast(adapter_t *, uint8_t []);
102 static int megaraid_busywait_mbox(mraid_device_t *);
103 static int megaraid_mbox_product_info(adapter_t *);
104 static int megaraid_mbox_extended_cdb(adapter_t *);
105 static int megaraid_mbox_support_ha(adapter_t *, uint16_t *);
106 static int megaraid_mbox_support_random_del(adapter_t *);
107 static int megaraid_mbox_get_max_sg(adapter_t *);
108 static void megaraid_mbox_enum_raid_scsi(adapter_t *);
109 static void megaraid_mbox_flush_cache(adapter_t *);
111 static void megaraid_mbox_display_scb(adapter_t *, scb_t *);
112 static void megaraid_mbox_setup_device_map(adapter_t *);
114 static int megaraid_queue_command(struct scsi_cmnd *,
115 void (*)(struct scsi_cmnd *));
116 static scb_t *megaraid_mbox_build_cmd(adapter_t *, struct scsi_cmnd *, int *);
117 static void megaraid_mbox_runpendq(adapter_t *, scb_t *);
118 static void megaraid_mbox_prepare_pthru(adapter_t *, scb_t *,
120 static void megaraid_mbox_prepare_epthru(adapter_t *, scb_t *,
123 static irqreturn_t megaraid_isr(int, void *, struct pt_regs *);
125 static void megaraid_mbox_dpc(unsigned long);
127 static ssize_t megaraid_sysfs_show_app_hndl(struct class_device *, char *);
128 static ssize_t megaraid_sysfs_show_ldnum(struct device *, struct device_attribute *attr, char *);
130 static int megaraid_cmm_register(adapter_t *);
131 static int megaraid_cmm_unregister(adapter_t *);
132 static int megaraid_mbox_mm_handler(unsigned long, uioc_t *, uint32_t);
133 static int megaraid_mbox_mm_command(adapter_t *, uioc_t *);
134 static void megaraid_mbox_mm_done(adapter_t *, scb_t *);
135 static int gather_hbainfo(adapter_t *, mraid_hba_info_t *);
136 static int wait_till_fw_empty(adapter_t *);
140 MODULE_AUTHOR("sju@lsil.com");
141 MODULE_DESCRIPTION("LSI Logic MegaRAID Mailbox Driver");
142 MODULE_LICENSE("GPL");
143 MODULE_VERSION(MEGARAID_VERSION);
146 * ### modules parameters for driver ###
150 * Set to enable driver to expose unconfigured disk to kernel
152 static int megaraid_expose_unconf_disks = 0;
153 module_param_named(unconf_disks, megaraid_expose_unconf_disks, int, 0);
154 MODULE_PARM_DESC(unconf_disks,
155 "Set to expose unconfigured disks to kernel (default=0)");
158 * driver wait time if the adapter's mailbox is busy
160 static unsigned int max_mbox_busy_wait = MBOX_BUSY_WAIT;
161 module_param_named(busy_wait, max_mbox_busy_wait, int, 0);
162 MODULE_PARM_DESC(busy_wait,
163 "Max wait for mailbox in microseconds if busy (default=10)");
166 * number of sectors per IO command
168 static unsigned int megaraid_max_sectors = MBOX_MAX_SECTORS;
169 module_param_named(max_sectors, megaraid_max_sectors, int, 0);
170 MODULE_PARM_DESC(max_sectors,
171 "Maximum number of sectors per IO command (default=128)");
174 * number of commands per logical unit
176 static unsigned int megaraid_cmd_per_lun = MBOX_DEF_CMD_PER_LUN;
177 module_param_named(cmd_per_lun, megaraid_cmd_per_lun, int, 0);
178 MODULE_PARM_DESC(cmd_per_lun,
179 "Maximum number of commands per logical unit (default=64)");
183 * Fast driver load option, skip scanning for physical devices during load.
184 * This would result in non-disk devices being skipped during driver load
185 * time. These can be later added though, using /proc/scsi/scsi
187 static unsigned int megaraid_fast_load = 0;
188 module_param_named(fast_load, megaraid_fast_load, int, 0);
189 MODULE_PARM_DESC(fast_load,
190 "Faster loading of the driver, skips physical devices! (default=0)");
194 * mraid_debug level - threshold for amount of information to be displayed by
195 * the driver. This level can be changed through modules parameters, ioctl or
196 * sysfs/proc interface. By default, print the announcement messages only.
198 int mraid_debug_level = CL_ANN;
199 module_param_named(debug_level, mraid_debug_level, int, 0);
200 MODULE_PARM_DESC(debug_level, "Debug level for driver (default=0)");
203 * ### global data ###
205 static uint8_t megaraid_mbox_version[8] =
206 { 0x02, 0x20, 0x04, 0x06, 3, 7, 20, 5 };
210 * PCI table for all supported controllers.
212 static struct pci_device_id pci_id_table_g[] = {
215 PCI_DEVICE_ID_PERC4_DI_DISCOVERY,
217 PCI_SUBSYS_ID_PERC4_DI_DISCOVERY,
220 PCI_VENDOR_ID_LSI_LOGIC,
221 PCI_DEVICE_ID_PERC4_SC,
223 PCI_SUBSYS_ID_PERC4_SC,
226 PCI_VENDOR_ID_LSI_LOGIC,
227 PCI_DEVICE_ID_PERC4_DC,
229 PCI_SUBSYS_ID_PERC4_DC,
232 PCI_VENDOR_ID_LSI_LOGIC,
239 PCI_DEVICE_ID_PERC4_DI_EVERGLADES,
241 PCI_SUBSYS_ID_PERC4_DI_EVERGLADES,
245 PCI_DEVICE_ID_PERC4E_SI_BIGBEND,
247 PCI_SUBSYS_ID_PERC4E_SI_BIGBEND,
251 PCI_DEVICE_ID_PERC4E_DI_KOBUK,
253 PCI_SUBSYS_ID_PERC4E_DI_KOBUK,
257 PCI_DEVICE_ID_PERC4E_DI_CORVETTE,
259 PCI_SUBSYS_ID_PERC4E_DI_CORVETTE,
263 PCI_DEVICE_ID_PERC4E_DI_EXPEDITION,
265 PCI_SUBSYS_ID_PERC4E_DI_EXPEDITION,
269 PCI_DEVICE_ID_PERC4E_DI_GUADALUPE,
271 PCI_SUBSYS_ID_PERC4E_DI_GUADALUPE,
274 PCI_VENDOR_ID_LSI_LOGIC,
275 PCI_DEVICE_ID_DOBSON,
281 PCI_DEVICE_ID_AMI_MEGARAID3,
286 PCI_VENDOR_ID_LSI_LOGIC,
287 PCI_DEVICE_ID_AMI_MEGARAID3,
292 PCI_VENDOR_ID_LSI_LOGIC,
293 PCI_DEVICE_ID_LINDSAY,
297 {0} /* Terminating entry */
299 MODULE_DEVICE_TABLE(pci, pci_id_table_g);
302 static struct pci_driver megaraid_pci_driver_g = {
304 .id_table = pci_id_table_g,
305 .probe = megaraid_probe_one,
306 .remove = __devexit_p(megaraid_detach_one),
307 .shutdown = megaraid_mbox_shutdown,
312 // definitions for the device attributes for exporting logical drive number
313 // for a scsi address (Host, Channel, Id, Lun)
315 CLASS_DEVICE_ATTR(megaraid_mbox_app_hndl, S_IRUSR, megaraid_sysfs_show_app_hndl,
318 // Host template initializer for megaraid mbox sysfs device attributes
319 static struct class_device_attribute *megaraid_shost_attrs[] = {
320 &class_device_attr_megaraid_mbox_app_hndl,
325 DEVICE_ATTR(megaraid_mbox_ld, S_IRUSR, megaraid_sysfs_show_ldnum, NULL);
327 // Host template initializer for megaraid mbox sysfs device attributes
328 static struct device_attribute *megaraid_sdev_attrs[] = {
329 &dev_attr_megaraid_mbox_ld,
334 * megaraid_change_queue_depth - Change the device's queue depth
335 * @sdev: scsi device struct
336 * @qdepth: depth to set
341 static int megaraid_change_queue_depth(struct scsi_device *sdev, int qdepth)
343 if (qdepth > MBOX_MAX_SCSI_CMDS)
344 qdepth = MBOX_MAX_SCSI_CMDS;
345 scsi_adjust_queue_depth(sdev, 0, qdepth);
346 return sdev->queue_depth;
350 * Scsi host template for megaraid unified driver
352 static struct scsi_host_template megaraid_template_g = {
353 .module = THIS_MODULE,
354 .name = "LSI Logic MegaRAID driver",
355 .proc_name = "megaraid",
356 .queuecommand = megaraid_queue_command,
357 .eh_abort_handler = megaraid_abort_handler,
358 .eh_device_reset_handler = megaraid_reset_handler,
359 .eh_bus_reset_handler = megaraid_reset_handler,
360 .eh_host_reset_handler = megaraid_reset_handler,
361 .change_queue_depth = megaraid_change_queue_depth,
362 .use_clustering = ENABLE_CLUSTERING,
363 .sdev_attrs = megaraid_sdev_attrs,
364 .shost_attrs = megaraid_shost_attrs,
369 * megaraid_init - module load hook
371 * We register ourselves as hotplug enabled module and let PCI subsystem
372 * discover our adaters
379 // Announce the driver version
380 con_log(CL_ANN, (KERN_INFO "megaraid: %s %s\n", MEGARAID_VERSION,
381 MEGARAID_EXT_VERSION));
383 // check validity of module parameters
384 if (megaraid_cmd_per_lun > MBOX_MAX_SCSI_CMDS) {
386 con_log(CL_ANN, (KERN_WARNING
387 "megaraid mailbox: max commands per lun reset to %d\n",
388 MBOX_MAX_SCSI_CMDS));
390 megaraid_cmd_per_lun = MBOX_MAX_SCSI_CMDS;
394 // register as a PCI hot-plug driver module
395 rval = pci_register_driver(&megaraid_pci_driver_g);
397 con_log(CL_ANN, (KERN_WARNING
398 "megaraid: could not register hotplug support.\n"));
406 * megaraid_exit - driver unload entry point
408 * We simply unwrap the megaraid_init routine here
413 con_log(CL_DLEVEL1, (KERN_NOTICE "megaraid: unloading framework\n"));
415 // unregister as PCI hotplug driver
416 pci_unregister_driver(&megaraid_pci_driver_g);
423 * megaraid_probe_one - PCI hotplug entry point
424 * @param pdev : handle to this controller's PCI configuration space
425 * @param id : pci device id of the class of controllers
427 * This routine should be called whenever a new adapter is detected by the
428 * PCI hotplug susbsytem.
431 megaraid_probe_one(struct pci_dev *pdev, const struct pci_device_id *id)
436 // detected a new controller
437 con_log(CL_ANN, (KERN_INFO
438 "megaraid: probe new device %#4.04x:%#4.04x:%#4.04x:%#4.04x: ",
439 pdev->vendor, pdev->device, pdev->subsystem_vendor,
440 pdev->subsystem_device));
442 con_log(CL_ANN, ("bus %d:slot %d:func %d\n", pdev->bus->number,
443 PCI_SLOT(pdev->devfn), PCI_FUNC(pdev->devfn)));
445 if (pci_enable_device(pdev)) {
446 con_log(CL_ANN, (KERN_WARNING
447 "megaraid: pci_enable_device failed\n"));
452 // Enable bus-mastering on this controller
453 pci_set_master(pdev);
455 // Allocate the per driver initialization structure
456 adapter = kmalloc(sizeof(adapter_t), GFP_KERNEL);
458 if (adapter == NULL) {
459 con_log(CL_ANN, (KERN_WARNING
460 "megaraid: out of memory, %s %d.\n", __FUNCTION__, __LINE__));
464 memset(adapter, 0, sizeof(adapter_t));
467 // set up PCI related soft state and other pre-known parameters
468 adapter->unique_id = pdev->bus->number << 8 | pdev->devfn;
469 adapter->irq = pdev->irq;
470 adapter->pdev = pdev;
472 atomic_set(&adapter->being_detached, 0);
474 // Setup the default DMA mask. This would be changed later on
475 // depending on hardware capabilities
476 if (pci_set_dma_mask(adapter->pdev, DMA_32BIT_MASK) != 0) {
478 con_log(CL_ANN, (KERN_WARNING
479 "megaraid: pci_set_dma_mask failed:%d\n", __LINE__));
481 goto out_free_adapter;
485 // Initialize the synchronization lock for kernel and LLD
486 spin_lock_init(&adapter->lock);
488 // Initialize the command queues: the list of free SCBs and the list
490 INIT_LIST_HEAD(&adapter->kscb_pool);
491 spin_lock_init(SCSI_FREE_LIST_LOCK(adapter));
493 INIT_LIST_HEAD(&adapter->pend_list);
494 spin_lock_init(PENDING_LIST_LOCK(adapter));
496 INIT_LIST_HEAD(&adapter->completed_list);
497 spin_lock_init(COMPLETED_LIST_LOCK(adapter));
500 // Start the mailbox based controller
501 if (megaraid_init_mbox(adapter) != 0) {
502 con_log(CL_ANN, (KERN_WARNING
503 "megaraid: maibox adapter did not initialize\n"));
505 goto out_free_adapter;
508 // Register with LSI Common Management Module
509 if (megaraid_cmm_register(adapter) != 0) {
511 con_log(CL_ANN, (KERN_WARNING
512 "megaraid: could not register with management module\n"));
517 // setup adapter handle in PCI soft state
518 pci_set_drvdata(pdev, adapter);
520 // attach with scsi mid-layer
521 if (megaraid_io_attach(adapter) != 0) {
523 con_log(CL_ANN, (KERN_WARNING "megaraid: io attach failed\n"));
531 pci_set_drvdata(pdev, NULL);
532 megaraid_cmm_unregister(adapter);
534 megaraid_fini_mbox(adapter);
538 pci_disable_device(pdev);
545 * megaraid_detach_one - release the framework resources and call LLD release
547 * @param pdev : handle for our PCI cofiguration space
549 * This routine is called during driver unload. We free all the allocated
550 * resources and call the corresponding LLD so that it can also release all
553 * This routine is also called from the PCI hotplug system
556 megaraid_detach_one(struct pci_dev *pdev)
559 struct Scsi_Host *host;
562 // Start a rollback on this adapter
563 adapter = pci_get_drvdata(pdev);
566 con_log(CL_ANN, (KERN_CRIT
567 "megaraid: Invalid detach on %#4.04x:%#4.04x:%#4.04x:%#4.04x\n",
568 pdev->vendor, pdev->device, pdev->subsystem_vendor,
569 pdev->subsystem_device));
574 con_log(CL_ANN, (KERN_NOTICE
575 "megaraid: detaching device %#4.04x:%#4.04x:%#4.04x:%#4.04x\n",
576 pdev->vendor, pdev->device, pdev->subsystem_vendor,
577 pdev->subsystem_device));
581 host = adapter->host;
583 // do not allow any more requests from the management module for this
585 // FIXME: How do we account for the request which might still be
587 atomic_set(&adapter->being_detached, 1);
589 // detach from the IO sub-system
590 megaraid_io_detach(adapter);
592 // reset the device state in the PCI structure. We check this
593 // condition when we enter here. If the device state is NULL,
594 // that would mean the device has already been removed
595 pci_set_drvdata(pdev, NULL);
597 // Unregister from common management module
599 // FIXME: this must return success or failure for conditions if there
600 // is a command pending with LLD or not.
601 megaraid_cmm_unregister(adapter);
603 // finalize the mailbox based controller and release all resources
604 megaraid_fini_mbox(adapter);
610 pci_disable_device(pdev);
617 * megaraid_mbox_shutdown - PCI shutdown for megaraid HBA
618 * @param device : generice driver model device
620 * Shutdown notification, perform flush cache
623 megaraid_mbox_shutdown(struct pci_dev *pdev)
625 adapter_t *adapter = pci_get_drvdata(pdev);
629 con_log(CL_ANN, (KERN_WARNING
630 "megaraid: null device in shutdown\n"));
635 con_log(CL_ANN, (KERN_INFO "megaraid: flushing adapter %d...",
638 megaraid_mbox_flush_cache(adapter);
640 con_log(CL_ANN, ("done\n"));
645 * megaraid_io_attach - attach a device with the IO subsystem
646 * @param adapter : controller's soft state
648 * Attach this device with the IO subsystem
651 megaraid_io_attach(adapter_t *adapter)
653 struct Scsi_Host *host;
655 // Initialize SCSI Host structure
656 host = scsi_host_alloc(&megaraid_template_g, 8);
658 con_log(CL_ANN, (KERN_WARNING
659 "megaraid mbox: scsi_register failed\n"));
664 SCSIHOST2ADAP(host) = (caddr_t)adapter;
665 adapter->host = host;
667 host->irq = adapter->irq;
668 host->unique_id = adapter->unique_id;
669 host->can_queue = adapter->max_cmds;
670 host->this_id = adapter->init_id;
671 host->sg_tablesize = adapter->sglen;
672 host->max_sectors = adapter->max_sectors;
673 host->cmd_per_lun = adapter->cmd_per_lun;
674 host->max_channel = adapter->max_channel;
675 host->max_id = adapter->max_target;
676 host->max_lun = adapter->max_lun;
679 // notify mid-layer about the new controller
680 if (scsi_add_host(host, &adapter->pdev->dev)) {
682 con_log(CL_ANN, (KERN_WARNING
683 "megaraid mbox: scsi_add_host failed\n"));
690 scsi_scan_host(host);
697 * megaraid_io_detach - detach a device from the IO subsystem
698 * @param adapter : controller's soft state
700 * Detach this device from the IO subsystem
703 megaraid_io_detach(adapter_t *adapter)
705 struct Scsi_Host *host;
707 con_log(CL_DLEVEL1, (KERN_INFO "megaraid: io detach\n"));
709 host = adapter->host;
711 scsi_remove_host(host);
718 * START: Mailbox Low Level Driver
720 * This is section specific to the single mailbox based controllers
724 * megaraid_init_mbox - initialize controller
725 * @param adapter - our soft state
727 * . Allocate 16-byte aligned mailbox memory for firmware handshake
728 * . Allocate controller's memory resources
729 * . Find out all initialization data
730 * . Allocate memory required for all the commands
731 * . Use internal library of FW routines, build up complete soft state
734 megaraid_init_mbox(adapter_t *adapter)
736 struct pci_dev *pdev;
737 mraid_device_t *raid_dev;
741 adapter->ito = MBOX_TIMEOUT;
742 pdev = adapter->pdev;
745 * Allocate and initialize the init data structure for mailbox
748 raid_dev = kmalloc(sizeof(mraid_device_t), GFP_KERNEL);
749 if (raid_dev == NULL) return -1;
751 memset(raid_dev, 0, sizeof(mraid_device_t));
754 * Attach the adapter soft state to raid device soft state
756 adapter->raid_device = (caddr_t)raid_dev;
757 raid_dev->fast_load = megaraid_fast_load;
761 raid_dev->baseport = pci_resource_start(pdev, 0);
763 if (pci_request_regions(pdev, "MegaRAID: LSI Logic Corporation") != 0) {
765 con_log(CL_ANN, (KERN_WARNING
766 "megaraid: mem region busy\n"));
768 goto out_free_raid_dev;
771 raid_dev->baseaddr = ioremap_nocache(raid_dev->baseport, 128);
773 if (!raid_dev->baseaddr) {
775 con_log(CL_ANN, (KERN_WARNING
776 "megaraid: could not map hba memory\n") );
778 goto out_release_regions;
782 // Setup the rest of the soft state using the library of FW routines
785 // request IRQ and register the interrupt service routine
786 if (request_irq(adapter->irq, megaraid_isr, IRQF_SHARED, "megaraid",
789 con_log(CL_ANN, (KERN_WARNING
790 "megaraid: Couldn't register IRQ %d!\n", adapter->irq));
796 // initialize the mutual exclusion lock for the mailbox
797 spin_lock_init(&raid_dev->mailbox_lock);
799 // allocate memory required for commands
800 if (megaraid_alloc_cmd_packets(adapter) != 0) {
805 if (megaraid_mbox_product_info(adapter) != 0) {
809 // Do we support extended CDBs
810 adapter->max_cdb_sz = 10;
811 if (megaraid_mbox_extended_cdb(adapter) == 0) {
812 adapter->max_cdb_sz = 16;
816 * Do we support cluster environment, if we do, what is the initiator
818 * NOTE: In a non-cluster aware firmware environment, the LLD should
819 * return 7 as initiator id.
822 adapter->init_id = -1;
823 if (megaraid_mbox_support_ha(adapter, &adapter->init_id) == 0) {
828 * Prepare the device ids array to have the mapping between the kernel
829 * device address and megaraid device address.
830 * We export the physical devices on their actual addresses. The
831 * logical drives are exported on a virtual SCSI channel
833 megaraid_mbox_setup_device_map(adapter);
835 // If the firmware supports random deletion, update the device id map
836 if (megaraid_mbox_support_random_del(adapter)) {
838 // Change the logical drives numbers in device_ids array one
839 // slot in device_ids is reserved for target id, that's why
841 for (i = 0; i <= MAX_LOGICAL_DRIVES_40LD; i++) {
842 adapter->device_ids[adapter->max_channel][i] += 0x80;
844 adapter->device_ids[adapter->max_channel][adapter->init_id] =
847 raid_dev->random_del_supported = 1;
851 * find out the maximum number of scatter-gather elements supported by
854 adapter->sglen = megaraid_mbox_get_max_sg(adapter);
856 // enumerate RAID and SCSI channels so that all devices on SCSI
857 // channels can later be exported, including disk devices
858 megaraid_mbox_enum_raid_scsi(adapter);
861 * Other parameters required by upper layer
863 * maximum number of sectors per IO command
865 adapter->max_sectors = megaraid_max_sectors;
868 * number of queued commands per LUN.
870 adapter->cmd_per_lun = megaraid_cmd_per_lun;
873 * Allocate resources required to issue FW calls, when sysfs is
876 if (megaraid_sysfs_alloc_resources(adapter) != 0) {
880 // Set the DMA mask to 64-bit. All supported controllers as capable of
882 if (pci_set_dma_mask(adapter->pdev, DMA_64BIT_MASK) != 0) {
884 con_log(CL_ANN, (KERN_WARNING
885 "megaraid: could not set DMA mask for 64-bit.\n"));
887 goto out_free_sysfs_res;
890 // setup tasklet for DPC
891 tasklet_init(&adapter->dpc_h, megaraid_mbox_dpc,
892 (unsigned long)adapter);
894 con_log(CL_DLEVEL1, (KERN_INFO
895 "megaraid mbox hba successfully initialized\n"));
900 megaraid_sysfs_free_resources(adapter);
902 megaraid_free_cmd_packets(adapter);
904 free_irq(adapter->irq, adapter);
906 iounmap(raid_dev->baseaddr);
908 pci_release_regions(pdev);
917 * megaraid_fini_mbox - undo controller initialization
918 * @param adapter : our soft state
921 megaraid_fini_mbox(adapter_t *adapter)
923 mraid_device_t *raid_dev = ADAP2RAIDDEV(adapter);
926 megaraid_mbox_flush_cache(adapter);
928 tasklet_kill(&adapter->dpc_h);
930 megaraid_sysfs_free_resources(adapter);
932 megaraid_free_cmd_packets(adapter);
934 free_irq(adapter->irq, adapter);
936 iounmap(raid_dev->baseaddr);
938 pci_release_regions(adapter->pdev);
947 * megaraid_alloc_cmd_packets - allocate shared mailbox
948 * @param adapter : soft state of the raid controller
950 * Allocate and align the shared mailbox. This maibox is used to issue
951 * all the commands. For IO based controllers, the mailbox is also regsitered
952 * with the FW. Allocate memory for all commands as well.
953 * This is our big allocator
956 megaraid_alloc_cmd_packets(adapter_t *adapter)
958 mraid_device_t *raid_dev = ADAP2RAIDDEV(adapter);
959 struct pci_dev *pdev;
963 struct mraid_pci_blk *epthru_pci_blk;
964 struct mraid_pci_blk *sg_pci_blk;
965 struct mraid_pci_blk *mbox_pci_blk;
968 pdev = adapter->pdev;
972 * Allocate the common 16-byte aligned memory for the handshake
975 raid_dev->una_mbox64 = pci_alloc_consistent(adapter->pdev,
976 sizeof(mbox64_t), &raid_dev->una_mbox64_dma);
978 if (!raid_dev->una_mbox64) {
979 con_log(CL_ANN, (KERN_WARNING
980 "megaraid: out of memory, %s %d\n", __FUNCTION__,
984 memset(raid_dev->una_mbox64, 0, sizeof(mbox64_t));
987 * Align the mailbox at 16-byte boundary
989 raid_dev->mbox = &raid_dev->una_mbox64->mbox32;
991 raid_dev->mbox = (mbox_t *)((((unsigned long)raid_dev->mbox) + 15) &
994 raid_dev->mbox64 = (mbox64_t *)(((unsigned long)raid_dev->mbox) - 8);
996 align = ((void *)raid_dev->mbox -
997 ((void *)&raid_dev->una_mbox64->mbox32));
999 raid_dev->mbox_dma = (unsigned long)raid_dev->una_mbox64_dma + 8 +
1002 // Allocate memory for commands issued internally
1003 adapter->ibuf = pci_alloc_consistent(pdev, MBOX_IBUF_SIZE,
1004 &adapter->ibuf_dma_h);
1005 if (!adapter->ibuf) {
1007 con_log(CL_ANN, (KERN_WARNING
1008 "megaraid: out of memory, %s %d\n", __FUNCTION__,
1011 goto out_free_common_mbox;
1013 memset(adapter->ibuf, 0, MBOX_IBUF_SIZE);
1015 // Allocate memory for our SCSI Command Blocks and their associated
1019 * Allocate memory for the base list of scb. Later allocate memory for
1020 * CCBs and embedded components of each CCB and point the pointers in
1021 * scb to the allocated components
1022 * NOTE: The code to allocate SCB will be duplicated in all the LLD
1023 * since the calling routine does not yet know the number of available
1026 adapter->kscb_list = kmalloc(sizeof(scb_t) * MBOX_MAX_SCSI_CMDS,
1029 if (adapter->kscb_list == NULL) {
1030 con_log(CL_ANN, (KERN_WARNING
1031 "megaraid: out of memory, %s %d\n", __FUNCTION__,
1035 memset(adapter->kscb_list, 0, sizeof(scb_t) * MBOX_MAX_SCSI_CMDS);
1037 // memory allocation for our command packets
1038 if (megaraid_mbox_setup_dma_pools(adapter) != 0) {
1039 con_log(CL_ANN, (KERN_WARNING
1040 "megaraid: out of memory, %s %d\n", __FUNCTION__,
1042 goto out_free_scb_list;
1045 // Adjust the scb pointers and link in the free pool
1046 epthru_pci_blk = raid_dev->epthru_pool;
1047 sg_pci_blk = raid_dev->sg_pool;
1048 mbox_pci_blk = raid_dev->mbox_pool;
1050 for (i = 0; i < MBOX_MAX_SCSI_CMDS; i++) {
1051 scb = adapter->kscb_list + i;
1052 ccb = raid_dev->ccb_list + i;
1054 ccb->mbox = (mbox_t *)(mbox_pci_blk[i].vaddr + 16);
1055 ccb->raw_mbox = (uint8_t *)ccb->mbox;
1056 ccb->mbox64 = (mbox64_t *)(mbox_pci_blk[i].vaddr + 8);
1057 ccb->mbox_dma_h = (unsigned long)mbox_pci_blk[i].dma_addr + 16;
1059 // make sure the mailbox is aligned properly
1060 if (ccb->mbox_dma_h & 0x0F) {
1061 con_log(CL_ANN, (KERN_CRIT
1062 "megaraid mbox: not aligned on 16-bytes\n"));
1064 goto out_teardown_dma_pools;
1067 ccb->epthru = (mraid_epassthru_t *)
1068 epthru_pci_blk[i].vaddr;
1069 ccb->epthru_dma_h = epthru_pci_blk[i].dma_addr;
1070 ccb->pthru = (mraid_passthru_t *)ccb->epthru;
1071 ccb->pthru_dma_h = ccb->epthru_dma_h;
1074 ccb->sgl64 = (mbox_sgl64 *)sg_pci_blk[i].vaddr;
1075 ccb->sgl_dma_h = sg_pci_blk[i].dma_addr;
1076 ccb->sgl32 = (mbox_sgl32 *)ccb->sgl64;
1078 scb->ccb = (caddr_t)ccb;
1081 scb->sno = i; // command index
1084 scb->state = SCB_FREE;
1085 scb->dma_direction = PCI_DMA_NONE;
1086 scb->dma_type = MRAID_DMA_NONE;
1087 scb->dev_channel = -1;
1088 scb->dev_target = -1;
1090 // put scb in the free pool
1091 list_add_tail(&scb->list, &adapter->kscb_pool);
1096 out_teardown_dma_pools:
1097 megaraid_mbox_teardown_dma_pools(adapter);
1099 kfree(adapter->kscb_list);
1101 pci_free_consistent(pdev, MBOX_IBUF_SIZE, (void *)adapter->ibuf,
1102 adapter->ibuf_dma_h);
1103 out_free_common_mbox:
1104 pci_free_consistent(adapter->pdev, sizeof(mbox64_t),
1105 (caddr_t)raid_dev->una_mbox64, raid_dev->una_mbox64_dma);
1112 * megaraid_free_cmd_packets - free memory
1113 * @param adapter : soft state of the raid controller
1115 * Release memory resources allocated for commands
1118 megaraid_free_cmd_packets(adapter_t *adapter)
1120 mraid_device_t *raid_dev = ADAP2RAIDDEV(adapter);
1122 megaraid_mbox_teardown_dma_pools(adapter);
1124 kfree(adapter->kscb_list);
1126 pci_free_consistent(adapter->pdev, MBOX_IBUF_SIZE,
1127 (void *)adapter->ibuf, adapter->ibuf_dma_h);
1129 pci_free_consistent(adapter->pdev, sizeof(mbox64_t),
1130 (caddr_t)raid_dev->una_mbox64, raid_dev->una_mbox64_dma);
1136 * megaraid_mbox_setup_dma_pools - setup dma pool for command packets
1137 * @param adapter : HBA soft state
1139 * setup the dma pools for mailbox, passthru and extended passthru structures,
1140 * and scatter-gather lists
1143 megaraid_mbox_setup_dma_pools(adapter_t *adapter)
1145 mraid_device_t *raid_dev = ADAP2RAIDDEV(adapter);
1146 struct mraid_pci_blk *epthru_pci_blk;
1147 struct mraid_pci_blk *sg_pci_blk;
1148 struct mraid_pci_blk *mbox_pci_blk;
1153 // Allocate memory for 16-bytes aligned mailboxes
1154 raid_dev->mbox_pool_handle = pci_pool_create("megaraid mbox pool",
1156 sizeof(mbox64_t) + 16,
1159 if (raid_dev->mbox_pool_handle == NULL) {
1160 goto fail_setup_dma_pool;
1163 mbox_pci_blk = raid_dev->mbox_pool;
1164 for (i = 0; i < MBOX_MAX_SCSI_CMDS; i++) {
1165 mbox_pci_blk[i].vaddr = pci_pool_alloc(
1166 raid_dev->mbox_pool_handle,
1168 &mbox_pci_blk[i].dma_addr);
1169 if (!mbox_pci_blk[i].vaddr) {
1170 goto fail_setup_dma_pool;
1175 * Allocate memory for each embedded passthru strucuture pointer
1176 * Request for a 128 bytes aligned structure for each passthru command
1178 * Since passthru and extended passthru commands are exclusive, they
1179 * share common memory pool. Passthru structures piggyback on memory
1180 * allocted to extended passthru since passthru is smaller of the two
1182 raid_dev->epthru_pool_handle = pci_pool_create("megaraid mbox pthru",
1183 adapter->pdev, sizeof(mraid_epassthru_t), 128, 0);
1185 if (raid_dev->epthru_pool_handle == NULL) {
1186 goto fail_setup_dma_pool;
1189 epthru_pci_blk = raid_dev->epthru_pool;
1190 for (i = 0; i < MBOX_MAX_SCSI_CMDS; i++) {
1191 epthru_pci_blk[i].vaddr = pci_pool_alloc(
1192 raid_dev->epthru_pool_handle,
1194 &epthru_pci_blk[i].dma_addr);
1195 if (!epthru_pci_blk[i].vaddr) {
1196 goto fail_setup_dma_pool;
1201 // Allocate memory for each scatter-gather list. Request for 512 bytes
1202 // alignment for each sg list
1203 raid_dev->sg_pool_handle = pci_pool_create("megaraid mbox sg",
1205 sizeof(mbox_sgl64) * MBOX_MAX_SG_SIZE,
1208 if (raid_dev->sg_pool_handle == NULL) {
1209 goto fail_setup_dma_pool;
1212 sg_pci_blk = raid_dev->sg_pool;
1213 for (i = 0; i < MBOX_MAX_SCSI_CMDS; i++) {
1214 sg_pci_blk[i].vaddr = pci_pool_alloc(
1215 raid_dev->sg_pool_handle,
1217 &sg_pci_blk[i].dma_addr);
1218 if (!sg_pci_blk[i].vaddr) {
1219 goto fail_setup_dma_pool;
1225 fail_setup_dma_pool:
1226 megaraid_mbox_teardown_dma_pools(adapter);
1232 * megaraid_mbox_teardown_dma_pools - teardown dma pools for command packets
1233 * @param adapter : HBA soft state
1235 * teardown the dma pool for mailbox, passthru and extended passthru
1236 * structures, and scatter-gather lists
1239 megaraid_mbox_teardown_dma_pools(adapter_t *adapter)
1241 mraid_device_t *raid_dev = ADAP2RAIDDEV(adapter);
1242 struct mraid_pci_blk *epthru_pci_blk;
1243 struct mraid_pci_blk *sg_pci_blk;
1244 struct mraid_pci_blk *mbox_pci_blk;
1248 sg_pci_blk = raid_dev->sg_pool;
1249 for (i = 0; i < MBOX_MAX_SCSI_CMDS && sg_pci_blk[i].vaddr; i++) {
1250 pci_pool_free(raid_dev->sg_pool_handle, sg_pci_blk[i].vaddr,
1251 sg_pci_blk[i].dma_addr);
1253 if (raid_dev->sg_pool_handle)
1254 pci_pool_destroy(raid_dev->sg_pool_handle);
1257 epthru_pci_blk = raid_dev->epthru_pool;
1258 for (i = 0; i < MBOX_MAX_SCSI_CMDS && epthru_pci_blk[i].vaddr; i++) {
1259 pci_pool_free(raid_dev->epthru_pool_handle,
1260 epthru_pci_blk[i].vaddr, epthru_pci_blk[i].dma_addr);
1262 if (raid_dev->epthru_pool_handle)
1263 pci_pool_destroy(raid_dev->epthru_pool_handle);
1266 mbox_pci_blk = raid_dev->mbox_pool;
1267 for (i = 0; i < MBOX_MAX_SCSI_CMDS && mbox_pci_blk[i].vaddr; i++) {
1268 pci_pool_free(raid_dev->mbox_pool_handle,
1269 mbox_pci_blk[i].vaddr, mbox_pci_blk[i].dma_addr);
1271 if (raid_dev->mbox_pool_handle)
1272 pci_pool_destroy(raid_dev->mbox_pool_handle);
1279 * megaraid_alloc_scb - detach and return a scb from the free list
1280 * @adapter : controller's soft state
1282 * return the scb from the head of the free list. NULL if there are none
1286 megaraid_alloc_scb(adapter_t *adapter, struct scsi_cmnd *scp)
1288 struct list_head *head = &adapter->kscb_pool;
1290 unsigned long flags;
1292 // detach scb from free pool
1293 spin_lock_irqsave(SCSI_FREE_LIST_LOCK(adapter), flags);
1295 if (list_empty(head)) {
1296 spin_unlock_irqrestore(SCSI_FREE_LIST_LOCK(adapter), flags);
1300 scb = list_entry(head->next, scb_t, list);
1301 list_del_init(&scb->list);
1303 spin_unlock_irqrestore(SCSI_FREE_LIST_LOCK(adapter), flags);
1305 scb->state = SCB_ACTIVE;
1307 scb->dma_type = MRAID_DMA_NONE;
1314 * megaraid_dealloc_scb - return the scb to the free pool
1315 * @adapter : controller's soft state
1316 * @scb : scb to be freed
1318 * return the scb back to the free list of scbs. The caller must 'flush' the
1319 * SCB before calling us. E.g., performing pci_unamp and/or pci_sync etc.
1320 * NOTE NOTE: Make sure the scb is not on any list before calling this
1324 megaraid_dealloc_scb(adapter_t *adapter, scb_t *scb)
1326 unsigned long flags;
1328 // put scb in the free pool
1329 scb->state = SCB_FREE;
1331 spin_lock_irqsave(SCSI_FREE_LIST_LOCK(adapter), flags);
1333 list_add(&scb->list, &adapter->kscb_pool);
1335 spin_unlock_irqrestore(SCSI_FREE_LIST_LOCK(adapter), flags);
1342 * megaraid_mbox_mksgl - make the scatter-gather list
1343 * @adapter - controller's soft state
1344 * @scb - scsi control block
1346 * prepare the scatter-gather list
1349 megaraid_mbox_mksgl(adapter_t *adapter, scb_t *scb)
1351 struct scatterlist *sgl;
1354 unsigned long offset;
1355 struct scsi_cmnd *scp;
1361 ccb = (mbox_ccb_t *)scb->ccb;
1363 // no mapping required if no data to be transferred
1364 if (!scp->request_buffer || !scp->request_bufflen)
1367 if (!scp->use_sg) { /* scatter-gather list not used */
1369 page = virt_to_page(scp->request_buffer);
1371 offset = ((unsigned long)scp->request_buffer & ~PAGE_MASK);
1373 ccb->buf_dma_h = pci_map_page(adapter->pdev, page, offset,
1374 scp->request_bufflen,
1375 scb->dma_direction);
1376 scb->dma_type = MRAID_DMA_WBUF;
1379 * We need to handle special 64-bit commands that need a
1383 ccb->sgl64[0].address = ccb->buf_dma_h;
1384 ccb->sgl64[0].length = scp->request_bufflen;
1389 sgl = (struct scatterlist *)scp->request_buffer;
1391 // The number of sg elements returned must not exceed our limit
1392 sgcnt = pci_map_sg(adapter->pdev, sgl, scp->use_sg,
1393 scb->dma_direction);
1395 if (sgcnt > adapter->sglen) {
1396 con_log(CL_ANN, (KERN_CRIT
1397 "megaraid critical: too many sg elements:%d\n",
1402 scb->dma_type = MRAID_DMA_WSG;
1404 for (i = 0; i < sgcnt; i++, sgl++) {
1405 ccb->sgl64[i].address = sg_dma_address(sgl);
1406 ccb->sgl64[i].length = sg_dma_len(sgl);
1409 // Return count of SG nodes
1415 * mbox_post_cmd - issue a mailbox command
1416 * @adapter - controller's soft state
1417 * @scb - command to be issued
1419 * post the command to the controller if mailbox is availble.
1422 mbox_post_cmd(adapter_t *adapter, scb_t *scb)
1424 mraid_device_t *raid_dev = ADAP2RAIDDEV(adapter);
1428 unsigned long flags;
1432 ccb = (mbox_ccb_t *)scb->ccb;
1433 mbox = raid_dev->mbox;
1434 mbox64 = raid_dev->mbox64;
1437 * Check for busy mailbox. If it is, return failure - the caller
1438 * should retry later.
1440 spin_lock_irqsave(MAILBOX_LOCK(raid_dev), flags);
1442 if (unlikely(mbox->busy)) {
1447 } while(mbox->busy && (i < max_mbox_busy_wait));
1451 spin_unlock_irqrestore(MAILBOX_LOCK(raid_dev), flags);
1458 // Copy this command's mailbox data into "adapter's" mailbox
1459 memcpy((caddr_t)mbox64, (caddr_t)ccb->mbox64, 22);
1460 mbox->cmdid = scb->sno;
1462 adapter->outstanding_cmds++;
1464 if (scb->dma_direction == PCI_DMA_TODEVICE) {
1465 if (!scb->scp->use_sg) { // sg list not used
1466 pci_dma_sync_single_for_device(adapter->pdev,
1468 scb->scp->request_bufflen,
1472 pci_dma_sync_sg_for_device(adapter->pdev,
1473 scb->scp->request_buffer,
1474 scb->scp->use_sg, PCI_DMA_TODEVICE);
1478 mbox->busy = 1; // Set busy
1483 WRINDOOR(raid_dev, raid_dev->mbox_dma | 0x1);
1485 spin_unlock_irqrestore(MAILBOX_LOCK(raid_dev), flags);
1492 * megaraid_queue_command - generic queue entry point for all LLDs
1493 * @scp : pointer to the scsi command to be executed
1494 * @done : callback routine to be called after the cmd has be completed
1496 * Queue entry point for mailbox based controllers.
1499 megaraid_queue_command(struct scsi_cmnd *scp, void (* done)(struct scsi_cmnd *))
1505 adapter = SCP2ADAPTER(scp);
1506 scp->scsi_done = done;
1510 * Allocate and build a SCB request
1511 * if_busy flag will be set if megaraid_mbox_build_cmd() command could
1512 * not allocate scb. We will return non-zero status in that case.
1513 * NOTE: scb can be null even though certain commands completed
1514 * successfully, e.g., MODE_SENSE and TEST_UNIT_READY, it would
1515 * return 0 in that case, and we would do the callback right away.
1518 scb = megaraid_mbox_build_cmd(adapter, scp, &if_busy);
1519 if (!scb) { // command already completed
1524 megaraid_mbox_runpendq(adapter, scb);
1529 * megaraid_mbox_build_cmd - transform the mid-layer scsi command to megaraid
1531 * @adapter - controller's soft state
1532 * @scp - mid-layer scsi command pointer
1533 * @busy - set if request could not be completed because of lack of
1536 * convert the command issued by mid-layer to format understood by megaraid
1537 * firmware. We also complete certain command without sending them to firmware
1540 megaraid_mbox_build_cmd(adapter_t *adapter, struct scsi_cmnd *scp, int *busy)
1542 mraid_device_t *rdev = ADAP2RAIDDEV(adapter);
1547 mraid_passthru_t *pthru;
1551 char skip[] = "skipping";
1552 char scan[] = "scanning";
1557 * Get the appropriate device map for the device this command is
1560 MRAID_GET_DEVICE_MAP(adapter, scp, channel, target, islogical);
1563 * Logical drive commands
1566 switch (scp->cmnd[0]) {
1567 case TEST_UNIT_READY:
1569 * Do we support clustering and is the support enabled
1570 * If no, return success always
1573 scp->result = (DID_OK << 16);
1577 if (!(scb = megaraid_alloc_scb(adapter, scp))) {
1578 scp->result = (DID_ERROR << 16);
1583 scb->dma_direction = scp->sc_data_direction;
1584 scb->dev_channel = 0xFF;
1585 scb->dev_target = target;
1586 ccb = (mbox_ccb_t *)scb->ccb;
1589 * The command id will be provided by the command
1592 ccb->raw_mbox[0] = CLUSTER_CMD;
1593 ccb->raw_mbox[2] = RESERVATION_STATUS;
1594 ccb->raw_mbox[3] = target;
1600 struct scatterlist *sgl;
1603 sgl = (struct scatterlist *)scp->request_buffer;
1606 (page_address((&sgl[0])->page)
1607 + (&sgl[0])->offset);
1609 memset(vaddr, 0, scp->cmnd[4]);
1612 con_log(CL_ANN, (KERN_WARNING
1613 "megaraid mailbox: invalid sg:%d\n",
1618 memset(scp->request_buffer, 0, scp->cmnd[4]);
1620 scp->result = (DID_OK << 16);
1625 * Display the channel scan for logical drives
1626 * Do not display scan for a channel if already done.
1628 if (!(rdev->last_disp & (1L << SCP2CHANNEL(scp)))) {
1630 con_log(CL_ANN, (KERN_INFO
1631 "scsi[%d]: scanning scsi channel %d",
1632 adapter->host->host_no,
1636 " [virtual] for logical drives\n"));
1638 rdev->last_disp |= (1L << SCP2CHANNEL(scp));
1645 * Do not allow LUN > 0 for logical drives and
1646 * requests for more than 40 logical drives
1649 scp->result = (DID_BAD_TARGET << 16);
1652 if ((target % 0x80) >= MAX_LOGICAL_DRIVES_40LD) {
1653 scp->result = (DID_BAD_TARGET << 16);
1658 /* Allocate a SCB and initialize passthru */
1659 if (!(scb = megaraid_alloc_scb(adapter, scp))) {
1660 scp->result = (DID_ERROR << 16);
1665 ccb = (mbox_ccb_t *)scb->ccb;
1666 scb->dev_channel = 0xFF;
1667 scb->dev_target = target;
1670 mbox64 = ccb->mbox64;
1674 pthru->reqsenselen = 14;
1675 pthru->islogical = 1;
1676 pthru->logdrv = target;
1677 pthru->cdblen = scp->cmd_len;
1678 memcpy(pthru->cdb, scp->cmnd, scp->cmd_len);
1680 mbox->cmd = MBOXCMD_PASSTHRU64;
1681 scb->dma_direction = scp->sc_data_direction;
1683 pthru->dataxferlen = scp->request_bufflen;
1684 pthru->dataxferaddr = ccb->sgl_dma_h;
1685 pthru->numsge = megaraid_mbox_mksgl(adapter,
1688 mbox->xferaddr = 0xFFFFFFFF;
1689 mbox64->xferaddr_lo = (uint32_t )ccb->pthru_dma_h;
1690 mbox64->xferaddr_hi = 0;
1702 * Allocate a SCB and initialize mailbox
1704 if (!(scb = megaraid_alloc_scb(adapter, scp))) {
1705 scp->result = (DID_ERROR << 16);
1709 ccb = (mbox_ccb_t *)scb->ccb;
1710 scb->dev_channel = 0xFF;
1711 scb->dev_target = target;
1713 mbox64 = ccb->mbox64;
1714 mbox->logdrv = target;
1717 * A little HACK: 2nd bit is zero for all scsi read
1718 * commands and is set for all scsi write commands
1720 mbox->cmd = (scp->cmnd[0] & 0x02) ? MBOXCMD_LWRITE64:
1724 * 6-byte READ(0x08) or WRITE(0x0A) cdb
1726 if (scp->cmd_len == 6) {
1727 mbox->numsectors = (uint32_t)scp->cmnd[4];
1729 ((uint32_t)scp->cmnd[1] << 16) |
1730 ((uint32_t)scp->cmnd[2] << 8) |
1731 (uint32_t)scp->cmnd[3];
1733 mbox->lba &= 0x1FFFFF;
1737 * 10-byte READ(0x28) or WRITE(0x2A) cdb
1739 else if (scp->cmd_len == 10) {
1741 (uint32_t)scp->cmnd[8] |
1742 ((uint32_t)scp->cmnd[7] << 8);
1744 ((uint32_t)scp->cmnd[2] << 24) |
1745 ((uint32_t)scp->cmnd[3] << 16) |
1746 ((uint32_t)scp->cmnd[4] << 8) |
1747 (uint32_t)scp->cmnd[5];
1751 * 12-byte READ(0xA8) or WRITE(0xAA) cdb
1753 else if (scp->cmd_len == 12) {
1755 ((uint32_t)scp->cmnd[2] << 24) |
1756 ((uint32_t)scp->cmnd[3] << 16) |
1757 ((uint32_t)scp->cmnd[4] << 8) |
1758 (uint32_t)scp->cmnd[5];
1761 ((uint32_t)scp->cmnd[6] << 24) |
1762 ((uint32_t)scp->cmnd[7] << 16) |
1763 ((uint32_t)scp->cmnd[8] << 8) |
1764 (uint32_t)scp->cmnd[9];
1767 con_log(CL_ANN, (KERN_WARNING
1768 "megaraid: unsupported CDB length\n"));
1770 megaraid_dealloc_scb(adapter, scb);
1772 scp->result = (DID_ERROR << 16);
1776 scb->dma_direction = scp->sc_data_direction;
1778 // Calculate Scatter-Gather info
1779 mbox64->xferaddr_lo = (uint32_t )ccb->sgl_dma_h;
1780 mbox->numsge = megaraid_mbox_mksgl(adapter,
1782 mbox->xferaddr = 0xFFFFFFFF;
1783 mbox64->xferaddr_hi = 0;
1790 * Do we support clustering and is the support enabled
1793 scp->result = (DID_BAD_TARGET << 16);
1798 * Allocate a SCB and initialize mailbox
1800 if (!(scb = megaraid_alloc_scb(adapter, scp))) {
1801 scp->result = (DID_ERROR << 16);
1806 ccb = (mbox_ccb_t *)scb->ccb;
1807 scb->dev_channel = 0xFF;
1808 scb->dev_target = target;
1809 ccb->raw_mbox[0] = CLUSTER_CMD;
1810 ccb->raw_mbox[2] = (scp->cmnd[0] == RESERVE) ?
1811 RESERVE_LD : RELEASE_LD;
1813 ccb->raw_mbox[3] = target;
1814 scb->dma_direction = scp->sc_data_direction;
1819 scp->result = (DID_BAD_TARGET << 16);
1823 else { // Passthru device commands
1825 // Do not allow access to target id > 15 or LUN > 7
1826 if (target > 15 || SCP2LUN(scp) > 7) {
1827 scp->result = (DID_BAD_TARGET << 16);
1831 // if fast load option was set and scan for last device is
1832 // over, reset the fast_load flag so that during a possible
1833 // next scan, devices can be made available
1834 if (rdev->fast_load && (target == 15) &&
1835 (SCP2CHANNEL(scp) == adapter->max_channel -1)) {
1837 con_log(CL_ANN, (KERN_INFO
1838 "megaraid[%d]: physical device scan re-enabled\n",
1839 adapter->host->host_no));
1840 rdev->fast_load = 0;
1844 * Display the channel scan for physical devices
1846 if (!(rdev->last_disp & (1L << SCP2CHANNEL(scp)))) {
1848 ss = rdev->fast_load ? skip : scan;
1850 con_log(CL_ANN, (KERN_INFO
1851 "scsi[%d]: %s scsi channel %d [Phy %d]",
1852 adapter->host->host_no, ss, SCP2CHANNEL(scp),
1856 " for non-raid devices\n"));
1858 rdev->last_disp |= (1L << SCP2CHANNEL(scp));
1861 // disable channel sweep if fast load option given
1862 if (rdev->fast_load) {
1863 scp->result = (DID_BAD_TARGET << 16);
1867 // Allocate a SCB and initialize passthru
1868 if (!(scb = megaraid_alloc_scb(adapter, scp))) {
1869 scp->result = (DID_ERROR << 16);
1874 ccb = (mbox_ccb_t *)scb->ccb;
1875 scb->dev_channel = channel;
1876 scb->dev_target = target;
1877 scb->dma_direction = scp->sc_data_direction;
1879 mbox64 = ccb->mbox64;
1881 // Does this firmware support extended CDBs
1882 if (adapter->max_cdb_sz == 16) {
1883 mbox->cmd = MBOXCMD_EXTPTHRU;
1885 megaraid_mbox_prepare_epthru(adapter, scb, scp);
1887 mbox64->xferaddr_lo = (uint32_t)ccb->epthru_dma_h;
1888 mbox64->xferaddr_hi = 0;
1889 mbox->xferaddr = 0xFFFFFFFF;
1892 mbox->cmd = MBOXCMD_PASSTHRU64;
1894 megaraid_mbox_prepare_pthru(adapter, scb, scp);
1896 mbox64->xferaddr_lo = (uint32_t)ccb->pthru_dma_h;
1897 mbox64->xferaddr_hi = 0;
1898 mbox->xferaddr = 0xFFFFFFFF;
1908 * megaraid_mbox_runpendq - execute commands queued in the pending queue
1909 * @adapter : controller's soft state
1910 * @scb : SCB to be queued in the pending list
1912 * scan the pending list for commands which are not yet issued and try to
1913 * post to the controller. The SCB can be a null pointer, which would indicate
1914 * no SCB to be queue, just try to execute the ones in the pending list.
1916 * NOTE: We do not actually traverse the pending list. The SCBs are plucked
1917 * out from the head of the pending list. If it is successfully issued, the
1918 * next SCB is at the head now.
1921 megaraid_mbox_runpendq(adapter_t *adapter, scb_t *scb_q)
1924 unsigned long flags;
1926 spin_lock_irqsave(PENDING_LIST_LOCK(adapter), flags);
1929 scb_q->state = SCB_PENDQ;
1930 list_add_tail(&scb_q->list, &adapter->pend_list);
1933 // if the adapter in not in quiescent mode, post the commands to FW
1934 if (adapter->quiescent) {
1935 spin_unlock_irqrestore(PENDING_LIST_LOCK(adapter), flags);
1939 while (!list_empty(&adapter->pend_list)) {
1941 assert_spin_locked(PENDING_LIST_LOCK(adapter));
1943 scb = list_entry(adapter->pend_list.next, scb_t, list);
1945 // remove the scb from the pending list and try to
1946 // issue. If we are unable to issue it, put back in
1947 // the pending list and return
1949 list_del_init(&scb->list);
1951 spin_unlock_irqrestore(PENDING_LIST_LOCK(adapter), flags);
1953 // if mailbox was busy, return SCB back to pending
1954 // list. Make sure to add at the head, since that's
1955 // where it would have been removed from
1957 scb->state = SCB_ISSUED;
1959 if (mbox_post_cmd(adapter, scb) != 0) {
1961 spin_lock_irqsave(PENDING_LIST_LOCK(adapter), flags);
1963 scb->state = SCB_PENDQ;
1965 list_add(&scb->list, &adapter->pend_list);
1967 spin_unlock_irqrestore(PENDING_LIST_LOCK(adapter),
1973 spin_lock_irqsave(PENDING_LIST_LOCK(adapter), flags);
1976 spin_unlock_irqrestore(PENDING_LIST_LOCK(adapter), flags);
1984 * megaraid_mbox_prepare_pthru - prepare a command for physical devices
1985 * @adapter - pointer to controller's soft state
1986 * @scb - scsi control block
1987 * @scp - scsi command from the mid-layer
1989 * prepare a command for the scsi physical devices
1992 megaraid_mbox_prepare_pthru(adapter_t *adapter, scb_t *scb,
1993 struct scsi_cmnd *scp)
1996 mraid_passthru_t *pthru;
2000 ccb = (mbox_ccb_t *)scb->ccb;
2002 channel = scb->dev_channel;
2003 target = scb->dev_target;
2005 // 0=6sec, 1=60sec, 2=10min, 3=3hrs, 4=NO timeout
2008 pthru->islogical = 0;
2010 pthru->target = (channel << 4) | target;
2011 pthru->logdrv = SCP2LUN(scp);
2012 pthru->reqsenselen = 14;
2013 pthru->cdblen = scp->cmd_len;
2015 memcpy(pthru->cdb, scp->cmnd, scp->cmd_len);
2017 if (scp->request_bufflen) {
2018 pthru->dataxferlen = scp->request_bufflen;
2019 pthru->dataxferaddr = ccb->sgl_dma_h;
2020 pthru->numsge = megaraid_mbox_mksgl(adapter, scb);
2023 pthru->dataxferaddr = 0;
2024 pthru->dataxferlen = 0;
2032 * megaraid_mbox_prepare_epthru - prepare a command for physical devices
2033 * @adapter - pointer to controller's soft state
2034 * @scb - scsi control block
2035 * @scp - scsi command from the mid-layer
2037 * prepare a command for the scsi physical devices. This rountine prepares
2038 * commands for devices which can take extended CDBs (>10 bytes)
2041 megaraid_mbox_prepare_epthru(adapter_t *adapter, scb_t *scb,
2042 struct scsi_cmnd *scp)
2045 mraid_epassthru_t *epthru;
2049 ccb = (mbox_ccb_t *)scb->ccb;
2050 epthru = ccb->epthru;
2051 channel = scb->dev_channel;
2052 target = scb->dev_target;
2054 // 0=6sec, 1=60sec, 2=10min, 3=3hrs, 4=NO timeout
2055 epthru->timeout = 4;
2057 epthru->islogical = 0;
2058 epthru->channel = 0;
2059 epthru->target = (channel << 4) | target;
2060 epthru->logdrv = SCP2LUN(scp);
2061 epthru->reqsenselen = 14;
2062 epthru->cdblen = scp->cmd_len;
2064 memcpy(epthru->cdb, scp->cmnd, scp->cmd_len);
2066 if (scp->request_bufflen) {
2067 epthru->dataxferlen = scp->request_bufflen;
2068 epthru->dataxferaddr = ccb->sgl_dma_h;
2069 epthru->numsge = megaraid_mbox_mksgl(adapter, scb);
2072 epthru->dataxferaddr = 0;
2073 epthru->dataxferlen = 0;
2081 * megaraid_ack_sequence - interrupt ack sequence for memory mapped HBAs
2082 * @adapter - controller's soft state
2084 * Interrupt ackrowledgement sequence for memory mapped HBAs. Find out the
2085 * completed command and put them on the completed list for later processing.
2087 * Returns: 1 if the interrupt is valid, 0 otherwise
2090 megaraid_ack_sequence(adapter_t *adapter)
2092 mraid_device_t *raid_dev = ADAP2RAIDDEV(adapter);
2096 uint8_t completed[MBOX_MAX_FIRMWARE_STATUS];
2097 struct list_head clist;
2100 unsigned long flags;
2104 mbox = raid_dev->mbox;
2106 // move the SCBs from the firmware completed array to our local list
2107 INIT_LIST_HEAD(&clist);
2109 // loop till F/W has more commands for us to complete
2111 spin_lock_irqsave(MAILBOX_LOCK(raid_dev), flags);
2114 * Check if a valid interrupt is pending. If found, force the
2115 * interrupt line low.
2117 dword = RDOUTDOOR(raid_dev);
2118 if (dword != 0x10001234) break;
2122 WROUTDOOR(raid_dev, 0x10001234);
2125 // wait for valid numstatus to post
2126 for (i = 0; i < 0xFFFFF; i++) {
2127 if (mbox->numstatus != 0xFF) {
2128 nstatus = mbox->numstatus;
2133 mbox->numstatus = 0xFF;
2135 adapter->outstanding_cmds -= nstatus;
2137 for (i = 0; i < nstatus; i++) {
2139 // wait for valid command index to post
2140 for (j = 0; j < 0xFFFFF; j++) {
2141 if (mbox->completed[i] != 0xFF) break;
2144 completed[i] = mbox->completed[i];
2145 mbox->completed[i] = 0xFF;
2147 if (completed[i] == 0xFF) {
2148 con_log(CL_ANN, (KERN_CRIT
2149 "megaraid: command posting timed out\n"));
2155 // Get SCB associated with this command id
2156 if (completed[i] >= MBOX_MAX_SCSI_CMDS) {
2158 scb = adapter->uscb_list + (completed[i] -
2159 MBOX_MAX_SCSI_CMDS);
2163 scb = adapter->kscb_list + completed[i];
2166 scb->status = mbox->status;
2167 list_add_tail(&scb->list, &clist);
2170 // Acknowledge interrupt
2171 WRINDOOR(raid_dev, 0x02);
2175 spin_unlock_irqrestore(MAILBOX_LOCK(raid_dev), flags);
2178 // put the completed commands in the completed list. DPC would
2179 // complete these commands later
2180 spin_lock_irqsave(COMPLETED_LIST_LOCK(adapter), flags);
2182 list_splice(&clist, &adapter->completed_list);
2184 spin_unlock_irqrestore(COMPLETED_LIST_LOCK(adapter), flags);
2187 // schedule the DPC if there is some work for it
2189 tasklet_schedule(&adapter->dpc_h);
2196 * megaraid_isr - isr for memory based mailbox based controllers
2198 * @devp - pointer to our soft state
2201 * Interrupt service routine for memory-mapped mailbox controllers.
2204 megaraid_isr(int irq, void *devp, struct pt_regs *regs)
2206 adapter_t *adapter = devp;
2209 handled = megaraid_ack_sequence(adapter);
2211 /* Loop through any pending requests */
2212 if (!adapter->quiescent) {
2213 megaraid_mbox_runpendq(adapter, NULL);
2216 return IRQ_RETVAL(handled);
2221 * megaraid_mbox_sync_scb - sync kernel buffers
2222 * @adapter : controller's soft state
2223 * @scb : pointer to the resource packet
2225 * DMA sync if required.
2228 megaraid_mbox_sync_scb(adapter_t *adapter, scb_t *scb)
2232 ccb = (mbox_ccb_t *)scb->ccb;
2234 switch (scb->dma_type) {
2236 case MRAID_DMA_WBUF:
2237 if (scb->dma_direction == PCI_DMA_FROMDEVICE) {
2238 pci_dma_sync_single_for_cpu(adapter->pdev,
2240 scb->scp->request_bufflen,
2241 PCI_DMA_FROMDEVICE);
2244 pci_unmap_page(adapter->pdev, ccb->buf_dma_h,
2245 scb->scp->request_bufflen, scb->dma_direction);
2250 if (scb->dma_direction == PCI_DMA_FROMDEVICE) {
2251 pci_dma_sync_sg_for_cpu(adapter->pdev,
2252 scb->scp->request_buffer,
2253 scb->scp->use_sg, PCI_DMA_FROMDEVICE);
2256 pci_unmap_sg(adapter->pdev, scb->scp->request_buffer,
2257 scb->scp->use_sg, scb->dma_direction);
2270 * megaraid_mbox_dpc - the tasklet to complete the commands from completed list
2271 * @devp : pointer to HBA soft state
2273 * Pick up the commands from the completed list and send back to the owners.
2274 * This is a reentrant function and does not assume any locks are held while
2275 * it is being called.
2278 megaraid_mbox_dpc(unsigned long devp)
2280 adapter_t *adapter = (adapter_t *)devp;
2281 mraid_device_t *raid_dev;
2282 struct list_head clist;
2283 struct scatterlist *sgl;
2286 struct scsi_cmnd *scp;
2287 mraid_passthru_t *pthru;
2288 mraid_epassthru_t *epthru;
2294 unsigned long flags;
2300 if (!adapter) return;
2302 raid_dev = ADAP2RAIDDEV(adapter);
2304 // move the SCBs from the completed list to our local list
2305 INIT_LIST_HEAD(&clist);
2307 spin_lock_irqsave(COMPLETED_LIST_LOCK(adapter), flags);
2309 list_splice_init(&adapter->completed_list, &clist);
2311 spin_unlock_irqrestore(COMPLETED_LIST_LOCK(adapter), flags);
2314 list_for_each_entry_safe(scb, tmp, &clist, list) {
2316 status = scb->status;
2318 ccb = (mbox_ccb_t *)scb->ccb;
2320 epthru = ccb->epthru;
2323 // Make sure f/w has completed a valid command
2324 if (scb->state != SCB_ISSUED) {
2325 con_log(CL_ANN, (KERN_CRIT
2326 "megaraid critical err: invalid command %d:%d:%p\n",
2327 scb->sno, scb->state, scp));
2329 continue; // Must never happen!
2332 // check for the management command and complete it right away
2333 if (scb->sno >= MBOX_MAX_SCSI_CMDS) {
2334 scb->state = SCB_FREE;
2335 scb->status = status;
2337 // remove from local clist
2338 list_del_init(&scb->list);
2340 kioc = (uioc_t *)scb->gp;
2343 megaraid_mbox_mm_done(adapter, scb);
2348 // Was an abort issued for this command earlier
2349 if (scb->state & SCB_ABORT) {
2350 con_log(CL_ANN, (KERN_NOTICE
2351 "megaraid: aborted cmd %lx[%x] completed\n",
2352 scp->serial_number, scb->sno));
2356 * If the inquiry came of a disk drive which is not part of
2357 * any RAID array, expose it to the kernel. For this to be
2358 * enabled, user must set the "megaraid_expose_unconf_disks"
2359 * flag to 1 by specifying it on module parameter list.
2360 * This would enable data migration off drives from other
2363 islogical = MRAID_IS_LOGICAL(adapter, scp);
2364 if (scp->cmnd[0] == INQUIRY && status == 0 && islogical == 0
2365 && IS_RAID_CH(raid_dev, scb->dev_channel)) {
2368 sgl = (struct scatterlist *)
2369 scp->request_buffer;
2372 c = *(unsigned char *)
2373 (page_address((&sgl[0])->page) +
2377 con_log(CL_ANN, (KERN_WARNING
2378 "megaraid mailbox: invalid sg:%d\n",
2384 c = *(uint8_t *)scp->request_buffer;
2387 if ((c & 0x1F ) == TYPE_DISK) {
2388 pdev_index = (scb->dev_channel * 16) +
2391 raid_dev->pdrv_state[pdev_index] & 0x0F;
2393 if (pdev_state == PDRV_ONLINE ||
2394 pdev_state == PDRV_FAILED ||
2395 pdev_state == PDRV_RBLD ||
2396 pdev_state == PDRV_HOTSPARE ||
2397 megaraid_expose_unconf_disks == 0) {
2404 // Convert MegaRAID status to Linux error code
2409 scp->result = (DID_OK << 16);
2414 /* set sense_buffer and result fields */
2415 if (mbox->cmd == MBOXCMD_PASSTHRU ||
2416 mbox->cmd == MBOXCMD_PASSTHRU64) {
2418 memcpy(scp->sense_buffer, pthru->reqsensearea,
2421 scp->result = DRIVER_SENSE << 24 |
2422 DID_OK << 16 | CHECK_CONDITION << 1;
2425 if (mbox->cmd == MBOXCMD_EXTPTHRU) {
2427 memcpy(scp->sense_buffer,
2428 epthru->reqsensearea, 14);
2430 scp->result = DRIVER_SENSE << 24 |
2432 CHECK_CONDITION << 1;
2434 scp->sense_buffer[0] = 0x70;
2435 scp->sense_buffer[2] = ABORTED_COMMAND;
2436 scp->result = CHECK_CONDITION << 1;
2443 scp->result = DID_BUS_BUSY << 16 | status;
2449 * If TEST_UNIT_READY fails, we know RESERVATION_STATUS
2452 if (scp->cmnd[0] == TEST_UNIT_READY) {
2453 scp->result = DID_ERROR << 16 |
2454 RESERVATION_CONFLICT << 1;
2458 * Error code returned is 1 if Reserve or Release
2459 * failed or the input parameter is invalid
2461 if (status == 1 && (scp->cmnd[0] == RESERVE ||
2462 scp->cmnd[0] == RELEASE)) {
2464 scp->result = DID_ERROR << 16 |
2465 RESERVATION_CONFLICT << 1;
2468 scp->result = DID_BAD_TARGET << 16 | status;
2472 // print a debug message for all failed commands
2474 megaraid_mbox_display_scb(adapter, scb);
2477 // Free our internal resources and call the mid-layer callback
2479 megaraid_mbox_sync_scb(adapter, scb);
2481 // remove from local clist
2482 list_del_init(&scb->list);
2484 // put back in free list
2485 megaraid_dealloc_scb(adapter, scb);
2487 // send the scsi packet back to kernel
2488 scp->scsi_done(scp);
2496 * megaraid_abort_handler - abort the scsi command
2497 * @scp : command to be aborted
2499 * Abort a previous SCSI request. Only commands on the pending list can be
2500 * aborted. All the commands issued to the F/W must complete.
2503 megaraid_abort_handler(struct scsi_cmnd *scp)
2506 mraid_device_t *raid_dev;
2510 unsigned long flags;
2514 adapter = SCP2ADAPTER(scp);
2515 raid_dev = ADAP2RAIDDEV(adapter);
2517 con_log(CL_ANN, (KERN_WARNING
2518 "megaraid: aborting-%ld cmd=%x <c=%d t=%d l=%d>\n",
2519 scp->serial_number, scp->cmnd[0], SCP2CHANNEL(scp),
2520 SCP2TARGET(scp), SCP2LUN(scp)));
2522 // If FW has stopped responding, simply return failure
2523 if (raid_dev->hw_error) {
2524 con_log(CL_ANN, (KERN_NOTICE
2525 "megaraid: hw error, not aborting\n"));
2529 // There might a race here, where the command was completed by the
2530 // firmware and now it is on the completed list. Before we could
2531 // complete the command to the kernel in dpc, the abort came.
2532 // Find out if this is the case to avoid the race.
2534 spin_lock_irqsave(COMPLETED_LIST_LOCK(adapter), flags);
2535 list_for_each_entry_safe(scb, tmp, &adapter->completed_list, list) {
2537 if (scb->scp == scp) { // Found command
2539 list_del_init(&scb->list); // from completed list
2541 con_log(CL_ANN, (KERN_WARNING
2542 "megaraid: %ld:%d[%d:%d], abort from completed list\n",
2543 scp->serial_number, scb->sno,
2544 scb->dev_channel, scb->dev_target));
2546 scp->result = (DID_ABORT << 16);
2547 scp->scsi_done(scp);
2549 megaraid_dealloc_scb(adapter, scb);
2551 spin_unlock_irqrestore(COMPLETED_LIST_LOCK(adapter),
2557 spin_unlock_irqrestore(COMPLETED_LIST_LOCK(adapter), flags);
2560 // Find out if this command is still on the pending list. If it is and
2561 // was never issued, abort and return success. If the command is owned
2562 // by the firmware, we must wait for it to complete by the FW.
2563 spin_lock_irqsave(PENDING_LIST_LOCK(adapter), flags);
2564 list_for_each_entry_safe(scb, tmp, &adapter->pend_list, list) {
2566 if (scb->scp == scp) { // Found command
2568 list_del_init(&scb->list); // from pending list
2570 ASSERT(!(scb->state & SCB_ISSUED));
2572 con_log(CL_ANN, (KERN_WARNING
2573 "megaraid abort: %ld[%d:%d], driver owner\n",
2574 scp->serial_number, scb->dev_channel,
2577 scp->result = (DID_ABORT << 16);
2578 scp->scsi_done(scp);
2580 megaraid_dealloc_scb(adapter, scb);
2582 spin_unlock_irqrestore(PENDING_LIST_LOCK(adapter),
2588 spin_unlock_irqrestore(PENDING_LIST_LOCK(adapter), flags);
2591 // Check do we even own this command, in which case this would be
2592 // owned by the firmware. The only way to locate the FW scb is to
2593 // traverse through the list of all SCB, since driver does not
2594 // maintain these SCBs on any list
2596 spin_lock_irq(&adapter->lock);
2597 for (i = 0; i < MBOX_MAX_SCSI_CMDS; i++) {
2598 scb = adapter->kscb_list + i;
2600 if (scb->scp == scp) {
2604 if (!(scb->state & SCB_ISSUED)) {
2605 con_log(CL_ANN, (KERN_WARNING
2606 "megaraid abort: %ld%d[%d:%d], invalid state\n",
2607 scp->serial_number, scb->sno, scb->dev_channel,
2612 con_log(CL_ANN, (KERN_WARNING
2613 "megaraid abort: %ld:%d[%d:%d], fw owner\n",
2614 scp->serial_number, scb->sno, scb->dev_channel,
2619 spin_unlock_irq(&adapter->lock);
2622 con_log(CL_ANN, (KERN_WARNING
2623 "megaraid abort: scsi cmd:%ld, do now own\n",
2624 scp->serial_number));
2626 // FIXME: Should there be a callback for this command?
2630 // We cannot actually abort a command owned by firmware, return
2631 // failure and wait for reset. In host reset handler, we will find out
2632 // if the HBA is still live
2637 * megaraid_reset_handler - device reset hadler for mailbox based driver
2638 * @scp : reference command
2640 * Reset handler for the mailbox based controller. First try to find out if
2641 * the FW is still live, in which case the outstanding commands counter mut go
2642 * down to 0. If that happens, also issue the reservation reset command to
2643 * relinquish (possible) reservations on the logical drives connected to this
2647 megaraid_reset_handler(struct scsi_cmnd *scp)
2652 mraid_device_t *raid_dev;
2653 unsigned long flags;
2654 uint8_t raw_mbox[sizeof(mbox_t)];
2656 int recovery_window;
2661 adapter = SCP2ADAPTER(scp);
2662 raid_dev = ADAP2RAIDDEV(adapter);
2664 // return failure if adapter is not responding
2665 if (raid_dev->hw_error) {
2666 con_log(CL_ANN, (KERN_NOTICE
2667 "megaraid: hw error, cannot reset\n"));
2672 // Under exceptional conditions, FW can take up to 3 minutes to
2673 // complete command processing. Wait for additional 2 minutes for the
2674 // pending commands counter to go down to 0. If it doesn't, let the
2675 // controller be marked offline
2676 // Also, reset all the commands currently owned by the driver
2677 spin_lock_irqsave(PENDING_LIST_LOCK(adapter), flags);
2678 list_for_each_entry_safe(scb, tmp, &adapter->pend_list, list) {
2679 list_del_init(&scb->list); // from pending list
2681 if (scb->sno >= MBOX_MAX_SCSI_CMDS) {
2682 con_log(CL_ANN, (KERN_WARNING
2683 "megaraid: IOCTL packet with %d[%d:%d] being reset\n",
2684 scb->sno, scb->dev_channel, scb->dev_target));
2688 kioc = (uioc_t *)scb->gp;
2689 kioc->status = -EFAULT;
2691 megaraid_mbox_mm_done(adapter, scb);
2693 if (scb->scp == scp) { // Found command
2694 con_log(CL_ANN, (KERN_WARNING
2695 "megaraid: %ld:%d[%d:%d], reset from pending list\n",
2696 scp->serial_number, scb->sno,
2697 scb->dev_channel, scb->dev_target));
2699 con_log(CL_ANN, (KERN_WARNING
2700 "megaraid: IO packet with %d[%d:%d] being reset\n",
2701 scb->sno, scb->dev_channel, scb->dev_target));
2704 scb->scp->result = (DID_RESET << 16);
2705 scb->scp->scsi_done(scb->scp);
2707 megaraid_dealloc_scb(adapter, scb);
2710 spin_unlock_irqrestore(PENDING_LIST_LOCK(adapter), flags);
2712 if (adapter->outstanding_cmds) {
2713 con_log(CL_ANN, (KERN_NOTICE
2714 "megaraid: %d outstanding commands. Max wait %d sec\n",
2715 adapter->outstanding_cmds,
2716 (MBOX_RESET_WAIT + MBOX_RESET_EXT_WAIT)));
2719 recovery_window = MBOX_RESET_WAIT + MBOX_RESET_EXT_WAIT;
2721 recovering = adapter->outstanding_cmds;
2723 for (i = 0; i < recovery_window; i++) {
2725 megaraid_ack_sequence(adapter);
2727 // print a message once every 5 seconds only
2730 "megaraid mbox: Wait for %d commands to complete:%d\n",
2731 adapter->outstanding_cmds,
2732 (MBOX_RESET_WAIT + MBOX_RESET_EXT_WAIT) - i));
2735 // bailout if no recovery happended in reset time
2736 if (adapter->outstanding_cmds == 0) {
2743 spin_lock(&adapter->lock);
2745 // If still outstanding commands, bail out
2746 if (adapter->outstanding_cmds) {
2747 con_log(CL_ANN, (KERN_WARNING
2748 "megaraid mbox: critical hardware error!\n"));
2750 raid_dev->hw_error = 1;
2756 con_log(CL_ANN, (KERN_NOTICE
2757 "megaraid mbox: reset sequence completed sucessfully\n"));
2761 // If the controller supports clustering, reset reservations
2767 // clear reservations if any
2768 raw_mbox[0] = CLUSTER_CMD;
2769 raw_mbox[2] = RESET_RESERVATIONS;
2772 if (mbox_post_sync_cmd_fast(adapter, raw_mbox) == 0) {
2774 (KERN_INFO "megaraid: reservation reset\n"));
2778 con_log(CL_ANN, (KERN_WARNING
2779 "megaraid: reservation reset failed\n"));
2783 spin_unlock_irq(&adapter->lock);
2788 * START: internal commands library
2790 * This section of the driver has the common routine used by the driver and
2791 * also has all the FW routines
2795 * mbox_post_sync_cmd() - blocking command to the mailbox based controllers
2796 * @adapter - controller's soft state
2797 * @raw_mbox - the mailbox
2799 * Issue a scb in synchronous and non-interrupt mode for mailbox based
2803 mbox_post_sync_cmd(adapter_t *adapter, uint8_t raw_mbox[])
2805 mraid_device_t *raid_dev = ADAP2RAIDDEV(adapter);
2812 mbox64 = raid_dev->mbox64;
2813 mbox = raid_dev->mbox;
2816 * Wait until mailbox is free
2818 if (megaraid_busywait_mbox(raid_dev) != 0)
2819 goto blocked_mailbox;
2822 * Copy mailbox data into host structure
2824 memcpy((caddr_t)mbox, (caddr_t)raw_mbox, 16);
2829 mbox->numstatus = 0xFF;
2830 mbox->status = 0xFF;
2833 WRINDOOR(raid_dev, raid_dev->mbox_dma | 0x1);
2835 // wait for maximum 1 second for status to post. If the status is not
2836 // available within 1 second, assume FW is initializing and wait
2837 // for an extended amount of time
2838 if (mbox->numstatus == 0xFF) { // status not yet available
2841 for (i = 0; mbox->numstatus == 0xFF && i < 1000; i++) {
2848 con_log(CL_ANN, (KERN_NOTICE
2849 "megaraid mailbox: wait for FW to boot "));
2851 for (i = 0; (mbox->numstatus == 0xFF) &&
2852 (i < MBOX_RESET_WAIT); i++) {
2854 con_log(CL_ANN, ("\b\b\b\b\b[%03d]",
2855 MBOX_RESET_WAIT - i));
2859 if (i == MBOX_RESET_WAIT) {
2862 "\nmegaraid mailbox: status not available\n"));
2866 con_log(CL_ANN, ("\b\b\b\b\b[ok] \n"));
2870 // wait for maximum 1 second for poll semaphore
2871 if (mbox->poll != 0x77) {
2874 for (i = 0; (mbox->poll != 0x77) && (i < 1000); i++) {
2880 con_log(CL_ANN, (KERN_WARNING
2881 "megaraid mailbox: could not get poll semaphore\n"));
2886 WRINDOOR(raid_dev, raid_dev->mbox_dma | 0x2);
2889 // wait for maximum 1 second for acknowledgement
2890 if (RDINDOOR(raid_dev) & 0x2) {
2893 for (i = 0; (RDINDOOR(raid_dev) & 0x2) && (i < 1000); i++) {
2899 con_log(CL_ANN, (KERN_WARNING
2900 "megaraid mailbox: could not acknowledge\n"));
2907 status = mbox->status;
2909 // invalidate the completed command id array. After command
2910 // completion, firmware would write the valid id.
2911 mbox->numstatus = 0xFF;
2912 mbox->status = 0xFF;
2913 for (i = 0; i < MBOX_MAX_FIRMWARE_STATUS; i++) {
2914 mbox->completed[i] = 0xFF;
2921 con_log(CL_ANN, (KERN_WARNING "megaraid: blocked mailbox\n") );
2927 * mbox_post_sync_cmd_fast - blocking command to the mailbox based controllers
2928 * @adapter - controller's soft state
2929 * @raw_mbox - the mailbox
2931 * Issue a scb in synchronous and non-interrupt mode for mailbox based
2932 * controllers. This is a faster version of the synchronous command and
2933 * therefore can be called in interrupt-context as well
2936 mbox_post_sync_cmd_fast(adapter_t *adapter, uint8_t raw_mbox[])
2938 mraid_device_t *raid_dev = ADAP2RAIDDEV(adapter);
2943 mbox = raid_dev->mbox;
2945 // return immediately if the mailbox is busy
2946 if (mbox->busy) return -1;
2948 // Copy mailbox data into host structure
2949 memcpy((caddr_t)mbox, (caddr_t)raw_mbox, 14);
2954 mbox->numstatus = 0xFF;
2955 mbox->status = 0xFF;
2958 WRINDOOR(raid_dev, raid_dev->mbox_dma | 0x1);
2960 for (i = 0; i < MBOX_SYNC_WAIT_CNT; i++) {
2961 if (mbox->numstatus != 0xFF) break;
2963 udelay(MBOX_SYNC_DELAY_200);
2966 if (i == MBOX_SYNC_WAIT_CNT) {
2967 // We may need to re-calibrate the counter
2968 con_log(CL_ANN, (KERN_CRIT
2969 "megaraid: fast sync command timed out\n"));
2972 WRINDOOR(raid_dev, raid_dev->mbox_dma | 0x2);
2975 return mbox->status;
2980 * megaraid_busywait_mbox() - Wait until the controller's mailbox is available
2981 * @raid_dev - RAID device (HBA) soft state
2983 * wait until the controller's mailbox is available to accept more commands.
2984 * wait for at most 1 second
2987 megaraid_busywait_mbox(mraid_device_t *raid_dev)
2989 mbox_t *mbox = raid_dev->mbox;
2994 for (i = 0; mbox->busy && i < 1000; i++)
2998 if (i < 1000) return 0;
3004 * megaraid_mbox_product_info - some static information about the controller
3005 * @adapter - our soft state
3007 * issue commands to the controller to grab some parameters required by our
3011 megaraid_mbox_product_info(adapter_t *adapter)
3013 mraid_device_t *raid_dev = ADAP2RAIDDEV(adapter);
3015 uint8_t raw_mbox[sizeof(mbox_t)];
3016 mraid_pinfo_t *pinfo;
3017 dma_addr_t pinfo_dma_h;
3018 mraid_inquiry3_t *mraid_inq3;
3022 memset((caddr_t)raw_mbox, 0, sizeof(raw_mbox));
3023 mbox = (mbox_t *)raw_mbox;
3026 * Issue an ENQUIRY3 command to find out certain adapter parameters,
3027 * e.g., max channels, max commands etc.
3029 pinfo = pci_alloc_consistent(adapter->pdev, sizeof(mraid_pinfo_t),
3032 if (pinfo == NULL) {
3033 con_log(CL_ANN, (KERN_WARNING
3034 "megaraid: out of memory, %s %d\n", __FUNCTION__,
3039 memset(pinfo, 0, sizeof(mraid_pinfo_t));
3041 mbox->xferaddr = (uint32_t)adapter->ibuf_dma_h;
3042 memset((void *)adapter->ibuf, 0, MBOX_IBUF_SIZE);
3044 raw_mbox[0] = FC_NEW_CONFIG;
3045 raw_mbox[2] = NC_SUBOP_ENQUIRY3;
3046 raw_mbox[3] = ENQ3_GET_SOLICITED_FULL;
3048 // Issue the command
3049 if (mbox_post_sync_cmd(adapter, raw_mbox) != 0) {
3051 con_log(CL_ANN, (KERN_WARNING "megaraid: Inquiry3 failed\n"));
3053 pci_free_consistent(adapter->pdev, sizeof(mraid_pinfo_t),
3054 pinfo, pinfo_dma_h);
3060 * Collect information about state of each physical drive
3061 * attached to the controller. We will expose all the disks
3062 * which are not part of RAID
3064 mraid_inq3 = (mraid_inquiry3_t *)adapter->ibuf;
3065 for (i = 0; i < MBOX_MAX_PHYSICAL_DRIVES; i++) {
3066 raid_dev->pdrv_state[i] = mraid_inq3->pdrv_state[i];
3070 * Get product info for information like number of channels,
3071 * maximum commands supported.
3073 memset((caddr_t)raw_mbox, 0, sizeof(raw_mbox));
3074 mbox->xferaddr = (uint32_t)pinfo_dma_h;
3076 raw_mbox[0] = FC_NEW_CONFIG;
3077 raw_mbox[2] = NC_SUBOP_PRODUCT_INFO;
3079 if (mbox_post_sync_cmd(adapter, raw_mbox) != 0) {
3081 con_log(CL_ANN, (KERN_WARNING
3082 "megaraid: product info failed\n"));
3084 pci_free_consistent(adapter->pdev, sizeof(mraid_pinfo_t),
3085 pinfo, pinfo_dma_h);
3091 * Setup some parameters for host, as required by our caller
3093 adapter->max_channel = pinfo->nchannels;
3096 * we will export all the logical drives on a single channel.
3097 * Add 1 since inquires do not come for inititor ID
3099 adapter->max_target = MAX_LOGICAL_DRIVES_40LD + 1;
3100 adapter->max_lun = 8; // up to 8 LUNs for non-disk devices
3103 * These are the maximum outstanding commands for the scsi-layer
3105 adapter->max_cmds = MBOX_MAX_SCSI_CMDS;
3107 memset(adapter->fw_version, 0, VERSION_SIZE);
3108 memset(adapter->bios_version, 0, VERSION_SIZE);
3110 memcpy(adapter->fw_version, pinfo->fw_version, 4);
3111 adapter->fw_version[4] = 0;
3113 memcpy(adapter->bios_version, pinfo->bios_version, 4);
3114 adapter->bios_version[4] = 0;
3116 con_log(CL_ANN, (KERN_NOTICE
3117 "megaraid: fw version:[%s] bios version:[%s]\n",
3118 adapter->fw_version, adapter->bios_version));
3120 pci_free_consistent(adapter->pdev, sizeof(mraid_pinfo_t), pinfo,
3129 * megaraid_mbox_extended_cdb - check for support for extended CDBs
3130 * @adapter - soft state for the controller
3132 * this routine check whether the controller in question supports extended
3133 * ( > 10 bytes ) CDBs
3136 megaraid_mbox_extended_cdb(adapter_t *adapter)
3139 uint8_t raw_mbox[sizeof(mbox_t)];
3142 mbox = (mbox_t *)raw_mbox;
3144 memset((caddr_t)raw_mbox, 0, sizeof(raw_mbox));
3145 mbox->xferaddr = (uint32_t)adapter->ibuf_dma_h;
3147 memset((void *)adapter->ibuf, 0, MBOX_IBUF_SIZE);
3149 raw_mbox[0] = MAIN_MISC_OPCODE;
3150 raw_mbox[2] = SUPPORT_EXT_CDB;
3156 if (mbox_post_sync_cmd(adapter, raw_mbox) != 0) {
3165 * megaraid_mbox_support_ha - Do we support clustering
3166 * @adapter - soft state for the controller
3167 * @init_id - ID of the initiator
3169 * Determine if the firmware supports clustering and the ID of the initiator.
3172 megaraid_mbox_support_ha(adapter_t *adapter, uint16_t *init_id)
3175 uint8_t raw_mbox[sizeof(mbox_t)];
3179 mbox = (mbox_t *)raw_mbox;
3181 memset((caddr_t)raw_mbox, 0, sizeof(raw_mbox));
3183 mbox->xferaddr = (uint32_t)adapter->ibuf_dma_h;
3185 memset((void *)adapter->ibuf, 0, MBOX_IBUF_SIZE);
3187 raw_mbox[0] = GET_TARGET_ID;
3189 // Issue the command
3192 if (mbox_post_sync_cmd(adapter, raw_mbox) == 0) {
3194 *init_id = *(uint8_t *)adapter->ibuf;
3196 con_log(CL_ANN, (KERN_INFO
3197 "megaraid: cluster firmware, initiator ID: %d\n",
3208 * megaraid_mbox_support_random_del - Do we support random deletion
3209 * @adapter - soft state for the controller
3211 * Determine if the firmware supports random deletion
3212 * Return: 1 is operation supported, 0 otherwise
3215 megaraid_mbox_support_random_del(adapter_t *adapter)
3218 uint8_t raw_mbox[sizeof(mbox_t)];
3222 mbox = (mbox_t *)raw_mbox;
3224 memset((caddr_t)raw_mbox, 0, sizeof(mbox_t));
3226 raw_mbox[0] = FC_DEL_LOGDRV;
3227 raw_mbox[2] = OP_SUP_DEL_LOGDRV;
3229 // Issue the command
3231 if (mbox_post_sync_cmd(adapter, raw_mbox) == 0) {
3233 con_log(CL_DLEVEL1, ("megaraid: supports random deletion\n"));
3243 * megaraid_mbox_get_max_sg - maximum sg elements supported by the firmware
3244 * @adapter - soft state for the controller
3246 * Find out the maximum number of scatter-gather elements supported by the
3250 megaraid_mbox_get_max_sg(adapter_t *adapter)
3253 uint8_t raw_mbox[sizeof(mbox_t)];
3257 mbox = (mbox_t *)raw_mbox;
3259 memset((caddr_t)raw_mbox, 0, sizeof(mbox_t));
3261 mbox->xferaddr = (uint32_t)adapter->ibuf_dma_h;
3263 memset((void *)adapter->ibuf, 0, MBOX_IBUF_SIZE);
3265 raw_mbox[0] = MAIN_MISC_OPCODE;
3266 raw_mbox[2] = GET_MAX_SG_SUPPORT;
3268 // Issue the command
3269 if (mbox_post_sync_cmd(adapter, raw_mbox) == 0) {
3270 nsg = *(uint8_t *)adapter->ibuf;
3273 nsg = MBOX_DEFAULT_SG_SIZE;
3276 if (nsg > MBOX_MAX_SG_SIZE) nsg = MBOX_MAX_SG_SIZE;
3283 * megaraid_mbox_enum_raid_scsi - enumerate the RAID and SCSI channels
3284 * @adapter - soft state for the controller
3286 * Enumerate the RAID and SCSI channels for ROMB platoforms so that channels
3287 * can be exported as regular SCSI channels
3290 megaraid_mbox_enum_raid_scsi(adapter_t *adapter)
3292 mraid_device_t *raid_dev = ADAP2RAIDDEV(adapter);
3294 uint8_t raw_mbox[sizeof(mbox_t)];
3297 mbox = (mbox_t *)raw_mbox;
3299 memset((caddr_t)raw_mbox, 0, sizeof(mbox_t));
3301 mbox->xferaddr = (uint32_t)adapter->ibuf_dma_h;
3303 memset((void *)adapter->ibuf, 0, MBOX_IBUF_SIZE);
3305 raw_mbox[0] = CHNL_CLASS;
3306 raw_mbox[2] = GET_CHNL_CLASS;
3308 // Issue the command. If the command fails, all channels are RAID
3310 raid_dev->channel_class = 0xFF;
3311 if (mbox_post_sync_cmd(adapter, raw_mbox) == 0) {
3312 raid_dev->channel_class = *(uint8_t *)adapter->ibuf;
3320 * megaraid_mbox_flush_cache - flush adapter and disks cache
3321 * @param adapter : soft state for the controller
3323 * Flush adapter cache followed by disks cache
3326 megaraid_mbox_flush_cache(adapter_t *adapter)
3329 uint8_t raw_mbox[sizeof(mbox_t)];
3332 mbox = (mbox_t *)raw_mbox;
3334 memset((caddr_t)raw_mbox, 0, sizeof(mbox_t));
3336 raw_mbox[0] = FLUSH_ADAPTER;
3338 if (mbox_post_sync_cmd(adapter, raw_mbox) != 0) {
3339 con_log(CL_ANN, ("megaraid: flush adapter failed\n"));
3342 raw_mbox[0] = FLUSH_SYSTEM;
3344 if (mbox_post_sync_cmd(adapter, raw_mbox) != 0) {
3345 con_log(CL_ANN, ("megaraid: flush disks cache failed\n"));
3353 * megaraid_mbox_display_scb - display SCB information, mostly debug purposes
3354 * @param adapter : controllers' soft state
3355 * @param scb : SCB to be displayed
3356 * @param level : debug level for console print
3358 * Diplay information about the given SCB iff the current debug level is
3362 megaraid_mbox_display_scb(adapter_t *adapter, scb_t *scb)
3365 struct scsi_cmnd *scp;
3371 ccb = (mbox_ccb_t *)scb->ccb;
3377 con_log(level, (KERN_NOTICE
3378 "megaraid mailbox: status:%#x cmd:%#x id:%#x ", scb->status,
3379 mbox->cmd, scb->sno));
3381 con_log(level, ("sec:%#x lba:%#x addr:%#x ld:%d sg:%d\n",
3382 mbox->numsectors, mbox->lba, mbox->xferaddr, mbox->logdrv,
3387 con_log(level, (KERN_NOTICE "scsi cmnd: "));
3389 for (i = 0; i < scp->cmd_len; i++) {
3390 con_log(level, ("%#2.02x ", scp->cmnd[i]));
3393 con_log(level, ("\n"));
3400 * megaraid_mbox_setup_device_map - manage device ids
3401 * @adapter : Driver's soft state
3403 * Manange the device ids to have an appropraite mapping between the kernel
3404 * scsi addresses and megaraid scsi and logical drive addresses. We export
3405 * scsi devices on their actual addresses, whereas the logical drives are
3406 * exported on a virtual scsi channel.
3409 megaraid_mbox_setup_device_map(adapter_t *adapter)
3415 * First fill the values on the logical drive channel
3417 for (t = 0; t < LSI_MAX_LOGICAL_DRIVES_64LD; t++)
3418 adapter->device_ids[adapter->max_channel][t] =
3419 (t < adapter->init_id) ? t : t - 1;
3421 adapter->device_ids[adapter->max_channel][adapter->init_id] = 0xFF;
3424 * Fill the values on the physical devices channels
3426 for (c = 0; c < adapter->max_channel; c++)
3427 for (t = 0; t < LSI_MAX_LOGICAL_DRIVES_64LD; t++)
3428 adapter->device_ids[c][t] = (c << 8) | t;
3433 * END: internal commands library
3437 * START: Interface for the common management module
3439 * This is the module, which interfaces with the common mangement module to
3440 * provide support for ioctl and sysfs
3444 * megaraid_cmm_register - register with the mangement module
3445 * @param adapter : HBA soft state
3447 * Register with the management module, which allows applications to issue
3448 * ioctl calls to the drivers. This interface is used by the management module
3449 * to setup sysfs support as well.
3452 megaraid_cmm_register(adapter_t *adapter)
3454 mraid_device_t *raid_dev = ADAP2RAIDDEV(adapter);
3461 // Allocate memory for the base list of scb for management module.
3462 adapter->uscb_list = kmalloc(sizeof(scb_t) * MBOX_MAX_USER_CMDS,
3465 if (adapter->uscb_list == NULL) {
3466 con_log(CL_ANN, (KERN_WARNING
3467 "megaraid: out of memory, %s %d\n", __FUNCTION__,
3471 memset(adapter->uscb_list, 0, sizeof(scb_t) * MBOX_MAX_USER_CMDS);
3474 // Initialize the synchronization parameters for resources for
3475 // commands for management module
3476 INIT_LIST_HEAD(&adapter->uscb_pool);
3478 spin_lock_init(USER_FREE_LIST_LOCK(adapter));
3482 // link all the packets. Note, CCB for commands, coming from the
3483 // commom management module, mailbox physical address are already
3484 // setup by it. We just need placeholder for that in our local command
3486 for (i = 0; i < MBOX_MAX_USER_CMDS; i++) {
3488 scb = adapter->uscb_list + i;
3489 ccb = raid_dev->uccb_list + i;
3491 scb->ccb = (caddr_t)ccb;
3492 ccb->mbox64 = raid_dev->umbox64 + i;
3493 ccb->mbox = &ccb->mbox64->mbox32;
3494 ccb->raw_mbox = (uint8_t *)ccb->mbox;
3498 // COMMAND ID 0 - (MBOX_MAX_SCSI_CMDS-1) ARE RESERVED FOR
3499 // COMMANDS COMING FROM IO SUBSYSTEM (MID-LAYER)
3500 scb->sno = i + MBOX_MAX_SCSI_CMDS;
3503 scb->state = SCB_FREE;
3504 scb->dma_direction = PCI_DMA_NONE;
3505 scb->dma_type = MRAID_DMA_NONE;
3506 scb->dev_channel = -1;
3507 scb->dev_target = -1;
3509 // put scb in the free pool
3510 list_add_tail(&scb->list, &adapter->uscb_pool);
3513 adp.unique_id = adapter->unique_id;
3514 adp.drvr_type = DRVRTYPE_MBOX;
3515 adp.drvr_data = (unsigned long)adapter;
3516 adp.pdev = adapter->pdev;
3517 adp.issue_uioc = megaraid_mbox_mm_handler;
3518 adp.timeout = MBOX_RESET_WAIT + MBOX_RESET_EXT_WAIT;
3519 adp.max_kioc = MBOX_MAX_USER_CMDS;
3521 if ((rval = mraid_mm_register_adp(&adp)) != 0) {
3523 con_log(CL_ANN, (KERN_WARNING
3524 "megaraid mbox: did not register with CMM\n"));
3526 kfree(adapter->uscb_list);
3534 * megaraid_cmm_unregister - un-register with the mangement module
3535 * @param adapter : HBA soft state
3537 * Un-register with the management module.
3538 * FIXME: mgmt module must return failure for unregister if it has pending
3542 megaraid_cmm_unregister(adapter_t *adapter)
3544 kfree(adapter->uscb_list);
3545 mraid_mm_unregister_adp(adapter->unique_id);
3551 * megaraid_mbox_mm_handler - interface for CMM to issue commands to LLD
3552 * @param drvr_data : LLD specific data
3553 * @param kioc : CMM interface packet
3554 * @param action : command action
3556 * This routine is invoked whenever the Common Mangement Module (CMM) has a
3557 * command for us. The 'action' parameter specifies if this is a new command
3561 megaraid_mbox_mm_handler(unsigned long drvr_data, uioc_t *kioc, uint32_t action)
3565 if (action != IOCTL_ISSUE) {
3566 con_log(CL_ANN, (KERN_WARNING
3567 "megaraid: unsupported management action:%#2x\n",
3572 adapter = (adapter_t *)drvr_data;
3574 // make sure this adapter is not being detached right now.
3575 if (atomic_read(&adapter->being_detached)) {
3576 con_log(CL_ANN, (KERN_WARNING
3577 "megaraid: reject management request, detaching\n"));
3581 switch (kioc->opcode) {
3585 kioc->status = gather_hbainfo(adapter, (mraid_hba_info_t *)
3586 (unsigned long)kioc->buf_vaddr);
3590 return kioc->status;
3594 return megaraid_mbox_mm_command(adapter, kioc);
3597 kioc->status = (-EINVAL);
3602 return 0; // not reached
3606 * megaraid_mbox_mm_command - issues commands routed through CMM
3607 * @param adapter : HBA soft state
3608 * @param kioc : management command packet
3610 * Issues commands, which are routed through the management module.
3613 megaraid_mbox_mm_command(adapter_t *adapter, uioc_t *kioc)
3615 struct list_head *head = &adapter->uscb_pool;
3620 unsigned long flags;
3622 // detach one scb from free pool
3623 spin_lock_irqsave(USER_FREE_LIST_LOCK(adapter), flags);
3625 if (list_empty(head)) { // should never happen because of CMM
3627 con_log(CL_ANN, (KERN_WARNING
3628 "megaraid mbox: bug in cmm handler, lost resources\n"));
3630 spin_unlock_irqrestore(USER_FREE_LIST_LOCK(adapter), flags);
3635 scb = list_entry(head->next, scb_t, list);
3636 list_del_init(&scb->list);
3638 spin_unlock_irqrestore(USER_FREE_LIST_LOCK(adapter), flags);
3640 scb->state = SCB_ACTIVE;
3641 scb->dma_type = MRAID_DMA_NONE;
3642 scb->dma_direction = PCI_DMA_NONE;
3644 ccb = (mbox_ccb_t *)scb->ccb;
3645 mbox64 = (mbox64_t *)(unsigned long)kioc->cmdbuf;
3646 raw_mbox = (uint8_t *)&mbox64->mbox32;
3648 memcpy(ccb->mbox64, mbox64, sizeof(mbox64_t));
3650 scb->gp = (unsigned long)kioc;
3653 * If it is a logdrv random delete operation, we have to wait till
3654 * there are no outstanding cmds at the fw and then issue it directly
3656 if (raw_mbox[0] == FC_DEL_LOGDRV && raw_mbox[2] == OP_DEL_LOGDRV) {
3658 if (wait_till_fw_empty(adapter)) {
3659 con_log(CL_ANN, (KERN_NOTICE
3660 "megaraid mbox: LD delete, timed out\n"));
3662 kioc->status = -ETIME;
3666 megaraid_mbox_mm_done(adapter, scb);
3671 INIT_LIST_HEAD(&scb->list);
3673 scb->state = SCB_ISSUED;
3674 if (mbox_post_cmd(adapter, scb) != 0) {
3676 con_log(CL_ANN, (KERN_NOTICE
3677 "megaraid mbox: LD delete, mailbox busy\n"));
3679 kioc->status = -EBUSY;
3683 megaraid_mbox_mm_done(adapter, scb);
3691 // put the command on the pending list and execute
3692 megaraid_mbox_runpendq(adapter, scb);
3699 wait_till_fw_empty(adapter_t *adapter)
3701 unsigned long flags = 0;
3706 * Set the quiescent flag to stop issuing cmds to FW.
3708 spin_lock_irqsave(&adapter->lock, flags);
3709 adapter->quiescent++;
3710 spin_unlock_irqrestore(&adapter->lock, flags);
3713 * Wait till there are no more cmds outstanding at FW. Try for at most
3716 for (i = 0; i < 60 && adapter->outstanding_cmds; i++) {
3717 con_log(CL_DLEVEL1, (KERN_INFO
3718 "megaraid: FW has %d pending commands\n",
3719 adapter->outstanding_cmds));
3724 return adapter->outstanding_cmds;
3729 * megaraid_mbox_mm_done - callback for CMM commands
3730 * @adapter : HBA soft state
3731 * @scb : completed command
3733 * Callback routine for internal commands originated from the management
3737 megaraid_mbox_mm_done(adapter_t *adapter, scb_t *scb)
3742 unsigned long flags;
3744 kioc = (uioc_t *)scb->gp;
3745 mbox64 = (mbox64_t *)(unsigned long)kioc->cmdbuf;
3746 mbox64->mbox32.status = scb->status;
3747 raw_mbox = (uint8_t *)&mbox64->mbox32;
3750 // put scb in the free pool
3751 scb->state = SCB_FREE;
3754 spin_lock_irqsave(USER_FREE_LIST_LOCK(adapter), flags);
3756 list_add(&scb->list, &adapter->uscb_pool);
3758 spin_unlock_irqrestore(USER_FREE_LIST_LOCK(adapter), flags);
3760 // if a delete logical drive operation succeeded, restart the
3762 if (raw_mbox[0] == FC_DEL_LOGDRV && raw_mbox[2] == OP_DEL_LOGDRV) {
3764 adapter->quiescent--;
3766 megaraid_mbox_runpendq(adapter, NULL);
3776 * gather_hbainfo - HBA characteristics for the applications
3777 * @param adapter : HBA soft state
3778 * @param hinfo : pointer to the caller's host info strucuture
3781 gather_hbainfo(adapter_t *adapter, mraid_hba_info_t *hinfo)
3785 dmajor = megaraid_mbox_version[0];
3787 hinfo->pci_vendor_id = adapter->pdev->vendor;
3788 hinfo->pci_device_id = adapter->pdev->device;
3789 hinfo->subsys_vendor_id = adapter->pdev->subsystem_vendor;
3790 hinfo->subsys_device_id = adapter->pdev->subsystem_device;
3792 hinfo->pci_bus = adapter->pdev->bus->number;
3793 hinfo->pci_dev_fn = adapter->pdev->devfn;
3794 hinfo->pci_slot = PCI_SLOT(adapter->pdev->devfn);
3795 hinfo->irq = adapter->host->irq;
3796 hinfo->baseport = ADAP2RAIDDEV(adapter)->baseport;
3798 hinfo->unique_id = (hinfo->pci_bus << 8) | adapter->pdev->devfn;
3799 hinfo->host_no = adapter->host->host_no;
3805 * END: Interface for the common management module
3811 * megaraid_sysfs_alloc_resources - allocate sysfs related resources
3813 * Allocate packets required to issue FW calls whenever the sysfs attributes
3814 * are read. These attributes would require up-to-date information from the
3815 * FW. Also set up resources for mutual exclusion to share these resources and
3818 * @param adapter : controller's soft state
3820 * @return 0 on success
3821 * @return -ERROR_CODE on failure
3824 megaraid_sysfs_alloc_resources(adapter_t *adapter)
3826 mraid_device_t *raid_dev = ADAP2RAIDDEV(adapter);
3829 raid_dev->sysfs_uioc = kmalloc(sizeof(uioc_t), GFP_KERNEL);
3831 raid_dev->sysfs_mbox64 = kmalloc(sizeof(mbox64_t), GFP_KERNEL);
3833 raid_dev->sysfs_buffer = pci_alloc_consistent(adapter->pdev,
3834 PAGE_SIZE, &raid_dev->sysfs_buffer_dma);
3836 if (!raid_dev->sysfs_uioc || !raid_dev->sysfs_mbox64 ||
3837 !raid_dev->sysfs_buffer) {
3839 con_log(CL_ANN, (KERN_WARNING
3840 "megaraid: out of memory, %s %d\n", __FUNCTION__,
3845 megaraid_sysfs_free_resources(adapter);
3848 sema_init(&raid_dev->sysfs_sem, 1);
3850 init_waitqueue_head(&raid_dev->sysfs_wait_q);
3857 * megaraid_sysfs_free_resources - free sysfs related resources
3859 * Free packets allocated for sysfs FW commands
3861 * @param adapter : controller's soft state
3864 megaraid_sysfs_free_resources(adapter_t *adapter)
3866 mraid_device_t *raid_dev = ADAP2RAIDDEV(adapter);
3868 kfree(raid_dev->sysfs_uioc);
3869 kfree(raid_dev->sysfs_mbox64);
3871 if (raid_dev->sysfs_buffer) {
3872 pci_free_consistent(adapter->pdev, PAGE_SIZE,
3873 raid_dev->sysfs_buffer, raid_dev->sysfs_buffer_dma);
3879 * megaraid_sysfs_get_ldmap_done - callback for get ldmap
3881 * Callback routine called in the ISR/tasklet context for get ldmap call
3883 * @param uioc : completed packet
3886 megaraid_sysfs_get_ldmap_done(uioc_t *uioc)
3888 adapter_t *adapter = (adapter_t *)uioc->buf_vaddr;
3889 mraid_device_t *raid_dev = ADAP2RAIDDEV(adapter);
3893 wake_up(&raid_dev->sysfs_wait_q);
3898 * megaraid_sysfs_get_ldmap_timeout - timeout handling for get ldmap
3900 * Timeout routine to recover and return to application, in case the adapter
3901 * has stopped responding. A timeout of 60 seconds for this command seem like
3904 * @param uioc : timed out packet
3907 megaraid_sysfs_get_ldmap_timeout(unsigned long data)
3909 uioc_t *uioc = (uioc_t *)data;
3910 adapter_t *adapter = (adapter_t *)uioc->buf_vaddr;
3911 mraid_device_t *raid_dev = ADAP2RAIDDEV(adapter);
3913 uioc->status = -ETIME;
3915 wake_up(&raid_dev->sysfs_wait_q);
3920 * megaraid_sysfs_get_ldmap - get update logical drive map
3922 * This routine will be called whenever user reads the logical drive
3923 * attributes, go get the current logical drive mapping table from the
3924 * firmware. We use the managment API's to issue commands to the controller.
3926 * NOTE: The commands issuance functionality is not generalized and
3927 * implemented in context of "get ld map" command only. If required, the
3928 * command issuance logical can be trivially pulled out and implemented as a
3929 * standalone libary. For now, this should suffice since there is no other
3930 * user of this interface.
3932 * @param adapter : controller's soft state
3934 * @return 0 on success
3935 * @return -1 on failure
3938 megaraid_sysfs_get_ldmap(adapter_t *adapter)
3940 mraid_device_t *raid_dev = ADAP2RAIDDEV(adapter);
3945 struct timer_list sysfs_timer;
3946 struct timer_list *timerp;
3951 * Allow only one read at a time to go through the sysfs attributes
3953 down(&raid_dev->sysfs_sem);
3955 uioc = raid_dev->sysfs_uioc;
3956 mbox64 = raid_dev->sysfs_mbox64;
3957 ldmap = raid_dev->sysfs_buffer;
3959 memset(uioc, 0, sizeof(uioc_t));
3960 memset(mbox64, 0, sizeof(mbox64_t));
3961 memset(ldmap, 0, sizeof(raid_dev->curr_ldmap));
3963 mbox = &mbox64->mbox32;
3964 raw_mbox = (char *)mbox;
3965 uioc->cmdbuf = (uint64_t)(unsigned long)mbox64;
3966 uioc->buf_vaddr = (caddr_t)adapter;
3967 uioc->status = -ENODATA;
3968 uioc->done = megaraid_sysfs_get_ldmap_done;
3971 * Prepare the mailbox packet to get the current logical drive mapping
3974 mbox->xferaddr = (uint32_t)raid_dev->sysfs_buffer_dma;
3976 raw_mbox[0] = FC_DEL_LOGDRV;
3977 raw_mbox[2] = OP_GET_LDID_MAP;
3980 * Setup a timer to recover from a non-responding controller
3982 timerp = &sysfs_timer;
3985 timerp->function = megaraid_sysfs_get_ldmap_timeout;
3986 timerp->data = (unsigned long)uioc;
3987 timerp->expires = jiffies + 60 * HZ;
3992 * Send the command to the firmware
3994 rval = megaraid_mbox_mm_command(adapter, uioc);
3996 if (rval == 0) { // command successfully issued
3997 wait_event(raid_dev->sysfs_wait_q, (uioc->status != -ENODATA));
4000 * Check if the command timed out
4002 if (uioc->status == -ETIME) {
4003 con_log(CL_ANN, (KERN_NOTICE
4004 "megaraid: sysfs get ld map timed out\n"));
4009 rval = mbox->status;
4013 memcpy(raid_dev->curr_ldmap, ldmap,
4014 sizeof(raid_dev->curr_ldmap));
4017 con_log(CL_ANN, (KERN_NOTICE
4018 "megaraid: get ld map failed with %x\n", rval));
4022 con_log(CL_ANN, (KERN_NOTICE
4023 "megaraid: could not issue ldmap command:%x\n", rval));
4027 del_timer_sync(timerp);
4029 up(&raid_dev->sysfs_sem);
4036 * megaraid_sysfs_show_app_hndl - display application handle for this adapter
4038 * Display the handle used by the applications while executing management
4039 * tasks on the adapter. We invoke a management module API to get the adapter
4040 * handle, since we do not interface with applications directly.
4042 * @param cdev : class device object representation for the host
4043 * @param buf : buffer to send data to
4046 megaraid_sysfs_show_app_hndl(struct class_device *cdev, char *buf)
4048 struct Scsi_Host *shost = class_to_shost(cdev);
4049 adapter_t *adapter = (adapter_t *)SCSIHOST2ADAP(shost);
4052 app_hndl = mraid_mm_adapter_app_handle(adapter->unique_id);
4054 return snprintf(buf, 8, "%u\n", app_hndl);
4059 * megaraid_sysfs_show_ldnum - display the logical drive number for this device
4061 * Display the logical drive number for the device in question, if it a valid
4062 * logical drive. For physical devices, "-1" is returned
4063 * The logical drive number is displayed in following format
4065 * <SCSI ID> <LD NUM> <LD STICKY ID> <APP ADAPTER HANDLE>
4066 * <int> <int> <int> <int>
4068 * @param dev : device object representation for the scsi device
4069 * @param buf : buffer to send data to
4072 megaraid_sysfs_show_ldnum(struct device *dev, struct device_attribute *attr, char *buf)
4074 struct scsi_device *sdev = to_scsi_device(dev);
4075 adapter_t *adapter = (adapter_t *)SCSIHOST2ADAP(sdev->host);
4076 mraid_device_t *raid_dev = ADAP2RAIDDEV(adapter);
4078 int logical_drv = -1;
4080 uint32_t app_hndl = 0;
4085 if (raid_dev->random_del_supported &&
4086 MRAID_IS_LOGICAL_SDEV(adapter, sdev)) {
4088 rval = megaraid_sysfs_get_ldmap(adapter);
4091 for (i = 0; i < MAX_LOGICAL_DRIVES_40LD; i++) {
4093 mapped_sdev_id = sdev->id;
4095 if (sdev->id > adapter->init_id) {
4096 mapped_sdev_id -= 1;
4099 if (raid_dev->curr_ldmap[i] == mapped_sdev_id) {
4105 ldid_map = raid_dev->curr_ldmap[i];
4107 app_hndl = mraid_mm_adapter_app_handle(
4108 adapter->unique_id);
4115 con_log(CL_ANN, (KERN_NOTICE
4116 "megaraid: sysfs get ld map failed: %x\n",
4121 return snprintf(buf, 36, "%d %d %d %d\n", scsi_id, logical_drv,
4122 ldid_map, app_hndl);
4127 * END: Mailbox Low Level Driver
4129 module_init(megaraid_init);
4130 module_exit(megaraid_exit);
4132 /* vim: set ts=8 sw=8 tw=78 ai si: */