2 * Serial Attached SCSI (SAS) Transport Layer initialization
4 * Copyright (C) 2005 Adaptec, Inc. All rights reserved.
7 * This file is licensed under GPLv2.
9 * This program is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU General Public License as
11 * published by the Free Software Foundation; either version 2 of the
12 * License, or (at your option) any later version.
14 * This program is distributed in the hope that it will be useful, but
15 * WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * General Public License for more details.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
26 #include <linux/module.h>
27 #include <linux/slab.h>
28 #include <linux/init.h>
29 #include <linux/device.h>
30 #include <linux/spinlock.h>
31 #include <scsi/sas_ata.h>
32 #include <scsi/scsi_host.h>
33 #include <scsi/scsi_device.h>
34 #include <scsi/scsi_transport.h>
35 #include <scsi/scsi_transport_sas.h>
37 #include "sas_internal.h"
39 #include "../scsi_sas_internal.h"
41 static struct kmem_cache *sas_task_cache;
43 struct sas_task *sas_alloc_task(gfp_t flags)
45 struct sas_task *task = kmem_cache_zalloc(sas_task_cache, flags);
48 spin_lock_init(&task->task_state_lock);
49 task->task_state_flags = SAS_TASK_STATE_PENDING;
54 EXPORT_SYMBOL_GPL(sas_alloc_task);
56 struct sas_task *sas_alloc_slow_task(gfp_t flags)
58 struct sas_task *task = sas_alloc_task(flags);
59 struct sas_task_slow *slow = kmalloc(sizeof(*slow), flags);
63 kmem_cache_free(sas_task_cache, task);
68 task->slow_task = slow;
70 timer_setup(&slow->timer, NULL, 0);
71 init_completion(&slow->completion);
75 EXPORT_SYMBOL_GPL(sas_alloc_slow_task);
77 void sas_free_task(struct sas_task *task)
80 kfree(task->slow_task);
81 kmem_cache_free(sas_task_cache, task);
84 EXPORT_SYMBOL_GPL(sas_free_task);
86 /*------------ SAS addr hash -----------*/
87 void sas_hash_addr(u8 *hashed, const u8 *sas_addr)
89 const u32 poly = 0x00DB2777;
93 for (i = 0; i < 8; i++) {
95 for (b = 7; b >= 0; b--) {
97 if ((1 << b) & sas_addr[i]) {
98 if (!(r & 0x01000000))
100 } else if (r & 0x01000000)
105 hashed[0] = (r >> 16) & 0xFF;
106 hashed[1] = (r >> 8) & 0xFF ;
107 hashed[2] = r & 0xFF;
110 int sas_register_ha(struct sas_ha_struct *sas_ha)
114 mutex_init(&sas_ha->disco_mutex);
115 spin_lock_init(&sas_ha->phy_port_lock);
116 sas_hash_addr(sas_ha->hashed_sas_addr, sas_ha->sas_addr);
118 set_bit(SAS_HA_REGISTERED, &sas_ha->state);
119 spin_lock_init(&sas_ha->lock);
120 mutex_init(&sas_ha->drain_mutex);
121 init_waitqueue_head(&sas_ha->eh_wait_q);
122 INIT_LIST_HEAD(&sas_ha->defer_q);
123 INIT_LIST_HEAD(&sas_ha->eh_dev_q);
125 error = sas_register_phys(sas_ha);
127 printk(KERN_NOTICE "couldn't register sas phys:%d\n", error);
131 error = sas_register_ports(sas_ha);
133 printk(KERN_NOTICE "couldn't register sas ports:%d\n", error);
137 error = sas_init_events(sas_ha);
139 printk(KERN_NOTICE "couldn't start event thread:%d\n", error);
143 INIT_LIST_HEAD(&sas_ha->eh_done_q);
144 INIT_LIST_HEAD(&sas_ha->eh_ata_q);
148 sas_unregister_ports(sas_ha);
154 static void sas_disable_events(struct sas_ha_struct *sas_ha)
156 /* Set the state to unregistered to avoid further unchained
157 * events to be queued, and flush any in-progress drainers
159 mutex_lock(&sas_ha->drain_mutex);
160 spin_lock_irq(&sas_ha->lock);
161 clear_bit(SAS_HA_REGISTERED, &sas_ha->state);
162 spin_unlock_irq(&sas_ha->lock);
163 __sas_drain_work(sas_ha);
164 mutex_unlock(&sas_ha->drain_mutex);
167 int sas_unregister_ha(struct sas_ha_struct *sas_ha)
169 sas_disable_events(sas_ha);
170 sas_unregister_ports(sas_ha);
172 /* flush unregistration work */
173 mutex_lock(&sas_ha->drain_mutex);
174 __sas_drain_work(sas_ha);
175 mutex_unlock(&sas_ha->drain_mutex);
180 static int sas_get_linkerrors(struct sas_phy *phy)
182 if (scsi_is_sas_phy_local(phy)) {
183 struct Scsi_Host *shost = dev_to_shost(phy->dev.parent);
184 struct sas_ha_struct *sas_ha = SHOST_TO_SAS_HA(shost);
185 struct asd_sas_phy *asd_phy = sas_ha->sas_phy[phy->number];
186 struct sas_internal *i =
187 to_sas_internal(sas_ha->core.shost->transportt);
189 return i->dft->lldd_control_phy(asd_phy, PHY_FUNC_GET_EVENTS, NULL);
192 return sas_smp_get_phy_events(phy);
195 int sas_try_ata_reset(struct asd_sas_phy *asd_phy)
197 struct domain_device *dev = NULL;
199 /* try to route user requested link resets through libata */
201 dev = asd_phy->port->port_dev;
203 /* validate that dev has been probed */
205 dev = sas_find_dev_by_rphy(dev->rphy);
207 if (dev && dev_is_sata(dev)) {
208 sas_ata_schedule_reset(dev);
209 sas_ata_wait_eh(dev);
217 * transport_sas_phy_reset - reset a phy and permit libata to manage the link
219 * phy reset request via sysfs in host workqueue context so we know we
220 * can block on eh and safely traverse the domain_device topology
222 static int transport_sas_phy_reset(struct sas_phy *phy, int hard_reset)
224 enum phy_func reset_type;
227 reset_type = PHY_FUNC_HARD_RESET;
229 reset_type = PHY_FUNC_LINK_RESET;
231 if (scsi_is_sas_phy_local(phy)) {
232 struct Scsi_Host *shost = dev_to_shost(phy->dev.parent);
233 struct sas_ha_struct *sas_ha = SHOST_TO_SAS_HA(shost);
234 struct asd_sas_phy *asd_phy = sas_ha->sas_phy[phy->number];
235 struct sas_internal *i =
236 to_sas_internal(sas_ha->core.shost->transportt);
238 if (!hard_reset && sas_try_ata_reset(asd_phy) == 0)
240 return i->dft->lldd_control_phy(asd_phy, reset_type, NULL);
242 struct sas_rphy *rphy = dev_to_rphy(phy->dev.parent);
243 struct domain_device *ddev = sas_find_dev_by_rphy(rphy);
244 struct domain_device *ata_dev = sas_ex_to_ata(ddev, phy->number);
246 if (ata_dev && !hard_reset) {
247 sas_ata_schedule_reset(ata_dev);
248 sas_ata_wait_eh(ata_dev);
251 return sas_smp_phy_control(ddev, phy->number, reset_type, NULL);
255 static int sas_phy_enable(struct sas_phy *phy, int enable)
261 cmd = PHY_FUNC_LINK_RESET;
263 cmd = PHY_FUNC_DISABLE;
265 if (scsi_is_sas_phy_local(phy)) {
266 struct Scsi_Host *shost = dev_to_shost(phy->dev.parent);
267 struct sas_ha_struct *sas_ha = SHOST_TO_SAS_HA(shost);
268 struct asd_sas_phy *asd_phy = sas_ha->sas_phy[phy->number];
269 struct sas_internal *i =
270 to_sas_internal(sas_ha->core.shost->transportt);
273 ret = transport_sas_phy_reset(phy, 0);
275 ret = i->dft->lldd_control_phy(asd_phy, cmd, NULL);
277 struct sas_rphy *rphy = dev_to_rphy(phy->dev.parent);
278 struct domain_device *ddev = sas_find_dev_by_rphy(rphy);
281 ret = transport_sas_phy_reset(phy, 0);
283 ret = sas_smp_phy_control(ddev, phy->number, cmd, NULL);
288 int sas_phy_reset(struct sas_phy *phy, int hard_reset)
291 enum phy_func reset_type;
297 reset_type = PHY_FUNC_HARD_RESET;
299 reset_type = PHY_FUNC_LINK_RESET;
301 if (scsi_is_sas_phy_local(phy)) {
302 struct Scsi_Host *shost = dev_to_shost(phy->dev.parent);
303 struct sas_ha_struct *sas_ha = SHOST_TO_SAS_HA(shost);
304 struct asd_sas_phy *asd_phy = sas_ha->sas_phy[phy->number];
305 struct sas_internal *i =
306 to_sas_internal(sas_ha->core.shost->transportt);
308 ret = i->dft->lldd_control_phy(asd_phy, reset_type, NULL);
310 struct sas_rphy *rphy = dev_to_rphy(phy->dev.parent);
311 struct domain_device *ddev = sas_find_dev_by_rphy(rphy);
312 ret = sas_smp_phy_control(ddev, phy->number, reset_type, NULL);
317 int sas_set_phy_speed(struct sas_phy *phy,
318 struct sas_phy_linkrates *rates)
322 if ((rates->minimum_linkrate &&
323 rates->minimum_linkrate > phy->maximum_linkrate) ||
324 (rates->maximum_linkrate &&
325 rates->maximum_linkrate < phy->minimum_linkrate))
328 if (rates->minimum_linkrate &&
329 rates->minimum_linkrate < phy->minimum_linkrate_hw)
330 rates->minimum_linkrate = phy->minimum_linkrate_hw;
332 if (rates->maximum_linkrate &&
333 rates->maximum_linkrate > phy->maximum_linkrate_hw)
334 rates->maximum_linkrate = phy->maximum_linkrate_hw;
336 if (scsi_is_sas_phy_local(phy)) {
337 struct Scsi_Host *shost = dev_to_shost(phy->dev.parent);
338 struct sas_ha_struct *sas_ha = SHOST_TO_SAS_HA(shost);
339 struct asd_sas_phy *asd_phy = sas_ha->sas_phy[phy->number];
340 struct sas_internal *i =
341 to_sas_internal(sas_ha->core.shost->transportt);
343 ret = i->dft->lldd_control_phy(asd_phy, PHY_FUNC_SET_LINK_RATE,
346 struct sas_rphy *rphy = dev_to_rphy(phy->dev.parent);
347 struct domain_device *ddev = sas_find_dev_by_rphy(rphy);
348 ret = sas_smp_phy_control(ddev, phy->number,
349 PHY_FUNC_LINK_RESET, rates);
356 void sas_prep_resume_ha(struct sas_ha_struct *ha)
360 set_bit(SAS_HA_REGISTERED, &ha->state);
362 /* clear out any stale link events/data from the suspension path */
363 for (i = 0; i < ha->num_phys; i++) {
364 struct asd_sas_phy *phy = ha->sas_phy[i];
366 memset(phy->attached_sas_addr, 0, SAS_ADDR_SIZE);
367 phy->port_events_pending = 0;
368 phy->phy_events_pending = 0;
369 phy->frame_rcvd_size = 0;
372 EXPORT_SYMBOL(sas_prep_resume_ha);
374 static int phys_suspended(struct sas_ha_struct *ha)
378 for (i = 0; i < ha->num_phys; i++) {
379 struct asd_sas_phy *phy = ha->sas_phy[i];
388 void sas_resume_ha(struct sas_ha_struct *ha)
390 const unsigned long tmo = msecs_to_jiffies(25000);
393 /* deform ports on phys that did not resume
394 * at this point we may be racing the phy coming back (as posted
395 * by the lldd). So we post the event and once we are in the
396 * libsas context check that the phy remains suspended before
399 i = phys_suspended(ha);
401 dev_info(ha->dev, "waiting up to 25 seconds for %d phy%s to resume\n",
402 i, i > 1 ? "s" : "");
403 wait_event_timeout(ha->eh_wait_q, phys_suspended(ha) == 0, tmo);
404 for (i = 0; i < ha->num_phys; i++) {
405 struct asd_sas_phy *phy = ha->sas_phy[i];
407 if (phy->suspended) {
408 dev_warn(&phy->phy->dev, "resume timeout\n");
409 sas_notify_phy_event(phy, PHYE_RESUME_TIMEOUT);
413 /* all phys are back up or timed out, turn on i/o so we can
414 * flush out disks that did not return
416 scsi_unblock_requests(ha->core.shost);
419 EXPORT_SYMBOL(sas_resume_ha);
421 void sas_suspend_ha(struct sas_ha_struct *ha)
425 sas_disable_events(ha);
426 scsi_block_requests(ha->core.shost);
427 for (i = 0; i < ha->num_phys; i++) {
428 struct asd_sas_port *port = ha->sas_port[i];
430 sas_discover_event(port, DISCE_SUSPEND);
433 /* flush suspend events while unregistered */
434 mutex_lock(&ha->drain_mutex);
435 __sas_drain_work(ha);
436 mutex_unlock(&ha->drain_mutex);
438 EXPORT_SYMBOL(sas_suspend_ha);
440 static void sas_phy_release(struct sas_phy *phy)
442 kfree(phy->hostdata);
443 phy->hostdata = NULL;
446 static void phy_reset_work(struct work_struct *work)
448 struct sas_phy_data *d = container_of(work, typeof(*d), reset_work.work);
450 d->reset_result = transport_sas_phy_reset(d->phy, d->hard_reset);
453 static void phy_enable_work(struct work_struct *work)
455 struct sas_phy_data *d = container_of(work, typeof(*d), enable_work.work);
457 d->enable_result = sas_phy_enable(d->phy, d->enable);
460 static int sas_phy_setup(struct sas_phy *phy)
462 struct sas_phy_data *d = kzalloc(sizeof(*d), GFP_KERNEL);
467 mutex_init(&d->event_lock);
468 INIT_SAS_WORK(&d->reset_work, phy_reset_work);
469 INIT_SAS_WORK(&d->enable_work, phy_enable_work);
476 static int queue_phy_reset(struct sas_phy *phy, int hard_reset)
478 struct Scsi_Host *shost = dev_to_shost(phy->dev.parent);
479 struct sas_ha_struct *ha = SHOST_TO_SAS_HA(shost);
480 struct sas_phy_data *d = phy->hostdata;
486 /* libsas workqueue coordinates ata-eh reset with discovery */
487 mutex_lock(&d->event_lock);
489 d->hard_reset = hard_reset;
491 spin_lock_irq(&ha->lock);
492 sas_queue_work(ha, &d->reset_work);
493 spin_unlock_irq(&ha->lock);
495 rc = sas_drain_work(ha);
497 rc = d->reset_result;
498 mutex_unlock(&d->event_lock);
503 static int queue_phy_enable(struct sas_phy *phy, int enable)
505 struct Scsi_Host *shost = dev_to_shost(phy->dev.parent);
506 struct sas_ha_struct *ha = SHOST_TO_SAS_HA(shost);
507 struct sas_phy_data *d = phy->hostdata;
513 /* libsas workqueue coordinates ata-eh reset with discovery */
514 mutex_lock(&d->event_lock);
515 d->enable_result = 0;
518 spin_lock_irq(&ha->lock);
519 sas_queue_work(ha, &d->enable_work);
520 spin_unlock_irq(&ha->lock);
522 rc = sas_drain_work(ha);
524 rc = d->enable_result;
525 mutex_unlock(&d->event_lock);
530 static struct sas_function_template sft = {
531 .phy_enable = queue_phy_enable,
532 .phy_reset = queue_phy_reset,
533 .phy_setup = sas_phy_setup,
534 .phy_release = sas_phy_release,
535 .set_phy_speed = sas_set_phy_speed,
536 .get_linkerrors = sas_get_linkerrors,
537 .smp_handler = sas_smp_handler,
540 struct scsi_transport_template *
541 sas_domain_attach_transport(struct sas_domain_function_template *dft)
543 struct scsi_transport_template *stt = sas_attach_transport(&sft);
544 struct sas_internal *i;
549 i = to_sas_internal(stt);
551 stt->create_work_queue = 1;
552 stt->eh_strategy_handler = sas_scsi_recover_host;
556 EXPORT_SYMBOL_GPL(sas_domain_attach_transport);
558 /* ---------- SAS Class register/unregister ---------- */
560 static int __init sas_class_init(void)
562 sas_task_cache = KMEM_CACHE(sas_task, SLAB_HWCACHE_ALIGN);
569 static void __exit sas_class_exit(void)
571 kmem_cache_destroy(sas_task_cache);
575 MODULE_DESCRIPTION("SAS Transport Layer");
576 MODULE_LICENSE("GPL v2");
578 module_init(sas_class_init);
579 module_exit(sas_class_exit);
581 EXPORT_SYMBOL_GPL(sas_register_ha);
582 EXPORT_SYMBOL_GPL(sas_unregister_ha);