1 /* linux/drivers/mtd/nand/bf5xx_nand.c
3 * Copyright 2006-2007 Analog Devices Inc.
4 * http://blackfin.uclinux.org/
5 * Bryan Wu <bryan.wu@analog.com>
7 * Blackfin BF5xx on-chip NAND flash controller driver
9 * Derived from drivers/mtd/nand/s3c2410.c
10 * Copyright (c) 2007 Ben Dooks <ben@simtec.co.uk>
12 * Derived from drivers/mtd/nand/cafe.c
13 * Copyright © 2006 Red Hat, Inc.
14 * Copyright © 2006 David Woodhouse <dwmw2@infradead.org>
17 * 12-Jun-2007 Bryan Wu: Initial version
18 * 18-Jul-2007 Bryan Wu:
19 * - ECC_HW and ECC_SW supported
20 * - DMA supported in ECC_HW
21 * - YAFFS tested as rootfs in both ECC_HW and ECC_SW
24 * Enable JFFS2 over NAND as rootfs
26 * This program is free software; you can redistribute it and/or modify
27 * it under the terms of the GNU General Public License as published by
28 * the Free Software Foundation; either version 2 of the License, or
29 * (at your option) any later version.
31 * This program is distributed in the hope that it will be useful,
32 * but WITHOUT ANY WARRANTY; without even the implied warranty of
33 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
34 * GNU General Public License for more details.
36 * You should have received a copy of the GNU General Public License
37 * along with this program; if not, write to the Free Software
38 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
41 #include <linux/module.h>
42 #include <linux/types.h>
43 #include <linux/init.h>
44 #include <linux/kernel.h>
45 #include <linux/string.h>
46 #include <linux/ioport.h>
47 #include <linux/platform_device.h>
48 #include <linux/delay.h>
49 #include <linux/dma-mapping.h>
50 #include <linux/err.h>
51 #include <linux/slab.h>
53 #include <linux/bitops.h>
55 #include <linux/mtd/mtd.h>
56 #include <linux/mtd/nand.h>
57 #include <linux/mtd/nand_ecc.h>
58 #include <linux/mtd/partitions.h>
60 #include <asm/blackfin.h>
62 #include <asm/cacheflush.h>
64 #include <asm/portmux.h>
66 #define DRV_NAME "bf5xx-nand"
67 #define DRV_VERSION "1.2"
68 #define DRV_AUTHOR "Bryan Wu <bryan.wu@analog.com>"
69 #define DRV_DESC "BF5xx on-chip NAND FLash Controller Driver"
71 #ifdef CONFIG_MTD_NAND_BF5XX_HWECC
72 static int hardware_ecc
= 1;
74 static int hardware_ecc
;
77 static unsigned short bfin_nfc_pin_req
[] =
95 * Data structures for bf5xx nand flash controller driver
99 struct bf5xx_nand_info
{
101 struct nand_hw_control controller
;
103 struct nand_chip chip
;
106 struct bf5xx_nand_platform
*platform
;
109 struct device
*device
;
112 struct completion dma_completion
;
116 * Conversion functions
118 static struct bf5xx_nand_info
*mtd_to_nand_info(struct mtd_info
*mtd
)
120 return container_of(mtd
, struct bf5xx_nand_info
, mtd
);
123 static struct bf5xx_nand_info
*to_nand_info(struct platform_device
*pdev
)
125 return platform_get_drvdata(pdev
);
128 static struct bf5xx_nand_platform
*to_nand_plat(struct platform_device
*pdev
)
130 return pdev
->dev
.platform_data
;
134 * struct nand_chip interface function pointers
138 * bf5xx_nand_hwcontrol
140 * Issue command and address cycles to the chip
142 static void bf5xx_nand_hwcontrol(struct mtd_info
*mtd
, int cmd
,
145 if (cmd
== NAND_CMD_NONE
)
148 while (bfin_read_NFC_STAT() & WB_FULL
)
152 bfin_write_NFC_CMD(cmd
);
154 bfin_write_NFC_ADDR(cmd
);
159 * bf5xx_nand_devready()
161 * returns 0 if the nand is busy, 1 if it is ready
163 static int bf5xx_nand_devready(struct mtd_info
*mtd
)
165 unsigned short val
= bfin_read_NFC_IRQSTAT();
167 if ((val
& NBUSYIRQ
) == NBUSYIRQ
)
175 * These allow the bf5xx to use the controller's ECC
176 * generator block to ECC the data as it passes through
180 * ECC error correction function
182 static int bf5xx_nand_correct_data_256(struct mtd_info
*mtd
, u_char
*dat
,
183 u_char
*read_ecc
, u_char
*calc_ecc
)
185 struct bf5xx_nand_info
*info
= mtd_to_nand_info(mtd
);
189 unsigned short failing_bit
, failing_byte
;
192 calced
= calc_ecc
[0] | (calc_ecc
[1] << 8) | (calc_ecc
[2] << 16);
193 stored
= read_ecc
[0] | (read_ecc
[1] << 8) | (read_ecc
[2] << 16);
195 syndrome
[0] = (calced
^ stored
);
198 * syndrome 0: all zero
202 if (!syndrome
[0] || !calced
|| !stored
)
206 * sysdrome 0: only one bit is one
207 * ECC data was incorrect
210 if (hweight32(syndrome
[0]) == 1) {
211 dev_err(info
->device
, "ECC data was incorrect!\n");
215 syndrome
[1] = (calced
& 0x7FF) ^ (stored
& 0x7FF);
216 syndrome
[2] = (calced
& 0x7FF) ^ ((calced
>> 11) & 0x7FF);
217 syndrome
[3] = (stored
& 0x7FF) ^ ((stored
>> 11) & 0x7FF);
218 syndrome
[4] = syndrome
[2] ^ syndrome
[3];
220 for (i
= 0; i
< 5; i
++)
221 dev_info(info
->device
, "syndrome[%d] 0x%08x\n", i
, syndrome
[i
]);
223 dev_info(info
->device
,
224 "calced[0x%08x], stored[0x%08x]\n",
228 * sysdrome 0: exactly 11 bits are one, each parity
229 * and parity' pair is 1 & 0 or 0 & 1.
230 * 1-bit correctable error
233 if (hweight32(syndrome
[0]) == 11 && syndrome
[4] == 0x7FF) {
234 dev_info(info
->device
,
235 "1-bit correctable error, correct it.\n");
236 dev_info(info
->device
,
237 "syndrome[1] 0x%08x\n", syndrome
[1]);
239 failing_bit
= syndrome
[1] & 0x7;
240 failing_byte
= syndrome
[1] >> 0x3;
241 data
= *(dat
+ failing_byte
);
242 data
= data
^ (0x1 << failing_bit
);
243 *(dat
+ failing_byte
) = data
;
249 * sysdrome 0: random data
250 * More than 1-bit error, non-correctable error
251 * Discard data, mark bad block
253 dev_err(info
->device
,
254 "More than 1-bit error, non-correctable error.\n");
255 dev_err(info
->device
,
256 "Please discard data, mark bad block\n");
261 static int bf5xx_nand_correct_data(struct mtd_info
*mtd
, u_char
*dat
,
262 u_char
*read_ecc
, u_char
*calc_ecc
)
264 struct bf5xx_nand_info
*info
= mtd_to_nand_info(mtd
);
265 struct bf5xx_nand_platform
*plat
= info
->platform
;
266 unsigned short page_size
= (plat
->page_size
? 512 : 256);
269 ret
= bf5xx_nand_correct_data_256(mtd
, dat
, read_ecc
, calc_ecc
);
271 /* If page size is 512, correct second 256 bytes */
272 if (page_size
== 512) {
276 ret
= bf5xx_nand_correct_data_256(mtd
, dat
, read_ecc
, calc_ecc
);
282 static void bf5xx_nand_enable_hwecc(struct mtd_info
*mtd
, int mode
)
287 static int bf5xx_nand_calculate_ecc(struct mtd_info
*mtd
,
288 const u_char
*dat
, u_char
*ecc_code
)
290 struct bf5xx_nand_info
*info
= mtd_to_nand_info(mtd
);
291 struct bf5xx_nand_platform
*plat
= info
->platform
;
292 u16 page_size
= (plat
->page_size
? 512 : 256);
297 /* first 4 bytes ECC code for 256 page size */
298 ecc0
= bfin_read_NFC_ECC0();
299 ecc1
= bfin_read_NFC_ECC1();
301 code
[0] = (ecc0
& 0x3FF) | ((ecc1
& 0x3FF) << 11);
303 dev_dbg(info
->device
, "returning ecc 0x%08x\n", code
[0]);
305 /* first 3 bytes in ecc_code for 256 page size */
307 memcpy(ecc_code
, p
, 3);
309 /* second 4 bytes ECC code for 512 page size */
310 if (page_size
== 512) {
311 ecc0
= bfin_read_NFC_ECC2();
312 ecc1
= bfin_read_NFC_ECC3();
313 code
[1] = (ecc0
& 0x3FF) | ((ecc1
& 0x3FF) << 11);
315 /* second 3 bytes in ecc_code for second 256
316 * bytes of 512 page size
318 p
= (u8
*) (code
+ 1);
319 memcpy((ecc_code
+ 3), p
, 3);
320 dev_dbg(info
->device
, "returning ecc 0x%08x\n", code
[1]);
327 * PIO mode for buffer writing and reading
329 static void bf5xx_nand_read_buf(struct mtd_info
*mtd
, uint8_t *buf
, int len
)
335 * Data reads are requested by first writing to NFC_DATA_RD
336 * and then reading back from NFC_READ.
338 for (i
= 0; i
< len
; i
++) {
339 while (bfin_read_NFC_STAT() & WB_FULL
)
342 /* Contents do not matter */
343 bfin_write_NFC_DATA_RD(0x0000);
346 while ((bfin_read_NFC_IRQSTAT() & RD_RDY
) != RD_RDY
)
349 buf
[i
] = bfin_read_NFC_READ();
351 val
= bfin_read_NFC_IRQSTAT();
353 bfin_write_NFC_IRQSTAT(val
);
358 static uint8_t bf5xx_nand_read_byte(struct mtd_info
*mtd
)
362 bf5xx_nand_read_buf(mtd
, &val
, 1);
367 static void bf5xx_nand_write_buf(struct mtd_info
*mtd
,
368 const uint8_t *buf
, int len
)
372 for (i
= 0; i
< len
; i
++) {
373 while (bfin_read_NFC_STAT() & WB_FULL
)
376 bfin_write_NFC_DATA_WR(buf
[i
]);
381 static void bf5xx_nand_read_buf16(struct mtd_info
*mtd
, uint8_t *buf
, int len
)
384 u16
*p
= (u16
*) buf
;
388 * Data reads are requested by first writing to NFC_DATA_RD
389 * and then reading back from NFC_READ.
391 bfin_write_NFC_DATA_RD(0x5555);
395 for (i
= 0; i
< len
; i
++)
396 p
[i
] = bfin_read_NFC_READ();
399 static void bf5xx_nand_write_buf16(struct mtd_info
*mtd
,
400 const uint8_t *buf
, int len
)
403 u16
*p
= (u16
*) buf
;
406 for (i
= 0; i
< len
; i
++)
407 bfin_write_NFC_DATA_WR(p
[i
]);
413 * DMA functions for buffer writing and reading
415 static irqreturn_t
bf5xx_nand_dma_irq(int irq
, void *dev_id
)
417 struct bf5xx_nand_info
*info
= dev_id
;
419 clear_dma_irqstat(CH_NFC
);
421 complete(&info
->dma_completion
);
426 static int bf5xx_nand_dma_rw(struct mtd_info
*mtd
,
427 uint8_t *buf
, int is_read
)
429 struct bf5xx_nand_info
*info
= mtd_to_nand_info(mtd
);
430 struct bf5xx_nand_platform
*plat
= info
->platform
;
431 unsigned short page_size
= (plat
->page_size
? 512 : 256);
434 dev_dbg(info
->device
, " mtd->%p, buf->%p, is_read %d\n",
438 * Before starting a dma transfer, be sure to invalidate/flush
439 * the cache over the address range of your DMA buffer to
440 * prevent cache coherency problems. Otherwise very subtle bugs
441 * can be introduced to your driver.
444 invalidate_dcache_range((unsigned int)buf
,
445 (unsigned int)(buf
+ page_size
));
447 flush_dcache_range((unsigned int)buf
,
448 (unsigned int)(buf
+ page_size
));
451 * This register must be written before each page is
452 * transferred to generate the correct ECC register
455 bfin_write_NFC_RST(0x1);
459 clear_dma_irqstat(CH_NFC
);
461 /* setup DMA register with Blackfin DMA API */
462 set_dma_config(CH_NFC
, 0x0);
463 set_dma_start_addr(CH_NFC
, (unsigned long) buf
);
464 set_dma_x_count(CH_NFC
, (page_size
>> 2));
465 set_dma_x_modify(CH_NFC
, 4);
467 /* setup write or read operation */
468 val
= DI_EN
| WDSIZE_32
;
471 set_dma_config(CH_NFC
, val
);
474 /* Start PAGE read/write operation */
476 bfin_write_NFC_PGCTL(0x1);
478 bfin_write_NFC_PGCTL(0x2);
479 wait_for_completion(&info
->dma_completion
);
484 static void bf5xx_nand_dma_read_buf(struct mtd_info
*mtd
,
485 uint8_t *buf
, int len
)
487 struct bf5xx_nand_info
*info
= mtd_to_nand_info(mtd
);
488 struct bf5xx_nand_platform
*plat
= info
->platform
;
489 unsigned short page_size
= (plat
->page_size
? 512 : 256);
491 dev_dbg(info
->device
, "mtd->%p, buf->%p, int %d\n", mtd
, buf
, len
);
493 if (len
== page_size
)
494 bf5xx_nand_dma_rw(mtd
, buf
, 1);
496 bf5xx_nand_read_buf(mtd
, buf
, len
);
499 static void bf5xx_nand_dma_write_buf(struct mtd_info
*mtd
,
500 const uint8_t *buf
, int len
)
502 struct bf5xx_nand_info
*info
= mtd_to_nand_info(mtd
);
503 struct bf5xx_nand_platform
*plat
= info
->platform
;
504 unsigned short page_size
= (plat
->page_size
? 512 : 256);
506 dev_dbg(info
->device
, "mtd->%p, buf->%p, len %d\n", mtd
, buf
, len
);
508 if (len
== page_size
)
509 bf5xx_nand_dma_rw(mtd
, (uint8_t *)buf
, 0);
511 bf5xx_nand_write_buf(mtd
, buf
, len
);
515 * System initialization functions
518 static int bf5xx_nand_dma_init(struct bf5xx_nand_info
*info
)
527 init_completion(&info
->dma_completion
);
530 /* Setup DMAC1 channel mux for NFC which shared with SDH */
531 val
= bfin_read_DMAC1_PERIMUX();
533 bfin_write_DMAC1_PERIMUX(val
);
536 /* Request NFC DMA channel */
537 ret
= request_dma(CH_NFC
, "BF5XX NFC driver");
539 dev_err(info
->device
, " unable to get DMA channel\n");
543 set_dma_callback(CH_NFC
, (void *) bf5xx_nand_dma_irq
, (void *) info
);
545 /* Turn off the DMA channel first */
551 * BF5XX NFC hardware initialization
553 * - clear interrupt status
555 static int bf5xx_nand_hw_init(struct bf5xx_nand_info
*info
)
559 struct bf5xx_nand_platform
*plat
= info
->platform
;
561 /* setup NFC_CTL register */
562 dev_info(info
->device
,
563 "page_size=%d, data_width=%d, wr_dly=%d, rd_dly=%d\n",
564 (plat
->page_size
? 512 : 256),
565 (plat
->data_width
? 16 : 8),
566 plat
->wr_dly
, plat
->rd_dly
);
568 val
= (plat
->page_size
<< NFC_PG_SIZE_OFFSET
) |
569 (plat
->data_width
<< NFC_NWIDTH_OFFSET
) |
570 (plat
->rd_dly
<< NFC_RDDLY_OFFSET
) |
571 (plat
->rd_dly
<< NFC_WRDLY_OFFSET
);
572 dev_dbg(info
->device
, "NFC_CTL is 0x%04x\n", val
);
574 bfin_write_NFC_CTL(val
);
577 /* clear interrupt status */
578 bfin_write_NFC_IRQMASK(0x0);
580 val
= bfin_read_NFC_IRQSTAT();
581 bfin_write_NFC_IRQSTAT(val
);
584 if (peripheral_request_list(bfin_nfc_pin_req
, DRV_NAME
)) {
585 printk(KERN_ERR DRV_NAME
586 ": Requesting Peripherals failed\n");
590 /* DMA initialization */
591 if (bf5xx_nand_dma_init(info
))
598 * Device management interface
600 static int bf5xx_nand_add_partition(struct bf5xx_nand_info
*info
)
602 struct mtd_info
*mtd
= &info
->mtd
;
604 #ifdef CONFIG_MTD_PARTITIONS
605 struct mtd_partition
*parts
= info
->platform
->partitions
;
606 int nr
= info
->platform
->nr_partitions
;
608 return add_mtd_partitions(mtd
, parts
, nr
);
610 return add_mtd_device(mtd
);
614 static int bf5xx_nand_remove(struct platform_device
*pdev
)
616 struct bf5xx_nand_info
*info
= to_nand_info(pdev
);
617 struct mtd_info
*mtd
= NULL
;
619 platform_set_drvdata(pdev
, NULL
);
621 /* first thing we need to do is release all our mtds
622 * and their partitions, then go through freeing the
631 peripheral_free_list(bfin_nfc_pin_req
);
633 /* free the common resources */
642 * called by device layer when it finds a device matching
643 * one our driver can handled. This code checks to see if
644 * it can allocate all necessary resources then calls the
645 * nand layer to look for devices
647 static int bf5xx_nand_probe(struct platform_device
*pdev
)
649 struct bf5xx_nand_platform
*plat
= to_nand_plat(pdev
);
650 struct bf5xx_nand_info
*info
= NULL
;
651 struct nand_chip
*chip
= NULL
;
652 struct mtd_info
*mtd
= NULL
;
655 dev_dbg(&pdev
->dev
, "(%p)\n", pdev
);
658 dev_err(&pdev
->dev
, "no platform specific information\n");
662 info
= kzalloc(sizeof(*info
), GFP_KERNEL
);
664 dev_err(&pdev
->dev
, "no memory for flash info\n");
669 platform_set_drvdata(pdev
, info
);
671 spin_lock_init(&info
->controller
.lock
);
672 init_waitqueue_head(&info
->controller
.wq
);
674 info
->device
= &pdev
->dev
;
675 info
->platform
= plat
;
677 /* initialise chip data struct */
680 if (plat
->data_width
)
681 chip
->options
|= NAND_BUSWIDTH_16
;
683 chip
->options
|= NAND_CACHEPRG
| NAND_SKIP_BBTSCAN
;
685 chip
->read_buf
= (plat
->data_width
) ?
686 bf5xx_nand_read_buf16
: bf5xx_nand_read_buf
;
687 chip
->write_buf
= (plat
->data_width
) ?
688 bf5xx_nand_write_buf16
: bf5xx_nand_write_buf
;
690 chip
->read_byte
= bf5xx_nand_read_byte
;
692 chip
->cmd_ctrl
= bf5xx_nand_hwcontrol
;
693 chip
->dev_ready
= bf5xx_nand_devready
;
695 chip
->priv
= &info
->mtd
;
696 chip
->controller
= &info
->controller
;
698 chip
->IO_ADDR_R
= (void __iomem
*) NFC_READ
;
699 chip
->IO_ADDR_W
= (void __iomem
*) NFC_DATA_WR
;
701 chip
->chip_delay
= 0;
703 /* initialise mtd info data struct */
706 mtd
->owner
= THIS_MODULE
;
708 /* initialise the hardware */
709 err
= bf5xx_nand_hw_init(info
);
713 /* setup hardware ECC data struct */
715 if (plat
->page_size
== NFC_PG_SIZE_256
) {
717 chip
->ecc
.size
= 256;
718 } else if (plat
->page_size
== NFC_PG_SIZE_512
) {
720 chip
->ecc
.size
= 512;
723 chip
->read_buf
= bf5xx_nand_dma_read_buf
;
724 chip
->write_buf
= bf5xx_nand_dma_write_buf
;
725 chip
->ecc
.calculate
= bf5xx_nand_calculate_ecc
;
726 chip
->ecc
.correct
= bf5xx_nand_correct_data
;
727 chip
->ecc
.mode
= NAND_ECC_HW
;
728 chip
->ecc
.hwctl
= bf5xx_nand_enable_hwecc
;
730 chip
->ecc
.mode
= NAND_ECC_SOFT
;
733 /* scan hardware nand chip and setup mtd info data struct */
734 if (nand_scan(mtd
, 1)) {
739 /* add NAND partition */
740 bf5xx_nand_add_partition(info
);
742 dev_dbg(&pdev
->dev
, "initialised ok\n");
746 bf5xx_nand_remove(pdev
);
756 static int bf5xx_nand_suspend(struct platform_device
*dev
, pm_message_t pm
)
758 struct bf5xx_nand_info
*info
= platform_get_drvdata(dev
);
763 static int bf5xx_nand_resume(struct platform_device
*dev
)
765 struct bf5xx_nand_info
*info
= platform_get_drvdata(dev
);
771 #define bf5xx_nand_suspend NULL
772 #define bf5xx_nand_resume NULL
775 /* driver device registration */
776 static struct platform_driver bf5xx_nand_driver
= {
777 .probe
= bf5xx_nand_probe
,
778 .remove
= bf5xx_nand_remove
,
779 .suspend
= bf5xx_nand_suspend
,
780 .resume
= bf5xx_nand_resume
,
783 .owner
= THIS_MODULE
,
787 static int __init
bf5xx_nand_init(void)
789 printk(KERN_INFO
"%s, Version %s (c) 2007 Analog Devices, Inc.\n",
790 DRV_DESC
, DRV_VERSION
);
792 return platform_driver_register(&bf5xx_nand_driver
);
795 static void __exit
bf5xx_nand_exit(void)
797 platform_driver_unregister(&bf5xx_nand_driver
);
800 module_init(bf5xx_nand_init
);
801 module_exit(bf5xx_nand_exit
);
803 MODULE_LICENSE("GPL");
804 MODULE_AUTHOR(DRV_AUTHOR
);
805 MODULE_DESCRIPTION(DRV_DESC
);