2 * Serial Attached SCSI (SAS) Transport Layer initialization
4 * Copyright (C) 2005 Adaptec, Inc. All rights reserved.
5 * Copyright (C) 2005 Luben Tuikov <luben_tuikov@adaptec.com>
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 INIT_LIST_HEAD(&task
->list
);
49 spin_lock_init(&task
->task_state_lock
);
50 task
->task_state_flags
= SAS_TASK_STATE_PENDING
;
55 EXPORT_SYMBOL_GPL(sas_alloc_task
);
57 struct sas_task
*sas_alloc_slow_task(gfp_t flags
)
59 struct sas_task
*task
= sas_alloc_task(flags
);
60 struct sas_task_slow
*slow
= kmalloc(sizeof(*slow
), flags
);
64 kmem_cache_free(sas_task_cache
, task
);
69 task
->slow_task
= slow
;
70 init_timer(&slow
->timer
);
71 init_completion(&slow
->completion
);
75 EXPORT_SYMBOL_GPL(sas_alloc_slow_task
);
77 void sas_free_task(struct sas_task
*task
)
80 BUG_ON(!list_empty(&task
->list
));
81 kfree(task
->slow_task
);
82 kmem_cache_free(sas_task_cache
, task
);
85 EXPORT_SYMBOL_GPL(sas_free_task
);
87 /*------------ SAS addr hash -----------*/
88 void sas_hash_addr(u8
*hashed
, const u8
*sas_addr
)
90 const u32 poly
= 0x00DB2777;
94 for (i
= 0; i
< 8; i
++) {
96 for (b
= 7; b
>= 0; b
--) {
98 if ((1 << b
) & sas_addr
[i
]) {
99 if (!(r
& 0x01000000))
101 } else if (r
& 0x01000000)
106 hashed
[0] = (r
>> 16) & 0xFF;
107 hashed
[1] = (r
>> 8) & 0xFF ;
108 hashed
[2] = r
& 0xFF;
112 /* ---------- HA events ---------- */
114 void sas_hae_reset(struct work_struct
*work
)
116 struct sas_ha_event
*ev
= to_sas_ha_event(work
);
117 struct sas_ha_struct
*ha
= ev
->ha
;
119 clear_bit(HAE_RESET
, &ha
->pending
);
122 int sas_register_ha(struct sas_ha_struct
*sas_ha
)
126 mutex_init(&sas_ha
->disco_mutex
);
127 spin_lock_init(&sas_ha
->phy_port_lock
);
128 sas_hash_addr(sas_ha
->hashed_sas_addr
, sas_ha
->sas_addr
);
130 if (sas_ha
->lldd_queue_size
== 0)
131 sas_ha
->lldd_queue_size
= 1;
132 else if (sas_ha
->lldd_queue_size
== -1)
133 sas_ha
->lldd_queue_size
= 128; /* Sanity */
135 set_bit(SAS_HA_REGISTERED
, &sas_ha
->state
);
136 spin_lock_init(&sas_ha
->lock
);
137 mutex_init(&sas_ha
->drain_mutex
);
138 init_waitqueue_head(&sas_ha
->eh_wait_q
);
139 INIT_LIST_HEAD(&sas_ha
->defer_q
);
140 INIT_LIST_HEAD(&sas_ha
->eh_dev_q
);
142 error
= sas_register_phys(sas_ha
);
144 printk(KERN_NOTICE
"couldn't register sas phys:%d\n", error
);
148 error
= sas_register_ports(sas_ha
);
150 printk(KERN_NOTICE
"couldn't register sas ports:%d\n", error
);
154 error
= sas_init_events(sas_ha
);
156 printk(KERN_NOTICE
"couldn't start event thread:%d\n", error
);
160 if (sas_ha
->lldd_max_execute_num
> 1) {
161 error
= sas_init_queue(sas_ha
);
163 printk(KERN_NOTICE
"couldn't start queue thread:%d, "
164 "running in direct mode\n", error
);
165 sas_ha
->lldd_max_execute_num
= 1;
169 INIT_LIST_HEAD(&sas_ha
->eh_done_q
);
170 INIT_LIST_HEAD(&sas_ha
->eh_ata_q
);
175 sas_unregister_ports(sas_ha
);
181 static void sas_disable_events(struct sas_ha_struct
*sas_ha
)
183 /* Set the state to unregistered to avoid further unchained
184 * events to be queued, and flush any in-progress drainers
186 mutex_lock(&sas_ha
->drain_mutex
);
187 spin_lock_irq(&sas_ha
->lock
);
188 clear_bit(SAS_HA_REGISTERED
, &sas_ha
->state
);
189 spin_unlock_irq(&sas_ha
->lock
);
190 __sas_drain_work(sas_ha
);
191 mutex_unlock(&sas_ha
->drain_mutex
);
194 int sas_unregister_ha(struct sas_ha_struct
*sas_ha
)
196 sas_disable_events(sas_ha
);
197 sas_unregister_ports(sas_ha
);
199 /* flush unregistration work */
200 mutex_lock(&sas_ha
->drain_mutex
);
201 __sas_drain_work(sas_ha
);
202 mutex_unlock(&sas_ha
->drain_mutex
);
204 if (sas_ha
->lldd_max_execute_num
> 1) {
205 sas_shutdown_queue(sas_ha
);
206 sas_ha
->lldd_max_execute_num
= 1;
212 static int sas_get_linkerrors(struct sas_phy
*phy
)
214 if (scsi_is_sas_phy_local(phy
)) {
215 struct Scsi_Host
*shost
= dev_to_shost(phy
->dev
.parent
);
216 struct sas_ha_struct
*sas_ha
= SHOST_TO_SAS_HA(shost
);
217 struct asd_sas_phy
*asd_phy
= sas_ha
->sas_phy
[phy
->number
];
218 struct sas_internal
*i
=
219 to_sas_internal(sas_ha
->core
.shost
->transportt
);
221 return i
->dft
->lldd_control_phy(asd_phy
, PHY_FUNC_GET_EVENTS
, NULL
);
224 return sas_smp_get_phy_events(phy
);
227 int sas_try_ata_reset(struct asd_sas_phy
*asd_phy
)
229 struct domain_device
*dev
= NULL
;
231 /* try to route user requested link resets through libata */
233 dev
= asd_phy
->port
->port_dev
;
235 /* validate that dev has been probed */
237 dev
= sas_find_dev_by_rphy(dev
->rphy
);
239 if (dev
&& dev_is_sata(dev
)) {
240 sas_ata_schedule_reset(dev
);
241 sas_ata_wait_eh(dev
);
249 * transport_sas_phy_reset - reset a phy and permit libata to manage the link
251 * phy reset request via sysfs in host workqueue context so we know we
252 * can block on eh and safely traverse the domain_device topology
254 static int transport_sas_phy_reset(struct sas_phy
*phy
, int hard_reset
)
256 enum phy_func reset_type
;
259 reset_type
= PHY_FUNC_HARD_RESET
;
261 reset_type
= PHY_FUNC_LINK_RESET
;
263 if (scsi_is_sas_phy_local(phy
)) {
264 struct Scsi_Host
*shost
= dev_to_shost(phy
->dev
.parent
);
265 struct sas_ha_struct
*sas_ha
= SHOST_TO_SAS_HA(shost
);
266 struct asd_sas_phy
*asd_phy
= sas_ha
->sas_phy
[phy
->number
];
267 struct sas_internal
*i
=
268 to_sas_internal(sas_ha
->core
.shost
->transportt
);
270 if (!hard_reset
&& sas_try_ata_reset(asd_phy
) == 0)
272 return i
->dft
->lldd_control_phy(asd_phy
, reset_type
, NULL
);
274 struct sas_rphy
*rphy
= dev_to_rphy(phy
->dev
.parent
);
275 struct domain_device
*ddev
= sas_find_dev_by_rphy(rphy
);
276 struct domain_device
*ata_dev
= sas_ex_to_ata(ddev
, phy
->number
);
278 if (ata_dev
&& !hard_reset
) {
279 sas_ata_schedule_reset(ata_dev
);
280 sas_ata_wait_eh(ata_dev
);
283 return sas_smp_phy_control(ddev
, phy
->number
, reset_type
, NULL
);
287 static int sas_phy_enable(struct sas_phy
*phy
, int enable
)
293 cmd
= PHY_FUNC_LINK_RESET
;
295 cmd
= PHY_FUNC_DISABLE
;
297 if (scsi_is_sas_phy_local(phy
)) {
298 struct Scsi_Host
*shost
= dev_to_shost(phy
->dev
.parent
);
299 struct sas_ha_struct
*sas_ha
= SHOST_TO_SAS_HA(shost
);
300 struct asd_sas_phy
*asd_phy
= sas_ha
->sas_phy
[phy
->number
];
301 struct sas_internal
*i
=
302 to_sas_internal(sas_ha
->core
.shost
->transportt
);
305 ret
= transport_sas_phy_reset(phy
, 0);
307 ret
= i
->dft
->lldd_control_phy(asd_phy
, cmd
, NULL
);
309 struct sas_rphy
*rphy
= dev_to_rphy(phy
->dev
.parent
);
310 struct domain_device
*ddev
= sas_find_dev_by_rphy(rphy
);
313 ret
= transport_sas_phy_reset(phy
, 0);
315 ret
= sas_smp_phy_control(ddev
, phy
->number
, cmd
, NULL
);
320 int sas_phy_reset(struct sas_phy
*phy
, int hard_reset
)
323 enum phy_func reset_type
;
329 reset_type
= PHY_FUNC_HARD_RESET
;
331 reset_type
= PHY_FUNC_LINK_RESET
;
333 if (scsi_is_sas_phy_local(phy
)) {
334 struct Scsi_Host
*shost
= dev_to_shost(phy
->dev
.parent
);
335 struct sas_ha_struct
*sas_ha
= SHOST_TO_SAS_HA(shost
);
336 struct asd_sas_phy
*asd_phy
= sas_ha
->sas_phy
[phy
->number
];
337 struct sas_internal
*i
=
338 to_sas_internal(sas_ha
->core
.shost
->transportt
);
340 ret
= i
->dft
->lldd_control_phy(asd_phy
, reset_type
, NULL
);
342 struct sas_rphy
*rphy
= dev_to_rphy(phy
->dev
.parent
);
343 struct domain_device
*ddev
= sas_find_dev_by_rphy(rphy
);
344 ret
= sas_smp_phy_control(ddev
, phy
->number
, reset_type
, NULL
);
349 int sas_set_phy_speed(struct sas_phy
*phy
,
350 struct sas_phy_linkrates
*rates
)
354 if ((rates
->minimum_linkrate
&&
355 rates
->minimum_linkrate
> phy
->maximum_linkrate
) ||
356 (rates
->maximum_linkrate
&&
357 rates
->maximum_linkrate
< phy
->minimum_linkrate
))
360 if (rates
->minimum_linkrate
&&
361 rates
->minimum_linkrate
< phy
->minimum_linkrate_hw
)
362 rates
->minimum_linkrate
= phy
->minimum_linkrate_hw
;
364 if (rates
->maximum_linkrate
&&
365 rates
->maximum_linkrate
> phy
->maximum_linkrate_hw
)
366 rates
->maximum_linkrate
= phy
->maximum_linkrate_hw
;
368 if (scsi_is_sas_phy_local(phy
)) {
369 struct Scsi_Host
*shost
= dev_to_shost(phy
->dev
.parent
);
370 struct sas_ha_struct
*sas_ha
= SHOST_TO_SAS_HA(shost
);
371 struct asd_sas_phy
*asd_phy
= sas_ha
->sas_phy
[phy
->number
];
372 struct sas_internal
*i
=
373 to_sas_internal(sas_ha
->core
.shost
->transportt
);
375 ret
= i
->dft
->lldd_control_phy(asd_phy
, PHY_FUNC_SET_LINK_RATE
,
378 struct sas_rphy
*rphy
= dev_to_rphy(phy
->dev
.parent
);
379 struct domain_device
*ddev
= sas_find_dev_by_rphy(rphy
);
380 ret
= sas_smp_phy_control(ddev
, phy
->number
,
381 PHY_FUNC_LINK_RESET
, rates
);
388 void sas_prep_resume_ha(struct sas_ha_struct
*ha
)
392 set_bit(SAS_HA_REGISTERED
, &ha
->state
);
394 /* clear out any stale link events/data from the suspension path */
395 for (i
= 0; i
< ha
->num_phys
; i
++) {
396 struct asd_sas_phy
*phy
= ha
->sas_phy
[i
];
398 memset(phy
->attached_sas_addr
, 0, SAS_ADDR_SIZE
);
399 phy
->port_events_pending
= 0;
400 phy
->phy_events_pending
= 0;
401 phy
->frame_rcvd_size
= 0;
404 EXPORT_SYMBOL(sas_prep_resume_ha
);
406 static int phys_suspended(struct sas_ha_struct
*ha
)
410 for (i
= 0; i
< ha
->num_phys
; i
++) {
411 struct asd_sas_phy
*phy
= ha
->sas_phy
[i
];
420 void sas_resume_ha(struct sas_ha_struct
*ha
)
422 const unsigned long tmo
= msecs_to_jiffies(25000);
425 /* deform ports on phys that did not resume
426 * at this point we may be racing the phy coming back (as posted
427 * by the lldd). So we post the event and once we are in the
428 * libsas context check that the phy remains suspended before
431 i
= phys_suspended(ha
);
433 dev_info(ha
->dev
, "waiting up to 25 seconds for %d phy%s to resume\n",
434 i
, i
> 1 ? "s" : "");
435 wait_event_timeout(ha
->eh_wait_q
, phys_suspended(ha
) == 0, tmo
);
436 for (i
= 0; i
< ha
->num_phys
; i
++) {
437 struct asd_sas_phy
*phy
= ha
->sas_phy
[i
];
439 if (phy
->suspended
) {
440 dev_warn(&phy
->phy
->dev
, "resume timeout\n");
441 sas_notify_phy_event(phy
, PHYE_RESUME_TIMEOUT
);
445 /* all phys are back up or timed out, turn on i/o so we can
446 * flush out disks that did not return
448 scsi_unblock_requests(ha
->core
.shost
);
451 EXPORT_SYMBOL(sas_resume_ha
);
453 void sas_suspend_ha(struct sas_ha_struct
*ha
)
457 sas_disable_events(ha
);
458 scsi_block_requests(ha
->core
.shost
);
459 for (i
= 0; i
< ha
->num_phys
; i
++) {
460 struct asd_sas_port
*port
= ha
->sas_port
[i
];
462 sas_discover_event(port
, DISCE_SUSPEND
);
465 /* flush suspend events while unregistered */
466 mutex_lock(&ha
->drain_mutex
);
467 __sas_drain_work(ha
);
468 mutex_unlock(&ha
->drain_mutex
);
470 EXPORT_SYMBOL(sas_suspend_ha
);
472 static void sas_phy_release(struct sas_phy
*phy
)
474 kfree(phy
->hostdata
);
475 phy
->hostdata
= NULL
;
478 static void phy_reset_work(struct work_struct
*work
)
480 struct sas_phy_data
*d
= container_of(work
, typeof(*d
), reset_work
.work
);
482 d
->reset_result
= transport_sas_phy_reset(d
->phy
, d
->hard_reset
);
485 static void phy_enable_work(struct work_struct
*work
)
487 struct sas_phy_data
*d
= container_of(work
, typeof(*d
), enable_work
.work
);
489 d
->enable_result
= sas_phy_enable(d
->phy
, d
->enable
);
492 static int sas_phy_setup(struct sas_phy
*phy
)
494 struct sas_phy_data
*d
= kzalloc(sizeof(*d
), GFP_KERNEL
);
499 mutex_init(&d
->event_lock
);
500 INIT_SAS_WORK(&d
->reset_work
, phy_reset_work
);
501 INIT_SAS_WORK(&d
->enable_work
, phy_enable_work
);
508 static int queue_phy_reset(struct sas_phy
*phy
, int hard_reset
)
510 struct Scsi_Host
*shost
= dev_to_shost(phy
->dev
.parent
);
511 struct sas_ha_struct
*ha
= SHOST_TO_SAS_HA(shost
);
512 struct sas_phy_data
*d
= phy
->hostdata
;
518 /* libsas workqueue coordinates ata-eh reset with discovery */
519 mutex_lock(&d
->event_lock
);
521 d
->hard_reset
= hard_reset
;
523 spin_lock_irq(&ha
->lock
);
524 sas_queue_work(ha
, &d
->reset_work
);
525 spin_unlock_irq(&ha
->lock
);
527 rc
= sas_drain_work(ha
);
529 rc
= d
->reset_result
;
530 mutex_unlock(&d
->event_lock
);
535 static int queue_phy_enable(struct sas_phy
*phy
, int enable
)
537 struct Scsi_Host
*shost
= dev_to_shost(phy
->dev
.parent
);
538 struct sas_ha_struct
*ha
= SHOST_TO_SAS_HA(shost
);
539 struct sas_phy_data
*d
= phy
->hostdata
;
545 /* libsas workqueue coordinates ata-eh reset with discovery */
546 mutex_lock(&d
->event_lock
);
547 d
->enable_result
= 0;
550 spin_lock_irq(&ha
->lock
);
551 sas_queue_work(ha
, &d
->enable_work
);
552 spin_unlock_irq(&ha
->lock
);
554 rc
= sas_drain_work(ha
);
556 rc
= d
->enable_result
;
557 mutex_unlock(&d
->event_lock
);
562 static struct sas_function_template sft
= {
563 .phy_enable
= queue_phy_enable
,
564 .phy_reset
= queue_phy_reset
,
565 .phy_setup
= sas_phy_setup
,
566 .phy_release
= sas_phy_release
,
567 .set_phy_speed
= sas_set_phy_speed
,
568 .get_linkerrors
= sas_get_linkerrors
,
569 .smp_handler
= sas_smp_handler
,
572 struct scsi_transport_template
*
573 sas_domain_attach_transport(struct sas_domain_function_template
*dft
)
575 struct scsi_transport_template
*stt
= sas_attach_transport(&sft
);
576 struct sas_internal
*i
;
581 i
= to_sas_internal(stt
);
583 stt
->create_work_queue
= 1;
584 stt
->eh_timed_out
= sas_scsi_timed_out
;
585 stt
->eh_strategy_handler
= sas_scsi_recover_host
;
589 EXPORT_SYMBOL_GPL(sas_domain_attach_transport
);
592 void sas_domain_release_transport(struct scsi_transport_template
*stt
)
594 sas_release_transport(stt
);
596 EXPORT_SYMBOL_GPL(sas_domain_release_transport
);
598 /* ---------- SAS Class register/unregister ---------- */
600 static int __init
sas_class_init(void)
602 sas_task_cache
= KMEM_CACHE(sas_task
, SLAB_HWCACHE_ALIGN
);
609 static void __exit
sas_class_exit(void)
611 kmem_cache_destroy(sas_task_cache
);
614 MODULE_AUTHOR("Luben Tuikov <luben_tuikov@adaptec.com>");
615 MODULE_DESCRIPTION("SAS Transport Layer");
616 MODULE_LICENSE("GPL v2");
618 module_init(sas_class_init
);
619 module_exit(sas_class_exit
);
621 EXPORT_SYMBOL_GPL(sas_register_ha
);
622 EXPORT_SYMBOL_GPL(sas_unregister_ha
);