1 /* Driver for Freecom USB/IDE adaptor
7 * Current development and maintenance by:
8 * (C) 2000 David Brown <usb-storage@davidb.org>
10 * This program is free software; you can redistribute it and/or modify it
11 * under the terms of the GNU General Public License as published by the
12 * Free Software Foundation; either version 2, or (at your option) any
15 * This program is distributed in the hope that it will be useful, but
16 * WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 * General Public License for more details.
20 * You should have received a copy of the GNU General Public License along
21 * with this program; if not, write to the Free Software Foundation, Inc.,
22 * 675 Mass Ave, Cambridge, MA 02139, USA.
24 * This driver was developed with information provided in FREECOM's USB
25 * Programmers Reference Guide. For further information contact Freecom
26 * (http://www.freecom.de/)
29 #include <linux/module.h>
30 #include <scsi/scsi.h>
31 #include <scsi/scsi_cmnd.h>
34 #include "transport.h"
38 MODULE_DESCRIPTION("Driver for Freecom USB/IDE adaptor");
39 MODULE_AUTHOR("David Brown <usb-storage@davidb.org>");
40 MODULE_LICENSE("GPL");
42 #ifdef CONFIG_USB_STORAGE_DEBUG
43 static void pdump (void *, int);
46 /* Bits of HD_STATUS */
50 /* All of the outgoing packets are 64 bytes long. */
51 struct freecom_cb_wrap
{
52 u8 Type
; /* Command type. */
53 u8 Timeout
; /* Timeout in seconds. */
54 u8 Atapi
[12]; /* An ATAPI packet. */
55 u8 Filler
[50]; /* Padding Data. */
58 struct freecom_xfer_wrap
{
59 u8 Type
; /* Command type. */
60 u8 Timeout
; /* Timeout in seconds. */
61 __le32 Count
; /* Number of bytes to transfer. */
63 } __attribute__ ((packed
));
65 struct freecom_ide_out
{
66 u8 Type
; /* Type + IDE register. */
68 __le16 Value
; /* Value to write. */
72 struct freecom_ide_in
{
73 u8 Type
; /* Type | IDE register. */
77 struct freecom_status
{
84 /* Freecom stuffs the interrupt status in the INDEX_STAT bit of the ide
86 #define FCM_INT_STATUS 0x02 /* INDEX_STAT */
87 #define FCM_STATUS_BUSY 0x80
89 /* These are the packet types. The low bit indicates that this command
90 * should wait for an interrupt. */
91 #define FCM_PACKET_ATAPI 0x21
92 #define FCM_PACKET_STATUS 0x20
94 /* Receive data from the IDE interface. The ATAPI packet has already
95 * waited, so the data should be immediately available. */
96 #define FCM_PACKET_INPUT 0x81
98 /* Send data to the IDE interface. */
99 #define FCM_PACKET_OUTPUT 0x01
101 /* Write a value to an ide register. Or the ide register to write after
102 * munging the address a bit. */
103 #define FCM_PACKET_IDE_WRITE 0x40
104 #define FCM_PACKET_IDE_READ 0xC0
106 /* All packets (except for status) are 64 bytes long. */
107 #define FCM_PACKET_LENGTH 64
108 #define FCM_STATUS_PACKET_LENGTH 4
110 static int init_freecom(struct us_data
*us
);
114 * The table of devices
116 #define UNUSUAL_DEV(id_vendor, id_product, bcdDeviceMin, bcdDeviceMax, \
117 vendorName, productName, useProtocol, useTransport, \
118 initFunction, flags) \
119 { USB_DEVICE_VER(id_vendor, id_product, bcdDeviceMin, bcdDeviceMax), \
120 .driver_info = (flags)|(USB_US_TYPE_STOR<<24) }
122 struct usb_device_id freecom_usb_ids
[] = {
123 # include "unusual_freecom.h"
124 { } /* Terminating entry */
126 MODULE_DEVICE_TABLE(usb
, freecom_usb_ids
);
133 #define UNUSUAL_DEV(idVendor, idProduct, bcdDeviceMin, bcdDeviceMax, \
134 vendor_name, product_name, use_protocol, use_transport, \
135 init_function, Flags) \
137 .vendorName = vendor_name, \
138 .productName = product_name, \
139 .useProtocol = use_protocol, \
140 .useTransport = use_transport, \
141 .initFunction = init_function, \
144 static struct us_unusual_dev freecom_unusual_dev_list
[] = {
145 # include "unusual_freecom.h"
146 { } /* Terminating entry */
152 freecom_readdata (struct scsi_cmnd
*srb
, struct us_data
*us
,
153 unsigned int ipipe
, unsigned int opipe
, int count
)
155 struct freecom_xfer_wrap
*fxfr
=
156 (struct freecom_xfer_wrap
*) us
->iobuf
;
159 fxfr
->Type
= FCM_PACKET_INPUT
| 0x00;
160 fxfr
->Timeout
= 0; /* Short timeout for debugging. */
161 fxfr
->Count
= cpu_to_le32 (count
);
162 memset (fxfr
->Pad
, 0, sizeof (fxfr
->Pad
));
164 US_DEBUGP("Read data Freecom! (c=%d)\n", count
);
166 /* Issue the transfer command. */
167 result
= usb_stor_bulk_transfer_buf (us
, opipe
, fxfr
,
168 FCM_PACKET_LENGTH
, NULL
);
169 if (result
!= USB_STOR_XFER_GOOD
) {
170 US_DEBUGP ("Freecom readdata transport error\n");
171 return USB_STOR_TRANSPORT_ERROR
;
174 /* Now transfer all of our blocks. */
175 US_DEBUGP("Start of read\n");
176 result
= usb_stor_bulk_srb(us
, ipipe
, srb
);
177 US_DEBUGP("freecom_readdata done!\n");
179 if (result
> USB_STOR_XFER_SHORT
)
180 return USB_STOR_TRANSPORT_ERROR
;
181 return USB_STOR_TRANSPORT_GOOD
;
185 freecom_writedata (struct scsi_cmnd
*srb
, struct us_data
*us
,
186 int unsigned ipipe
, unsigned int opipe
, int count
)
188 struct freecom_xfer_wrap
*fxfr
=
189 (struct freecom_xfer_wrap
*) us
->iobuf
;
192 fxfr
->Type
= FCM_PACKET_OUTPUT
| 0x00;
193 fxfr
->Timeout
= 0; /* Short timeout for debugging. */
194 fxfr
->Count
= cpu_to_le32 (count
);
195 memset (fxfr
->Pad
, 0, sizeof (fxfr
->Pad
));
197 US_DEBUGP("Write data Freecom! (c=%d)\n", count
);
199 /* Issue the transfer command. */
200 result
= usb_stor_bulk_transfer_buf (us
, opipe
, fxfr
,
201 FCM_PACKET_LENGTH
, NULL
);
202 if (result
!= USB_STOR_XFER_GOOD
) {
203 US_DEBUGP ("Freecom writedata transport error\n");
204 return USB_STOR_TRANSPORT_ERROR
;
207 /* Now transfer all of our blocks. */
208 US_DEBUGP("Start of write\n");
209 result
= usb_stor_bulk_srb(us
, opipe
, srb
);
211 US_DEBUGP("freecom_writedata done!\n");
212 if (result
> USB_STOR_XFER_SHORT
)
213 return USB_STOR_TRANSPORT_ERROR
;
214 return USB_STOR_TRANSPORT_GOOD
;
218 * Transport for the Freecom USB/IDE adaptor.
221 static int freecom_transport(struct scsi_cmnd
*srb
, struct us_data
*us
)
223 struct freecom_cb_wrap
*fcb
;
224 struct freecom_status
*fst
;
225 unsigned int ipipe
, opipe
; /* We need both pipes. */
227 unsigned int partial
;
230 fcb
= (struct freecom_cb_wrap
*) us
->iobuf
;
231 fst
= (struct freecom_status
*) us
->iobuf
;
233 US_DEBUGP("Freecom TRANSPORT STARTED\n");
235 /* Get handles for both transports. */
236 opipe
= us
->send_bulk_pipe
;
237 ipipe
= us
->recv_bulk_pipe
;
239 /* The ATAPI Command always goes out first. */
240 fcb
->Type
= FCM_PACKET_ATAPI
| 0x00;
242 memcpy (fcb
->Atapi
, srb
->cmnd
, 12);
243 memset (fcb
->Filler
, 0, sizeof (fcb
->Filler
));
245 US_DEBUG(pdump (srb
->cmnd
, 12));
248 result
= usb_stor_bulk_transfer_buf (us
, opipe
, fcb
,
249 FCM_PACKET_LENGTH
, NULL
);
251 /* The Freecom device will only fail if there is something wrong in
252 * USB land. It returns the status in its own registers, which
253 * come back in the bulk pipe. */
254 if (result
!= USB_STOR_XFER_GOOD
) {
255 US_DEBUGP ("freecom transport error\n");
256 return USB_STOR_TRANSPORT_ERROR
;
259 /* There are times we can optimize out this status read, but it
260 * doesn't hurt us to always do it now. */
261 result
= usb_stor_bulk_transfer_buf (us
, ipipe
, fst
,
262 FCM_STATUS_PACKET_LENGTH
, &partial
);
263 US_DEBUGP("foo Status result %d %u\n", result
, partial
);
264 if (result
!= USB_STOR_XFER_GOOD
)
265 return USB_STOR_TRANSPORT_ERROR
;
267 US_DEBUG(pdump ((void *) fst
, partial
));
269 /* The firmware will time-out commands after 20 seconds. Some commands
270 * can legitimately take longer than this, so we use a different
271 * command that only waits for the interrupt and then sends status,
272 * without having to send a new ATAPI command to the device.
274 * NOTE: There is some indication that a data transfer after a timeout
275 * may not work, but that is a condition that should never happen.
277 while (fst
->Status
& FCM_STATUS_BUSY
) {
278 US_DEBUGP("20 second USB/ATAPI bridge TIMEOUT occurred!\n");
279 US_DEBUGP("fst->Status is %x\n", fst
->Status
);
281 /* Get the status again */
282 fcb
->Type
= FCM_PACKET_STATUS
;
284 memset (fcb
->Atapi
, 0, sizeof(fcb
->Atapi
));
285 memset (fcb
->Filler
, 0, sizeof (fcb
->Filler
));
288 result
= usb_stor_bulk_transfer_buf (us
, opipe
, fcb
,
289 FCM_PACKET_LENGTH
, NULL
);
291 /* The Freecom device will only fail if there is something
292 * wrong in USB land. It returns the status in its own
293 * registers, which come back in the bulk pipe.
295 if (result
!= USB_STOR_XFER_GOOD
) {
296 US_DEBUGP ("freecom transport error\n");
297 return USB_STOR_TRANSPORT_ERROR
;
301 result
= usb_stor_bulk_transfer_buf (us
, ipipe
, fst
,
302 FCM_STATUS_PACKET_LENGTH
, &partial
);
304 US_DEBUGP("bar Status result %d %u\n", result
, partial
);
305 if (result
!= USB_STOR_XFER_GOOD
)
306 return USB_STOR_TRANSPORT_ERROR
;
308 US_DEBUG(pdump ((void *) fst
, partial
));
312 return USB_STOR_TRANSPORT_ERROR
;
313 if ((fst
->Status
& 1) != 0) {
314 US_DEBUGP("operation failed\n");
315 return USB_STOR_TRANSPORT_FAILED
;
318 /* The device might not have as much data available as we
319 * requested. If you ask for more than the device has, this reads
320 * and such will hang. */
321 US_DEBUGP("Device indicates that it has %d bytes available\n",
322 le16_to_cpu (fst
->Count
));
323 US_DEBUGP("SCSI requested %d\n", scsi_bufflen(srb
));
325 /* Find the length we desire to read. */
326 switch (srb
->cmnd
[0]) {
328 case REQUEST_SENSE
: /* 16 or 18 bytes? spec says 18, lots of devices only have 16 */
331 length
= le16_to_cpu(fst
->Count
);
334 length
= scsi_bufflen(srb
);
337 /* verify that this amount is legal */
338 if (length
> scsi_bufflen(srb
)) {
339 length
= scsi_bufflen(srb
);
340 US_DEBUGP("Truncating request to match buffer length: %d\n", length
);
343 /* What we do now depends on what direction the data is supposed to
346 switch (us
->srb
->sc_data_direction
) {
347 case DMA_FROM_DEVICE
:
348 /* catch bogus "read 0 length" case */
351 /* Make sure that the status indicates that the device
352 * wants data as well. */
353 if ((fst
->Status
& DRQ_STAT
) == 0 || (fst
->Reason
& 3) != 2) {
354 US_DEBUGP("SCSI wants data, drive doesn't have any\n");
355 return USB_STOR_TRANSPORT_FAILED
;
357 result
= freecom_readdata (srb
, us
, ipipe
, opipe
, length
);
358 if (result
!= USB_STOR_TRANSPORT_GOOD
)
361 US_DEBUGP("FCM: Waiting for status\n");
362 result
= usb_stor_bulk_transfer_buf (us
, ipipe
, fst
,
363 FCM_PACKET_LENGTH
, &partial
);
364 US_DEBUG(pdump ((void *) fst
, partial
));
366 if (partial
!= 4 || result
> USB_STOR_XFER_SHORT
)
367 return USB_STOR_TRANSPORT_ERROR
;
368 if ((fst
->Status
& ERR_STAT
) != 0) {
369 US_DEBUGP("operation failed\n");
370 return USB_STOR_TRANSPORT_FAILED
;
372 if ((fst
->Reason
& 3) != 3) {
373 US_DEBUGP("Drive seems still hungry\n");
374 return USB_STOR_TRANSPORT_FAILED
;
376 US_DEBUGP("Transfer happy\n");
380 /* catch bogus "write 0 length" case */
383 /* Make sure the status indicates that the device wants to
386 result
= freecom_writedata (srb
, us
, ipipe
, opipe
, length
);
387 if (result
!= USB_STOR_TRANSPORT_GOOD
)
390 US_DEBUGP("FCM: Waiting for status\n");
391 result
= usb_stor_bulk_transfer_buf (us
, ipipe
, fst
,
392 FCM_PACKET_LENGTH
, &partial
);
394 if (partial
!= 4 || result
> USB_STOR_XFER_SHORT
)
395 return USB_STOR_TRANSPORT_ERROR
;
396 if ((fst
->Status
& ERR_STAT
) != 0) {
397 US_DEBUGP("operation failed\n");
398 return USB_STOR_TRANSPORT_FAILED
;
400 if ((fst
->Reason
& 3) != 3) {
401 US_DEBUGP("Drive seems still hungry\n");
402 return USB_STOR_TRANSPORT_FAILED
;
405 US_DEBUGP("Transfer happy\n");
410 /* Easy, do nothing. */
414 /* should never hit here -- filtered in usb.c */
415 US_DEBUGP ("freecom unimplemented direction: %d\n",
416 us
->srb
->sc_data_direction
);
417 // Return fail, SCSI seems to handle this better.
418 return USB_STOR_TRANSPORT_FAILED
;
422 return USB_STOR_TRANSPORT_GOOD
;
425 static int init_freecom(struct us_data
*us
)
428 char *buffer
= us
->iobuf
;
430 /* The DMA-mapped I/O buffer is 64 bytes long, just right for
431 * all our packets. No need to allocate any extra buffer space.
434 result
= usb_stor_control_msg(us
, us
->recv_ctrl_pipe
,
435 0x4c, 0xc0, 0x4346, 0x0, buffer
, 0x20, 3*HZ
);
437 US_DEBUGP("String returned from FC init is: %s\n", buffer
);
439 /* Special thanks to the people at Freecom for providing me with
440 * this "magic sequence", which they use in their Windows and MacOS
441 * drivers to make sure that all the attached perhiperals are
446 result
= usb_stor_control_msg(us
, us
->send_ctrl_pipe
,
447 0x4d, 0x40, 0x24d8, 0x0, NULL
, 0x0, 3*HZ
);
448 US_DEBUGP("result from activate reset is %d\n", result
);
454 result
= usb_stor_control_msg(us
, us
->send_ctrl_pipe
,
455 0x4d, 0x40, 0x24f8, 0x0, NULL
, 0x0, 3*HZ
);
456 US_DEBUGP("result from clear reset is %d\n", result
);
461 return USB_STOR_TRANSPORT_GOOD
;
464 static int usb_stor_freecom_reset(struct us_data
*us
)
466 printk (KERN_CRIT
"freecom reset called\n");
468 /* We don't really have this feature. */
472 #ifdef CONFIG_USB_STORAGE_DEBUG
473 static void pdump (void *ibuffer
, int length
)
475 static char line
[80];
477 unsigned char *buffer
= (unsigned char *) ibuffer
;
482 for (i
= 0; i
< length
; i
++) {
485 offset
+= sprintf (line
+offset
, " - ");
486 for (j
= i
- 16; j
< i
; j
++) {
487 if (buffer
[j
] >= 32 && buffer
[j
] <= 126)
488 line
[offset
++] = buffer
[j
];
490 line
[offset
++] = '.';
493 US_DEBUGP("%s\n", line
);
496 offset
+= sprintf (line
+offset
, "%08x:", i
);
498 else if ((i
& 7) == 0) {
499 offset
+= sprintf (line
+offset
, " -");
501 offset
+= sprintf (line
+offset
, " %02x", buffer
[i
] & 0xff);
504 /* Add the last "chunk" of data. */
505 from
= (length
- 1) % 16;
506 base
= ((length
- 1) / 16) * 16;
508 for (i
= from
+ 1; i
< 16; i
++)
509 offset
+= sprintf (line
+offset
, " ");
511 offset
+= sprintf (line
+offset
, " ");
512 offset
+= sprintf (line
+offset
, " - ");
514 for (i
= 0; i
<= from
; i
++) {
515 if (buffer
[base
+i
] >= 32 && buffer
[base
+i
] <= 126)
516 line
[offset
++] = buffer
[base
+i
];
518 line
[offset
++] = '.';
521 US_DEBUGP("%s\n", line
);
526 static int freecom_probe(struct usb_interface
*intf
,
527 const struct usb_device_id
*id
)
532 result
= usb_stor_probe1(&us
, intf
, id
,
533 (id
- freecom_usb_ids
) + freecom_unusual_dev_list
);
537 us
->transport_name
= "Freecom";
538 us
->transport
= freecom_transport
;
539 us
->transport_reset
= usb_stor_freecom_reset
;
542 result
= usb_stor_probe2(us
);
546 static struct usb_driver freecom_driver
= {
547 .name
= "ums-freecom",
548 .probe
= freecom_probe
,
549 .disconnect
= usb_stor_disconnect
,
550 .suspend
= usb_stor_suspend
,
551 .resume
= usb_stor_resume
,
552 .reset_resume
= usb_stor_reset_resume
,
553 .pre_reset
= usb_stor_pre_reset
,
554 .post_reset
= usb_stor_post_reset
,
555 .id_table
= freecom_usb_ids
,
559 static int __init
freecom_init(void)
561 return usb_register(&freecom_driver
);
564 static void __exit
freecom_exit(void)
566 usb_deregister(&freecom_driver
);
569 module_init(freecom_init
);
570 module_exit(freecom_exit
);