mtd: m25p80: fixup device removal failure path
[deliverable/linux.git] / drivers / mtd / nand / nand_bbt.c
CommitLineData
1da177e4
LT
1/*
2 * drivers/mtd/nand_bbt.c
3 *
4 * Overview:
5 * Bad block table support for the NAND driver
61b03bd7 6 *
d159c4e5 7 * Copyright © 2004 Thomas Gleixner (tglx@linutronix.de)
1da177e4 8 *
1da177e4
LT
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License version 2 as
11 * published by the Free Software Foundation.
12 *
13 * Description:
14 *
61b03bd7 15 * When nand_scan_bbt is called, then it tries to find the bad block table
7cba7b14 16 * depending on the options in the BBT descriptor(s). If no flash based BBT
bb9ebd4e 17 * (NAND_BBT_USE_FLASH) is specified then the device is scanned for factory
7cba7b14
SAS
18 * marked good / bad blocks. This information is used to create a memory BBT.
19 * Once a new bad block is discovered then the "factory" information is updated
20 * on the device.
21 * If a flash based BBT is specified then the function first tries to find the
22 * BBT on flash. If a BBT is found then the contents are read and the memory
23 * based BBT is created. If a mirrored BBT is selected then the mirror is
24 * searched too and the versions are compared. If the mirror has a greater
44ed0ffd 25 * version number, then the mirror BBT is used to build the memory based BBT.
1da177e4 26 * If the tables are not versioned, then we "or" the bad block information.
7cba7b14
SAS
27 * If one of the BBTs is out of date or does not exist it is (re)created.
28 * If no BBT exists at all then the device is scanned for factory marked
61b03bd7 29 * good / bad blocks and the bad block tables are created.
1da177e4 30 *
7cba7b14
SAS
31 * For manufacturer created BBTs like the one found on M-SYS DOC devices
32 * the BBT is searched and read but never created
1da177e4 33 *
7cba7b14 34 * The auto generated bad block table is located in the last good blocks
61b03bd7 35 * of the device. The table is mirrored, so it can be updated eventually.
7cba7b14
SAS
36 * The table is marked in the OOB area with an ident pattern and a version
37 * number which indicates which of both tables is more up to date. If the NAND
38 * controller needs the complete OOB area for the ECC information then the
bb9ebd4e 39 * option NAND_BBT_NO_OOB should be used (along with NAND_BBT_USE_FLASH, of
a40f7341
BN
40 * course): it moves the ident pattern and the version byte into the data area
41 * and the OOB area will remain untouched.
1da177e4
LT
42 *
43 * The table uses 2 bits per block
7cba7b14
SAS
44 * 11b: block is good
45 * 00b: block is factory marked bad
46 * 01b, 10b: block is marked bad due to wear
1da177e4
LT
47 *
48 * The memory bad block table uses the following scheme:
49 * 00b: block is good
50 * 01b: block is marked bad due to wear
51 * 10b: block is reserved (to protect the bbt area)
52 * 11b: block is factory marked bad
61b03bd7 53 *
1da177e4
LT
54 * Multichip devices like DOC store the bad block info per floor.
55 *
56 * Following assumptions are made:
57 * - bbts start at a page boundary, if autolocated on a block boundary
e0c7d767 58 * - the space necessary for a bbt in FLASH does not exceed a block boundary
61b03bd7 59 *
1da177e4
LT
60 */
61
62#include <linux/slab.h>
63#include <linux/types.h>
64#include <linux/mtd/mtd.h>
61de9da6 65#include <linux/mtd/bbm.h>
1da177e4
LT
66#include <linux/mtd/nand.h>
67#include <linux/mtd/nand_ecc.h>
1da177e4
LT
68#include <linux/bitops.h>
69#include <linux/delay.h>
c3f8abf4 70#include <linux/vmalloc.h>
f3bcc017 71#include <linux/export.h>
491ed06f 72#include <linux/string.h>
1da177e4 73
771c568b
BN
74#define BBT_BLOCK_GOOD 0x00
75#define BBT_BLOCK_WORN 0x01
76#define BBT_BLOCK_RESERVED 0x02
77#define BBT_BLOCK_FACTORY_BAD 0x03
78
79#define BBT_ENTRY_MASK 0x03
80#define BBT_ENTRY_SHIFT 2
81
b32843b7
BN
82static int nand_update_bbt(struct mtd_info *mtd, loff_t offs);
83
771c568b
BN
84static inline uint8_t bbt_get_entry(struct nand_chip *chip, int block)
85{
86 uint8_t entry = chip->bbt[block >> BBT_ENTRY_SHIFT];
87 entry >>= (block & BBT_ENTRY_MASK) * 2;
88 return entry & BBT_ENTRY_MASK;
89}
90
91static inline void bbt_mark_entry(struct nand_chip *chip, int block,
92 uint8_t mark)
93{
94 uint8_t msk = (mark & BBT_ENTRY_MASK) << ((block & BBT_ENTRY_MASK) * 2);
95 chip->bbt[block >> BBT_ENTRY_SHIFT] |= msk;
96}
97
7cba7b14
SAS
98static int check_pattern_no_oob(uint8_t *buf, struct nand_bbt_descr *td)
99{
718894ad
BN
100 if (memcmp(buf, td->pattern, td->len))
101 return -1;
102 return 0;
7cba7b14
SAS
103}
104
61b03bd7 105/**
1da177e4 106 * check_pattern - [GENERIC] check if a pattern is in the buffer
8b6e50c9
BN
107 * @buf: the buffer to search
108 * @len: the length of buffer to search
109 * @paglen: the pagelength
110 * @td: search pattern descriptor
1da177e4 111 *
8b6e50c9 112 * Check for a pattern at the given place. Used to search bad block tables and
dad22562 113 * good / bad block identifiers.
8b6e50c9 114 */
e0c7d767 115static int check_pattern(uint8_t *buf, int len, int paglen, struct nand_bbt_descr *td)
1da177e4 116{
7cba7b14
SAS
117 if (td->options & NAND_BBT_NO_OOB)
118 return check_pattern_no_oob(buf, td);
119
1da177e4 120 /* Compare the pattern */
dad22562 121 if (memcmp(buf + paglen + td->offs, td->pattern, td->len))
75b66d8c 122 return -1;
58373ff0 123
1da177e4
LT
124 return 0;
125}
126
61b03bd7 127/**
c9e05365 128 * check_short_pattern - [GENERIC] check if a pattern is in the buffer
8b6e50c9
BN
129 * @buf: the buffer to search
130 * @td: search pattern descriptor
c9e05365 131 *
8b6e50c9
BN
132 * Check for a pattern at the given place. Used to search bad block tables and
133 * good / bad block identifiers. Same as check_pattern, but no optional empty
134 * check.
135 */
e0c7d767 136static int check_short_pattern(uint8_t *buf, struct nand_bbt_descr *td)
c9e05365 137{
c9e05365 138 /* Compare the pattern */
491ed06f
BN
139 if (memcmp(buf + td->offs, td->pattern, td->len))
140 return -1;
c9e05365
TG
141 return 0;
142}
143
7cba7b14
SAS
144/**
145 * add_marker_len - compute the length of the marker in data area
8b6e50c9 146 * @td: BBT descriptor used for computation
7cba7b14 147 *
7854d3f7 148 * The length will be 0 if the marker is located in OOB area.
7cba7b14
SAS
149 */
150static u32 add_marker_len(struct nand_bbt_descr *td)
151{
152 u32 len;
153
154 if (!(td->options & NAND_BBT_NO_OOB))
155 return 0;
156
157 len = td->len;
158 if (td->options & NAND_BBT_VERSION)
159 len++;
160 return len;
161}
162
1da177e4
LT
163/**
164 * read_bbt - [GENERIC] Read the bad block table starting from page
8b6e50c9
BN
165 * @mtd: MTD device structure
166 * @buf: temporary buffer
167 * @page: the starting page
168 * @num: the number of bbt descriptors to read
7854d3f7 169 * @td: the bbt describtion table
b4d20d60 170 * @offs: block number offset in the table
1da177e4
LT
171 *
172 * Read the bad block table starting from page.
1da177e4 173 */
e0c7d767 174static int read_bbt(struct mtd_info *mtd, uint8_t *buf, int page, int num,
df5b4e34 175 struct nand_bbt_descr *td, int offs)
1da177e4 176{
167a8d52 177 int res, ret = 0, i, j, act = 0;
1da177e4
LT
178 struct nand_chip *this = mtd->priv;
179 size_t retlen, len, totlen;
180 loff_t from;
df5b4e34 181 int bits = td->options & NAND_BBT_NRBITS_MSK;
596d7452 182 uint8_t msk = (uint8_t)((1 << bits) - 1);
7cba7b14 183 u32 marker_len;
df5b4e34 184 int reserved_block_code = td->reserved_block_code;
1da177e4
LT
185
186 totlen = (num * bits) >> 3;
7cba7b14 187 marker_len = add_marker_len(td);
596d7452 188 from = ((loff_t)page) << this->page_shift;
61b03bd7 189
1da177e4 190 while (totlen) {
596d7452 191 len = min(totlen, (size_t)(1 << this->bbt_erase_shift));
7cba7b14
SAS
192 if (marker_len) {
193 /*
194 * In case the BBT marker is not in the OOB area it
195 * will be just in the first page.
196 */
197 len -= marker_len;
198 from += marker_len;
199 marker_len = 0;
200 }
329ad399 201 res = mtd_read(mtd, from, len, &retlen, buf);
1da177e4 202 if (res < 0) {
167a8d52
BN
203 if (mtd_is_eccerr(res)) {
204 pr_info("nand_bbt: ECC error in BBT at "
205 "0x%012llx\n", from & ~mtd->writesize);
206 return res;
207 } else if (mtd_is_bitflip(res)) {
208 pr_info("nand_bbt: corrected error in BBT at "
209 "0x%012llx\n", from & ~mtd->writesize);
210 ret = res;
211 } else {
212 pr_info("nand_bbt: error reading BBT\n");
1da177e4
LT
213 return res;
214 }
61b03bd7 215 }
1da177e4
LT
216
217 /* Analyse data */
218 for (i = 0; i < len; i++) {
219 uint8_t dat = buf[i];
b4d20d60 220 for (j = 0; j < 8; j += bits, act++) {
1da177e4
LT
221 uint8_t tmp = (dat >> j) & msk;
222 if (tmp == msk)
223 continue;
e0c7d767 224 if (reserved_block_code && (tmp == reserved_block_code)) {
d0370219 225 pr_info("nand_read_bbt: reserved block at 0x%012llx\n",
b4d20d60
BN
226 (loff_t)(offs + act) <<
227 this->bbt_erase_shift);
228 bbt_mark_entry(this, offs + act,
771c568b 229 BBT_BLOCK_RESERVED);
f1a28c02 230 mtd->ecc_stats.bbtblocks++;
1da177e4
LT
231 continue;
232 }
8b6e50c9
BN
233 /*
234 * Leave it for now, if it's matured we can
a0f5080e 235 * move this message to pr_debug.
8b6e50c9 236 */
d0370219 237 pr_info("nand_read_bbt: bad block at 0x%012llx\n",
b4d20d60
BN
238 (loff_t)(offs + act) <<
239 this->bbt_erase_shift);
8b6e50c9 240 /* Factory marked bad or worn out? */
1da177e4 241 if (tmp == 0)
b4d20d60 242 bbt_mark_entry(this, offs + act,
771c568b 243 BBT_BLOCK_FACTORY_BAD);
1da177e4 244 else
b4d20d60 245 bbt_mark_entry(this, offs + act,
771c568b 246 BBT_BLOCK_WORN);
f1a28c02 247 mtd->ecc_stats.badblocks++;
61b03bd7 248 }
1da177e4
LT
249 }
250 totlen -= len;
251 from += len;
252 }
167a8d52 253 return ret;
1da177e4
LT
254}
255
256/**
257 * read_abs_bbt - [GENERIC] Read the bad block table starting at a given page
8b6e50c9
BN
258 * @mtd: MTD device structure
259 * @buf: temporary buffer
260 * @td: descriptor for the bad block table
596d7452 261 * @chip: read the table for a specific chip, -1 read all chips; applies only if
8b6e50c9 262 * NAND_BBT_PERCHIP option is set
1da177e4 263 *
8b6e50c9
BN
264 * Read the bad block table for all chips starting at a given page. We assume
265 * that the bbt bits are in consecutive order.
266 */
e0c7d767 267static int read_abs_bbt(struct mtd_info *mtd, uint8_t *buf, struct nand_bbt_descr *td, int chip)
1da177e4
LT
268{
269 struct nand_chip *this = mtd->priv;
270 int res = 0, i;
1da177e4 271
1da177e4
LT
272 if (td->options & NAND_BBT_PERCHIP) {
273 int offs = 0;
274 for (i = 0; i < this->numchips; i++) {
275 if (chip == -1 || chip == i)
df5b4e34
SAS
276 res = read_bbt(mtd, buf, td->pages[i],
277 this->chipsize >> this->bbt_erase_shift,
278 td, offs);
1da177e4
LT
279 if (res)
280 return res;
b4d20d60 281 offs += this->chipsize >> this->bbt_erase_shift;
1da177e4
LT
282 }
283 } else {
df5b4e34
SAS
284 res = read_bbt(mtd, buf, td->pages[0],
285 mtd->size >> this->bbt_erase_shift, td, 0);
1da177e4
LT
286 if (res)
287 return res;
288 }
289 return 0;
290}
291
8b6e50c9 292/* BBT marker is in the first page, no OOB */
af69dcd3 293static int scan_read_data(struct mtd_info *mtd, uint8_t *buf, loff_t offs,
7cba7b14
SAS
294 struct nand_bbt_descr *td)
295{
296 size_t retlen;
297 size_t len;
298
299 len = td->len;
300 if (td->options & NAND_BBT_VERSION)
301 len++;
302
329ad399 303 return mtd_read(mtd, offs, len, &retlen, buf);
7cba7b14
SAS
304}
305
a7e68834 306/**
af69dcd3 307 * scan_read_oob - [GENERIC] Scan data+OOB region to buffer
a7e68834
BN
308 * @mtd: MTD device structure
309 * @buf: temporary buffer
310 * @offs: offset at which to scan
311 * @len: length of data region to read
312 *
313 * Scan read data from data+OOB. May traverse multiple pages, interleaving
314 * page,OOB,page,OOB,... in buf. Completes transfer and returns the "strongest"
315 * ECC condition (error or bitflip). May quit on the first (non-ECC) error.
316 */
af69dcd3 317static int scan_read_oob(struct mtd_info *mtd, uint8_t *buf, loff_t offs,
8593fbc6
TG
318 size_t len)
319{
320 struct mtd_oob_ops ops;
a7e68834 321 int res, ret = 0;
8593fbc6 322
a7e68834 323 ops.mode = MTD_OPS_PLACE_OOB;
8593fbc6
TG
324 ops.ooboffs = 0;
325 ops.ooblen = mtd->oobsize;
8593fbc6 326
b64d39d8 327 while (len > 0) {
105513cc
BN
328 ops.datbuf = buf;
329 ops.len = min(len, (size_t)mtd->writesize);
330 ops.oobbuf = buf + ops.len;
b64d39d8 331
fd2819bb 332 res = mtd_read_oob(mtd, offs, &ops);
a7e68834
BN
333 if (res) {
334 if (!mtd_is_bitflip_or_eccerr(res))
335 return res;
336 else if (mtd_is_eccerr(res) || !ret)
337 ret = res;
338 }
b64d39d8
ML
339
340 buf += mtd->oobsize + mtd->writesize;
341 len -= mtd->writesize;
34a5704d 342 offs += mtd->writesize;
b64d39d8 343 }
a7e68834 344 return ret;
8593fbc6
TG
345}
346
af69dcd3 347static int scan_read(struct mtd_info *mtd, uint8_t *buf, loff_t offs,
7cba7b14
SAS
348 size_t len, struct nand_bbt_descr *td)
349{
350 if (td->options & NAND_BBT_NO_OOB)
af69dcd3 351 return scan_read_data(mtd, buf, offs, td);
7cba7b14 352 else
af69dcd3 353 return scan_read_oob(mtd, buf, offs, len);
7cba7b14
SAS
354}
355
8b6e50c9 356/* Scan write data with oob to flash */
8593fbc6
TG
357static int scan_write_bbt(struct mtd_info *mtd, loff_t offs, size_t len,
358 uint8_t *buf, uint8_t *oob)
359{
360 struct mtd_oob_ops ops;
361
0612b9dd 362 ops.mode = MTD_OPS_PLACE_OOB;
8593fbc6
TG
363 ops.ooboffs = 0;
364 ops.ooblen = mtd->oobsize;
365 ops.datbuf = buf;
366 ops.oobbuf = oob;
367 ops.len = len;
368
a2cc5ba0 369 return mtd_write_oob(mtd, offs, &ops);
8593fbc6
TG
370}
371
7cba7b14
SAS
372static u32 bbt_get_ver_offs(struct mtd_info *mtd, struct nand_bbt_descr *td)
373{
374 u32 ver_offs = td->veroffs;
375
376 if (!(td->options & NAND_BBT_NO_OOB))
377 ver_offs += mtd->writesize;
378 return ver_offs;
379}
380
1da177e4
LT
381/**
382 * read_abs_bbts - [GENERIC] Read the bad block table(s) for all chips starting at a given page
8b6e50c9
BN
383 * @mtd: MTD device structure
384 * @buf: temporary buffer
385 * @td: descriptor for the bad block table
386 * @md: descriptor for the bad block table mirror
1da177e4 387 *
8b6e50c9
BN
388 * Read the bad block table(s) for all chips starting at a given page. We
389 * assume that the bbt bits are in consecutive order.
390 */
7b5a2d40
BN
391static void read_abs_bbts(struct mtd_info *mtd, uint8_t *buf,
392 struct nand_bbt_descr *td, struct nand_bbt_descr *md)
1da177e4
LT
393{
394 struct nand_chip *this = mtd->priv;
395
61b03bd7 396 /* Read the primary version, if available */
1da177e4 397 if (td->options & NAND_BBT_VERSION) {
af69dcd3 398 scan_read(mtd, buf, (loff_t)td->pages[0] << this->page_shift,
7cba7b14
SAS
399 mtd->writesize, td);
400 td->version[0] = buf[bbt_get_ver_offs(mtd, td)];
9a4d4d69 401 pr_info("Bad block table at page %d, version 0x%02X\n",
d0370219 402 td->pages[0], td->version[0]);
1da177e4
LT
403 }
404
61b03bd7 405 /* Read the mirror version, if available */
1da177e4 406 if (md && (md->options & NAND_BBT_VERSION)) {
af69dcd3 407 scan_read(mtd, buf, (loff_t)md->pages[0] << this->page_shift,
7bb9c754 408 mtd->writesize, md);
7cba7b14 409 md->version[0] = buf[bbt_get_ver_offs(mtd, md)];
9a4d4d69 410 pr_info("Bad block table at page %d, version 0x%02X\n",
d0370219 411 md->pages[0], md->version[0]);
1da177e4 412 }
1da177e4
LT
413}
414
8b6e50c9 415/* Scan a given block full */
8593fbc6
TG
416static int scan_block_full(struct mtd_info *mtd, struct nand_bbt_descr *bd,
417 loff_t offs, uint8_t *buf, size_t readlen,
eceb84b1 418 int scanlen, int numpages)
8593fbc6
TG
419{
420 int ret, j;
421
af69dcd3 422 ret = scan_read_oob(mtd, buf, offs, readlen);
afa17de2 423 /* Ignore ECC errors when checking for BBM */
d57f4054 424 if (ret && !mtd_is_bitflip_or_eccerr(ret))
8593fbc6
TG
425 return ret;
426
eceb84b1 427 for (j = 0; j < numpages; j++, buf += scanlen) {
8593fbc6
TG
428 if (check_pattern(buf, scanlen, mtd->writesize, bd))
429 return 1;
430 }
431 return 0;
432}
433
8b6e50c9 434/* Scan a given block partially */
8593fbc6 435static int scan_block_fast(struct mtd_info *mtd, struct nand_bbt_descr *bd,
eceb84b1 436 loff_t offs, uint8_t *buf, int numpages)
8593fbc6
TG
437{
438 struct mtd_oob_ops ops;
439 int j, ret;
440
8593fbc6
TG
441 ops.ooblen = mtd->oobsize;
442 ops.oobbuf = buf;
443 ops.ooboffs = 0;
444 ops.datbuf = NULL;
0612b9dd 445 ops.mode = MTD_OPS_PLACE_OOB;
8593fbc6 446
eceb84b1 447 for (j = 0; j < numpages; j++) {
8593fbc6 448 /*
8b6e50c9
BN
449 * Read the full oob until read_oob is fixed to handle single
450 * byte reads for 16 bit buswidth.
8593fbc6 451 */
fd2819bb 452 ret = mtd_read_oob(mtd, offs, &ops);
903cd06c 453 /* Ignore ECC errors when checking for BBM */
d57f4054 454 if (ret && !mtd_is_bitflip_or_eccerr(ret))
8593fbc6
TG
455 return ret;
456
457 if (check_short_pattern(buf, bd))
458 return 1;
459
460 offs += mtd->writesize;
461 }
462 return 0;
463}
464
1da177e4
LT
465/**
466 * create_bbt - [GENERIC] Create a bad block table by scanning the device
8b6e50c9
BN
467 * @mtd: MTD device structure
468 * @buf: temporary buffer
469 * @bd: descriptor for the good/bad block search pattern
470 * @chip: create the table for a specific chip, -1 read all chips; applies only
471 * if NAND_BBT_PERCHIP option is set
1da177e4 472 *
8b6e50c9
BN
473 * Create a bad block table by scanning the device for the given good/bad block
474 * identify pattern.
1da177e4 475 */
8593fbc6
TG
476static int create_bbt(struct mtd_info *mtd, uint8_t *buf,
477 struct nand_bbt_descr *bd, int chip)
1da177e4
LT
478{
479 struct nand_chip *this = mtd->priv;
eceb84b1 480 int i, numblocks, numpages, scanlen;
1da177e4
LT
481 int startblock;
482 loff_t from;
8593fbc6 483 size_t readlen;
1da177e4 484
9a4d4d69 485 pr_info("Scanning device for bad blocks\n");
1da177e4
LT
486
487 if (bd->options & NAND_BBT_SCANALLPAGES)
eceb84b1 488 numpages = 1 << (this->bbt_erase_shift - this->page_shift);
58373ff0 489 else if (bd->options & NAND_BBT_SCAN2NDPAGE)
eceb84b1 490 numpages = 2;
58373ff0 491 else
eceb84b1 492 numpages = 1;
171650af 493
dad22562
BN
494 /* We need only read few bytes from the OOB area */
495 scanlen = 0;
496 readlen = bd->len;
1da177e4
LT
497
498 if (chip == -1) {
b4d20d60 499 numblocks = mtd->size >> this->bbt_erase_shift;
1da177e4
LT
500 startblock = 0;
501 from = 0;
502 } else {
503 if (chip >= this->numchips) {
9a4d4d69 504 pr_warn("create_bbt(): chipnr (%d) > available chips (%d)\n",
e0c7d767 505 chip + 1, this->numchips);
171650af 506 return -EINVAL;
1da177e4 507 }
b4d20d60 508 numblocks = this->chipsize >> this->bbt_erase_shift;
1da177e4
LT
509 startblock = chip * numblocks;
510 numblocks += startblock;
b4d20d60 511 from = (loff_t)startblock << this->bbt_erase_shift;
1da177e4 512 }
61b03bd7 513
5fb1549d 514 if (this->bbt_options & NAND_BBT_SCANLASTPAGE)
eceb84b1 515 from += mtd->erasesize - (mtd->writesize * numpages);
b60b08b0 516
b4d20d60 517 for (i = startblock; i < numblocks; i++) {
eeada24d 518 int ret;
61b03bd7 519
7cba7b14
SAS
520 BUG_ON(bd->options & NAND_BBT_NO_OOB);
521
8593fbc6
TG
522 if (bd->options & NAND_BBT_SCANALLPAGES)
523 ret = scan_block_full(mtd, bd, from, buf, readlen,
eceb84b1 524 scanlen, numpages);
8593fbc6 525 else
eceb84b1 526 ret = scan_block_fast(mtd, bd, from, buf, numpages);
8593fbc6
TG
527
528 if (ret < 0)
529 return ret;
530
531 if (ret) {
b4d20d60 532 bbt_mark_entry(this, i, BBT_BLOCK_FACTORY_BAD);
9a4d4d69 533 pr_warn("Bad eraseblock %d at 0x%012llx\n",
b4d20d60 534 i, (unsigned long long)from);
f1a28c02 535 mtd->ecc_stats.badblocks++;
1da177e4 536 }
8593fbc6 537
1da177e4
LT
538 from += (1 << this->bbt_erase_shift);
539 }
eeada24d 540 return 0;
1da177e4
LT
541}
542
543/**
544 * search_bbt - [GENERIC] scan the device for a specific bad block table
8b6e50c9
BN
545 * @mtd: MTD device structure
546 * @buf: temporary buffer
547 * @td: descriptor for the bad block table
1da177e4 548 *
8b6e50c9
BN
549 * Read the bad block table by searching for a given ident pattern. Search is
550 * preformed either from the beginning up or from the end of the device
551 * downwards. The search starts always at the start of a block. If the option
552 * NAND_BBT_PERCHIP is given, each chip is searched for a bbt, which contains
553 * the bad block information of this chip. This is necessary to provide support
554 * for certain DOC devices.
1da177e4 555 *
8b6e50c9 556 * The bbt ident pattern resides in the oob area of the first page in a block.
1da177e4 557 */
e0c7d767 558static int search_bbt(struct mtd_info *mtd, uint8_t *buf, struct nand_bbt_descr *td)
1da177e4
LT
559{
560 struct nand_chip *this = mtd->priv;
561 int i, chips;
562 int bits, startblock, block, dir;
28318776 563 int scanlen = mtd->writesize + mtd->oobsize;
1da177e4 564 int bbtblocks;
8593fbc6 565 int blocktopage = this->bbt_erase_shift - this->page_shift;
1da177e4 566
8b6e50c9 567 /* Search direction top -> down? */
1da177e4 568 if (td->options & NAND_BBT_LASTBLOCK) {
e0c7d767 569 startblock = (mtd->size >> this->bbt_erase_shift) - 1;
1da177e4
LT
570 dir = -1;
571 } else {
61b03bd7 572 startblock = 0;
1da177e4 573 dir = 1;
61b03bd7
TG
574 }
575
8b6e50c9 576 /* Do we have a bbt per chip? */
1da177e4
LT
577 if (td->options & NAND_BBT_PERCHIP) {
578 chips = this->numchips;
579 bbtblocks = this->chipsize >> this->bbt_erase_shift;
580 startblock &= bbtblocks - 1;
581 } else {
582 chips = 1;
583 bbtblocks = mtd->size >> this->bbt_erase_shift;
584 }
61b03bd7 585
1da177e4
LT
586 /* Number of bits for each erase block in the bbt */
587 bits = td->options & NAND_BBT_NRBITS_MSK;
61b03bd7 588
1da177e4
LT
589 for (i = 0; i < chips; i++) {
590 /* Reset version information */
61b03bd7 591 td->version[i] = 0;
1da177e4
LT
592 td->pages[i] = -1;
593 /* Scan the maximum number of blocks */
594 for (block = 0; block < td->maxblocks; block++) {
8593fbc6 595
1da177e4 596 int actblock = startblock + dir * block;
69423d99 597 loff_t offs = (loff_t)actblock << this->bbt_erase_shift;
8593fbc6 598
1da177e4 599 /* Read first page */
af69dcd3 600 scan_read(mtd, buf, offs, mtd->writesize, td);
28318776 601 if (!check_pattern(buf, scanlen, mtd->writesize, td)) {
8593fbc6 602 td->pages[i] = actblock << blocktopage;
1da177e4 603 if (td->options & NAND_BBT_VERSION) {
7cba7b14
SAS
604 offs = bbt_get_ver_offs(mtd, td);
605 td->version[i] = buf[offs];
1da177e4
LT
606 }
607 break;
608 }
609 }
610 startblock += this->chipsize >> this->bbt_erase_shift;
611 }
612 /* Check, if we found a bbt for each requested chip */
613 for (i = 0; i < chips; i++) {
614 if (td->pages[i] == -1)
9a4d4d69 615 pr_warn("Bad block table not found for chip %d\n", i);
1da177e4 616 else
d0370219
BN
617 pr_info("Bad block table found at page %d, version "
618 "0x%02X\n", td->pages[i], td->version[i]);
1da177e4 619 }
61b03bd7 620 return 0;
1da177e4
LT
621}
622
623/**
624 * search_read_bbts - [GENERIC] scan the device for bad block table(s)
8b6e50c9
BN
625 * @mtd: MTD device structure
626 * @buf: temporary buffer
627 * @td: descriptor for the bad block table
628 * @md: descriptor for the bad block table mirror
1da177e4 629 *
8b6e50c9
BN
630 * Search and read the bad block table(s).
631 */
7b5a2d40
BN
632static void search_read_bbts(struct mtd_info *mtd, uint8_t *buf,
633 struct nand_bbt_descr *td,
634 struct nand_bbt_descr *md)
1da177e4
LT
635{
636 /* Search the primary table */
e0c7d767 637 search_bbt(mtd, buf, td);
61b03bd7 638
1da177e4
LT
639 /* Search the mirror table */
640 if (md)
e0c7d767 641 search_bbt(mtd, buf, md);
1da177e4 642}
1da177e4 643
61b03bd7 644/**
1da177e4 645 * write_bbt - [GENERIC] (Re)write the bad block table
8b6e50c9
BN
646 * @mtd: MTD device structure
647 * @buf: temporary buffer
648 * @td: descriptor for the bad block table
649 * @md: descriptor for the bad block table mirror
650 * @chipsel: selector for a specific chip, -1 for all
1da177e4 651 *
8b6e50c9
BN
652 * (Re)write the bad block table.
653 */
e0c7d767 654static int write_bbt(struct mtd_info *mtd, uint8_t *buf,
9223a456
TG
655 struct nand_bbt_descr *td, struct nand_bbt_descr *md,
656 int chipsel)
1da177e4
LT
657{
658 struct nand_chip *this = mtd->priv;
1da177e4 659 struct erase_info einfo;
b4d20d60 660 int i, res, chip = 0;
1da177e4 661 int bits, startblock, dir, page, offs, numblocks, sft, sftmsk;
b4d20d60 662 int nrchips, pageoffs, ooboffs;
1da177e4
LT
663 uint8_t msk[4];
664 uint8_t rcode = td->reserved_block_code;
8593fbc6 665 size_t retlen, len = 0;
1da177e4 666 loff_t to;
8593fbc6
TG
667 struct mtd_oob_ops ops;
668
669 ops.ooblen = mtd->oobsize;
670 ops.ooboffs = 0;
671 ops.datbuf = NULL;
0612b9dd 672 ops.mode = MTD_OPS_PLACE_OOB;
1da177e4
LT
673
674 if (!rcode)
675 rcode = 0xff;
8b6e50c9 676 /* Write bad block table per chip rather than per device? */
1da177e4 677 if (td->options & NAND_BBT_PERCHIP) {
e0c7d767 678 numblocks = (int)(this->chipsize >> this->bbt_erase_shift);
8b6e50c9 679 /* Full device write or specific chip? */
1da177e4
LT
680 if (chipsel == -1) {
681 nrchips = this->numchips;
682 } else {
683 nrchips = chipsel + 1;
684 chip = chipsel;
685 }
686 } else {
e0c7d767 687 numblocks = (int)(mtd->size >> this->bbt_erase_shift);
1da177e4 688 nrchips = 1;
61b03bd7
TG
689 }
690
1da177e4
LT
691 /* Loop through the chips */
692 for (; chip < nrchips; chip++) {
8b6e50c9
BN
693 /*
694 * There was already a version of the table, reuse the page
61b03bd7 695 * This applies for absolute placement too, as we have the
1da177e4
LT
696 * page nr. in td->pages.
697 */
698 if (td->pages[chip] != -1) {
699 page = td->pages[chip];
700 goto write;
61b03bd7 701 }
1da177e4 702
8b6e50c9
BN
703 /*
704 * Automatic placement of the bad block table. Search direction
705 * top -> down?
706 */
1da177e4
LT
707 if (td->options & NAND_BBT_LASTBLOCK) {
708 startblock = numblocks * (chip + 1) - 1;
709 dir = -1;
710 } else {
711 startblock = chip * numblocks;
712 dir = 1;
61b03bd7 713 }
1da177e4
LT
714
715 for (i = 0; i < td->maxblocks; i++) {
716 int block = startblock + dir * i;
717 /* Check, if the block is bad */
771c568b
BN
718 switch (bbt_get_entry(this, block)) {
719 case BBT_BLOCK_WORN:
720 case BBT_BLOCK_FACTORY_BAD:
1da177e4
LT
721 continue;
722 }
9223a456
TG
723 page = block <<
724 (this->bbt_erase_shift - this->page_shift);
1da177e4
LT
725 /* Check, if the block is used by the mirror table */
726 if (!md || md->pages[chip] != page)
727 goto write;
728 }
9a4d4d69 729 pr_err("No space left to write bad block table\n");
1da177e4 730 return -ENOSPC;
e0c7d767 731 write:
1da177e4
LT
732
733 /* Set up shift count and masks for the flash table */
734 bits = td->options & NAND_BBT_NRBITS_MSK;
9223a456 735 msk[2] = ~rcode;
1da177e4 736 switch (bits) {
9223a456
TG
737 case 1: sft = 3; sftmsk = 0x07; msk[0] = 0x00; msk[1] = 0x01;
738 msk[3] = 0x01;
739 break;
740 case 2: sft = 2; sftmsk = 0x06; msk[0] = 0x00; msk[1] = 0x01;
741 msk[3] = 0x03;
742 break;
743 case 4: sft = 1; sftmsk = 0x04; msk[0] = 0x00; msk[1] = 0x0C;
744 msk[3] = 0x0f;
745 break;
746 case 8: sft = 0; sftmsk = 0x00; msk[0] = 0x00; msk[1] = 0x0F;
747 msk[3] = 0xff;
748 break;
1da177e4
LT
749 default: return -EINVAL;
750 }
61b03bd7 751
596d7452 752 to = ((loff_t)page) << this->page_shift;
1da177e4 753
8b6e50c9 754 /* Must we save the block contents? */
1da177e4
LT
755 if (td->options & NAND_BBT_SAVECONTENT) {
756 /* Make it block aligned */
596d7452 757 to &= ~((loff_t)((1 << this->bbt_erase_shift) - 1));
1da177e4 758 len = 1 << this->bbt_erase_shift;
329ad399 759 res = mtd_read(mtd, to, len, &retlen, buf);
1da177e4
LT
760 if (res < 0) {
761 if (retlen != len) {
d0370219
BN
762 pr_info("nand_bbt: error reading block "
763 "for writing the bad block table\n");
1da177e4
LT
764 return res;
765 }
d0370219
BN
766 pr_warn("nand_bbt: ECC error while reading "
767 "block for writing bad block table\n");
1da177e4 768 }
9223a456 769 /* Read oob data */
7014568b 770 ops.ooblen = (len >> this->page_shift) * mtd->oobsize;
8593fbc6 771 ops.oobbuf = &buf[len];
fd2819bb 772 res = mtd_read_oob(mtd, to + mtd->writesize, &ops);
7014568b 773 if (res < 0 || ops.oobretlen != ops.ooblen)
9223a456
TG
774 goto outerr;
775
1da177e4
LT
776 /* Calc the byte offset in the buffer */
777 pageoffs = page - (int)(to >> this->page_shift);
778 offs = pageoffs << this->page_shift;
779 /* Preset the bbt area with 0xff */
596d7452 780 memset(&buf[offs], 0xff, (size_t)(numblocks >> sft));
9223a456
TG
781 ooboffs = len + (pageoffs * mtd->oobsize);
782
7cba7b14
SAS
783 } else if (td->options & NAND_BBT_NO_OOB) {
784 ooboffs = 0;
785 offs = td->len;
8b6e50c9 786 /* The version byte */
7cba7b14
SAS
787 if (td->options & NAND_BBT_VERSION)
788 offs++;
789 /* Calc length */
596d7452 790 len = (size_t)(numblocks >> sft);
7cba7b14 791 len += offs;
8b6e50c9 792 /* Make it page aligned! */
7cba7b14
SAS
793 len = ALIGN(len, mtd->writesize);
794 /* Preset the buffer with 0xff */
795 memset(buf, 0xff, len);
796 /* Pattern is located at the begin of first page */
797 memcpy(buf, td->pattern, td->len);
1da177e4
LT
798 } else {
799 /* Calc length */
596d7452 800 len = (size_t)(numblocks >> sft);
8b6e50c9 801 /* Make it page aligned! */
cda32091 802 len = ALIGN(len, mtd->writesize);
1da177e4 803 /* Preset the buffer with 0xff */
9223a456
TG
804 memset(buf, 0xff, len +
805 (len >> this->page_shift)* mtd->oobsize);
1da177e4 806 offs = 0;
9223a456 807 ooboffs = len;
1da177e4 808 /* Pattern is located in oob area of first page */
9223a456 809 memcpy(&buf[ooboffs + td->offs], td->pattern, td->len);
1da177e4 810 }
61b03bd7 811
9223a456
TG
812 if (td->options & NAND_BBT_VERSION)
813 buf[ooboffs + td->veroffs] = td->version[chip];
814
8b6e50c9 815 /* Walk through the memory table */
b4d20d60 816 for (i = 0; i < numblocks; i++) {
1da177e4 817 uint8_t dat;
b4d20d60
BN
818 int sftcnt = (i << (3 - sft)) & sftmsk;
819 dat = bbt_get_entry(this, chip * numblocks + i);
820 /* Do not store the reserved bbt blocks! */
821 buf[offs + (i >> sft)] &= ~(msk[dat] << sftcnt);
1da177e4 822 }
61b03bd7 823
e0c7d767 824 memset(&einfo, 0, sizeof(einfo));
1da177e4 825 einfo.mtd = mtd;
69423d99 826 einfo.addr = to;
1da177e4 827 einfo.len = 1 << this->bbt_erase_shift;
e0c7d767 828 res = nand_erase_nand(mtd, &einfo, 1);
9223a456
TG
829 if (res < 0)
830 goto outerr;
61b03bd7 831
7cba7b14
SAS
832 res = scan_write_bbt(mtd, to, len, buf,
833 td->options & NAND_BBT_NO_OOB ? NULL :
834 &buf[len]);
9223a456
TG
835 if (res < 0)
836 goto outerr;
837
d0370219
BN
838 pr_info("Bad block table written to 0x%012llx, version 0x%02X\n",
839 (unsigned long long)to, td->version[chip]);
61b03bd7 840
1da177e4
LT
841 /* Mark it as used */
842 td->pages[chip] = page;
61b03bd7 843 }
1da177e4 844 return 0;
9223a456
TG
845
846 outerr:
d0370219 847 pr_warn("nand_bbt: error while writing bad block table %d\n", res);
9223a456 848 return res;
1da177e4
LT
849}
850
851/**
852 * nand_memory_bbt - [GENERIC] create a memory based bad block table
8b6e50c9
BN
853 * @mtd: MTD device structure
854 * @bd: descriptor for the good/bad block search pattern
1da177e4 855 *
8b6e50c9
BN
856 * The function creates a memory based bbt by scanning the device for
857 * manufacturer / software marked good / bad blocks.
858 */
e0c7d767 859static inline int nand_memory_bbt(struct mtd_info *mtd, struct nand_bbt_descr *bd)
1da177e4
LT
860{
861 struct nand_chip *this = mtd->priv;
862
4bf63fcb 863 return create_bbt(mtd, this->buffers->databuf, bd, -1);
1da177e4
LT
864}
865
866/**
e0c7d767 867 * check_create - [GENERIC] create and write bbt(s) if necessary
8b6e50c9
BN
868 * @mtd: MTD device structure
869 * @buf: temporary buffer
870 * @bd: descriptor for the good/bad block search pattern
1da177e4 871 *
8b6e50c9
BN
872 * The function checks the results of the previous call to read_bbt and creates
873 * / updates the bbt(s) if necessary. Creation is necessary if no bbt was found
874 * for the chip/device. Update is necessary if one of the tables is missing or
875 * the version nr. of one table is less than the other.
876 */
e0c7d767 877static int check_create(struct mtd_info *mtd, uint8_t *buf, struct nand_bbt_descr *bd)
1da177e4 878{
623978de 879 int i, chips, writeops, create, chipsel, res, res2;
1da177e4
LT
880 struct nand_chip *this = mtd->priv;
881 struct nand_bbt_descr *td = this->bbt_td;
882 struct nand_bbt_descr *md = this->bbt_md;
883 struct nand_bbt_descr *rd, *rd2;
884
8b6e50c9 885 /* Do we have a bbt per chip? */
61b03bd7 886 if (td->options & NAND_BBT_PERCHIP)
1da177e4 887 chips = this->numchips;
61b03bd7 888 else
1da177e4 889 chips = 1;
61b03bd7 890
1da177e4
LT
891 for (i = 0; i < chips; i++) {
892 writeops = 0;
b61bf5bb 893 create = 0;
1da177e4
LT
894 rd = NULL;
895 rd2 = NULL;
623978de 896 res = res2 = 0;
8b6e50c9 897 /* Per chip or per device? */
1da177e4 898 chipsel = (td->options & NAND_BBT_PERCHIP) ? i : -1;
8b6e50c9 899 /* Mirrored table available? */
1da177e4
LT
900 if (md) {
901 if (td->pages[i] == -1 && md->pages[i] == -1) {
b61bf5bb 902 create = 1;
1da177e4 903 writeops = 0x03;
c5e8ef9c 904 } else if (td->pages[i] == -1) {
61b03bd7 905 rd = md;
596d7452 906 writeops = 0x01;
c5e8ef9c 907 } else if (md->pages[i] == -1) {
1da177e4 908 rd = td;
596d7452 909 writeops = 0x02;
c5e8ef9c 910 } else if (td->version[i] == md->version[i]) {
1da177e4
LT
911 rd = td;
912 if (!(td->options & NAND_BBT_VERSION))
913 rd2 = md;
c5e8ef9c 914 } else if (((int8_t)(td->version[i] - md->version[i])) > 0) {
1da177e4 915 rd = td;
596d7452 916 writeops = 0x02;
1da177e4
LT
917 } else {
918 rd = md;
596d7452 919 writeops = 0x01;
1da177e4 920 }
1da177e4
LT
921 } else {
922 if (td->pages[i] == -1) {
b61bf5bb 923 create = 1;
1da177e4 924 writeops = 0x01;
b61bf5bb
BN
925 } else {
926 rd = td;
1da177e4 927 }
1da177e4 928 }
61b03bd7 929
b61bf5bb
BN
930 if (create) {
931 /* Create the bad block table by scanning the device? */
932 if (!(td->options & NAND_BBT_CREATE))
933 continue;
934
935 /* Create the table in memory by scanning the chip(s) */
936 if (!(this->bbt_options & NAND_BBT_CREATE_EMPTY))
937 create_bbt(mtd, buf, bd, chipsel);
938
939 td->version[i] = 1;
940 if (md)
941 md->version[i] = 1;
942 }
943
8b6e50c9 944 /* Read back first? */
623978de
BN
945 if (rd) {
946 res = read_abs_bbt(mtd, buf, rd, chipsel);
947 if (mtd_is_eccerr(res)) {
948 /* Mark table as invalid */
949 rd->pages[i] = -1;
dadc17a3 950 rd->version[i] = 0;
623978de
BN
951 i--;
952 continue;
953 }
954 }
8b6e50c9 955 /* If they weren't versioned, read both */
623978de
BN
956 if (rd2) {
957 res2 = read_abs_bbt(mtd, buf, rd2, chipsel);
958 if (mtd_is_eccerr(res2)) {
959 /* Mark table as invalid */
960 rd2->pages[i] = -1;
dadc17a3 961 rd2->version[i] = 0;
623978de
BN
962 i--;
963 continue;
964 }
965 }
966
967 /* Scrub the flash table(s)? */
968 if (mtd_is_bitflip(res) || mtd_is_bitflip(res2))
969 writeops = 0x03;
1da177e4 970
dadc17a3
BN
971 /* Update version numbers before writing */
972 if (md) {
973 td->version[i] = max(td->version[i], md->version[i]);
974 md->version[i] = td->version[i];
975 }
976
8b6e50c9 977 /* Write the bad block table to the device? */
1da177e4 978 if ((writeops & 0x01) && (td->options & NAND_BBT_WRITE)) {
e0c7d767 979 res = write_bbt(mtd, buf, td, md, chipsel);
1da177e4
LT
980 if (res < 0)
981 return res;
982 }
61b03bd7 983
8b6e50c9 984 /* Write the mirror bad block table to the device? */
1da177e4 985 if ((writeops & 0x02) && md && (md->options & NAND_BBT_WRITE)) {
e0c7d767 986 res = write_bbt(mtd, buf, md, td, chipsel);
1da177e4
LT
987 if (res < 0)
988 return res;
989 }
990 }
61b03bd7 991 return 0;
1da177e4
LT
992}
993
994/**
61b03bd7 995 * mark_bbt_regions - [GENERIC] mark the bad block table regions
8b6e50c9
BN
996 * @mtd: MTD device structure
997 * @td: bad block table descriptor
1da177e4 998 *
8b6e50c9
BN
999 * The bad block table regions are marked as "bad" to prevent accidental
1000 * erasures / writes. The regions are identified by the mark 0x02.
1001 */
e0c7d767 1002static void mark_bbt_region(struct mtd_info *mtd, struct nand_bbt_descr *td)
1da177e4
LT
1003{
1004 struct nand_chip *this = mtd->priv;
1005 int i, j, chips, block, nrblocks, update;
771c568b 1006 uint8_t oldval;
1da177e4 1007
8b6e50c9 1008 /* Do we have a bbt per chip? */
1da177e4
LT
1009 if (td->options & NAND_BBT_PERCHIP) {
1010 chips = this->numchips;
1011 nrblocks = (int)(this->chipsize >> this->bbt_erase_shift);
1012 } else {
1013 chips = 1;
1014 nrblocks = (int)(mtd->size >> this->bbt_erase_shift);
61b03bd7
TG
1015 }
1016
1da177e4
LT
1017 for (i = 0; i < chips; i++) {
1018 if ((td->options & NAND_BBT_ABSPAGE) ||
1019 !(td->options & NAND_BBT_WRITE)) {
e0c7d767
DW
1020 if (td->pages[i] == -1)
1021 continue;
1da177e4 1022 block = td->pages[i] >> (this->bbt_erase_shift - this->page_shift);
b4d20d60
BN
1023 oldval = bbt_get_entry(this, block);
1024 bbt_mark_entry(this, block, BBT_BLOCK_RESERVED);
771c568b
BN
1025 if ((oldval != BBT_BLOCK_RESERVED) &&
1026 td->reserved_block_code)
b4d20d60
BN
1027 nand_update_bbt(mtd, (loff_t)block <<
1028 this->bbt_erase_shift);
1da177e4
LT
1029 continue;
1030 }
1031 update = 0;
1032 if (td->options & NAND_BBT_LASTBLOCK)
1033 block = ((i + 1) * nrblocks) - td->maxblocks;
61b03bd7 1034 else
1da177e4 1035 block = i * nrblocks;
1da177e4 1036 for (j = 0; j < td->maxblocks; j++) {
b4d20d60
BN
1037 oldval = bbt_get_entry(this, block);
1038 bbt_mark_entry(this, block, BBT_BLOCK_RESERVED);
771c568b 1039 if (oldval != BBT_BLOCK_RESERVED)
e0c7d767 1040 update = 1;
b4d20d60 1041 block++;
61b03bd7 1042 }
8b6e50c9
BN
1043 /*
1044 * If we want reserved blocks to be recorded to flash, and some
1045 * new ones have been marked, then we need to update the stored
1046 * bbts. This should only happen once.
1047 */
1da177e4 1048 if (update && td->reserved_block_code)
b4d20d60
BN
1049 nand_update_bbt(mtd, (loff_t)(block - 1) <<
1050 this->bbt_erase_shift);
1da177e4
LT
1051 }
1052}
1053
7cba7b14
SAS
1054/**
1055 * verify_bbt_descr - verify the bad block description
8b6e50c9
BN
1056 * @mtd: MTD device structure
1057 * @bd: the table to verify
7cba7b14
SAS
1058 *
1059 * This functions performs a few sanity checks on the bad block description
1060 * table.
1061 */
1062static void verify_bbt_descr(struct mtd_info *mtd, struct nand_bbt_descr *bd)
1063{
1064 struct nand_chip *this = mtd->priv;
7912a5e7
SF
1065 u32 pattern_len;
1066 u32 bits;
7cba7b14
SAS
1067 u32 table_size;
1068
1069 if (!bd)
1070 return;
7912a5e7
SF
1071
1072 pattern_len = bd->len;
1073 bits = bd->options & NAND_BBT_NRBITS_MSK;
1074
a40f7341 1075 BUG_ON((this->bbt_options & NAND_BBT_NO_OOB) &&
bb9ebd4e 1076 !(this->bbt_options & NAND_BBT_USE_FLASH));
7cba7b14
SAS
1077 BUG_ON(!bits);
1078
1079 if (bd->options & NAND_BBT_VERSION)
1080 pattern_len++;
1081
1082 if (bd->options & NAND_BBT_NO_OOB) {
bb9ebd4e 1083 BUG_ON(!(this->bbt_options & NAND_BBT_USE_FLASH));
a40f7341 1084 BUG_ON(!(this->bbt_options & NAND_BBT_NO_OOB));
7cba7b14
SAS
1085 BUG_ON(bd->offs);
1086 if (bd->options & NAND_BBT_VERSION)
1087 BUG_ON(bd->veroffs != bd->len);
1088 BUG_ON(bd->options & NAND_BBT_SAVECONTENT);
1089 }
1090
1091 if (bd->options & NAND_BBT_PERCHIP)
1092 table_size = this->chipsize >> this->bbt_erase_shift;
1093 else
1094 table_size = mtd->size >> this->bbt_erase_shift;
1095 table_size >>= 3;
1096 table_size *= bits;
1097 if (bd->options & NAND_BBT_NO_OOB)
1098 table_size += pattern_len;
1099 BUG_ON(table_size > (1 << this->bbt_erase_shift));
1100}
1101
1da177e4
LT
1102/**
1103 * nand_scan_bbt - [NAND Interface] scan, find, read and maybe create bad block table(s)
8b6e50c9
BN
1104 * @mtd: MTD device structure
1105 * @bd: descriptor for the good/bad block search pattern
1da177e4 1106 *
8b6e50c9
BN
1107 * The function checks, if a bad block table(s) is/are already available. If
1108 * not it scans the device for manufacturer marked good / bad blocks and writes
1109 * the bad block table(s) to the selected place.
1da177e4 1110 *
8b6e50c9
BN
1111 * The bad block table memory is allocated here. It must be freed by calling
1112 * the nand_free_bbt function.
1113 */
e0c7d767 1114int nand_scan_bbt(struct mtd_info *mtd, struct nand_bbt_descr *bd)
1da177e4
LT
1115{
1116 struct nand_chip *this = mtd->priv;
1117 int len, res = 0;
1118 uint8_t *buf;
1119 struct nand_bbt_descr *td = this->bbt_td;
1120 struct nand_bbt_descr *md = this->bbt_md;
1121
1122 len = mtd->size >> (this->bbt_erase_shift + 2);
8b6e50c9
BN
1123 /*
1124 * Allocate memory (2bit per block) and clear the memory bad block
1125 * table.
1126 */
95b93a0c 1127 this->bbt = kzalloc(len, GFP_KERNEL);
0870066d 1128 if (!this->bbt)
1da177e4 1129 return -ENOMEM;
1da177e4 1130
8b6e50c9
BN
1131 /*
1132 * If no primary table decriptor is given, scan the device to build a
1133 * memory based bad block table.
1da177e4 1134 */
eeada24d
AB
1135 if (!td) {
1136 if ((res = nand_memory_bbt(mtd, bd))) {
d0370219 1137 pr_err("nand_bbt: can't scan flash and build the RAM-based BBT\n");
e0c7d767 1138 kfree(this->bbt);
eeada24d
AB
1139 this->bbt = NULL;
1140 }
1141 return res;
1142 }
7cba7b14
SAS
1143 verify_bbt_descr(mtd, td);
1144 verify_bbt_descr(mtd, md);
1da177e4
LT
1145
1146 /* Allocate a temporary buffer for one eraseblock incl. oob */
1147 len = (1 << this->bbt_erase_shift);
1148 len += (len >> this->page_shift) * mtd->oobsize;
c3f8abf4 1149 buf = vmalloc(len);
1da177e4 1150 if (!buf) {
e0c7d767 1151 kfree(this->bbt);
1da177e4
LT
1152 this->bbt = NULL;
1153 return -ENOMEM;
1154 }
61b03bd7 1155
8b6e50c9 1156 /* Is the bbt at a given page? */
1da177e4 1157 if (td->options & NAND_BBT_ABSPAGE) {
7b5a2d40 1158 read_abs_bbts(mtd, buf, td, md);
61b03bd7 1159 } else {
1da177e4 1160 /* Search the bad block table using a pattern in oob */
7b5a2d40 1161 search_read_bbts(mtd, buf, td, md);
61b03bd7 1162 }
1da177e4 1163
7b5a2d40 1164 res = check_create(mtd, buf, bd);
61b03bd7 1165
1da177e4 1166 /* Prevent the bbt regions from erasing / writing */
e0c7d767 1167 mark_bbt_region(mtd, td);
1da177e4 1168 if (md)
e0c7d767 1169 mark_bbt_region(mtd, md);
61b03bd7 1170
e0c7d767 1171 vfree(buf);
1da177e4
LT
1172 return res;
1173}
1174
1da177e4 1175/**
b32843b7 1176 * nand_update_bbt - update bad block table(s)
8b6e50c9
BN
1177 * @mtd: MTD device structure
1178 * @offs: the offset of the newly marked block
1da177e4 1179 *
8b6e50c9
BN
1180 * The function updates the bad block table(s).
1181 */
b32843b7 1182static int nand_update_bbt(struct mtd_info *mtd, loff_t offs)
1da177e4
LT
1183{
1184 struct nand_chip *this = mtd->priv;
1196ac5a 1185 int len, res = 0;
1da177e4
LT
1186 int chip, chipsel;
1187 uint8_t *buf;
1188 struct nand_bbt_descr *td = this->bbt_td;
1189 struct nand_bbt_descr *md = this->bbt_md;
1190
1191 if (!this->bbt || !td)
1192 return -EINVAL;
1193
1da177e4
LT
1194 /* Allocate a temporary buffer for one eraseblock incl. oob */
1195 len = (1 << this->bbt_erase_shift);
1196 len += (len >> this->page_shift) * mtd->oobsize;
e0c7d767 1197 buf = kmalloc(len, GFP_KERNEL);
0870066d 1198 if (!buf)
1da177e4 1199 return -ENOMEM;
1da177e4 1200
8b6e50c9 1201 /* Do we have a bbt per chip? */
1da177e4 1202 if (td->options & NAND_BBT_PERCHIP) {
e0c7d767 1203 chip = (int)(offs >> this->chip_shift);
1da177e4
LT
1204 chipsel = chip;
1205 } else {
1206 chip = 0;
1207 chipsel = -1;
1208 }
1209
1210 td->version[chip]++;
1211 if (md)
61b03bd7 1212 md->version[chip]++;
1da177e4 1213
8b6e50c9 1214 /* Write the bad block table to the device? */
1196ac5a 1215 if (td->options & NAND_BBT_WRITE) {
e0c7d767 1216 res = write_bbt(mtd, buf, td, md, chipsel);
1da177e4
LT
1217 if (res < 0)
1218 goto out;
1219 }
8b6e50c9 1220 /* Write the mirror bad block table to the device? */
1196ac5a 1221 if (md && (md->options & NAND_BBT_WRITE)) {
e0c7d767 1222 res = write_bbt(mtd, buf, md, td, chipsel);
1da177e4
LT
1223 }
1224
e0c7d767
DW
1225 out:
1226 kfree(buf);
1da177e4
LT
1227 return res;
1228}
1229
8b6e50c9
BN
1230/*
1231 * Define some generic bad / good block scan pattern which are used
1232 * while scanning a device for factory marked good / bad blocks.
1233 */
1da177e4
LT
1234static uint8_t scan_ff_pattern[] = { 0xff, 0xff };
1235
7854d3f7 1236/* Generic flash bbt descriptors */
1da177e4
LT
1237static uint8_t bbt_pattern[] = {'B', 'b', 't', '0' };
1238static uint8_t mirror_pattern[] = {'1', 't', 'b', 'B' };
1239
1240static struct nand_bbt_descr bbt_main_descr = {
61b03bd7 1241 .options = NAND_BBT_LASTBLOCK | NAND_BBT_CREATE | NAND_BBT_WRITE
1da177e4
LT
1242 | NAND_BBT_2BIT | NAND_BBT_VERSION | NAND_BBT_PERCHIP,
1243 .offs = 8,
1244 .len = 4,
1245 .veroffs = 12,
61de9da6 1246 .maxblocks = NAND_BBT_SCAN_MAXBLOCKS,
1da177e4
LT
1247 .pattern = bbt_pattern
1248};
1249
1250static struct nand_bbt_descr bbt_mirror_descr = {
61b03bd7 1251 .options = NAND_BBT_LASTBLOCK | NAND_BBT_CREATE | NAND_BBT_WRITE
1da177e4
LT
1252 | NAND_BBT_2BIT | NAND_BBT_VERSION | NAND_BBT_PERCHIP,
1253 .offs = 8,
1254 .len = 4,
1255 .veroffs = 12,
61de9da6 1256 .maxblocks = NAND_BBT_SCAN_MAXBLOCKS,
1da177e4
LT
1257 .pattern = mirror_pattern
1258};
1259
9fd6b37a 1260static struct nand_bbt_descr bbt_main_no_oob_descr = {
7cba7b14
SAS
1261 .options = NAND_BBT_LASTBLOCK | NAND_BBT_CREATE | NAND_BBT_WRITE
1262 | NAND_BBT_2BIT | NAND_BBT_VERSION | NAND_BBT_PERCHIP
1263 | NAND_BBT_NO_OOB,
1264 .len = 4,
1265 .veroffs = 4,
61de9da6 1266 .maxblocks = NAND_BBT_SCAN_MAXBLOCKS,
7cba7b14
SAS
1267 .pattern = bbt_pattern
1268};
1269
9fd6b37a 1270static struct nand_bbt_descr bbt_mirror_no_oob_descr = {
7cba7b14
SAS
1271 .options = NAND_BBT_LASTBLOCK | NAND_BBT_CREATE | NAND_BBT_WRITE
1272 | NAND_BBT_2BIT | NAND_BBT_VERSION | NAND_BBT_PERCHIP
1273 | NAND_BBT_NO_OOB,
1274 .len = 4,
1275 .veroffs = 4,
61de9da6 1276 .maxblocks = NAND_BBT_SCAN_MAXBLOCKS,
7cba7b14
SAS
1277 .pattern = mirror_pattern
1278};
1279
752ed6c5 1280#define BADBLOCK_SCAN_MASK (~NAND_BBT_NO_OOB)
58373ff0 1281/**
752ed6c5 1282 * nand_create_badblock_pattern - [INTERN] Creates a BBT descriptor structure
8b6e50c9 1283 * @this: NAND chip to create descriptor for
58373ff0
BN
1284 *
1285 * This function allocates and initializes a nand_bbt_descr for BBM detection
752ed6c5 1286 * based on the properties of @this. The new descriptor is stored in
58373ff0
BN
1287 * this->badblock_pattern. Thus, this->badblock_pattern should be NULL when
1288 * passed to this function.
58373ff0 1289 */
752ed6c5 1290static int nand_create_badblock_pattern(struct nand_chip *this)
58373ff0
BN
1291{
1292 struct nand_bbt_descr *bd;
1293 if (this->badblock_pattern) {
752ed6c5 1294 pr_warn("Bad block pattern already allocated; not replacing\n");
58373ff0
BN
1295 return -EINVAL;
1296 }
1297 bd = kzalloc(sizeof(*bd), GFP_KERNEL);
0870066d 1298 if (!bd)
58373ff0 1299 return -ENOMEM;
752ed6c5 1300 bd->options = this->bbt_options & BADBLOCK_SCAN_MASK;
58373ff0
BN
1301 bd->offs = this->badblockpos;
1302 bd->len = (this->options & NAND_BUSWIDTH_16) ? 2 : 1;
1303 bd->pattern = scan_ff_pattern;
1304 bd->options |= NAND_BBT_DYNAMICSTRUCT;
1305 this->badblock_pattern = bd;
1306 return 0;
1307}
1308
1da177e4 1309/**
61b03bd7 1310 * nand_default_bbt - [NAND Interface] Select a default bad block table for the device
8b6e50c9 1311 * @mtd: MTD device structure
1da177e4 1312 *
8b6e50c9
BN
1313 * This function selects the default bad block table support for the device and
1314 * calls the nand_scan_bbt function.
1315 */
e0c7d767 1316int nand_default_bbt(struct mtd_info *mtd)
1da177e4
LT
1317{
1318 struct nand_chip *this = mtd->priv;
61b03bd7 1319
8b6e50c9 1320 /* Is a flash based bad block table requested? */
bb9ebd4e 1321 if (this->bbt_options & NAND_BBT_USE_FLASH) {
61b03bd7
TG
1322 /* Use the default pattern descriptors */
1323 if (!this->bbt_td) {
a40f7341 1324 if (this->bbt_options & NAND_BBT_NO_OOB) {
9fd6b37a
BN
1325 this->bbt_td = &bbt_main_no_oob_descr;
1326 this->bbt_md = &bbt_mirror_no_oob_descr;
7cba7b14
SAS
1327 } else {
1328 this->bbt_td = &bbt_main_descr;
1329 this->bbt_md = &bbt_mirror_descr;
1330 }
1da177e4 1331 }
1da177e4
LT
1332 } else {
1333 this->bbt_td = NULL;
1334 this->bbt_md = NULL;
1da177e4 1335 }
a2f812df
BN
1336
1337 if (!this->badblock_pattern)
752ed6c5 1338 nand_create_badblock_pattern(this);
a2f812df 1339
e0c7d767 1340 return nand_scan_bbt(mtd, this->badblock_pattern);
1da177e4
LT
1341}
1342
1343/**
61b03bd7 1344 * nand_isbad_bbt - [NAND Interface] Check if a block is bad
8b6e50c9
BN
1345 * @mtd: MTD device structure
1346 * @offs: offset in the device
1347 * @allowbbt: allow access to bad block table region
1348 */
e0c7d767 1349int nand_isbad_bbt(struct mtd_info *mtd, loff_t offs, int allowbbt)
1da177e4
LT
1350{
1351 struct nand_chip *this = mtd->priv;
39dbb029 1352 int block, res;
61b03bd7 1353
b4d20d60
BN
1354 block = (int)(offs >> this->bbt_erase_shift);
1355 res = bbt_get_entry(this, block);
1da177e4 1356
289c0522
BN
1357 pr_debug("nand_isbad_bbt(): bbt info for offs 0x%08x: "
1358 "(block %d) 0x%02x\n",
b4d20d60 1359 (unsigned int)offs, block, res);
1da177e4 1360
39dbb029 1361 switch (res) {
771c568b 1362 case BBT_BLOCK_GOOD:
e0c7d767 1363 return 0;
771c568b 1364 case BBT_BLOCK_WORN:
e0c7d767 1365 return 1;
771c568b 1366 case BBT_BLOCK_RESERVED:
e0c7d767 1367 return allowbbt ? 0 : 1;
1da177e4
LT
1368 }
1369 return 1;
1370}
1371
b32843b7
BN
1372/**
1373 * nand_markbad_bbt - [NAND Interface] Mark a block bad in the BBT
1374 * @mtd: MTD device structure
1375 * @offs: offset of the bad block
1376 */
1377int nand_markbad_bbt(struct mtd_info *mtd, loff_t offs)
1378{
1379 struct nand_chip *this = mtd->priv;
1380 int block, ret = 0;
1381
1382 block = (int)(offs >> this->bbt_erase_shift);
1383
1384 /* Mark bad block in memory */
1385 bbt_mark_entry(this, block, BBT_BLOCK_WORN);
1386
1387 /* Update flash-based bad block table */
1388 if (this->bbt_options & NAND_BBT_USE_FLASH)
1389 ret = nand_update_bbt(mtd, offs);
1390
1391 return ret;
1392}
1393
e0c7d767 1394EXPORT_SYMBOL(nand_scan_bbt);
This page took 0.635566 seconds and 5 git commands to generate.