2 * SBP2 driver (SCSI over IEEE1394)
4 * Copyright (C) 2005-2007 Kristian Hoegsberg <krh@bitplanet.net>
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software Foundation,
18 * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
22 * The basic structure of this driver is based on the old storage driver,
23 * drivers/ieee1394/sbp2.c, originally written by
24 * James Goodwin <jamesg@filanet.com>
25 * with later contributions and ongoing maintenance from
26 * Ben Collins <bcollins@debian.org>,
27 * Stefan Richter <stefanr@s5r6.in-berlin.de>
31 #include <linux/kernel.h>
32 #include <linux/module.h>
33 #include <linux/moduleparam.h>
34 #include <linux/mod_devicetable.h>
35 #include <linux/delay.h>
36 #include <linux/device.h>
37 #include <linux/scatterlist.h>
38 #include <linux/dma-mapping.h>
39 #include <linux/blkdev.h>
40 #include <linux/string.h>
41 #include <linux/stringify.h>
42 #include <linux/timer.h>
43 #include <linux/workqueue.h>
44 #include <asm/system.h>
46 #include <scsi/scsi.h>
47 #include <scsi/scsi_cmnd.h>
48 #include <scsi/scsi_device.h>
49 #include <scsi/scsi_host.h>
51 #include "fw-transaction.h"
52 #include "fw-topology.h"
53 #include "fw-device.h"
56 * So far only bridges from Oxford Semiconductor are known to support
57 * concurrent logins. Depending on firmware, four or two concurrent logins
58 * are possible on OXFW911 and newer Oxsemi bridges.
60 * Concurrent logins are useful together with cluster filesystems.
62 static int sbp2_param_exclusive_login = 1;
63 module_param_named(exclusive_login, sbp2_param_exclusive_login, bool, 0644);
64 MODULE_PARM_DESC(exclusive_login, "Exclusive login to sbp2 device "
65 "(default = Y, use N for concurrent initiators)");
68 * Flags for firmware oddities
70 * - 128kB max transfer
71 * Limit transfer size. Necessary for some old bridges.
74 * When scsi_mod probes the device, let the inquiry command look like that
78 * Suppress sending of mode_sense for mode page 8 if the device pretends to
79 * support the SCSI Primary Block commands instead of Reduced Block Commands.
82 * Tell sd_mod to correct the last sector number reported by read_capacity.
83 * Avoids access beyond actual disk limits on devices with an off-by-one bug.
84 * Don't use this with devices which don't have this bug.
87 * Wait extra SBP2_INQUIRY_DELAY seconds after login before SCSI inquiry.
89 * - override internal blacklist
90 * Instead of adding to the built-in blacklist, use only the workarounds
91 * specified in the module load parameter.
92 * Useful if a blacklist entry interfered with a non-broken device.
94 #define SBP2_WORKAROUND_128K_MAX_TRANS 0x1
95 #define SBP2_WORKAROUND_INQUIRY_36 0x2
96 #define SBP2_WORKAROUND_MODE_SENSE_8 0x4
97 #define SBP2_WORKAROUND_FIX_CAPACITY 0x8
98 #define SBP2_WORKAROUND_DELAY_INQUIRY 0x10
99 #define SBP2_INQUIRY_DELAY 12
100 #define SBP2_WORKAROUND_OVERRIDE 0x100
102 static int sbp2_param_workarounds;
103 module_param_named(workarounds, sbp2_param_workarounds, int, 0644);
104 MODULE_PARM_DESC(workarounds, "Work around device bugs (default = 0"
105 ", 128kB max transfer = " __stringify(SBP2_WORKAROUND_128K_MAX_TRANS)
106 ", 36 byte inquiry = " __stringify(SBP2_WORKAROUND_INQUIRY_36)
107 ", skip mode page 8 = " __stringify(SBP2_WORKAROUND_MODE_SENSE_8)
108 ", fix capacity = " __stringify(SBP2_WORKAROUND_FIX_CAPACITY)
109 ", delay inquiry = " __stringify(SBP2_WORKAROUND_DELAY_INQUIRY)
110 ", override internal blacklist = " __stringify(SBP2_WORKAROUND_OVERRIDE)
111 ", or a combination)");
113 /* I don't know why the SCSI stack doesn't define something like this... */
114 typedef void (*scsi_done_fn_t)(struct scsi_cmnd *);
116 static const char sbp2_driver_name[] = "sbp2";
119 * We create one struct sbp2_logical_unit per SBP-2 Logical Unit Number Entry
120 * and one struct scsi_device per sbp2_logical_unit.
122 struct sbp2_logical_unit {
123 struct sbp2_target *tgt;
124 struct list_head link;
125 struct scsi_device *sdev;
126 struct fw_address_handler address_handler;
127 struct list_head orb_list;
129 u64 command_block_agent_address;
134 * The generation is updated once we've logged in or reconnected
135 * to the logical unit. Thus, I/O to the device will automatically
136 * fail and get retried if it happens in a window where the device
137 * is not ready, e.g. after a bus reset but before we reconnect.
141 struct delayed_work work;
145 * We create one struct sbp2_target per IEEE 1212 Unit Directory
146 * and one struct Scsi_Host per sbp2_target.
150 struct fw_unit *unit;
151 struct list_head lu_list;
153 u64 management_agent_address;
157 unsigned int workarounds;
158 unsigned int mgt_orb_timeout;
162 * Per section 7.4.8 of the SBP-2 spec, a mgt_ORB_timeout value can be
163 * provided in the config rom. Most devices do provide a value, which
164 * we'll use for login management orbs, but with some sane limits.
166 #define SBP2_MIN_LOGIN_ORB_TIMEOUT 5000U /* Timeout in ms */
167 #define SBP2_MAX_LOGIN_ORB_TIMEOUT 40000U /* Timeout in ms */
168 #define SBP2_ORB_TIMEOUT 2000U /* Timeout in ms */
169 #define SBP2_ORB_NULL 0x80000000
170 #define SBP2_MAX_SG_ELEMENT_LENGTH 0xf000
172 #define SBP2_DIRECTION_TO_MEDIA 0x0
173 #define SBP2_DIRECTION_FROM_MEDIA 0x1
175 /* Unit directory keys */
176 #define SBP2_CSR_UNIT_CHARACTERISTICS 0x3a
177 #define SBP2_CSR_FIRMWARE_REVISION 0x3c
178 #define SBP2_CSR_LOGICAL_UNIT_NUMBER 0x14
179 #define SBP2_CSR_LOGICAL_UNIT_DIRECTORY 0xd4
181 /* Management orb opcodes */
182 #define SBP2_LOGIN_REQUEST 0x0
183 #define SBP2_QUERY_LOGINS_REQUEST 0x1
184 #define SBP2_RECONNECT_REQUEST 0x3
185 #define SBP2_SET_PASSWORD_REQUEST 0x4
186 #define SBP2_LOGOUT_REQUEST 0x7
187 #define SBP2_ABORT_TASK_REQUEST 0xb
188 #define SBP2_ABORT_TASK_SET 0xc
189 #define SBP2_LOGICAL_UNIT_RESET 0xe
190 #define SBP2_TARGET_RESET_REQUEST 0xf
192 /* Offsets for command block agent registers */
193 #define SBP2_AGENT_STATE 0x00
194 #define SBP2_AGENT_RESET 0x04
195 #define SBP2_ORB_POINTER 0x08
196 #define SBP2_DOORBELL 0x10
197 #define SBP2_UNSOLICITED_STATUS_ENABLE 0x14
199 /* Status write response codes */
200 #define SBP2_STATUS_REQUEST_COMPLETE 0x0
201 #define SBP2_STATUS_TRANSPORT_FAILURE 0x1
202 #define SBP2_STATUS_ILLEGAL_REQUEST 0x2
203 #define SBP2_STATUS_VENDOR_DEPENDENT 0x3
205 #define STATUS_GET_ORB_HIGH(v) ((v).status & 0xffff)
206 #define STATUS_GET_SBP_STATUS(v) (((v).status >> 16) & 0xff)
207 #define STATUS_GET_LEN(v) (((v).status >> 24) & 0x07)
208 #define STATUS_GET_DEAD(v) (((v).status >> 27) & 0x01)
209 #define STATUS_GET_RESPONSE(v) (((v).status >> 28) & 0x03)
210 #define STATUS_GET_SOURCE(v) (((v).status >> 30) & 0x03)
211 #define STATUS_GET_ORB_LOW(v) ((v).orb_low)
212 #define STATUS_GET_DATA(v) ((v).data)
220 struct sbp2_pointer {
226 struct fw_transaction t;
228 dma_addr_t request_bus;
230 struct sbp2_pointer pointer;
231 void (*callback)(struct sbp2_orb * orb, struct sbp2_status * status);
232 struct list_head link;
235 #define MANAGEMENT_ORB_LUN(v) ((v))
236 #define MANAGEMENT_ORB_FUNCTION(v) ((v) << 16)
237 #define MANAGEMENT_ORB_RECONNECT(v) ((v) << 20)
238 #define MANAGEMENT_ORB_EXCLUSIVE(v) ((v) ? 1 << 28 : 0)
239 #define MANAGEMENT_ORB_REQUEST_FORMAT(v) ((v) << 29)
240 #define MANAGEMENT_ORB_NOTIFY ((1) << 31)
242 #define MANAGEMENT_ORB_RESPONSE_LENGTH(v) ((v))
243 #define MANAGEMENT_ORB_PASSWORD_LENGTH(v) ((v) << 16)
245 struct sbp2_management_orb {
246 struct sbp2_orb base;
248 struct sbp2_pointer password;
249 struct sbp2_pointer response;
252 struct sbp2_pointer status_fifo;
255 dma_addr_t response_bus;
256 struct completion done;
257 struct sbp2_status status;
260 #define LOGIN_RESPONSE_GET_LOGIN_ID(v) ((v).misc & 0xffff)
261 #define LOGIN_RESPONSE_GET_LENGTH(v) (((v).misc >> 16) & 0xffff)
263 struct sbp2_login_response {
265 struct sbp2_pointer command_block_agent;
268 #define COMMAND_ORB_DATA_SIZE(v) ((v))
269 #define COMMAND_ORB_PAGE_SIZE(v) ((v) << 16)
270 #define COMMAND_ORB_PAGE_TABLE_PRESENT ((1) << 19)
271 #define COMMAND_ORB_MAX_PAYLOAD(v) ((v) << 20)
272 #define COMMAND_ORB_SPEED(v) ((v) << 24)
273 #define COMMAND_ORB_DIRECTION(v) ((v) << 27)
274 #define COMMAND_ORB_REQUEST_FORMAT(v) ((v) << 29)
275 #define COMMAND_ORB_NOTIFY ((1) << 31)
277 struct sbp2_command_orb {
278 struct sbp2_orb base;
280 struct sbp2_pointer next;
281 struct sbp2_pointer data_descriptor;
283 u8 command_block[12];
285 struct scsi_cmnd *cmd;
287 struct sbp2_logical_unit *lu;
289 struct sbp2_pointer page_table[SG_ALL] __attribute__((aligned(8)));
290 dma_addr_t page_table_bus;
294 * List of devices with known bugs.
296 * The firmware_revision field, masked with 0xffff00, is the best
297 * indicator for the type of bridge chip of a device. It yields a few
298 * false positives but this did not break correctly behaving devices
299 * so far. We use ~0 as a wildcard, since the 24 bit values we get
300 * from the config rom can never match that.
302 static const struct {
303 u32 firmware_revision;
305 unsigned int workarounds;
306 } sbp2_workarounds_table[] = {
307 /* DViCO Momobay CX-1 with TSB42AA9 bridge */ {
308 .firmware_revision = 0x002800,
310 .workarounds = SBP2_WORKAROUND_INQUIRY_36 |
311 SBP2_WORKAROUND_MODE_SENSE_8,
313 /* DViCO Momobay FX-3A with TSB42AA9A bridge */ {
314 .firmware_revision = 0x002800,
316 .workarounds = SBP2_WORKAROUND_DELAY_INQUIRY,
318 /* Initio bridges, actually only needed for some older ones */ {
319 .firmware_revision = 0x000200,
321 .workarounds = SBP2_WORKAROUND_INQUIRY_36,
323 /* Symbios bridge */ {
324 .firmware_revision = 0xa0b800,
326 .workarounds = SBP2_WORKAROUND_128K_MAX_TRANS,
330 * There are iPods (2nd gen, 3rd gen) with model_id == 0, but
331 * these iPods do not feature the read_capacity bug according
332 * to one report. Read_capacity behaviour as well as model_id
333 * could change due to Apple-supplied firmware updates though.
336 /* iPod 4th generation. */ {
337 .firmware_revision = 0x0a2700,
339 .workarounds = SBP2_WORKAROUND_FIX_CAPACITY,
342 .firmware_revision = 0x0a2700,
344 .workarounds = SBP2_WORKAROUND_FIX_CAPACITY,
347 .firmware_revision = 0x0a2700,
349 .workarounds = SBP2_WORKAROUND_FIX_CAPACITY,
354 free_orb(struct kref *kref)
356 struct sbp2_orb *orb = container_of(kref, struct sbp2_orb, kref);
362 sbp2_status_write(struct fw_card *card, struct fw_request *request,
363 int tcode, int destination, int source,
364 int generation, int speed,
365 unsigned long long offset,
366 void *payload, size_t length, void *callback_data)
368 struct sbp2_logical_unit *lu = callback_data;
369 struct sbp2_orb *orb;
370 struct sbp2_status status;
374 if (tcode != TCODE_WRITE_BLOCK_REQUEST ||
375 length == 0 || length > sizeof(status)) {
376 fw_send_response(card, request, RCODE_TYPE_ERROR);
380 header_size = min(length, 2 * sizeof(u32));
381 fw_memcpy_from_be32(&status, payload, header_size);
382 if (length > header_size)
383 memcpy(status.data, payload + 8, length - header_size);
384 if (STATUS_GET_SOURCE(status) == 2 || STATUS_GET_SOURCE(status) == 3) {
385 fw_notify("non-orb related status write, not handled\n");
386 fw_send_response(card, request, RCODE_COMPLETE);
390 /* Lookup the orb corresponding to this status write. */
391 spin_lock_irqsave(&card->lock, flags);
392 list_for_each_entry(orb, &lu->orb_list, link) {
393 if (STATUS_GET_ORB_HIGH(status) == 0 &&
394 STATUS_GET_ORB_LOW(status) == orb->request_bus) {
395 orb->rcode = RCODE_COMPLETE;
396 list_del(&orb->link);
400 spin_unlock_irqrestore(&card->lock, flags);
402 if (&orb->link != &lu->orb_list)
403 orb->callback(orb, &status);
405 fw_error("status write for unknown orb\n");
407 kref_put(&orb->kref, free_orb);
409 fw_send_response(card, request, RCODE_COMPLETE);
413 complete_transaction(struct fw_card *card, int rcode,
414 void *payload, size_t length, void *data)
416 struct sbp2_orb *orb = data;
420 * This is a little tricky. We can get the status write for
421 * the orb before we get this callback. The status write
422 * handler above will assume the orb pointer transaction was
423 * successful and set the rcode to RCODE_COMPLETE for the orb.
424 * So this callback only sets the rcode if it hasn't already
425 * been set and only does the cleanup if the transaction
426 * failed and we didn't already get a status write.
428 spin_lock_irqsave(&card->lock, flags);
430 if (orb->rcode == -1)
432 if (orb->rcode != RCODE_COMPLETE) {
433 list_del(&orb->link);
434 spin_unlock_irqrestore(&card->lock, flags);
435 orb->callback(orb, NULL);
437 spin_unlock_irqrestore(&card->lock, flags);
440 kref_put(&orb->kref, free_orb);
444 sbp2_send_orb(struct sbp2_orb *orb, struct sbp2_logical_unit *lu,
445 int node_id, int generation, u64 offset)
447 struct fw_device *device = fw_device(lu->tgt->unit->device.parent);
450 orb->pointer.high = 0;
451 orb->pointer.low = orb->request_bus;
452 fw_memcpy_to_be32(&orb->pointer, &orb->pointer, sizeof(orb->pointer));
454 spin_lock_irqsave(&device->card->lock, flags);
455 list_add_tail(&orb->link, &lu->orb_list);
456 spin_unlock_irqrestore(&device->card->lock, flags);
458 /* Take a ref for the orb list and for the transaction callback. */
459 kref_get(&orb->kref);
460 kref_get(&orb->kref);
462 fw_send_request(device->card, &orb->t, TCODE_WRITE_BLOCK_REQUEST,
463 node_id, generation, device->max_speed, offset,
464 &orb->pointer, sizeof(orb->pointer),
465 complete_transaction, orb);
468 static int sbp2_cancel_orbs(struct sbp2_logical_unit *lu)
470 struct fw_device *device = fw_device(lu->tgt->unit->device.parent);
471 struct sbp2_orb *orb, *next;
472 struct list_head list;
474 int retval = -ENOENT;
476 INIT_LIST_HEAD(&list);
477 spin_lock_irqsave(&device->card->lock, flags);
478 list_splice_init(&lu->orb_list, &list);
479 spin_unlock_irqrestore(&device->card->lock, flags);
481 list_for_each_entry_safe(orb, next, &list, link) {
483 if (fw_cancel_transaction(device->card, &orb->t) == 0)
486 orb->rcode = RCODE_CANCELLED;
487 orb->callback(orb, NULL);
494 complete_management_orb(struct sbp2_orb *base_orb, struct sbp2_status *status)
496 struct sbp2_management_orb *orb =
497 container_of(base_orb, struct sbp2_management_orb, base);
500 memcpy(&orb->status, status, sizeof(*status));
501 complete(&orb->done);
505 sbp2_send_management_orb(struct sbp2_logical_unit *lu, int node_id,
506 int generation, int function, int lun_or_login_id,
509 struct fw_device *device = fw_device(lu->tgt->unit->device.parent);
510 struct sbp2_management_orb *orb;
511 unsigned int timeout;
512 int retval = -ENOMEM;
514 if (function == SBP2_LOGOUT_REQUEST && fw_device_is_shutdown(device))
517 orb = kzalloc(sizeof(*orb), GFP_ATOMIC);
521 kref_init(&orb->base.kref);
523 dma_map_single(device->card->device, &orb->response,
524 sizeof(orb->response), DMA_FROM_DEVICE);
525 if (dma_mapping_error(orb->response_bus))
526 goto fail_mapping_response;
528 orb->request.response.high = 0;
529 orb->request.response.low = orb->response_bus;
532 MANAGEMENT_ORB_NOTIFY |
533 MANAGEMENT_ORB_FUNCTION(function) |
534 MANAGEMENT_ORB_LUN(lun_or_login_id);
535 orb->request.length =
536 MANAGEMENT_ORB_RESPONSE_LENGTH(sizeof(orb->response));
538 orb->request.status_fifo.high = lu->address_handler.offset >> 32;
539 orb->request.status_fifo.low = lu->address_handler.offset;
541 if (function == SBP2_LOGIN_REQUEST) {
542 /* Ask for 2^2 == 4 seconds reconnect grace period */
544 MANAGEMENT_ORB_RECONNECT(2) |
545 MANAGEMENT_ORB_EXCLUSIVE(sbp2_param_exclusive_login);
546 timeout = lu->tgt->mgt_orb_timeout;
548 timeout = SBP2_ORB_TIMEOUT;
551 fw_memcpy_to_be32(&orb->request, &orb->request, sizeof(orb->request));
553 init_completion(&orb->done);
554 orb->base.callback = complete_management_orb;
556 orb->base.request_bus =
557 dma_map_single(device->card->device, &orb->request,
558 sizeof(orb->request), DMA_TO_DEVICE);
559 if (dma_mapping_error(orb->base.request_bus))
560 goto fail_mapping_request;
562 sbp2_send_orb(&orb->base, lu, node_id, generation,
563 lu->tgt->management_agent_address);
565 wait_for_completion_timeout(&orb->done, msecs_to_jiffies(timeout));
568 if (sbp2_cancel_orbs(lu) == 0) {
569 fw_error("orb reply timed out, rcode=0x%02x\n",
574 if (orb->base.rcode != RCODE_COMPLETE) {
575 fw_error("management write failed, rcode 0x%02x\n",
580 if (STATUS_GET_RESPONSE(orb->status) != 0 ||
581 STATUS_GET_SBP_STATUS(orb->status) != 0) {
582 fw_error("error status: %d:%d\n",
583 STATUS_GET_RESPONSE(orb->status),
584 STATUS_GET_SBP_STATUS(orb->status));
590 dma_unmap_single(device->card->device, orb->base.request_bus,
591 sizeof(orb->request), DMA_TO_DEVICE);
592 fail_mapping_request:
593 dma_unmap_single(device->card->device, orb->response_bus,
594 sizeof(orb->response), DMA_FROM_DEVICE);
595 fail_mapping_response:
597 fw_memcpy_from_be32(response,
598 orb->response, sizeof(orb->response));
599 kref_put(&orb->base.kref, free_orb);
605 complete_agent_reset_write(struct fw_card *card, int rcode,
606 void *payload, size_t length, void *done)
611 static void sbp2_agent_reset(struct sbp2_logical_unit *lu)
613 struct fw_device *device = fw_device(lu->tgt->unit->device.parent);
614 DECLARE_COMPLETION_ONSTACK(done);
615 struct fw_transaction t;
618 fw_send_request(device->card, &t, TCODE_WRITE_QUADLET_REQUEST,
619 lu->tgt->node_id, lu->generation, device->max_speed,
620 lu->command_block_agent_address + SBP2_AGENT_RESET,
621 &z, sizeof(z), complete_agent_reset_write, &done);
622 wait_for_completion(&done);
626 complete_agent_reset_write_no_wait(struct fw_card *card, int rcode,
627 void *payload, size_t length, void *data)
632 static void sbp2_agent_reset_no_wait(struct sbp2_logical_unit *lu)
634 struct fw_device *device = fw_device(lu->tgt->unit->device.parent);
635 struct fw_transaction *t;
638 t = kmalloc(sizeof(*t), GFP_ATOMIC);
642 fw_send_request(device->card, t, TCODE_WRITE_QUADLET_REQUEST,
643 lu->tgt->node_id, lu->generation, device->max_speed,
644 lu->command_block_agent_address + SBP2_AGENT_RESET,
645 &z, sizeof(z), complete_agent_reset_write_no_wait, t);
648 static void sbp2_release_target(struct kref *kref)
650 struct sbp2_target *tgt = container_of(kref, struct sbp2_target, kref);
651 struct sbp2_logical_unit *lu, *next;
652 struct Scsi_Host *shost =
653 container_of((void *)tgt, struct Scsi_Host, hostdata[0]);
655 list_for_each_entry_safe(lu, next, &tgt->lu_list, link) {
657 scsi_remove_device(lu->sdev);
659 sbp2_send_management_orb(lu, tgt->node_id, lu->generation,
660 SBP2_LOGOUT_REQUEST, lu->login_id, NULL);
662 fw_core_remove_address_handler(&lu->address_handler);
666 scsi_remove_host(shost);
667 fw_notify("released %s\n", tgt->unit->device.bus_id);
669 put_device(&tgt->unit->device);
670 scsi_host_put(shost);
673 static struct workqueue_struct *sbp2_wq;
676 * Always get the target's kref when scheduling work on one its units.
677 * Each workqueue job is responsible to call sbp2_target_put() upon return.
679 static void sbp2_queue_work(struct sbp2_logical_unit *lu, unsigned long delay)
681 if (queue_delayed_work(sbp2_wq, &lu->work, delay))
682 kref_get(&lu->tgt->kref);
685 static void sbp2_target_put(struct sbp2_target *tgt)
687 kref_put(&tgt->kref, sbp2_release_target);
690 static void sbp2_reconnect(struct work_struct *work);
692 static void sbp2_login(struct work_struct *work)
694 struct sbp2_logical_unit *lu =
695 container_of(work, struct sbp2_logical_unit, work.work);
696 struct Scsi_Host *shost =
697 container_of((void *)lu->tgt, struct Scsi_Host, hostdata[0]);
698 struct scsi_device *sdev;
699 struct scsi_lun eight_bytes_lun;
700 struct fw_unit *unit = lu->tgt->unit;
701 struct fw_device *device = fw_device(unit->device.parent);
702 struct sbp2_login_response response;
703 int generation, node_id, local_node_id;
705 if (fw_device_is_shutdown(device))
708 generation = device->generation;
709 smp_rmb(); /* node_id must not be older than generation */
710 node_id = device->node_id;
711 local_node_id = device->card->node_id;
713 if (sbp2_send_management_orb(lu, node_id, generation,
714 SBP2_LOGIN_REQUEST, lu->lun, &response) < 0) {
715 if (lu->retries++ < 5)
716 sbp2_queue_work(lu, DIV_ROUND_UP(HZ, 5));
718 fw_error("failed to login to %s LUN %04x\n",
719 unit->device.bus_id, lu->lun);
723 lu->generation = generation;
724 lu->tgt->node_id = node_id;
725 lu->tgt->address_high = local_node_id << 16;
727 /* Get command block agent offset and login id. */
728 lu->command_block_agent_address =
729 ((u64) (response.command_block_agent.high & 0xffff) << 32) |
730 response.command_block_agent.low;
731 lu->login_id = LOGIN_RESPONSE_GET_LOGIN_ID(response);
733 fw_notify("logged in to %s LUN %04x (%d retries)\n",
734 unit->device.bus_id, lu->lun, lu->retries);
737 /* FIXME: The linux1394 sbp2 does this last step. */
738 sbp2_set_busy_timeout(scsi_id);
741 PREPARE_DELAYED_WORK(&lu->work, sbp2_reconnect);
742 sbp2_agent_reset(lu);
744 if (lu->tgt->workarounds & SBP2_WORKAROUND_DELAY_INQUIRY)
745 ssleep(SBP2_INQUIRY_DELAY);
747 memset(&eight_bytes_lun, 0, sizeof(eight_bytes_lun));
748 eight_bytes_lun.scsi_lun[0] = (lu->lun >> 8) & 0xff;
749 eight_bytes_lun.scsi_lun[1] = lu->lun & 0xff;
751 sdev = __scsi_add_device(shost, 0, 0,
752 scsilun_to_int(&eight_bytes_lun), lu);
754 smp_rmb(); /* generation may have changed */
755 generation = device->generation;
756 smp_rmb(); /* node_id must not be older than generation */
758 sbp2_send_management_orb(lu, device->node_id, generation,
759 SBP2_LOGOUT_REQUEST, lu->login_id, NULL);
761 * Set this back to sbp2_login so we fall back and
762 * retry login on bus reset.
764 PREPARE_DELAYED_WORK(&lu->work, sbp2_login);
767 scsi_device_put(sdev);
770 sbp2_target_put(lu->tgt);
773 static int sbp2_add_logical_unit(struct sbp2_target *tgt, int lun_entry)
775 struct sbp2_logical_unit *lu;
777 lu = kmalloc(sizeof(*lu), GFP_KERNEL);
781 lu->address_handler.length = 0x100;
782 lu->address_handler.address_callback = sbp2_status_write;
783 lu->address_handler.callback_data = lu;
785 if (fw_core_add_address_handler(&lu->address_handler,
786 &fw_high_memory_region) < 0) {
793 lu->lun = lun_entry & 0xffff;
795 INIT_LIST_HEAD(&lu->orb_list);
796 INIT_DELAYED_WORK(&lu->work, sbp2_login);
798 list_add_tail(&lu->link, &tgt->lu_list);
802 static int sbp2_scan_logical_unit_dir(struct sbp2_target *tgt, u32 *directory)
804 struct fw_csr_iterator ci;
807 fw_csr_iterator_init(&ci, directory);
808 while (fw_csr_iterator_next(&ci, &key, &value))
809 if (key == SBP2_CSR_LOGICAL_UNIT_NUMBER &&
810 sbp2_add_logical_unit(tgt, value) < 0)
815 static int sbp2_scan_unit_dir(struct sbp2_target *tgt, u32 *directory,
816 u32 *model, u32 *firmware_revision)
818 struct fw_csr_iterator ci;
820 unsigned int timeout;
822 fw_csr_iterator_init(&ci, directory);
823 while (fw_csr_iterator_next(&ci, &key, &value)) {
826 case CSR_DEPENDENT_INFO | CSR_OFFSET:
827 tgt->management_agent_address =
828 CSR_REGISTER_BASE + 4 * value;
831 case CSR_DIRECTORY_ID:
832 tgt->directory_id = value;
839 case SBP2_CSR_FIRMWARE_REVISION:
840 *firmware_revision = value;
843 case SBP2_CSR_UNIT_CHARACTERISTICS:
844 /* the timeout value is stored in 500ms units */
845 timeout = ((unsigned int) value >> 8 & 0xff) * 500;
846 timeout = max(timeout, SBP2_MIN_LOGIN_ORB_TIMEOUT);
847 tgt->mgt_orb_timeout =
848 min(timeout, SBP2_MAX_LOGIN_ORB_TIMEOUT);
850 if (timeout > tgt->mgt_orb_timeout)
851 fw_notify("%s: config rom contains %ds "
852 "management ORB timeout, limiting "
853 "to %ds\n", tgt->unit->device.bus_id,
855 tgt->mgt_orb_timeout / 1000);
858 case SBP2_CSR_LOGICAL_UNIT_NUMBER:
859 if (sbp2_add_logical_unit(tgt, value) < 0)
863 case SBP2_CSR_LOGICAL_UNIT_DIRECTORY:
864 if (sbp2_scan_logical_unit_dir(tgt, ci.p + value) < 0)
872 static void sbp2_init_workarounds(struct sbp2_target *tgt, u32 model,
873 u32 firmware_revision)
876 unsigned int w = sbp2_param_workarounds;
879 fw_notify("Please notify linux1394-devel@lists.sourceforge.net "
880 "if you need the workarounds parameter for %s\n",
881 tgt->unit->device.bus_id);
883 if (w & SBP2_WORKAROUND_OVERRIDE)
886 for (i = 0; i < ARRAY_SIZE(sbp2_workarounds_table); i++) {
888 if (sbp2_workarounds_table[i].firmware_revision !=
889 (firmware_revision & 0xffffff00))
892 if (sbp2_workarounds_table[i].model != model &&
893 sbp2_workarounds_table[i].model != ~0)
896 w |= sbp2_workarounds_table[i].workarounds;
901 fw_notify("Workarounds for %s: 0x%x "
902 "(firmware_revision 0x%06x, model_id 0x%06x)\n",
903 tgt->unit->device.bus_id,
904 w, firmware_revision, model);
905 tgt->workarounds = w;
908 static struct scsi_host_template scsi_driver_template;
910 static int sbp2_probe(struct device *dev)
912 struct fw_unit *unit = fw_unit(dev);
913 struct fw_device *device = fw_device(unit->device.parent);
914 struct sbp2_target *tgt;
915 struct sbp2_logical_unit *lu;
916 struct Scsi_Host *shost;
917 u32 model, firmware_revision;
919 shost = scsi_host_alloc(&scsi_driver_template, sizeof(*tgt));
923 tgt = (struct sbp2_target *)shost->hostdata;
924 unit->device.driver_data = tgt;
926 kref_init(&tgt->kref);
927 INIT_LIST_HEAD(&tgt->lu_list);
929 if (fw_device_enable_phys_dma(device) < 0)
932 if (scsi_add_host(shost, &unit->device) < 0)
935 /* Initialize to values that won't match anything in our table. */
936 firmware_revision = 0xff000000;
939 /* implicit directory ID */
940 tgt->directory_id = ((unit->directory - device->config_rom) * 4
941 + CSR_CONFIG_ROM) & 0xffffff;
943 if (sbp2_scan_unit_dir(tgt, unit->directory, &model,
944 &firmware_revision) < 0)
947 sbp2_init_workarounds(tgt, model, firmware_revision);
949 get_device(&unit->device);
951 /* Do the login in a workqueue so we can easily reschedule retries. */
952 list_for_each_entry(lu, &tgt->lu_list, link)
953 sbp2_queue_work(lu, 0);
957 sbp2_target_put(tgt);
961 scsi_host_put(shost);
965 static int sbp2_remove(struct device *dev)
967 struct fw_unit *unit = fw_unit(dev);
968 struct sbp2_target *tgt = unit->device.driver_data;
970 sbp2_target_put(tgt);
974 static void sbp2_reconnect(struct work_struct *work)
976 struct sbp2_logical_unit *lu =
977 container_of(work, struct sbp2_logical_unit, work.work);
978 struct fw_unit *unit = lu->tgt->unit;
979 struct fw_device *device = fw_device(unit->device.parent);
980 int generation, node_id, local_node_id;
982 if (fw_device_is_shutdown(device))
985 generation = device->generation;
986 smp_rmb(); /* node_id must not be older than generation */
987 node_id = device->node_id;
988 local_node_id = device->card->node_id;
990 if (sbp2_send_management_orb(lu, node_id, generation,
991 SBP2_RECONNECT_REQUEST,
992 lu->login_id, NULL) < 0) {
993 if (lu->retries++ >= 5) {
994 fw_error("failed to reconnect to %s\n",
995 unit->device.bus_id);
996 /* Fall back and try to log in again. */
998 PREPARE_DELAYED_WORK(&lu->work, sbp2_login);
1000 sbp2_queue_work(lu, DIV_ROUND_UP(HZ, 5));
1004 lu->generation = generation;
1005 lu->tgt->node_id = node_id;
1006 lu->tgt->address_high = local_node_id << 16;
1008 fw_notify("reconnected to %s LUN %04x (%d retries)\n",
1009 unit->device.bus_id, lu->lun, lu->retries);
1011 sbp2_agent_reset(lu);
1012 sbp2_cancel_orbs(lu);
1014 sbp2_target_put(lu->tgt);
1017 static void sbp2_update(struct fw_unit *unit)
1019 struct sbp2_target *tgt = unit->device.driver_data;
1020 struct sbp2_logical_unit *lu;
1022 fw_device_enable_phys_dma(fw_device(unit->device.parent));
1025 * Fw-core serializes sbp2_update() against sbp2_remove().
1026 * Iteration over tgt->lu_list is therefore safe here.
1028 list_for_each_entry(lu, &tgt->lu_list, link) {
1030 sbp2_queue_work(lu, 0);
1034 #define SBP2_UNIT_SPEC_ID_ENTRY 0x0000609e
1035 #define SBP2_SW_VERSION_ENTRY 0x00010483
1037 static const struct fw_device_id sbp2_id_table[] = {
1039 .match_flags = FW_MATCH_SPECIFIER_ID | FW_MATCH_VERSION,
1040 .specifier_id = SBP2_UNIT_SPEC_ID_ENTRY,
1041 .version = SBP2_SW_VERSION_ENTRY,
1046 static struct fw_driver sbp2_driver = {
1048 .owner = THIS_MODULE,
1049 .name = sbp2_driver_name,
1050 .bus = &fw_bus_type,
1051 .probe = sbp2_probe,
1052 .remove = sbp2_remove,
1054 .update = sbp2_update,
1055 .id_table = sbp2_id_table,
1059 sbp2_status_to_sense_data(u8 *sbp2_status, u8 *sense_data)
1063 sense_data[0] = 0x70;
1064 sense_data[1] = 0x0;
1065 sense_data[2] = sbp2_status[1];
1066 sense_data[3] = sbp2_status[4];
1067 sense_data[4] = sbp2_status[5];
1068 sense_data[5] = sbp2_status[6];
1069 sense_data[6] = sbp2_status[7];
1071 sense_data[8] = sbp2_status[8];
1072 sense_data[9] = sbp2_status[9];
1073 sense_data[10] = sbp2_status[10];
1074 sense_data[11] = sbp2_status[11];
1075 sense_data[12] = sbp2_status[2];
1076 sense_data[13] = sbp2_status[3];
1077 sense_data[14] = sbp2_status[12];
1078 sense_data[15] = sbp2_status[13];
1080 sam_status = sbp2_status[0] & 0x3f;
1082 switch (sam_status) {
1084 case SAM_STAT_CHECK_CONDITION:
1085 case SAM_STAT_CONDITION_MET:
1087 case SAM_STAT_RESERVATION_CONFLICT:
1088 case SAM_STAT_COMMAND_TERMINATED:
1089 return DID_OK << 16 | sam_status;
1092 return DID_ERROR << 16;
1097 complete_command_orb(struct sbp2_orb *base_orb, struct sbp2_status *status)
1099 struct sbp2_command_orb *orb =
1100 container_of(base_orb, struct sbp2_command_orb, base);
1101 struct fw_device *device = fw_device(orb->lu->tgt->unit->device.parent);
1104 if (status != NULL) {
1105 if (STATUS_GET_DEAD(*status))
1106 sbp2_agent_reset_no_wait(orb->lu);
1108 switch (STATUS_GET_RESPONSE(*status)) {
1109 case SBP2_STATUS_REQUEST_COMPLETE:
1110 result = DID_OK << 16;
1112 case SBP2_STATUS_TRANSPORT_FAILURE:
1113 result = DID_BUS_BUSY << 16;
1115 case SBP2_STATUS_ILLEGAL_REQUEST:
1116 case SBP2_STATUS_VENDOR_DEPENDENT:
1118 result = DID_ERROR << 16;
1122 if (result == DID_OK << 16 && STATUS_GET_LEN(*status) > 1)
1123 result = sbp2_status_to_sense_data(STATUS_GET_DATA(*status),
1124 orb->cmd->sense_buffer);
1127 * If the orb completes with status == NULL, something
1128 * went wrong, typically a bus reset happened mid-orb
1129 * or when sending the write (less likely).
1131 result = DID_BUS_BUSY << 16;
1134 dma_unmap_single(device->card->device, orb->base.request_bus,
1135 sizeof(orb->request), DMA_TO_DEVICE);
1137 if (scsi_sg_count(orb->cmd) > 0)
1138 dma_unmap_sg(device->card->device, scsi_sglist(orb->cmd),
1139 scsi_sg_count(orb->cmd),
1140 orb->cmd->sc_data_direction);
1142 if (orb->page_table_bus != 0)
1143 dma_unmap_single(device->card->device, orb->page_table_bus,
1144 sizeof(orb->page_table), DMA_TO_DEVICE);
1146 orb->cmd->result = result;
1147 orb->done(orb->cmd);
1151 sbp2_map_scatterlist(struct sbp2_command_orb *orb, struct fw_device *device,
1152 struct sbp2_logical_unit *lu)
1154 struct scatterlist *sg;
1155 int sg_len, l, i, j, count;
1158 sg = scsi_sglist(orb->cmd);
1159 count = dma_map_sg(device->card->device, sg, scsi_sg_count(orb->cmd),
1160 orb->cmd->sc_data_direction);
1165 * Handle the special case where there is only one element in
1166 * the scatter list by converting it to an immediate block
1167 * request. This is also a workaround for broken devices such
1168 * as the second generation iPod which doesn't support page
1171 if (count == 1 && sg_dma_len(sg) < SBP2_MAX_SG_ELEMENT_LENGTH) {
1172 orb->request.data_descriptor.high = lu->tgt->address_high;
1173 orb->request.data_descriptor.low = sg_dma_address(sg);
1174 orb->request.misc |= COMMAND_ORB_DATA_SIZE(sg_dma_len(sg));
1179 * Convert the scatterlist to an sbp2 page table. If any
1180 * scatterlist entries are too big for sbp2, we split them as we
1181 * go. Even if we ask the block I/O layer to not give us sg
1182 * elements larger than 65535 bytes, some IOMMUs may merge sg elements
1183 * during DMA mapping, and Linux currently doesn't prevent this.
1185 for (i = 0, j = 0; i < count; i++, sg = sg_next(sg)) {
1186 sg_len = sg_dma_len(sg);
1187 sg_addr = sg_dma_address(sg);
1189 /* FIXME: This won't get us out of the pinch. */
1190 if (unlikely(j >= ARRAY_SIZE(orb->page_table))) {
1191 fw_error("page table overflow\n");
1192 goto fail_page_table;
1194 l = min(sg_len, SBP2_MAX_SG_ELEMENT_LENGTH);
1195 orb->page_table[j].low = sg_addr;
1196 orb->page_table[j].high = (l << 16);
1203 fw_memcpy_to_be32(orb->page_table, orb->page_table,
1204 sizeof(orb->page_table[0]) * j);
1205 orb->page_table_bus =
1206 dma_map_single(device->card->device, orb->page_table,
1207 sizeof(orb->page_table), DMA_TO_DEVICE);
1208 if (dma_mapping_error(orb->page_table_bus))
1209 goto fail_page_table;
1212 * The data_descriptor pointer is the one case where we need
1213 * to fill in the node ID part of the address. All other
1214 * pointers assume that the data referenced reside on the
1215 * initiator (i.e. us), but data_descriptor can refer to data
1216 * on other nodes so we need to put our ID in descriptor.high.
1218 orb->request.data_descriptor.high = lu->tgt->address_high;
1219 orb->request.data_descriptor.low = orb->page_table_bus;
1220 orb->request.misc |=
1221 COMMAND_ORB_PAGE_TABLE_PRESENT |
1222 COMMAND_ORB_DATA_SIZE(j);
1227 dma_unmap_sg(device->card->device, sg, scsi_sg_count(orb->cmd),
1228 orb->cmd->sc_data_direction);
1233 /* SCSI stack integration */
1235 static int sbp2_scsi_queuecommand(struct scsi_cmnd *cmd, scsi_done_fn_t done)
1237 struct sbp2_logical_unit *lu = cmd->device->hostdata;
1238 struct fw_device *device = fw_device(lu->tgt->unit->device.parent);
1239 struct sbp2_command_orb *orb;
1240 unsigned int max_payload;
1241 int retval = SCSI_MLQUEUE_HOST_BUSY;
1244 * Bidirectional commands are not yet implemented, and unknown
1245 * transfer direction not handled.
1247 if (cmd->sc_data_direction == DMA_BIDIRECTIONAL) {
1248 fw_error("Can't handle DMA_BIDIRECTIONAL, rejecting command\n");
1249 cmd->result = DID_ERROR << 16;
1254 orb = kzalloc(sizeof(*orb), GFP_ATOMIC);
1256 fw_notify("failed to alloc orb\n");
1257 return SCSI_MLQUEUE_HOST_BUSY;
1260 /* Initialize rcode to something not RCODE_COMPLETE. */
1261 orb->base.rcode = -1;
1262 kref_init(&orb->base.kref);
1268 orb->request.next.high = SBP2_ORB_NULL;
1269 orb->request.next.low = 0x0;
1271 * At speed 100 we can do 512 bytes per packet, at speed 200,
1272 * 1024 bytes per packet etc. The SBP-2 max_payload field
1273 * specifies the max payload size as 2 ^ (max_payload + 2), so
1274 * if we set this to max_speed + 7, we get the right value.
1276 max_payload = min(device->max_speed + 7,
1277 device->card->max_receive - 1);
1279 COMMAND_ORB_MAX_PAYLOAD(max_payload) |
1280 COMMAND_ORB_SPEED(device->max_speed) |
1283 if (cmd->sc_data_direction == DMA_FROM_DEVICE)
1284 orb->request.misc |=
1285 COMMAND_ORB_DIRECTION(SBP2_DIRECTION_FROM_MEDIA);
1286 else if (cmd->sc_data_direction == DMA_TO_DEVICE)
1287 orb->request.misc |=
1288 COMMAND_ORB_DIRECTION(SBP2_DIRECTION_TO_MEDIA);
1290 if (scsi_sg_count(cmd) && sbp2_map_scatterlist(orb, device, lu) < 0)
1293 fw_memcpy_to_be32(&orb->request, &orb->request, sizeof(orb->request));
1295 memset(orb->request.command_block,
1296 0, sizeof(orb->request.command_block));
1297 memcpy(orb->request.command_block, cmd->cmnd, COMMAND_SIZE(*cmd->cmnd));
1299 orb->base.callback = complete_command_orb;
1300 orb->base.request_bus =
1301 dma_map_single(device->card->device, &orb->request,
1302 sizeof(orb->request), DMA_TO_DEVICE);
1303 if (dma_mapping_error(orb->base.request_bus))
1306 sbp2_send_orb(&orb->base, lu, lu->tgt->node_id, lu->generation,
1307 lu->command_block_agent_address + SBP2_ORB_POINTER);
1310 kref_put(&orb->base.kref, free_orb);
1314 static int sbp2_scsi_slave_alloc(struct scsi_device *sdev)
1316 struct sbp2_logical_unit *lu = sdev->hostdata;
1318 sdev->allow_restart = 1;
1321 * Update the dma alignment (minimum alignment requirements for
1322 * start and end of DMA transfers) to be a sector
1324 blk_queue_update_dma_alignment(sdev->request_queue, 511);
1326 if (lu->tgt->workarounds & SBP2_WORKAROUND_INQUIRY_36)
1327 sdev->inquiry_len = 36;
1332 static int sbp2_scsi_slave_configure(struct scsi_device *sdev)
1334 struct sbp2_logical_unit *lu = sdev->hostdata;
1336 sdev->use_10_for_rw = 1;
1338 if (sdev->type == TYPE_ROM)
1339 sdev->use_10_for_ms = 1;
1341 if (sdev->type == TYPE_DISK &&
1342 lu->tgt->workarounds & SBP2_WORKAROUND_MODE_SENSE_8)
1343 sdev->skip_ms_page_8 = 1;
1345 if (lu->tgt->workarounds & SBP2_WORKAROUND_FIX_CAPACITY)
1346 sdev->fix_capacity = 1;
1348 if (lu->tgt->workarounds & SBP2_WORKAROUND_128K_MAX_TRANS)
1349 blk_queue_max_sectors(sdev->request_queue, 128 * 1024 / 512);
1355 * Called by scsi stack when something has really gone wrong. Usually
1356 * called when a command has timed-out for some reason.
1358 static int sbp2_scsi_abort(struct scsi_cmnd *cmd)
1360 struct sbp2_logical_unit *lu = cmd->device->hostdata;
1362 fw_notify("sbp2_scsi_abort\n");
1363 sbp2_agent_reset(lu);
1364 sbp2_cancel_orbs(lu);
1370 * Format of /sys/bus/scsi/devices/.../ieee1394_id:
1371 * u64 EUI-64 : u24 directory_ID : u16 LUN (all printed in hexadecimal)
1373 * This is the concatenation of target port identifier and logical unit
1374 * identifier as per SAM-2...SAM-4 annex A.
1377 sbp2_sysfs_ieee1394_id_show(struct device *dev, struct device_attribute *attr,
1380 struct scsi_device *sdev = to_scsi_device(dev);
1381 struct sbp2_logical_unit *lu;
1382 struct fw_device *device;
1387 lu = sdev->hostdata;
1388 device = fw_device(lu->tgt->unit->device.parent);
1390 return sprintf(buf, "%08x%08x:%06x:%04x\n",
1391 device->config_rom[3], device->config_rom[4],
1392 lu->tgt->directory_id, lu->lun);
1395 static DEVICE_ATTR(ieee1394_id, S_IRUGO, sbp2_sysfs_ieee1394_id_show, NULL);
1397 static struct device_attribute *sbp2_scsi_sysfs_attrs[] = {
1398 &dev_attr_ieee1394_id,
1402 static struct scsi_host_template scsi_driver_template = {
1403 .module = THIS_MODULE,
1404 .name = "SBP-2 IEEE-1394",
1405 .proc_name = sbp2_driver_name,
1406 .queuecommand = sbp2_scsi_queuecommand,
1407 .slave_alloc = sbp2_scsi_slave_alloc,
1408 .slave_configure = sbp2_scsi_slave_configure,
1409 .eh_abort_handler = sbp2_scsi_abort,
1411 .sg_tablesize = SG_ALL,
1412 .use_clustering = ENABLE_CLUSTERING,
1415 .sdev_attrs = sbp2_scsi_sysfs_attrs,
1418 MODULE_AUTHOR("Kristian Hoegsberg <krh@bitplanet.net>");
1419 MODULE_DESCRIPTION("SCSI over IEEE1394");
1420 MODULE_LICENSE("GPL");
1421 MODULE_DEVICE_TABLE(ieee1394, sbp2_id_table);
1423 /* Provide a module alias so root-on-sbp2 initrds don't break. */
1424 #ifndef CONFIG_IEEE1394_SBP2_MODULE
1425 MODULE_ALIAS("sbp2");
1428 static int __init sbp2_init(void)
1430 sbp2_wq = create_singlethread_workqueue(KBUILD_MODNAME);
1434 return driver_register(&sbp2_driver.driver);
1437 static void __exit sbp2_cleanup(void)
1439 driver_unregister(&sbp2_driver.driver);
1440 destroy_workqueue(sbp2_wq);
1443 module_init(sbp2_init);
1444 module_exit(sbp2_cleanup);