2 * linux/drivers/mtd/onenand/onenand_base.c
4 * Copyright (C) 2005-2006 Samsung Electronics
5 * Kyungmin Park <kyungmin.park@samsung.com>
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License version 2 as
9 * published by the Free Software Foundation.
12 #include <linux/kernel.h>
13 #include <linux/module.h>
14 #include <linux/init.h>
15 #include <linux/sched.h>
16 #include <linux/interrupt.h>
17 #include <linux/jiffies.h>
18 #include <linux/mtd/mtd.h>
19 #include <linux/mtd/onenand.h>
20 #include <linux/mtd/partitions.h>
25 * onenand_oob_64 - oob info for large (2KB) page
27 static struct nand_ecclayout onenand_oob_64 = {
36 {2, 3}, {14, 2}, {18, 3}, {30, 2},
37 {34, 3}, {46, 2}, {50, 3}, {62, 2}
42 * onenand_oob_32 - oob info for middle (1KB) page
44 static struct nand_ecclayout onenand_oob_32 = {
50 .oobfree = { {2, 3}, {14, 2}, {18, 3}, {30, 2} }
53 static const unsigned char ffchars[] = {
54 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff,
55 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, /* 16 */
56 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff,
57 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, /* 32 */
58 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff,
59 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, /* 48 */
60 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff,
61 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, /* 64 */
65 * onenand_readw - [OneNAND Interface] Read OneNAND register
66 * @param addr address to read
68 * Read OneNAND register
70 static unsigned short onenand_readw(void __iomem *addr)
76 * onenand_writew - [OneNAND Interface] Write OneNAND register with value
77 * @param value value to write
78 * @param addr address to write
80 * Write OneNAND register with value
82 static void onenand_writew(unsigned short value, void __iomem *addr)
88 * onenand_block_address - [DEFAULT] Get block address
89 * @param this onenand chip data structure
90 * @param block the block
91 * @return translated block address if DDP, otherwise same
93 * Setup Start Address 1 Register (F100h)
95 static int onenand_block_address(struct onenand_chip *this, int block)
97 if (this->device_id & ONENAND_DEVICE_IS_DDP) {
98 /* Device Flash Core select, NAND Flash Block Address */
101 if (block & this->density_mask)
104 return (dfs << ONENAND_DDP_SHIFT) |
105 (block & (this->density_mask - 1));
112 * onenand_bufferram_address - [DEFAULT] Get bufferram address
113 * @param this onenand chip data structure
114 * @param block the block
115 * @return set DBS value if DDP, otherwise 0
117 * Setup Start Address 2 Register (F101h) for DDP
119 static int onenand_bufferram_address(struct onenand_chip *this, int block)
121 if (this->device_id & ONENAND_DEVICE_IS_DDP) {
122 /* Device BufferRAM Select */
125 if (block & this->density_mask)
128 return (dbs << ONENAND_DDP_SHIFT);
135 * onenand_page_address - [DEFAULT] Get page address
136 * @param page the page address
137 * @param sector the sector address
138 * @return combined page and sector address
140 * Setup Start Address 8 Register (F107h)
142 static int onenand_page_address(int page, int sector)
144 /* Flash Page Address, Flash Sector Address */
147 fpa = page & ONENAND_FPA_MASK;
148 fsa = sector & ONENAND_FSA_MASK;
150 return ((fpa << ONENAND_FPA_SHIFT) | fsa);
154 * onenand_buffer_address - [DEFAULT] Get buffer address
155 * @param dataram1 DataRAM index
156 * @param sectors the sector address
157 * @param count the number of sectors
158 * @return the start buffer value
160 * Setup Start Buffer Register (F200h)
162 static int onenand_buffer_address(int dataram1, int sectors, int count)
166 /* BufferRAM Sector Address */
167 bsa = sectors & ONENAND_BSA_MASK;
170 bsa |= ONENAND_BSA_DATARAM1; /* DataRAM1 */
172 bsa |= ONENAND_BSA_DATARAM0; /* DataRAM0 */
174 /* BufferRAM Sector Count */
175 bsc = count & ONENAND_BSC_MASK;
177 return ((bsa << ONENAND_BSA_SHIFT) | bsc);
181 * onenand_command - [DEFAULT] Send command to OneNAND device
182 * @param mtd MTD device structure
183 * @param cmd the command to be sent
184 * @param addr offset to read from or write to
185 * @param len number of bytes to read or write
187 * Send command to OneNAND device. This function is used for middle/large page
188 * devices (1KB/2KB Bytes per page)
190 static int onenand_command(struct mtd_info *mtd, int cmd, loff_t addr, size_t len)
192 struct onenand_chip *this = mtd->priv;
193 int value, readcmd = 0, block_cmd = 0;
196 /* Address translation */
198 case ONENAND_CMD_UNLOCK:
199 case ONENAND_CMD_LOCK:
200 case ONENAND_CMD_LOCK_TIGHT:
201 case ONENAND_CMD_UNLOCK_ALL:
206 case ONENAND_CMD_ERASE:
207 case ONENAND_CMD_BUFFERRAM:
208 case ONENAND_CMD_OTP_ACCESS:
210 block = (int) (addr >> this->erase_shift);
215 block = (int) (addr >> this->erase_shift);
216 page = (int) (addr >> this->page_shift);
217 page &= this->page_mask;
221 /* NOTE: The setting order of the registers is very important! */
222 if (cmd == ONENAND_CMD_BUFFERRAM) {
223 /* Select DataRAM for DDP */
224 value = onenand_bufferram_address(this, block);
225 this->write_word(value, this->base + ONENAND_REG_START_ADDRESS2);
227 /* Switch to the next data buffer */
228 ONENAND_SET_NEXT_BUFFERRAM(this);
234 /* Write 'DFS, FBA' of Flash */
235 value = onenand_block_address(this, block);
236 this->write_word(value, this->base + ONENAND_REG_START_ADDRESS1);
239 /* Select DataRAM for DDP */
240 value = onenand_bufferram_address(this, block);
241 this->write_word(value, this->base + ONENAND_REG_START_ADDRESS2);
246 /* Now we use page size operation */
247 int sectors = 4, count = 4;
251 case ONENAND_CMD_READ:
252 case ONENAND_CMD_READOOB:
253 dataram = ONENAND_SET_NEXT_BUFFERRAM(this);
258 dataram = ONENAND_CURRENT_BUFFERRAM(this);
262 /* Write 'FPA, FSA' of Flash */
263 value = onenand_page_address(page, sectors);
264 this->write_word(value, this->base + ONENAND_REG_START_ADDRESS8);
266 /* Write 'BSA, BSC' of DataRAM */
267 value = onenand_buffer_address(dataram, sectors, count);
268 this->write_word(value, this->base + ONENAND_REG_START_BUFFER);
271 /* Select DataRAM for DDP */
272 value = onenand_bufferram_address(this, block);
273 this->write_word(value, this->base + ONENAND_REG_START_ADDRESS2);
277 /* Interrupt clear */
278 this->write_word(ONENAND_INT_CLEAR, this->base + ONENAND_REG_INTERRUPT);
281 this->write_word(cmd, this->base + ONENAND_REG_COMMAND);
287 * onenand_wait - [DEFAULT] wait until the command is done
288 * @param mtd MTD device structure
289 * @param state state to select the max. timeout value
291 * Wait for command done. This applies to all OneNAND command
292 * Read can take up to 30us, erase up to 2ms and program up to 350us
293 * according to general OneNAND specs
295 static int onenand_wait(struct mtd_info *mtd, int state)
297 struct onenand_chip * this = mtd->priv;
298 unsigned long timeout;
299 unsigned int flags = ONENAND_INT_MASTER;
300 unsigned int interrupt = 0;
303 /* The 20 msec is enough */
304 timeout = jiffies + msecs_to_jiffies(20);
305 while (time_before(jiffies, timeout)) {
306 interrupt = this->read_word(this->base + ONENAND_REG_INTERRUPT);
308 if (interrupt & flags)
311 if (state != FL_READING)
314 /* To get correct interrupt status in timeout case */
315 interrupt = this->read_word(this->base + ONENAND_REG_INTERRUPT);
317 ctrl = this->read_word(this->base + ONENAND_REG_CTRL_STATUS);
319 if (ctrl & ONENAND_CTRL_ERROR) {
320 DEBUG(MTD_DEBUG_LEVEL0, "onenand_wait: controller error = 0x%04x\n", ctrl);
321 if (ctrl & ONENAND_CTRL_LOCK)
322 DEBUG(MTD_DEBUG_LEVEL0, "onenand_wait: it's locked error.\n");
326 if (interrupt & ONENAND_INT_READ) {
327 int ecc = this->read_word(this->base + ONENAND_REG_ECC_STATUS);
329 DEBUG(MTD_DEBUG_LEVEL0, "onenand_wait: ECC error = 0x%04x\n", ecc);
330 if (ecc & ONENAND_ECC_2BIT_ALL) {
331 mtd->ecc_stats.failed++;
333 } else if (ecc & ONENAND_ECC_1BIT_ALL)
334 mtd->ecc_stats.corrected++;
336 } else if (state == FL_READING) {
337 printk(KERN_ERR "onenand_wait: read timeout! ctrl=0x%04x intr=0x%04x\n", ctrl, interrupt);
345 * onenand_interrupt - [DEFAULT] onenand interrupt handler
346 * @param irq onenand interrupt number
347 * @param dev_id interrupt data
351 static irqreturn_t onenand_interrupt(int irq, void *data)
353 struct onenand_chip *this = (struct onenand_chip *) data;
355 /* To handle shared interrupt */
356 if (!this->complete.done)
357 complete(&this->complete);
363 * onenand_interrupt_wait - [DEFAULT] wait until the command is done
364 * @param mtd MTD device structure
365 * @param state state to select the max. timeout value
367 * Wait for command done.
369 static int onenand_interrupt_wait(struct mtd_info *mtd, int state)
371 struct onenand_chip *this = mtd->priv;
373 wait_for_completion(&this->complete);
375 return onenand_wait(mtd, state);
379 * onenand_try_interrupt_wait - [DEFAULT] try interrupt wait
380 * @param mtd MTD device structure
381 * @param state state to select the max. timeout value
383 * Try interrupt based wait (It is used one-time)
385 static int onenand_try_interrupt_wait(struct mtd_info *mtd, int state)
387 struct onenand_chip *this = mtd->priv;
388 unsigned long remain, timeout;
390 /* We use interrupt wait first */
391 this->wait = onenand_interrupt_wait;
393 timeout = msecs_to_jiffies(100);
394 remain = wait_for_completion_timeout(&this->complete, timeout);
396 printk(KERN_INFO "OneNAND: There's no interrupt. "
397 "We use the normal wait\n");
399 /* Release the irq */
400 free_irq(this->irq, this);
402 this->wait = onenand_wait;
405 return onenand_wait(mtd, state);
409 * onenand_setup_wait - [OneNAND Interface] setup onenand wait method
410 * @param mtd MTD device structure
412 * There's two method to wait onenand work
413 * 1. polling - read interrupt status register
414 * 2. interrupt - use the kernel interrupt method
416 static void onenand_setup_wait(struct mtd_info *mtd)
418 struct onenand_chip *this = mtd->priv;
421 init_completion(&this->complete);
423 if (this->irq <= 0) {
424 this->wait = onenand_wait;
428 if (request_irq(this->irq, &onenand_interrupt,
429 IRQF_SHARED, "onenand", this)) {
430 /* If we can't get irq, use the normal wait */
431 this->wait = onenand_wait;
435 /* Enable interrupt */
436 syscfg = this->read_word(this->base + ONENAND_REG_SYS_CFG1);
437 syscfg |= ONENAND_SYS_CFG1_IOBE;
438 this->write_word(syscfg, this->base + ONENAND_REG_SYS_CFG1);
440 this->wait = onenand_try_interrupt_wait;
444 * onenand_bufferram_offset - [DEFAULT] BufferRAM offset
445 * @param mtd MTD data structure
446 * @param area BufferRAM area
447 * @return offset given area
449 * Return BufferRAM offset given area
451 static inline int onenand_bufferram_offset(struct mtd_info *mtd, int area)
453 struct onenand_chip *this = mtd->priv;
455 if (ONENAND_CURRENT_BUFFERRAM(this)) {
456 if (area == ONENAND_DATARAM)
457 return mtd->writesize;
458 if (area == ONENAND_SPARERAM)
466 * onenand_read_bufferram - [OneNAND Interface] Read the bufferram area
467 * @param mtd MTD data structure
468 * @param area BufferRAM area
469 * @param buffer the databuffer to put/get data
470 * @param offset offset to read from or write to
471 * @param count number of bytes to read/write
473 * Read the BufferRAM area
475 static int onenand_read_bufferram(struct mtd_info *mtd, int area,
476 unsigned char *buffer, int offset, size_t count)
478 struct onenand_chip *this = mtd->priv;
479 void __iomem *bufferram;
481 bufferram = this->base + area;
483 bufferram += onenand_bufferram_offset(mtd, area);
485 if (ONENAND_CHECK_BYTE_ACCESS(count)) {
488 /* Align with word(16-bit) size */
491 /* Read word and save byte */
492 word = this->read_word(bufferram + offset + count);
493 buffer[count] = (word & 0xff);
496 memcpy(buffer, bufferram + offset, count);
502 * onenand_sync_read_bufferram - [OneNAND Interface] Read the bufferram area with Sync. Burst mode
503 * @param mtd MTD data structure
504 * @param area BufferRAM area
505 * @param buffer the databuffer to put/get data
506 * @param offset offset to read from or write to
507 * @param count number of bytes to read/write
509 * Read the BufferRAM area with Sync. Burst Mode
511 static int onenand_sync_read_bufferram(struct mtd_info *mtd, int area,
512 unsigned char *buffer, int offset, size_t count)
514 struct onenand_chip *this = mtd->priv;
515 void __iomem *bufferram;
517 bufferram = this->base + area;
519 bufferram += onenand_bufferram_offset(mtd, area);
521 this->mmcontrol(mtd, ONENAND_SYS_CFG1_SYNC_READ);
523 if (ONENAND_CHECK_BYTE_ACCESS(count)) {
526 /* Align with word(16-bit) size */
529 /* Read word and save byte */
530 word = this->read_word(bufferram + offset + count);
531 buffer[count] = (word & 0xff);
534 memcpy(buffer, bufferram + offset, count);
536 this->mmcontrol(mtd, 0);
542 * onenand_write_bufferram - [OneNAND Interface] Write the bufferram area
543 * @param mtd MTD data structure
544 * @param area BufferRAM area
545 * @param buffer the databuffer to put/get data
546 * @param offset offset to read from or write to
547 * @param count number of bytes to read/write
549 * Write the BufferRAM area
551 static int onenand_write_bufferram(struct mtd_info *mtd, int area,
552 const unsigned char *buffer, int offset, size_t count)
554 struct onenand_chip *this = mtd->priv;
555 void __iomem *bufferram;
557 bufferram = this->base + area;
559 bufferram += onenand_bufferram_offset(mtd, area);
561 if (ONENAND_CHECK_BYTE_ACCESS(count)) {
565 /* Align with word(16-bit) size */
568 /* Calculate byte access offset */
569 byte_offset = offset + count;
571 /* Read word and save byte */
572 word = this->read_word(bufferram + byte_offset);
573 word = (word & ~0xff) | buffer[count];
574 this->write_word(word, bufferram + byte_offset);
577 memcpy(bufferram + offset, buffer, count);
583 * onenand_check_bufferram - [GENERIC] Check BufferRAM information
584 * @param mtd MTD data structure
585 * @param addr address to check
586 * @return 1 if there are valid data, otherwise 0
588 * Check bufferram if there is data we required
590 static int onenand_check_bufferram(struct mtd_info *mtd, loff_t addr)
592 struct onenand_chip *this = mtd->priv;
596 block = (int) (addr >> this->erase_shift);
597 page = (int) (addr >> this->page_shift);
598 page &= this->page_mask;
600 i = ONENAND_CURRENT_BUFFERRAM(this);
602 /* Is there valid data? */
603 if (this->bufferram[i].block == block &&
604 this->bufferram[i].page == page &&
605 this->bufferram[i].valid)
612 * onenand_update_bufferram - [GENERIC] Update BufferRAM information
613 * @param mtd MTD data structure
614 * @param addr address to update
615 * @param valid valid flag
617 * Update BufferRAM information
619 static int onenand_update_bufferram(struct mtd_info *mtd, loff_t addr,
622 struct onenand_chip *this = mtd->priv;
626 block = (int) (addr >> this->erase_shift);
627 page = (int) (addr >> this->page_shift);
628 page &= this->page_mask;
630 /* Invalidate BufferRAM */
631 for (i = 0; i < MAX_BUFFERRAM; i++) {
632 if (this->bufferram[i].block == block &&
633 this->bufferram[i].page == page)
634 this->bufferram[i].valid = 0;
637 /* Update BufferRAM */
638 i = ONENAND_CURRENT_BUFFERRAM(this);
639 this->bufferram[i].block = block;
640 this->bufferram[i].page = page;
641 this->bufferram[i].valid = valid;
647 * onenand_get_device - [GENERIC] Get chip for selected access
648 * @param mtd MTD device structure
649 * @param new_state the state which is requested
651 * Get the device and lock it for exclusive access
653 static int onenand_get_device(struct mtd_info *mtd, int new_state)
655 struct onenand_chip *this = mtd->priv;
656 DECLARE_WAITQUEUE(wait, current);
659 * Grab the lock and see if the device is available
662 spin_lock(&this->chip_lock);
663 if (this->state == FL_READY) {
664 this->state = new_state;
665 spin_unlock(&this->chip_lock);
668 if (new_state == FL_PM_SUSPENDED) {
669 spin_unlock(&this->chip_lock);
670 return (this->state == FL_PM_SUSPENDED) ? 0 : -EAGAIN;
672 set_current_state(TASK_UNINTERRUPTIBLE);
673 add_wait_queue(&this->wq, &wait);
674 spin_unlock(&this->chip_lock);
676 remove_wait_queue(&this->wq, &wait);
683 * onenand_release_device - [GENERIC] release chip
684 * @param mtd MTD device structure
686 * Deselect, release chip lock and wake up anyone waiting on the device
688 static void onenand_release_device(struct mtd_info *mtd)
690 struct onenand_chip *this = mtd->priv;
692 /* Release the chip */
693 spin_lock(&this->chip_lock);
694 this->state = FL_READY;
696 spin_unlock(&this->chip_lock);
700 * onenand_read - [MTD Interface] Read data from flash
701 * @param mtd MTD device structure
702 * @param from offset to read from
703 * @param len number of bytes to read
704 * @param retlen pointer to variable to store the number of read bytes
705 * @param buf the databuffer to put data
709 static int onenand_read(struct mtd_info *mtd, loff_t from, size_t len,
710 size_t *retlen, u_char *buf)
712 struct onenand_chip *this = mtd->priv;
713 struct mtd_ecc_stats stats;
714 int read = 0, column;
716 int ret = 0, boundary = 0;
718 DEBUG(MTD_DEBUG_LEVEL3, "onenand_read: from = 0x%08x, len = %i\n", (unsigned int) from, (int) len);
720 /* Do not allow reads past end of device */
721 if ((from + len) > mtd->size) {
722 DEBUG(MTD_DEBUG_LEVEL0, "onenand_read: Attempt read beyond end of device\n");
727 /* Grab the lock and see if the device is available */
728 onenand_get_device(mtd, FL_READING);
730 /* TODO handling oob */
732 stats = mtd->ecc_stats;
734 /* Read-while-load method */
736 /* Do first load to bufferRAM */
738 if (!onenand_check_bufferram(mtd, from)) {
739 this->command(mtd, ONENAND_CMD_READ, from, mtd->writesize);
740 ret = this->wait(mtd, FL_READING);
741 onenand_update_bufferram(mtd, from, !ret);
745 thislen = min_t(int, mtd->writesize, len - read);
746 column = from & (mtd->writesize - 1);
747 if (column + thislen > mtd->writesize)
748 thislen = mtd->writesize - column;
751 /* If there is more to load then start next load */
753 if (read + thislen < len) {
754 this->command(mtd, ONENAND_CMD_READ, from, mtd->writesize);
756 * Chip boundary handling in DDP
757 * Now we issued chip 1 read and pointed chip 1
758 * bufferam so we have to point chip 0 bufferam.
760 if (this->device_id & ONENAND_DEVICE_IS_DDP &&
761 unlikely(from == (this->chipsize >> 1))) {
762 this->write_word(0, this->base + ONENAND_REG_START_ADDRESS2);
766 ONENAND_SET_PREV_BUFFERRAM(this);
768 /* While load is going, read from last bufferRAM */
769 this->read_bufferram(mtd, ONENAND_DATARAM, buf, column, thislen);
770 /* See if we are done */
774 /* Set up for next read from bufferRAM */
775 if (unlikely(boundary))
776 this->write_word(0x8000, this->base + ONENAND_REG_START_ADDRESS2);
777 ONENAND_SET_NEXT_BUFFERRAM(this);
779 thislen = min_t(int, mtd->writesize, len - read);
782 /* Now wait for load */
783 ret = this->wait(mtd, FL_READING);
784 onenand_update_bufferram(mtd, from, !ret);
787 /* Deselect and wake up anyone waiting on the device */
788 onenand_release_device(mtd);
791 * Return success, if no ECC failures, else -EBADMSG
792 * fs driver will take care of that, because
793 * retlen == desired len and result == -EBADMSG
797 if (mtd->ecc_stats.failed - stats.failed)
803 return mtd->ecc_stats.corrected - stats.corrected ? -EUCLEAN : 0;
807 * onenand_do_read_oob - [MTD Interface] OneNAND read out-of-band
808 * @param mtd MTD device structure
809 * @param from offset to read from
810 * @param len number of bytes to read
811 * @param retlen pointer to variable to store the number of read bytes
812 * @param buf the databuffer to put data
814 * OneNAND read out-of-band data from the spare area
816 int onenand_do_read_oob(struct mtd_info *mtd, loff_t from, size_t len,
817 size_t *retlen, u_char *buf)
819 struct onenand_chip *this = mtd->priv;
820 int read = 0, thislen, column;
823 DEBUG(MTD_DEBUG_LEVEL3, "onenand_read_oob: from = 0x%08x, len = %i\n", (unsigned int) from, (int) len);
825 /* Initialize return length value */
828 /* Do not allow reads past end of device */
829 if (unlikely((from + len) > mtd->size)) {
830 DEBUG(MTD_DEBUG_LEVEL0, "onenand_read_oob: Attempt read beyond end of device\n");
834 /* Grab the lock and see if the device is available */
835 onenand_get_device(mtd, FL_READING);
837 column = from & (mtd->oobsize - 1);
842 thislen = mtd->oobsize - column;
843 thislen = min_t(int, thislen, len);
845 this->command(mtd, ONENAND_CMD_READOOB, from, mtd->oobsize);
847 onenand_update_bufferram(mtd, from, 0);
849 ret = this->wait(mtd, FL_READING);
850 /* First copy data and check return value for ECC handling */
852 this->read_bufferram(mtd, ONENAND_SPARERAM, buf, column, thislen);
855 DEBUG(MTD_DEBUG_LEVEL0, "onenand_read_oob: read failed = 0x%x\n", ret);
869 from += mtd->writesize;
875 /* Deselect and wake up anyone waiting on the device */
876 onenand_release_device(mtd);
883 * onenand_read_oob - [MTD Interface] NAND write data and/or out-of-band
884 * @mtd: MTD device structure
885 * @from: offset to read from
886 * @ops: oob operation description structure
888 static int onenand_read_oob(struct mtd_info *mtd, loff_t from,
889 struct mtd_oob_ops *ops)
891 BUG_ON(ops->mode != MTD_OOB_PLACE);
893 return onenand_do_read_oob(mtd, from + ops->ooboffs, ops->ooblen,
894 &ops->oobretlen, ops->oobbuf);
897 #ifdef CONFIG_MTD_ONENAND_VERIFY_WRITE
899 * onenand_verify_oob - [GENERIC] verify the oob contents after a write
900 * @param mtd MTD device structure
901 * @param buf the databuffer to verify
902 * @param to offset to read from
903 * @param len number of bytes to read and compare
906 static int onenand_verify_oob(struct mtd_info *mtd, const u_char *buf, loff_t to, int len)
908 struct onenand_chip *this = mtd->priv;
909 char *readp = this->page_buf;
910 int column = to & (mtd->oobsize - 1);
913 this->command(mtd, ONENAND_CMD_READOOB, to, mtd->oobsize);
914 onenand_update_bufferram(mtd, to, 0);
915 status = this->wait(mtd, FL_READING);
919 this->read_bufferram(mtd, ONENAND_SPARERAM, readp, column, len);
921 for(i = 0; i < len; i++)
922 if (buf[i] != 0xFF && buf[i] != readp[i])
929 * onenand_verify_page - [GENERIC] verify the chip contents after a write
930 * @param mtd MTD device structure
931 * @param buf the databuffer to verify
933 * Check DataRAM area directly
935 static int onenand_verify_page(struct mtd_info *mtd, u_char *buf, loff_t addr)
937 struct onenand_chip *this = mtd->priv;
938 void __iomem *dataram0, *dataram1;
941 /* In partial page write, just skip it */
942 if ((addr & (mtd->writesize - 1)) != 0)
945 this->command(mtd, ONENAND_CMD_READ, addr, mtd->writesize);
947 ret = this->wait(mtd, FL_READING);
951 onenand_update_bufferram(mtd, addr, 1);
953 /* Check, if the two dataram areas are same */
954 dataram0 = this->base + ONENAND_DATARAM;
955 dataram1 = dataram0 + mtd->writesize;
957 if (memcmp(dataram0, dataram1, mtd->writesize))
963 #define onenand_verify_page(...) (0)
964 #define onenand_verify_oob(...) (0)
967 #define NOTALIGNED(x) ((x & (this->subpagesize - 1)) != 0)
970 * onenand_write - [MTD Interface] write buffer to FLASH
971 * @param mtd MTD device structure
972 * @param to offset to write to
973 * @param len number of bytes to write
974 * @param retlen pointer to variable to store the number of written bytes
975 * @param buf the data to write
979 static int onenand_write(struct mtd_info *mtd, loff_t to, size_t len,
980 size_t *retlen, const u_char *buf)
982 struct onenand_chip *this = mtd->priv;
987 DEBUG(MTD_DEBUG_LEVEL3, "onenand_write: to = 0x%08x, len = %i\n", (unsigned int) to, (int) len);
989 /* Initialize retlen, in case of early exit */
992 /* Do not allow writes past end of device */
993 if (unlikely((to + len) > mtd->size)) {
994 DEBUG(MTD_DEBUG_LEVEL0, "onenand_write: Attempt write to past end of device\n");
998 /* Reject writes, which are not page aligned */
999 if (unlikely(NOTALIGNED(to)) || unlikely(NOTALIGNED(len))) {
1000 DEBUG(MTD_DEBUG_LEVEL0, "onenand_write: Attempt to write not page aligned data\n");
1004 column = to & (mtd->writesize - 1);
1005 subpage = column || (len & (mtd->writesize - 1));
1007 /* Grab the lock and see if the device is available */
1008 onenand_get_device(mtd, FL_WRITING);
1010 /* Loop until all data write */
1011 while (written < len) {
1012 int bytes = mtd->writesize;
1013 int thislen = min_t(int, bytes, len - written);
1014 u_char *wbuf = (u_char *) buf;
1018 this->command(mtd, ONENAND_CMD_BUFFERRAM, to, bytes);
1020 /* Partial page write */
1022 bytes = min_t(int, bytes - column, (int) len);
1023 memset(this->page_buf, 0xff, mtd->writesize);
1024 memcpy(this->page_buf + column, buf, bytes);
1025 wbuf = this->page_buf;
1026 /* Even though partial write, we need page size */
1027 thislen = mtd->writesize;
1030 this->write_bufferram(mtd, ONENAND_DATARAM, wbuf, 0, thislen);
1031 this->write_bufferram(mtd, ONENAND_SPARERAM, ffchars, 0, mtd->oobsize);
1033 this->command(mtd, ONENAND_CMD_PROG, to, mtd->writesize);
1035 /* In partial page write we don't update bufferram */
1036 onenand_update_bufferram(mtd, to, !subpage);
1038 ret = this->wait(mtd, FL_WRITING);
1040 DEBUG(MTD_DEBUG_LEVEL0, "onenand_write: write filaed %d\n", ret);
1044 /* Only check verify write turn on */
1045 ret = onenand_verify_page(mtd, (u_char *) wbuf, to);
1047 DEBUG(MTD_DEBUG_LEVEL0, "onenand_write: verify failed %d\n", ret);
1061 /* Deselect and wake up anyone waiting on the device */
1062 onenand_release_device(mtd);
1070 * onenand_do_write_oob - [Internal] OneNAND write out-of-band
1071 * @param mtd MTD device structure
1072 * @param to offset to write to
1073 * @param len number of bytes to write
1074 * @param retlen pointer to variable to store the number of written bytes
1075 * @param buf the data to write
1077 * OneNAND write out-of-band
1079 static int onenand_do_write_oob(struct mtd_info *mtd, loff_t to, size_t len,
1080 size_t *retlen, const u_char *buf)
1082 struct onenand_chip *this = mtd->priv;
1083 int column, ret = 0;
1086 DEBUG(MTD_DEBUG_LEVEL3, "onenand_write_oob: to = 0x%08x, len = %i\n", (unsigned int) to, (int) len);
1088 /* Initialize retlen, in case of early exit */
1091 /* Do not allow writes past end of device */
1092 if (unlikely((to + len) > mtd->size)) {
1093 DEBUG(MTD_DEBUG_LEVEL0, "onenand_write_oob: Attempt write to past end of device\n");
1097 /* Grab the lock and see if the device is available */
1098 onenand_get_device(mtd, FL_WRITING);
1100 /* Loop until all data write */
1101 while (written < len) {
1102 int thislen = min_t(int, mtd->oobsize, len - written);
1106 column = to & (mtd->oobsize - 1);
1108 this->command(mtd, ONENAND_CMD_BUFFERRAM, to, mtd->oobsize);
1110 /* We send data to spare ram with oobsize
1111 * to prevent byte access */
1112 memset(this->page_buf, 0xff, mtd->oobsize);
1113 memcpy(this->page_buf + column, buf, thislen);
1114 this->write_bufferram(mtd, ONENAND_SPARERAM, this->page_buf, 0, mtd->oobsize);
1116 this->command(mtd, ONENAND_CMD_PROGOOB, to, mtd->oobsize);
1118 onenand_update_bufferram(mtd, to, 0);
1120 ret = this->wait(mtd, FL_WRITING);
1122 DEBUG(MTD_DEBUG_LEVEL0, "onenand_write_oob: write filaed %d\n", ret);
1126 ret = onenand_verify_oob(mtd, buf, to, thislen);
1128 DEBUG(MTD_DEBUG_LEVEL0, "onenand_write_oob: verify failed %d\n", ret);
1142 /* Deselect and wake up anyone waiting on the device */
1143 onenand_release_device(mtd);
1151 * onenand_write_oob - [MTD Interface] NAND write data and/or out-of-band
1152 * @mtd: MTD device structure
1153 * @from: offset to read from
1154 * @ops: oob operation description structure
1156 static int onenand_write_oob(struct mtd_info *mtd, loff_t to,
1157 struct mtd_oob_ops *ops)
1159 BUG_ON(ops->mode != MTD_OOB_PLACE);
1161 return onenand_do_write_oob(mtd, to + ops->ooboffs, ops->ooblen,
1162 &ops->oobretlen, ops->oobbuf);
1166 * onenand_block_checkbad - [GENERIC] Check if a block is marked bad
1167 * @param mtd MTD device structure
1168 * @param ofs offset from device start
1169 * @param getchip 0, if the chip is already selected
1170 * @param allowbbt 1, if its allowed to access the bbt area
1172 * Check, if the block is bad. Either by reading the bad block table or
1173 * calling of the scan function.
1175 static int onenand_block_checkbad(struct mtd_info *mtd, loff_t ofs, int getchip, int allowbbt)
1177 struct onenand_chip *this = mtd->priv;
1178 struct bbm_info *bbm = this->bbm;
1180 /* Return info from the table */
1181 return bbm->isbad_bbt(mtd, ofs, allowbbt);
1185 * onenand_erase - [MTD Interface] erase block(s)
1186 * @param mtd MTD device structure
1187 * @param instr erase instruction
1189 * Erase one ore more blocks
1191 static int onenand_erase(struct mtd_info *mtd, struct erase_info *instr)
1193 struct onenand_chip *this = mtd->priv;
1194 unsigned int block_size;
1199 DEBUG(MTD_DEBUG_LEVEL3, "onenand_erase: start = 0x%08x, len = %i\n", (unsigned int) instr->addr, (unsigned int) instr->len);
1201 block_size = (1 << this->erase_shift);
1203 /* Start address must align on block boundary */
1204 if (unlikely(instr->addr & (block_size - 1))) {
1205 DEBUG(MTD_DEBUG_LEVEL0, "onenand_erase: Unaligned address\n");
1209 /* Length must align on block boundary */
1210 if (unlikely(instr->len & (block_size - 1))) {
1211 DEBUG(MTD_DEBUG_LEVEL0, "onenand_erase: Length not block aligned\n");
1215 /* Do not allow erase past end of device */
1216 if (unlikely((instr->len + instr->addr) > mtd->size)) {
1217 DEBUG(MTD_DEBUG_LEVEL0, "onenand_erase: Erase past end of device\n");
1221 instr->fail_addr = 0xffffffff;
1223 /* Grab the lock and see if the device is available */
1224 onenand_get_device(mtd, FL_ERASING);
1226 /* Loop throught the pages */
1230 instr->state = MTD_ERASING;
1235 /* Check if we have a bad block, we do not erase bad blocks */
1236 if (onenand_block_checkbad(mtd, addr, 0, 0)) {
1237 printk (KERN_WARNING "onenand_erase: attempt to erase a bad block at addr 0x%08x\n", (unsigned int) addr);
1238 instr->state = MTD_ERASE_FAILED;
1242 this->command(mtd, ONENAND_CMD_ERASE, addr, block_size);
1244 ret = this->wait(mtd, FL_ERASING);
1245 /* Check, if it is write protected */
1247 DEBUG(MTD_DEBUG_LEVEL0, "onenand_erase: Failed erase, block %d\n", (unsigned) (addr >> this->erase_shift));
1248 instr->state = MTD_ERASE_FAILED;
1249 instr->fail_addr = addr;
1257 instr->state = MTD_ERASE_DONE;
1261 ret = instr->state == MTD_ERASE_DONE ? 0 : -EIO;
1262 /* Do call back function */
1264 mtd_erase_callback(instr);
1266 /* Deselect and wake up anyone waiting on the device */
1267 onenand_release_device(mtd);
1273 * onenand_sync - [MTD Interface] sync
1274 * @param mtd MTD device structure
1276 * Sync is actually a wait for chip ready function
1278 static void onenand_sync(struct mtd_info *mtd)
1280 DEBUG(MTD_DEBUG_LEVEL3, "onenand_sync: called\n");
1282 /* Grab the lock and see if the device is available */
1283 onenand_get_device(mtd, FL_SYNCING);
1285 /* Release it and go back */
1286 onenand_release_device(mtd);
1290 * onenand_block_isbad - [MTD Interface] Check whether the block at the given offset is bad
1291 * @param mtd MTD device structure
1292 * @param ofs offset relative to mtd start
1294 * Check whether the block is bad
1296 static int onenand_block_isbad(struct mtd_info *mtd, loff_t ofs)
1298 /* Check for invalid offset */
1299 if (ofs > mtd->size)
1302 return onenand_block_checkbad(mtd, ofs, 1, 0);
1306 * onenand_default_block_markbad - [DEFAULT] mark a block bad
1307 * @param mtd MTD device structure
1308 * @param ofs offset from device start
1310 * This is the default implementation, which can be overridden by
1311 * a hardware specific driver.
1313 static int onenand_default_block_markbad(struct mtd_info *mtd, loff_t ofs)
1315 struct onenand_chip *this = mtd->priv;
1316 struct bbm_info *bbm = this->bbm;
1317 u_char buf[2] = {0, 0};
1321 /* Get block number */
1322 block = ((int) ofs) >> bbm->bbt_erase_shift;
1324 bbm->bbt[block >> 2] |= 0x01 << ((block & 0x03) << 1);
1326 /* We write two bytes, so we dont have to mess with 16 bit access */
1327 ofs += mtd->oobsize + (bbm->badblockpos & ~0x01);
1328 return onenand_do_write_oob(mtd, ofs , 2, &retlen, buf);
1332 * onenand_block_markbad - [MTD Interface] Mark the block at the given offset as bad
1333 * @param mtd MTD device structure
1334 * @param ofs offset relative to mtd start
1336 * Mark the block as bad
1338 static int onenand_block_markbad(struct mtd_info *mtd, loff_t ofs)
1340 struct onenand_chip *this = mtd->priv;
1343 ret = onenand_block_isbad(mtd, ofs);
1345 /* If it was bad already, return success and do nothing */
1351 return this->block_markbad(mtd, ofs);
1355 * onenand_do_lock_cmd - [OneNAND Interface] Lock or unlock block(s)
1356 * @param mtd MTD device structure
1357 * @param ofs offset relative to mtd start
1358 * @param len number of bytes to lock or unlock
1360 * Lock or unlock one or more blocks
1362 static int onenand_do_lock_cmd(struct mtd_info *mtd, loff_t ofs, size_t len, int cmd)
1364 struct onenand_chip *this = mtd->priv;
1365 int start, end, block, value, status;
1368 start = ofs >> this->erase_shift;
1369 end = len >> this->erase_shift;
1371 if (cmd == ONENAND_CMD_LOCK)
1372 wp_status_mask = ONENAND_WP_LS;
1374 wp_status_mask = ONENAND_WP_US;
1376 /* Continuous lock scheme */
1377 if (this->options & ONENAND_HAS_CONT_LOCK) {
1378 /* Set start block address */
1379 this->write_word(start, this->base + ONENAND_REG_START_BLOCK_ADDRESS);
1380 /* Set end block address */
1381 this->write_word(start + end - 1, this->base + ONENAND_REG_END_BLOCK_ADDRESS);
1382 /* Write lock command */
1383 this->command(mtd, cmd, 0, 0);
1385 /* There's no return value */
1386 this->wait(mtd, FL_LOCKING);
1389 while (this->read_word(this->base + ONENAND_REG_CTRL_STATUS)
1390 & ONENAND_CTRL_ONGO)
1393 /* Check lock status */
1394 status = this->read_word(this->base + ONENAND_REG_WP_STATUS);
1395 if (!(status & wp_status_mask))
1396 printk(KERN_ERR "wp status = 0x%x\n", status);
1401 /* Block lock scheme */
1402 for (block = start; block < start + end; block++) {
1403 /* Set block address */
1404 value = onenand_block_address(this, block);
1405 this->write_word(value, this->base + ONENAND_REG_START_ADDRESS1);
1406 /* Select DataRAM for DDP */
1407 value = onenand_bufferram_address(this, block);
1408 this->write_word(value, this->base + ONENAND_REG_START_ADDRESS2);
1409 /* Set start block address */
1410 this->write_word(block, this->base + ONENAND_REG_START_BLOCK_ADDRESS);
1411 /* Write lock command */
1412 this->command(mtd, cmd, 0, 0);
1414 /* There's no return value */
1415 this->wait(mtd, FL_LOCKING);
1418 while (this->read_word(this->base + ONENAND_REG_CTRL_STATUS)
1419 & ONENAND_CTRL_ONGO)
1422 /* Check lock status */
1423 status = this->read_word(this->base + ONENAND_REG_WP_STATUS);
1424 if (!(status & wp_status_mask))
1425 printk(KERN_ERR "block = %d, wp status = 0x%x\n", block, status);
1432 * onenand_lock - [MTD Interface] Lock block(s)
1433 * @param mtd MTD device structure
1434 * @param ofs offset relative to mtd start
1435 * @param len number of bytes to unlock
1437 * Lock one or more blocks
1439 static int onenand_lock(struct mtd_info *mtd, loff_t ofs, size_t len)
1441 return onenand_do_lock_cmd(mtd, ofs, len, ONENAND_CMD_LOCK);
1445 * onenand_unlock - [MTD Interface] Unlock block(s)
1446 * @param mtd MTD device structure
1447 * @param ofs offset relative to mtd start
1448 * @param len number of bytes to unlock
1450 * Unlock one or more blocks
1452 static int onenand_unlock(struct mtd_info *mtd, loff_t ofs, size_t len)
1454 return onenand_do_lock_cmd(mtd, ofs, len, ONENAND_CMD_UNLOCK);
1458 * onenand_check_lock_status - [OneNAND Interface] Check lock status
1459 * @param this onenand chip data structure
1463 static void onenand_check_lock_status(struct onenand_chip *this)
1465 unsigned int value, block, status;
1468 end = this->chipsize >> this->erase_shift;
1469 for (block = 0; block < end; block++) {
1470 /* Set block address */
1471 value = onenand_block_address(this, block);
1472 this->write_word(value, this->base + ONENAND_REG_START_ADDRESS1);
1473 /* Select DataRAM for DDP */
1474 value = onenand_bufferram_address(this, block);
1475 this->write_word(value, this->base + ONENAND_REG_START_ADDRESS2);
1476 /* Set start block address */
1477 this->write_word(block, this->base + ONENAND_REG_START_BLOCK_ADDRESS);
1479 /* Check lock status */
1480 status = this->read_word(this->base + ONENAND_REG_WP_STATUS);
1481 if (!(status & ONENAND_WP_US))
1482 printk(KERN_ERR "block = %d, wp status = 0x%x\n", block, status);
1487 * onenand_unlock_all - [OneNAND Interface] unlock all blocks
1488 * @param mtd MTD device structure
1492 static int onenand_unlock_all(struct mtd_info *mtd)
1494 struct onenand_chip *this = mtd->priv;
1496 if (this->options & ONENAND_HAS_UNLOCK_ALL) {
1497 /* Set start block address */
1498 this->write_word(0, this->base + ONENAND_REG_START_BLOCK_ADDRESS);
1499 /* Write unlock command */
1500 this->command(mtd, ONENAND_CMD_UNLOCK_ALL, 0, 0);
1502 /* There's no return value */
1503 this->wait(mtd, FL_LOCKING);
1506 while (this->read_word(this->base + ONENAND_REG_CTRL_STATUS)
1507 & ONENAND_CTRL_ONGO)
1510 /* Workaround for all block unlock in DDP */
1511 if (this->device_id & ONENAND_DEVICE_IS_DDP) {
1512 /* 1st block on another chip */
1513 loff_t ofs = this->chipsize >> 1;
1514 size_t len = mtd->erasesize;
1516 onenand_unlock(mtd, ofs, len);
1519 onenand_check_lock_status(this);
1524 onenand_unlock(mtd, 0x0, this->chipsize);
1529 #ifdef CONFIG_MTD_ONENAND_OTP
1531 /* Interal OTP operation */
1532 typedef int (*otp_op_t)(struct mtd_info *mtd, loff_t form, size_t len,
1533 size_t *retlen, u_char *buf);
1536 * do_otp_read - [DEFAULT] Read OTP block area
1537 * @param mtd MTD device structure
1538 * @param from The offset to read
1539 * @param len number of bytes to read
1540 * @param retlen pointer to variable to store the number of readbytes
1541 * @param buf the databuffer to put/get data
1543 * Read OTP block area.
1545 static int do_otp_read(struct mtd_info *mtd, loff_t from, size_t len,
1546 size_t *retlen, u_char *buf)
1548 struct onenand_chip *this = mtd->priv;
1551 /* Enter OTP access mode */
1552 this->command(mtd, ONENAND_CMD_OTP_ACCESS, 0, 0);
1553 this->wait(mtd, FL_OTPING);
1555 ret = mtd->read(mtd, from, len, retlen, buf);
1557 /* Exit OTP access mode */
1558 this->command(mtd, ONENAND_CMD_RESET, 0, 0);
1559 this->wait(mtd, FL_RESETING);
1565 * do_otp_write - [DEFAULT] Write OTP block area
1566 * @param mtd MTD device structure
1567 * @param from The offset to write
1568 * @param len number of bytes to write
1569 * @param retlen pointer to variable to store the number of write bytes
1570 * @param buf the databuffer to put/get data
1572 * Write OTP block area.
1574 static int do_otp_write(struct mtd_info *mtd, loff_t from, size_t len,
1575 size_t *retlen, u_char *buf)
1577 struct onenand_chip *this = mtd->priv;
1578 unsigned char *pbuf = buf;
1581 /* Force buffer page aligned */
1582 if (len < mtd->writesize) {
1583 memcpy(this->page_buf, buf, len);
1584 memset(this->page_buf + len, 0xff, mtd->writesize - len);
1585 pbuf = this->page_buf;
1586 len = mtd->writesize;
1589 /* Enter OTP access mode */
1590 this->command(mtd, ONENAND_CMD_OTP_ACCESS, 0, 0);
1591 this->wait(mtd, FL_OTPING);
1593 ret = mtd->write(mtd, from, len, retlen, pbuf);
1595 /* Exit OTP access mode */
1596 this->command(mtd, ONENAND_CMD_RESET, 0, 0);
1597 this->wait(mtd, FL_RESETING);
1603 * do_otp_lock - [DEFAULT] Lock OTP block area
1604 * @param mtd MTD device structure
1605 * @param from The offset to lock
1606 * @param len number of bytes to lock
1607 * @param retlen pointer to variable to store the number of lock bytes
1608 * @param buf the databuffer to put/get data
1610 * Lock OTP block area.
1612 static int do_otp_lock(struct mtd_info *mtd, loff_t from, size_t len,
1613 size_t *retlen, u_char *buf)
1615 struct onenand_chip *this = mtd->priv;
1618 /* Enter OTP access mode */
1619 this->command(mtd, ONENAND_CMD_OTP_ACCESS, 0, 0);
1620 this->wait(mtd, FL_OTPING);
1622 ret = onenand_do_write_oob(mtd, from, len, retlen, buf);
1624 /* Exit OTP access mode */
1625 this->command(mtd, ONENAND_CMD_RESET, 0, 0);
1626 this->wait(mtd, FL_RESETING);
1632 * onenand_otp_walk - [DEFAULT] Handle OTP operation
1633 * @param mtd MTD device structure
1634 * @param from The offset to read/write
1635 * @param len number of bytes to read/write
1636 * @param retlen pointer to variable to store the number of read bytes
1637 * @param buf the databuffer to put/get data
1638 * @param action do given action
1639 * @param mode specify user and factory
1641 * Handle OTP operation.
1643 static int onenand_otp_walk(struct mtd_info *mtd, loff_t from, size_t len,
1644 size_t *retlen, u_char *buf,
1645 otp_op_t action, int mode)
1647 struct onenand_chip *this = mtd->priv;
1654 density = this->device_id >> ONENAND_DEVICE_DENSITY_SHIFT;
1655 if (density < ONENAND_DEVICE_DENSITY_512Mb)
1660 if (mode == MTD_OTP_FACTORY) {
1661 from += mtd->writesize * otp_pages;
1662 otp_pages = 64 - otp_pages;
1665 /* Check User/Factory boundary */
1666 if (((mtd->writesize * otp_pages) - (from + len)) < 0)
1669 while (len > 0 && otp_pages > 0) {
1670 if (!action) { /* OTP Info functions */
1671 struct otp_info *otpinfo;
1673 len -= sizeof(struct otp_info);
1677 otpinfo = (struct otp_info *) buf;
1678 otpinfo->start = from;
1679 otpinfo->length = mtd->writesize;
1680 otpinfo->locked = 0;
1682 from += mtd->writesize;
1683 buf += sizeof(struct otp_info);
1684 *retlen += sizeof(struct otp_info);
1689 ret = action(mtd, from, len, &tmp_retlen, buf);
1705 * onenand_get_fact_prot_info - [MTD Interface] Read factory OTP info
1706 * @param mtd MTD device structure
1707 * @param buf the databuffer to put/get data
1708 * @param len number of bytes to read
1710 * Read factory OTP info.
1712 static int onenand_get_fact_prot_info(struct mtd_info *mtd,
1713 struct otp_info *buf, size_t len)
1718 ret = onenand_otp_walk(mtd, 0, len, &retlen, (u_char *) buf, NULL, MTD_OTP_FACTORY);
1720 return ret ? : retlen;
1724 * onenand_read_fact_prot_reg - [MTD Interface] Read factory OTP area
1725 * @param mtd MTD device structure
1726 * @param from The offset to read
1727 * @param len number of bytes to read
1728 * @param retlen pointer to variable to store the number of read bytes
1729 * @param buf the databuffer to put/get data
1731 * Read factory OTP area.
1733 static int onenand_read_fact_prot_reg(struct mtd_info *mtd, loff_t from,
1734 size_t len, size_t *retlen, u_char *buf)
1736 return onenand_otp_walk(mtd, from, len, retlen, buf, do_otp_read, MTD_OTP_FACTORY);
1740 * onenand_get_user_prot_info - [MTD Interface] Read user OTP info
1741 * @param mtd MTD device structure
1742 * @param buf the databuffer to put/get data
1743 * @param len number of bytes to read
1745 * Read user OTP info.
1747 static int onenand_get_user_prot_info(struct mtd_info *mtd,
1748 struct otp_info *buf, size_t len)
1753 ret = onenand_otp_walk(mtd, 0, len, &retlen, (u_char *) buf, NULL, MTD_OTP_USER);
1755 return ret ? : retlen;
1759 * onenand_read_user_prot_reg - [MTD Interface] Read user OTP area
1760 * @param mtd MTD device structure
1761 * @param from The offset to read
1762 * @param len number of bytes to read
1763 * @param retlen pointer to variable to store the number of read bytes
1764 * @param buf the databuffer to put/get data
1766 * Read user OTP area.
1768 static int onenand_read_user_prot_reg(struct mtd_info *mtd, loff_t from,
1769 size_t len, size_t *retlen, u_char *buf)
1771 return onenand_otp_walk(mtd, from, len, retlen, buf, do_otp_read, MTD_OTP_USER);
1775 * onenand_write_user_prot_reg - [MTD Interface] Write user OTP area
1776 * @param mtd MTD device structure
1777 * @param from The offset to write
1778 * @param len number of bytes to write
1779 * @param retlen pointer to variable to store the number of write bytes
1780 * @param buf the databuffer to put/get data
1782 * Write user OTP area.
1784 static int onenand_write_user_prot_reg(struct mtd_info *mtd, loff_t from,
1785 size_t len, size_t *retlen, u_char *buf)
1787 return onenand_otp_walk(mtd, from, len, retlen, buf, do_otp_write, MTD_OTP_USER);
1791 * onenand_lock_user_prot_reg - [MTD Interface] Lock user OTP area
1792 * @param mtd MTD device structure
1793 * @param from The offset to lock
1794 * @param len number of bytes to unlock
1796 * Write lock mark on spare area in page 0 in OTP block
1798 static int onenand_lock_user_prot_reg(struct mtd_info *mtd, loff_t from,
1801 unsigned char oob_buf[64];
1805 memset(oob_buf, 0xff, mtd->oobsize);
1807 * Note: OTP lock operation
1808 * OTP block : 0xXXFC
1809 * 1st block : 0xXXF3 (If chip support)
1810 * Both : 0xXXF0 (If chip support)
1812 oob_buf[ONENAND_OTP_LOCK_OFFSET] = 0xFC;
1815 * Write lock mark to 8th word of sector0 of page0 of the spare0.
1816 * We write 16 bytes spare area instead of 2 bytes.
1821 ret = onenand_otp_walk(mtd, from, len, &retlen, oob_buf, do_otp_lock, MTD_OTP_USER);
1823 return ret ? : retlen;
1825 #endif /* CONFIG_MTD_ONENAND_OTP */
1828 * onenand_lock_scheme - Check and set OneNAND lock scheme
1829 * @param mtd MTD data structure
1831 * Check and set OneNAND lock scheme
1833 static void onenand_lock_scheme(struct mtd_info *mtd)
1835 struct onenand_chip *this = mtd->priv;
1836 unsigned int density, process;
1838 /* Lock scheme depends on density and process */
1839 density = this->device_id >> ONENAND_DEVICE_DENSITY_SHIFT;
1840 process = this->version_id >> ONENAND_VERSION_PROCESS_SHIFT;
1843 if (density >= ONENAND_DEVICE_DENSITY_1Gb) {
1844 /* A-Die has all block unlock */
1846 printk(KERN_DEBUG "Chip support all block unlock\n");
1847 this->options |= ONENAND_HAS_UNLOCK_ALL;
1850 /* Some OneNAND has continues lock scheme */
1852 printk(KERN_DEBUG "Lock scheme is Continues Lock\n");
1853 this->options |= ONENAND_HAS_CONT_LOCK;
1859 * onenand_print_device_info - Print device ID
1860 * @param device device ID
1864 static void onenand_print_device_info(int device, int version)
1866 int vcc, demuxed, ddp, density;
1868 vcc = device & ONENAND_DEVICE_VCC_MASK;
1869 demuxed = device & ONENAND_DEVICE_IS_DEMUX;
1870 ddp = device & ONENAND_DEVICE_IS_DDP;
1871 density = device >> ONENAND_DEVICE_DENSITY_SHIFT;
1872 printk(KERN_INFO "%sOneNAND%s %dMB %sV 16-bit (0x%02x)\n",
1873 demuxed ? "" : "Muxed ",
1876 vcc ? "2.65/3.3" : "1.8",
1878 printk(KERN_DEBUG "OneNAND version = 0x%04x\n", version);
1881 static const struct onenand_manufacturers onenand_manuf_ids[] = {
1882 {ONENAND_MFR_SAMSUNG, "Samsung"},
1886 * onenand_check_maf - Check manufacturer ID
1887 * @param manuf manufacturer ID
1889 * Check manufacturer ID
1891 static int onenand_check_maf(int manuf)
1893 int size = ARRAY_SIZE(onenand_manuf_ids);
1897 for (i = 0; i < size; i++)
1898 if (manuf == onenand_manuf_ids[i].id)
1902 name = onenand_manuf_ids[i].name;
1906 printk(KERN_DEBUG "OneNAND Manufacturer: %s (0x%0x)\n", name, manuf);
1912 * onenand_probe - [OneNAND Interface] Probe the OneNAND device
1913 * @param mtd MTD device structure
1915 * OneNAND detection method:
1916 * Compare the the values from command with ones from register
1918 static int onenand_probe(struct mtd_info *mtd)
1920 struct onenand_chip *this = mtd->priv;
1921 int bram_maf_id, bram_dev_id, maf_id, dev_id, ver_id;
1925 /* Save system configuration 1 */
1926 syscfg = this->read_word(this->base + ONENAND_REG_SYS_CFG1);
1927 /* Clear Sync. Burst Read mode to read BootRAM */
1928 this->write_word((syscfg & ~ONENAND_SYS_CFG1_SYNC_READ), this->base + ONENAND_REG_SYS_CFG1);
1930 /* Send the command for reading device ID from BootRAM */
1931 this->write_word(ONENAND_CMD_READID, this->base + ONENAND_BOOTRAM);
1933 /* Read manufacturer and device IDs from BootRAM */
1934 bram_maf_id = this->read_word(this->base + ONENAND_BOOTRAM + 0x0);
1935 bram_dev_id = this->read_word(this->base + ONENAND_BOOTRAM + 0x2);
1937 /* Reset OneNAND to read default register values */
1938 this->write_word(ONENAND_CMD_RESET, this->base + ONENAND_BOOTRAM);
1940 this->wait(mtd, FL_RESETING);
1942 /* Restore system configuration 1 */
1943 this->write_word(syscfg, this->base + ONENAND_REG_SYS_CFG1);
1945 /* Check manufacturer ID */
1946 if (onenand_check_maf(bram_maf_id))
1949 /* Read manufacturer and device IDs from Register */
1950 maf_id = this->read_word(this->base + ONENAND_REG_MANUFACTURER_ID);
1951 dev_id = this->read_word(this->base + ONENAND_REG_DEVICE_ID);
1952 ver_id = this->read_word(this->base + ONENAND_REG_VERSION_ID);
1954 /* Check OneNAND device */
1955 if (maf_id != bram_maf_id || dev_id != bram_dev_id)
1958 /* Flash device information */
1959 onenand_print_device_info(dev_id, ver_id);
1960 this->device_id = dev_id;
1961 this->version_id = ver_id;
1963 density = dev_id >> ONENAND_DEVICE_DENSITY_SHIFT;
1964 this->chipsize = (16 << density) << 20;
1965 /* Set density mask. it is used for DDP */
1966 this->density_mask = (1 << (density + 6));
1968 /* OneNAND page size & block size */
1969 /* The data buffer size is equal to page size */
1970 mtd->writesize = this->read_word(this->base + ONENAND_REG_DATA_BUFFER_SIZE);
1971 mtd->oobsize = mtd->writesize >> 5;
1972 /* Pagers per block is always 64 in OneNAND */
1973 mtd->erasesize = mtd->writesize << 6;
1975 this->erase_shift = ffs(mtd->erasesize) - 1;
1976 this->page_shift = ffs(mtd->writesize) - 1;
1977 this->ppb_shift = (this->erase_shift - this->page_shift);
1978 this->page_mask = (mtd->erasesize / mtd->writesize) - 1;
1980 /* REVIST: Multichip handling */
1982 mtd->size = this->chipsize;
1984 /* Check OneNAND lock scheme */
1985 onenand_lock_scheme(mtd);
1991 * onenand_suspend - [MTD Interface] Suspend the OneNAND flash
1992 * @param mtd MTD device structure
1994 static int onenand_suspend(struct mtd_info *mtd)
1996 return onenand_get_device(mtd, FL_PM_SUSPENDED);
2000 * onenand_resume - [MTD Interface] Resume the OneNAND flash
2001 * @param mtd MTD device structure
2003 static void onenand_resume(struct mtd_info *mtd)
2005 struct onenand_chip *this = mtd->priv;
2007 if (this->state == FL_PM_SUSPENDED)
2008 onenand_release_device(mtd);
2010 printk(KERN_ERR "resume() called for the chip which is not"
2011 "in suspended state\n");
2015 * onenand_scan - [OneNAND Interface] Scan for the OneNAND device
2016 * @param mtd MTD device structure
2017 * @param maxchips Number of chips to scan for
2019 * This fills out all the not initialized function pointers
2020 * with the defaults.
2021 * The flash ID is read and the mtd/chip structures are
2022 * filled with the appropriate values.
2024 int onenand_scan(struct mtd_info *mtd, int maxchips)
2026 struct onenand_chip *this = mtd->priv;
2028 if (!this->read_word)
2029 this->read_word = onenand_readw;
2030 if (!this->write_word)
2031 this->write_word = onenand_writew;
2034 this->command = onenand_command;
2036 onenand_setup_wait(mtd);
2038 if (!this->read_bufferram)
2039 this->read_bufferram = onenand_read_bufferram;
2040 if (!this->write_bufferram)
2041 this->write_bufferram = onenand_write_bufferram;
2043 if (!this->block_markbad)
2044 this->block_markbad = onenand_default_block_markbad;
2045 if (!this->scan_bbt)
2046 this->scan_bbt = onenand_default_bbt;
2048 if (onenand_probe(mtd))
2051 /* Set Sync. Burst Read after probing */
2052 if (this->mmcontrol) {
2053 printk(KERN_INFO "OneNAND Sync. Burst Read support\n");
2054 this->read_bufferram = onenand_sync_read_bufferram;
2057 /* Allocate buffers, if necessary */
2058 if (!this->page_buf) {
2060 len = mtd->writesize + mtd->oobsize;
2061 this->page_buf = kmalloc(len, GFP_KERNEL);
2062 if (!this->page_buf) {
2063 printk(KERN_ERR "onenand_scan(): Can't allocate page_buf\n");
2066 this->options |= ONENAND_PAGEBUF_ALLOC;
2069 this->state = FL_READY;
2070 init_waitqueue_head(&this->wq);
2071 spin_lock_init(&this->chip_lock);
2074 * Allow subpage writes up to oobsize.
2076 switch (mtd->oobsize) {
2078 this->ecclayout = &onenand_oob_64;
2079 mtd->subpage_sft = 2;
2083 this->ecclayout = &onenand_oob_32;
2084 mtd->subpage_sft = 1;
2088 printk(KERN_WARNING "No OOB scheme defined for oobsize %d\n",
2090 mtd->subpage_sft = 0;
2091 /* To prevent kernel oops */
2092 this->ecclayout = &onenand_oob_32;
2096 this->subpagesize = mtd->writesize >> mtd->subpage_sft;
2097 mtd->ecclayout = this->ecclayout;
2099 /* Fill in remaining MTD driver data */
2100 mtd->type = MTD_NANDFLASH;
2101 mtd->flags = MTD_CAP_NANDFLASH;
2102 mtd->ecctype = MTD_ECC_SW;
2103 mtd->erase = onenand_erase;
2105 mtd->unpoint = NULL;
2106 mtd->read = onenand_read;
2107 mtd->write = onenand_write;
2108 mtd->read_oob = onenand_read_oob;
2109 mtd->write_oob = onenand_write_oob;
2110 #ifdef CONFIG_MTD_ONENAND_OTP
2111 mtd->get_fact_prot_info = onenand_get_fact_prot_info;
2112 mtd->read_fact_prot_reg = onenand_read_fact_prot_reg;
2113 mtd->get_user_prot_info = onenand_get_user_prot_info;
2114 mtd->read_user_prot_reg = onenand_read_user_prot_reg;
2115 mtd->write_user_prot_reg = onenand_write_user_prot_reg;
2116 mtd->lock_user_prot_reg = onenand_lock_user_prot_reg;
2118 mtd->sync = onenand_sync;
2119 mtd->lock = onenand_lock;
2120 mtd->unlock = onenand_unlock;
2121 mtd->suspend = onenand_suspend;
2122 mtd->resume = onenand_resume;
2123 mtd->block_isbad = onenand_block_isbad;
2124 mtd->block_markbad = onenand_block_markbad;
2125 mtd->owner = THIS_MODULE;
2127 /* Unlock whole block */
2128 onenand_unlock_all(mtd);
2130 return this->scan_bbt(mtd);
2134 * onenand_release - [OneNAND Interface] Free resources held by the OneNAND device
2135 * @param mtd MTD device structure
2137 void onenand_release(struct mtd_info *mtd)
2139 struct onenand_chip *this = mtd->priv;
2141 #ifdef CONFIG_MTD_PARTITIONS
2142 /* Deregister partitions */
2143 del_mtd_partitions (mtd);
2145 /* Deregister the device */
2146 del_mtd_device (mtd);
2148 /* Free bad block table memory, if allocated */
2151 /* Buffer allocated by onenand_scan */
2152 if (this->options & ONENAND_PAGEBUF_ALLOC)
2153 kfree(this->page_buf);
2156 EXPORT_SYMBOL_GPL(onenand_scan);
2157 EXPORT_SYMBOL_GPL(onenand_release);
2159 MODULE_LICENSE("GPL");
2160 MODULE_AUTHOR("Kyungmin Park <kyungmin.park@samsung.com>");
2161 MODULE_DESCRIPTION("Generic OneNAND flash driver code");