2 * linux/drivers/mtd/onenand/onenand_base.c
4 * Copyright (C) 2005-2007 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 /* Device Flash Core select, NAND Flash Block Address */
98 if (block & this->density_mask)
99 return ONENAND_DDP_CHIP1 | (block ^ this->density_mask);
105 * onenand_bufferram_address - [DEFAULT] Get bufferram address
106 * @param this onenand chip data structure
107 * @param block the block
108 * @return set DBS value if DDP, otherwise 0
110 * Setup Start Address 2 Register (F101h) for DDP
112 static int onenand_bufferram_address(struct onenand_chip *this, int block)
114 /* Device BufferRAM Select */
115 if (block & this->density_mask)
116 return ONENAND_DDP_CHIP1;
118 return ONENAND_DDP_CHIP0;
122 * onenand_page_address - [DEFAULT] Get page address
123 * @param page the page address
124 * @param sector the sector address
125 * @return combined page and sector address
127 * Setup Start Address 8 Register (F107h)
129 static int onenand_page_address(int page, int sector)
131 /* Flash Page Address, Flash Sector Address */
134 fpa = page & ONENAND_FPA_MASK;
135 fsa = sector & ONENAND_FSA_MASK;
137 return ((fpa << ONENAND_FPA_SHIFT) | fsa);
141 * onenand_buffer_address - [DEFAULT] Get buffer address
142 * @param dataram1 DataRAM index
143 * @param sectors the sector address
144 * @param count the number of sectors
145 * @return the start buffer value
147 * Setup Start Buffer Register (F200h)
149 static int onenand_buffer_address(int dataram1, int sectors, int count)
153 /* BufferRAM Sector Address */
154 bsa = sectors & ONENAND_BSA_MASK;
157 bsa |= ONENAND_BSA_DATARAM1; /* DataRAM1 */
159 bsa |= ONENAND_BSA_DATARAM0; /* DataRAM0 */
161 /* BufferRAM Sector Count */
162 bsc = count & ONENAND_BSC_MASK;
164 return ((bsa << ONENAND_BSA_SHIFT) | bsc);
168 * onenand_command - [DEFAULT] Send command to OneNAND device
169 * @param mtd MTD device structure
170 * @param cmd the command to be sent
171 * @param addr offset to read from or write to
172 * @param len number of bytes to read or write
174 * Send command to OneNAND device. This function is used for middle/large page
175 * devices (1KB/2KB Bytes per page)
177 static int onenand_command(struct mtd_info *mtd, int cmd, loff_t addr, size_t len)
179 struct onenand_chip *this = mtd->priv;
180 int value, readcmd = 0, block_cmd = 0;
183 /* Address translation */
185 case ONENAND_CMD_UNLOCK:
186 case ONENAND_CMD_LOCK:
187 case ONENAND_CMD_LOCK_TIGHT:
188 case ONENAND_CMD_UNLOCK_ALL:
193 case ONENAND_CMD_ERASE:
194 case ONENAND_CMD_BUFFERRAM:
195 case ONENAND_CMD_OTP_ACCESS:
197 block = (int) (addr >> this->erase_shift);
202 block = (int) (addr >> this->erase_shift);
203 page = (int) (addr >> this->page_shift);
204 page &= this->page_mask;
208 /* NOTE: The setting order of the registers is very important! */
209 if (cmd == ONENAND_CMD_BUFFERRAM) {
210 /* Select DataRAM for DDP */
211 value = onenand_bufferram_address(this, block);
212 this->write_word(value, this->base + ONENAND_REG_START_ADDRESS2);
214 /* Switch to the next data buffer */
215 ONENAND_SET_NEXT_BUFFERRAM(this);
221 /* Write 'DFS, FBA' of Flash */
222 value = onenand_block_address(this, block);
223 this->write_word(value, this->base + ONENAND_REG_START_ADDRESS1);
226 /* Select DataRAM for DDP */
227 value = onenand_bufferram_address(this, block);
228 this->write_word(value, this->base + ONENAND_REG_START_ADDRESS2);
233 /* Now we use page size operation */
234 int sectors = 4, count = 4;
238 case ONENAND_CMD_READ:
239 case ONENAND_CMD_READOOB:
240 dataram = ONENAND_SET_NEXT_BUFFERRAM(this);
245 dataram = ONENAND_CURRENT_BUFFERRAM(this);
249 /* Write 'FPA, FSA' of Flash */
250 value = onenand_page_address(page, sectors);
251 this->write_word(value, this->base + ONENAND_REG_START_ADDRESS8);
253 /* Write 'BSA, BSC' of DataRAM */
254 value = onenand_buffer_address(dataram, sectors, count);
255 this->write_word(value, this->base + ONENAND_REG_START_BUFFER);
258 /* Select DataRAM for DDP */
259 value = onenand_bufferram_address(this, block);
260 this->write_word(value, this->base + ONENAND_REG_START_ADDRESS2);
264 /* Interrupt clear */
265 this->write_word(ONENAND_INT_CLEAR, this->base + ONENAND_REG_INTERRUPT);
268 this->write_word(cmd, this->base + ONENAND_REG_COMMAND);
274 * onenand_wait - [DEFAULT] wait until the command is done
275 * @param mtd MTD device structure
276 * @param state state to select the max. timeout value
278 * Wait for command done. This applies to all OneNAND command
279 * Read can take up to 30us, erase up to 2ms and program up to 350us
280 * according to general OneNAND specs
282 static int onenand_wait(struct mtd_info *mtd, int state)
284 struct onenand_chip * this = mtd->priv;
285 unsigned long timeout;
286 unsigned int flags = ONENAND_INT_MASTER;
287 unsigned int interrupt = 0;
290 /* The 20 msec is enough */
291 timeout = jiffies + msecs_to_jiffies(20);
292 while (time_before(jiffies, timeout)) {
293 interrupt = this->read_word(this->base + ONENAND_REG_INTERRUPT);
295 if (interrupt & flags)
298 if (state != FL_READING)
301 /* To get correct interrupt status in timeout case */
302 interrupt = this->read_word(this->base + ONENAND_REG_INTERRUPT);
304 ctrl = this->read_word(this->base + ONENAND_REG_CTRL_STATUS);
306 if (ctrl & ONENAND_CTRL_ERROR) {
307 printk(KERN_ERR "onenand_wait: controller error = 0x%04x\n", ctrl);
308 if (ctrl & ONENAND_CTRL_LOCK)
309 printk(KERN_ERR "onenand_wait: it's locked error.\n");
313 if (interrupt & ONENAND_INT_READ) {
314 int ecc = this->read_word(this->base + ONENAND_REG_ECC_STATUS);
316 printk(KERN_ERR "onenand_wait: ECC error = 0x%04x\n", ecc);
317 if (ecc & ONENAND_ECC_2BIT_ALL) {
318 mtd->ecc_stats.failed++;
320 } else if (ecc & ONENAND_ECC_1BIT_ALL)
321 mtd->ecc_stats.corrected++;
323 } else if (state == FL_READING) {
324 printk(KERN_ERR "onenand_wait: read timeout! ctrl=0x%04x intr=0x%04x\n", ctrl, interrupt);
332 * onenand_interrupt - [DEFAULT] onenand interrupt handler
333 * @param irq onenand interrupt number
334 * @param dev_id interrupt data
338 static irqreturn_t onenand_interrupt(int irq, void *data)
340 struct onenand_chip *this = (struct onenand_chip *) data;
342 /* To handle shared interrupt */
343 if (!this->complete.done)
344 complete(&this->complete);
350 * onenand_interrupt_wait - [DEFAULT] wait until the command is done
351 * @param mtd MTD device structure
352 * @param state state to select the max. timeout value
354 * Wait for command done.
356 static int onenand_interrupt_wait(struct mtd_info *mtd, int state)
358 struct onenand_chip *this = mtd->priv;
360 wait_for_completion(&this->complete);
362 return onenand_wait(mtd, state);
366 * onenand_try_interrupt_wait - [DEFAULT] try interrupt wait
367 * @param mtd MTD device structure
368 * @param state state to select the max. timeout value
370 * Try interrupt based wait (It is used one-time)
372 static int onenand_try_interrupt_wait(struct mtd_info *mtd, int state)
374 struct onenand_chip *this = mtd->priv;
375 unsigned long remain, timeout;
377 /* We use interrupt wait first */
378 this->wait = onenand_interrupt_wait;
380 timeout = msecs_to_jiffies(100);
381 remain = wait_for_completion_timeout(&this->complete, timeout);
383 printk(KERN_INFO "OneNAND: There's no interrupt. "
384 "We use the normal wait\n");
386 /* Release the irq */
387 free_irq(this->irq, this);
389 this->wait = onenand_wait;
392 return onenand_wait(mtd, state);
396 * onenand_setup_wait - [OneNAND Interface] setup onenand wait method
397 * @param mtd MTD device structure
399 * There's two method to wait onenand work
400 * 1. polling - read interrupt status register
401 * 2. interrupt - use the kernel interrupt method
403 static void onenand_setup_wait(struct mtd_info *mtd)
405 struct onenand_chip *this = mtd->priv;
408 init_completion(&this->complete);
410 if (this->irq <= 0) {
411 this->wait = onenand_wait;
415 if (request_irq(this->irq, &onenand_interrupt,
416 IRQF_SHARED, "onenand", this)) {
417 /* If we can't get irq, use the normal wait */
418 this->wait = onenand_wait;
422 /* Enable interrupt */
423 syscfg = this->read_word(this->base + ONENAND_REG_SYS_CFG1);
424 syscfg |= ONENAND_SYS_CFG1_IOBE;
425 this->write_word(syscfg, this->base + ONENAND_REG_SYS_CFG1);
427 this->wait = onenand_try_interrupt_wait;
431 * onenand_bufferram_offset - [DEFAULT] BufferRAM offset
432 * @param mtd MTD data structure
433 * @param area BufferRAM area
434 * @return offset given area
436 * Return BufferRAM offset given area
438 static inline int onenand_bufferram_offset(struct mtd_info *mtd, int area)
440 struct onenand_chip *this = mtd->priv;
442 if (ONENAND_CURRENT_BUFFERRAM(this)) {
443 if (area == ONENAND_DATARAM)
444 return mtd->writesize;
445 if (area == ONENAND_SPARERAM)
453 * onenand_read_bufferram - [OneNAND Interface] Read the bufferram area
454 * @param mtd MTD data structure
455 * @param area BufferRAM area
456 * @param buffer the databuffer to put/get data
457 * @param offset offset to read from or write to
458 * @param count number of bytes to read/write
460 * Read the BufferRAM area
462 static int onenand_read_bufferram(struct mtd_info *mtd, int area,
463 unsigned char *buffer, int offset, size_t count)
465 struct onenand_chip *this = mtd->priv;
466 void __iomem *bufferram;
468 bufferram = this->base + area;
470 bufferram += onenand_bufferram_offset(mtd, area);
472 if (ONENAND_CHECK_BYTE_ACCESS(count)) {
475 /* Align with word(16-bit) size */
478 /* Read word and save byte */
479 word = this->read_word(bufferram + offset + count);
480 buffer[count] = (word & 0xff);
483 memcpy(buffer, bufferram + offset, count);
489 * onenand_sync_read_bufferram - [OneNAND Interface] Read the bufferram area with Sync. Burst mode
490 * @param mtd MTD data structure
491 * @param area BufferRAM area
492 * @param buffer the databuffer to put/get data
493 * @param offset offset to read from or write to
494 * @param count number of bytes to read/write
496 * Read the BufferRAM area with Sync. Burst Mode
498 static int onenand_sync_read_bufferram(struct mtd_info *mtd, int area,
499 unsigned char *buffer, int offset, size_t count)
501 struct onenand_chip *this = mtd->priv;
502 void __iomem *bufferram;
504 bufferram = this->base + area;
506 bufferram += onenand_bufferram_offset(mtd, area);
508 this->mmcontrol(mtd, ONENAND_SYS_CFG1_SYNC_READ);
510 if (ONENAND_CHECK_BYTE_ACCESS(count)) {
513 /* Align with word(16-bit) size */
516 /* Read word and save byte */
517 word = this->read_word(bufferram + offset + count);
518 buffer[count] = (word & 0xff);
521 memcpy(buffer, bufferram + offset, count);
523 this->mmcontrol(mtd, 0);
529 * onenand_write_bufferram - [OneNAND Interface] Write the bufferram area
530 * @param mtd MTD data structure
531 * @param area BufferRAM area
532 * @param buffer the databuffer to put/get data
533 * @param offset offset to read from or write to
534 * @param count number of bytes to read/write
536 * Write the BufferRAM area
538 static int onenand_write_bufferram(struct mtd_info *mtd, int area,
539 const unsigned char *buffer, int offset, size_t count)
541 struct onenand_chip *this = mtd->priv;
542 void __iomem *bufferram;
544 bufferram = this->base + area;
546 bufferram += onenand_bufferram_offset(mtd, area);
548 if (ONENAND_CHECK_BYTE_ACCESS(count)) {
552 /* Align with word(16-bit) size */
555 /* Calculate byte access offset */
556 byte_offset = offset + count;
558 /* Read word and save byte */
559 word = this->read_word(bufferram + byte_offset);
560 word = (word & ~0xff) | buffer[count];
561 this->write_word(word, bufferram + byte_offset);
564 memcpy(bufferram + offset, buffer, count);
570 * onenand_check_bufferram - [GENERIC] Check BufferRAM information
571 * @param mtd MTD data structure
572 * @param addr address to check
573 * @return 1 if there are valid data, otherwise 0
575 * Check bufferram if there is data we required
577 static int onenand_check_bufferram(struct mtd_info *mtd, loff_t addr)
579 struct onenand_chip *this = mtd->priv;
580 int blockpage, found = 0;
583 blockpage = (int) (addr >> this->page_shift);
585 /* Is there valid data? */
586 i = ONENAND_CURRENT_BUFFERRAM(this);
587 if (this->bufferram[i].blockpage == blockpage)
590 /* Check another BufferRAM */
591 i = ONENAND_NEXT_BUFFERRAM(this);
592 if (this->bufferram[i].blockpage == blockpage) {
593 ONENAND_SET_NEXT_BUFFERRAM(this);
598 if (found && ONENAND_IS_DDP(this)) {
599 /* Select DataRAM for DDP */
600 int block = (int) (addr >> this->erase_shift);
601 int value = onenand_bufferram_address(this, block);
602 this->write_word(value, this->base + ONENAND_REG_START_ADDRESS2);
609 * onenand_update_bufferram - [GENERIC] Update BufferRAM information
610 * @param mtd MTD data structure
611 * @param addr address to update
612 * @param valid valid flag
614 * Update BufferRAM information
616 static void onenand_update_bufferram(struct mtd_info *mtd, loff_t addr,
619 struct onenand_chip *this = mtd->priv;
623 blockpage = (int) (addr >> this->page_shift);
625 /* Invalidate another BufferRAM */
626 i = ONENAND_NEXT_BUFFERRAM(this);
627 if (this->bufferram[i].blockpage == blockpage)
628 this->bufferram[i].blockpage = -1;
630 /* Update BufferRAM */
631 i = ONENAND_CURRENT_BUFFERRAM(this);
633 this->bufferram[i].blockpage = blockpage;
635 this->bufferram[i].blockpage = -1;
639 * onenand_invalidate_bufferram - [GENERIC] Invalidate BufferRAM information
640 * @param mtd MTD data structure
641 * @param addr start address to invalidate
642 * @param len length to invalidate
644 * Invalidate BufferRAM information
646 static void onenand_invalidate_bufferram(struct mtd_info *mtd, loff_t addr,
649 struct onenand_chip *this = mtd->priv;
651 loff_t end_addr = addr + len;
653 /* Invalidate BufferRAM */
654 for (i = 0; i < MAX_BUFFERRAM; i++) {
655 loff_t buf_addr = this->bufferram[i].blockpage << this->page_shift;
656 if (buf_addr >= addr && buf_addr < end_addr)
657 this->bufferram[i].blockpage = -1;
662 * onenand_get_device - [GENERIC] Get chip for selected access
663 * @param mtd MTD device structure
664 * @param new_state the state which is requested
666 * Get the device and lock it for exclusive access
668 static int onenand_get_device(struct mtd_info *mtd, int new_state)
670 struct onenand_chip *this = mtd->priv;
671 DECLARE_WAITQUEUE(wait, current);
674 * Grab the lock and see if the device is available
677 spin_lock(&this->chip_lock);
678 if (this->state == FL_READY) {
679 this->state = new_state;
680 spin_unlock(&this->chip_lock);
683 if (new_state == FL_PM_SUSPENDED) {
684 spin_unlock(&this->chip_lock);
685 return (this->state == FL_PM_SUSPENDED) ? 0 : -EAGAIN;
687 set_current_state(TASK_UNINTERRUPTIBLE);
688 add_wait_queue(&this->wq, &wait);
689 spin_unlock(&this->chip_lock);
691 remove_wait_queue(&this->wq, &wait);
698 * onenand_release_device - [GENERIC] release chip
699 * @param mtd MTD device structure
701 * Deselect, release chip lock and wake up anyone waiting on the device
703 static void onenand_release_device(struct mtd_info *mtd)
705 struct onenand_chip *this = mtd->priv;
707 /* Release the chip */
708 spin_lock(&this->chip_lock);
709 this->state = FL_READY;
711 spin_unlock(&this->chip_lock);
715 * onenand_read - [MTD Interface] Read data from flash
716 * @param mtd MTD device structure
717 * @param from offset to read from
718 * @param len number of bytes to read
719 * @param retlen pointer to variable to store the number of read bytes
720 * @param buf the databuffer to put data
724 static int onenand_read(struct mtd_info *mtd, loff_t from, size_t len,
725 size_t *retlen, u_char *buf)
727 struct onenand_chip *this = mtd->priv;
728 struct mtd_ecc_stats stats;
729 int read = 0, column;
731 int ret = 0, boundary = 0;
733 DEBUG(MTD_DEBUG_LEVEL3, "onenand_read: from = 0x%08x, len = %i\n", (unsigned int) from, (int) len);
735 /* Do not allow reads past end of device */
736 if ((from + len) > mtd->size) {
737 printk(KERN_ERR "onenand_read: Attempt read beyond end of device\n");
742 /* Grab the lock and see if the device is available */
743 onenand_get_device(mtd, FL_READING);
745 stats = mtd->ecc_stats;
747 /* Read-while-load method */
749 /* Do first load to bufferRAM */
751 if (!onenand_check_bufferram(mtd, from)) {
752 this->command(mtd, ONENAND_CMD_READ, from, mtd->writesize);
753 ret = this->wait(mtd, FL_READING);
754 onenand_update_bufferram(mtd, from, !ret);
758 thislen = min_t(int, mtd->writesize, len - read);
759 column = from & (mtd->writesize - 1);
760 if (column + thislen > mtd->writesize)
761 thislen = mtd->writesize - column;
764 /* If there is more to load then start next load */
766 if (read + thislen < len) {
767 this->command(mtd, ONENAND_CMD_READ, from, mtd->writesize);
769 * Chip boundary handling in DDP
770 * Now we issued chip 1 read and pointed chip 1
771 * bufferam so we have to point chip 0 bufferam.
773 if (ONENAND_IS_DDP(this) &&
774 unlikely(from == (this->chipsize >> 1))) {
775 this->write_word(ONENAND_DDP_CHIP0, this->base + ONENAND_REG_START_ADDRESS2);
779 ONENAND_SET_PREV_BUFFERRAM(this);
781 /* While load is going, read from last bufferRAM */
782 this->read_bufferram(mtd, ONENAND_DATARAM, buf, column, thislen);
783 /* See if we are done */
787 /* Set up for next read from bufferRAM */
788 if (unlikely(boundary))
789 this->write_word(ONENAND_DDP_CHIP1, this->base + ONENAND_REG_START_ADDRESS2);
790 ONENAND_SET_NEXT_BUFFERRAM(this);
792 thislen = min_t(int, mtd->writesize, len - read);
795 /* Now wait for load */
796 ret = this->wait(mtd, FL_READING);
797 onenand_update_bufferram(mtd, from, !ret);
800 /* Deselect and wake up anyone waiting on the device */
801 onenand_release_device(mtd);
804 * Return success, if no ECC failures, else -EBADMSG
805 * fs driver will take care of that, because
806 * retlen == desired len and result == -EBADMSG
810 if (mtd->ecc_stats.failed - stats.failed)
816 return mtd->ecc_stats.corrected - stats.corrected ? -EUCLEAN : 0;
820 * onenand_transfer_auto_oob - [Internal] oob auto-placement transfer
821 * @param mtd MTD device structure
822 * @param buf destination address
823 * @param column oob offset to read from
824 * @param thislen oob length to read
826 static int onenand_transfer_auto_oob(struct mtd_info *mtd, uint8_t *buf, int column,
829 struct onenand_chip *this = mtd->priv;
830 struct nand_oobfree *free;
831 int readcol = column;
832 int readend = column + thislen;
834 uint8_t *oob_buf = this->page_buf + mtd->writesize;
836 for (free = this->ecclayout->oobfree; free->length; ++free) {
837 if (readcol >= lastgap)
838 readcol += free->offset - lastgap;
839 if (readend >= lastgap)
840 readend += free->offset - lastgap;
841 lastgap = free->offset + free->length;
843 this->read_bufferram(mtd, ONENAND_SPARERAM, oob_buf, 0, mtd->oobsize);
844 for (free = this->ecclayout->oobfree; free->length; ++free) {
845 int free_end = free->offset + free->length;
846 if (free->offset < readend && free_end > readcol) {
847 int st = max_t(int,free->offset,readcol);
848 int ed = min_t(int,free_end,readend);
850 memcpy(buf, oob_buf + st, n);
858 * onenand_do_read_oob - [MTD Interface] OneNAND read out-of-band
859 * @param mtd MTD device structure
860 * @param from offset to read from
861 * @param len number of bytes to read
862 * @param retlen pointer to variable to store the number of read bytes
863 * @param buf the databuffer to put data
864 * @param mode operation mode
866 * OneNAND read out-of-band data from the spare area
868 static int onenand_do_read_oob(struct mtd_info *mtd, loff_t from, size_t len,
869 size_t *retlen, u_char *buf, mtd_oob_mode_t mode)
871 struct onenand_chip *this = mtd->priv;
872 int read = 0, thislen, column, oobsize;
875 DEBUG(MTD_DEBUG_LEVEL3, "onenand_read_oob: from = 0x%08x, len = %i\n", (unsigned int) from, (int) len);
877 /* Initialize return length value */
880 if (mode == MTD_OOB_AUTO)
881 oobsize = this->ecclayout->oobavail;
883 oobsize = mtd->oobsize;
885 column = from & (mtd->oobsize - 1);
887 if (unlikely(column >= oobsize)) {
888 printk(KERN_ERR "onenand_read_oob: Attempted to start read outside oob\n");
892 /* Do not allow reads past end of device */
893 if (unlikely(from >= mtd->size ||
894 column + len > ((mtd->size >> this->page_shift) -
895 (from >> this->page_shift)) * oobsize)) {
896 printk(KERN_ERR "onenand_read_oob: Attempted to read beyond end of device\n");
900 /* Grab the lock and see if the device is available */
901 onenand_get_device(mtd, FL_READING);
906 thislen = oobsize - column;
907 thislen = min_t(int, thislen, len);
909 this->command(mtd, ONENAND_CMD_READOOB, from, mtd->oobsize);
911 onenand_update_bufferram(mtd, from, 0);
913 ret = this->wait(mtd, FL_READING);
914 /* First copy data and check return value for ECC handling */
916 if (mode == MTD_OOB_AUTO)
917 onenand_transfer_auto_oob(mtd, buf, column, thislen);
919 this->read_bufferram(mtd, ONENAND_SPARERAM, buf, column, thislen);
922 printk(KERN_ERR "onenand_read_oob: read failed = 0x%x\n", ret);
936 from += mtd->writesize;
941 /* Deselect and wake up anyone waiting on the device */
942 onenand_release_device(mtd);
949 * onenand_read_oob - [MTD Interface] NAND write data and/or out-of-band
950 * @param mtd: MTD device structure
951 * @param from: offset to read from
952 * @param ops: oob operation description structure
954 static int onenand_read_oob(struct mtd_info *mtd, loff_t from,
955 struct mtd_oob_ops *ops)
962 /* Not implemented yet */
966 return onenand_do_read_oob(mtd, from + ops->ooboffs, ops->ooblen,
967 &ops->oobretlen, ops->oobbuf, ops->mode);
971 * onenand_bbt_wait - [DEFAULT] wait until the command is done
972 * @param mtd MTD device structure
973 * @param state state to select the max. timeout value
975 * Wait for command done.
977 static int onenand_bbt_wait(struct mtd_info *mtd, int state)
979 struct onenand_chip *this = mtd->priv;
980 unsigned long timeout;
981 unsigned int interrupt;
984 /* The 20 msec is enough */
985 timeout = jiffies + msecs_to_jiffies(20);
986 while (time_before(jiffies, timeout)) {
987 interrupt = this->read_word(this->base + ONENAND_REG_INTERRUPT);
988 if (interrupt & ONENAND_INT_MASTER)
991 /* To get correct interrupt status in timeout case */
992 interrupt = this->read_word(this->base + ONENAND_REG_INTERRUPT);
993 ctrl = this->read_word(this->base + ONENAND_REG_CTRL_STATUS);
995 if (ctrl & ONENAND_CTRL_ERROR) {
996 printk(KERN_DEBUG "onenand_bbt_wait: controller error = 0x%04x\n", ctrl);
997 /* Initial bad block case */
998 if (ctrl & ONENAND_CTRL_LOAD)
999 return ONENAND_BBT_READ_ERROR;
1000 return ONENAND_BBT_READ_FATAL_ERROR;
1003 if (interrupt & ONENAND_INT_READ) {
1004 int ecc = this->read_word(this->base + ONENAND_REG_ECC_STATUS);
1005 if (ecc & ONENAND_ECC_2BIT_ALL)
1006 return ONENAND_BBT_READ_ERROR;
1008 printk(KERN_ERR "onenand_bbt_wait: read timeout!"
1009 "ctrl=0x%04x intr=0x%04x\n", ctrl, interrupt);
1010 return ONENAND_BBT_READ_FATAL_ERROR;
1017 * onenand_bbt_read_oob - [MTD Interface] OneNAND read out-of-band for bbt scan
1018 * @param mtd MTD device structure
1019 * @param from offset to read from
1020 * @param ops oob operation description structure
1022 * OneNAND read out-of-band data from the spare area for bbt scan
1024 int onenand_bbt_read_oob(struct mtd_info *mtd, loff_t from,
1025 struct mtd_oob_ops *ops)
1027 struct onenand_chip *this = mtd->priv;
1028 int read = 0, thislen, column;
1030 size_t len = ops->ooblen;
1031 u_char *buf = ops->oobbuf;
1033 DEBUG(MTD_DEBUG_LEVEL3, "onenand_bbt_read_oob: from = 0x%08x, len = %zi\n", (unsigned int) from, len);
1035 /* Initialize return value */
1038 /* Do not allow reads past end of device */
1039 if (unlikely((from + len) > mtd->size)) {
1040 printk(KERN_ERR "onenand_bbt_read_oob: Attempt read beyond end of device\n");
1041 return ONENAND_BBT_READ_FATAL_ERROR;
1044 /* Grab the lock and see if the device is available */
1045 onenand_get_device(mtd, FL_READING);
1047 column = from & (mtd->oobsize - 1);
1049 while (read < len) {
1052 thislen = mtd->oobsize - column;
1053 thislen = min_t(int, thislen, len);
1055 this->command(mtd, ONENAND_CMD_READOOB, from, mtd->oobsize);
1057 onenand_update_bufferram(mtd, from, 0);
1059 ret = onenand_bbt_wait(mtd, FL_READING);
1063 this->read_bufferram(mtd, ONENAND_SPARERAM, buf, column, thislen);
1072 /* Update Page size */
1073 from += mtd->writesize;
1078 /* Deselect and wake up anyone waiting on the device */
1079 onenand_release_device(mtd);
1081 ops->oobretlen = read;
1085 #ifdef CONFIG_MTD_ONENAND_VERIFY_WRITE
1087 * onenand_verify_oob - [GENERIC] verify the oob contents after a write
1088 * @param mtd MTD device structure
1089 * @param buf the databuffer to verify
1090 * @param to offset to read from
1093 static int onenand_verify_oob(struct mtd_info *mtd, const u_char *buf, loff_t to)
1095 struct onenand_chip *this = mtd->priv;
1099 this->command(mtd, ONENAND_CMD_READOOB, to, mtd->oobsize);
1100 onenand_update_bufferram(mtd, to, 0);
1101 status = this->wait(mtd, FL_READING);
1105 this->read_bufferram(mtd, ONENAND_SPARERAM, oobbuf, 0, mtd->oobsize);
1106 for (i = 0; i < mtd->oobsize; i++)
1107 if (buf[i] != 0xFF && buf[i] != oobbuf[i])
1114 * onenand_verify - [GENERIC] verify the chip contents after a write
1115 * @param mtd MTD device structure
1116 * @param buf the databuffer to verify
1117 * @param addr offset to read from
1118 * @param len number of bytes to read and compare
1121 static int onenand_verify(struct mtd_info *mtd, const u_char *buf, loff_t addr, size_t len)
1123 struct onenand_chip *this = mtd->priv;
1124 void __iomem *dataram;
1126 int thislen, column;
1129 thislen = min_t(int, mtd->writesize, len);
1130 column = addr & (mtd->writesize - 1);
1131 if (column + thislen > mtd->writesize)
1132 thislen = mtd->writesize - column;
1134 this->command(mtd, ONENAND_CMD_READ, addr, mtd->writesize);
1136 onenand_update_bufferram(mtd, addr, 0);
1138 ret = this->wait(mtd, FL_READING);
1142 onenand_update_bufferram(mtd, addr, 1);
1144 dataram = this->base + ONENAND_DATARAM;
1145 dataram += onenand_bufferram_offset(mtd, ONENAND_DATARAM);
1147 if (memcmp(buf, dataram + column, thislen))
1158 #define onenand_verify(...) (0)
1159 #define onenand_verify_oob(...) (0)
1162 #define NOTALIGNED(x) ((x & (this->subpagesize - 1)) != 0)
1165 * onenand_write - [MTD Interface] write buffer to FLASH
1166 * @param mtd MTD device structure
1167 * @param to offset to write to
1168 * @param len number of bytes to write
1169 * @param retlen pointer to variable to store the number of written bytes
1170 * @param buf the data to write
1174 static int onenand_write(struct mtd_info *mtd, loff_t to, size_t len,
1175 size_t *retlen, const u_char *buf)
1177 struct onenand_chip *this = mtd->priv;
1180 int column, subpage;
1182 DEBUG(MTD_DEBUG_LEVEL3, "onenand_write: to = 0x%08x, len = %i\n", (unsigned int) to, (int) len);
1184 /* Initialize retlen, in case of early exit */
1187 /* Do not allow writes past end of device */
1188 if (unlikely((to + len) > mtd->size)) {
1189 printk(KERN_ERR "onenand_write: Attempt write to past end of device\n");
1193 /* Reject writes, which are not page aligned */
1194 if (unlikely(NOTALIGNED(to)) || unlikely(NOTALIGNED(len))) {
1195 printk(KERN_ERR "onenand_write: Attempt to write not page aligned data\n");
1199 column = to & (mtd->writesize - 1);
1201 /* Grab the lock and see if the device is available */
1202 onenand_get_device(mtd, FL_WRITING);
1204 /* Loop until all data write */
1205 while (written < len) {
1206 int thislen = min_t(int, mtd->writesize - column, len - written);
1207 u_char *wbuf = (u_char *) buf;
1211 this->command(mtd, ONENAND_CMD_BUFFERRAM, to, thislen);
1213 /* Partial page write */
1214 subpage = thislen < mtd->writesize;
1216 memset(this->page_buf, 0xff, mtd->writesize);
1217 memcpy(this->page_buf + column, buf, thislen);
1218 wbuf = this->page_buf;
1221 this->write_bufferram(mtd, ONENAND_DATARAM, wbuf, 0, mtd->writesize);
1222 this->write_bufferram(mtd, ONENAND_SPARERAM, ffchars, 0, mtd->oobsize);
1224 this->command(mtd, ONENAND_CMD_PROG, to, mtd->writesize);
1226 ret = this->wait(mtd, FL_WRITING);
1228 /* In partial page write we don't update bufferram */
1229 onenand_update_bufferram(mtd, to, !ret && !subpage);
1232 printk(KERN_ERR "onenand_write: write filaed %d\n", ret);
1236 /* Only check verify write turn on */
1237 ret = onenand_verify(mtd, (u_char *) wbuf, to, thislen);
1239 printk(KERN_ERR "onenand_write: verify failed %d\n", ret);
1253 /* Deselect and wake up anyone waiting on the device */
1254 onenand_release_device(mtd);
1262 * onenand_fill_auto_oob - [Internal] oob auto-placement transfer
1263 * @param mtd MTD device structure
1264 * @param oob_buf oob buffer
1265 * @param buf source address
1266 * @param column oob offset to write to
1267 * @param thislen oob length to write
1269 static int onenand_fill_auto_oob(struct mtd_info *mtd, u_char *oob_buf,
1270 const u_char *buf, int column, int thislen)
1272 struct onenand_chip *this = mtd->priv;
1273 struct nand_oobfree *free;
1274 int writecol = column;
1275 int writeend = column + thislen;
1278 for (free = this->ecclayout->oobfree; free->length; ++free) {
1279 if (writecol >= lastgap)
1280 writecol += free->offset - lastgap;
1281 if (writeend >= lastgap)
1282 writeend += free->offset - lastgap;
1283 lastgap = free->offset + free->length;
1285 for (free = this->ecclayout->oobfree; free->length; ++free) {
1286 int free_end = free->offset + free->length;
1287 if (free->offset < writeend && free_end > writecol) {
1288 int st = max_t(int,free->offset,writecol);
1289 int ed = min_t(int,free_end,writeend);
1291 memcpy(oob_buf + st, buf, n);
1299 * onenand_do_write_oob - [Internal] OneNAND write out-of-band
1300 * @param mtd MTD device structure
1301 * @param to offset to write to
1302 * @param len number of bytes to write
1303 * @param retlen pointer to variable to store the number of written bytes
1304 * @param buf the data to write
1305 * @param mode operation mode
1307 * OneNAND write out-of-band
1309 static int onenand_do_write_oob(struct mtd_info *mtd, loff_t to, size_t len,
1310 size_t *retlen, const u_char *buf, mtd_oob_mode_t mode)
1312 struct onenand_chip *this = mtd->priv;
1313 int column, ret = 0, oobsize;
1317 DEBUG(MTD_DEBUG_LEVEL3, "onenand_write_oob: to = 0x%08x, len = %i\n", (unsigned int) to, (int) len);
1319 /* Initialize retlen, in case of early exit */
1322 if (mode == MTD_OOB_AUTO)
1323 oobsize = this->ecclayout->oobavail;
1325 oobsize = mtd->oobsize;
1327 column = to & (mtd->oobsize - 1);
1329 if (unlikely(column >= oobsize)) {
1330 printk(KERN_ERR "onenand_write_oob: Attempted to start write outside oob\n");
1334 /* For compatibility with NAND: Do not allow write past end of page */
1335 if (unlikely(column + len > oobsize)) {
1336 printk(KERN_ERR "onenand_write_oob: "
1337 "Attempt to write past end of page\n");
1341 /* Do not allow reads past end of device */
1342 if (unlikely(to >= mtd->size ||
1343 column + len > ((mtd->size >> this->page_shift) -
1344 (to >> this->page_shift)) * oobsize)) {
1345 printk(KERN_ERR "onenand_write_oob: Attempted to write past end of device\n");
1349 /* Grab the lock and see if the device is available */
1350 onenand_get_device(mtd, FL_WRITING);
1352 oobbuf = this->page_buf + mtd->writesize;
1354 /* Loop until all data write */
1355 while (written < len) {
1356 int thislen = min_t(int, oobsize, len - written);
1360 this->command(mtd, ONENAND_CMD_BUFFERRAM, to, mtd->oobsize);
1362 /* We send data to spare ram with oobsize
1363 * to prevent byte access */
1364 memset(oobbuf, 0xff, mtd->oobsize);
1365 if (mode == MTD_OOB_AUTO)
1366 onenand_fill_auto_oob(mtd, oobbuf, buf, column, thislen);
1368 memcpy(oobbuf + column, buf, thislen);
1369 this->write_bufferram(mtd, ONENAND_SPARERAM, oobbuf, 0, mtd->oobsize);
1371 this->command(mtd, ONENAND_CMD_PROGOOB, to, mtd->oobsize);
1373 onenand_update_bufferram(mtd, to, 0);
1375 ret = this->wait(mtd, FL_WRITING);
1377 printk(KERN_ERR "onenand_write_oob: write failed %d\n", ret);
1381 ret = onenand_verify_oob(mtd, oobbuf, to);
1383 printk(KERN_ERR "onenand_write_oob: verify failed %d\n", ret);
1391 to += mtd->writesize;
1396 /* Deselect and wake up anyone waiting on the device */
1397 onenand_release_device(mtd);
1405 * onenand_write_oob - [MTD Interface] NAND write data and/or out-of-band
1406 * @param mtd: MTD device structure
1407 * @param to: offset to write
1408 * @param ops: oob operation description structure
1410 static int onenand_write_oob(struct mtd_info *mtd, loff_t to,
1411 struct mtd_oob_ops *ops)
1413 switch (ops->mode) {
1418 /* Not implemented yet */
1422 return onenand_do_write_oob(mtd, to + ops->ooboffs, ops->ooblen,
1423 &ops->oobretlen, ops->oobbuf, ops->mode);
1427 * onenand_block_checkbad - [GENERIC] Check if a block is marked bad
1428 * @param mtd MTD device structure
1429 * @param ofs offset from device start
1430 * @param getchip 0, if the chip is already selected
1431 * @param allowbbt 1, if its allowed to access the bbt area
1433 * Check, if the block is bad. Either by reading the bad block table or
1434 * calling of the scan function.
1436 static int onenand_block_checkbad(struct mtd_info *mtd, loff_t ofs, int getchip, int allowbbt)
1438 struct onenand_chip *this = mtd->priv;
1439 struct bbm_info *bbm = this->bbm;
1441 /* Return info from the table */
1442 return bbm->isbad_bbt(mtd, ofs, allowbbt);
1446 * onenand_erase - [MTD Interface] erase block(s)
1447 * @param mtd MTD device structure
1448 * @param instr erase instruction
1450 * Erase one ore more blocks
1452 static int onenand_erase(struct mtd_info *mtd, struct erase_info *instr)
1454 struct onenand_chip *this = mtd->priv;
1455 unsigned int block_size;
1460 DEBUG(MTD_DEBUG_LEVEL3, "onenand_erase: start = 0x%08x, len = %i\n", (unsigned int) instr->addr, (unsigned int) instr->len);
1462 block_size = (1 << this->erase_shift);
1464 /* Start address must align on block boundary */
1465 if (unlikely(instr->addr & (block_size - 1))) {
1466 printk(KERN_ERR "onenand_erase: Unaligned address\n");
1470 /* Length must align on block boundary */
1471 if (unlikely(instr->len & (block_size - 1))) {
1472 printk(KERN_ERR "onenand_erase: Length not block aligned\n");
1476 /* Do not allow erase past end of device */
1477 if (unlikely((instr->len + instr->addr) > mtd->size)) {
1478 printk(KERN_ERR "onenand_erase: Erase past end of device\n");
1482 instr->fail_addr = 0xffffffff;
1484 /* Grab the lock and see if the device is available */
1485 onenand_get_device(mtd, FL_ERASING);
1487 /* Loop throught the pages */
1491 instr->state = MTD_ERASING;
1496 /* Check if we have a bad block, we do not erase bad blocks */
1497 if (onenand_block_checkbad(mtd, addr, 0, 0)) {
1498 printk (KERN_WARNING "onenand_erase: attempt to erase a bad block at addr 0x%08x\n", (unsigned int) addr);
1499 instr->state = MTD_ERASE_FAILED;
1503 this->command(mtd, ONENAND_CMD_ERASE, addr, block_size);
1505 onenand_invalidate_bufferram(mtd, addr, block_size);
1507 ret = this->wait(mtd, FL_ERASING);
1508 /* Check, if it is write protected */
1510 printk(KERN_ERR "onenand_erase: Failed erase, block %d\n", (unsigned) (addr >> this->erase_shift));
1511 instr->state = MTD_ERASE_FAILED;
1512 instr->fail_addr = addr;
1520 instr->state = MTD_ERASE_DONE;
1524 ret = instr->state == MTD_ERASE_DONE ? 0 : -EIO;
1525 /* Do call back function */
1527 mtd_erase_callback(instr);
1529 /* Deselect and wake up anyone waiting on the device */
1530 onenand_release_device(mtd);
1536 * onenand_sync - [MTD Interface] sync
1537 * @param mtd MTD device structure
1539 * Sync is actually a wait for chip ready function
1541 static void onenand_sync(struct mtd_info *mtd)
1543 DEBUG(MTD_DEBUG_LEVEL3, "onenand_sync: called\n");
1545 /* Grab the lock and see if the device is available */
1546 onenand_get_device(mtd, FL_SYNCING);
1548 /* Release it and go back */
1549 onenand_release_device(mtd);
1553 * onenand_block_isbad - [MTD Interface] Check whether the block at the given offset is bad
1554 * @param mtd MTD device structure
1555 * @param ofs offset relative to mtd start
1557 * Check whether the block is bad
1559 static int onenand_block_isbad(struct mtd_info *mtd, loff_t ofs)
1561 /* Check for invalid offset */
1562 if (ofs > mtd->size)
1565 return onenand_block_checkbad(mtd, ofs, 1, 0);
1569 * onenand_default_block_markbad - [DEFAULT] mark a block bad
1570 * @param mtd MTD device structure
1571 * @param ofs offset from device start
1573 * This is the default implementation, which can be overridden by
1574 * a hardware specific driver.
1576 static int onenand_default_block_markbad(struct mtd_info *mtd, loff_t ofs)
1578 struct onenand_chip *this = mtd->priv;
1579 struct bbm_info *bbm = this->bbm;
1580 u_char buf[2] = {0, 0};
1584 /* Get block number */
1585 block = ((int) ofs) >> bbm->bbt_erase_shift;
1587 bbm->bbt[block >> 2] |= 0x01 << ((block & 0x03) << 1);
1589 /* We write two bytes, so we dont have to mess with 16 bit access */
1590 ofs += mtd->oobsize + (bbm->badblockpos & ~0x01);
1591 return onenand_do_write_oob(mtd, ofs , 2, &retlen, buf, MTD_OOB_PLACE);
1595 * onenand_block_markbad - [MTD Interface] Mark the block at the given offset as bad
1596 * @param mtd MTD device structure
1597 * @param ofs offset relative to mtd start
1599 * Mark the block as bad
1601 static int onenand_block_markbad(struct mtd_info *mtd, loff_t ofs)
1603 struct onenand_chip *this = mtd->priv;
1606 ret = onenand_block_isbad(mtd, ofs);
1608 /* If it was bad already, return success and do nothing */
1614 return this->block_markbad(mtd, ofs);
1618 * onenand_do_lock_cmd - [OneNAND Interface] Lock or unlock block(s)
1619 * @param mtd MTD device structure
1620 * @param ofs offset relative to mtd start
1621 * @param len number of bytes to lock or unlock
1622 * @param cmd lock or unlock command
1624 * Lock or unlock one or more blocks
1626 static int onenand_do_lock_cmd(struct mtd_info *mtd, loff_t ofs, size_t len, int cmd)
1628 struct onenand_chip *this = mtd->priv;
1629 int start, end, block, value, status;
1632 start = ofs >> this->erase_shift;
1633 end = len >> this->erase_shift;
1635 if (cmd == ONENAND_CMD_LOCK)
1636 wp_status_mask = ONENAND_WP_LS;
1638 wp_status_mask = ONENAND_WP_US;
1640 /* Continuous lock scheme */
1641 if (this->options & ONENAND_HAS_CONT_LOCK) {
1642 /* Set start block address */
1643 this->write_word(start, this->base + ONENAND_REG_START_BLOCK_ADDRESS);
1644 /* Set end block address */
1645 this->write_word(start + end - 1, this->base + ONENAND_REG_END_BLOCK_ADDRESS);
1646 /* Write lock command */
1647 this->command(mtd, cmd, 0, 0);
1649 /* There's no return value */
1650 this->wait(mtd, FL_LOCKING);
1653 while (this->read_word(this->base + ONENAND_REG_CTRL_STATUS)
1654 & ONENAND_CTRL_ONGO)
1657 /* Check lock status */
1658 status = this->read_word(this->base + ONENAND_REG_WP_STATUS);
1659 if (!(status & wp_status_mask))
1660 printk(KERN_ERR "wp status = 0x%x\n", status);
1665 /* Block lock scheme */
1666 for (block = start; block < start + end; block++) {
1667 /* Set block address */
1668 value = onenand_block_address(this, block);
1669 this->write_word(value, this->base + ONENAND_REG_START_ADDRESS1);
1670 /* Select DataRAM for DDP */
1671 value = onenand_bufferram_address(this, block);
1672 this->write_word(value, this->base + ONENAND_REG_START_ADDRESS2);
1673 /* Set start block address */
1674 this->write_word(block, this->base + ONENAND_REG_START_BLOCK_ADDRESS);
1675 /* Write lock command */
1676 this->command(mtd, cmd, 0, 0);
1678 /* There's no return value */
1679 this->wait(mtd, FL_LOCKING);
1682 while (this->read_word(this->base + ONENAND_REG_CTRL_STATUS)
1683 & ONENAND_CTRL_ONGO)
1686 /* Check lock status */
1687 status = this->read_word(this->base + ONENAND_REG_WP_STATUS);
1688 if (!(status & wp_status_mask))
1689 printk(KERN_ERR "block = %d, wp status = 0x%x\n", block, status);
1696 * onenand_lock - [MTD Interface] Lock block(s)
1697 * @param mtd MTD device structure
1698 * @param ofs offset relative to mtd start
1699 * @param len number of bytes to unlock
1701 * Lock one or more blocks
1703 static int onenand_lock(struct mtd_info *mtd, loff_t ofs, size_t len)
1705 return onenand_do_lock_cmd(mtd, ofs, len, ONENAND_CMD_LOCK);
1709 * onenand_unlock - [MTD Interface] Unlock block(s)
1710 * @param mtd MTD device structure
1711 * @param ofs offset relative to mtd start
1712 * @param len number of bytes to unlock
1714 * Unlock one or more blocks
1716 static int onenand_unlock(struct mtd_info *mtd, loff_t ofs, size_t len)
1718 return onenand_do_lock_cmd(mtd, ofs, len, ONENAND_CMD_UNLOCK);
1722 * onenand_check_lock_status - [OneNAND Interface] Check lock status
1723 * @param this onenand chip data structure
1727 static void onenand_check_lock_status(struct onenand_chip *this)
1729 unsigned int value, block, status;
1732 end = this->chipsize >> this->erase_shift;
1733 for (block = 0; block < end; block++) {
1734 /* Set block address */
1735 value = onenand_block_address(this, block);
1736 this->write_word(value, this->base + ONENAND_REG_START_ADDRESS1);
1737 /* Select DataRAM for DDP */
1738 value = onenand_bufferram_address(this, block);
1739 this->write_word(value, this->base + ONENAND_REG_START_ADDRESS2);
1740 /* Set start block address */
1741 this->write_word(block, this->base + ONENAND_REG_START_BLOCK_ADDRESS);
1743 /* Check lock status */
1744 status = this->read_word(this->base + ONENAND_REG_WP_STATUS);
1745 if (!(status & ONENAND_WP_US))
1746 printk(KERN_ERR "block = %d, wp status = 0x%x\n", block, status);
1751 * onenand_unlock_all - [OneNAND Interface] unlock all blocks
1752 * @param mtd MTD device structure
1756 static int onenand_unlock_all(struct mtd_info *mtd)
1758 struct onenand_chip *this = mtd->priv;
1760 if (this->options & ONENAND_HAS_UNLOCK_ALL) {
1761 /* Set start block address */
1762 this->write_word(0, this->base + ONENAND_REG_START_BLOCK_ADDRESS);
1763 /* Write unlock command */
1764 this->command(mtd, ONENAND_CMD_UNLOCK_ALL, 0, 0);
1766 /* There's no return value */
1767 this->wait(mtd, FL_LOCKING);
1770 while (this->read_word(this->base + ONENAND_REG_CTRL_STATUS)
1771 & ONENAND_CTRL_ONGO)
1774 /* Workaround for all block unlock in DDP */
1775 if (ONENAND_IS_DDP(this)) {
1776 /* 1st block on another chip */
1777 loff_t ofs = this->chipsize >> 1;
1778 size_t len = mtd->erasesize;
1780 onenand_unlock(mtd, ofs, len);
1783 onenand_check_lock_status(this);
1788 onenand_unlock(mtd, 0x0, this->chipsize);
1793 #ifdef CONFIG_MTD_ONENAND_OTP
1795 /* Interal OTP operation */
1796 typedef int (*otp_op_t)(struct mtd_info *mtd, loff_t form, size_t len,
1797 size_t *retlen, u_char *buf);
1800 * do_otp_read - [DEFAULT] Read OTP block area
1801 * @param mtd MTD device structure
1802 * @param from The offset to read
1803 * @param len number of bytes to read
1804 * @param retlen pointer to variable to store the number of readbytes
1805 * @param buf the databuffer to put/get data
1807 * Read OTP block area.
1809 static int do_otp_read(struct mtd_info *mtd, loff_t from, size_t len,
1810 size_t *retlen, u_char *buf)
1812 struct onenand_chip *this = mtd->priv;
1815 /* Enter OTP access mode */
1816 this->command(mtd, ONENAND_CMD_OTP_ACCESS, 0, 0);
1817 this->wait(mtd, FL_OTPING);
1819 ret = mtd->read(mtd, from, len, retlen, buf);
1821 /* Exit OTP access mode */
1822 this->command(mtd, ONENAND_CMD_RESET, 0, 0);
1823 this->wait(mtd, FL_RESETING);
1829 * do_otp_write - [DEFAULT] Write OTP block area
1830 * @param mtd MTD device structure
1831 * @param from The offset to write
1832 * @param len number of bytes to write
1833 * @param retlen pointer to variable to store the number of write bytes
1834 * @param buf the databuffer to put/get data
1836 * Write OTP block area.
1838 static int do_otp_write(struct mtd_info *mtd, loff_t from, size_t len,
1839 size_t *retlen, u_char *buf)
1841 struct onenand_chip *this = mtd->priv;
1842 unsigned char *pbuf = buf;
1845 /* Force buffer page aligned */
1846 if (len < mtd->writesize) {
1847 memcpy(this->page_buf, buf, len);
1848 memset(this->page_buf + len, 0xff, mtd->writesize - len);
1849 pbuf = this->page_buf;
1850 len = mtd->writesize;
1853 /* Enter OTP access mode */
1854 this->command(mtd, ONENAND_CMD_OTP_ACCESS, 0, 0);
1855 this->wait(mtd, FL_OTPING);
1857 ret = mtd->write(mtd, from, len, retlen, pbuf);
1859 /* Exit OTP access mode */
1860 this->command(mtd, ONENAND_CMD_RESET, 0, 0);
1861 this->wait(mtd, FL_RESETING);
1867 * do_otp_lock - [DEFAULT] Lock OTP block area
1868 * @param mtd MTD device structure
1869 * @param from The offset to lock
1870 * @param len number of bytes to lock
1871 * @param retlen pointer to variable to store the number of lock bytes
1872 * @param buf the databuffer to put/get data
1874 * Lock OTP block area.
1876 static int do_otp_lock(struct mtd_info *mtd, loff_t from, size_t len,
1877 size_t *retlen, u_char *buf)
1879 struct onenand_chip *this = mtd->priv;
1882 /* Enter OTP access mode */
1883 this->command(mtd, ONENAND_CMD_OTP_ACCESS, 0, 0);
1884 this->wait(mtd, FL_OTPING);
1886 ret = onenand_do_write_oob(mtd, from, len, retlen, buf, MTD_OOB_PLACE);
1888 /* Exit OTP access mode */
1889 this->command(mtd, ONENAND_CMD_RESET, 0, 0);
1890 this->wait(mtd, FL_RESETING);
1896 * onenand_otp_walk - [DEFAULT] Handle OTP operation
1897 * @param mtd MTD device structure
1898 * @param from The offset to read/write
1899 * @param len number of bytes to read/write
1900 * @param retlen pointer to variable to store the number of read bytes
1901 * @param buf the databuffer to put/get data
1902 * @param action do given action
1903 * @param mode specify user and factory
1905 * Handle OTP operation.
1907 static int onenand_otp_walk(struct mtd_info *mtd, loff_t from, size_t len,
1908 size_t *retlen, u_char *buf,
1909 otp_op_t action, int mode)
1911 struct onenand_chip *this = mtd->priv;
1918 density = this->device_id >> ONENAND_DEVICE_DENSITY_SHIFT;
1919 if (density < ONENAND_DEVICE_DENSITY_512Mb)
1924 if (mode == MTD_OTP_FACTORY) {
1925 from += mtd->writesize * otp_pages;
1926 otp_pages = 64 - otp_pages;
1929 /* Check User/Factory boundary */
1930 if (((mtd->writesize * otp_pages) - (from + len)) < 0)
1933 while (len > 0 && otp_pages > 0) {
1934 if (!action) { /* OTP Info functions */
1935 struct otp_info *otpinfo;
1937 len -= sizeof(struct otp_info);
1941 otpinfo = (struct otp_info *) buf;
1942 otpinfo->start = from;
1943 otpinfo->length = mtd->writesize;
1944 otpinfo->locked = 0;
1946 from += mtd->writesize;
1947 buf += sizeof(struct otp_info);
1948 *retlen += sizeof(struct otp_info);
1953 ret = action(mtd, from, len, &tmp_retlen, buf);
1969 * onenand_get_fact_prot_info - [MTD Interface] Read factory OTP info
1970 * @param mtd MTD device structure
1971 * @param buf the databuffer to put/get data
1972 * @param len number of bytes to read
1974 * Read factory OTP info.
1976 static int onenand_get_fact_prot_info(struct mtd_info *mtd,
1977 struct otp_info *buf, size_t len)
1982 ret = onenand_otp_walk(mtd, 0, len, &retlen, (u_char *) buf, NULL, MTD_OTP_FACTORY);
1984 return ret ? : retlen;
1988 * onenand_read_fact_prot_reg - [MTD Interface] Read factory OTP area
1989 * @param mtd MTD device structure
1990 * @param from The offset to read
1991 * @param len number of bytes to read
1992 * @param retlen pointer to variable to store the number of read bytes
1993 * @param buf the databuffer to put/get data
1995 * Read factory OTP area.
1997 static int onenand_read_fact_prot_reg(struct mtd_info *mtd, loff_t from,
1998 size_t len, size_t *retlen, u_char *buf)
2000 return onenand_otp_walk(mtd, from, len, retlen, buf, do_otp_read, MTD_OTP_FACTORY);
2004 * onenand_get_user_prot_info - [MTD Interface] Read user OTP info
2005 * @param mtd MTD device structure
2006 * @param buf the databuffer to put/get data
2007 * @param len number of bytes to read
2009 * Read user OTP info.
2011 static int onenand_get_user_prot_info(struct mtd_info *mtd,
2012 struct otp_info *buf, size_t len)
2017 ret = onenand_otp_walk(mtd, 0, len, &retlen, (u_char *) buf, NULL, MTD_OTP_USER);
2019 return ret ? : retlen;
2023 * onenand_read_user_prot_reg - [MTD Interface] Read user OTP area
2024 * @param mtd MTD device structure
2025 * @param from The offset to read
2026 * @param len number of bytes to read
2027 * @param retlen pointer to variable to store the number of read bytes
2028 * @param buf the databuffer to put/get data
2030 * Read user OTP area.
2032 static int onenand_read_user_prot_reg(struct mtd_info *mtd, loff_t from,
2033 size_t len, size_t *retlen, u_char *buf)
2035 return onenand_otp_walk(mtd, from, len, retlen, buf, do_otp_read, MTD_OTP_USER);
2039 * onenand_write_user_prot_reg - [MTD Interface] Write user OTP area
2040 * @param mtd MTD device structure
2041 * @param from The offset to write
2042 * @param len number of bytes to write
2043 * @param retlen pointer to variable to store the number of write bytes
2044 * @param buf the databuffer to put/get data
2046 * Write user OTP area.
2048 static int onenand_write_user_prot_reg(struct mtd_info *mtd, loff_t from,
2049 size_t len, size_t *retlen, u_char *buf)
2051 return onenand_otp_walk(mtd, from, len, retlen, buf, do_otp_write, MTD_OTP_USER);
2055 * onenand_lock_user_prot_reg - [MTD Interface] Lock user OTP area
2056 * @param mtd MTD device structure
2057 * @param from The offset to lock
2058 * @param len number of bytes to unlock
2060 * Write lock mark on spare area in page 0 in OTP block
2062 static int onenand_lock_user_prot_reg(struct mtd_info *mtd, loff_t from,
2065 unsigned char oob_buf[64];
2069 memset(oob_buf, 0xff, mtd->oobsize);
2071 * Note: OTP lock operation
2072 * OTP block : 0xXXFC
2073 * 1st block : 0xXXF3 (If chip support)
2074 * Both : 0xXXF0 (If chip support)
2076 oob_buf[ONENAND_OTP_LOCK_OFFSET] = 0xFC;
2079 * Write lock mark to 8th word of sector0 of page0 of the spare0.
2080 * We write 16 bytes spare area instead of 2 bytes.
2085 ret = onenand_otp_walk(mtd, from, len, &retlen, oob_buf, do_otp_lock, MTD_OTP_USER);
2087 return ret ? : retlen;
2089 #endif /* CONFIG_MTD_ONENAND_OTP */
2092 * onenand_check_features - Check and set OneNAND features
2093 * @param mtd MTD data structure
2095 * Check and set OneNAND features
2098 static void onenand_check_features(struct mtd_info *mtd)
2100 struct onenand_chip *this = mtd->priv;
2101 unsigned int density, process;
2103 /* Lock scheme depends on density and process */
2104 density = this->device_id >> ONENAND_DEVICE_DENSITY_SHIFT;
2105 process = this->version_id >> ONENAND_VERSION_PROCESS_SHIFT;
2108 if (density >= ONENAND_DEVICE_DENSITY_1Gb) {
2109 /* A-Die has all block unlock */
2111 printk(KERN_DEBUG "Chip support all block unlock\n");
2112 this->options |= ONENAND_HAS_UNLOCK_ALL;
2115 /* Some OneNAND has continues lock scheme */
2117 printk(KERN_DEBUG "Lock scheme is Continues Lock\n");
2118 this->options |= ONENAND_HAS_CONT_LOCK;
2124 * onenand_print_device_info - Print device & version ID
2125 * @param device device ID
2126 * @param version version ID
2128 * Print device & version ID
2130 static void onenand_print_device_info(int device, int version)
2132 int vcc, demuxed, ddp, density;
2134 vcc = device & ONENAND_DEVICE_VCC_MASK;
2135 demuxed = device & ONENAND_DEVICE_IS_DEMUX;
2136 ddp = device & ONENAND_DEVICE_IS_DDP;
2137 density = device >> ONENAND_DEVICE_DENSITY_SHIFT;
2138 printk(KERN_INFO "%sOneNAND%s %dMB %sV 16-bit (0x%02x)\n",
2139 demuxed ? "" : "Muxed ",
2142 vcc ? "2.65/3.3" : "1.8",
2144 printk(KERN_DEBUG "OneNAND version = 0x%04x\n", version);
2147 static const struct onenand_manufacturers onenand_manuf_ids[] = {
2148 {ONENAND_MFR_SAMSUNG, "Samsung"},
2152 * onenand_check_maf - Check manufacturer ID
2153 * @param manuf manufacturer ID
2155 * Check manufacturer ID
2157 static int onenand_check_maf(int manuf)
2159 int size = ARRAY_SIZE(onenand_manuf_ids);
2163 for (i = 0; i < size; i++)
2164 if (manuf == onenand_manuf_ids[i].id)
2168 name = onenand_manuf_ids[i].name;
2172 printk(KERN_DEBUG "OneNAND Manufacturer: %s (0x%0x)\n", name, manuf);
2178 * onenand_probe - [OneNAND Interface] Probe the OneNAND device
2179 * @param mtd MTD device structure
2181 * OneNAND detection method:
2182 * Compare the the values from command with ones from register
2184 static int onenand_probe(struct mtd_info *mtd)
2186 struct onenand_chip *this = mtd->priv;
2187 int bram_maf_id, bram_dev_id, maf_id, dev_id, ver_id;
2191 /* Save system configuration 1 */
2192 syscfg = this->read_word(this->base + ONENAND_REG_SYS_CFG1);
2193 /* Clear Sync. Burst Read mode to read BootRAM */
2194 this->write_word((syscfg & ~ONENAND_SYS_CFG1_SYNC_READ), this->base + ONENAND_REG_SYS_CFG1);
2196 /* Send the command for reading device ID from BootRAM */
2197 this->write_word(ONENAND_CMD_READID, this->base + ONENAND_BOOTRAM);
2199 /* Read manufacturer and device IDs from BootRAM */
2200 bram_maf_id = this->read_word(this->base + ONENAND_BOOTRAM + 0x0);
2201 bram_dev_id = this->read_word(this->base + ONENAND_BOOTRAM + 0x2);
2203 /* Reset OneNAND to read default register values */
2204 this->write_word(ONENAND_CMD_RESET, this->base + ONENAND_BOOTRAM);
2206 this->wait(mtd, FL_RESETING);
2208 /* Restore system configuration 1 */
2209 this->write_word(syscfg, this->base + ONENAND_REG_SYS_CFG1);
2211 /* Check manufacturer ID */
2212 if (onenand_check_maf(bram_maf_id))
2215 /* Read manufacturer and device IDs from Register */
2216 maf_id = this->read_word(this->base + ONENAND_REG_MANUFACTURER_ID);
2217 dev_id = this->read_word(this->base + ONENAND_REG_DEVICE_ID);
2218 ver_id = this->read_word(this->base + ONENAND_REG_VERSION_ID);
2220 /* Check OneNAND device */
2221 if (maf_id != bram_maf_id || dev_id != bram_dev_id)
2224 /* Flash device information */
2225 onenand_print_device_info(dev_id, ver_id);
2226 this->device_id = dev_id;
2227 this->version_id = ver_id;
2229 density = dev_id >> ONENAND_DEVICE_DENSITY_SHIFT;
2230 this->chipsize = (16 << density) << 20;
2231 /* Set density mask. it is used for DDP */
2232 if (ONENAND_IS_DDP(this))
2233 this->density_mask = (1 << (density + 6));
2235 this->density_mask = 0;
2237 /* OneNAND page size & block size */
2238 /* The data buffer size is equal to page size */
2239 mtd->writesize = this->read_word(this->base + ONENAND_REG_DATA_BUFFER_SIZE);
2240 mtd->oobsize = mtd->writesize >> 5;
2241 /* Pages per a block are always 64 in OneNAND */
2242 mtd->erasesize = mtd->writesize << 6;
2244 this->erase_shift = ffs(mtd->erasesize) - 1;
2245 this->page_shift = ffs(mtd->writesize) - 1;
2246 this->page_mask = (1 << (this->erase_shift - this->page_shift)) - 1;
2248 /* REVIST: Multichip handling */
2250 mtd->size = this->chipsize;
2252 /* Check OneNAND features */
2253 onenand_check_features(mtd);
2259 * onenand_suspend - [MTD Interface] Suspend the OneNAND flash
2260 * @param mtd MTD device structure
2262 static int onenand_suspend(struct mtd_info *mtd)
2264 return onenand_get_device(mtd, FL_PM_SUSPENDED);
2268 * onenand_resume - [MTD Interface] Resume the OneNAND flash
2269 * @param mtd MTD device structure
2271 static void onenand_resume(struct mtd_info *mtd)
2273 struct onenand_chip *this = mtd->priv;
2275 if (this->state == FL_PM_SUSPENDED)
2276 onenand_release_device(mtd);
2278 printk(KERN_ERR "resume() called for the chip which is not"
2279 "in suspended state\n");
2283 * onenand_scan - [OneNAND Interface] Scan for the OneNAND device
2284 * @param mtd MTD device structure
2285 * @param maxchips Number of chips to scan for
2287 * This fills out all the not initialized function pointers
2288 * with the defaults.
2289 * The flash ID is read and the mtd/chip structures are
2290 * filled with the appropriate values.
2292 int onenand_scan(struct mtd_info *mtd, int maxchips)
2295 struct onenand_chip *this = mtd->priv;
2297 if (!this->read_word)
2298 this->read_word = onenand_readw;
2299 if (!this->write_word)
2300 this->write_word = onenand_writew;
2303 this->command = onenand_command;
2305 onenand_setup_wait(mtd);
2307 if (!this->read_bufferram)
2308 this->read_bufferram = onenand_read_bufferram;
2309 if (!this->write_bufferram)
2310 this->write_bufferram = onenand_write_bufferram;
2312 if (!this->block_markbad)
2313 this->block_markbad = onenand_default_block_markbad;
2314 if (!this->scan_bbt)
2315 this->scan_bbt = onenand_default_bbt;
2317 if (onenand_probe(mtd))
2320 /* Set Sync. Burst Read after probing */
2321 if (this->mmcontrol) {
2322 printk(KERN_INFO "OneNAND Sync. Burst Read support\n");
2323 this->read_bufferram = onenand_sync_read_bufferram;
2326 /* Allocate buffers, if necessary */
2327 if (!this->page_buf) {
2329 len = mtd->writesize + mtd->oobsize;
2330 this->page_buf = kmalloc(len, GFP_KERNEL);
2331 if (!this->page_buf) {
2332 printk(KERN_ERR "onenand_scan(): Can't allocate page_buf\n");
2335 this->options |= ONENAND_PAGEBUF_ALLOC;
2338 this->state = FL_READY;
2339 init_waitqueue_head(&this->wq);
2340 spin_lock_init(&this->chip_lock);
2343 * Allow subpage writes up to oobsize.
2345 switch (mtd->oobsize) {
2347 this->ecclayout = &onenand_oob_64;
2348 mtd->subpage_sft = 2;
2352 this->ecclayout = &onenand_oob_32;
2353 mtd->subpage_sft = 1;
2357 printk(KERN_WARNING "No OOB scheme defined for oobsize %d\n",
2359 mtd->subpage_sft = 0;
2360 /* To prevent kernel oops */
2361 this->ecclayout = &onenand_oob_32;
2365 this->subpagesize = mtd->writesize >> mtd->subpage_sft;
2368 * The number of bytes available for a client to place data into
2369 * the out of band area
2371 this->ecclayout->oobavail = 0;
2372 for (i = 0; this->ecclayout->oobfree[i].length; i++)
2373 this->ecclayout->oobavail +=
2374 this->ecclayout->oobfree[i].length;
2375 mtd->oobavail = this->ecclayout->oobavail;
2377 mtd->ecclayout = this->ecclayout;
2379 /* Fill in remaining MTD driver data */
2380 mtd->type = MTD_NANDFLASH;
2381 mtd->flags = MTD_CAP_NANDFLASH;
2382 mtd->erase = onenand_erase;
2384 mtd->unpoint = NULL;
2385 mtd->read = onenand_read;
2386 mtd->write = onenand_write;
2387 mtd->read_oob = onenand_read_oob;
2388 mtd->write_oob = onenand_write_oob;
2389 #ifdef CONFIG_MTD_ONENAND_OTP
2390 mtd->get_fact_prot_info = onenand_get_fact_prot_info;
2391 mtd->read_fact_prot_reg = onenand_read_fact_prot_reg;
2392 mtd->get_user_prot_info = onenand_get_user_prot_info;
2393 mtd->read_user_prot_reg = onenand_read_user_prot_reg;
2394 mtd->write_user_prot_reg = onenand_write_user_prot_reg;
2395 mtd->lock_user_prot_reg = onenand_lock_user_prot_reg;
2397 mtd->sync = onenand_sync;
2398 mtd->lock = onenand_lock;
2399 mtd->unlock = onenand_unlock;
2400 mtd->suspend = onenand_suspend;
2401 mtd->resume = onenand_resume;
2402 mtd->block_isbad = onenand_block_isbad;
2403 mtd->block_markbad = onenand_block_markbad;
2404 mtd->owner = THIS_MODULE;
2406 /* Unlock whole block */
2407 onenand_unlock_all(mtd);
2409 return this->scan_bbt(mtd);
2413 * onenand_release - [OneNAND Interface] Free resources held by the OneNAND device
2414 * @param mtd MTD device structure
2416 void onenand_release(struct mtd_info *mtd)
2418 struct onenand_chip *this = mtd->priv;
2420 #ifdef CONFIG_MTD_PARTITIONS
2421 /* Deregister partitions */
2422 del_mtd_partitions (mtd);
2424 /* Deregister the device */
2425 del_mtd_device (mtd);
2427 /* Free bad block table memory, if allocated */
2429 struct bbm_info *bbm = this->bbm;
2433 /* Buffer allocated by onenand_scan */
2434 if (this->options & ONENAND_PAGEBUF_ALLOC)
2435 kfree(this->page_buf);
2438 EXPORT_SYMBOL_GPL(onenand_scan);
2439 EXPORT_SYMBOL_GPL(onenand_release);
2441 MODULE_LICENSE("GPL");
2442 MODULE_AUTHOR("Kyungmin Park <kyungmin.park@samsung.com>");
2443 MODULE_DESCRIPTION("Generic OneNAND flash driver code");