1 /* Driver for SanDisk SDDR-09 SmartMedia reader
3 * $Id: sddr09.c,v 1.24 2002/04/22 03:39:43 mdharm Exp $
4 * (c) 2000, 2001 Robert Baruch (autophile@starband.net)
5 * (c) 2002 Andries Brouwer (aeb@cwi.nl)
6 * Developed with the assistance of:
7 * (c) 2002 Alan Stern <stern@rowland.org>
9 * The SanDisk SDDR-09 SmartMedia reader uses the Shuttle EUSB-01 chip.
10 * This chip is a programmable USB controller. In the SDDR-09, it has
11 * been programmed to obey a certain limited set of SCSI commands.
12 * This driver translates the "real" SCSI commands to the SDDR-09 SCSI
15 * This program is free software; you can redistribute it and/or modify it
16 * under the terms of the GNU General Public License as published by the
17 * Free Software Foundation; either version 2, or (at your option) any
20 * This program is distributed in the hope that it will be useful, but
21 * WITHOUT ANY WARRANTY; without even the implied warranty of
22 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
23 * General Public License for more details.
25 * You should have received a copy of the GNU General Public License along
26 * with this program; if not, write to the Free Software Foundation, Inc.,
27 * 675 Mass Ave, Cambridge, MA 02139, USA.
31 * Known vendor commands: 12 bytes, first byte is opcode
33 * E7: read scatter gather
41 * EF: compute checksum (?)
44 #include <linux/sched.h>
45 #include <linux/errno.h>
46 #include <linux/slab.h>
48 #include <scsi/scsi.h>
49 #include <scsi/scsi_cmnd.h>
52 #include "transport.h"
58 #define short_pack(lsb,msb) ( ((u16)(lsb)) | ( ((u16)(msb))<<8 ) )
59 #define LSB_of(s) ((s)&0xFF)
60 #define MSB_of(s) ((s)>>8)
62 /* #define US_DEBUGP printk */
65 * First some stuff that does not belong here:
66 * data on SmartMedia and other cards, completely
67 * unrelated to this driver.
68 * Similar stuff occurs in <linux/mtd/nand_ids.h>.
71 struct nand_flash_dev {
73 int chipshift; /* 1<<cs bytes total capacity */
74 char pageshift; /* 1<<ps bytes in a page */
75 char blockshift; /* 1<<bs pages in an erase block */
76 char zoneshift; /* 1<<zs blocks in a zone */
77 /* # of logical blocks is 125/128 of this */
78 char pageadrlen; /* length of an address in bytes - 1 */
82 * NAND Flash Manufacturer ID Codes
84 #define NAND_MFR_AMD 0x01
85 #define NAND_MFR_NATSEMI 0x8f
86 #define NAND_MFR_TOSHIBA 0x98
87 #define NAND_MFR_SAMSUNG 0xec
89 static inline char *nand_flash_manufacturer(int manuf_id) {
93 case NAND_MFR_NATSEMI:
95 case NAND_MFR_TOSHIBA:
97 case NAND_MFR_SAMSUNG:
105 * It looks like it is unnecessary to attach manufacturer to the
106 * remaining data: SSFDC prescribes manufacturer-independent id codes.
108 * 256 MB NAND flash has a 5-byte ID with 2nd byte 0xaa, 0xba, 0xca or 0xda.
111 static struct nand_flash_dev nand_flash_ids[] = {
113 { 0x6e, 20, 8, 4, 8, 2}, /* 1 MB */
114 { 0xe8, 20, 8, 4, 8, 2}, /* 1 MB */
115 { 0xec, 20, 8, 4, 8, 2}, /* 1 MB */
116 { 0x64, 21, 8, 4, 9, 2}, /* 2 MB */
117 { 0xea, 21, 8, 4, 9, 2}, /* 2 MB */
118 { 0x6b, 22, 9, 4, 9, 2}, /* 4 MB */
119 { 0xe3, 22, 9, 4, 9, 2}, /* 4 MB */
120 { 0xe5, 22, 9, 4, 9, 2}, /* 4 MB */
121 { 0xe6, 23, 9, 4, 10, 2}, /* 8 MB */
122 { 0x73, 24, 9, 5, 10, 2}, /* 16 MB */
123 { 0x75, 25, 9, 5, 10, 2}, /* 32 MB */
124 { 0x76, 26, 9, 5, 10, 3}, /* 64 MB */
125 { 0x79, 27, 9, 5, 10, 3}, /* 128 MB */
128 { 0x5d, 21, 9, 4, 8, 2}, /* 2 MB */
129 { 0xd5, 22, 9, 4, 9, 2}, /* 4 MB */
130 { 0xd6, 23, 9, 4, 10, 2}, /* 8 MB */
131 { 0x57, 24, 9, 4, 11, 2}, /* 16 MB */
132 { 0x58, 25, 9, 4, 12, 2}, /* 32 MB */
136 static struct nand_flash_dev *
137 nand_find_id(unsigned char id) {
140 for (i = 0; i < ARRAY_SIZE(nand_flash_ids); i++)
141 if (nand_flash_ids[i].model_id == id)
142 return &(nand_flash_ids[i]);
149 static unsigned char parity[256];
150 static unsigned char ecc2[256];
152 static void nand_init_ecc(void) {
156 for (i = 1; i < 256; i++)
157 parity[i] = (parity[i&(i-1)] ^ 1);
159 for (i = 0; i < 256; i++) {
161 for (j = 0; j < 8; j++) {
171 ecc2[i] = ~(a ^ (a<<1) ^ (parity[i] ? 0xa8 : 0));
175 /* compute 3-byte ecc on 256 bytes */
176 static void nand_compute_ecc(unsigned char *data, unsigned char *ecc) {
178 unsigned char par, bit, bits[8];
181 for (j = 0; j < 8; j++)
184 /* collect 16 checksum bits */
185 for (i = 0; i < 256; i++) {
187 bit = parity[data[i]];
188 for (j = 0; j < 8; j++)
189 if ((i & (1<<j)) == 0)
193 /* put 4+4+4 = 12 bits in the ecc */
194 a = (bits[3] << 6) + (bits[2] << 4) + (bits[1] << 2) + bits[0];
195 ecc[0] = ~(a ^ (a<<1) ^ (parity[par] ? 0xaa : 0));
197 a = (bits[7] << 6) + (bits[6] << 4) + (bits[5] << 2) + bits[4];
198 ecc[1] = ~(a ^ (a<<1) ^ (parity[par] ? 0xaa : 0));
203 static int nand_compare_ecc(unsigned char *data, unsigned char *ecc) {
204 return (data[0] == ecc[0] && data[1] == ecc[1] && data[2] == ecc[2]);
207 static void nand_store_ecc(unsigned char *data, unsigned char *ecc) {
208 memcpy(data, ecc, 3);
212 * The actual driver starts here.
215 struct sddr09_card_info {
216 unsigned long capacity; /* Size of card in bytes */
217 int pagesize; /* Size of page in bytes */
218 int pageshift; /* log2 of pagesize */
219 int blocksize; /* Size of block in pages */
220 int blockshift; /* log2 of blocksize */
221 int blockmask; /* 2^blockshift - 1 */
222 int *lba_to_pba; /* logical to physical map */
223 int *pba_to_lba; /* physical to logical map */
224 int lbact; /* number of available pages */
226 #define SDDR09_WP 1 /* write protected */
230 * On my 16MB card, control blocks have size 64 (16 real control bytes,
231 * and 48 junk bytes). In reality of course the card uses 16 control bytes,
232 * so the reader makes up the remaining 48. Don't know whether these numbers
233 * depend on the card. For now a constant.
235 #define CONTROL_SHIFT 6
238 * On my Combo CF/SM reader, the SM reader has LUN 1.
239 * (and things fail with LUN 0).
240 * It seems LUN is irrelevant for others.
243 #define LUNBITS (LUN << 5)
246 * LBA and PBA are unsigned ints. Special values.
248 #define UNDEF 0xffffffff
249 #define SPARE 0xfffffffe
250 #define UNUSABLE 0xfffffffd
252 static const int erase_bad_lba_entries = 0;
254 /* send vendor interface command (0x41) */
255 /* called for requests 0, 1, 8 */
257 sddr09_send_command(struct us_data *us,
258 unsigned char request,
259 unsigned char direction,
260 unsigned char *xfer_data,
261 unsigned int xfer_len) {
263 unsigned char requesttype = (0x41 | direction);
266 // Get the receive or send control pipe number
268 if (direction == USB_DIR_IN)
269 pipe = us->recv_ctrl_pipe;
271 pipe = us->send_ctrl_pipe;
273 rc = usb_stor_ctrl_transfer(us, pipe, request, requesttype,
274 0, 0, xfer_data, xfer_len);
276 case USB_STOR_XFER_GOOD: return 0;
277 case USB_STOR_XFER_STALLED: return -EPIPE;
278 default: return -EIO;
283 sddr09_send_scsi_command(struct us_data *us,
284 unsigned char *command,
285 unsigned int command_len) {
286 return sddr09_send_command(us, 0, USB_DIR_OUT, command, command_len);
291 * Test Unit Ready Command: 12 bytes.
295 sddr09_test_unit_ready(struct us_data *us) {
296 unsigned char *command = us->iobuf;
299 memset(command, 0, 6);
300 command[1] = LUNBITS;
302 result = sddr09_send_scsi_command(us, command, 6);
304 US_DEBUGP("sddr09_test_unit_ready returns %d\n", result);
311 * Request Sense Command: 12 bytes.
313 * byte 4: data length
316 sddr09_request_sense(struct us_data *us, unsigned char *sensebuf, int buflen) {
317 unsigned char *command = us->iobuf;
320 memset(command, 0, 12);
322 command[1] = LUNBITS;
325 result = sddr09_send_scsi_command(us, command, 12);
329 result = usb_stor_bulk_transfer_buf(us, us->recv_bulk_pipe,
330 sensebuf, buflen, NULL);
331 return (result == USB_STOR_XFER_GOOD ? 0 : -EIO);
335 * Read Command: 12 bytes.
337 * byte 1: last two bits: 00: read data, 01: read blockwise control,
338 * 10: read both, 11: read pagewise control.
339 * It turns out we need values 20, 21, 22, 23 here (LUN 1).
340 * bytes 2-5: address (interpretation depends on byte 1, see below)
341 * bytes 10-11: count (idem)
343 * A page has 512 data bytes and 64 control bytes (16 control and 48 junk).
344 * A read data command gets data in 512-byte pages.
345 * A read control command gets control in 64-byte chunks.
346 * A read both command gets data+control in 576-byte chunks.
348 * Blocks are groups of 32 pages, and read blockwise control jumps to the
349 * next block, while read pagewise control jumps to the next page after
350 * reading a group of 64 control bytes.
351 * [Here 512 = 1<<pageshift, 32 = 1<<blockshift, 64 is constant?]
353 * (1 MB and 2 MB cards are a bit different, but I have only a 16 MB card.)
357 sddr09_readX(struct us_data *us, int x, unsigned long fromaddress,
358 int nr_of_pages, int bulklen, unsigned char *buf,
361 unsigned char *command = us->iobuf;
365 command[1] = LUNBITS | x;
366 command[2] = MSB_of(fromaddress>>16);
367 command[3] = LSB_of(fromaddress>>16);
368 command[4] = MSB_of(fromaddress & 0xFFFF);
369 command[5] = LSB_of(fromaddress & 0xFFFF);
374 command[10] = MSB_of(nr_of_pages);
375 command[11] = LSB_of(nr_of_pages);
377 result = sddr09_send_scsi_command(us, command, 12);
380 US_DEBUGP("Result for send_control in sddr09_read2%d %d\n",
385 result = usb_stor_bulk_transfer_sg(us, us->recv_bulk_pipe,
386 buf, bulklen, use_sg, NULL);
388 if (result != USB_STOR_XFER_GOOD) {
389 US_DEBUGP("Result for bulk_transfer in sddr09_read2%d %d\n",
399 * fromaddress counts data shorts:
400 * increasing it by 256 shifts the bytestream by 512 bytes;
401 * the last 8 bits are ignored.
403 * nr_of_pages counts pages of size (1 << pageshift).
406 sddr09_read20(struct us_data *us, unsigned long fromaddress,
407 int nr_of_pages, int pageshift, unsigned char *buf, int use_sg) {
408 int bulklen = nr_of_pages << pageshift;
410 /* The last 8 bits of fromaddress are ignored. */
411 return sddr09_readX(us, 0, fromaddress, nr_of_pages, bulklen,
416 * Read Blockwise Control
418 * fromaddress gives the starting position (as in read data;
419 * the last 8 bits are ignored); increasing it by 32*256 shifts
420 * the output stream by 64 bytes.
422 * count counts control groups of size (1 << controlshift).
423 * For me, controlshift = 6. Is this constant?
425 * After getting one control group, jump to the next block
426 * (fromaddress += 8192).
429 sddr09_read21(struct us_data *us, unsigned long fromaddress,
430 int count, int controlshift, unsigned char *buf, int use_sg) {
432 int bulklen = (count << controlshift);
433 return sddr09_readX(us, 1, fromaddress, count, bulklen,
438 * Read both Data and Control
440 * fromaddress counts data shorts, ignoring control:
441 * increasing it by 256 shifts the bytestream by 576 = 512+64 bytes;
442 * the last 8 bits are ignored.
444 * nr_of_pages counts pages of size (1 << pageshift) + (1 << controlshift).
447 sddr09_read22(struct us_data *us, unsigned long fromaddress,
448 int nr_of_pages, int pageshift, unsigned char *buf, int use_sg) {
450 int bulklen = (nr_of_pages << pageshift) + (nr_of_pages << CONTROL_SHIFT);
451 US_DEBUGP("sddr09_read22: reading %d pages, %d bytes\n",
452 nr_of_pages, bulklen);
453 return sddr09_readX(us, 2, fromaddress, nr_of_pages, bulklen,
459 * Read Pagewise Control
461 * fromaddress gives the starting position (as in read data;
462 * the last 8 bits are ignored); increasing it by 256 shifts
463 * the output stream by 64 bytes.
465 * count counts control groups of size (1 << controlshift).
466 * For me, controlshift = 6. Is this constant?
468 * After getting one control group, jump to the next page
469 * (fromaddress += 256).
472 sddr09_read23(struct us_data *us, unsigned long fromaddress,
473 int count, int controlshift, unsigned char *buf, int use_sg) {
475 int bulklen = (count << controlshift);
476 return sddr09_readX(us, 3, fromaddress, count, bulklen,
482 * Erase Command: 12 bytes.
484 * bytes 6-9: erase address (big-endian, counting shorts, sector aligned).
486 * Always precisely one block is erased; bytes 2-5 and 10-11 are ignored.
487 * The byte address being erased is 2*Eaddress.
488 * The CIS cannot be erased.
491 sddr09_erase(struct us_data *us, unsigned long Eaddress) {
492 unsigned char *command = us->iobuf;
495 US_DEBUGP("sddr09_erase: erase address %lu\n", Eaddress);
497 memset(command, 0, 12);
499 command[1] = LUNBITS;
500 command[6] = MSB_of(Eaddress>>16);
501 command[7] = LSB_of(Eaddress>>16);
502 command[8] = MSB_of(Eaddress & 0xFFFF);
503 command[9] = LSB_of(Eaddress & 0xFFFF);
505 result = sddr09_send_scsi_command(us, command, 12);
508 US_DEBUGP("Result for send_control in sddr09_erase %d\n",
515 * Write CIS Command: 12 bytes.
517 * bytes 2-5: write address in shorts
518 * bytes 10-11: sector count
520 * This writes at the indicated address. Don't know how it differs
521 * from E9. Maybe it does not erase? However, it will also write to
524 * When two such commands on the same page follow each other directly,
525 * the second one is not done.
529 * Write Command: 12 bytes.
531 * bytes 2-5: write address (big-endian, counting shorts, sector aligned).
532 * bytes 6-9: erase address (big-endian, counting shorts, sector aligned).
533 * bytes 10-11: sector count (big-endian, in 512-byte sectors).
535 * If write address equals erase address, the erase is done first,
536 * otherwise the write is done first. When erase address equals zero
540 sddr09_writeX(struct us_data *us,
541 unsigned long Waddress, unsigned long Eaddress,
542 int nr_of_pages, int bulklen, unsigned char *buf, int use_sg) {
544 unsigned char *command = us->iobuf;
548 command[1] = LUNBITS;
550 command[2] = MSB_of(Waddress>>16);
551 command[3] = LSB_of(Waddress>>16);
552 command[4] = MSB_of(Waddress & 0xFFFF);
553 command[5] = LSB_of(Waddress & 0xFFFF);
555 command[6] = MSB_of(Eaddress>>16);
556 command[7] = LSB_of(Eaddress>>16);
557 command[8] = MSB_of(Eaddress & 0xFFFF);
558 command[9] = LSB_of(Eaddress & 0xFFFF);
560 command[10] = MSB_of(nr_of_pages);
561 command[11] = LSB_of(nr_of_pages);
563 result = sddr09_send_scsi_command(us, command, 12);
566 US_DEBUGP("Result for send_control in sddr09_writeX %d\n",
571 result = usb_stor_bulk_transfer_sg(us, us->send_bulk_pipe,
572 buf, bulklen, use_sg, NULL);
574 if (result != USB_STOR_XFER_GOOD) {
575 US_DEBUGP("Result for bulk_transfer in sddr09_writeX %d\n",
582 /* erase address, write same address */
584 sddr09_write_inplace(struct us_data *us, unsigned long address,
585 int nr_of_pages, int pageshift, unsigned char *buf,
587 int bulklen = (nr_of_pages << pageshift) + (nr_of_pages << CONTROL_SHIFT);
588 return sddr09_writeX(us, address, address, nr_of_pages, bulklen,
594 * Read Scatter Gather Command: 3+4n bytes.
597 * bytes 4i-1,4i,4i+1: page address
598 * byte 4i+2: page count
601 * This reads several pages from the card to a single memory buffer.
602 * The last two bits of byte 1 have the same meaning as for E8.
605 sddr09_read_sg_test_only(struct us_data *us) {
606 unsigned char *command = us->iobuf;
607 int result, bulklen, nsg, ct;
609 unsigned long address;
613 command[1] = LUNBITS;
615 address = 040000; ct = 1;
617 bulklen += (ct << 9);
618 command[4*nsg+2] = ct;
619 command[4*nsg+1] = ((address >> 9) & 0xFF);
620 command[4*nsg+0] = ((address >> 17) & 0xFF);
621 command[4*nsg-1] = ((address >> 25) & 0xFF);
623 address = 0340000; ct = 1;
625 bulklen += (ct << 9);
626 command[4*nsg+2] = ct;
627 command[4*nsg+1] = ((address >> 9) & 0xFF);
628 command[4*nsg+0] = ((address >> 17) & 0xFF);
629 command[4*nsg-1] = ((address >> 25) & 0xFF);
631 address = 01000000; ct = 2;
633 bulklen += (ct << 9);
634 command[4*nsg+2] = ct;
635 command[4*nsg+1] = ((address >> 9) & 0xFF);
636 command[4*nsg+0] = ((address >> 17) & 0xFF);
637 command[4*nsg-1] = ((address >> 25) & 0xFF);
641 result = sddr09_send_scsi_command(us, command, 4*nsg+3);
644 US_DEBUGP("Result for send_control in sddr09_read_sg %d\n",
649 buf = kmalloc(bulklen, GFP_NOIO);
653 result = usb_stor_bulk_transfer_buf(us, us->recv_bulk_pipe,
656 if (result != USB_STOR_XFER_GOOD) {
657 US_DEBUGP("Result for bulk_transfer in sddr09_read_sg %d\n",
667 * Read Status Command: 12 bytes.
670 * Returns 64 bytes, all zero except for the first.
672 * bit 5: 1: Suspended
674 * bit 7: 1: Not write-protected
678 sddr09_read_status(struct us_data *us, unsigned char *status) {
680 unsigned char *command = us->iobuf;
681 unsigned char *data = us->iobuf;
684 US_DEBUGP("Reading status...\n");
686 memset(command, 0, 12);
688 command[1] = LUNBITS;
690 result = sddr09_send_scsi_command(us, command, 12);
694 result = usb_stor_bulk_transfer_buf(us, us->recv_bulk_pipe,
697 return (result == USB_STOR_XFER_GOOD ? 0 : -EIO);
701 sddr09_read_data(struct us_data *us,
702 unsigned long address,
703 unsigned int sectors) {
705 struct sddr09_card_info *info = (struct sddr09_card_info *) us->extra;
706 unsigned char *buffer;
707 unsigned int lba, maxlba, pba;
708 unsigned int page, pages;
709 unsigned int len, index, offset;
712 // Figure out the initial LBA and page
713 lba = address >> info->blockshift;
714 page = (address & info->blockmask);
715 maxlba = info->capacity >> (info->pageshift + info->blockshift);
719 // Since we only read in one block at a time, we have to create
720 // a bounce buffer and move the data a piece at a time between the
721 // bounce buffer and the actual transfer buffer.
723 len = min(sectors, (unsigned int) info->blocksize) * info->pagesize;
724 buffer = kmalloc(len, GFP_NOIO);
725 if (buffer == NULL) {
726 printk("sddr09_read_data: Out of memory\n");
730 // This could be made much more efficient by checking for
731 // contiguous LBA's. Another exercise left to the student.
736 while (sectors > 0) {
738 /* Find number of pages we can read in this block */
739 pages = min(sectors, info->blocksize - page);
740 len = pages << info->pageshift;
742 /* Not overflowing capacity? */
744 US_DEBUGP("Error: Requested lba %u exceeds "
745 "maximum %u\n", lba, maxlba);
750 /* Find where this lba lives on disk */
751 pba = info->lba_to_pba[lba];
753 if (pba == UNDEF) { /* this lba was never written */
755 US_DEBUGP("Read %d zero pages (LBA %d) page %d\n",
758 /* This is not really an error. It just means
759 that the block has never been written.
760 Instead of returning an error
761 it is better to return all zero data. */
763 memset(buffer, 0, len);
766 US_DEBUGP("Read %d pages, from PBA %d"
767 " (LBA %d) page %d\n",
768 pages, pba, lba, page);
770 address = ((pba << info->blockshift) + page) <<
773 result = sddr09_read20(us, address>>1,
774 pages, info->pageshift, buffer, 0);
779 // Store the data in the transfer buffer
780 usb_stor_access_xfer_buf(buffer, len, us->srb,
781 &index, &offset, TO_XFER_BUF);
793 sddr09_find_unused_pba(struct sddr09_card_info *info, unsigned int lba) {
794 static unsigned int lastpba = 1;
795 int zonestart, end, i;
797 zonestart = (lba/1000) << 10;
798 end = info->capacity >> (info->blockshift + info->pageshift);
803 for (i = lastpba+1; i < end; i++) {
804 if (info->pba_to_lba[zonestart+i] == UNDEF) {
809 for (i = 0; i <= lastpba; i++) {
810 if (info->pba_to_lba[zonestart+i] == UNDEF) {
819 sddr09_write_lba(struct us_data *us, unsigned int lba,
820 unsigned int page, unsigned int pages,
821 unsigned char *ptr, unsigned char *blockbuffer) {
823 struct sddr09_card_info *info = (struct sddr09_card_info *) us->extra;
824 unsigned long address;
825 unsigned int pba, lbap;
826 unsigned int pagelen;
827 unsigned char *bptr, *cptr, *xptr;
828 unsigned char ecc[3];
829 int i, result, isnew;
831 lbap = ((lba % 1000) << 1) | 0x1000;
832 if (parity[MSB_of(lbap) ^ LSB_of(lbap)])
834 pba = info->lba_to_pba[lba];
838 pba = sddr09_find_unused_pba(info, lba);
840 printk("sddr09_write_lba: Out of unused blocks\n");
843 info->pba_to_lba[pba] = lba;
844 info->lba_to_pba[lba] = pba;
849 /* Maybe it is impossible to write to PBA 1.
850 Fake success, but don't do anything. */
851 printk("sddr09: avoid writing to pba 1\n");
855 pagelen = (1 << info->pageshift) + (1 << CONTROL_SHIFT);
857 /* read old contents */
858 address = (pba << (info->pageshift + info->blockshift));
859 result = sddr09_read22(us, address>>1, info->blocksize,
860 info->pageshift, blockbuffer, 0);
864 /* check old contents and fill lba */
865 for (i = 0; i < info->blocksize; i++) {
866 bptr = blockbuffer + i*pagelen;
867 cptr = bptr + info->pagesize;
868 nand_compute_ecc(bptr, ecc);
869 if (!nand_compare_ecc(cptr+13, ecc)) {
870 US_DEBUGP("Warning: bad ecc in page %d- of pba %d\n",
872 nand_store_ecc(cptr+13, ecc);
874 nand_compute_ecc(bptr+(info->pagesize / 2), ecc);
875 if (!nand_compare_ecc(cptr+8, ecc)) {
876 US_DEBUGP("Warning: bad ecc in page %d+ of pba %d\n",
878 nand_store_ecc(cptr+8, ecc);
880 cptr[6] = cptr[11] = MSB_of(lbap);
881 cptr[7] = cptr[12] = LSB_of(lbap);
884 /* copy in new stuff and compute ECC */
886 for (i = page; i < page+pages; i++) {
887 bptr = blockbuffer + i*pagelen;
888 cptr = bptr + info->pagesize;
889 memcpy(bptr, xptr, info->pagesize);
890 xptr += info->pagesize;
891 nand_compute_ecc(bptr, ecc);
892 nand_store_ecc(cptr+13, ecc);
893 nand_compute_ecc(bptr+(info->pagesize / 2), ecc);
894 nand_store_ecc(cptr+8, ecc);
897 US_DEBUGP("Rewrite PBA %d (LBA %d)\n", pba, lba);
899 result = sddr09_write_inplace(us, address>>1, info->blocksize,
900 info->pageshift, blockbuffer, 0);
902 US_DEBUGP("sddr09_write_inplace returns %d\n", result);
906 unsigned char status = 0;
907 int result2 = sddr09_read_status(us, &status);
909 US_DEBUGP("sddr09_write_inplace: cannot read status\n");
910 else if (status != 0xc0)
911 US_DEBUGP("sddr09_write_inplace: status after write: 0x%x\n",
918 int result2 = sddr09_test_unit_ready(us);
926 sddr09_write_data(struct us_data *us,
927 unsigned long address,
928 unsigned int sectors) {
930 struct sddr09_card_info *info = (struct sddr09_card_info *) us->extra;
931 unsigned int lba, maxlba, page, pages;
932 unsigned int pagelen, blocklen;
933 unsigned char *blockbuffer;
934 unsigned char *buffer;
935 unsigned int len, index, offset;
938 // Figure out the initial LBA and page
939 lba = address >> info->blockshift;
940 page = (address & info->blockmask);
941 maxlba = info->capacity >> (info->pageshift + info->blockshift);
945 // blockbuffer is used for reading in the old data, overwriting
946 // with the new data, and performing ECC calculations
948 /* TODO: instead of doing kmalloc/kfree for each write,
949 add a bufferpointer to the info structure */
951 pagelen = (1 << info->pageshift) + (1 << CONTROL_SHIFT);
952 blocklen = (pagelen << info->blockshift);
953 blockbuffer = kmalloc(blocklen, GFP_NOIO);
955 printk("sddr09_write_data: Out of memory\n");
959 // Since we don't write the user data directly to the device,
960 // we have to create a bounce buffer and move the data a piece
961 // at a time between the bounce buffer and the actual transfer buffer.
963 len = min(sectors, (unsigned int) info->blocksize) * info->pagesize;
964 buffer = kmalloc(len, GFP_NOIO);
965 if (buffer == NULL) {
966 printk("sddr09_write_data: Out of memory\n");
974 while (sectors > 0) {
976 // Write as many sectors as possible in this block
978 pages = min(sectors, info->blocksize - page);
979 len = (pages << info->pageshift);
981 /* Not overflowing capacity? */
983 US_DEBUGP("Error: Requested lba %u exceeds "
984 "maximum %u\n", lba, maxlba);
989 // Get the data from the transfer buffer
990 usb_stor_access_xfer_buf(buffer, len, us->srb,
991 &index, &offset, FROM_XFER_BUF);
993 result = sddr09_write_lba(us, lba, page, pages,
994 buffer, blockbuffer);
1010 sddr09_read_control(struct us_data *us,
1011 unsigned long address,
1012 unsigned int blocks,
1013 unsigned char *content,
1016 US_DEBUGP("Read control address %lu, blocks %d\n",
1019 return sddr09_read21(us, address, blocks,
1020 CONTROL_SHIFT, content, use_sg);
1024 * Read Device ID Command: 12 bytes.
1025 * byte 0: opcode: ED
1027 * Returns 2 bytes: Manufacturer ID and Device ID.
1028 * On more recent cards 3 bytes: the third byte is an option code A5
1029 * signifying that the secret command to read an 128-bit ID is available.
1030 * On still more recent cards 4 bytes: the fourth byte C0 means that
1031 * a second read ID cmd is available.
1034 sddr09_read_deviceID(struct us_data *us, unsigned char *deviceID) {
1035 unsigned char *command = us->iobuf;
1036 unsigned char *content = us->iobuf;
1039 memset(command, 0, 12);
1041 command[1] = LUNBITS;
1043 result = sddr09_send_scsi_command(us, command, 12);
1047 result = usb_stor_bulk_transfer_buf(us, us->recv_bulk_pipe,
1050 for (i = 0; i < 4; i++)
1051 deviceID[i] = content[i];
1053 return (result == USB_STOR_XFER_GOOD ? 0 : -EIO);
1057 sddr09_get_wp(struct us_data *us, struct sddr09_card_info *info) {
1059 unsigned char status;
1061 result = sddr09_read_status(us, &status);
1063 US_DEBUGP("sddr09_get_wp: read_status fails\n");
1066 US_DEBUGP("sddr09_get_wp: status 0x%02X", status);
1067 if ((status & 0x80) == 0) {
1068 info->flags |= SDDR09_WP; /* write protected */
1072 US_DEBUGP(" Ready");
1073 if (status & LUNBITS)
1074 US_DEBUGP(" Suspended");
1076 US_DEBUGP(" Error");
1083 * Reset Command: 12 bytes.
1084 * byte 0: opcode: EB
1087 sddr09_reset(struct us_data *us) {
1089 unsigned char *command = us->iobuf;
1091 memset(command, 0, 12);
1093 command[1] = LUNBITS;
1095 return sddr09_send_scsi_command(us, command, 12);
1099 static struct nand_flash_dev *
1100 sddr09_get_cardinfo(struct us_data *us, unsigned char flags) {
1101 struct nand_flash_dev *cardinfo;
1102 unsigned char deviceID[4];
1106 US_DEBUGP("Reading capacity...\n");
1108 result = sddr09_read_deviceID(us, deviceID);
1111 US_DEBUGP("Result of read_deviceID is %d\n", result);
1112 printk("sddr09: could not read card info\n");
1116 sprintf(blurbtxt, "sddr09: Found Flash card, ID = %02X %02X %02X %02X",
1117 deviceID[0], deviceID[1], deviceID[2], deviceID[3]);
1119 /* Byte 0 is the manufacturer */
1120 sprintf(blurbtxt + strlen(blurbtxt),
1122 nand_flash_manufacturer(deviceID[0]));
1124 /* Byte 1 is the device type */
1125 cardinfo = nand_find_id(deviceID[1]);
1127 /* MB or MiB? It is neither. A 16 MB card has
1128 17301504 raw bytes, of which 16384000 are
1129 usable for user data. */
1130 sprintf(blurbtxt + strlen(blurbtxt),
1131 ", %d MB", 1<<(cardinfo->chipshift - 20));
1133 sprintf(blurbtxt + strlen(blurbtxt),
1134 ", type unrecognized");
1137 /* Byte 2 is code to signal availability of 128-bit ID */
1138 if (deviceID[2] == 0xa5) {
1139 sprintf(blurbtxt + strlen(blurbtxt),
1143 /* Byte 3 announces the availability of another read ID command */
1144 if (deviceID[3] == 0xc0) {
1145 sprintf(blurbtxt + strlen(blurbtxt),
1149 if (flags & SDDR09_WP)
1150 sprintf(blurbtxt + strlen(blurbtxt),
1153 printk("%s\n", blurbtxt);
1159 sddr09_read_map(struct us_data *us) {
1161 struct sddr09_card_info *info = (struct sddr09_card_info *) us->extra;
1162 int numblocks, alloc_len, alloc_blocks;
1164 unsigned char *buffer, *buffer_end, *ptr;
1165 unsigned int lba, lbact;
1167 if (!info->capacity)
1170 // size of a block is 1 << (blockshift + pageshift) bytes
1171 // divide into the total capacity to get the number of blocks
1173 numblocks = info->capacity >> (info->blockshift + info->pageshift);
1175 // read 64 bytes for every block (actually 1 << CONTROL_SHIFT)
1176 // but only use a 64 KB buffer
1177 // buffer size used must be a multiple of (1 << CONTROL_SHIFT)
1178 #define SDDR09_READ_MAP_BUFSZ 65536
1180 alloc_blocks = min(numblocks, SDDR09_READ_MAP_BUFSZ >> CONTROL_SHIFT);
1181 alloc_len = (alloc_blocks << CONTROL_SHIFT);
1182 buffer = kmalloc(alloc_len, GFP_NOIO);
1183 if (buffer == NULL) {
1184 printk("sddr09_read_map: out of memory\n");
1188 buffer_end = buffer + alloc_len;
1190 #undef SDDR09_READ_MAP_BUFSZ
1192 kfree(info->lba_to_pba);
1193 kfree(info->pba_to_lba);
1194 info->lba_to_pba = kmalloc(numblocks*sizeof(int), GFP_NOIO);
1195 info->pba_to_lba = kmalloc(numblocks*sizeof(int), GFP_NOIO);
1197 if (info->lba_to_pba == NULL || info->pba_to_lba == NULL) {
1198 printk("sddr09_read_map: out of memory\n");
1203 for (i = 0; i < numblocks; i++)
1204 info->lba_to_pba[i] = info->pba_to_lba[i] = UNDEF;
1207 * Define lba-pba translation table
1211 for (i = 0; i < numblocks; i++) {
1212 ptr += (1 << CONTROL_SHIFT);
1213 if (ptr >= buffer_end) {
1214 unsigned long address;
1216 address = i << (info->pageshift + info->blockshift);
1217 result = sddr09_read_control(
1219 min(alloc_blocks, numblocks - i),
1228 if (i == 0 || i == 1) {
1229 info->pba_to_lba[i] = UNUSABLE;
1233 /* special PBAs have control field 0^16 */
1234 for (j = 0; j < 16; j++)
1237 info->pba_to_lba[i] = UNUSABLE;
1238 printk("sddr09: PBA %d has no logical mapping\n", i);
1242 /* unwritten PBAs have control field FF^16 */
1243 for (j = 0; j < 16; j++)
1249 /* normal PBAs start with six FFs */
1251 printk("sddr09: PBA %d has no logical mapping: "
1252 "reserved area = %02X%02X%02X%02X "
1253 "data status %02X block status %02X\n",
1254 i, ptr[0], ptr[1], ptr[2], ptr[3],
1256 info->pba_to_lba[i] = UNUSABLE;
1260 if ((ptr[6] >> 4) != 0x01) {
1261 printk("sddr09: PBA %d has invalid address field "
1262 "%02X%02X/%02X%02X\n",
1263 i, ptr[6], ptr[7], ptr[11], ptr[12]);
1264 info->pba_to_lba[i] = UNUSABLE;
1268 /* check even parity */
1269 if (parity[ptr[6] ^ ptr[7]]) {
1270 printk("sddr09: Bad parity in LBA for block %d"
1271 " (%02X %02X)\n", i, ptr[6], ptr[7]);
1272 info->pba_to_lba[i] = UNUSABLE;
1276 lba = short_pack(ptr[7], ptr[6]);
1277 lba = (lba & 0x07FF) >> 1;
1280 * Every 1024 physical blocks ("zone"), the LBA numbers
1281 * go back to zero, but are within a higher block of LBA's.
1282 * Also, there is a maximum of 1000 LBA's per zone.
1283 * In other words, in PBA 1024-2047 you will find LBA 0-999
1284 * which are really LBA 1000-1999. This allows for 24 bad
1285 * or special physical blocks per zone.
1289 printk("sddr09: Bad low LBA %d for block %d\n",
1291 goto possibly_erase;
1294 lba += 1000*(i/0x400);
1296 if (info->lba_to_pba[lba] != UNDEF) {
1297 printk("sddr09: LBA %d seen for PBA %d and %d\n",
1298 lba, info->lba_to_pba[lba], i);
1299 goto possibly_erase;
1302 info->pba_to_lba[i] = lba;
1303 info->lba_to_pba[lba] = i;
1307 if (erase_bad_lba_entries) {
1308 unsigned long address;
1310 address = (i << (info->pageshift + info->blockshift));
1311 sddr09_erase(us, address>>1);
1312 info->pba_to_lba[i] = UNDEF;
1314 info->pba_to_lba[i] = UNUSABLE;
1318 * Approximate capacity. This is not entirely correct yet,
1319 * since a zone with less than 1000 usable pages leads to
1320 * missing LBAs. Especially if it is the last zone, some
1321 * LBAs can be past capacity.
1324 for (i = 0; i < numblocks; i += 1024) {
1327 for (j = 0; j < 1024 && i+j < numblocks; j++) {
1328 if (info->pba_to_lba[i+j] != UNUSABLE) {
1330 info->pba_to_lba[i+j] = SPARE;
1337 info->lbact = lbact;
1338 US_DEBUGP("Found %d LBA's\n", lbact);
1343 kfree(info->lba_to_pba);
1344 kfree(info->pba_to_lba);
1345 info->lba_to_pba = NULL;
1346 info->pba_to_lba = NULL;
1353 sddr09_card_info_destructor(void *extra) {
1354 struct sddr09_card_info *info = (struct sddr09_card_info *)extra;
1359 kfree(info->lba_to_pba);
1360 kfree(info->pba_to_lba);
1364 sddr09_common_init(struct us_data *us) {
1367 /* set the configuration -- STALL is an acceptable response here */
1368 if (us->pusb_dev->actconfig->desc.bConfigurationValue != 1) {
1369 US_DEBUGP("active config #%d != 1 ??\n", us->pusb_dev
1370 ->actconfig->desc.bConfigurationValue);
1374 result = usb_reset_configuration(us->pusb_dev);
1375 US_DEBUGP("Result of usb_reset_configuration is %d\n", result);
1376 if (result == -EPIPE) {
1377 US_DEBUGP("-- stall on control interface\n");
1378 } else if (result != 0) {
1379 /* it's not a stall, but another error -- time to bail */
1380 US_DEBUGP("-- Unknown error. Rejecting device\n");
1384 us->extra = kzalloc(sizeof(struct sddr09_card_info), GFP_NOIO);
1387 us->extra_destructor = sddr09_card_info_destructor;
1395 * This is needed at a very early stage. If this is not listed in the
1396 * unusual devices list but called from here then LUN 0 of the combo reader
1397 * is not recognized. But I do not know what precisely these calls do.
1400 usb_stor_sddr09_dpcm_init(struct us_data *us) {
1402 unsigned char *data = us->iobuf;
1404 result = sddr09_common_init(us);
1408 result = sddr09_send_command(us, 0x01, USB_DIR_IN, data, 2);
1410 US_DEBUGP("sddr09_init: send_command fails\n");
1414 US_DEBUGP("SDDR09init: %02X %02X\n", data[0], data[1]);
1417 result = sddr09_send_command(us, 0x08, USB_DIR_IN, data, 2);
1419 US_DEBUGP("sddr09_init: 2nd send_command fails\n");
1423 US_DEBUGP("SDDR09init: %02X %02X\n", data[0], data[1]);
1426 result = sddr09_request_sense(us, data, 18);
1427 if (result == 0 && data[2] != 0) {
1429 for (j=0; j<18; j++)
1430 printk(" %02X", data[j]);
1432 // get 70 00 00 00 00 00 00 * 00 00 00 00 00 00
1433 // 70: current command
1434 // sense key 0, sense code 0, extd sense code 0
1435 // additional transfer length * = sizeof(data) - 7
1436 // Or: 70 00 06 00 00 00 00 0b 00 00 00 00 28 00 00 00 00 00
1437 // sense key 06, sense code 28: unit attention,
1438 // not ready to ready transition
1443 return 0; /* not result */
1447 * Transport for the Sandisk SDDR-09
1449 int sddr09_transport(struct scsi_cmnd *srb, struct us_data *us)
1451 static unsigned char sensekey = 0, sensecode = 0;
1452 static unsigned char havefakesense = 0;
1454 unsigned char *ptr = us->iobuf;
1455 unsigned long capacity;
1456 unsigned int page, pages;
1458 struct sddr09_card_info *info;
1460 static unsigned char inquiry_response[8] = {
1461 0x00, 0x80, 0x00, 0x02, 0x1F, 0x00, 0x00, 0x00
1464 /* note: no block descriptor support */
1465 static unsigned char mode_page_01[19] = {
1466 0x00, 0x0F, 0x00, 0x0, 0x0, 0x0, 0x00,
1468 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00
1471 info = (struct sddr09_card_info *)us->extra;
1473 if (srb->cmnd[0] == REQUEST_SENSE && havefakesense) {
1474 /* for a faked command, we have to follow with a faked sense */
1479 ptr[12] = sensecode;
1480 usb_stor_set_xfer_buf(ptr, 18, srb);
1481 sensekey = sensecode = havefakesense = 0;
1482 return USB_STOR_TRANSPORT_GOOD;
1487 /* Dummy up a response for INQUIRY since SDDR09 doesn't
1488 respond to INQUIRY commands */
1490 if (srb->cmnd[0] == INQUIRY) {
1491 memcpy(ptr, inquiry_response, 8);
1492 fill_inquiry_response(us, ptr, 36);
1493 return USB_STOR_TRANSPORT_GOOD;
1496 if (srb->cmnd[0] == READ_CAPACITY) {
1497 struct nand_flash_dev *cardinfo;
1499 sddr09_get_wp(us, info); /* read WP bit */
1501 cardinfo = sddr09_get_cardinfo(us, info->flags);
1503 /* probably no media */
1505 sensekey = 0x02; /* not ready */
1506 sensecode = 0x3a; /* medium not present */
1507 return USB_STOR_TRANSPORT_FAILED;
1510 info->capacity = (1 << cardinfo->chipshift);
1511 info->pageshift = cardinfo->pageshift;
1512 info->pagesize = (1 << info->pageshift);
1513 info->blockshift = cardinfo->blockshift;
1514 info->blocksize = (1 << info->blockshift);
1515 info->blockmask = info->blocksize - 1;
1517 // map initialization, must follow get_cardinfo()
1518 if (sddr09_read_map(us)) {
1519 /* probably out of memory */
1525 capacity = (info->lbact << info->blockshift) - 1;
1527 ((__be32 *) ptr)[0] = cpu_to_be32(capacity);
1531 ((__be32 *) ptr)[1] = cpu_to_be32(info->pagesize);
1532 usb_stor_set_xfer_buf(ptr, 8, srb);
1534 return USB_STOR_TRANSPORT_GOOD;
1537 if (srb->cmnd[0] == MODE_SENSE_10) {
1538 int modepage = (srb->cmnd[2] & 0x3F);
1540 /* They ask for the Read/Write error recovery page,
1541 or for all pages. */
1542 /* %% We should check DBD %% */
1543 if (modepage == 0x01 || modepage == 0x3F) {
1544 US_DEBUGP("SDDR09: Dummy up request for "
1545 "mode page 0x%x\n", modepage);
1547 memcpy(ptr, mode_page_01, sizeof(mode_page_01));
1548 ((__be16*)ptr)[0] = cpu_to_be16(sizeof(mode_page_01) - 2);
1549 ptr[3] = (info->flags & SDDR09_WP) ? 0x80 : 0;
1550 usb_stor_set_xfer_buf(ptr, sizeof(mode_page_01), srb);
1551 return USB_STOR_TRANSPORT_GOOD;
1554 sensekey = 0x05; /* illegal request */
1555 sensecode = 0x24; /* invalid field in CDB */
1556 return USB_STOR_TRANSPORT_FAILED;
1559 if (srb->cmnd[0] == ALLOW_MEDIUM_REMOVAL)
1560 return USB_STOR_TRANSPORT_GOOD;
1564 if (srb->cmnd[0] == READ_10) {
1566 page = short_pack(srb->cmnd[3], srb->cmnd[2]);
1568 page |= short_pack(srb->cmnd[5], srb->cmnd[4]);
1569 pages = short_pack(srb->cmnd[8], srb->cmnd[7]);
1571 US_DEBUGP("READ_10: read page %d pagect %d\n",
1574 result = sddr09_read_data(us, page, pages);
1575 return (result == 0 ? USB_STOR_TRANSPORT_GOOD :
1576 USB_STOR_TRANSPORT_ERROR);
1579 if (srb->cmnd[0] == WRITE_10) {
1581 page = short_pack(srb->cmnd[3], srb->cmnd[2]);
1583 page |= short_pack(srb->cmnd[5], srb->cmnd[4]);
1584 pages = short_pack(srb->cmnd[8], srb->cmnd[7]);
1586 US_DEBUGP("WRITE_10: write page %d pagect %d\n",
1589 result = sddr09_write_data(us, page, pages);
1590 return (result == 0 ? USB_STOR_TRANSPORT_GOOD :
1591 USB_STOR_TRANSPORT_ERROR);
1594 /* catch-all for all other commands, except
1595 * pass TEST_UNIT_READY and REQUEST_SENSE through
1597 if (srb->cmnd[0] != TEST_UNIT_READY &&
1598 srb->cmnd[0] != REQUEST_SENSE) {
1599 sensekey = 0x05; /* illegal request */
1600 sensecode = 0x20; /* invalid command */
1602 return USB_STOR_TRANSPORT_FAILED;
1605 for (; srb->cmd_len<12; srb->cmd_len++)
1606 srb->cmnd[srb->cmd_len] = 0;
1608 srb->cmnd[1] = LUNBITS;
1611 for (i=0; i<12; i++)
1612 sprintf(ptr+strlen(ptr), "%02X ", srb->cmnd[i]);
1614 US_DEBUGP("SDDR09: Send control for command %s\n", ptr);
1616 result = sddr09_send_scsi_command(us, srb->cmnd, 12);
1618 US_DEBUGP("sddr09_transport: sddr09_send_scsi_command "
1619 "returns %d\n", result);
1620 return USB_STOR_TRANSPORT_ERROR;
1623 if (srb->request_bufflen == 0)
1624 return USB_STOR_TRANSPORT_GOOD;
1626 if (srb->sc_data_direction == DMA_TO_DEVICE ||
1627 srb->sc_data_direction == DMA_FROM_DEVICE) {
1628 unsigned int pipe = (srb->sc_data_direction == DMA_TO_DEVICE)
1629 ? us->send_bulk_pipe : us->recv_bulk_pipe;
1631 US_DEBUGP("SDDR09: %s %d bytes\n",
1632 (srb->sc_data_direction == DMA_TO_DEVICE) ?
1633 "sending" : "receiving",
1634 srb->request_bufflen);
1636 result = usb_stor_bulk_transfer_sg(us, pipe,
1637 srb->request_buffer,
1638 srb->request_bufflen,
1639 srb->use_sg, &srb->resid);
1641 return (result == USB_STOR_XFER_GOOD ?
1642 USB_STOR_TRANSPORT_GOOD : USB_STOR_TRANSPORT_ERROR);
1645 return USB_STOR_TRANSPORT_GOOD;
1649 * Initialization routine for the sddr09 subdriver
1652 usb_stor_sddr09_init(struct us_data *us) {
1653 return sddr09_common_init(us);