1 /* linux/drivers/mtd/nand/bf5xx_nand.c
3 * Copyright 2006-2008 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
23 * This program is free software; you can redistribute it and/or modify
24 * it under the terms of the GNU General Public License as published by
25 * the Free Software Foundation; either version 2 of the License, or
26 * (at your option) any later version.
28 * This program is distributed in the hope that it will be useful,
29 * but WITHOUT ANY WARRANTY; without even the implied warranty of
30 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
31 * GNU General Public License for more details.
33 * You should have received a copy of the GNU General Public License
34 * along with this program; if not, write to the Free Software
35 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
38 #include <linux/module.h>
39 #include <linux/types.h>
40 #include <linux/init.h>
41 #include <linux/kernel.h>
42 #include <linux/string.h>
43 #include <linux/ioport.h>
44 #include <linux/platform_device.h>
45 #include <linux/delay.h>
46 #include <linux/dma-mapping.h>
47 #include <linux/err.h>
48 #include <linux/slab.h>
50 #include <linux/bitops.h>
52 #include <linux/mtd/mtd.h>
53 #include <linux/mtd/nand.h>
54 #include <linux/mtd/nand_ecc.h>
55 #include <linux/mtd/partitions.h>
57 #include <asm/blackfin.h>
59 #include <asm/cacheflush.h>
61 #include <asm/portmux.h>
63 #define DRV_NAME "bf5xx-nand"
64 #define DRV_VERSION "1.2"
65 #define DRV_AUTHOR "Bryan Wu <bryan.wu@analog.com>"
66 #define DRV_DESC "BF5xx on-chip NAND FLash Controller Driver"
69 #define NBUSY 0x01 /* Not Busy */
70 #define WB_FULL 0x02 /* Write Buffer Full */
71 #define PG_WR_STAT 0x04 /* Page Write Pending */
72 #define PG_RD_STAT 0x08 /* Page Read Pending */
73 #define WB_EMPTY 0x10 /* Write Buffer Empty */
75 /* NFC_IRQSTAT Masks */
76 #define NBUSYIRQ 0x01 /* Not Busy IRQ */
77 #define WB_OVF 0x02 /* Write Buffer Overflow */
78 #define WB_EDGE 0x04 /* Write Buffer Edge Detect */
79 #define RD_RDY 0x08 /* Read Data Ready */
80 #define WR_DONE 0x10 /* Page Write Done */
83 #define ECC_RST 0x01 /* ECC (and NFC counters) Reset */
86 #define PG_RD_START 0x01 /* Page Read Start */
87 #define PG_WR_START 0x02 /* Page Write Start */
89 #ifdef CONFIG_MTD_NAND_BF5XX_HWECC
90 static int hardware_ecc = 1;
92 static int hardware_ecc;
95 static const unsigned short bfin_nfc_pin_req[] =
112 #ifdef CONFIG_MTD_NAND_BF5XX_BOOTROM_ECC
113 static uint8_t bbt_pattern[] = { 0xff };
115 static struct nand_bbt_descr bootrom_bbt = {
119 .pattern = bbt_pattern,
122 static struct nand_ecclayout bootrom_ecclayout = {
125 0x8 * 0, 0x8 * 0 + 1, 0x8 * 0 + 2,
126 0x8 * 1, 0x8 * 1 + 1, 0x8 * 1 + 2,
127 0x8 * 2, 0x8 * 2 + 1, 0x8 * 2 + 2,
128 0x8 * 3, 0x8 * 3 + 1, 0x8 * 3 + 2,
129 0x8 * 4, 0x8 * 4 + 1, 0x8 * 4 + 2,
130 0x8 * 5, 0x8 * 5 + 1, 0x8 * 5 + 2,
131 0x8 * 6, 0x8 * 6 + 1, 0x8 * 6 + 2,
132 0x8 * 7, 0x8 * 7 + 1, 0x8 * 7 + 2
148 * Data structures for bf5xx nand flash controller driver
151 /* bf5xx nand info */
152 struct bf5xx_nand_info {
154 struct nand_hw_control controller;
156 struct nand_chip chip;
159 struct bf5xx_nand_platform *platform;
162 struct device *device;
165 struct completion dma_completion;
169 * Conversion functions
171 static struct bf5xx_nand_info *mtd_to_nand_info(struct mtd_info *mtd)
173 return container_of(mtd, struct bf5xx_nand_info, mtd);
176 static struct bf5xx_nand_info *to_nand_info(struct platform_device *pdev)
178 return platform_get_drvdata(pdev);
181 static struct bf5xx_nand_platform *to_nand_plat(struct platform_device *pdev)
183 return pdev->dev.platform_data;
187 * struct nand_chip interface function pointers
191 * bf5xx_nand_hwcontrol
193 * Issue command and address cycles to the chip
195 static void bf5xx_nand_hwcontrol(struct mtd_info *mtd, int cmd,
198 if (cmd == NAND_CMD_NONE)
201 while (bfin_read_NFC_STAT() & WB_FULL)
205 bfin_write_NFC_CMD(cmd);
206 else if (ctrl & NAND_ALE)
207 bfin_write_NFC_ADDR(cmd);
212 * bf5xx_nand_devready()
214 * returns 0 if the nand is busy, 1 if it is ready
216 static int bf5xx_nand_devready(struct mtd_info *mtd)
218 unsigned short val = bfin_read_NFC_STAT();
220 if ((val & NBUSY) == NBUSY)
228 * These allow the bf5xx to use the controller's ECC
229 * generator block to ECC the data as it passes through
233 * ECC error correction function
235 static int bf5xx_nand_correct_data_256(struct mtd_info *mtd, u_char *dat,
236 u_char *read_ecc, u_char *calc_ecc)
238 struct bf5xx_nand_info *info = mtd_to_nand_info(mtd);
242 unsigned short failing_bit, failing_byte;
245 calced = calc_ecc[0] | (calc_ecc[1] << 8) | (calc_ecc[2] << 16);
246 stored = read_ecc[0] | (read_ecc[1] << 8) | (read_ecc[2] << 16);
248 syndrome[0] = (calced ^ stored);
251 * syndrome 0: all zero
255 if (!syndrome[0] || !calced || !stored)
259 * sysdrome 0: only one bit is one
260 * ECC data was incorrect
263 if (hweight32(syndrome[0]) == 1) {
264 dev_err(info->device, "ECC data was incorrect!\n");
268 syndrome[1] = (calced & 0x7FF) ^ (stored & 0x7FF);
269 syndrome[2] = (calced & 0x7FF) ^ ((calced >> 11) & 0x7FF);
270 syndrome[3] = (stored & 0x7FF) ^ ((stored >> 11) & 0x7FF);
271 syndrome[4] = syndrome[2] ^ syndrome[3];
273 for (i = 0; i < 5; i++)
274 dev_info(info->device, "syndrome[%d] 0x%08x\n", i, syndrome[i]);
276 dev_info(info->device,
277 "calced[0x%08x], stored[0x%08x]\n",
281 * sysdrome 0: exactly 11 bits are one, each parity
282 * and parity' pair is 1 & 0 or 0 & 1.
283 * 1-bit correctable error
286 if (hweight32(syndrome[0]) == 11 && syndrome[4] == 0x7FF) {
287 dev_info(info->device,
288 "1-bit correctable error, correct it.\n");
289 dev_info(info->device,
290 "syndrome[1] 0x%08x\n", syndrome[1]);
292 failing_bit = syndrome[1] & 0x7;
293 failing_byte = syndrome[1] >> 0x3;
294 data = *(dat + failing_byte);
295 data = data ^ (0x1 << failing_bit);
296 *(dat + failing_byte) = data;
302 * sysdrome 0: random data
303 * More than 1-bit error, non-correctable error
304 * Discard data, mark bad block
306 dev_err(info->device,
307 "More than 1-bit error, non-correctable error.\n");
308 dev_err(info->device,
309 "Please discard data, mark bad block\n");
314 static int bf5xx_nand_correct_data(struct mtd_info *mtd, u_char *dat,
315 u_char *read_ecc, u_char *calc_ecc)
317 struct nand_chip *chip = mtd->priv;
320 ret = bf5xx_nand_correct_data_256(mtd, dat, read_ecc, calc_ecc);
322 /* If ecc size is 512, correct second 256 bytes */
323 if (chip->ecc.size == 512) {
327 ret |= bf5xx_nand_correct_data_256(mtd, dat, read_ecc, calc_ecc);
333 static void bf5xx_nand_enable_hwecc(struct mtd_info *mtd, int mode)
338 static int bf5xx_nand_calculate_ecc(struct mtd_info *mtd,
339 const u_char *dat, u_char *ecc_code)
341 struct bf5xx_nand_info *info = mtd_to_nand_info(mtd);
342 struct nand_chip *chip = mtd->priv;
347 /* first 3 bytes ECC code for 256 page size */
348 ecc0 = bfin_read_NFC_ECC0();
349 ecc1 = bfin_read_NFC_ECC1();
351 code[0] = (ecc0 & 0x7ff) | ((ecc1 & 0x7ff) << 11);
353 dev_dbg(info->device, "returning ecc 0x%08x\n", code[0]);
356 memcpy(ecc_code, p, 3);
358 /* second 3 bytes ECC code for 512 ecc size */
359 if (chip->ecc.size == 512) {
360 ecc0 = bfin_read_NFC_ECC2();
361 ecc1 = bfin_read_NFC_ECC3();
362 code[1] = (ecc0 & 0x7ff) | ((ecc1 & 0x7ff) << 11);
364 /* second 3 bytes in ecc_code for second 256
365 * bytes of 512 page size
367 p = (u8 *) (code + 1);
368 memcpy((ecc_code + 3), p, 3);
369 dev_dbg(info->device, "returning ecc 0x%08x\n", code[1]);
376 * PIO mode for buffer writing and reading
378 static void bf5xx_nand_read_buf(struct mtd_info *mtd, uint8_t *buf, int len)
384 * Data reads are requested by first writing to NFC_DATA_RD
385 * and then reading back from NFC_READ.
387 for (i = 0; i < len; i++) {
388 while (bfin_read_NFC_STAT() & WB_FULL)
391 /* Contents do not matter */
392 bfin_write_NFC_DATA_RD(0x0000);
395 while ((bfin_read_NFC_IRQSTAT() & RD_RDY) != RD_RDY)
398 buf[i] = bfin_read_NFC_READ();
400 val = bfin_read_NFC_IRQSTAT();
402 bfin_write_NFC_IRQSTAT(val);
407 static uint8_t bf5xx_nand_read_byte(struct mtd_info *mtd)
411 bf5xx_nand_read_buf(mtd, &val, 1);
416 static void bf5xx_nand_write_buf(struct mtd_info *mtd,
417 const uint8_t *buf, int len)
421 for (i = 0; i < len; i++) {
422 while (bfin_read_NFC_STAT() & WB_FULL)
425 bfin_write_NFC_DATA_WR(buf[i]);
430 static void bf5xx_nand_read_buf16(struct mtd_info *mtd, uint8_t *buf, int len)
433 u16 *p = (u16 *) buf;
437 * Data reads are requested by first writing to NFC_DATA_RD
438 * and then reading back from NFC_READ.
440 bfin_write_NFC_DATA_RD(0x5555);
444 for (i = 0; i < len; i++)
445 p[i] = bfin_read_NFC_READ();
448 static void bf5xx_nand_write_buf16(struct mtd_info *mtd,
449 const uint8_t *buf, int len)
452 u16 *p = (u16 *) buf;
455 for (i = 0; i < len; i++)
456 bfin_write_NFC_DATA_WR(p[i]);
462 * DMA functions for buffer writing and reading
464 static irqreturn_t bf5xx_nand_dma_irq(int irq, void *dev_id)
466 struct bf5xx_nand_info *info = dev_id;
468 clear_dma_irqstat(CH_NFC);
470 complete(&info->dma_completion);
475 static void bf5xx_nand_dma_rw(struct mtd_info *mtd,
476 uint8_t *buf, int is_read)
478 struct bf5xx_nand_info *info = mtd_to_nand_info(mtd);
479 struct nand_chip *chip = mtd->priv;
482 dev_dbg(info->device, " mtd->%p, buf->%p, is_read %d\n",
486 * Before starting a dma transfer, be sure to invalidate/flush
487 * the cache over the address range of your DMA buffer to
488 * prevent cache coherency problems. Otherwise very subtle bugs
489 * can be introduced to your driver.
492 invalidate_dcache_range((unsigned int)buf,
493 (unsigned int)(buf + chip->ecc.size));
495 flush_dcache_range((unsigned int)buf,
496 (unsigned int)(buf + chip->ecc.size));
499 * This register must be written before each page is
500 * transferred to generate the correct ECC register
503 bfin_write_NFC_RST(ECC_RST);
505 while (bfin_read_NFC_RST() & ECC_RST)
509 clear_dma_irqstat(CH_NFC);
511 /* setup DMA register with Blackfin DMA API */
512 set_dma_config(CH_NFC, 0x0);
513 set_dma_start_addr(CH_NFC, (unsigned long) buf);
515 /* The DMAs have different size on BF52x and BF54x */
517 set_dma_x_count(CH_NFC, (chip->ecc.size >> 1));
518 set_dma_x_modify(CH_NFC, 2);
519 val = DI_EN | WDSIZE_16;
523 set_dma_x_count(CH_NFC, (chip->ecc.size >> 2));
524 set_dma_x_modify(CH_NFC, 4);
525 val = DI_EN | WDSIZE_32;
527 /* setup write or read operation */
530 set_dma_config(CH_NFC, val);
533 /* Start PAGE read/write operation */
535 bfin_write_NFC_PGCTL(PG_RD_START);
537 bfin_write_NFC_PGCTL(PG_WR_START);
538 wait_for_completion(&info->dma_completion);
541 static void bf5xx_nand_dma_read_buf(struct mtd_info *mtd,
542 uint8_t *buf, int len)
544 struct bf5xx_nand_info *info = mtd_to_nand_info(mtd);
545 struct nand_chip *chip = mtd->priv;
547 dev_dbg(info->device, "mtd->%p, buf->%p, int %d\n", mtd, buf, len);
549 if (len == chip->ecc.size)
550 bf5xx_nand_dma_rw(mtd, buf, 1);
552 bf5xx_nand_read_buf(mtd, buf, len);
555 static void bf5xx_nand_dma_write_buf(struct mtd_info *mtd,
556 const uint8_t *buf, int len)
558 struct bf5xx_nand_info *info = mtd_to_nand_info(mtd);
559 struct nand_chip *chip = mtd->priv;
561 dev_dbg(info->device, "mtd->%p, buf->%p, len %d\n", mtd, buf, len);
563 if (len == chip->ecc.size)
564 bf5xx_nand_dma_rw(mtd, (uint8_t *)buf, 0);
566 bf5xx_nand_write_buf(mtd, buf, len);
569 static int bf5xx_nand_read_page_raw(struct mtd_info *mtd, struct nand_chip *chip,
570 uint8_t *buf, int page)
572 bf5xx_nand_read_buf(mtd, buf, mtd->writesize);
573 bf5xx_nand_read_buf(mtd, chip->oob_poi, mtd->oobsize);
578 static void bf5xx_nand_write_page_raw(struct mtd_info *mtd, struct nand_chip *chip,
581 bf5xx_nand_write_buf(mtd, buf, mtd->writesize);
582 bf5xx_nand_write_buf(mtd, chip->oob_poi, mtd->oobsize);
586 * System initialization functions
588 static int bf5xx_nand_dma_init(struct bf5xx_nand_info *info)
596 init_completion(&info->dma_completion);
598 /* Request NFC DMA channel */
599 ret = request_dma(CH_NFC, "BF5XX NFC driver");
601 dev_err(info->device, " unable to get DMA channel\n");
606 /* Setup DMAC1 channel mux for NFC which shared with SDH */
607 bfin_write_DMAC1_PERIMUX(bfin_read_DMAC1_PERIMUX() & ~1);
611 set_dma_callback(CH_NFC, bf5xx_nand_dma_irq, info);
613 /* Turn off the DMA channel first */
618 static void bf5xx_nand_dma_remove(struct bf5xx_nand_info *info)
620 /* Free NFC DMA channel */
626 * BF5XX NFC hardware initialization
628 * - clear interrupt status
630 static int bf5xx_nand_hw_init(struct bf5xx_nand_info *info)
634 struct bf5xx_nand_platform *plat = info->platform;
636 /* setup NFC_CTL register */
637 dev_info(info->device,
638 "data_width=%d, wr_dly=%d, rd_dly=%d\n",
639 (plat->data_width ? 16 : 8),
640 plat->wr_dly, plat->rd_dly);
642 val = (1 << NFC_PG_SIZE_OFFSET) |
643 (plat->data_width << NFC_NWIDTH_OFFSET) |
644 (plat->rd_dly << NFC_RDDLY_OFFSET) |
645 (plat->wr_dly << NFC_WRDLY_OFFSET);
646 dev_dbg(info->device, "NFC_CTL is 0x%04x\n", val);
648 bfin_write_NFC_CTL(val);
651 /* clear interrupt status */
652 bfin_write_NFC_IRQMASK(0x0);
654 val = bfin_read_NFC_IRQSTAT();
655 bfin_write_NFC_IRQSTAT(val);
658 /* DMA initialization */
659 if (bf5xx_nand_dma_init(info))
666 * Device management interface
668 static int __devinit bf5xx_nand_add_partition(struct bf5xx_nand_info *info)
670 struct mtd_info *mtd = &info->mtd;
672 #ifdef CONFIG_MTD_PARTITIONS
673 struct mtd_partition *parts = info->platform->partitions;
674 int nr = info->platform->nr_partitions;
676 return add_mtd_partitions(mtd, parts, nr);
678 return add_mtd_device(mtd);
682 static int __devexit bf5xx_nand_remove(struct platform_device *pdev)
684 struct bf5xx_nand_info *info = to_nand_info(pdev);
685 struct mtd_info *mtd = NULL;
687 platform_set_drvdata(pdev, NULL);
689 /* first thing we need to do is release all our mtds
690 * and their partitions, then go through freeing the
699 peripheral_free_list(bfin_nfc_pin_req);
700 bf5xx_nand_dma_remove(info);
702 /* free the common resources */
708 static int bf5xx_nand_scan(struct mtd_info *mtd)
710 struct nand_chip *chip = mtd->priv;
713 ret = nand_scan_ident(mtd, 1);
719 * for nand with page size > 512B, think it as several sections with 512B
721 if (likely(mtd->writesize >= 512)) {
722 chip->ecc.size = 512;
725 chip->ecc.size = 256;
727 bfin_write_NFC_CTL(bfin_read_NFC_CTL() & ~(1 << NFC_PG_SIZE_OFFSET));
732 return nand_scan_tail(mtd);
738 * called by device layer when it finds a device matching
739 * one our driver can handled. This code checks to see if
740 * it can allocate all necessary resources then calls the
741 * nand layer to look for devices
743 static int __devinit bf5xx_nand_probe(struct platform_device *pdev)
745 struct bf5xx_nand_platform *plat = to_nand_plat(pdev);
746 struct bf5xx_nand_info *info = NULL;
747 struct nand_chip *chip = NULL;
748 struct mtd_info *mtd = NULL;
751 dev_dbg(&pdev->dev, "(%p)\n", pdev);
754 dev_err(&pdev->dev, "no platform specific information\n");
758 if (peripheral_request_list(bfin_nfc_pin_req, DRV_NAME)) {
759 dev_err(&pdev->dev, "requesting Peripherals failed\n");
763 info = kzalloc(sizeof(*info), GFP_KERNEL);
765 dev_err(&pdev->dev, "no memory for flash info\n");
767 goto out_err_kzalloc;
770 platform_set_drvdata(pdev, info);
772 spin_lock_init(&info->controller.lock);
773 init_waitqueue_head(&info->controller.wq);
775 info->device = &pdev->dev;
776 info->platform = plat;
778 /* initialise chip data struct */
781 if (plat->data_width)
782 chip->options |= NAND_BUSWIDTH_16;
784 chip->options |= NAND_CACHEPRG | NAND_SKIP_BBTSCAN;
786 chip->read_buf = (plat->data_width) ?
787 bf5xx_nand_read_buf16 : bf5xx_nand_read_buf;
788 chip->write_buf = (plat->data_width) ?
789 bf5xx_nand_write_buf16 : bf5xx_nand_write_buf;
791 chip->read_byte = bf5xx_nand_read_byte;
793 chip->cmd_ctrl = bf5xx_nand_hwcontrol;
794 chip->dev_ready = bf5xx_nand_devready;
796 chip->priv = &info->mtd;
797 chip->controller = &info->controller;
799 chip->IO_ADDR_R = (void __iomem *) NFC_READ;
800 chip->IO_ADDR_W = (void __iomem *) NFC_DATA_WR;
802 chip->chip_delay = 0;
804 /* initialise mtd info data struct */
807 mtd->owner = THIS_MODULE;
809 /* initialise the hardware */
810 err = bf5xx_nand_hw_init(info);
812 goto out_err_hw_init;
814 /* setup hardware ECC data struct */
816 #ifdef CONFIG_MTD_NAND_BF5XX_BOOTROM_ECC
817 chip->badblock_pattern = &bootrom_bbt;
818 chip->ecc.layout = &bootrom_ecclayout;
820 chip->read_buf = bf5xx_nand_dma_read_buf;
821 chip->write_buf = bf5xx_nand_dma_write_buf;
822 chip->ecc.calculate = bf5xx_nand_calculate_ecc;
823 chip->ecc.correct = bf5xx_nand_correct_data;
824 chip->ecc.mode = NAND_ECC_HW;
825 chip->ecc.hwctl = bf5xx_nand_enable_hwecc;
826 chip->ecc.read_page_raw = bf5xx_nand_read_page_raw;
827 chip->ecc.write_page_raw = bf5xx_nand_write_page_raw;
829 chip->ecc.mode = NAND_ECC_SOFT;
832 /* scan hardware nand chip and setup mtd info data struct */
833 if (bf5xx_nand_scan(mtd)) {
835 goto out_err_nand_scan;
838 /* add NAND partition */
839 bf5xx_nand_add_partition(info);
841 dev_dbg(&pdev->dev, "initialised ok\n");
845 bf5xx_nand_dma_remove(info);
847 platform_set_drvdata(pdev, NULL);
850 peripheral_free_list(bfin_nfc_pin_req);
858 static int bf5xx_nand_suspend(struct platform_device *dev, pm_message_t pm)
860 struct bf5xx_nand_info *info = platform_get_drvdata(dev);
865 static int bf5xx_nand_resume(struct platform_device *dev)
867 struct bf5xx_nand_info *info = platform_get_drvdata(dev);
873 #define bf5xx_nand_suspend NULL
874 #define bf5xx_nand_resume NULL
877 /* driver device registration */
878 static struct platform_driver bf5xx_nand_driver = {
879 .probe = bf5xx_nand_probe,
880 .remove = __devexit_p(bf5xx_nand_remove),
881 .suspend = bf5xx_nand_suspend,
882 .resume = bf5xx_nand_resume,
885 .owner = THIS_MODULE,
889 static int __init bf5xx_nand_init(void)
891 printk(KERN_INFO "%s, Version %s (c) 2007 Analog Devices, Inc.\n",
892 DRV_DESC, DRV_VERSION);
894 return platform_driver_register(&bf5xx_nand_driver);
897 static void __exit bf5xx_nand_exit(void)
899 platform_driver_unregister(&bf5xx_nand_driver);
902 module_init(bf5xx_nand_init);
903 module_exit(bf5xx_nand_exit);
905 MODULE_LICENSE("GPL");
906 MODULE_AUTHOR(DRV_AUTHOR);
907 MODULE_DESCRIPTION(DRV_DESC);
908 MODULE_ALIAS("platform:" DRV_NAME);