5 * This is the generic MTD driver for NAND flash devices. It should be
6 * capable of working with almost all NAND chips currently available.
7 * Basic support for AG-AND chips is provided.
9 * Additional technical information is available on
10 * http://www.linux-mtd.infradead.org/doc/nand.html
12 * Copyright (C) 2000 Steven J. Hill (sjhill@realitydiluted.com)
13 * 2002-2006 Thomas Gleixner (tglx@linutronix.de)
16 * David Woodhouse for adding multichip support
18 * Aleph One Ltd. and Toby Churchill Ltd. for supporting the
19 * rework for 2K page size chips
22 * Enable cached programming for 2k page size chips
23 * Check, if mtd->ecctype should be set to MTD_ECC_HW
24 * if we have HW ecc support.
25 * The AG-AND chips have nice features for speed improvement,
26 * which are not supported yet. Read / program 4 pages in one go.
27 * BBT table is not serialized, has to be fixed
29 * This program is free software; you can redistribute it and/or modify
30 * it under the terms of the GNU General Public License version 2 as
31 * published by the Free Software Foundation.
37 #include <linux/module.h>
38 #include <linux/delay.h>
39 #include <linux/errno.h>
40 #include <linux/err.h>
41 #include <linux/sched.h>
42 #include <linux/slab.h>
43 #include <linux/types.h>
44 #include <linux/mtd/mtd.h>
45 #include <linux/mtd/nand.h>
46 #include <linux/mtd/nand_ecc.h>
47 #include <linux/mtd/compatmac.h>
48 #include <linux/interrupt.h>
49 #include <linux/bitops.h>
50 #include <linux/leds.h>
53 #ifdef CONFIG_MTD_PARTITIONS
54 #include <linux/mtd/partitions.h>
61 #define ENOTSUPP 524 /* Operation is not supported */
65 #include <linux/err.h>
66 #include <linux/mtd/compat.h>
67 #include <linux/mtd/mtd.h>
68 #include <linux/mtd/nand.h>
69 #include <linux/mtd/nand_ecc.h>
71 #ifdef CONFIG_MTD_PARTITIONS
72 #include <linux/mtd/partitions.h>
76 #include <asm/errno.h>
78 #ifdef CONFIG_JFFS2_NAND
79 #include <jffs2/jffs2.h>
83 * CONFIG_SYS_NAND_RESET_CNT is used as a timeout mechanism when resetting
84 * a flash. NAND flash is initialized prior to interrupts so standard timers
85 * can't be used. CONFIG_SYS_NAND_RESET_CNT should be set to a value
86 * which is greater than (max NAND reset time / NAND status read time).
87 * A conservative default of 200000 (500 us / 25 ns) is used as a default.
89 #ifndef CONFIG_SYS_NAND_RESET_CNT
90 #define CONFIG_SYS_NAND_RESET_CNT 200000
93 /* Define default oob placement schemes for large and small page devices */
94 static struct nand_ecclayout nand_oob_8 = {
104 static struct nand_ecclayout nand_oob_16 = {
106 .eccpos = {0, 1, 2, 3, 6, 7},
112 static struct nand_ecclayout nand_oob_64 = {
115 40, 41, 42, 43, 44, 45, 46, 47,
116 48, 49, 50, 51, 52, 53, 54, 55,
117 56, 57, 58, 59, 60, 61, 62, 63},
123 static struct nand_ecclayout nand_oob_128 = {
126 80, 81, 82, 83, 84, 85, 86, 87,
127 88, 89, 90, 91, 92, 93, 94, 95,
128 96, 97, 98, 99, 100, 101, 102, 103,
129 104, 105, 106, 107, 108, 109, 110, 111,
130 112, 113, 114, 115, 116, 117, 118, 119,
131 120, 121, 122, 123, 124, 125, 126, 127},
138 static int nand_get_device(struct nand_chip *chip, struct mtd_info *mtd,
141 static int nand_do_write_oob(struct mtd_info *mtd, loff_t to,
142 struct mtd_oob_ops *ops);
144 static int nand_wait(struct mtd_info *mtd, struct nand_chip *this);
147 * For devices which display every fart in the system on a separate LED. Is
148 * compiled away when LED support is disabled.
152 DEFINE_LED_TRIGGER(nand_led_trigger);
156 * nand_release_device - [GENERIC] release chip
157 * @mtd: MTD device structure
159 * Deselect, release chip lock and wake up anyone waiting on the device
163 static void nand_release_device(struct mtd_info *mtd)
165 struct nand_chip *chip = mtd->priv;
167 /* De-select the NAND device */
168 chip->select_chip(mtd, -1);
170 /* Release the controller and the chip */
171 spin_lock(&chip->controller->lock);
172 chip->controller->active = NULL;
173 chip->state = FL_READY;
174 wake_up(&chip->controller->wq);
175 spin_unlock(&chip->controller->lock);
178 static void nand_release_device (struct mtd_info *mtd)
180 struct nand_chip *this = mtd->priv;
181 this->select_chip(mtd, -1); /* De-select the NAND device */
186 * nand_read_byte - [DEFAULT] read one byte from the chip
187 * @mtd: MTD device structure
189 * Default read function for 8bit buswith
191 static uint8_t nand_read_byte(struct mtd_info *mtd)
193 struct nand_chip *chip = mtd->priv;
194 return readb(chip->IO_ADDR_R);
198 * nand_read_byte16 - [DEFAULT] read one byte endianess aware from the chip
199 * @mtd: MTD device structure
201 * Default read function for 16bit buswith with
202 * endianess conversion
204 static uint8_t nand_read_byte16(struct mtd_info *mtd)
206 struct nand_chip *chip = mtd->priv;
207 return (uint8_t) cpu_to_le16(readw(chip->IO_ADDR_R));
211 * nand_read_word - [DEFAULT] read one word from the chip
212 * @mtd: MTD device structure
214 * Default read function for 16bit buswith without
215 * endianess conversion
217 static u16 nand_read_word(struct mtd_info *mtd)
219 struct nand_chip *chip = mtd->priv;
220 return readw(chip->IO_ADDR_R);
224 * nand_select_chip - [DEFAULT] control CE line
225 * @mtd: MTD device structure
226 * @chipnr: chipnumber to select, -1 for deselect
228 * Default select function for 1 chip devices.
230 static void nand_select_chip(struct mtd_info *mtd, int chipnr)
232 struct nand_chip *chip = mtd->priv;
236 chip->cmd_ctrl(mtd, NAND_CMD_NONE, 0 | NAND_CTRL_CHANGE);
247 * nand_write_buf - [DEFAULT] write buffer to chip
248 * @mtd: MTD device structure
250 * @len: number of bytes to write
252 * Default write function for 8bit buswith
254 static void nand_write_buf(struct mtd_info *mtd, const uint8_t *buf, int len)
257 struct nand_chip *chip = mtd->priv;
259 for (i = 0; i < len; i++)
260 writeb(buf[i], chip->IO_ADDR_W);
264 * nand_read_buf - [DEFAULT] read chip data into buffer
265 * @mtd: MTD device structure
266 * @buf: buffer to store date
267 * @len: number of bytes to read
269 * Default read function for 8bit buswith
271 static void nand_read_buf(struct mtd_info *mtd, uint8_t *buf, int len)
274 struct nand_chip *chip = mtd->priv;
276 for (i = 0; i < len; i++)
277 buf[i] = readb(chip->IO_ADDR_R);
281 * nand_verify_buf - [DEFAULT] Verify chip data against buffer
282 * @mtd: MTD device structure
283 * @buf: buffer containing the data to compare
284 * @len: number of bytes to compare
286 * Default verify function for 8bit buswith
288 static int nand_verify_buf(struct mtd_info *mtd, const uint8_t *buf, int len)
291 struct nand_chip *chip = mtd->priv;
293 for (i = 0; i < len; i++)
294 if (buf[i] != readb(chip->IO_ADDR_R))
300 * nand_write_buf16 - [DEFAULT] write buffer to chip
301 * @mtd: MTD device structure
303 * @len: number of bytes to write
305 * Default write function for 16bit buswith
307 static void nand_write_buf16(struct mtd_info *mtd, const uint8_t *buf, int len)
310 struct nand_chip *chip = mtd->priv;
311 u16 *p = (u16 *) buf;
314 for (i = 0; i < len; i++)
315 writew(p[i], chip->IO_ADDR_W);
320 * nand_read_buf16 - [DEFAULT] read chip data into buffer
321 * @mtd: MTD device structure
322 * @buf: buffer to store date
323 * @len: number of bytes to read
325 * Default read function for 16bit buswith
327 static void nand_read_buf16(struct mtd_info *mtd, uint8_t *buf, int len)
330 struct nand_chip *chip = mtd->priv;
331 u16 *p = (u16 *) buf;
334 for (i = 0; i < len; i++)
335 p[i] = readw(chip->IO_ADDR_R);
339 * nand_verify_buf16 - [DEFAULT] Verify chip data against buffer
340 * @mtd: MTD device structure
341 * @buf: buffer containing the data to compare
342 * @len: number of bytes to compare
344 * Default verify function for 16bit buswith
346 static int nand_verify_buf16(struct mtd_info *mtd, const uint8_t *buf, int len)
349 struct nand_chip *chip = mtd->priv;
350 u16 *p = (u16 *) buf;
353 for (i = 0; i < len; i++)
354 if (p[i] != readw(chip->IO_ADDR_R))
361 * nand_block_bad - [DEFAULT] Read bad block marker from the chip
362 * @mtd: MTD device structure
363 * @ofs: offset from device start
364 * @getchip: 0, if the chip is already selected
366 * Check, if the block is bad.
368 static int nand_block_bad(struct mtd_info *mtd, loff_t ofs, int getchip)
370 int page, chipnr, res = 0;
371 struct nand_chip *chip = mtd->priv;
374 page = (int)(ofs >> chip->page_shift) & chip->pagemask;
377 chipnr = (int)(ofs >> chip->chip_shift);
379 nand_get_device(chip, mtd, FL_READING);
381 /* Select the NAND device */
382 chip->select_chip(mtd, chipnr);
385 if (chip->options & NAND_BUSWIDTH_16) {
386 chip->cmdfunc(mtd, NAND_CMD_READOOB, chip->badblockpos & 0xFE,
388 bad = cpu_to_le16(chip->read_word(mtd));
389 if (chip->badblockpos & 0x1)
391 if ((bad & 0xFF) != 0xff)
394 chip->cmdfunc(mtd, NAND_CMD_READOOB, chip->badblockpos, page);
395 if (chip->read_byte(mtd) != 0xff)
400 nand_release_device(mtd);
406 * nand_default_block_markbad - [DEFAULT] mark a block bad
407 * @mtd: MTD device structure
408 * @ofs: offset from device start
410 * This is the default implementation, which can be overridden by
411 * a hardware specific driver.
413 static int nand_default_block_markbad(struct mtd_info *mtd, loff_t ofs)
415 struct nand_chip *chip = mtd->priv;
416 uint8_t buf[2] = { 0, 0 };
419 /* Get block number */
420 block = (int)(ofs >> chip->bbt_erase_shift);
422 chip->bbt[block >> 2] |= 0x01 << ((block & 0x03) << 1);
424 /* Do we have a flash based bad block table ? */
425 if (chip->options & NAND_USE_FLASH_BBT)
426 ret = nand_update_bbt(mtd, ofs);
428 /* We write two bytes, so we dont have to mess with 16 bit
431 nand_get_device(chip, mtd, FL_WRITING);
433 chip->ops.len = chip->ops.ooblen = 2;
434 chip->ops.datbuf = NULL;
435 chip->ops.oobbuf = buf;
436 chip->ops.ooboffs = chip->badblockpos & ~0x01;
438 ret = nand_do_write_oob(mtd, ofs, &chip->ops);
439 nand_release_device(mtd);
442 mtd->ecc_stats.badblocks++;
448 * nand_check_wp - [GENERIC] check if the chip is write protected
449 * @mtd: MTD device structure
450 * Check, if the device is write protected
452 * The function expects, that the device is already selected
454 static int nand_check_wp(struct mtd_info *mtd)
456 struct nand_chip *chip = mtd->priv;
457 /* Check the WP bit */
458 chip->cmdfunc(mtd, NAND_CMD_STATUS, -1, -1);
459 return (chip->read_byte(mtd) & NAND_STATUS_WP) ? 0 : 1;
463 * nand_block_checkbad - [GENERIC] Check if a block is marked bad
464 * @mtd: MTD device structure
465 * @ofs: offset from device start
466 * @getchip: 0, if the chip is already selected
467 * @allowbbt: 1, if its allowed to access the bbt area
469 * Check, if the block is bad. Either by reading the bad block table or
470 * calling of the scan function.
472 static int nand_block_checkbad(struct mtd_info *mtd, loff_t ofs, int getchip,
475 struct nand_chip *chip = mtd->priv;
477 if (!(chip->options & NAND_BBT_SCANNED)) {
478 chip->options |= NAND_BBT_SCANNED;
483 return chip->block_bad(mtd, ofs, getchip);
485 /* Return info from the table */
486 return nand_isbad_bbt(mtd, ofs, allowbbt);
490 * Wait for the ready pin, after a command
491 * The timeout is catched later.
495 void nand_wait_ready(struct mtd_info *mtd)
497 struct nand_chip *chip = mtd->priv;
498 unsigned long timeo = jiffies + 2;
500 led_trigger_event(nand_led_trigger, LED_FULL);
501 /* wait until command is processed or timeout occures */
503 if (chip->dev_ready(mtd))
505 touch_softlockup_watchdog();
506 } while (time_before(jiffies, timeo));
507 led_trigger_event(nand_led_trigger, LED_OFF);
509 EXPORT_SYMBOL_GPL(nand_wait_ready);
511 void nand_wait_ready(struct mtd_info *mtd)
513 struct nand_chip *chip = mtd->priv;
514 u32 timeo = (CONFIG_SYS_HZ * 20) / 1000;
518 /* wait until command is processed or timeout occures */
519 while (get_timer(0) < timeo) {
521 if (chip->dev_ready(mtd))
528 * nand_command - [DEFAULT] Send command to NAND device
529 * @mtd: MTD device structure
530 * @command: the command to be sent
531 * @column: the column address for this command, -1 if none
532 * @page_addr: the page address for this command, -1 if none
534 * Send command to NAND device. This function is used for small page
535 * devices (256/512 Bytes per page)
537 static void nand_command(struct mtd_info *mtd, unsigned int command,
538 int column, int page_addr)
540 register struct nand_chip *chip = mtd->priv;
541 int ctrl = NAND_CTRL_CLE | NAND_CTRL_CHANGE;
542 uint32_t rst_sts_cnt = CONFIG_SYS_NAND_RESET_CNT;
545 * Write out the command to the device.
547 if (command == NAND_CMD_SEQIN) {
550 if (column >= mtd->writesize) {
552 column -= mtd->writesize;
553 readcmd = NAND_CMD_READOOB;
554 } else if (column < 256) {
555 /* First 256 bytes --> READ0 */
556 readcmd = NAND_CMD_READ0;
559 readcmd = NAND_CMD_READ1;
561 chip->cmd_ctrl(mtd, readcmd, ctrl);
562 ctrl &= ~NAND_CTRL_CHANGE;
564 chip->cmd_ctrl(mtd, command, ctrl);
567 * Address cycle, when necessary
569 ctrl = NAND_CTRL_ALE | NAND_CTRL_CHANGE;
570 /* Serially input address */
572 /* Adjust columns for 16 bit buswidth */
573 if (chip->options & NAND_BUSWIDTH_16)
575 chip->cmd_ctrl(mtd, column, ctrl);
576 ctrl &= ~NAND_CTRL_CHANGE;
578 if (page_addr != -1) {
579 chip->cmd_ctrl(mtd, page_addr, ctrl);
580 ctrl &= ~NAND_CTRL_CHANGE;
581 chip->cmd_ctrl(mtd, page_addr >> 8, ctrl);
582 /* One more address cycle for devices > 32MiB */
583 if (chip->chipsize > (32 << 20))
584 chip->cmd_ctrl(mtd, page_addr >> 16, ctrl);
586 chip->cmd_ctrl(mtd, NAND_CMD_NONE, NAND_NCE | NAND_CTRL_CHANGE);
589 * program and erase have their own busy handlers
590 * status and sequential in needs no delay
594 case NAND_CMD_PAGEPROG:
595 case NAND_CMD_ERASE1:
596 case NAND_CMD_ERASE2:
598 case NAND_CMD_STATUS:
604 udelay(chip->chip_delay);
605 chip->cmd_ctrl(mtd, NAND_CMD_STATUS,
606 NAND_CTRL_CLE | NAND_CTRL_CHANGE);
608 NAND_CMD_NONE, NAND_NCE | NAND_CTRL_CHANGE);
609 while (!(chip->read_byte(mtd) & NAND_STATUS_READY) &&
613 /* This applies to read commands */
616 * If we don't have access to the busy pin, we apply the given
619 if (!chip->dev_ready) {
620 udelay(chip->chip_delay);
624 /* Apply this short delay always to ensure that we do wait tWB in
625 * any case on any machine. */
628 nand_wait_ready(mtd);
632 * nand_command_lp - [DEFAULT] Send command to NAND large page device
633 * @mtd: MTD device structure
634 * @command: the command to be sent
635 * @column: the column address for this command, -1 if none
636 * @page_addr: the page address for this command, -1 if none
638 * Send command to NAND device. This is the version for the new large page
639 * devices We dont have the separate regions as we have in the small page
640 * devices. We must emulate NAND_CMD_READOOB to keep the code compatible.
642 static void nand_command_lp(struct mtd_info *mtd, unsigned int command,
643 int column, int page_addr)
645 register struct nand_chip *chip = mtd->priv;
646 uint32_t rst_sts_cnt = CONFIG_SYS_NAND_RESET_CNT;
648 /* Emulate NAND_CMD_READOOB */
649 if (command == NAND_CMD_READOOB) {
650 column += mtd->writesize;
651 command = NAND_CMD_READ0;
654 /* Command latch cycle */
655 chip->cmd_ctrl(mtd, command & 0xff,
656 NAND_NCE | NAND_CLE | NAND_CTRL_CHANGE);
658 if (column != -1 || page_addr != -1) {
659 int ctrl = NAND_CTRL_CHANGE | NAND_NCE | NAND_ALE;
661 /* Serially input address */
663 /* Adjust columns for 16 bit buswidth */
664 if (chip->options & NAND_BUSWIDTH_16)
666 chip->cmd_ctrl(mtd, column, ctrl);
667 ctrl &= ~NAND_CTRL_CHANGE;
668 chip->cmd_ctrl(mtd, column >> 8, ctrl);
670 if (page_addr != -1) {
671 chip->cmd_ctrl(mtd, page_addr, ctrl);
672 chip->cmd_ctrl(mtd, page_addr >> 8,
673 NAND_NCE | NAND_ALE);
674 /* One more address cycle for devices > 128MiB */
675 if (chip->chipsize > (128 << 20))
676 chip->cmd_ctrl(mtd, page_addr >> 16,
677 NAND_NCE | NAND_ALE);
680 chip->cmd_ctrl(mtd, NAND_CMD_NONE, NAND_NCE | NAND_CTRL_CHANGE);
683 * program and erase have their own busy handlers
684 * status, sequential in, and deplete1 need no delay
688 case NAND_CMD_CACHEDPROG:
689 case NAND_CMD_PAGEPROG:
690 case NAND_CMD_ERASE1:
691 case NAND_CMD_ERASE2:
694 case NAND_CMD_STATUS:
695 case NAND_CMD_DEPLETE1:
699 * read error status commands require only a short delay
701 case NAND_CMD_STATUS_ERROR:
702 case NAND_CMD_STATUS_ERROR0:
703 case NAND_CMD_STATUS_ERROR1:
704 case NAND_CMD_STATUS_ERROR2:
705 case NAND_CMD_STATUS_ERROR3:
706 udelay(chip->chip_delay);
712 udelay(chip->chip_delay);
713 chip->cmd_ctrl(mtd, NAND_CMD_STATUS,
714 NAND_NCE | NAND_CLE | NAND_CTRL_CHANGE);
715 chip->cmd_ctrl(mtd, NAND_CMD_NONE,
716 NAND_NCE | NAND_CTRL_CHANGE);
717 while (!(chip->read_byte(mtd) & NAND_STATUS_READY) &&
721 case NAND_CMD_RNDOUT:
722 /* No ready / busy check necessary */
723 chip->cmd_ctrl(mtd, NAND_CMD_RNDOUTSTART,
724 NAND_NCE | NAND_CLE | NAND_CTRL_CHANGE);
725 chip->cmd_ctrl(mtd, NAND_CMD_NONE,
726 NAND_NCE | NAND_CTRL_CHANGE);
730 chip->cmd_ctrl(mtd, NAND_CMD_READSTART,
731 NAND_NCE | NAND_CLE | NAND_CTRL_CHANGE);
732 chip->cmd_ctrl(mtd, NAND_CMD_NONE,
733 NAND_NCE | NAND_CTRL_CHANGE);
735 /* This applies to read commands */
738 * If we don't have access to the busy pin, we apply the given
741 if (!chip->dev_ready) {
742 udelay(chip->chip_delay);
747 /* Apply this short delay always to ensure that we do wait tWB in
748 * any case on any machine. */
751 nand_wait_ready(mtd);
755 * nand_get_device - [GENERIC] Get chip for selected access
756 * @chip: the nand chip descriptor
757 * @mtd: MTD device structure
758 * @new_state: the state which is requested
760 * Get the device and lock it for exclusive access
765 nand_get_device(struct nand_chip *chip, struct mtd_info *mtd, int new_state)
767 spinlock_t *lock = &chip->controller->lock;
768 wait_queue_head_t *wq = &chip->controller->wq;
769 DECLARE_WAITQUEUE(wait, current);
773 /* Hardware controller shared among independend devices */
774 /* Hardware controller shared among independend devices */
775 if (!chip->controller->active)
776 chip->controller->active = chip;
778 if (chip->controller->active == chip && chip->state == FL_READY) {
779 chip->state = new_state;
783 if (new_state == FL_PM_SUSPENDED) {
785 return (chip->state == FL_PM_SUSPENDED) ? 0 : -EAGAIN;
787 set_current_state(TASK_UNINTERRUPTIBLE);
788 add_wait_queue(wq, &wait);
791 remove_wait_queue(wq, &wait);
795 static int nand_get_device (struct nand_chip *this, struct mtd_info *mtd, int new_state)
797 this->state = new_state;
803 * nand_wait - [DEFAULT] wait until the command is done
804 * @mtd: MTD device structure
805 * @chip: NAND chip structure
807 * Wait for command done. This applies to erase and program only
808 * Erase can take up to 400ms and program up to 20ms according to
809 * general NAND and SmartMedia specs
813 static int nand_wait(struct mtd_info *mtd, struct nand_chip *chip)
816 unsigned long timeo = jiffies;
817 int status, state = chip->state;
819 if (state == FL_ERASING)
820 timeo += (HZ * 400) / 1000;
822 timeo += (HZ * 20) / 1000;
824 led_trigger_event(nand_led_trigger, LED_FULL);
826 /* Apply this short delay always to ensure that we do wait tWB in
827 * any case on any machine. */
830 if ((state == FL_ERASING) && (chip->options & NAND_IS_AND))
831 chip->cmdfunc(mtd, NAND_CMD_STATUS_MULTI, -1, -1);
833 chip->cmdfunc(mtd, NAND_CMD_STATUS, -1, -1);
835 while (time_before(jiffies, timeo)) {
836 if (chip->dev_ready) {
837 if (chip->dev_ready(mtd))
840 if (chip->read_byte(mtd) & NAND_STATUS_READY)
845 led_trigger_event(nand_led_trigger, LED_OFF);
847 status = (int)chip->read_byte(mtd);
851 static int nand_wait(struct mtd_info *mtd, struct nand_chip *this)
854 int state = this->state;
856 if (state == FL_ERASING)
857 timeo = (CONFIG_SYS_HZ * 400) / 1000;
859 timeo = (CONFIG_SYS_HZ * 20) / 1000;
861 if ((state == FL_ERASING) && (this->options & NAND_IS_AND))
862 this->cmdfunc(mtd, NAND_CMD_STATUS_MULTI, -1, -1);
864 this->cmdfunc(mtd, NAND_CMD_STATUS, -1, -1);
869 if (get_timer(0) > timeo) {
874 if (this->dev_ready) {
875 if (this->dev_ready(mtd))
878 if (this->read_byte(mtd) & NAND_STATUS_READY)
882 #ifdef PPCHAMELON_NAND_TIMER_HACK
884 while (get_timer(0) < 10);
885 #endif /* PPCHAMELON_NAND_TIMER_HACK */
887 return this->read_byte(mtd);
892 * nand_read_page_raw - [Intern] read raw page data without ecc
893 * @mtd: mtd info structure
894 * @chip: nand chip info structure
895 * @buf: buffer to store read data
896 * @page: page number to read
898 * Not for syndrome calculating ecc controllers, which use a special oob layout
900 static int nand_read_page_raw(struct mtd_info *mtd, struct nand_chip *chip,
901 uint8_t *buf, int page)
903 chip->read_buf(mtd, buf, mtd->writesize);
904 chip->read_buf(mtd, chip->oob_poi, mtd->oobsize);
909 * nand_read_page_raw_syndrome - [Intern] read raw page data without ecc
910 * @mtd: mtd info structure
911 * @chip: nand chip info structure
912 * @buf: buffer to store read data
913 * @page: page number to read
915 * We need a special oob layout and handling even when OOB isn't used.
917 static int nand_read_page_raw_syndrome(struct mtd_info *mtd, struct nand_chip *chip,
918 uint8_t *buf, int page)
920 int eccsize = chip->ecc.size;
921 int eccbytes = chip->ecc.bytes;
922 uint8_t *oob = chip->oob_poi;
925 for (steps = chip->ecc.steps; steps > 0; steps--) {
926 chip->read_buf(mtd, buf, eccsize);
929 if (chip->ecc.prepad) {
930 chip->read_buf(mtd, oob, chip->ecc.prepad);
931 oob += chip->ecc.prepad;
934 chip->read_buf(mtd, oob, eccbytes);
937 if (chip->ecc.postpad) {
938 chip->read_buf(mtd, oob, chip->ecc.postpad);
939 oob += chip->ecc.postpad;
943 size = mtd->oobsize - (oob - chip->oob_poi);
945 chip->read_buf(mtd, oob, size);
951 * nand_read_page_swecc - [REPLACABLE] software ecc based page read function
952 * @mtd: mtd info structure
953 * @chip: nand chip info structure
954 * @buf: buffer to store read data
955 * @page: page number to read
957 static int nand_read_page_swecc(struct mtd_info *mtd, struct nand_chip *chip,
958 uint8_t *buf, int page)
960 int i, eccsize = chip->ecc.size;
961 int eccbytes = chip->ecc.bytes;
962 int eccsteps = chip->ecc.steps;
964 uint8_t *ecc_calc = chip->buffers->ecccalc;
965 uint8_t *ecc_code = chip->buffers->ecccode;
966 uint32_t *eccpos = chip->ecc.layout->eccpos;
968 chip->ecc.read_page_raw(mtd, chip, buf, page);
970 for (i = 0; eccsteps; eccsteps--, i += eccbytes, p += eccsize)
971 chip->ecc.calculate(mtd, p, &ecc_calc[i]);
973 for (i = 0; i < chip->ecc.total; i++)
974 ecc_code[i] = chip->oob_poi[eccpos[i]];
976 eccsteps = chip->ecc.steps;
979 for (i = 0 ; eccsteps; eccsteps--, i += eccbytes, p += eccsize) {
982 stat = chip->ecc.correct(mtd, p, &ecc_code[i], &ecc_calc[i]);
984 mtd->ecc_stats.failed++;
986 mtd->ecc_stats.corrected += stat;
992 * nand_read_subpage - [REPLACABLE] software ecc based sub-page read function
993 * @mtd: mtd info structure
994 * @chip: nand chip info structure
995 * @data_offs: offset of requested data within the page
996 * @readlen: data length
997 * @bufpoi: buffer to store read data
999 static int nand_read_subpage(struct mtd_info *mtd, struct nand_chip *chip, uint32_t data_offs, uint32_t readlen, uint8_t *bufpoi)
1001 int start_step, end_step, num_steps;
1002 uint32_t *eccpos = chip->ecc.layout->eccpos;
1004 int data_col_addr, i, gaps = 0;
1005 int datafrag_len, eccfrag_len, aligned_len, aligned_pos;
1006 int busw = (chip->options & NAND_BUSWIDTH_16) ? 2 : 1;
1008 /* Column address wihin the page aligned to ECC size (256bytes). */
1009 start_step = data_offs / chip->ecc.size;
1010 end_step = (data_offs + readlen - 1) / chip->ecc.size;
1011 num_steps = end_step - start_step + 1;
1013 /* Data size aligned to ECC ecc.size*/
1014 datafrag_len = num_steps * chip->ecc.size;
1015 eccfrag_len = num_steps * chip->ecc.bytes;
1017 data_col_addr = start_step * chip->ecc.size;
1018 /* If we read not a page aligned data */
1019 if (data_col_addr != 0)
1020 chip->cmdfunc(mtd, NAND_CMD_RNDOUT, data_col_addr, -1);
1022 p = bufpoi + data_col_addr;
1023 chip->read_buf(mtd, p, datafrag_len);
1026 for (i = 0; i < eccfrag_len ; i += chip->ecc.bytes, p += chip->ecc.size)
1027 chip->ecc.calculate(mtd, p, &chip->buffers->ecccalc[i]);
1029 /* The performance is faster if to position offsets
1030 according to ecc.pos. Let make sure here that
1031 there are no gaps in ecc positions */
1032 for (i = 0; i < eccfrag_len - 1; i++) {
1033 if (eccpos[i + start_step * chip->ecc.bytes] + 1 !=
1034 eccpos[i + start_step * chip->ecc.bytes + 1]) {
1040 chip->cmdfunc(mtd, NAND_CMD_RNDOUT, mtd->writesize, -1);
1041 chip->read_buf(mtd, chip->oob_poi, mtd->oobsize);
1043 /* send the command to read the particular ecc bytes */
1044 /* take care about buswidth alignment in read_buf */
1045 aligned_pos = eccpos[start_step * chip->ecc.bytes] & ~(busw - 1);
1046 aligned_len = eccfrag_len;
1047 if (eccpos[start_step * chip->ecc.bytes] & (busw - 1))
1049 if (eccpos[(start_step + num_steps) * chip->ecc.bytes] & (busw - 1))
1052 chip->cmdfunc(mtd, NAND_CMD_RNDOUT, mtd->writesize + aligned_pos, -1);
1053 chip->read_buf(mtd, &chip->oob_poi[aligned_pos], aligned_len);
1056 for (i = 0; i < eccfrag_len; i++)
1057 chip->buffers->ecccode[i] = chip->oob_poi[eccpos[i + start_step * chip->ecc.bytes]];
1059 p = bufpoi + data_col_addr;
1060 for (i = 0; i < eccfrag_len ; i += chip->ecc.bytes, p += chip->ecc.size) {
1063 stat = chip->ecc.correct(mtd, p, &chip->buffers->ecccode[i], &chip->buffers->ecccalc[i]);
1065 mtd->ecc_stats.failed++;
1067 mtd->ecc_stats.corrected += stat;
1073 * nand_read_page_hwecc - [REPLACABLE] hardware ecc based page read function
1074 * @mtd: mtd info structure
1075 * @chip: nand chip info structure
1076 * @buf: buffer to store read data
1077 * @page: page number to read
1079 * Not for syndrome calculating ecc controllers which need a special oob layout
1081 static int nand_read_page_hwecc(struct mtd_info *mtd, struct nand_chip *chip,
1082 uint8_t *buf, int page)
1084 int i, eccsize = chip->ecc.size;
1085 int eccbytes = chip->ecc.bytes;
1086 int eccsteps = chip->ecc.steps;
1088 uint8_t *ecc_calc = chip->buffers->ecccalc;
1089 uint8_t *ecc_code = chip->buffers->ecccode;
1090 uint32_t *eccpos = chip->ecc.layout->eccpos;
1092 for (i = 0; eccsteps; eccsteps--, i += eccbytes, p += eccsize) {
1093 chip->ecc.hwctl(mtd, NAND_ECC_READ);
1094 chip->read_buf(mtd, p, eccsize);
1095 chip->ecc.calculate(mtd, p, &ecc_calc[i]);
1097 chip->read_buf(mtd, chip->oob_poi, mtd->oobsize);
1099 for (i = 0; i < chip->ecc.total; i++)
1100 ecc_code[i] = chip->oob_poi[eccpos[i]];
1102 eccsteps = chip->ecc.steps;
1105 for (i = 0 ; eccsteps; eccsteps--, i += eccbytes, p += eccsize) {
1108 stat = chip->ecc.correct(mtd, p, &ecc_code[i], &ecc_calc[i]);
1110 mtd->ecc_stats.failed++;
1112 mtd->ecc_stats.corrected += stat;
1118 * nand_read_page_hwecc_oob_first - [REPLACABLE] hw ecc, read oob first
1119 * @mtd: mtd info structure
1120 * @chip: nand chip info structure
1121 * @buf: buffer to store read data
1122 * @page: page number to read
1124 * Hardware ECC for large page chips, require OOB to be read first.
1125 * For this ECC mode, the write_page method is re-used from ECC_HW.
1126 * These methods read/write ECC from the OOB area, unlike the
1127 * ECC_HW_SYNDROME support with multiple ECC steps, follows the
1128 * "infix ECC" scheme and reads/writes ECC from the data area, by
1129 * overwriting the NAND manufacturer bad block markings.
1131 static int nand_read_page_hwecc_oob_first(struct mtd_info *mtd,
1132 struct nand_chip *chip, uint8_t *buf, int page)
1134 int i, eccsize = chip->ecc.size;
1135 int eccbytes = chip->ecc.bytes;
1136 int eccsteps = chip->ecc.steps;
1138 uint8_t *ecc_code = chip->buffers->ecccode;
1139 uint32_t *eccpos = chip->ecc.layout->eccpos;
1140 uint8_t *ecc_calc = chip->buffers->ecccalc;
1142 /* Read the OOB area first */
1143 chip->cmdfunc(mtd, NAND_CMD_READOOB, 0, page);
1144 chip->read_buf(mtd, chip->oob_poi, mtd->oobsize);
1145 chip->cmdfunc(mtd, NAND_CMD_READ0, 0, page);
1147 for (i = 0; i < chip->ecc.total; i++)
1148 ecc_code[i] = chip->oob_poi[eccpos[i]];
1150 for (i = 0; eccsteps; eccsteps--, i += eccbytes, p += eccsize) {
1153 chip->ecc.hwctl(mtd, NAND_ECC_READ);
1154 chip->read_buf(mtd, p, eccsize);
1155 chip->ecc.calculate(mtd, p, &ecc_calc[i]);
1157 stat = chip->ecc.correct(mtd, p, &ecc_code[i], NULL);
1159 mtd->ecc_stats.failed++;
1161 mtd->ecc_stats.corrected += stat;
1167 * nand_read_page_syndrome - [REPLACABLE] hardware ecc syndrom based page read
1168 * @mtd: mtd info structure
1169 * @chip: nand chip info structure
1170 * @buf: buffer to store read data
1171 * @page: page number to read
1173 * The hw generator calculates the error syndrome automatically. Therefor
1174 * we need a special oob layout and handling.
1176 static int nand_read_page_syndrome(struct mtd_info *mtd, struct nand_chip *chip,
1177 uint8_t *buf, int page)
1179 int i, eccsize = chip->ecc.size;
1180 int eccbytes = chip->ecc.bytes;
1181 int eccsteps = chip->ecc.steps;
1183 uint8_t *oob = chip->oob_poi;
1185 for (i = 0; eccsteps; eccsteps--, i += eccbytes, p += eccsize) {
1188 chip->ecc.hwctl(mtd, NAND_ECC_READ);
1189 chip->read_buf(mtd, p, eccsize);
1191 if (chip->ecc.prepad) {
1192 chip->read_buf(mtd, oob, chip->ecc.prepad);
1193 oob += chip->ecc.prepad;
1196 chip->ecc.hwctl(mtd, NAND_ECC_READSYN);
1197 chip->read_buf(mtd, oob, eccbytes);
1198 stat = chip->ecc.correct(mtd, p, oob, NULL);
1201 mtd->ecc_stats.failed++;
1203 mtd->ecc_stats.corrected += stat;
1207 if (chip->ecc.postpad) {
1208 chip->read_buf(mtd, oob, chip->ecc.postpad);
1209 oob += chip->ecc.postpad;
1213 /* Calculate remaining oob bytes */
1214 i = mtd->oobsize - (oob - chip->oob_poi);
1216 chip->read_buf(mtd, oob, i);
1222 * nand_transfer_oob - [Internal] Transfer oob to client buffer
1223 * @chip: nand chip structure
1224 * @oob: oob destination address
1225 * @ops: oob ops structure
1226 * @len: size of oob to transfer
1228 static uint8_t *nand_transfer_oob(struct nand_chip *chip, uint8_t *oob,
1229 struct mtd_oob_ops *ops, size_t len)
1235 memcpy(oob, chip->oob_poi + ops->ooboffs, len);
1238 case MTD_OOB_AUTO: {
1239 struct nand_oobfree *free = chip->ecc.layout->oobfree;
1240 uint32_t boffs = 0, roffs = ops->ooboffs;
1243 for(; free->length && len; free++, len -= bytes) {
1244 /* Read request not from offset 0 ? */
1245 if (unlikely(roffs)) {
1246 if (roffs >= free->length) {
1247 roffs -= free->length;
1250 boffs = free->offset + roffs;
1251 bytes = min_t(size_t, len,
1252 (free->length - roffs));
1255 bytes = min_t(size_t, len, free->length);
1256 boffs = free->offset;
1258 memcpy(oob, chip->oob_poi + boffs, bytes);
1270 * nand_do_read_ops - [Internal] Read data with ECC
1272 * @mtd: MTD device structure
1273 * @from: offset to read from
1274 * @ops: oob ops structure
1276 * Internal function. Called with chip held.
1278 static int nand_do_read_ops(struct mtd_info *mtd, loff_t from,
1279 struct mtd_oob_ops *ops)
1281 int chipnr, page, realpage, col, bytes, aligned;
1282 struct nand_chip *chip = mtd->priv;
1283 struct mtd_ecc_stats stats;
1284 int blkcheck = (1 << (chip->phys_erase_shift - chip->page_shift)) - 1;
1287 uint32_t readlen = ops->len;
1288 uint32_t oobreadlen = ops->ooblen;
1289 uint8_t *bufpoi, *oob, *buf;
1291 stats = mtd->ecc_stats;
1293 chipnr = (int)(from >> chip->chip_shift);
1294 chip->select_chip(mtd, chipnr);
1296 realpage = (int)(from >> chip->page_shift);
1297 page = realpage & chip->pagemask;
1299 col = (int)(from & (mtd->writesize - 1));
1305 bytes = min(mtd->writesize - col, readlen);
1306 aligned = (bytes == mtd->writesize);
1308 /* Is the current page in the buffer ? */
1309 if (realpage != chip->pagebuf || oob) {
1310 bufpoi = aligned ? buf : chip->buffers->databuf;
1312 if (likely(sndcmd)) {
1313 chip->cmdfunc(mtd, NAND_CMD_READ0, 0x00, page);
1317 /* Now read the page into the buffer */
1318 if (unlikely(ops->mode == MTD_OOB_RAW))
1319 ret = chip->ecc.read_page_raw(mtd, chip,
1321 else if (!aligned && NAND_SUBPAGE_READ(chip) && !oob)
1322 ret = chip->ecc.read_subpage(mtd, chip, col, bytes, bufpoi);
1324 ret = chip->ecc.read_page(mtd, chip, bufpoi,
1329 /* Transfer not aligned data */
1331 if (!NAND_SUBPAGE_READ(chip) && !oob)
1332 chip->pagebuf = realpage;
1333 memcpy(buf, chip->buffers->databuf + col, bytes);
1338 if (unlikely(oob)) {
1339 /* Raw mode does data:oob:data:oob */
1340 if (ops->mode != MTD_OOB_RAW) {
1341 int toread = min(oobreadlen,
1342 chip->ecc.layout->oobavail);
1344 oob = nand_transfer_oob(chip,
1346 oobreadlen -= toread;
1349 buf = nand_transfer_oob(chip,
1350 buf, ops, mtd->oobsize);
1353 if (!(chip->options & NAND_NO_READRDY)) {
1355 * Apply delay or wait for ready/busy pin. Do
1356 * this before the AUTOINCR check, so no
1357 * problems arise if a chip which does auto
1358 * increment is marked as NOAUTOINCR by the
1361 if (!chip->dev_ready)
1362 udelay(chip->chip_delay);
1364 nand_wait_ready(mtd);
1367 memcpy(buf, chip->buffers->databuf + col, bytes);
1376 /* For subsequent reads align to page boundary. */
1378 /* Increment page address */
1381 page = realpage & chip->pagemask;
1382 /* Check, if we cross a chip boundary */
1385 chip->select_chip(mtd, -1);
1386 chip->select_chip(mtd, chipnr);
1389 /* Check, if the chip supports auto page increment
1390 * or if we have hit a block boundary.
1392 if (!NAND_CANAUTOINCR(chip) || !(page & blkcheck))
1396 ops->retlen = ops->len - (size_t) readlen;
1398 ops->oobretlen = ops->ooblen - oobreadlen;
1403 if (mtd->ecc_stats.failed - stats.failed)
1406 return mtd->ecc_stats.corrected - stats.corrected ? -EUCLEAN : 0;
1410 * nand_read - [MTD Interface] MTD compability function for nand_do_read_ecc
1411 * @mtd: MTD device structure
1412 * @from: offset to read from
1413 * @len: number of bytes to read
1414 * @retlen: pointer to variable to store the number of read bytes
1415 * @buf: the databuffer to put data
1417 * Get hold of the chip and call nand_do_read
1419 static int nand_read(struct mtd_info *mtd, loff_t from, size_t len,
1420 size_t *retlen, uint8_t *buf)
1422 struct nand_chip *chip = mtd->priv;
1425 /* Do not allow reads past end of device */
1426 if ((from + len) > mtd->size)
1431 nand_get_device(chip, mtd, FL_READING);
1433 chip->ops.len = len;
1434 chip->ops.datbuf = buf;
1435 chip->ops.oobbuf = NULL;
1437 ret = nand_do_read_ops(mtd, from, &chip->ops);
1439 *retlen = chip->ops.retlen;
1441 nand_release_device(mtd);
1447 * nand_read_oob_std - [REPLACABLE] the most common OOB data read function
1448 * @mtd: mtd info structure
1449 * @chip: nand chip info structure
1450 * @page: page number to read
1451 * @sndcmd: flag whether to issue read command or not
1453 static int nand_read_oob_std(struct mtd_info *mtd, struct nand_chip *chip,
1454 int page, int sndcmd)
1457 chip->cmdfunc(mtd, NAND_CMD_READOOB, 0, page);
1460 chip->read_buf(mtd, chip->oob_poi, mtd->oobsize);
1465 * nand_read_oob_syndrome - [REPLACABLE] OOB data read function for HW ECC
1467 * @mtd: mtd info structure
1468 * @chip: nand chip info structure
1469 * @page: page number to read
1470 * @sndcmd: flag whether to issue read command or not
1472 static int nand_read_oob_syndrome(struct mtd_info *mtd, struct nand_chip *chip,
1473 int page, int sndcmd)
1475 uint8_t *buf = chip->oob_poi;
1476 int length = mtd->oobsize;
1477 int chunk = chip->ecc.bytes + chip->ecc.prepad + chip->ecc.postpad;
1478 int eccsize = chip->ecc.size;
1479 uint8_t *bufpoi = buf;
1480 int i, toread, sndrnd = 0, pos;
1482 chip->cmdfunc(mtd, NAND_CMD_READ0, chip->ecc.size, page);
1483 for (i = 0; i < chip->ecc.steps; i++) {
1485 pos = eccsize + i * (eccsize + chunk);
1486 if (mtd->writesize > 512)
1487 chip->cmdfunc(mtd, NAND_CMD_RNDOUT, pos, -1);
1489 chip->cmdfunc(mtd, NAND_CMD_READ0, pos, page);
1492 toread = min_t(int, length, chunk);
1493 chip->read_buf(mtd, bufpoi, toread);
1498 chip->read_buf(mtd, bufpoi, length);
1504 * nand_write_oob_std - [REPLACABLE] the most common OOB data write function
1505 * @mtd: mtd info structure
1506 * @chip: nand chip info structure
1507 * @page: page number to write
1509 static int nand_write_oob_std(struct mtd_info *mtd, struct nand_chip *chip,
1513 const uint8_t *buf = chip->oob_poi;
1514 int length = mtd->oobsize;
1516 chip->cmdfunc(mtd, NAND_CMD_SEQIN, mtd->writesize, page);
1517 chip->write_buf(mtd, buf, length);
1518 /* Send command to program the OOB data */
1519 chip->cmdfunc(mtd, NAND_CMD_PAGEPROG, -1, -1);
1521 status = chip->waitfunc(mtd, chip);
1523 return status & NAND_STATUS_FAIL ? -EIO : 0;
1527 * nand_write_oob_syndrome - [REPLACABLE] OOB data write function for HW ECC
1528 * with syndrome - only for large page flash !
1529 * @mtd: mtd info structure
1530 * @chip: nand chip info structure
1531 * @page: page number to write
1533 static int nand_write_oob_syndrome(struct mtd_info *mtd,
1534 struct nand_chip *chip, int page)
1536 int chunk = chip->ecc.bytes + chip->ecc.prepad + chip->ecc.postpad;
1537 int eccsize = chip->ecc.size, length = mtd->oobsize;
1538 int i, len, pos, status = 0, sndcmd = 0, steps = chip->ecc.steps;
1539 const uint8_t *bufpoi = chip->oob_poi;
1542 * data-ecc-data-ecc ... ecc-oob
1544 * data-pad-ecc-pad-data-pad .... ecc-pad-oob
1546 if (!chip->ecc.prepad && !chip->ecc.postpad) {
1547 pos = steps * (eccsize + chunk);
1552 chip->cmdfunc(mtd, NAND_CMD_SEQIN, pos, page);
1553 for (i = 0; i < steps; i++) {
1555 if (mtd->writesize <= 512) {
1556 uint32_t fill = 0xFFFFFFFF;
1560 int num = min_t(int, len, 4);
1561 chip->write_buf(mtd, (uint8_t *)&fill,
1566 pos = eccsize + i * (eccsize + chunk);
1567 chip->cmdfunc(mtd, NAND_CMD_RNDIN, pos, -1);
1571 len = min_t(int, length, chunk);
1572 chip->write_buf(mtd, bufpoi, len);
1577 chip->write_buf(mtd, bufpoi, length);
1579 chip->cmdfunc(mtd, NAND_CMD_PAGEPROG, -1, -1);
1580 status = chip->waitfunc(mtd, chip);
1582 return status & NAND_STATUS_FAIL ? -EIO : 0;
1586 * nand_do_read_oob - [Intern] NAND read out-of-band
1587 * @mtd: MTD device structure
1588 * @from: offset to read from
1589 * @ops: oob operations description structure
1591 * NAND read out-of-band data from the spare area
1593 static int nand_do_read_oob(struct mtd_info *mtd, loff_t from,
1594 struct mtd_oob_ops *ops)
1596 int page, realpage, chipnr, sndcmd = 1;
1597 struct nand_chip *chip = mtd->priv;
1598 int blkcheck = (1 << (chip->phys_erase_shift - chip->page_shift)) - 1;
1599 int readlen = ops->ooblen;
1601 uint8_t *buf = ops->oobbuf;
1603 MTDDEBUG (MTD_DEBUG_LEVEL3, "nand_read_oob: from = 0x%08Lx, len = %i\n",
1604 (unsigned long long)from, readlen);
1606 if (ops->mode == MTD_OOB_AUTO)
1607 len = chip->ecc.layout->oobavail;
1611 if (unlikely(ops->ooboffs >= len)) {
1612 MTDDEBUG (MTD_DEBUG_LEVEL0, "nand_read_oob: "
1613 "Attempt to start read outside oob\n");
1617 /* Do not allow reads past end of device */
1618 if (unlikely(from >= mtd->size ||
1619 ops->ooboffs + readlen > ((mtd->size >> chip->page_shift) -
1620 (from >> chip->page_shift)) * len)) {
1621 MTDDEBUG (MTD_DEBUG_LEVEL0, "nand_read_oob: "
1622 "Attempt read beyond end of device\n");
1626 chipnr = (int)(from >> chip->chip_shift);
1627 chip->select_chip(mtd, chipnr);
1629 /* Shift to get page */
1630 realpage = (int)(from >> chip->page_shift);
1631 page = realpage & chip->pagemask;
1634 sndcmd = chip->ecc.read_oob(mtd, chip, page, sndcmd);
1636 len = min(len, readlen);
1637 buf = nand_transfer_oob(chip, buf, ops, len);
1639 if (!(chip->options & NAND_NO_READRDY)) {
1641 * Apply delay or wait for ready/busy pin. Do this
1642 * before the AUTOINCR check, so no problems arise if a
1643 * chip which does auto increment is marked as
1644 * NOAUTOINCR by the board driver.
1646 if (!chip->dev_ready)
1647 udelay(chip->chip_delay);
1649 nand_wait_ready(mtd);
1656 /* Increment page address */
1659 page = realpage & chip->pagemask;
1660 /* Check, if we cross a chip boundary */
1663 chip->select_chip(mtd, -1);
1664 chip->select_chip(mtd, chipnr);
1667 /* Check, if the chip supports auto page increment
1668 * or if we have hit a block boundary.
1670 if (!NAND_CANAUTOINCR(chip) || !(page & blkcheck))
1674 ops->oobretlen = ops->ooblen;
1679 * nand_read_oob - [MTD Interface] NAND read data and/or out-of-band
1680 * @mtd: MTD device structure
1681 * @from: offset to read from
1682 * @ops: oob operation description structure
1684 * NAND read data and/or out-of-band data
1686 static int nand_read_oob(struct mtd_info *mtd, loff_t from,
1687 struct mtd_oob_ops *ops)
1689 struct nand_chip *chip = mtd->priv;
1690 int ret = -ENOTSUPP;
1694 /* Do not allow reads past end of device */
1695 if (ops->datbuf && (from + ops->len) > mtd->size) {
1696 MTDDEBUG (MTD_DEBUG_LEVEL0, "nand_read_oob: "
1697 "Attempt read beyond end of device\n");
1701 nand_get_device(chip, mtd, FL_READING);
1714 ret = nand_do_read_oob(mtd, from, ops);
1716 ret = nand_do_read_ops(mtd, from, ops);
1719 nand_release_device(mtd);
1725 * nand_write_page_raw - [Intern] raw page write function
1726 * @mtd: mtd info structure
1727 * @chip: nand chip info structure
1730 * Not for syndrome calculating ecc controllers, which use a special oob layout
1732 static void nand_write_page_raw(struct mtd_info *mtd, struct nand_chip *chip,
1735 chip->write_buf(mtd, buf, mtd->writesize);
1736 chip->write_buf(mtd, chip->oob_poi, mtd->oobsize);
1740 * nand_write_page_raw_syndrome - [Intern] raw page write function
1741 * @mtd: mtd info structure
1742 * @chip: nand chip info structure
1745 * We need a special oob layout and handling even when ECC isn't checked.
1747 static void nand_write_page_raw_syndrome(struct mtd_info *mtd, struct nand_chip *chip,
1750 int eccsize = chip->ecc.size;
1751 int eccbytes = chip->ecc.bytes;
1752 uint8_t *oob = chip->oob_poi;
1755 for (steps = chip->ecc.steps; steps > 0; steps--) {
1756 chip->write_buf(mtd, buf, eccsize);
1759 if (chip->ecc.prepad) {
1760 chip->write_buf(mtd, oob, chip->ecc.prepad);
1761 oob += chip->ecc.prepad;
1764 chip->read_buf(mtd, oob, eccbytes);
1767 if (chip->ecc.postpad) {
1768 chip->write_buf(mtd, oob, chip->ecc.postpad);
1769 oob += chip->ecc.postpad;
1773 size = mtd->oobsize - (oob - chip->oob_poi);
1775 chip->write_buf(mtd, oob, size);
1778 * nand_write_page_swecc - [REPLACABLE] software ecc based page write function
1779 * @mtd: mtd info structure
1780 * @chip: nand chip info structure
1783 static void nand_write_page_swecc(struct mtd_info *mtd, struct nand_chip *chip,
1786 int i, eccsize = chip->ecc.size;
1787 int eccbytes = chip->ecc.bytes;
1788 int eccsteps = chip->ecc.steps;
1789 uint8_t *ecc_calc = chip->buffers->ecccalc;
1790 const uint8_t *p = buf;
1791 uint32_t *eccpos = chip->ecc.layout->eccpos;
1793 /* Software ecc calculation */
1794 for (i = 0; eccsteps; eccsteps--, i += eccbytes, p += eccsize)
1795 chip->ecc.calculate(mtd, p, &ecc_calc[i]);
1797 for (i = 0; i < chip->ecc.total; i++)
1798 chip->oob_poi[eccpos[i]] = ecc_calc[i];
1800 chip->ecc.write_page_raw(mtd, chip, buf);
1804 * nand_write_page_hwecc - [REPLACABLE] hardware ecc based page write function
1805 * @mtd: mtd info structure
1806 * @chip: nand chip info structure
1809 static void nand_write_page_hwecc(struct mtd_info *mtd, struct nand_chip *chip,
1812 int i, eccsize = chip->ecc.size;
1813 int eccbytes = chip->ecc.bytes;
1814 int eccsteps = chip->ecc.steps;
1815 uint8_t *ecc_calc = chip->buffers->ecccalc;
1816 const uint8_t *p = buf;
1817 uint32_t *eccpos = chip->ecc.layout->eccpos;
1819 for (i = 0; eccsteps; eccsteps--, i += eccbytes, p += eccsize) {
1820 chip->ecc.hwctl(mtd, NAND_ECC_WRITE);
1821 chip->write_buf(mtd, p, eccsize);
1822 chip->ecc.calculate(mtd, p, &ecc_calc[i]);
1825 for (i = 0; i < chip->ecc.total; i++)
1826 chip->oob_poi[eccpos[i]] = ecc_calc[i];
1828 chip->write_buf(mtd, chip->oob_poi, mtd->oobsize);
1832 * nand_write_page_syndrome - [REPLACABLE] hardware ecc syndrom based page write
1833 * @mtd: mtd info structure
1834 * @chip: nand chip info structure
1837 * The hw generator calculates the error syndrome automatically. Therefor
1838 * we need a special oob layout and handling.
1840 static void nand_write_page_syndrome(struct mtd_info *mtd,
1841 struct nand_chip *chip, const uint8_t *buf)
1843 int i, eccsize = chip->ecc.size;
1844 int eccbytes = chip->ecc.bytes;
1845 int eccsteps = chip->ecc.steps;
1846 const uint8_t *p = buf;
1847 uint8_t *oob = chip->oob_poi;
1849 for (i = 0; eccsteps; eccsteps--, i += eccbytes, p += eccsize) {
1851 chip->ecc.hwctl(mtd, NAND_ECC_WRITE);
1852 chip->write_buf(mtd, p, eccsize);
1854 if (chip->ecc.prepad) {
1855 chip->write_buf(mtd, oob, chip->ecc.prepad);
1856 oob += chip->ecc.prepad;
1859 chip->ecc.calculate(mtd, p, oob);
1860 chip->write_buf(mtd, oob, eccbytes);
1863 if (chip->ecc.postpad) {
1864 chip->write_buf(mtd, oob, chip->ecc.postpad);
1865 oob += chip->ecc.postpad;
1869 /* Calculate remaining oob bytes */
1870 i = mtd->oobsize - (oob - chip->oob_poi);
1872 chip->write_buf(mtd, oob, i);
1876 * nand_write_page - [REPLACEABLE] write one page
1877 * @mtd: MTD device structure
1878 * @chip: NAND chip descriptor
1879 * @buf: the data to write
1880 * @page: page number to write
1881 * @cached: cached programming
1882 * @raw: use _raw version of write_page
1884 static int nand_write_page(struct mtd_info *mtd, struct nand_chip *chip,
1885 const uint8_t *buf, int page, int cached, int raw)
1889 chip->cmdfunc(mtd, NAND_CMD_SEQIN, 0x00, page);
1892 chip->ecc.write_page_raw(mtd, chip, buf);
1894 chip->ecc.write_page(mtd, chip, buf);
1897 * Cached progamming disabled for now, Not sure if its worth the
1898 * trouble. The speed gain is not very impressive. (2.3->2.6Mib/s)
1902 if (!cached || !(chip->options & NAND_CACHEPRG)) {
1904 chip->cmdfunc(mtd, NAND_CMD_PAGEPROG, -1, -1);
1905 status = chip->waitfunc(mtd, chip);
1907 * See if operation failed and additional status checks are
1910 if ((status & NAND_STATUS_FAIL) && (chip->errstat))
1911 status = chip->errstat(mtd, chip, FL_WRITING, status,
1914 if (status & NAND_STATUS_FAIL)
1917 chip->cmdfunc(mtd, NAND_CMD_CACHEDPROG, -1, -1);
1918 status = chip->waitfunc(mtd, chip);
1921 #ifdef CONFIG_MTD_NAND_VERIFY_WRITE
1922 /* Send command to read back the data */
1923 chip->cmdfunc(mtd, NAND_CMD_READ0, 0, page);
1925 if (chip->verify_buf(mtd, buf, mtd->writesize))
1932 * nand_fill_oob - [Internal] Transfer client buffer to oob
1933 * @chip: nand chip structure
1934 * @oob: oob data buffer
1935 * @ops: oob ops structure
1937 static uint8_t *nand_fill_oob(struct nand_chip *chip, uint8_t *oob,
1938 struct mtd_oob_ops *ops)
1940 size_t len = ops->ooblen;
1946 memcpy(chip->oob_poi + ops->ooboffs, oob, len);
1949 case MTD_OOB_AUTO: {
1950 struct nand_oobfree *free = chip->ecc.layout->oobfree;
1951 uint32_t boffs = 0, woffs = ops->ooboffs;
1954 for(; free->length && len; free++, len -= bytes) {
1955 /* Write request not from offset 0 ? */
1956 if (unlikely(woffs)) {
1957 if (woffs >= free->length) {
1958 woffs -= free->length;
1961 boffs = free->offset + woffs;
1962 bytes = min_t(size_t, len,
1963 (free->length - woffs));
1966 bytes = min_t(size_t, len, free->length);
1967 boffs = free->offset;
1969 memcpy(chip->oob_poi + boffs, oob, bytes);
1980 #define NOTALIGNED(x) (x & (chip->subpagesize - 1)) != 0
1983 * nand_do_write_ops - [Internal] NAND write with ECC
1984 * @mtd: MTD device structure
1985 * @to: offset to write to
1986 * @ops: oob operations description structure
1988 * NAND write with ECC
1990 static int nand_do_write_ops(struct mtd_info *mtd, loff_t to,
1991 struct mtd_oob_ops *ops)
1993 int chipnr, realpage, page, blockmask, column;
1994 struct nand_chip *chip = mtd->priv;
1995 uint32_t writelen = ops->len;
1996 uint8_t *oob = ops->oobbuf;
1997 uint8_t *buf = ops->datbuf;
2004 column = to & (mtd->writesize - 1);
2005 subpage = column || (writelen & (mtd->writesize - 1));
2010 chipnr = (int)(to >> chip->chip_shift);
2011 chip->select_chip(mtd, chipnr);
2013 /* Check, if it is write protected */
2014 if (nand_check_wp(mtd)) {
2015 printk (KERN_NOTICE "nand_do_write_ops: Device is write protected\n");
2019 realpage = (int)(to >> chip->page_shift);
2020 page = realpage & chip->pagemask;
2021 blockmask = (1 << (chip->phys_erase_shift - chip->page_shift)) - 1;
2023 /* Invalidate the page cache, when we write to the cached page */
2024 if (to <= (chip->pagebuf << chip->page_shift) &&
2025 (chip->pagebuf << chip->page_shift) < (to + ops->len))
2028 /* If we're not given explicit OOB data, let it be 0xFF */
2030 memset(chip->oob_poi, 0xff, mtd->oobsize);
2033 int bytes = mtd->writesize;
2034 int cached = writelen > bytes && page != blockmask;
2035 uint8_t *wbuf = buf;
2037 /* Partial page write ? */
2038 if (unlikely(column || writelen < (mtd->writesize - 1))) {
2040 bytes = min_t(int, bytes - column, (int) writelen);
2042 memset(chip->buffers->databuf, 0xff, mtd->writesize);
2043 memcpy(&chip->buffers->databuf[column], buf, bytes);
2044 wbuf = chip->buffers->databuf;
2048 oob = nand_fill_oob(chip, oob, ops);
2050 ret = chip->write_page(mtd, chip, wbuf, page, cached,
2051 (ops->mode == MTD_OOB_RAW));
2063 page = realpage & chip->pagemask;
2064 /* Check, if we cross a chip boundary */
2067 chip->select_chip(mtd, -1);
2068 chip->select_chip(mtd, chipnr);
2072 ops->retlen = ops->len - writelen;
2074 ops->oobretlen = ops->ooblen;
2079 * nand_write - [MTD Interface] NAND write with ECC
2080 * @mtd: MTD device structure
2081 * @to: offset to write to
2082 * @len: number of bytes to write
2083 * @retlen: pointer to variable to store the number of written bytes
2084 * @buf: the data to write
2086 * NAND write with ECC
2088 static int nand_write(struct mtd_info *mtd, loff_t to, size_t len,
2089 size_t *retlen, const uint8_t *buf)
2091 struct nand_chip *chip = mtd->priv;
2094 /* Do not allow reads past end of device */
2095 if ((to + len) > mtd->size)
2100 nand_get_device(chip, mtd, FL_WRITING);
2102 chip->ops.len = len;
2103 chip->ops.datbuf = (uint8_t *)buf;
2104 chip->ops.oobbuf = NULL;
2106 ret = nand_do_write_ops(mtd, to, &chip->ops);
2108 *retlen = chip->ops.retlen;
2110 nand_release_device(mtd);
2116 * nand_do_write_oob - [MTD Interface] NAND write out-of-band
2117 * @mtd: MTD device structure
2118 * @to: offset to write to
2119 * @ops: oob operation description structure
2121 * NAND write out-of-band
2123 static int nand_do_write_oob(struct mtd_info *mtd, loff_t to,
2124 struct mtd_oob_ops *ops)
2126 int chipnr, page, status, len;
2127 struct nand_chip *chip = mtd->priv;
2129 MTDDEBUG (MTD_DEBUG_LEVEL3, "nand_write_oob: to = 0x%08x, len = %i\n",
2130 (unsigned int)to, (int)ops->ooblen);
2132 if (ops->mode == MTD_OOB_AUTO)
2133 len = chip->ecc.layout->oobavail;
2137 /* Do not allow write past end of page */
2138 if ((ops->ooboffs + ops->ooblen) > len) {
2139 MTDDEBUG (MTD_DEBUG_LEVEL0, "nand_write_oob: "
2140 "Attempt to write past end of page\n");
2144 if (unlikely(ops->ooboffs >= len)) {
2145 MTDDEBUG (MTD_DEBUG_LEVEL0, "nand_read_oob: "
2146 "Attempt to start write outside oob\n");
2150 /* Do not allow reads past end of device */
2151 if (unlikely(to >= mtd->size ||
2152 ops->ooboffs + ops->ooblen >
2153 ((mtd->size >> chip->page_shift) -
2154 (to >> chip->page_shift)) * len)) {
2155 MTDDEBUG (MTD_DEBUG_LEVEL0, "nand_read_oob: "
2156 "Attempt write beyond end of device\n");
2160 chipnr = (int)(to >> chip->chip_shift);
2161 chip->select_chip(mtd, chipnr);
2163 /* Shift to get page */
2164 page = (int)(to >> chip->page_shift);
2167 * Reset the chip. Some chips (like the Toshiba TC5832DC found in one
2168 * of my DiskOnChip 2000 test units) will clear the whole data page too
2169 * if we don't do this. I have no clue why, but I seem to have 'fixed'
2170 * it in the doc2000 driver in August 1999. dwmw2.
2172 chip->cmdfunc(mtd, NAND_CMD_RESET, -1, -1);
2174 /* Check, if it is write protected */
2175 if (nand_check_wp(mtd))
2178 /* Invalidate the page cache, if we write to the cached page */
2179 if (page == chip->pagebuf)
2182 memset(chip->oob_poi, 0xff, mtd->oobsize);
2183 nand_fill_oob(chip, ops->oobbuf, ops);
2184 status = chip->ecc.write_oob(mtd, chip, page & chip->pagemask);
2185 memset(chip->oob_poi, 0xff, mtd->oobsize);
2190 ops->oobretlen = ops->ooblen;
2196 * nand_write_oob - [MTD Interface] NAND write data and/or out-of-band
2197 * @mtd: MTD device structure
2198 * @to: offset to write to
2199 * @ops: oob operation description structure
2201 static int nand_write_oob(struct mtd_info *mtd, loff_t to,
2202 struct mtd_oob_ops *ops)
2204 struct nand_chip *chip = mtd->priv;
2205 int ret = -ENOTSUPP;
2209 /* Do not allow writes past end of device */
2210 if (ops->datbuf && (to + ops->len) > mtd->size) {
2211 MTDDEBUG (MTD_DEBUG_LEVEL0, "nand_read_oob: "
2212 "Attempt read beyond end of device\n");
2216 nand_get_device(chip, mtd, FL_WRITING);
2229 ret = nand_do_write_oob(mtd, to, ops);
2231 ret = nand_do_write_ops(mtd, to, ops);
2234 nand_release_device(mtd);
2239 * single_erease_cmd - [GENERIC] NAND standard block erase command function
2240 * @mtd: MTD device structure
2241 * @page: the page address of the block which will be erased
2243 * Standard erase command for NAND chips
2245 static void single_erase_cmd(struct mtd_info *mtd, int page)
2247 struct nand_chip *chip = mtd->priv;
2248 /* Send commands to erase a block */
2249 chip->cmdfunc(mtd, NAND_CMD_ERASE1, -1, page);
2250 chip->cmdfunc(mtd, NAND_CMD_ERASE2, -1, -1);
2254 * multi_erease_cmd - [GENERIC] AND specific block erase command function
2255 * @mtd: MTD device structure
2256 * @page: the page address of the block which will be erased
2258 * AND multi block erase command function
2259 * Erase 4 consecutive blocks
2261 static void multi_erase_cmd(struct mtd_info *mtd, int page)
2263 struct nand_chip *chip = mtd->priv;
2264 /* Send commands to erase a block */
2265 chip->cmdfunc(mtd, NAND_CMD_ERASE1, -1, page++);
2266 chip->cmdfunc(mtd, NAND_CMD_ERASE1, -1, page++);
2267 chip->cmdfunc(mtd, NAND_CMD_ERASE1, -1, page++);
2268 chip->cmdfunc(mtd, NAND_CMD_ERASE1, -1, page);
2269 chip->cmdfunc(mtd, NAND_CMD_ERASE2, -1, -1);
2273 * nand_erase - [MTD Interface] erase block(s)
2274 * @mtd: MTD device structure
2275 * @instr: erase instruction
2277 * Erase one ore more blocks
2279 static int nand_erase(struct mtd_info *mtd, struct erase_info *instr)
2281 return nand_erase_nand(mtd, instr, 0);
2284 #define BBT_PAGE_MASK 0xffffff3f
2286 * nand_erase_nand - [Internal] erase block(s)
2287 * @mtd: MTD device structure
2288 * @instr: erase instruction
2289 * @allowbbt: allow erasing the bbt area
2291 * Erase one ore more blocks
2293 int nand_erase_nand(struct mtd_info *mtd, struct erase_info *instr,
2296 int page, status, pages_per_block, ret, chipnr;
2297 struct nand_chip *chip = mtd->priv;
2298 loff_t rewrite_bbt[CONFIG_SYS_NAND_MAX_CHIPS] = {0};
2299 unsigned int bbt_masked_page = 0xffffffff;
2302 MTDDEBUG(MTD_DEBUG_LEVEL3, "nand_erase: start = 0x%012llx, "
2303 "len = %llu\n", (unsigned long long) instr->addr,
2304 (unsigned long long) instr->len);
2306 /* Start address must align on block boundary */
2307 if (instr->addr & ((1 << chip->phys_erase_shift) - 1)) {
2308 MTDDEBUG (MTD_DEBUG_LEVEL0, "nand_erase: Unaligned address\n");
2312 /* Length must align on block boundary */
2313 if (instr->len & ((1 << chip->phys_erase_shift) - 1)) {
2314 MTDDEBUG (MTD_DEBUG_LEVEL0,
2315 "nand_erase: Length not block aligned\n");
2319 /* Do not allow erase past end of device */
2320 if ((instr->len + instr->addr) > mtd->size) {
2321 MTDDEBUG (MTD_DEBUG_LEVEL0,
2322 "nand_erase: Erase past end of device\n");
2326 instr->fail_addr = 0xffffffff;
2328 /* Grab the lock and see if the device is available */
2329 nand_get_device(chip, mtd, FL_ERASING);
2331 /* Shift to get first page */
2332 page = (int)(instr->addr >> chip->page_shift);
2333 chipnr = (int)(instr->addr >> chip->chip_shift);
2335 /* Calculate pages in each block */
2336 pages_per_block = 1 << (chip->phys_erase_shift - chip->page_shift);
2338 /* Select the NAND device */
2339 chip->select_chip(mtd, chipnr);
2341 /* Check, if it is write protected */
2342 if (nand_check_wp(mtd)) {
2343 MTDDEBUG (MTD_DEBUG_LEVEL0,
2344 "nand_erase: Device is write protected!!!\n");
2345 instr->state = MTD_ERASE_FAILED;
2350 * If BBT requires refresh, set the BBT page mask to see if the BBT
2351 * should be rewritten. Otherwise the mask is set to 0xffffffff which
2352 * can not be matched. This is also done when the bbt is actually
2353 * erased to avoid recusrsive updates
2355 if (chip->options & BBT_AUTO_REFRESH && !allowbbt)
2356 bbt_masked_page = chip->bbt_td->pages[chipnr] & BBT_PAGE_MASK;
2358 /* Loop through the pages */
2361 instr->state = MTD_ERASING;
2365 * heck if we have a bad block, we do not erase bad blocks !
2367 if (nand_block_checkbad(mtd, ((loff_t) page) <<
2368 chip->page_shift, 0, allowbbt)) {
2369 printk(KERN_WARNING "nand_erase: attempt to erase a "
2370 "bad block at page 0x%08x\n", page);
2371 instr->state = MTD_ERASE_FAILED;
2376 * Invalidate the page cache, if we erase the block which
2377 * contains the current cached page
2379 if (page <= chip->pagebuf && chip->pagebuf <
2380 (page + pages_per_block))
2383 chip->erase_cmd(mtd, page & chip->pagemask);
2385 status = chip->waitfunc(mtd, chip);
2388 * See if operation failed and additional status checks are
2391 if ((status & NAND_STATUS_FAIL) && (chip->errstat))
2392 status = chip->errstat(mtd, chip, FL_ERASING,
2395 /* See if block erase succeeded */
2396 if (status & NAND_STATUS_FAIL) {
2397 MTDDEBUG (MTD_DEBUG_LEVEL0, "nand_erase: "
2398 "Failed erase, page 0x%08x\n", page);
2399 instr->state = MTD_ERASE_FAILED;
2400 instr->fail_addr = ((loff_t)page << chip->page_shift);
2405 * If BBT requires refresh, set the BBT rewrite flag to the
2408 if (bbt_masked_page != 0xffffffff &&
2409 (page & BBT_PAGE_MASK) == bbt_masked_page)
2410 rewrite_bbt[chipnr] =
2411 ((loff_t)page << chip->page_shift);
2413 /* Increment page address and decrement length */
2414 len -= (1 << chip->phys_erase_shift);
2415 page += pages_per_block;
2417 /* Check, if we cross a chip boundary */
2418 if (len && !(page & chip->pagemask)) {
2420 chip->select_chip(mtd, -1);
2421 chip->select_chip(mtd, chipnr);
2424 * If BBT requires refresh and BBT-PERCHIP, set the BBT
2425 * page mask to see if this BBT should be rewritten
2427 if (bbt_masked_page != 0xffffffff &&
2428 (chip->bbt_td->options & NAND_BBT_PERCHIP))
2429 bbt_masked_page = chip->bbt_td->pages[chipnr] &
2433 instr->state = MTD_ERASE_DONE;
2437 ret = instr->state == MTD_ERASE_DONE ? 0 : -EIO;
2439 /* Deselect and wake up anyone waiting on the device */
2440 nand_release_device(mtd);
2442 /* Do call back function */
2444 mtd_erase_callback(instr);
2447 * If BBT requires refresh and erase was successful, rewrite any
2448 * selected bad block tables
2450 if (bbt_masked_page == 0xffffffff || ret)
2453 for (chipnr = 0; chipnr < chip->numchips; chipnr++) {
2454 if (!rewrite_bbt[chipnr])
2456 /* update the BBT for chip */
2457 MTDDEBUG (MTD_DEBUG_LEVEL0, "nand_erase_nand: nand_update_bbt "
2458 "(%d:0x%0llx 0x%0x)\n", chipnr, rewrite_bbt[chipnr],
2459 chip->bbt_td->pages[chipnr]);
2460 nand_update_bbt(mtd, rewrite_bbt[chipnr]);
2463 /* Return more or less happy */
2468 * nand_sync - [MTD Interface] sync
2469 * @mtd: MTD device structure
2471 * Sync is actually a wait for chip ready function
2473 static void nand_sync(struct mtd_info *mtd)
2475 struct nand_chip *chip = mtd->priv;
2477 MTDDEBUG (MTD_DEBUG_LEVEL3, "nand_sync: called\n");
2479 /* Grab the lock and see if the device is available */
2480 nand_get_device(chip, mtd, FL_SYNCING);
2481 /* Release it and go back */
2482 nand_release_device(mtd);
2486 * nand_block_isbad - [MTD Interface] Check if block at offset is bad
2487 * @mtd: MTD device structure
2488 * @offs: offset relative to mtd start
2490 static int nand_block_isbad(struct mtd_info *mtd, loff_t offs)
2492 /* Check for invalid offset */
2493 if (offs > mtd->size)
2496 return nand_block_checkbad(mtd, offs, 1, 0);
2500 * nand_block_markbad - [MTD Interface] Mark block at the given offset as bad
2501 * @mtd: MTD device structure
2502 * @ofs: offset relative to mtd start
2504 static int nand_block_markbad(struct mtd_info *mtd, loff_t ofs)
2506 struct nand_chip *chip = mtd->priv;
2509 if ((ret = nand_block_isbad(mtd, ofs))) {
2510 /* If it was bad already, return success and do nothing. */
2516 return chip->block_markbad(mtd, ofs);
2520 * nand_suspend - [MTD Interface] Suspend the NAND flash
2521 * @mtd: MTD device structure
2523 static int nand_suspend(struct mtd_info *mtd)
2525 struct nand_chip *chip = mtd->priv;
2527 return nand_get_device(chip, mtd, FL_PM_SUSPENDED);
2531 * nand_resume - [MTD Interface] Resume the NAND flash
2532 * @mtd: MTD device structure
2534 static void nand_resume(struct mtd_info *mtd)
2536 struct nand_chip *chip = mtd->priv;
2538 if (chip->state == FL_PM_SUSPENDED)
2539 nand_release_device(mtd);
2541 printk(KERN_ERR "nand_resume() called for a chip which is not "
2542 "in suspended state\n");
2546 * Set default functions
2548 static void nand_set_defaults(struct nand_chip *chip, int busw)
2550 /* check for proper chip_delay setup, set 20us if not */
2551 if (!chip->chip_delay)
2552 chip->chip_delay = 20;
2554 /* check, if a user supplied command function given */
2555 if (chip->cmdfunc == NULL)
2556 chip->cmdfunc = nand_command;
2558 /* check, if a user supplied wait function given */
2559 if (chip->waitfunc == NULL)
2560 chip->waitfunc = nand_wait;
2562 if (!chip->select_chip)
2563 chip->select_chip = nand_select_chip;
2564 if (!chip->read_byte)
2565 chip->read_byte = busw ? nand_read_byte16 : nand_read_byte;
2566 if (!chip->read_word)
2567 chip->read_word = nand_read_word;
2568 if (!chip->block_bad)
2569 chip->block_bad = nand_block_bad;
2570 if (!chip->block_markbad)
2571 chip->block_markbad = nand_default_block_markbad;
2572 if (!chip->write_buf)
2573 chip->write_buf = busw ? nand_write_buf16 : nand_write_buf;
2574 if (!chip->read_buf)
2575 chip->read_buf = busw ? nand_read_buf16 : nand_read_buf;
2576 if (!chip->verify_buf)
2577 chip->verify_buf = busw ? nand_verify_buf16 : nand_verify_buf;
2578 if (!chip->scan_bbt)
2579 chip->scan_bbt = nand_default_bbt;
2581 if (!chip->controller) {
2582 chip->controller = &chip->hwcontrol;
2584 /* XXX U-BOOT XXX */
2586 spin_lock_init(&chip->controller->lock);
2587 init_waitqueue_head(&chip->controller->wq);
2594 * Get the flash and manufacturer id and lookup if the type is supported
2596 static struct nand_flash_dev *nand_get_flash_type(struct mtd_info *mtd,
2597 struct nand_chip *chip,
2598 int busw, int *maf_id)
2600 struct nand_flash_dev *type = NULL;
2601 int i, dev_id, maf_idx;
2602 int tmp_id, tmp_manf;
2604 /* Select the device */
2605 chip->select_chip(mtd, 0);
2608 * Reset the chip, required by some chips (e.g. Micron MT29FxGxxxxx)
2611 chip->cmdfunc(mtd, NAND_CMD_RESET, -1, -1);
2613 /* Send the command for reading device ID */
2614 chip->cmdfunc(mtd, NAND_CMD_READID, 0x00, -1);
2616 /* Read manufacturer and device IDs */
2617 *maf_id = chip->read_byte(mtd);
2618 dev_id = chip->read_byte(mtd);
2620 /* Try again to make sure, as some systems the bus-hold or other
2621 * interface concerns can cause random data which looks like a
2622 * possibly credible NAND flash to appear. If the two results do
2623 * not match, ignore the device completely.
2626 chip->cmdfunc(mtd, NAND_CMD_READID, 0x00, -1);
2628 /* Read manufacturer and device IDs */
2630 tmp_manf = chip->read_byte(mtd);
2631 tmp_id = chip->read_byte(mtd);
2633 if (tmp_manf != *maf_id || tmp_id != dev_id) {
2634 printk(KERN_INFO "%s: second ID read did not match "
2635 "%02x,%02x against %02x,%02x\n", __func__,
2636 *maf_id, dev_id, tmp_manf, tmp_id);
2637 return ERR_PTR(-ENODEV);
2640 /* Lookup the flash id */
2641 for (i = 0; nand_flash_ids[i].name != NULL; i++) {
2642 if (dev_id == nand_flash_ids[i].id) {
2643 type = &nand_flash_ids[i];
2649 /* supress warning if there is no nand */
2650 if (*maf_id != 0x00 && *maf_id != 0xff &&
2651 dev_id != 0x00 && dev_id != 0xff)
2652 printk(KERN_INFO "%s: unknown NAND device: "
2653 "Manufacturer ID: 0x%02x, Chip ID: 0x%02x\n",
2654 __func__, *maf_id, dev_id);
2655 return ERR_PTR(-ENODEV);
2659 mtd->name = type->name;
2661 chip->chipsize = (uint64_t)type->chipsize << 20;
2663 /* Newer devices have all the information in additional id bytes */
2664 if (!type->pagesize) {
2666 /* The 3rd id byte holds MLC / multichip data */
2667 chip->cellinfo = chip->read_byte(mtd);
2668 /* The 4th id byte is the important one */
2669 extid = chip->read_byte(mtd);
2671 mtd->writesize = 1024 << (extid & 0x3);
2674 mtd->oobsize = (8 << (extid & 0x01)) * (mtd->writesize >> 9);
2676 /* Calc blocksize. Blocksize is multiples of 64KiB */
2677 mtd->erasesize = (64 * 1024) << (extid & 0x03);
2679 /* Get buswidth information */
2680 busw = (extid & 0x01) ? NAND_BUSWIDTH_16 : 0;
2684 * Old devices have chip data hardcoded in the device id table
2686 mtd->erasesize = type->erasesize;
2687 mtd->writesize = type->pagesize;
2688 mtd->oobsize = mtd->writesize / 32;
2689 busw = type->options & NAND_BUSWIDTH_16;
2692 /* Try to identify manufacturer */
2693 for (maf_idx = 0; nand_manuf_ids[maf_idx].id != 0x0; maf_idx++) {
2694 if (nand_manuf_ids[maf_idx].id == *maf_id)
2699 * Check, if buswidth is correct. Hardware drivers should set
2702 if (busw != (chip->options & NAND_BUSWIDTH_16)) {
2703 printk(KERN_INFO "NAND device: Manufacturer ID:"
2704 " 0x%02x, Chip ID: 0x%02x (%s %s)\n", *maf_id,
2705 dev_id, nand_manuf_ids[maf_idx].name, mtd->name);
2706 printk(KERN_WARNING "NAND bus width %d instead %d bit\n",
2707 (chip->options & NAND_BUSWIDTH_16) ? 16 : 8,
2709 return ERR_PTR(-EINVAL);
2712 /* Calculate the address shift from the page size */
2713 chip->page_shift = ffs(mtd->writesize) - 1;
2714 /* Convert chipsize to number of pages per chip -1. */
2715 chip->pagemask = (chip->chipsize >> chip->page_shift) - 1;
2717 chip->bbt_erase_shift = chip->phys_erase_shift =
2718 ffs(mtd->erasesize) - 1;
2719 if (chip->chipsize & 0xffffffff)
2720 chip->chip_shift = ffs((unsigned)chip->chipsize) - 1;
2722 chip->chip_shift = ffs((unsigned)(chip->chipsize >> 32)) + 31;
2724 /* Set the bad block position */
2725 chip->badblockpos = mtd->writesize > 512 ?
2726 NAND_LARGE_BADBLOCK_POS : NAND_SMALL_BADBLOCK_POS;
2728 /* Get chip options, preserve non chip based options */
2729 chip->options &= ~NAND_CHIPOPTIONS_MSK;
2730 chip->options |= type->options & NAND_CHIPOPTIONS_MSK;
2733 * Set chip as a default. Board drivers can override it, if necessary
2735 chip->options |= NAND_NO_AUTOINCR;
2737 /* Check if chip is a not a samsung device. Do not clear the
2738 * options for chips which are not having an extended id.
2740 if (*maf_id != NAND_MFR_SAMSUNG && !type->pagesize)
2741 chip->options &= ~NAND_SAMSUNG_LP_OPTIONS;
2743 /* Check for AND chips with 4 page planes */
2744 if (chip->options & NAND_4PAGE_ARRAY)
2745 chip->erase_cmd = multi_erase_cmd;
2747 chip->erase_cmd = single_erase_cmd;
2749 /* Do not replace user supplied command function ! */
2750 if (mtd->writesize > 512 && chip->cmdfunc == nand_command)
2751 chip->cmdfunc = nand_command_lp;
2753 MTDDEBUG (MTD_DEBUG_LEVEL0, "NAND device: Manufacturer ID:"
2754 " 0x%02x, Chip ID: 0x%02x (%s %s)\n", *maf_id, dev_id,
2755 nand_manuf_ids[maf_idx].name, type->name);
2761 * nand_scan_ident - [NAND Interface] Scan for the NAND device
2762 * @mtd: MTD device structure
2763 * @maxchips: Number of chips to scan for
2765 * This is the first phase of the normal nand_scan() function. It
2766 * reads the flash ID and sets up MTD fields accordingly.
2768 * The mtd->owner field must be set to the module of the caller.
2770 int nand_scan_ident(struct mtd_info *mtd, int maxchips)
2772 int i, busw, nand_maf_id;
2773 struct nand_chip *chip = mtd->priv;
2774 struct nand_flash_dev *type;
2776 /* Get buswidth to select the correct functions */
2777 busw = chip->options & NAND_BUSWIDTH_16;
2778 /* Set the default functions */
2779 nand_set_defaults(chip, busw);
2781 /* Read the flash type */
2782 type = nand_get_flash_type(mtd, chip, busw, &nand_maf_id);
2785 #ifndef CONFIG_SYS_NAND_QUIET_TEST
2786 printk(KERN_WARNING "No NAND device found!!!\n");
2788 chip->select_chip(mtd, -1);
2789 return PTR_ERR(type);
2792 /* Check for a chip array */
2793 for (i = 1; i < maxchips; i++) {
2794 chip->select_chip(mtd, i);
2795 /* See comment in nand_get_flash_type for reset */
2796 chip->cmdfunc(mtd, NAND_CMD_RESET, -1, -1);
2797 /* Send the command for reading device ID */
2798 chip->cmdfunc(mtd, NAND_CMD_READID, 0x00, -1);
2799 /* Read manufacturer and device IDs */
2800 if (nand_maf_id != chip->read_byte(mtd) ||
2801 type->id != chip->read_byte(mtd))
2806 printk(KERN_INFO "%d NAND chips detected\n", i);
2809 /* Store the number of chips and calc total size for mtd */
2811 mtd->size = i * chip->chipsize;
2818 * nand_scan_tail - [NAND Interface] Scan for the NAND device
2819 * @mtd: MTD device structure
2821 * This is the second phase of the normal nand_scan() function. It
2822 * fills out all the uninitialized function pointers with the defaults
2823 * and scans for a bad block table if appropriate.
2825 int nand_scan_tail(struct mtd_info *mtd)
2828 struct nand_chip *chip = mtd->priv;
2830 if (!(chip->options & NAND_OWN_BUFFERS))
2831 chip->buffers = kmalloc(sizeof(*chip->buffers), GFP_KERNEL);
2835 /* Set the internal oob buffer location, just after the page data */
2836 chip->oob_poi = chip->buffers->databuf + mtd->writesize;
2839 * If no default placement scheme is given, select an appropriate one
2841 if (!chip->ecc.layout) {
2842 switch (mtd->oobsize) {
2844 chip->ecc.layout = &nand_oob_8;
2847 chip->ecc.layout = &nand_oob_16;
2850 chip->ecc.layout = &nand_oob_64;
2853 chip->ecc.layout = &nand_oob_128;
2856 printk(KERN_WARNING "No oob scheme defined for "
2857 "oobsize %d\n", mtd->oobsize);
2861 if (!chip->write_page)
2862 chip->write_page = nand_write_page;
2865 * check ECC mode, default to software if 3byte/512byte hardware ECC is
2866 * selected and we have 256 byte pagesize fallback to software ECC
2869 switch (chip->ecc.mode) {
2870 case NAND_ECC_HW_OOB_FIRST:
2871 /* Similar to NAND_ECC_HW, but a separate read_page handle */
2872 if (!chip->ecc.calculate || !chip->ecc.correct ||
2874 printk(KERN_WARNING "No ECC functions supplied, "
2875 "Hardware ECC not possible\n");
2878 if (!chip->ecc.read_page)
2879 chip->ecc.read_page = nand_read_page_hwecc_oob_first;
2882 /* Use standard hwecc read page function ? */
2883 if (!chip->ecc.read_page)
2884 chip->ecc.read_page = nand_read_page_hwecc;
2885 if (!chip->ecc.write_page)
2886 chip->ecc.write_page = nand_write_page_hwecc;
2887 if (!chip->ecc.read_page_raw)
2888 chip->ecc.read_page_raw = nand_read_page_raw;
2889 if (!chip->ecc.write_page_raw)
2890 chip->ecc.write_page_raw = nand_write_page_raw;
2891 if (!chip->ecc.read_oob)
2892 chip->ecc.read_oob = nand_read_oob_std;
2893 if (!chip->ecc.write_oob)
2894 chip->ecc.write_oob = nand_write_oob_std;
2896 case NAND_ECC_HW_SYNDROME:
2897 if ((!chip->ecc.calculate || !chip->ecc.correct ||
2898 !chip->ecc.hwctl) &&
2899 (!chip->ecc.read_page ||
2900 chip->ecc.read_page == nand_read_page_hwecc ||
2901 !chip->ecc.write_page ||
2902 chip->ecc.write_page == nand_write_page_hwecc)) {
2903 printk(KERN_WARNING "No ECC functions supplied, "
2904 "Hardware ECC not possible\n");
2907 /* Use standard syndrome read/write page function ? */
2908 if (!chip->ecc.read_page)
2909 chip->ecc.read_page = nand_read_page_syndrome;
2910 if (!chip->ecc.write_page)
2911 chip->ecc.write_page = nand_write_page_syndrome;
2912 if (!chip->ecc.read_page_raw)
2913 chip->ecc.read_page_raw = nand_read_page_raw_syndrome;
2914 if (!chip->ecc.write_page_raw)
2915 chip->ecc.write_page_raw = nand_write_page_raw_syndrome;
2916 if (!chip->ecc.read_oob)
2917 chip->ecc.read_oob = nand_read_oob_syndrome;
2918 if (!chip->ecc.write_oob)
2919 chip->ecc.write_oob = nand_write_oob_syndrome;
2921 if (mtd->writesize >= chip->ecc.size)
2923 printk(KERN_WARNING "%d byte HW ECC not possible on "
2924 "%d byte page size, fallback to SW ECC\n",
2925 chip->ecc.size, mtd->writesize);
2926 chip->ecc.mode = NAND_ECC_SOFT;
2929 chip->ecc.calculate = nand_calculate_ecc;
2930 chip->ecc.correct = nand_correct_data;
2931 chip->ecc.read_page = nand_read_page_swecc;
2932 chip->ecc.read_subpage = nand_read_subpage;
2933 chip->ecc.write_page = nand_write_page_swecc;
2934 chip->ecc.read_page_raw = nand_read_page_raw;
2935 chip->ecc.write_page_raw = nand_write_page_raw;
2936 chip->ecc.read_oob = nand_read_oob_std;
2937 chip->ecc.write_oob = nand_write_oob_std;
2938 chip->ecc.size = 256;
2939 chip->ecc.bytes = 3;
2943 printk(KERN_WARNING "NAND_ECC_NONE selected by board driver. "
2944 "This is not recommended !!\n");
2945 chip->ecc.read_page = nand_read_page_raw;
2946 chip->ecc.write_page = nand_write_page_raw;
2947 chip->ecc.read_oob = nand_read_oob_std;
2948 chip->ecc.read_page_raw = nand_read_page_raw;
2949 chip->ecc.write_page_raw = nand_write_page_raw;
2950 chip->ecc.write_oob = nand_write_oob_std;
2951 chip->ecc.size = mtd->writesize;
2952 chip->ecc.bytes = 0;
2956 printk(KERN_WARNING "Invalid NAND_ECC_MODE %d\n",
2962 * The number of bytes available for a client to place data into
2963 * the out of band area
2965 chip->ecc.layout->oobavail = 0;
2966 for (i = 0; chip->ecc.layout->oobfree[i].length
2967 && i < ARRAY_SIZE(chip->ecc.layout->oobfree); i++)
2968 chip->ecc.layout->oobavail +=
2969 chip->ecc.layout->oobfree[i].length;
2970 mtd->oobavail = chip->ecc.layout->oobavail;
2973 * Set the number of read / write steps for one page depending on ECC
2976 chip->ecc.steps = mtd->writesize / chip->ecc.size;
2977 if(chip->ecc.steps * chip->ecc.size != mtd->writesize) {
2978 printk(KERN_WARNING "Invalid ecc parameters\n");
2981 chip->ecc.total = chip->ecc.steps * chip->ecc.bytes;
2984 * Allow subpage writes up to ecc.steps. Not possible for MLC
2987 if (!(chip->options & NAND_NO_SUBPAGE_WRITE) &&
2988 !(chip->cellinfo & NAND_CI_CELLTYPE_MSK)) {
2989 switch(chip->ecc.steps) {
2991 mtd->subpage_sft = 1;
2996 mtd->subpage_sft = 2;
3000 chip->subpagesize = mtd->writesize >> mtd->subpage_sft;
3002 /* Initialize state */
3003 chip->state = FL_READY;
3005 /* De-select the device */
3006 chip->select_chip(mtd, -1);
3008 /* Invalidate the pagebuffer reference */
3011 /* Fill in remaining MTD driver data */
3012 mtd->type = MTD_NANDFLASH;
3013 mtd->flags = MTD_CAP_NANDFLASH;
3014 mtd->erase = nand_erase;
3016 mtd->unpoint = NULL;
3017 mtd->read = nand_read;
3018 mtd->write = nand_write;
3019 mtd->read_oob = nand_read_oob;
3020 mtd->write_oob = nand_write_oob;
3021 mtd->sync = nand_sync;
3024 mtd->suspend = nand_suspend;
3025 mtd->resume = nand_resume;
3026 mtd->block_isbad = nand_block_isbad;
3027 mtd->block_markbad = nand_block_markbad;
3029 /* propagate ecc.layout to mtd_info */
3030 mtd->ecclayout = chip->ecc.layout;
3032 /* Check, if we should skip the bad block table scan */
3033 if (chip->options & NAND_SKIP_BBTSCAN)
3034 chip->options |= NAND_BBT_SCANNED;
3039 /* module_text_address() isn't exported, and it's mostly a pointless
3040 test if this is a module _anyway_ -- they'd have to try _really_ hard
3041 to call us from in-kernel code if the core NAND support is modular. */
3043 #define caller_is_module() (1)
3045 #define caller_is_module() \
3046 module_text_address((unsigned long)__builtin_return_address(0))
3050 * nand_scan - [NAND Interface] Scan for the NAND device
3051 * @mtd: MTD device structure
3052 * @maxchips: Number of chips to scan for
3054 * This fills out all the uninitialized function pointers
3055 * with the defaults.
3056 * The flash ID is read and the mtd/chip structures are
3057 * filled with the appropriate values.
3058 * The mtd->owner field must be set to the module of the caller
3061 int nand_scan(struct mtd_info *mtd, int maxchips)
3065 /* Many callers got this wrong, so check for it for a while... */
3066 /* XXX U-BOOT XXX */
3068 if (!mtd->owner && caller_is_module()) {
3069 printk(KERN_CRIT "nand_scan() called with NULL mtd->owner!\n");
3074 ret = nand_scan_ident(mtd, maxchips);
3076 ret = nand_scan_tail(mtd);
3081 * nand_release - [NAND Interface] Free resources held by the NAND device
3082 * @mtd: MTD device structure
3084 void nand_release(struct mtd_info *mtd)
3086 struct nand_chip *chip = mtd->priv;
3088 #ifdef CONFIG_MTD_PARTITIONS
3089 /* Deregister partitions */
3090 del_mtd_partitions(mtd);
3092 /* Deregister the device */
3093 /* XXX U-BOOT XXX */
3095 del_mtd_device(mtd);
3098 /* Free bad block table memory */
3100 if (!(chip->options & NAND_OWN_BUFFERS))
3101 kfree(chip->buffers);
3104 /* XXX U-BOOT XXX */
3106 EXPORT_SYMBOL_GPL(nand_scan);
3107 EXPORT_SYMBOL_GPL(nand_scan_ident);
3108 EXPORT_SYMBOL_GPL(nand_scan_tail);
3109 EXPORT_SYMBOL_GPL(nand_release);
3111 static int __init nand_base_init(void)
3113 led_trigger_register_simple("nand-disk", &nand_led_trigger);
3117 static void __exit nand_base_exit(void)
3119 led_trigger_unregister_simple(nand_led_trigger);
3122 module_init(nand_base_init);
3123 module_exit(nand_base_exit);
3125 MODULE_LICENSE("GPL");
3126 MODULE_AUTHOR("Steven J. Hill <sjhill@realitydiluted.com>, Thomas Gleixner <tglx@linutronix.de>");
3127 MODULE_DESCRIPTION("Generic NAND flash driver code");