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 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
;
69 init_timer(&slow
->timer
);
70 init_completion(&slow
->completion
);
74 EXPORT_SYMBOL_GPL(sas_alloc_slow_task
);
76 void sas_free_task(struct sas_task
*task
)
79 kfree(task
->slow_task
);
80 kmem_cache_free(sas_task_cache
, task
);
83 EXPORT_SYMBOL_GPL(sas_free_task
);
85 /*------------ SAS addr hash -----------*/
86 void sas_hash_addr(u8
*hashed
, const u8
*sas_addr
)
88 const u32 poly
= 0x00DB2777;
92 for (i
= 0; i
< 8; i
++) {
94 for (b
= 7; b
>= 0; b
--) {
96 if ((1 << b
) & sas_addr
[i
]) {
97 if (!(r
& 0x01000000))
99 } else if (r
& 0x01000000)
104 hashed
[0] = (r
>> 16) & 0xFF;
105 hashed
[1] = (r
>> 8) & 0xFF ;
106 hashed
[2] = r
& 0xFF;
110 /* ---------- HA events ---------- */
112 void sas_hae_reset(struct work_struct
*work
)
114 struct sas_ha_event
*ev
= to_sas_ha_event(work
);
115 struct sas_ha_struct
*ha
= ev
->ha
;
117 clear_bit(HAE_RESET
, &ha
->pending
);
120 int sas_register_ha(struct sas_ha_struct
*sas_ha
)
124 mutex_init(&sas_ha
->disco_mutex
);
125 spin_lock_init(&sas_ha
->phy_port_lock
);
126 sas_hash_addr(sas_ha
->hashed_sas_addr
, sas_ha
->sas_addr
);
128 set_bit(SAS_HA_REGISTERED
, &sas_ha
->state
);
129 spin_lock_init(&sas_ha
->lock
);
130 mutex_init(&sas_ha
->drain_mutex
);
131 init_waitqueue_head(&sas_ha
->eh_wait_q
);
132 INIT_LIST_HEAD(&sas_ha
->defer_q
);
133 INIT_LIST_HEAD(&sas_ha
->eh_dev_q
);
135 error
= sas_register_phys(sas_ha
);
137 printk(KERN_NOTICE
"couldn't register sas phys:%d\n", error
);
141 error
= sas_register_ports(sas_ha
);
143 printk(KERN_NOTICE
"couldn't register sas ports:%d\n", error
);
147 error
= sas_init_events(sas_ha
);
149 printk(KERN_NOTICE
"couldn't start event thread:%d\n", error
);
153 INIT_LIST_HEAD(&sas_ha
->eh_done_q
);
154 INIT_LIST_HEAD(&sas_ha
->eh_ata_q
);
159 sas_unregister_ports(sas_ha
);
165 static void sas_disable_events(struct sas_ha_struct
*sas_ha
)
167 /* Set the state to unregistered to avoid further unchained
168 * events to be queued, and flush any in-progress drainers
170 mutex_lock(&sas_ha
->drain_mutex
);
171 spin_lock_irq(&sas_ha
->lock
);
172 clear_bit(SAS_HA_REGISTERED
, &sas_ha
->state
);
173 spin_unlock_irq(&sas_ha
->lock
);
174 __sas_drain_work(sas_ha
);
175 mutex_unlock(&sas_ha
->drain_mutex
);
178 int sas_unregister_ha(struct sas_ha_struct
*sas_ha
)
180 sas_disable_events(sas_ha
);
181 sas_unregister_ports(sas_ha
);
183 /* flush unregistration work */
184 mutex_lock(&sas_ha
->drain_mutex
);
185 __sas_drain_work(sas_ha
);
186 mutex_unlock(&sas_ha
->drain_mutex
);
191 static int sas_get_linkerrors(struct sas_phy
*phy
)
193 if (scsi_is_sas_phy_local(phy
)) {
194 struct Scsi_Host
*shost
= dev_to_shost(phy
->dev
.parent
);
195 struct sas_ha_struct
*sas_ha
= SHOST_TO_SAS_HA(shost
);
196 struct asd_sas_phy
*asd_phy
= sas_ha
->sas_phy
[phy
->number
];
197 struct sas_internal
*i
=
198 to_sas_internal(sas_ha
->core
.shost
->transportt
);
200 return i
->dft
->lldd_control_phy(asd_phy
, PHY_FUNC_GET_EVENTS
, NULL
);
203 return sas_smp_get_phy_events(phy
);
206 int sas_try_ata_reset(struct asd_sas_phy
*asd_phy
)
208 struct domain_device
*dev
= NULL
;
210 /* try to route user requested link resets through libata */
212 dev
= asd_phy
->port
->port_dev
;
214 /* validate that dev has been probed */
216 dev
= sas_find_dev_by_rphy(dev
->rphy
);
218 if (dev
&& dev_is_sata(dev
)) {
219 sas_ata_schedule_reset(dev
);
220 sas_ata_wait_eh(dev
);
228 * transport_sas_phy_reset - reset a phy and permit libata to manage the link
230 * phy reset request via sysfs in host workqueue context so we know we
231 * can block on eh and safely traverse the domain_device topology
233 static int transport_sas_phy_reset(struct sas_phy
*phy
, int hard_reset
)
235 enum phy_func reset_type
;
238 reset_type
= PHY_FUNC_HARD_RESET
;
240 reset_type
= PHY_FUNC_LINK_RESET
;
242 if (scsi_is_sas_phy_local(phy
)) {
243 struct Scsi_Host
*shost
= dev_to_shost(phy
->dev
.parent
);
244 struct sas_ha_struct
*sas_ha
= SHOST_TO_SAS_HA(shost
);
245 struct asd_sas_phy
*asd_phy
= sas_ha
->sas_phy
[phy
->number
];
246 struct sas_internal
*i
=
247 to_sas_internal(sas_ha
->core
.shost
->transportt
);
249 if (!hard_reset
&& sas_try_ata_reset(asd_phy
) == 0)
251 return i
->dft
->lldd_control_phy(asd_phy
, reset_type
, NULL
);
253 struct sas_rphy
*rphy
= dev_to_rphy(phy
->dev
.parent
);
254 struct domain_device
*ddev
= sas_find_dev_by_rphy(rphy
);
255 struct domain_device
*ata_dev
= sas_ex_to_ata(ddev
, phy
->number
);
257 if (ata_dev
&& !hard_reset
) {
258 sas_ata_schedule_reset(ata_dev
);
259 sas_ata_wait_eh(ata_dev
);
262 return sas_smp_phy_control(ddev
, phy
->number
, reset_type
, NULL
);
266 static int sas_phy_enable(struct sas_phy
*phy
, int enable
)
272 cmd
= PHY_FUNC_LINK_RESET
;
274 cmd
= PHY_FUNC_DISABLE
;
276 if (scsi_is_sas_phy_local(phy
)) {
277 struct Scsi_Host
*shost
= dev_to_shost(phy
->dev
.parent
);
278 struct sas_ha_struct
*sas_ha
= SHOST_TO_SAS_HA(shost
);
279 struct asd_sas_phy
*asd_phy
= sas_ha
->sas_phy
[phy
->number
];
280 struct sas_internal
*i
=
281 to_sas_internal(sas_ha
->core
.shost
->transportt
);
284 ret
= transport_sas_phy_reset(phy
, 0);
286 ret
= i
->dft
->lldd_control_phy(asd_phy
, cmd
, NULL
);
288 struct sas_rphy
*rphy
= dev_to_rphy(phy
->dev
.parent
);
289 struct domain_device
*ddev
= sas_find_dev_by_rphy(rphy
);
292 ret
= transport_sas_phy_reset(phy
, 0);
294 ret
= sas_smp_phy_control(ddev
, phy
->number
, cmd
, NULL
);
299 int sas_phy_reset(struct sas_phy
*phy
, int hard_reset
)
302 enum phy_func reset_type
;
308 reset_type
= PHY_FUNC_HARD_RESET
;
310 reset_type
= PHY_FUNC_LINK_RESET
;
312 if (scsi_is_sas_phy_local(phy
)) {
313 struct Scsi_Host
*shost
= dev_to_shost(phy
->dev
.parent
);
314 struct sas_ha_struct
*sas_ha
= SHOST_TO_SAS_HA(shost
);
315 struct asd_sas_phy
*asd_phy
= sas_ha
->sas_phy
[phy
->number
];
316 struct sas_internal
*i
=
317 to_sas_internal(sas_ha
->core
.shost
->transportt
);
319 ret
= i
->dft
->lldd_control_phy(asd_phy
, reset_type
, NULL
);
321 struct sas_rphy
*rphy
= dev_to_rphy(phy
->dev
.parent
);
322 struct domain_device
*ddev
= sas_find_dev_by_rphy(rphy
);
323 ret
= sas_smp_phy_control(ddev
, phy
->number
, reset_type
, NULL
);
328 int sas_set_phy_speed(struct sas_phy
*phy
,
329 struct sas_phy_linkrates
*rates
)
333 if ((rates
->minimum_linkrate
&&
334 rates
->minimum_linkrate
> phy
->maximum_linkrate
) ||
335 (rates
->maximum_linkrate
&&
336 rates
->maximum_linkrate
< phy
->minimum_linkrate
))
339 if (rates
->minimum_linkrate
&&
340 rates
->minimum_linkrate
< phy
->minimum_linkrate_hw
)
341 rates
->minimum_linkrate
= phy
->minimum_linkrate_hw
;
343 if (rates
->maximum_linkrate
&&
344 rates
->maximum_linkrate
> phy
->maximum_linkrate_hw
)
345 rates
->maximum_linkrate
= phy
->maximum_linkrate_hw
;
347 if (scsi_is_sas_phy_local(phy
)) {
348 struct Scsi_Host
*shost
= dev_to_shost(phy
->dev
.parent
);
349 struct sas_ha_struct
*sas_ha
= SHOST_TO_SAS_HA(shost
);
350 struct asd_sas_phy
*asd_phy
= sas_ha
->sas_phy
[phy
->number
];
351 struct sas_internal
*i
=
352 to_sas_internal(sas_ha
->core
.shost
->transportt
);
354 ret
= i
->dft
->lldd_control_phy(asd_phy
, PHY_FUNC_SET_LINK_RATE
,
357 struct sas_rphy
*rphy
= dev_to_rphy(phy
->dev
.parent
);
358 struct domain_device
*ddev
= sas_find_dev_by_rphy(rphy
);
359 ret
= sas_smp_phy_control(ddev
, phy
->number
,
360 PHY_FUNC_LINK_RESET
, rates
);
367 void sas_prep_resume_ha(struct sas_ha_struct
*ha
)
371 set_bit(SAS_HA_REGISTERED
, &ha
->state
);
373 /* clear out any stale link events/data from the suspension path */
374 for (i
= 0; i
< ha
->num_phys
; i
++) {
375 struct asd_sas_phy
*phy
= ha
->sas_phy
[i
];
377 memset(phy
->attached_sas_addr
, 0, SAS_ADDR_SIZE
);
378 phy
->port_events_pending
= 0;
379 phy
->phy_events_pending
= 0;
380 phy
->frame_rcvd_size
= 0;
383 EXPORT_SYMBOL(sas_prep_resume_ha
);
385 static int phys_suspended(struct sas_ha_struct
*ha
)
389 for (i
= 0; i
< ha
->num_phys
; i
++) {
390 struct asd_sas_phy
*phy
= ha
->sas_phy
[i
];
399 void sas_resume_ha(struct sas_ha_struct
*ha
)
401 const unsigned long tmo
= msecs_to_jiffies(25000);
404 /* deform ports on phys that did not resume
405 * at this point we may be racing the phy coming back (as posted
406 * by the lldd). So we post the event and once we are in the
407 * libsas context check that the phy remains suspended before
410 i
= phys_suspended(ha
);
412 dev_info(ha
->dev
, "waiting up to 25 seconds for %d phy%s to resume\n",
413 i
, i
> 1 ? "s" : "");
414 wait_event_timeout(ha
->eh_wait_q
, phys_suspended(ha
) == 0, tmo
);
415 for (i
= 0; i
< ha
->num_phys
; i
++) {
416 struct asd_sas_phy
*phy
= ha
->sas_phy
[i
];
418 if (phy
->suspended
) {
419 dev_warn(&phy
->phy
->dev
, "resume timeout\n");
420 sas_notify_phy_event(phy
, PHYE_RESUME_TIMEOUT
);
424 /* all phys are back up or timed out, turn on i/o so we can
425 * flush out disks that did not return
427 scsi_unblock_requests(ha
->core
.shost
);
430 EXPORT_SYMBOL(sas_resume_ha
);
432 void sas_suspend_ha(struct sas_ha_struct
*ha
)
436 sas_disable_events(ha
);
437 scsi_block_requests(ha
->core
.shost
);
438 for (i
= 0; i
< ha
->num_phys
; i
++) {
439 struct asd_sas_port
*port
= ha
->sas_port
[i
];
441 sas_discover_event(port
, DISCE_SUSPEND
);
444 /* flush suspend events while unregistered */
445 mutex_lock(&ha
->drain_mutex
);
446 __sas_drain_work(ha
);
447 mutex_unlock(&ha
->drain_mutex
);
449 EXPORT_SYMBOL(sas_suspend_ha
);
451 static void sas_phy_release(struct sas_phy
*phy
)
453 kfree(phy
->hostdata
);
454 phy
->hostdata
= NULL
;
457 static void phy_reset_work(struct work_struct
*work
)
459 struct sas_phy_data
*d
= container_of(work
, typeof(*d
), reset_work
.work
);
461 d
->reset_result
= transport_sas_phy_reset(d
->phy
, d
->hard_reset
);
464 static void phy_enable_work(struct work_struct
*work
)
466 struct sas_phy_data
*d
= container_of(work
, typeof(*d
), enable_work
.work
);
468 d
->enable_result
= sas_phy_enable(d
->phy
, d
->enable
);
471 static int sas_phy_setup(struct sas_phy
*phy
)
473 struct sas_phy_data
*d
= kzalloc(sizeof(*d
), GFP_KERNEL
);
478 mutex_init(&d
->event_lock
);
479 INIT_SAS_WORK(&d
->reset_work
, phy_reset_work
);
480 INIT_SAS_WORK(&d
->enable_work
, phy_enable_work
);
487 static int queue_phy_reset(struct sas_phy
*phy
, int hard_reset
)
489 struct Scsi_Host
*shost
= dev_to_shost(phy
->dev
.parent
);
490 struct sas_ha_struct
*ha
= SHOST_TO_SAS_HA(shost
);
491 struct sas_phy_data
*d
= phy
->hostdata
;
497 /* libsas workqueue coordinates ata-eh reset with discovery */
498 mutex_lock(&d
->event_lock
);
500 d
->hard_reset
= hard_reset
;
502 spin_lock_irq(&ha
->lock
);
503 sas_queue_work(ha
, &d
->reset_work
);
504 spin_unlock_irq(&ha
->lock
);
506 rc
= sas_drain_work(ha
);
508 rc
= d
->reset_result
;
509 mutex_unlock(&d
->event_lock
);
514 static int queue_phy_enable(struct sas_phy
*phy
, int enable
)
516 struct Scsi_Host
*shost
= dev_to_shost(phy
->dev
.parent
);
517 struct sas_ha_struct
*ha
= SHOST_TO_SAS_HA(shost
);
518 struct sas_phy_data
*d
= phy
->hostdata
;
524 /* libsas workqueue coordinates ata-eh reset with discovery */
525 mutex_lock(&d
->event_lock
);
526 d
->enable_result
= 0;
529 spin_lock_irq(&ha
->lock
);
530 sas_queue_work(ha
, &d
->enable_work
);
531 spin_unlock_irq(&ha
->lock
);
533 rc
= sas_drain_work(ha
);
535 rc
= d
->enable_result
;
536 mutex_unlock(&d
->event_lock
);
541 static struct sas_function_template sft
= {
542 .phy_enable
= queue_phy_enable
,
543 .phy_reset
= queue_phy_reset
,
544 .phy_setup
= sas_phy_setup
,
545 .phy_release
= sas_phy_release
,
546 .set_phy_speed
= sas_set_phy_speed
,
547 .get_linkerrors
= sas_get_linkerrors
,
548 .smp_handler
= sas_smp_handler
,
551 struct scsi_transport_template
*
552 sas_domain_attach_transport(struct sas_domain_function_template
*dft
)
554 struct scsi_transport_template
*stt
= sas_attach_transport(&sft
);
555 struct sas_internal
*i
;
560 i
= to_sas_internal(stt
);
562 stt
->create_work_queue
= 1;
563 stt
->eh_timed_out
= sas_scsi_timed_out
;
564 stt
->eh_strategy_handler
= sas_scsi_recover_host
;
568 EXPORT_SYMBOL_GPL(sas_domain_attach_transport
);
571 void sas_domain_release_transport(struct scsi_transport_template
*stt
)
573 sas_release_transport(stt
);
575 EXPORT_SYMBOL_GPL(sas_domain_release_transport
);
577 /* ---------- SAS Class register/unregister ---------- */
579 static int __init
sas_class_init(void)
581 sas_task_cache
= KMEM_CACHE(sas_task
, SLAB_HWCACHE_ALIGN
);
588 static void __exit
sas_class_exit(void)
590 kmem_cache_destroy(sas_task_cache
);
593 MODULE_AUTHOR("Luben Tuikov <luben_tuikov@adaptec.com>");
594 MODULE_DESCRIPTION("SAS Transport Layer");
595 MODULE_LICENSE("GPL v2");
597 module_init(sas_class_init
);
598 module_exit(sas_class_exit
);
600 EXPORT_SYMBOL_GPL(sas_register_ha
);
601 EXPORT_SYMBOL_GPL(sas_unregister_ha
);