Linux Audio

Check our new training course

Loading...
v3.1
  1/*
  2 * inftlcore.c -- Linux driver for Inverse Flash Translation Layer (INFTL)
  3 *
  4 * Copyright © 2002, Greg Ungerer (gerg@snapgear.com)
  5 *
  6 * Based heavily on the nftlcore.c code which is:
  7 * Copyright © 1999 Machine Vision Holdings, Inc.
  8 * Copyright © 1999 David Woodhouse <dwmw2@infradead.org>
  9 *
 10 * This program is free software; you can redistribute it and/or modify
 11 * it under the terms of the GNU General Public License as published by
 12 * the Free Software Foundation; either version 2 of the License, or
 13 * (at your option) any later version.
 14 *
 15 * This program is distributed in the hope that it will be useful,
 16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 18 * GNU General Public License for more details.
 19 *
 20 * You should have received a copy of the GNU General Public License
 21 * along with this program; if not, write to the Free Software
 22 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 23 */
 24
 25#include <linux/kernel.h>
 26#include <linux/module.h>
 27#include <linux/delay.h>
 28#include <linux/slab.h>
 29#include <linux/sched.h>
 30#include <linux/init.h>
 31#include <linux/kmod.h>
 32#include <linux/hdreg.h>
 33#include <linux/mtd/mtd.h>
 34#include <linux/mtd/nftl.h>
 35#include <linux/mtd/inftl.h>
 36#include <linux/mtd/nand.h>
 37#include <asm/uaccess.h>
 38#include <asm/errno.h>
 39#include <asm/io.h>
 40
 41/*
 42 * Maximum number of loops while examining next block, to have a
 43 * chance to detect consistency problems (they should never happen
 44 * because of the checks done in the mounting.
 45 */
 46#define MAX_LOOPS 10000
 47
 48static void inftl_add_mtd(struct mtd_blktrans_ops *tr, struct mtd_info *mtd)
 49{
 50	struct INFTLrecord *inftl;
 51	unsigned long temp;
 52
 53	if (mtd->type != MTD_NANDFLASH || mtd->size > UINT_MAX)
 54		return;
 55	/* OK, this is moderately ugly.  But probably safe.  Alternatives? */
 56	if (memcmp(mtd->name, "DiskOnChip", 10))
 57		return;
 58
 59	if (!mtd->block_isbad) {
 60		printk(KERN_ERR
 61"INFTL no longer supports the old DiskOnChip drivers loaded via docprobe.\n"
 62"Please use the new diskonchip driver under the NAND subsystem.\n");
 63		return;
 64	}
 65
 66	DEBUG(MTD_DEBUG_LEVEL3, "INFTL: add_mtd for %s\n", mtd->name);
 67
 68	inftl = kzalloc(sizeof(*inftl), GFP_KERNEL);
 69
 70	if (!inftl) {
 71		printk(KERN_WARNING "INFTL: Out of memory for data structures\n");
 72		return;
 73	}
 74
 75	inftl->mbd.mtd = mtd;
 76	inftl->mbd.devnum = -1;
 77
 78	inftl->mbd.tr = tr;
 79
 80	if (INFTL_mount(inftl) < 0) {
 81		printk(KERN_WARNING "INFTL: could not mount device\n");
 82		kfree(inftl);
 83		return;
 84	}
 85
 86	/* OK, it's a new one. Set up all the data structures. */
 87
 88	/* Calculate geometry */
 89	inftl->cylinders = 1024;
 90	inftl->heads = 16;
 91
 92	temp = inftl->cylinders * inftl->heads;
 93	inftl->sectors = inftl->mbd.size / temp;
 94	if (inftl->mbd.size % temp) {
 95		inftl->sectors++;
 96		temp = inftl->cylinders * inftl->sectors;
 97		inftl->heads = inftl->mbd.size / temp;
 98
 99		if (inftl->mbd.size % temp) {
100			inftl->heads++;
101			temp = inftl->heads * inftl->sectors;
102			inftl->cylinders = inftl->mbd.size / temp;
103		}
104	}
105
106	if (inftl->mbd.size != inftl->heads * inftl->cylinders * inftl->sectors) {
107		/*
108		  Oh no we don't have
109		   mbd.size == heads * cylinders * sectors
110		*/
111		printk(KERN_WARNING "INFTL: cannot calculate a geometry to "
112		       "match size of 0x%lx.\n", inftl->mbd.size);
113		printk(KERN_WARNING "INFTL: using C:%d H:%d S:%d "
114			"(== 0x%lx sects)\n",
115			inftl->cylinders, inftl->heads , inftl->sectors,
116			(long)inftl->cylinders * (long)inftl->heads *
117			(long)inftl->sectors );
118	}
119
120	if (add_mtd_blktrans_dev(&inftl->mbd)) {
121		kfree(inftl->PUtable);
122		kfree(inftl->VUtable);
123		kfree(inftl);
124		return;
125	}
126#ifdef PSYCHO_DEBUG
127	printk(KERN_INFO "INFTL: Found new inftl%c\n", inftl->mbd.devnum + 'a');
128#endif
129	return;
130}
131
132static void inftl_remove_dev(struct mtd_blktrans_dev *dev)
133{
134	struct INFTLrecord *inftl = (void *)dev;
135
136	DEBUG(MTD_DEBUG_LEVEL3, "INFTL: remove_dev (i=%d)\n", dev->devnum);
137
138	del_mtd_blktrans_dev(dev);
139
140	kfree(inftl->PUtable);
141	kfree(inftl->VUtable);
142}
143
144/*
145 * Actual INFTL access routines.
146 */
147
148/*
149 * Read oob data from flash
150 */
151int inftl_read_oob(struct mtd_info *mtd, loff_t offs, size_t len,
152		   size_t *retlen, uint8_t *buf)
153{
154	struct mtd_oob_ops ops;
155	int res;
156
157	ops.mode = MTD_OOB_PLACE;
158	ops.ooboffs = offs & (mtd->writesize - 1);
159	ops.ooblen = len;
160	ops.oobbuf = buf;
161	ops.datbuf = NULL;
162
163	res = mtd->read_oob(mtd, offs & ~(mtd->writesize - 1), &ops);
164	*retlen = ops.oobretlen;
165	return res;
166}
167
168/*
169 * Write oob data to flash
170 */
171int inftl_write_oob(struct mtd_info *mtd, loff_t offs, size_t len,
172		    size_t *retlen, uint8_t *buf)
173{
174	struct mtd_oob_ops ops;
175	int res;
176
177	ops.mode = MTD_OOB_PLACE;
178	ops.ooboffs = offs & (mtd->writesize - 1);
179	ops.ooblen = len;
180	ops.oobbuf = buf;
181	ops.datbuf = NULL;
182
183	res = mtd->write_oob(mtd, offs & ~(mtd->writesize - 1), &ops);
184	*retlen = ops.oobretlen;
185	return res;
186}
187
188/*
189 * Write data and oob to flash
190 */
191static int inftl_write(struct mtd_info *mtd, loff_t offs, size_t len,
192		       size_t *retlen, uint8_t *buf, uint8_t *oob)
193{
194	struct mtd_oob_ops ops;
195	int res;
196
197	ops.mode = MTD_OOB_PLACE;
198	ops.ooboffs = offs;
199	ops.ooblen = mtd->oobsize;
200	ops.oobbuf = oob;
201	ops.datbuf = buf;
202	ops.len = len;
203
204	res = mtd->write_oob(mtd, offs & ~(mtd->writesize - 1), &ops);
205	*retlen = ops.retlen;
206	return res;
207}
208
209/*
210 * INFTL_findfreeblock: Find a free Erase Unit on the INFTL partition.
211 *	This function is used when the give Virtual Unit Chain.
212 */
213static u16 INFTL_findfreeblock(struct INFTLrecord *inftl, int desperate)
214{
215	u16 pot = inftl->LastFreeEUN;
216	int silly = inftl->nb_blocks;
217
218	DEBUG(MTD_DEBUG_LEVEL3, "INFTL: INFTL_findfreeblock(inftl=%p,"
219		"desperate=%d)\n", inftl, desperate);
220
221	/*
222	 * Normally, we force a fold to happen before we run out of free
223	 * blocks completely.
224	 */
225	if (!desperate && inftl->numfreeEUNs < 2) {
226		DEBUG(MTD_DEBUG_LEVEL1, "INFTL: there are too few free "
227			"EUNs (%d)\n", inftl->numfreeEUNs);
228		return BLOCK_NIL;
229	}
230
231	/* Scan for a free block */
232	do {
233		if (inftl->PUtable[pot] == BLOCK_FREE) {
234			inftl->LastFreeEUN = pot;
235			return pot;
236		}
237
238		if (++pot > inftl->lastEUN)
239			pot = 0;
240
241		if (!silly--) {
242			printk(KERN_WARNING "INFTL: no free blocks found!  "
243				"EUN range = %d - %d\n", 0, inftl->LastFreeEUN);
244			return BLOCK_NIL;
245		}
246	} while (pot != inftl->LastFreeEUN);
247
248	return BLOCK_NIL;
249}
250
251static u16 INFTL_foldchain(struct INFTLrecord *inftl, unsigned thisVUC, unsigned pendingblock)
252{
253	u16 BlockMap[MAX_SECTORS_PER_UNIT];
254	unsigned char BlockDeleted[MAX_SECTORS_PER_UNIT];
255	unsigned int thisEUN, prevEUN, status;
256	struct mtd_info *mtd = inftl->mbd.mtd;
257	int block, silly;
258	unsigned int targetEUN;
259	struct inftl_oob oob;
260	size_t retlen;
261
262	DEBUG(MTD_DEBUG_LEVEL3, "INFTL: INFTL_foldchain(inftl=%p,thisVUC=%d,"
263		"pending=%d)\n", inftl, thisVUC, pendingblock);
264
265	memset(BlockMap, 0xff, sizeof(BlockMap));
266	memset(BlockDeleted, 0, sizeof(BlockDeleted));
267
268	thisEUN = targetEUN = inftl->VUtable[thisVUC];
269
270	if (thisEUN == BLOCK_NIL) {
271		printk(KERN_WARNING "INFTL: trying to fold non-existent "
272		       "Virtual Unit Chain %d!\n", thisVUC);
273		return BLOCK_NIL;
274	}
275
276	/*
277	 * Scan to find the Erase Unit which holds the actual data for each
278	 * 512-byte block within the Chain.
279	 */
280	silly = MAX_LOOPS;
281	while (thisEUN < inftl->nb_blocks) {
282		for (block = 0; block < inftl->EraseSize/SECTORSIZE; block ++) {
283			if ((BlockMap[block] != BLOCK_NIL) ||
284			    BlockDeleted[block])
285				continue;
286
287			if (inftl_read_oob(mtd, (thisEUN * inftl->EraseSize)
288					   + (block * SECTORSIZE), 16, &retlen,
289					   (char *)&oob) < 0)
290				status = SECTOR_IGNORE;
291			else
292				status = oob.b.Status | oob.b.Status1;
293
294			switch(status) {
295			case SECTOR_FREE:
296			case SECTOR_IGNORE:
297				break;
298			case SECTOR_USED:
299				BlockMap[block] = thisEUN;
300				continue;
301			case SECTOR_DELETED:
302				BlockDeleted[block] = 1;
303				continue;
304			default:
305				printk(KERN_WARNING "INFTL: unknown status "
306					"for block %d in EUN %d: %x\n",
307					block, thisEUN, status);
308				break;
309			}
310		}
311
312		if (!silly--) {
313			printk(KERN_WARNING "INFTL: infinite loop in Virtual "
314				"Unit Chain 0x%x\n", thisVUC);
315			return BLOCK_NIL;
316		}
317
318		thisEUN = inftl->PUtable[thisEUN];
319	}
320
321	/*
322	 * OK. We now know the location of every block in the Virtual Unit
323	 * Chain, and the Erase Unit into which we are supposed to be copying.
324	 * Go for it.
325	 */
326	DEBUG(MTD_DEBUG_LEVEL1, "INFTL: folding chain %d into unit %d\n",
327		thisVUC, targetEUN);
328
329	for (block = 0; block < inftl->EraseSize/SECTORSIZE ; block++) {
330		unsigned char movebuf[SECTORSIZE];
331		int ret;
332
333		/*
334		 * If it's in the target EUN already, or if it's pending write,
335		 * do nothing.
336		 */
337		if (BlockMap[block] == targetEUN || (pendingblock ==
338		    (thisVUC * (inftl->EraseSize / SECTORSIZE) + block))) {
339			continue;
340		}
341
342		/*
343		 * Copy only in non free block (free blocks can only
344                 * happen in case of media errors or deleted blocks).
345		 */
346		if (BlockMap[block] == BLOCK_NIL)
347			continue;
348
349		ret = mtd->read(mtd, (inftl->EraseSize * BlockMap[block]) +
350				(block * SECTORSIZE), SECTORSIZE, &retlen,
351				movebuf);
352		if (ret < 0 && ret != -EUCLEAN) {
353			ret = mtd->read(mtd,
354					(inftl->EraseSize * BlockMap[block]) +
355					(block * SECTORSIZE), SECTORSIZE,
356					&retlen, movebuf);
 
 
 
357			if (ret != -EIO)
358				DEBUG(MTD_DEBUG_LEVEL1, "INFTL: error went "
359				      "away on retry?\n");
360		}
361		memset(&oob, 0xff, sizeof(struct inftl_oob));
362		oob.b.Status = oob.b.Status1 = SECTOR_USED;
363
364		inftl_write(inftl->mbd.mtd, (inftl->EraseSize * targetEUN) +
365			    (block * SECTORSIZE), SECTORSIZE, &retlen,
366			    movebuf, (char *)&oob);
367	}
368
369	/*
370	 * Newest unit in chain now contains data from _all_ older units.
371	 * So go through and erase each unit in chain, oldest first. (This
372	 * is important, by doing oldest first if we crash/reboot then it
373	 * it is relatively simple to clean up the mess).
374	 */
375	DEBUG(MTD_DEBUG_LEVEL1, "INFTL: want to erase virtual chain %d\n",
376		thisVUC);
377
378	for (;;) {
379		/* Find oldest unit in chain. */
380		thisEUN = inftl->VUtable[thisVUC];
381		prevEUN = BLOCK_NIL;
382		while (inftl->PUtable[thisEUN] != BLOCK_NIL) {
383			prevEUN = thisEUN;
384			thisEUN = inftl->PUtable[thisEUN];
385		}
386
387		/* Check if we are all done */
388		if (thisEUN == targetEUN)
389			break;
390
391		/* Unlink the last block from the chain. */
392		inftl->PUtable[prevEUN] = BLOCK_NIL;
393
394		/* Now try to erase it. */
395		if (INFTL_formatblock(inftl, thisEUN) < 0) {
396			/*
397			 * Could not erase : mark block as reserved.
398			 */
399			inftl->PUtable[thisEUN] = BLOCK_RESERVED;
400		} else {
401			/* Correctly erased : mark it as free */
402			inftl->PUtable[thisEUN] = BLOCK_FREE;
403			inftl->numfreeEUNs++;
404		}
405	}
406
407	return targetEUN;
408}
409
410static u16 INFTL_makefreeblock(struct INFTLrecord *inftl, unsigned pendingblock)
411{
412	/*
413	 * This is the part that needs some cleverness applied.
414	 * For now, I'm doing the minimum applicable to actually
415	 * get the thing to work.
416	 * Wear-levelling and other clever stuff needs to be implemented
417	 * and we also need to do some assessment of the results when
418	 * the system loses power half-way through the routine.
419	 */
420	u16 LongestChain = 0;
421	u16 ChainLength = 0, thislen;
422	u16 chain, EUN;
423
424	DEBUG(MTD_DEBUG_LEVEL3, "INFTL: INFTL_makefreeblock(inftl=%p,"
425		"pending=%d)\n", inftl, pendingblock);
426
427	for (chain = 0; chain < inftl->nb_blocks; chain++) {
428		EUN = inftl->VUtable[chain];
429		thislen = 0;
430
431		while (EUN <= inftl->lastEUN) {
432			thislen++;
433			EUN = inftl->PUtable[EUN];
434			if (thislen > 0xff00) {
435				printk(KERN_WARNING "INFTL: endless loop in "
436					"Virtual Chain %d: Unit %x\n",
437					chain, EUN);
438				/*
439				 * Actually, don't return failure.
440				 * Just ignore this chain and get on with it.
441				 */
442				thislen = 0;
443				break;
444			}
445		}
446
447		if (thislen > ChainLength) {
448			ChainLength = thislen;
449			LongestChain = chain;
450		}
451	}
452
453	if (ChainLength < 2) {
454		printk(KERN_WARNING "INFTL: no Virtual Unit Chains available "
455			"for folding. Failing request\n");
456		return BLOCK_NIL;
457	}
458
459	return INFTL_foldchain(inftl, LongestChain, pendingblock);
460}
461
462static int nrbits(unsigned int val, int bitcount)
463{
464	int i, total = 0;
465
466	for (i = 0; (i < bitcount); i++)
467		total += (((0x1 << i) & val) ? 1 : 0);
468	return total;
469}
470
471/*
472 * INFTL_findwriteunit: Return the unit number into which we can write
473 *                      for this block. Make it available if it isn't already.
474 */
475static inline u16 INFTL_findwriteunit(struct INFTLrecord *inftl, unsigned block)
476{
477	unsigned int thisVUC = block / (inftl->EraseSize / SECTORSIZE);
478	unsigned int thisEUN, writeEUN, prev_block, status;
479	unsigned long blockofs = (block * SECTORSIZE) & (inftl->EraseSize -1);
480	struct mtd_info *mtd = inftl->mbd.mtd;
481	struct inftl_oob oob;
482	struct inftl_bci bci;
483	unsigned char anac, nacs, parity;
484	size_t retlen;
485	int silly, silly2 = 3;
486
487	DEBUG(MTD_DEBUG_LEVEL3, "INFTL: INFTL_findwriteunit(inftl=%p,"
488		"block=%d)\n", inftl, block);
489
490	do {
491		/*
492		 * Scan the media to find a unit in the VUC which has
493		 * a free space for the block in question.
494		 */
495		writeEUN = BLOCK_NIL;
496		thisEUN = inftl->VUtable[thisVUC];
497		silly = MAX_LOOPS;
498
499		while (thisEUN <= inftl->lastEUN) {
500			inftl_read_oob(mtd, (thisEUN * inftl->EraseSize) +
501				       blockofs, 8, &retlen, (char *)&bci);
502
503			status = bci.Status | bci.Status1;
504			DEBUG(MTD_DEBUG_LEVEL3, "INFTL: status of block %d in "
505				"EUN %d is %x\n", block , writeEUN, status);
506
507			switch(status) {
508			case SECTOR_FREE:
509				writeEUN = thisEUN;
510				break;
511			case SECTOR_DELETED:
512			case SECTOR_USED:
513				/* Can't go any further */
514				goto hitused;
515			case SECTOR_IGNORE:
516				break;
517			default:
518				/*
519				 * Invalid block. Don't use it any more.
520				 * Must implement.
521				 */
522				break;
523			}
524
525			if (!silly--) {
526				printk(KERN_WARNING "INFTL: infinite loop in "
527					"Virtual Unit Chain 0x%x\n", thisVUC);
528				return BLOCK_NIL;
529			}
530
531			/* Skip to next block in chain */
532			thisEUN = inftl->PUtable[thisEUN];
533		}
534
535hitused:
536		if (writeEUN != BLOCK_NIL)
537			return writeEUN;
538
539
540		/*
541		 * OK. We didn't find one in the existing chain, or there
542		 * is no existing chain. Allocate a new one.
543		 */
544		writeEUN = INFTL_findfreeblock(inftl, 0);
545
546		if (writeEUN == BLOCK_NIL) {
547			/*
548			 * That didn't work - there were no free blocks just
549			 * waiting to be picked up. We're going to have to fold
550			 * a chain to make room.
551			 */
552			thisEUN = INFTL_makefreeblock(inftl, block);
553
554			/*
555			 * Hopefully we free something, lets try again.
556			 * This time we are desperate...
557			 */
558			DEBUG(MTD_DEBUG_LEVEL1, "INFTL: using desperate==1 "
559				"to find free EUN to accommodate write to "
560				"VUC %d\n", thisVUC);
561			writeEUN = INFTL_findfreeblock(inftl, 1);
562			if (writeEUN == BLOCK_NIL) {
563				/*
564				 * Ouch. This should never happen - we should
565				 * always be able to make some room somehow.
566				 * If we get here, we've allocated more storage
567				 * space than actual media, or our makefreeblock
568				 * routine is missing something.
569				 */
570				printk(KERN_WARNING "INFTL: cannot make free "
571					"space.\n");
572#ifdef DEBUG
573				INFTL_dumptables(inftl);
574				INFTL_dumpVUchains(inftl);
575#endif
576				return BLOCK_NIL;
577			}
578		}
579
580		/*
581		 * Insert new block into virtual chain. Firstly update the
582		 * block headers in flash...
583		 */
584		anac = 0;
585		nacs = 0;
586		thisEUN = inftl->VUtable[thisVUC];
587		if (thisEUN != BLOCK_NIL) {
588			inftl_read_oob(mtd, thisEUN * inftl->EraseSize
589				       + 8, 8, &retlen, (char *)&oob.u);
590			anac = oob.u.a.ANAC + 1;
591			nacs = oob.u.a.NACs + 1;
592		}
593
594		prev_block = inftl->VUtable[thisVUC];
595		if (prev_block < inftl->nb_blocks)
596			prev_block -= inftl->firstEUN;
597
598		parity = (nrbits(thisVUC, 16) & 0x1) ? 0x1 : 0;
599		parity |= (nrbits(prev_block, 16) & 0x1) ? 0x2 : 0;
600		parity |= (nrbits(anac, 8) & 0x1) ? 0x4 : 0;
601		parity |= (nrbits(nacs, 8) & 0x1) ? 0x8 : 0;
602
603		oob.u.a.virtualUnitNo = cpu_to_le16(thisVUC);
604		oob.u.a.prevUnitNo = cpu_to_le16(prev_block);
605		oob.u.a.ANAC = anac;
606		oob.u.a.NACs = nacs;
607		oob.u.a.parityPerField = parity;
608		oob.u.a.discarded = 0xaa;
609
610		inftl_write_oob(mtd, writeEUN * inftl->EraseSize + 8, 8,
611				&retlen, (char *)&oob.u);
612
613		/* Also back up header... */
614		oob.u.b.virtualUnitNo = cpu_to_le16(thisVUC);
615		oob.u.b.prevUnitNo = cpu_to_le16(prev_block);
616		oob.u.b.ANAC = anac;
617		oob.u.b.NACs = nacs;
618		oob.u.b.parityPerField = parity;
619		oob.u.b.discarded = 0xaa;
620
621		inftl_write_oob(mtd, writeEUN * inftl->EraseSize +
622				SECTORSIZE * 4 + 8, 8, &retlen, (char *)&oob.u);
623
624		inftl->PUtable[writeEUN] = inftl->VUtable[thisVUC];
625		inftl->VUtable[thisVUC] = writeEUN;
626
627		inftl->numfreeEUNs--;
628		return writeEUN;
629
630	} while (silly2--);
631
632	printk(KERN_WARNING "INFTL: error folding to make room for Virtual "
633		"Unit Chain 0x%x\n", thisVUC);
634	return BLOCK_NIL;
635}
636
637/*
638 * Given a Virtual Unit Chain, see if it can be deleted, and if so do it.
639 */
640static void INFTL_trydeletechain(struct INFTLrecord *inftl, unsigned thisVUC)
641{
642	struct mtd_info *mtd = inftl->mbd.mtd;
643	unsigned char BlockUsed[MAX_SECTORS_PER_UNIT];
644	unsigned char BlockDeleted[MAX_SECTORS_PER_UNIT];
645	unsigned int thisEUN, status;
646	int block, silly;
647	struct inftl_bci bci;
648	size_t retlen;
649
650	DEBUG(MTD_DEBUG_LEVEL3, "INFTL: INFTL_trydeletechain(inftl=%p,"
651		"thisVUC=%d)\n", inftl, thisVUC);
652
653	memset(BlockUsed, 0, sizeof(BlockUsed));
654	memset(BlockDeleted, 0, sizeof(BlockDeleted));
655
656	thisEUN = inftl->VUtable[thisVUC];
657	if (thisEUN == BLOCK_NIL) {
658		printk(KERN_WARNING "INFTL: trying to delete non-existent "
659		       "Virtual Unit Chain %d!\n", thisVUC);
660		return;
661	}
662
663	/*
664	 * Scan through the Erase Units to determine whether any data is in
665	 * each of the 512-byte blocks within the Chain.
666	 */
667	silly = MAX_LOOPS;
668	while (thisEUN < inftl->nb_blocks) {
669		for (block = 0; block < inftl->EraseSize/SECTORSIZE; block++) {
670			if (BlockUsed[block] || BlockDeleted[block])
671				continue;
672
673			if (inftl_read_oob(mtd, (thisEUN * inftl->EraseSize)
674					   + (block * SECTORSIZE), 8 , &retlen,
675					  (char *)&bci) < 0)
676				status = SECTOR_IGNORE;
677			else
678				status = bci.Status | bci.Status1;
679
680			switch(status) {
681			case SECTOR_FREE:
682			case SECTOR_IGNORE:
683				break;
684			case SECTOR_USED:
685				BlockUsed[block] = 1;
686				continue;
687			case SECTOR_DELETED:
688				BlockDeleted[block] = 1;
689				continue;
690			default:
691				printk(KERN_WARNING "INFTL: unknown status "
692					"for block %d in EUN %d: 0x%x\n",
693					block, thisEUN, status);
694			}
695		}
696
697		if (!silly--) {
698			printk(KERN_WARNING "INFTL: infinite loop in Virtual "
699				"Unit Chain 0x%x\n", thisVUC);
700			return;
701		}
702
703		thisEUN = inftl->PUtable[thisEUN];
704	}
705
706	for (block = 0; block < inftl->EraseSize/SECTORSIZE; block++)
707		if (BlockUsed[block])
708			return;
709
710	/*
711	 * For each block in the chain free it and make it available
712	 * for future use. Erase from the oldest unit first.
713	 */
714	DEBUG(MTD_DEBUG_LEVEL1, "INFTL: deleting empty VUC %d\n", thisVUC);
715
716	for (;;) {
717		u16 *prevEUN = &inftl->VUtable[thisVUC];
718		thisEUN = *prevEUN;
719
720		/* If the chain is all gone already, we're done */
721		if (thisEUN == BLOCK_NIL) {
722			DEBUG(MTD_DEBUG_LEVEL2, "INFTL: Empty VUC %d for deletion was already absent\n", thisEUN);
723			return;
724		}
725
726		/* Find oldest unit in chain. */
727		while (inftl->PUtable[thisEUN] != BLOCK_NIL) {
728			BUG_ON(thisEUN >= inftl->nb_blocks);
729
730			prevEUN = &inftl->PUtable[thisEUN];
731			thisEUN = *prevEUN;
732		}
733
734		DEBUG(MTD_DEBUG_LEVEL3, "Deleting EUN %d from VUC %d\n",
735		      thisEUN, thisVUC);
736
737		if (INFTL_formatblock(inftl, thisEUN) < 0) {
738			/*
739			 * Could not erase : mark block as reserved.
740			 */
741			inftl->PUtable[thisEUN] = BLOCK_RESERVED;
742		} else {
743			/* Correctly erased : mark it as free */
744			inftl->PUtable[thisEUN] = BLOCK_FREE;
745			inftl->numfreeEUNs++;
746		}
747
748		/* Now sort out whatever was pointing to it... */
749		*prevEUN = BLOCK_NIL;
750
751		/* Ideally we'd actually be responsive to new
752		   requests while we're doing this -- if there's
753		   free space why should others be made to wait? */
754		cond_resched();
755	}
756
757	inftl->VUtable[thisVUC] = BLOCK_NIL;
758}
759
760static int INFTL_deleteblock(struct INFTLrecord *inftl, unsigned block)
761{
762	unsigned int thisEUN = inftl->VUtable[block / (inftl->EraseSize / SECTORSIZE)];
763	unsigned long blockofs = (block * SECTORSIZE) & (inftl->EraseSize - 1);
764	struct mtd_info *mtd = inftl->mbd.mtd;
765	unsigned int status;
766	int silly = MAX_LOOPS;
767	size_t retlen;
768	struct inftl_bci bci;
769
770	DEBUG(MTD_DEBUG_LEVEL3, "INFTL: INFTL_deleteblock(inftl=%p,"
771		"block=%d)\n", inftl, block);
772
773	while (thisEUN < inftl->nb_blocks) {
774		if (inftl_read_oob(mtd, (thisEUN * inftl->EraseSize) +
775				   blockofs, 8, &retlen, (char *)&bci) < 0)
776			status = SECTOR_IGNORE;
777		else
778			status = bci.Status | bci.Status1;
779
780		switch (status) {
781		case SECTOR_FREE:
782		case SECTOR_IGNORE:
783			break;
784		case SECTOR_DELETED:
785			thisEUN = BLOCK_NIL;
786			goto foundit;
787		case SECTOR_USED:
788			goto foundit;
789		default:
790			printk(KERN_WARNING "INFTL: unknown status for "
791				"block %d in EUN %d: 0x%x\n",
792				block, thisEUN, status);
793			break;
794		}
795
796		if (!silly--) {
797			printk(KERN_WARNING "INFTL: infinite loop in Virtual "
798				"Unit Chain 0x%x\n",
799				block / (inftl->EraseSize / SECTORSIZE));
800			return 1;
801		}
802		thisEUN = inftl->PUtable[thisEUN];
803	}
804
805foundit:
806	if (thisEUN != BLOCK_NIL) {
807		loff_t ptr = (thisEUN * inftl->EraseSize) + blockofs;
808
809		if (inftl_read_oob(mtd, ptr, 8, &retlen, (char *)&bci) < 0)
810			return -EIO;
811		bci.Status = bci.Status1 = SECTOR_DELETED;
812		if (inftl_write_oob(mtd, ptr, 8, &retlen, (char *)&bci) < 0)
813			return -EIO;
814		INFTL_trydeletechain(inftl, block / (inftl->EraseSize / SECTORSIZE));
815	}
816	return 0;
817}
818
819static int inftl_writeblock(struct mtd_blktrans_dev *mbd, unsigned long block,
820			    char *buffer)
821{
822	struct INFTLrecord *inftl = (void *)mbd;
823	unsigned int writeEUN;
824	unsigned long blockofs = (block * SECTORSIZE) & (inftl->EraseSize - 1);
825	size_t retlen;
826	struct inftl_oob oob;
827	char *p, *pend;
828
829	DEBUG(MTD_DEBUG_LEVEL3, "INFTL: inftl_writeblock(inftl=%p,block=%ld,"
830		"buffer=%p)\n", inftl, block, buffer);
831
832	/* Is block all zero? */
833	pend = buffer + SECTORSIZE;
834	for (p = buffer; p < pend && !*p; p++)
835		;
836
837	if (p < pend) {
838		writeEUN = INFTL_findwriteunit(inftl, block);
839
840		if (writeEUN == BLOCK_NIL) {
841			printk(KERN_WARNING "inftl_writeblock(): cannot find "
842				"block to write to\n");
843			/*
844			 * If we _still_ haven't got a block to use,
845			 * we're screwed.
846			 */
847			return 1;
848		}
849
850		memset(&oob, 0xff, sizeof(struct inftl_oob));
851		oob.b.Status = oob.b.Status1 = SECTOR_USED;
852
853		inftl_write(inftl->mbd.mtd, (writeEUN * inftl->EraseSize) +
854			    blockofs, SECTORSIZE, &retlen, (char *)buffer,
855			    (char *)&oob);
856		/*
857		 * need to write SECTOR_USED flags since they are not written
858		 * in mtd_writeecc
859		 */
860	} else {
861		INFTL_deleteblock(inftl, block);
862	}
863
864	return 0;
865}
866
867static int inftl_readblock(struct mtd_blktrans_dev *mbd, unsigned long block,
868			   char *buffer)
869{
870	struct INFTLrecord *inftl = (void *)mbd;
871	unsigned int thisEUN = inftl->VUtable[block / (inftl->EraseSize / SECTORSIZE)];
872	unsigned long blockofs = (block * SECTORSIZE) & (inftl->EraseSize - 1);
873	struct mtd_info *mtd = inftl->mbd.mtd;
874	unsigned int status;
875	int silly = MAX_LOOPS;
876	struct inftl_bci bci;
877	size_t retlen;
878
879	DEBUG(MTD_DEBUG_LEVEL3, "INFTL: inftl_readblock(inftl=%p,block=%ld,"
880		"buffer=%p)\n", inftl, block, buffer);
881
882	while (thisEUN < inftl->nb_blocks) {
883		if (inftl_read_oob(mtd, (thisEUN * inftl->EraseSize) +
884				  blockofs, 8, &retlen, (char *)&bci) < 0)
885			status = SECTOR_IGNORE;
886		else
887			status = bci.Status | bci.Status1;
888
889		switch (status) {
890		case SECTOR_DELETED:
891			thisEUN = BLOCK_NIL;
892			goto foundit;
893		case SECTOR_USED:
894			goto foundit;
895		case SECTOR_FREE:
896		case SECTOR_IGNORE:
897			break;
898		default:
899			printk(KERN_WARNING "INFTL: unknown status for "
900				"block %ld in EUN %d: 0x%04x\n",
901				block, thisEUN, status);
902			break;
903		}
904
905		if (!silly--) {
906			printk(KERN_WARNING "INFTL: infinite loop in "
907				"Virtual Unit Chain 0x%lx\n",
908				block / (inftl->EraseSize / SECTORSIZE));
909			return 1;
910		}
911
912		thisEUN = inftl->PUtable[thisEUN];
913	}
914
915foundit:
916	if (thisEUN == BLOCK_NIL) {
917		/* The requested block is not on the media, return all 0x00 */
918		memset(buffer, 0, SECTORSIZE);
919	} else {
920		size_t retlen;
921		loff_t ptr = (thisEUN * inftl->EraseSize) + blockofs;
922		int ret = mtd->read(mtd, ptr, SECTORSIZE, &retlen, buffer);
923
924		/* Handle corrected bit flips gracefully */
925		if (ret < 0 && ret != -EUCLEAN)
926			return -EIO;
927	}
928	return 0;
929}
930
931static int inftl_getgeo(struct mtd_blktrans_dev *dev, struct hd_geometry *geo)
932{
933	struct INFTLrecord *inftl = (void *)dev;
934
935	geo->heads = inftl->heads;
936	geo->sectors = inftl->sectors;
937	geo->cylinders = inftl->cylinders;
938
939	return 0;
940}
941
942static struct mtd_blktrans_ops inftl_tr = {
943	.name		= "inftl",
944	.major		= INFTL_MAJOR,
945	.part_bits	= INFTL_PARTN_BITS,
946	.blksize 	= 512,
947	.getgeo		= inftl_getgeo,
948	.readsect	= inftl_readblock,
949	.writesect	= inftl_writeblock,
950	.add_mtd	= inftl_add_mtd,
951	.remove_dev	= inftl_remove_dev,
952	.owner		= THIS_MODULE,
953};
954
955static int __init init_inftl(void)
956{
957	return register_mtd_blktrans(&inftl_tr);
958}
959
960static void __exit cleanup_inftl(void)
961{
962	deregister_mtd_blktrans(&inftl_tr);
963}
964
965module_init(init_inftl);
966module_exit(cleanup_inftl);
967
968MODULE_LICENSE("GPL");
969MODULE_AUTHOR("Greg Ungerer <gerg@snapgear.com>, David Woodhouse <dwmw2@infradead.org>, Fabrice Bellard <fabrice.bellard@netgem.com> et al.");
970MODULE_DESCRIPTION("Support code for Inverse Flash Translation Layer, used on M-Systems DiskOnChip 2000, Millennium and Millennium Plus");
v4.10.11
  1/*
  2 * inftlcore.c -- Linux driver for Inverse Flash Translation Layer (INFTL)
  3 *
  4 * Copyright © 2002, Greg Ungerer (gerg@snapgear.com)
  5 *
  6 * Based heavily on the nftlcore.c code which is:
  7 * Copyright © 1999 Machine Vision Holdings, Inc.
  8 * Copyright © 1999 David Woodhouse <dwmw2@infradead.org>
  9 *
 10 * This program is free software; you can redistribute it and/or modify
 11 * it under the terms of the GNU General Public License as published by
 12 * the Free Software Foundation; either version 2 of the License, or
 13 * (at your option) any later version.
 14 *
 15 * This program is distributed in the hope that it will be useful,
 16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 18 * GNU General Public License for more details.
 19 *
 20 * You should have received a copy of the GNU General Public License
 21 * along with this program; if not, write to the Free Software
 22 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 23 */
 24
 25#include <linux/kernel.h>
 26#include <linux/module.h>
 27#include <linux/delay.h>
 28#include <linux/slab.h>
 29#include <linux/sched.h>
 30#include <linux/init.h>
 31#include <linux/kmod.h>
 32#include <linux/hdreg.h>
 33#include <linux/mtd/mtd.h>
 34#include <linux/mtd/nftl.h>
 35#include <linux/mtd/inftl.h>
 36#include <linux/mtd/nand.h>
 37#include <linux/uaccess.h>
 38#include <asm/errno.h>
 39#include <asm/io.h>
 40
 41/*
 42 * Maximum number of loops while examining next block, to have a
 43 * chance to detect consistency problems (they should never happen
 44 * because of the checks done in the mounting.
 45 */
 46#define MAX_LOOPS 10000
 47
 48static void inftl_add_mtd(struct mtd_blktrans_ops *tr, struct mtd_info *mtd)
 49{
 50	struct INFTLrecord *inftl;
 51	unsigned long temp;
 52
 53	if (!mtd_type_is_nand(mtd) || mtd->size > UINT_MAX)
 54		return;
 55	/* OK, this is moderately ugly.  But probably safe.  Alternatives? */
 56	if (memcmp(mtd->name, "DiskOnChip", 10))
 57		return;
 58
 59	if (!mtd->_block_isbad) {
 60		printk(KERN_ERR
 61"INFTL no longer supports the old DiskOnChip drivers loaded via docprobe.\n"
 62"Please use the new diskonchip driver under the NAND subsystem.\n");
 63		return;
 64	}
 65
 66	pr_debug("INFTL: add_mtd for %s\n", mtd->name);
 67
 68	inftl = kzalloc(sizeof(*inftl), GFP_KERNEL);
 69
 70	if (!inftl)
 
 71		return;
 
 72
 73	inftl->mbd.mtd = mtd;
 74	inftl->mbd.devnum = -1;
 75
 76	inftl->mbd.tr = tr;
 77
 78	if (INFTL_mount(inftl) < 0) {
 79		printk(KERN_WARNING "INFTL: could not mount device\n");
 80		kfree(inftl);
 81		return;
 82	}
 83
 84	/* OK, it's a new one. Set up all the data structures. */
 85
 86	/* Calculate geometry */
 87	inftl->cylinders = 1024;
 88	inftl->heads = 16;
 89
 90	temp = inftl->cylinders * inftl->heads;
 91	inftl->sectors = inftl->mbd.size / temp;
 92	if (inftl->mbd.size % temp) {
 93		inftl->sectors++;
 94		temp = inftl->cylinders * inftl->sectors;
 95		inftl->heads = inftl->mbd.size / temp;
 96
 97		if (inftl->mbd.size % temp) {
 98			inftl->heads++;
 99			temp = inftl->heads * inftl->sectors;
100			inftl->cylinders = inftl->mbd.size / temp;
101		}
102	}
103
104	if (inftl->mbd.size != inftl->heads * inftl->cylinders * inftl->sectors) {
105		/*
106		  Oh no we don't have
107		   mbd.size == heads * cylinders * sectors
108		*/
109		printk(KERN_WARNING "INFTL: cannot calculate a geometry to "
110		       "match size of 0x%lx.\n", inftl->mbd.size);
111		printk(KERN_WARNING "INFTL: using C:%d H:%d S:%d "
112			"(== 0x%lx sects)\n",
113			inftl->cylinders, inftl->heads , inftl->sectors,
114			(long)inftl->cylinders * (long)inftl->heads *
115			(long)inftl->sectors );
116	}
117
118	if (add_mtd_blktrans_dev(&inftl->mbd)) {
119		kfree(inftl->PUtable);
120		kfree(inftl->VUtable);
121		kfree(inftl);
122		return;
123	}
124#ifdef PSYCHO_DEBUG
125	printk(KERN_INFO "INFTL: Found new inftl%c\n", inftl->mbd.devnum + 'a');
126#endif
127	return;
128}
129
130static void inftl_remove_dev(struct mtd_blktrans_dev *dev)
131{
132	struct INFTLrecord *inftl = (void *)dev;
133
134	pr_debug("INFTL: remove_dev (i=%d)\n", dev->devnum);
135
136	del_mtd_blktrans_dev(dev);
137
138	kfree(inftl->PUtable);
139	kfree(inftl->VUtable);
140}
141
142/*
143 * Actual INFTL access routines.
144 */
145
146/*
147 * Read oob data from flash
148 */
149int inftl_read_oob(struct mtd_info *mtd, loff_t offs, size_t len,
150		   size_t *retlen, uint8_t *buf)
151{
152	struct mtd_oob_ops ops;
153	int res;
154
155	ops.mode = MTD_OPS_PLACE_OOB;
156	ops.ooboffs = offs & (mtd->writesize - 1);
157	ops.ooblen = len;
158	ops.oobbuf = buf;
159	ops.datbuf = NULL;
160
161	res = mtd_read_oob(mtd, offs & ~(mtd->writesize - 1), &ops);
162	*retlen = ops.oobretlen;
163	return res;
164}
165
166/*
167 * Write oob data to flash
168 */
169int inftl_write_oob(struct mtd_info *mtd, loff_t offs, size_t len,
170		    size_t *retlen, uint8_t *buf)
171{
172	struct mtd_oob_ops ops;
173	int res;
174
175	ops.mode = MTD_OPS_PLACE_OOB;
176	ops.ooboffs = offs & (mtd->writesize - 1);
177	ops.ooblen = len;
178	ops.oobbuf = buf;
179	ops.datbuf = NULL;
180
181	res = mtd_write_oob(mtd, offs & ~(mtd->writesize - 1), &ops);
182	*retlen = ops.oobretlen;
183	return res;
184}
185
186/*
187 * Write data and oob to flash
188 */
189static int inftl_write(struct mtd_info *mtd, loff_t offs, size_t len,
190		       size_t *retlen, uint8_t *buf, uint8_t *oob)
191{
192	struct mtd_oob_ops ops;
193	int res;
194
195	ops.mode = MTD_OPS_PLACE_OOB;
196	ops.ooboffs = offs;
197	ops.ooblen = mtd->oobsize;
198	ops.oobbuf = oob;
199	ops.datbuf = buf;
200	ops.len = len;
201
202	res = mtd_write_oob(mtd, offs & ~(mtd->writesize - 1), &ops);
203	*retlen = ops.retlen;
204	return res;
205}
206
207/*
208 * INFTL_findfreeblock: Find a free Erase Unit on the INFTL partition.
209 *	This function is used when the give Virtual Unit Chain.
210 */
211static u16 INFTL_findfreeblock(struct INFTLrecord *inftl, int desperate)
212{
213	u16 pot = inftl->LastFreeEUN;
214	int silly = inftl->nb_blocks;
215
216	pr_debug("INFTL: INFTL_findfreeblock(inftl=%p,desperate=%d)\n",
217			inftl, desperate);
218
219	/*
220	 * Normally, we force a fold to happen before we run out of free
221	 * blocks completely.
222	 */
223	if (!desperate && inftl->numfreeEUNs < 2) {
224		pr_debug("INFTL: there are too few free EUNs (%d)\n",
225				inftl->numfreeEUNs);
226		return BLOCK_NIL;
227	}
228
229	/* Scan for a free block */
230	do {
231		if (inftl->PUtable[pot] == BLOCK_FREE) {
232			inftl->LastFreeEUN = pot;
233			return pot;
234		}
235
236		if (++pot > inftl->lastEUN)
237			pot = 0;
238
239		if (!silly--) {
240			printk(KERN_WARNING "INFTL: no free blocks found!  "
241				"EUN range = %d - %d\n", 0, inftl->LastFreeEUN);
242			return BLOCK_NIL;
243		}
244	} while (pot != inftl->LastFreeEUN);
245
246	return BLOCK_NIL;
247}
248
249static u16 INFTL_foldchain(struct INFTLrecord *inftl, unsigned thisVUC, unsigned pendingblock)
250{
251	u16 BlockMap[MAX_SECTORS_PER_UNIT];
252	unsigned char BlockDeleted[MAX_SECTORS_PER_UNIT];
253	unsigned int thisEUN, prevEUN, status;
254	struct mtd_info *mtd = inftl->mbd.mtd;
255	int block, silly;
256	unsigned int targetEUN;
257	struct inftl_oob oob;
258	size_t retlen;
259
260	pr_debug("INFTL: INFTL_foldchain(inftl=%p,thisVUC=%d,pending=%d)\n",
261			inftl, thisVUC, pendingblock);
262
263	memset(BlockMap, 0xff, sizeof(BlockMap));
264	memset(BlockDeleted, 0, sizeof(BlockDeleted));
265
266	thisEUN = targetEUN = inftl->VUtable[thisVUC];
267
268	if (thisEUN == BLOCK_NIL) {
269		printk(KERN_WARNING "INFTL: trying to fold non-existent "
270		       "Virtual Unit Chain %d!\n", thisVUC);
271		return BLOCK_NIL;
272	}
273
274	/*
275	 * Scan to find the Erase Unit which holds the actual data for each
276	 * 512-byte block within the Chain.
277	 */
278	silly = MAX_LOOPS;
279	while (thisEUN < inftl->nb_blocks) {
280		for (block = 0; block < inftl->EraseSize/SECTORSIZE; block ++) {
281			if ((BlockMap[block] != BLOCK_NIL) ||
282			    BlockDeleted[block])
283				continue;
284
285			if (inftl_read_oob(mtd, (thisEUN * inftl->EraseSize)
286					   + (block * SECTORSIZE), 16, &retlen,
287					   (char *)&oob) < 0)
288				status = SECTOR_IGNORE;
289			else
290				status = oob.b.Status | oob.b.Status1;
291
292			switch(status) {
293			case SECTOR_FREE:
294			case SECTOR_IGNORE:
295				break;
296			case SECTOR_USED:
297				BlockMap[block] = thisEUN;
298				continue;
299			case SECTOR_DELETED:
300				BlockDeleted[block] = 1;
301				continue;
302			default:
303				printk(KERN_WARNING "INFTL: unknown status "
304					"for block %d in EUN %d: %x\n",
305					block, thisEUN, status);
306				break;
307			}
308		}
309
310		if (!silly--) {
311			printk(KERN_WARNING "INFTL: infinite loop in Virtual "
312				"Unit Chain 0x%x\n", thisVUC);
313			return BLOCK_NIL;
314		}
315
316		thisEUN = inftl->PUtable[thisEUN];
317	}
318
319	/*
320	 * OK. We now know the location of every block in the Virtual Unit
321	 * Chain, and the Erase Unit into which we are supposed to be copying.
322	 * Go for it.
323	 */
324	pr_debug("INFTL: folding chain %d into unit %d\n", thisVUC, targetEUN);
 
325
326	for (block = 0; block < inftl->EraseSize/SECTORSIZE ; block++) {
327		unsigned char movebuf[SECTORSIZE];
328		int ret;
329
330		/*
331		 * If it's in the target EUN already, or if it's pending write,
332		 * do nothing.
333		 */
334		if (BlockMap[block] == targetEUN || (pendingblock ==
335		    (thisVUC * (inftl->EraseSize / SECTORSIZE) + block))) {
336			continue;
337		}
338
339		/*
340		 * Copy only in non free block (free blocks can only
341                 * happen in case of media errors or deleted blocks).
342		 */
343		if (BlockMap[block] == BLOCK_NIL)
344			continue;
345
346		ret = mtd_read(mtd,
347			       (inftl->EraseSize * BlockMap[block]) + (block * SECTORSIZE),
348			       SECTORSIZE,
349			       &retlen,
350			       movebuf);
351		if (ret < 0 && !mtd_is_bitflip(ret)) {
352			ret = mtd_read(mtd,
353				       (inftl->EraseSize * BlockMap[block]) + (block * SECTORSIZE),
354				       SECTORSIZE,
355				       &retlen,
356				       movebuf);
357			if (ret != -EIO)
358				pr_debug("INFTL: error went away on retry?\n");
 
359		}
360		memset(&oob, 0xff, sizeof(struct inftl_oob));
361		oob.b.Status = oob.b.Status1 = SECTOR_USED;
362
363		inftl_write(inftl->mbd.mtd, (inftl->EraseSize * targetEUN) +
364			    (block * SECTORSIZE), SECTORSIZE, &retlen,
365			    movebuf, (char *)&oob);
366	}
367
368	/*
369	 * Newest unit in chain now contains data from _all_ older units.
370	 * So go through and erase each unit in chain, oldest first. (This
371	 * is important, by doing oldest first if we crash/reboot then it
372	 * it is relatively simple to clean up the mess).
373	 */
374	pr_debug("INFTL: want to erase virtual chain %d\n", thisVUC);
 
375
376	for (;;) {
377		/* Find oldest unit in chain. */
378		thisEUN = inftl->VUtable[thisVUC];
379		prevEUN = BLOCK_NIL;
380		while (inftl->PUtable[thisEUN] != BLOCK_NIL) {
381			prevEUN = thisEUN;
382			thisEUN = inftl->PUtable[thisEUN];
383		}
384
385		/* Check if we are all done */
386		if (thisEUN == targetEUN)
387			break;
388
389		/* Unlink the last block from the chain. */
390		inftl->PUtable[prevEUN] = BLOCK_NIL;
391
392		/* Now try to erase it. */
393		if (INFTL_formatblock(inftl, thisEUN) < 0) {
394			/*
395			 * Could not erase : mark block as reserved.
396			 */
397			inftl->PUtable[thisEUN] = BLOCK_RESERVED;
398		} else {
399			/* Correctly erased : mark it as free */
400			inftl->PUtable[thisEUN] = BLOCK_FREE;
401			inftl->numfreeEUNs++;
402		}
403	}
404
405	return targetEUN;
406}
407
408static u16 INFTL_makefreeblock(struct INFTLrecord *inftl, unsigned pendingblock)
409{
410	/*
411	 * This is the part that needs some cleverness applied.
412	 * For now, I'm doing the minimum applicable to actually
413	 * get the thing to work.
414	 * Wear-levelling and other clever stuff needs to be implemented
415	 * and we also need to do some assessment of the results when
416	 * the system loses power half-way through the routine.
417	 */
418	u16 LongestChain = 0;
419	u16 ChainLength = 0, thislen;
420	u16 chain, EUN;
421
422	pr_debug("INFTL: INFTL_makefreeblock(inftl=%p,"
423		"pending=%d)\n", inftl, pendingblock);
424
425	for (chain = 0; chain < inftl->nb_blocks; chain++) {
426		EUN = inftl->VUtable[chain];
427		thislen = 0;
428
429		while (EUN <= inftl->lastEUN) {
430			thislen++;
431			EUN = inftl->PUtable[EUN];
432			if (thislen > 0xff00) {
433				printk(KERN_WARNING "INFTL: endless loop in "
434					"Virtual Chain %d: Unit %x\n",
435					chain, EUN);
436				/*
437				 * Actually, don't return failure.
438				 * Just ignore this chain and get on with it.
439				 */
440				thislen = 0;
441				break;
442			}
443		}
444
445		if (thislen > ChainLength) {
446			ChainLength = thislen;
447			LongestChain = chain;
448		}
449	}
450
451	if (ChainLength < 2) {
452		printk(KERN_WARNING "INFTL: no Virtual Unit Chains available "
453			"for folding. Failing request\n");
454		return BLOCK_NIL;
455	}
456
457	return INFTL_foldchain(inftl, LongestChain, pendingblock);
458}
459
460static int nrbits(unsigned int val, int bitcount)
461{
462	int i, total = 0;
463
464	for (i = 0; (i < bitcount); i++)
465		total += (((0x1 << i) & val) ? 1 : 0);
466	return total;
467}
468
469/*
470 * INFTL_findwriteunit: Return the unit number into which we can write
471 *                      for this block. Make it available if it isn't already.
472 */
473static inline u16 INFTL_findwriteunit(struct INFTLrecord *inftl, unsigned block)
474{
475	unsigned int thisVUC = block / (inftl->EraseSize / SECTORSIZE);
476	unsigned int thisEUN, writeEUN, prev_block, status;
477	unsigned long blockofs = (block * SECTORSIZE) & (inftl->EraseSize -1);
478	struct mtd_info *mtd = inftl->mbd.mtd;
479	struct inftl_oob oob;
480	struct inftl_bci bci;
481	unsigned char anac, nacs, parity;
482	size_t retlen;
483	int silly, silly2 = 3;
484
485	pr_debug("INFTL: INFTL_findwriteunit(inftl=%p,block=%d)\n",
486			inftl, block);
487
488	do {
489		/*
490		 * Scan the media to find a unit in the VUC which has
491		 * a free space for the block in question.
492		 */
493		writeEUN = BLOCK_NIL;
494		thisEUN = inftl->VUtable[thisVUC];
495		silly = MAX_LOOPS;
496
497		while (thisEUN <= inftl->lastEUN) {
498			inftl_read_oob(mtd, (thisEUN * inftl->EraseSize) +
499				       blockofs, 8, &retlen, (char *)&bci);
500
501			status = bci.Status | bci.Status1;
502			pr_debug("INFTL: status of block %d in EUN %d is %x\n",
503					block , writeEUN, status);
504
505			switch(status) {
506			case SECTOR_FREE:
507				writeEUN = thisEUN;
508				break;
509			case SECTOR_DELETED:
510			case SECTOR_USED:
511				/* Can't go any further */
512				goto hitused;
513			case SECTOR_IGNORE:
514				break;
515			default:
516				/*
517				 * Invalid block. Don't use it any more.
518				 * Must implement.
519				 */
520				break;
521			}
522
523			if (!silly--) {
524				printk(KERN_WARNING "INFTL: infinite loop in "
525					"Virtual Unit Chain 0x%x\n", thisVUC);
526				return BLOCK_NIL;
527			}
528
529			/* Skip to next block in chain */
530			thisEUN = inftl->PUtable[thisEUN];
531		}
532
533hitused:
534		if (writeEUN != BLOCK_NIL)
535			return writeEUN;
536
537
538		/*
539		 * OK. We didn't find one in the existing chain, or there
540		 * is no existing chain. Allocate a new one.
541		 */
542		writeEUN = INFTL_findfreeblock(inftl, 0);
543
544		if (writeEUN == BLOCK_NIL) {
545			/*
546			 * That didn't work - there were no free blocks just
547			 * waiting to be picked up. We're going to have to fold
548			 * a chain to make room.
549			 */
550			thisEUN = INFTL_makefreeblock(inftl, block);
551
552			/*
553			 * Hopefully we free something, lets try again.
554			 * This time we are desperate...
555			 */
556			pr_debug("INFTL: using desperate==1 to find free EUN "
557					"to accommodate write to VUC %d\n",
558					thisVUC);
559			writeEUN = INFTL_findfreeblock(inftl, 1);
560			if (writeEUN == BLOCK_NIL) {
561				/*
562				 * Ouch. This should never happen - we should
563				 * always be able to make some room somehow.
564				 * If we get here, we've allocated more storage
565				 * space than actual media, or our makefreeblock
566				 * routine is missing something.
567				 */
568				printk(KERN_WARNING "INFTL: cannot make free "
569					"space.\n");
570#ifdef DEBUG
571				INFTL_dumptables(inftl);
572				INFTL_dumpVUchains(inftl);
573#endif
574				return BLOCK_NIL;
575			}
576		}
577
578		/*
579		 * Insert new block into virtual chain. Firstly update the
580		 * block headers in flash...
581		 */
582		anac = 0;
583		nacs = 0;
584		thisEUN = inftl->VUtable[thisVUC];
585		if (thisEUN != BLOCK_NIL) {
586			inftl_read_oob(mtd, thisEUN * inftl->EraseSize
587				       + 8, 8, &retlen, (char *)&oob.u);
588			anac = oob.u.a.ANAC + 1;
589			nacs = oob.u.a.NACs + 1;
590		}
591
592		prev_block = inftl->VUtable[thisVUC];
593		if (prev_block < inftl->nb_blocks)
594			prev_block -= inftl->firstEUN;
595
596		parity = (nrbits(thisVUC, 16) & 0x1) ? 0x1 : 0;
597		parity |= (nrbits(prev_block, 16) & 0x1) ? 0x2 : 0;
598		parity |= (nrbits(anac, 8) & 0x1) ? 0x4 : 0;
599		parity |= (nrbits(nacs, 8) & 0x1) ? 0x8 : 0;
600
601		oob.u.a.virtualUnitNo = cpu_to_le16(thisVUC);
602		oob.u.a.prevUnitNo = cpu_to_le16(prev_block);
603		oob.u.a.ANAC = anac;
604		oob.u.a.NACs = nacs;
605		oob.u.a.parityPerField = parity;
606		oob.u.a.discarded = 0xaa;
607
608		inftl_write_oob(mtd, writeEUN * inftl->EraseSize + 8, 8,
609				&retlen, (char *)&oob.u);
610
611		/* Also back up header... */
612		oob.u.b.virtualUnitNo = cpu_to_le16(thisVUC);
613		oob.u.b.prevUnitNo = cpu_to_le16(prev_block);
614		oob.u.b.ANAC = anac;
615		oob.u.b.NACs = nacs;
616		oob.u.b.parityPerField = parity;
617		oob.u.b.discarded = 0xaa;
618
619		inftl_write_oob(mtd, writeEUN * inftl->EraseSize +
620				SECTORSIZE * 4 + 8, 8, &retlen, (char *)&oob.u);
621
622		inftl->PUtable[writeEUN] = inftl->VUtable[thisVUC];
623		inftl->VUtable[thisVUC] = writeEUN;
624
625		inftl->numfreeEUNs--;
626		return writeEUN;
627
628	} while (silly2--);
629
630	printk(KERN_WARNING "INFTL: error folding to make room for Virtual "
631		"Unit Chain 0x%x\n", thisVUC);
632	return BLOCK_NIL;
633}
634
635/*
636 * Given a Virtual Unit Chain, see if it can be deleted, and if so do it.
637 */
638static void INFTL_trydeletechain(struct INFTLrecord *inftl, unsigned thisVUC)
639{
640	struct mtd_info *mtd = inftl->mbd.mtd;
641	unsigned char BlockUsed[MAX_SECTORS_PER_UNIT];
642	unsigned char BlockDeleted[MAX_SECTORS_PER_UNIT];
643	unsigned int thisEUN, status;
644	int block, silly;
645	struct inftl_bci bci;
646	size_t retlen;
647
648	pr_debug("INFTL: INFTL_trydeletechain(inftl=%p,"
649		"thisVUC=%d)\n", inftl, thisVUC);
650
651	memset(BlockUsed, 0, sizeof(BlockUsed));
652	memset(BlockDeleted, 0, sizeof(BlockDeleted));
653
654	thisEUN = inftl->VUtable[thisVUC];
655	if (thisEUN == BLOCK_NIL) {
656		printk(KERN_WARNING "INFTL: trying to delete non-existent "
657		       "Virtual Unit Chain %d!\n", thisVUC);
658		return;
659	}
660
661	/*
662	 * Scan through the Erase Units to determine whether any data is in
663	 * each of the 512-byte blocks within the Chain.
664	 */
665	silly = MAX_LOOPS;
666	while (thisEUN < inftl->nb_blocks) {
667		for (block = 0; block < inftl->EraseSize/SECTORSIZE; block++) {
668			if (BlockUsed[block] || BlockDeleted[block])
669				continue;
670
671			if (inftl_read_oob(mtd, (thisEUN * inftl->EraseSize)
672					   + (block * SECTORSIZE), 8 , &retlen,
673					  (char *)&bci) < 0)
674				status = SECTOR_IGNORE;
675			else
676				status = bci.Status | bci.Status1;
677
678			switch(status) {
679			case SECTOR_FREE:
680			case SECTOR_IGNORE:
681				break;
682			case SECTOR_USED:
683				BlockUsed[block] = 1;
684				continue;
685			case SECTOR_DELETED:
686				BlockDeleted[block] = 1;
687				continue;
688			default:
689				printk(KERN_WARNING "INFTL: unknown status "
690					"for block %d in EUN %d: 0x%x\n",
691					block, thisEUN, status);
692			}
693		}
694
695		if (!silly--) {
696			printk(KERN_WARNING "INFTL: infinite loop in Virtual "
697				"Unit Chain 0x%x\n", thisVUC);
698			return;
699		}
700
701		thisEUN = inftl->PUtable[thisEUN];
702	}
703
704	for (block = 0; block < inftl->EraseSize/SECTORSIZE; block++)
705		if (BlockUsed[block])
706			return;
707
708	/*
709	 * For each block in the chain free it and make it available
710	 * for future use. Erase from the oldest unit first.
711	 */
712	pr_debug("INFTL: deleting empty VUC %d\n", thisVUC);
713
714	for (;;) {
715		u16 *prevEUN = &inftl->VUtable[thisVUC];
716		thisEUN = *prevEUN;
717
718		/* If the chain is all gone already, we're done */
719		if (thisEUN == BLOCK_NIL) {
720			pr_debug("INFTL: Empty VUC %d for deletion was already absent\n", thisEUN);
721			return;
722		}
723
724		/* Find oldest unit in chain. */
725		while (inftl->PUtable[thisEUN] != BLOCK_NIL) {
726			BUG_ON(thisEUN >= inftl->nb_blocks);
727
728			prevEUN = &inftl->PUtable[thisEUN];
729			thisEUN = *prevEUN;
730		}
731
732		pr_debug("Deleting EUN %d from VUC %d\n",
733		      thisEUN, thisVUC);
734
735		if (INFTL_formatblock(inftl, thisEUN) < 0) {
736			/*
737			 * Could not erase : mark block as reserved.
738			 */
739			inftl->PUtable[thisEUN] = BLOCK_RESERVED;
740		} else {
741			/* Correctly erased : mark it as free */
742			inftl->PUtable[thisEUN] = BLOCK_FREE;
743			inftl->numfreeEUNs++;
744		}
745
746		/* Now sort out whatever was pointing to it... */
747		*prevEUN = BLOCK_NIL;
748
749		/* Ideally we'd actually be responsive to new
750		   requests while we're doing this -- if there's
751		   free space why should others be made to wait? */
752		cond_resched();
753	}
754
755	inftl->VUtable[thisVUC] = BLOCK_NIL;
756}
757
758static int INFTL_deleteblock(struct INFTLrecord *inftl, unsigned block)
759{
760	unsigned int thisEUN = inftl->VUtable[block / (inftl->EraseSize / SECTORSIZE)];
761	unsigned long blockofs = (block * SECTORSIZE) & (inftl->EraseSize - 1);
762	struct mtd_info *mtd = inftl->mbd.mtd;
763	unsigned int status;
764	int silly = MAX_LOOPS;
765	size_t retlen;
766	struct inftl_bci bci;
767
768	pr_debug("INFTL: INFTL_deleteblock(inftl=%p,"
769		"block=%d)\n", inftl, block);
770
771	while (thisEUN < inftl->nb_blocks) {
772		if (inftl_read_oob(mtd, (thisEUN * inftl->EraseSize) +
773				   blockofs, 8, &retlen, (char *)&bci) < 0)
774			status = SECTOR_IGNORE;
775		else
776			status = bci.Status | bci.Status1;
777
778		switch (status) {
779		case SECTOR_FREE:
780		case SECTOR_IGNORE:
781			break;
782		case SECTOR_DELETED:
783			thisEUN = BLOCK_NIL;
784			goto foundit;
785		case SECTOR_USED:
786			goto foundit;
787		default:
788			printk(KERN_WARNING "INFTL: unknown status for "
789				"block %d in EUN %d: 0x%x\n",
790				block, thisEUN, status);
791			break;
792		}
793
794		if (!silly--) {
795			printk(KERN_WARNING "INFTL: infinite loop in Virtual "
796				"Unit Chain 0x%x\n",
797				block / (inftl->EraseSize / SECTORSIZE));
798			return 1;
799		}
800		thisEUN = inftl->PUtable[thisEUN];
801	}
802
803foundit:
804	if (thisEUN != BLOCK_NIL) {
805		loff_t ptr = (thisEUN * inftl->EraseSize) + blockofs;
806
807		if (inftl_read_oob(mtd, ptr, 8, &retlen, (char *)&bci) < 0)
808			return -EIO;
809		bci.Status = bci.Status1 = SECTOR_DELETED;
810		if (inftl_write_oob(mtd, ptr, 8, &retlen, (char *)&bci) < 0)
811			return -EIO;
812		INFTL_trydeletechain(inftl, block / (inftl->EraseSize / SECTORSIZE));
813	}
814	return 0;
815}
816
817static int inftl_writeblock(struct mtd_blktrans_dev *mbd, unsigned long block,
818			    char *buffer)
819{
820	struct INFTLrecord *inftl = (void *)mbd;
821	unsigned int writeEUN;
822	unsigned long blockofs = (block * SECTORSIZE) & (inftl->EraseSize - 1);
823	size_t retlen;
824	struct inftl_oob oob;
825	char *p, *pend;
826
827	pr_debug("INFTL: inftl_writeblock(inftl=%p,block=%ld,"
828		"buffer=%p)\n", inftl, block, buffer);
829
830	/* Is block all zero? */
831	pend = buffer + SECTORSIZE;
832	for (p = buffer; p < pend && !*p; p++)
833		;
834
835	if (p < pend) {
836		writeEUN = INFTL_findwriteunit(inftl, block);
837
838		if (writeEUN == BLOCK_NIL) {
839			printk(KERN_WARNING "inftl_writeblock(): cannot find "
840				"block to write to\n");
841			/*
842			 * If we _still_ haven't got a block to use,
843			 * we're screwed.
844			 */
845			return 1;
846		}
847
848		memset(&oob, 0xff, sizeof(struct inftl_oob));
849		oob.b.Status = oob.b.Status1 = SECTOR_USED;
850
851		inftl_write(inftl->mbd.mtd, (writeEUN * inftl->EraseSize) +
852			    blockofs, SECTORSIZE, &retlen, (char *)buffer,
853			    (char *)&oob);
854		/*
855		 * need to write SECTOR_USED flags since they are not written
856		 * in mtd_writeecc
857		 */
858	} else {
859		INFTL_deleteblock(inftl, block);
860	}
861
862	return 0;
863}
864
865static int inftl_readblock(struct mtd_blktrans_dev *mbd, unsigned long block,
866			   char *buffer)
867{
868	struct INFTLrecord *inftl = (void *)mbd;
869	unsigned int thisEUN = inftl->VUtable[block / (inftl->EraseSize / SECTORSIZE)];
870	unsigned long blockofs = (block * SECTORSIZE) & (inftl->EraseSize - 1);
871	struct mtd_info *mtd = inftl->mbd.mtd;
872	unsigned int status;
873	int silly = MAX_LOOPS;
874	struct inftl_bci bci;
875	size_t retlen;
876
877	pr_debug("INFTL: inftl_readblock(inftl=%p,block=%ld,"
878		"buffer=%p)\n", inftl, block, buffer);
879
880	while (thisEUN < inftl->nb_blocks) {
881		if (inftl_read_oob(mtd, (thisEUN * inftl->EraseSize) +
882				  blockofs, 8, &retlen, (char *)&bci) < 0)
883			status = SECTOR_IGNORE;
884		else
885			status = bci.Status | bci.Status1;
886
887		switch (status) {
888		case SECTOR_DELETED:
889			thisEUN = BLOCK_NIL;
890			goto foundit;
891		case SECTOR_USED:
892			goto foundit;
893		case SECTOR_FREE:
894		case SECTOR_IGNORE:
895			break;
896		default:
897			printk(KERN_WARNING "INFTL: unknown status for "
898				"block %ld in EUN %d: 0x%04x\n",
899				block, thisEUN, status);
900			break;
901		}
902
903		if (!silly--) {
904			printk(KERN_WARNING "INFTL: infinite loop in "
905				"Virtual Unit Chain 0x%lx\n",
906				block / (inftl->EraseSize / SECTORSIZE));
907			return 1;
908		}
909
910		thisEUN = inftl->PUtable[thisEUN];
911	}
912
913foundit:
914	if (thisEUN == BLOCK_NIL) {
915		/* The requested block is not on the media, return all 0x00 */
916		memset(buffer, 0, SECTORSIZE);
917	} else {
918		size_t retlen;
919		loff_t ptr = (thisEUN * inftl->EraseSize) + blockofs;
920		int ret = mtd_read(mtd, ptr, SECTORSIZE, &retlen, buffer);
921
922		/* Handle corrected bit flips gracefully */
923		if (ret < 0 && !mtd_is_bitflip(ret))
924			return -EIO;
925	}
926	return 0;
927}
928
929static int inftl_getgeo(struct mtd_blktrans_dev *dev, struct hd_geometry *geo)
930{
931	struct INFTLrecord *inftl = (void *)dev;
932
933	geo->heads = inftl->heads;
934	geo->sectors = inftl->sectors;
935	geo->cylinders = inftl->cylinders;
936
937	return 0;
938}
939
940static struct mtd_blktrans_ops inftl_tr = {
941	.name		= "inftl",
942	.major		= INFTL_MAJOR,
943	.part_bits	= INFTL_PARTN_BITS,
944	.blksize 	= 512,
945	.getgeo		= inftl_getgeo,
946	.readsect	= inftl_readblock,
947	.writesect	= inftl_writeblock,
948	.add_mtd	= inftl_add_mtd,
949	.remove_dev	= inftl_remove_dev,
950	.owner		= THIS_MODULE,
951};
952
953static int __init init_inftl(void)
954{
955	return register_mtd_blktrans(&inftl_tr);
956}
957
958static void __exit cleanup_inftl(void)
959{
960	deregister_mtd_blktrans(&inftl_tr);
961}
962
963module_init(init_inftl);
964module_exit(cleanup_inftl);
965
966MODULE_LICENSE("GPL");
967MODULE_AUTHOR("Greg Ungerer <gerg@snapgear.com>, David Woodhouse <dwmw2@infradead.org>, Fabrice Bellard <fabrice.bellard@netgem.com> et al.");
968MODULE_DESCRIPTION("Support code for Inverse Flash Translation Layer, used on M-Systems DiskOnChip 2000, Millennium and Millennium Plus");