blob: c0615d1526f9756576c126f45aa61c9d7ccb3c07 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
2 * drivers/mtd/nand_bbt.c
3 *
4 * Overview:
5 * Bad block table support for the NAND driver
Thomas Gleixner61b03bd2005-11-07 11:15:49 +00006 *
Fabio Estevamd159c4e2012-07-28 19:29:25 -03007 * Copyright © 2004 Thomas Gleixner (tglx@linutronix.de)
Linus Torvalds1da177e2005-04-16 15:20:36 -07008 *
Linus Torvalds1da177e2005-04-16 15:20:36 -07009 * 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 *
Thomas Gleixner61b03bd2005-11-07 11:15:49 +000015 * When nand_scan_bbt is called, then it tries to find the bad block table
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +020016 * depending on the options in the BBT descriptor(s). If no flash based BBT
Brian Norrisbb9ebd42011-05-31 16:31:23 -070017 * (NAND_BBT_USE_FLASH) is specified then the device is scanned for factory
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +020018 * 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
Huang Shijie44ed0ff2012-07-03 16:44:15 +080025 * version number, then the mirror BBT is used to build the memory based BBT.
Linus Torvalds1da177e2005-04-16 15:20:36 -070026 * If the tables are not versioned, then we "or" the bad block information.
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +020027 * 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
Thomas Gleixner61b03bd2005-11-07 11:15:49 +000029 * good / bad blocks and the bad block tables are created.
Linus Torvalds1da177e2005-04-16 15:20:36 -070030 *
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +020031 * For manufacturer created BBTs like the one found on M-SYS DOC devices
32 * the BBT is searched and read but never created
Linus Torvalds1da177e2005-04-16 15:20:36 -070033 *
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +020034 * The auto generated bad block table is located in the last good blocks
Thomas Gleixner61b03bd2005-11-07 11:15:49 +000035 * of the device. The table is mirrored, so it can be updated eventually.
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +020036 * 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
Brian Norrisbb9ebd42011-05-31 16:31:23 -070039 * option NAND_BBT_NO_OOB should be used (along with NAND_BBT_USE_FLASH, of
Brian Norrisa40f7342011-05-31 16:31:22 -070040 * course): it moves the ident pattern and the version byte into the data area
41 * and the OOB area will remain untouched.
Linus Torvalds1da177e2005-04-16 15:20:36 -070042 *
43 * The table uses 2 bits per block
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +020044 * 11b: block is good
45 * 00b: block is factory marked bad
46 * 01b, 10b: block is marked bad due to wear
Linus Torvalds1da177e2005-04-16 15:20:36 -070047 *
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
Thomas Gleixner61b03bd2005-11-07 11:15:49 +000053 *
Linus Torvalds1da177e2005-04-16 15:20:36 -070054 * 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
David Woodhousee0c7d762006-05-13 18:07:53 +010058 * - the space necessary for a bbt in FLASH does not exceed a block boundary
Thomas Gleixner61b03bd2005-11-07 11:15:49 +000059 *
Linus Torvalds1da177e2005-04-16 15:20:36 -070060 */
61
62#include <linux/slab.h>
63#include <linux/types.h>
64#include <linux/mtd/mtd.h>
Richard Genoud61de9da2012-09-11 15:50:54 +020065#include <linux/mtd/bbm.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070066#include <linux/mtd/nand.h>
67#include <linux/mtd/nand_ecc.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070068#include <linux/bitops.h>
69#include <linux/delay.h>
David Woodhousec3f8abf2006-05-13 04:03:42 +010070#include <linux/vmalloc.h>
Paul Gortmakerf3bcc012011-07-10 12:43:28 -040071#include <linux/export.h>
Brian Norris491ed062012-06-22 16:35:44 -070072#include <linux/string.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070073
Brian Norris771c5682013-07-30 17:52:55 -070074#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
Brian Norrisb32843b2013-07-30 17:52:59 -070082static int nand_update_bbt(struct mtd_info *mtd, loff_t offs);
83
Brian Norris771c5682013-07-30 17:52:55 -070084static 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
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +020098static int check_pattern_no_oob(uint8_t *buf, struct nand_bbt_descr *td)
99{
Brian Norris718894a2012-06-22 16:35:43 -0700100 if (memcmp(buf, td->pattern, td->len))
101 return -1;
102 return 0;
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +0200103}
104
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000105/**
Linus Torvalds1da177e2005-04-16 15:20:36 -0700106 * check_pattern - [GENERIC] check if a pattern is in the buffer
Brian Norris8b6e50c2011-05-25 14:59:01 -0700107 * @buf: the buffer to search
108 * @len: the length of buffer to search
109 * @paglen: the pagelength
110 * @td: search pattern descriptor
Linus Torvalds1da177e2005-04-16 15:20:36 -0700111 *
Brian Norris8b6e50c2011-05-25 14:59:01 -0700112 * Check for a pattern at the given place. Used to search bad block tables and
Brian Norrisdad22562013-07-30 17:53:00 -0700113 * good / bad block identifiers.
Brian Norris8b6e50c2011-05-25 14:59:01 -0700114 */
David Woodhousee0c7d762006-05-13 18:07:53 +0100115static int check_pattern(uint8_t *buf, int len, int paglen, struct nand_bbt_descr *td)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700116{
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +0200117 if (td->options & NAND_BBT_NO_OOB)
118 return check_pattern_no_oob(buf, td);
119
Linus Torvalds1da177e2005-04-16 15:20:36 -0700120 /* Compare the pattern */
Brian Norrisdad22562013-07-30 17:53:00 -0700121 if (memcmp(buf + paglen + td->offs, td->pattern, td->len))
Brian Norris75b66d82011-09-07 13:13:41 -0700122 return -1;
Brian Norris58373ff2010-07-15 12:15:44 -0700123
Linus Torvalds1da177e2005-04-16 15:20:36 -0700124 return 0;
125}
126
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000127/**
Thomas Gleixnerc9e053652005-06-14 16:39:57 +0100128 * check_short_pattern - [GENERIC] check if a pattern is in the buffer
Brian Norris8b6e50c2011-05-25 14:59:01 -0700129 * @buf: the buffer to search
130 * @td: search pattern descriptor
Thomas Gleixnerc9e053652005-06-14 16:39:57 +0100131 *
Brian Norris8b6e50c2011-05-25 14:59:01 -0700132 * 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 */
David Woodhousee0c7d762006-05-13 18:07:53 +0100136static int check_short_pattern(uint8_t *buf, struct nand_bbt_descr *td)
Thomas Gleixnerc9e053652005-06-14 16:39:57 +0100137{
Thomas Gleixnerc9e053652005-06-14 16:39:57 +0100138 /* Compare the pattern */
Brian Norris491ed062012-06-22 16:35:44 -0700139 if (memcmp(buf + td->offs, td->pattern, td->len))
140 return -1;
Thomas Gleixnerc9e053652005-06-14 16:39:57 +0100141 return 0;
142}
143
Linus Torvalds1da177e2005-04-16 15:20:36 -0700144/**
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +0200145 * add_marker_len - compute the length of the marker in data area
Brian Norris8b6e50c2011-05-25 14:59:01 -0700146 * @td: BBT descriptor used for computation
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +0200147 *
Brian Norris7854d3f2011-06-23 14:12:08 -0700148 * The length will be 0 if the marker is located in OOB area.
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +0200149 */
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
163/**
Linus Torvalds1da177e2005-04-16 15:20:36 -0700164 * read_bbt - [GENERIC] Read the bad block table starting from page
Brian Norris8b6e50c2011-05-25 14:59:01 -0700165 * @mtd: MTD device structure
166 * @buf: temporary buffer
167 * @page: the starting page
168 * @num: the number of bbt descriptors to read
Brian Norris7854d3f2011-06-23 14:12:08 -0700169 * @td: the bbt describtion table
Brian Norrisb4d20d62013-07-30 17:52:56 -0700170 * @offs: block number offset in the table
Linus Torvalds1da177e2005-04-16 15:20:36 -0700171 *
172 * Read the bad block table starting from page.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700173 */
David Woodhousee0c7d762006-05-13 18:07:53 +0100174static int read_bbt(struct mtd_info *mtd, uint8_t *buf, int page, int num,
Sebastian Andrzej Siewiordf5b4e32010-09-29 19:43:51 +0200175 struct nand_bbt_descr *td, int offs)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700176{
Brian Norris167a8d52011-09-20 18:35:08 -0700177 int res, ret = 0, i, j, act = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700178 struct nand_chip *this = mtd->priv;
179 size_t retlen, len, totlen;
180 loff_t from;
Sebastian Andrzej Siewiordf5b4e32010-09-29 19:43:51 +0200181 int bits = td->options & NAND_BBT_NRBITS_MSK;
Brian Norris596d7452011-09-07 13:13:33 -0700182 uint8_t msk = (uint8_t)((1 << bits) - 1);
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +0200183 u32 marker_len;
Sebastian Andrzej Siewiordf5b4e32010-09-29 19:43:51 +0200184 int reserved_block_code = td->reserved_block_code;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700185
186 totlen = (num * bits) >> 3;
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +0200187 marker_len = add_marker_len(td);
Brian Norris596d7452011-09-07 13:13:33 -0700188 from = ((loff_t)page) << this->page_shift;
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000189
Linus Torvalds1da177e2005-04-16 15:20:36 -0700190 while (totlen) {
Brian Norris596d7452011-09-07 13:13:33 -0700191 len = min(totlen, (size_t)(1 << this->bbt_erase_shift));
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +0200192 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 }
Artem Bityutskiy329ad392011-12-23 17:30:16 +0200201 res = mtd_read(mtd, from, len, &retlen, buf);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700202 if (res < 0) {
Brian Norris167a8d52011-09-20 18:35:08 -0700203 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");
Linus Torvalds1da177e2005-04-16 15:20:36 -0700213 return res;
214 }
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000215 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700216
217 /* Analyse data */
218 for (i = 0; i < len; i++) {
219 uint8_t dat = buf[i];
Brian Norrisb4d20d62013-07-30 17:52:56 -0700220 for (j = 0; j < 8; j += bits, act++) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700221 uint8_t tmp = (dat >> j) & msk;
222 if (tmp == msk)
223 continue;
David Woodhousee0c7d762006-05-13 18:07:53 +0100224 if (reserved_block_code && (tmp == reserved_block_code)) {
Brian Norrisd0370212011-07-19 10:06:08 -0700225 pr_info("nand_read_bbt: reserved block at 0x%012llx\n",
Brian Norrisb4d20d62013-07-30 17:52:56 -0700226 (loff_t)(offs + act) <<
227 this->bbt_erase_shift);
228 bbt_mark_entry(this, offs + act,
Brian Norris771c5682013-07-30 17:52:55 -0700229 BBT_BLOCK_RESERVED);
Thomas Gleixnerf1a28c02006-05-30 00:37:34 +0200230 mtd->ecc_stats.bbtblocks++;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700231 continue;
232 }
Brian Norris8b6e50c2011-05-25 14:59:01 -0700233 /*
234 * Leave it for now, if it's matured we can
Brian Norrisa0f50802011-07-19 10:06:06 -0700235 * move this message to pr_debug.
Brian Norris8b6e50c2011-05-25 14:59:01 -0700236 */
Brian Norrisd0370212011-07-19 10:06:08 -0700237 pr_info("nand_read_bbt: bad block at 0x%012llx\n",
Brian Norrisb4d20d62013-07-30 17:52:56 -0700238 (loff_t)(offs + act) <<
239 this->bbt_erase_shift);
Brian Norris8b6e50c2011-05-25 14:59:01 -0700240 /* Factory marked bad or worn out? */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700241 if (tmp == 0)
Brian Norrisb4d20d62013-07-30 17:52:56 -0700242 bbt_mark_entry(this, offs + act,
Brian Norris771c5682013-07-30 17:52:55 -0700243 BBT_BLOCK_FACTORY_BAD);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700244 else
Brian Norrisb4d20d62013-07-30 17:52:56 -0700245 bbt_mark_entry(this, offs + act,
Brian Norris771c5682013-07-30 17:52:55 -0700246 BBT_BLOCK_WORN);
Thomas Gleixnerf1a28c02006-05-30 00:37:34 +0200247 mtd->ecc_stats.badblocks++;
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000248 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700249 }
250 totlen -= len;
251 from += len;
252 }
Brian Norris167a8d52011-09-20 18:35:08 -0700253 return ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700254}
255
256/**
257 * read_abs_bbt - [GENERIC] Read the bad block table starting at a given page
Brian Norris8b6e50c2011-05-25 14:59:01 -0700258 * @mtd: MTD device structure
259 * @buf: temporary buffer
260 * @td: descriptor for the bad block table
Brian Norris596d7452011-09-07 13:13:33 -0700261 * @chip: read the table for a specific chip, -1 read all chips; applies only if
Brian Norris8b6e50c2011-05-25 14:59:01 -0700262 * NAND_BBT_PERCHIP option is set
Linus Torvalds1da177e2005-04-16 15:20:36 -0700263 *
Brian Norris8b6e50c2011-05-25 14:59:01 -0700264 * 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 */
David Woodhousee0c7d762006-05-13 18:07:53 +0100267static int read_abs_bbt(struct mtd_info *mtd, uint8_t *buf, struct nand_bbt_descr *td, int chip)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700268{
269 struct nand_chip *this = mtd->priv;
270 int res = 0, i;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700271
Linus Torvalds1da177e2005-04-16 15:20:36 -0700272 if (td->options & NAND_BBT_PERCHIP) {
273 int offs = 0;
274 for (i = 0; i < this->numchips; i++) {
275 if (chip == -1 || chip == i)
Sebastian Andrzej Siewiordf5b4e32010-09-29 19:43:51 +0200276 res = read_bbt(mtd, buf, td->pages[i],
277 this->chipsize >> this->bbt_erase_shift,
278 td, offs);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700279 if (res)
280 return res;
Brian Norrisb4d20d62013-07-30 17:52:56 -0700281 offs += this->chipsize >> this->bbt_erase_shift;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700282 }
283 } else {
Sebastian Andrzej Siewiordf5b4e32010-09-29 19:43:51 +0200284 res = read_bbt(mtd, buf, td->pages[0],
285 mtd->size >> this->bbt_erase_shift, td, 0);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700286 if (res)
287 return res;
288 }
289 return 0;
290}
291
Brian Norris8b6e50c2011-05-25 14:59:01 -0700292/* BBT marker is in the first page, no OOB */
Brian Norrisaf69dcd2012-06-22 16:35:42 -0700293static int scan_read_data(struct mtd_info *mtd, uint8_t *buf, loff_t offs,
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +0200294 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
Artem Bityutskiy329ad392011-12-23 17:30:16 +0200303 return mtd_read(mtd, offs, len, &retlen, buf);
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +0200304}
305
Brian Norrisa7e68832012-06-22 16:35:45 -0700306/**
Brian Norrisaf69dcd2012-06-22 16:35:42 -0700307 * scan_read_oob - [GENERIC] Scan data+OOB region to buffer
Brian Norrisa7e68832012-06-22 16:35:45 -0700308 * @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 */
Brian Norrisaf69dcd2012-06-22 16:35:42 -0700317static int scan_read_oob(struct mtd_info *mtd, uint8_t *buf, loff_t offs,
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200318 size_t len)
319{
320 struct mtd_oob_ops ops;
Brian Norrisa7e68832012-06-22 16:35:45 -0700321 int res, ret = 0;
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200322
Brian Norrisa7e68832012-06-22 16:35:45 -0700323 ops.mode = MTD_OPS_PLACE_OOB;
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200324 ops.ooboffs = 0;
325 ops.ooblen = mtd->oobsize;
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200326
Maxim Levitskyb64d39d2010-02-22 20:39:37 +0200327 while (len > 0) {
Brian Norris105513c2011-09-07 13:13:28 -0700328 ops.datbuf = buf;
329 ops.len = min(len, (size_t)mtd->writesize);
330 ops.oobbuf = buf + ops.len;
Maxim Levitskyb64d39d2010-02-22 20:39:37 +0200331
Artem Bityutskiyfd2819b2011-12-23 18:27:05 +0200332 res = mtd_read_oob(mtd, offs, &ops);
Brian Norrisa7e68832012-06-22 16:35:45 -0700333 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 }
Maxim Levitskyb64d39d2010-02-22 20:39:37 +0200339
340 buf += mtd->oobsize + mtd->writesize;
341 len -= mtd->writesize;
Dmitry Maluka34a57042012-05-11 20:51:51 +0300342 offs += mtd->writesize;
Maxim Levitskyb64d39d2010-02-22 20:39:37 +0200343 }
Brian Norrisa7e68832012-06-22 16:35:45 -0700344 return ret;
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200345}
346
Brian Norrisaf69dcd2012-06-22 16:35:42 -0700347static int scan_read(struct mtd_info *mtd, uint8_t *buf, loff_t offs,
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +0200348 size_t len, struct nand_bbt_descr *td)
349{
350 if (td->options & NAND_BBT_NO_OOB)
Brian Norrisaf69dcd2012-06-22 16:35:42 -0700351 return scan_read_data(mtd, buf, offs, td);
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +0200352 else
Brian Norrisaf69dcd2012-06-22 16:35:42 -0700353 return scan_read_oob(mtd, buf, offs, len);
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +0200354}
355
Brian Norris8b6e50c2011-05-25 14:59:01 -0700356/* Scan write data with oob to flash */
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200357static 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
Brian Norris0612b9d2011-08-30 18:45:40 -0700362 ops.mode = MTD_OPS_PLACE_OOB;
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200363 ops.ooboffs = 0;
364 ops.ooblen = mtd->oobsize;
365 ops.datbuf = buf;
366 ops.oobbuf = oob;
367 ops.len = len;
368
Artem Bityutskiya2cc5ba2011-12-23 18:29:55 +0200369 return mtd_write_oob(mtd, offs, &ops);
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200370}
371
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +0200372static 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
Linus Torvalds1da177e2005-04-16 15:20:36 -0700381/**
382 * read_abs_bbts - [GENERIC] Read the bad block table(s) for all chips starting at a given page
Brian Norris8b6e50c2011-05-25 14:59:01 -0700383 * @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
Linus Torvalds1da177e2005-04-16 15:20:36 -0700387 *
Brian Norris8b6e50c2011-05-25 14:59:01 -0700388 * 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 */
Brian Norris7b5a2d42012-06-22 16:35:41 -0700391static void read_abs_bbts(struct mtd_info *mtd, uint8_t *buf,
392 struct nand_bbt_descr *td, struct nand_bbt_descr *md)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700393{
394 struct nand_chip *this = mtd->priv;
395
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000396 /* Read the primary version, if available */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700397 if (td->options & NAND_BBT_VERSION) {
Brian Norrisaf69dcd2012-06-22 16:35:42 -0700398 scan_read(mtd, buf, (loff_t)td->pages[0] << this->page_shift,
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +0200399 mtd->writesize, td);
400 td->version[0] = buf[bbt_get_ver_offs(mtd, td)];
Brian Norris9a4d4d62011-07-19 10:06:07 -0700401 pr_info("Bad block table at page %d, version 0x%02X\n",
Brian Norrisd0370212011-07-19 10:06:08 -0700402 td->pages[0], td->version[0]);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700403 }
404
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000405 /* Read the mirror version, if available */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700406 if (md && (md->options & NAND_BBT_VERSION)) {
Brian Norrisaf69dcd2012-06-22 16:35:42 -0700407 scan_read(mtd, buf, (loff_t)md->pages[0] << this->page_shift,
Shmulik Ladkani7bb9c752012-06-10 13:58:12 +0300408 mtd->writesize, md);
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +0200409 md->version[0] = buf[bbt_get_ver_offs(mtd, md)];
Brian Norris9a4d4d62011-07-19 10:06:07 -0700410 pr_info("Bad block table at page %d, version 0x%02X\n",
Brian Norrisd0370212011-07-19 10:06:08 -0700411 md->pages[0], md->version[0]);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700412 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700413}
414
Brian Norris8b6e50c2011-05-25 14:59:01 -0700415/* Scan a given block partially */
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200416static int scan_block_fast(struct mtd_info *mtd, struct nand_bbt_descr *bd,
Shmulik Ladkanieceb84b2012-08-20 16:29:15 +0300417 loff_t offs, uint8_t *buf, int numpages)
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200418{
419 struct mtd_oob_ops ops;
420 int j, ret;
421
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200422 ops.ooblen = mtd->oobsize;
423 ops.oobbuf = buf;
424 ops.ooboffs = 0;
425 ops.datbuf = NULL;
Brian Norris0612b9d2011-08-30 18:45:40 -0700426 ops.mode = MTD_OPS_PLACE_OOB;
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200427
Shmulik Ladkanieceb84b2012-08-20 16:29:15 +0300428 for (j = 0; j < numpages; j++) {
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200429 /*
Brian Norris8b6e50c2011-05-25 14:59:01 -0700430 * Read the full oob until read_oob is fixed to handle single
431 * byte reads for 16 bit buswidth.
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200432 */
Artem Bityutskiyfd2819b2011-12-23 18:27:05 +0200433 ret = mtd_read_oob(mtd, offs, &ops);
Brian Norris903cd062011-06-28 16:28:58 -0700434 /* Ignore ECC errors when checking for BBM */
Brian Norrisd57f40542011-09-20 18:34:25 -0700435 if (ret && !mtd_is_bitflip_or_eccerr(ret))
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200436 return ret;
437
438 if (check_short_pattern(buf, bd))
439 return 1;
440
441 offs += mtd->writesize;
442 }
443 return 0;
444}
445
Linus Torvalds1da177e2005-04-16 15:20:36 -0700446/**
447 * create_bbt - [GENERIC] Create a bad block table by scanning the device
Brian Norris8b6e50c2011-05-25 14:59:01 -0700448 * @mtd: MTD device structure
449 * @buf: temporary buffer
450 * @bd: descriptor for the good/bad block search pattern
451 * @chip: create the table for a specific chip, -1 read all chips; applies only
452 * if NAND_BBT_PERCHIP option is set
Linus Torvalds1da177e2005-04-16 15:20:36 -0700453 *
Brian Norris8b6e50c2011-05-25 14:59:01 -0700454 * Create a bad block table by scanning the device for the given good/bad block
455 * identify pattern.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700456 */
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200457static int create_bbt(struct mtd_info *mtd, uint8_t *buf,
458 struct nand_bbt_descr *bd, int chip)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700459{
460 struct nand_chip *this = mtd->priv;
Brian Norris5961ad22013-10-30 00:41:30 -0400461 int i, numblocks, numpages;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700462 int startblock;
463 loff_t from;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700464
Brian Norris9a4d4d62011-07-19 10:06:07 -0700465 pr_info("Scanning device for bad blocks\n");
Linus Torvalds1da177e2005-04-16 15:20:36 -0700466
Brian Norris5961ad22013-10-30 00:41:30 -0400467 if (bd->options & NAND_BBT_SCAN2NDPAGE)
Shmulik Ladkanieceb84b2012-08-20 16:29:15 +0300468 numpages = 2;
Brian Norris58373ff2010-07-15 12:15:44 -0700469 else
Shmulik Ladkanieceb84b2012-08-20 16:29:15 +0300470 numpages = 1;
Artem B. Bityuckiy171650a2005-02-16 17:09:39 +0000471
Linus Torvalds1da177e2005-04-16 15:20:36 -0700472 if (chip == -1) {
Brian Norrisb4d20d62013-07-30 17:52:56 -0700473 numblocks = mtd->size >> this->bbt_erase_shift;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700474 startblock = 0;
475 from = 0;
476 } else {
477 if (chip >= this->numchips) {
Brian Norris9a4d4d62011-07-19 10:06:07 -0700478 pr_warn("create_bbt(): chipnr (%d) > available chips (%d)\n",
David Woodhousee0c7d762006-05-13 18:07:53 +0100479 chip + 1, this->numchips);
Artem B. Bityuckiy171650a2005-02-16 17:09:39 +0000480 return -EINVAL;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700481 }
Brian Norrisb4d20d62013-07-30 17:52:56 -0700482 numblocks = this->chipsize >> this->bbt_erase_shift;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700483 startblock = chip * numblocks;
484 numblocks += startblock;
Brian Norrisb4d20d62013-07-30 17:52:56 -0700485 from = (loff_t)startblock << this->bbt_erase_shift;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700486 }
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000487
Brian Norris5fb15492011-05-31 16:31:21 -0700488 if (this->bbt_options & NAND_BBT_SCANLASTPAGE)
Shmulik Ladkanieceb84b2012-08-20 16:29:15 +0300489 from += mtd->erasesize - (mtd->writesize * numpages);
Kevin Cernekeeb60b08b2010-05-04 20:58:10 -0700490
Brian Norrisb4d20d62013-07-30 17:52:56 -0700491 for (i = startblock; i < numblocks; i++) {
Artem B. Bityuckiyeeada242005-02-11 10:14:15 +0000492 int ret;
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000493
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +0200494 BUG_ON(bd->options & NAND_BBT_NO_OOB);
495
Brian Norris5961ad22013-10-30 00:41:30 -0400496 ret = scan_block_fast(mtd, bd, from, buf, numpages);
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200497 if (ret < 0)
498 return ret;
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000499
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200500 if (ret) {
Brian Norrisb4d20d62013-07-30 17:52:56 -0700501 bbt_mark_entry(this, i, BBT_BLOCK_FACTORY_BAD);
Brian Norris9a4d4d62011-07-19 10:06:07 -0700502 pr_warn("Bad eraseblock %d at 0x%012llx\n",
Brian Norrisb4d20d62013-07-30 17:52:56 -0700503 i, (unsigned long long)from);
Thomas Gleixnerf1a28c02006-05-30 00:37:34 +0200504 mtd->ecc_stats.badblocks++;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700505 }
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200506
Linus Torvalds1da177e2005-04-16 15:20:36 -0700507 from += (1 << this->bbt_erase_shift);
508 }
Artem B. Bityuckiyeeada242005-02-11 10:14:15 +0000509 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700510}
511
512/**
513 * search_bbt - [GENERIC] scan the device for a specific bad block table
Brian Norris8b6e50c2011-05-25 14:59:01 -0700514 * @mtd: MTD device structure
515 * @buf: temporary buffer
516 * @td: descriptor for the bad block table
Linus Torvalds1da177e2005-04-16 15:20:36 -0700517 *
Brian Norris8b6e50c2011-05-25 14:59:01 -0700518 * Read the bad block table by searching for a given ident pattern. Search is
519 * preformed either from the beginning up or from the end of the device
520 * downwards. The search starts always at the start of a block. If the option
521 * NAND_BBT_PERCHIP is given, each chip is searched for a bbt, which contains
522 * the bad block information of this chip. This is necessary to provide support
523 * for certain DOC devices.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700524 *
Brian Norris8b6e50c2011-05-25 14:59:01 -0700525 * The bbt ident pattern resides in the oob area of the first page in a block.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700526 */
David Woodhousee0c7d762006-05-13 18:07:53 +0100527static int search_bbt(struct mtd_info *mtd, uint8_t *buf, struct nand_bbt_descr *td)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700528{
529 struct nand_chip *this = mtd->priv;
530 int i, chips;
531 int bits, startblock, block, dir;
Joern Engel28318772006-05-22 23:18:05 +0200532 int scanlen = mtd->writesize + mtd->oobsize;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700533 int bbtblocks;
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200534 int blocktopage = this->bbt_erase_shift - this->page_shift;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700535
Brian Norris8b6e50c2011-05-25 14:59:01 -0700536 /* Search direction top -> down? */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700537 if (td->options & NAND_BBT_LASTBLOCK) {
David Woodhousee0c7d762006-05-13 18:07:53 +0100538 startblock = (mtd->size >> this->bbt_erase_shift) - 1;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700539 dir = -1;
540 } else {
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000541 startblock = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700542 dir = 1;
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000543 }
544
Brian Norris8b6e50c2011-05-25 14:59:01 -0700545 /* Do we have a bbt per chip? */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700546 if (td->options & NAND_BBT_PERCHIP) {
547 chips = this->numchips;
548 bbtblocks = this->chipsize >> this->bbt_erase_shift;
549 startblock &= bbtblocks - 1;
550 } else {
551 chips = 1;
552 bbtblocks = mtd->size >> this->bbt_erase_shift;
553 }
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000554
Linus Torvalds1da177e2005-04-16 15:20:36 -0700555 /* Number of bits for each erase block in the bbt */
556 bits = td->options & NAND_BBT_NRBITS_MSK;
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000557
Linus Torvalds1da177e2005-04-16 15:20:36 -0700558 for (i = 0; i < chips; i++) {
559 /* Reset version information */
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000560 td->version[i] = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700561 td->pages[i] = -1;
562 /* Scan the maximum number of blocks */
563 for (block = 0; block < td->maxblocks; block++) {
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200564
Linus Torvalds1da177e2005-04-16 15:20:36 -0700565 int actblock = startblock + dir * block;
Adrian Hunter69423d92008-12-10 13:37:21 +0000566 loff_t offs = (loff_t)actblock << this->bbt_erase_shift;
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200567
Linus Torvalds1da177e2005-04-16 15:20:36 -0700568 /* Read first page */
Brian Norrisaf69dcd2012-06-22 16:35:42 -0700569 scan_read(mtd, buf, offs, mtd->writesize, td);
Joern Engel28318772006-05-22 23:18:05 +0200570 if (!check_pattern(buf, scanlen, mtd->writesize, td)) {
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200571 td->pages[i] = actblock << blocktopage;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700572 if (td->options & NAND_BBT_VERSION) {
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +0200573 offs = bbt_get_ver_offs(mtd, td);
574 td->version[i] = buf[offs];
Linus Torvalds1da177e2005-04-16 15:20:36 -0700575 }
576 break;
577 }
578 }
579 startblock += this->chipsize >> this->bbt_erase_shift;
580 }
581 /* Check, if we found a bbt for each requested chip */
582 for (i = 0; i < chips; i++) {
583 if (td->pages[i] == -1)
Brian Norris9a4d4d62011-07-19 10:06:07 -0700584 pr_warn("Bad block table not found for chip %d\n", i);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700585 else
Brian Norrisd0370212011-07-19 10:06:08 -0700586 pr_info("Bad block table found at page %d, version "
587 "0x%02X\n", td->pages[i], td->version[i]);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700588 }
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000589 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700590}
591
592/**
593 * search_read_bbts - [GENERIC] scan the device for bad block table(s)
Brian Norris8b6e50c2011-05-25 14:59:01 -0700594 * @mtd: MTD device structure
595 * @buf: temporary buffer
596 * @td: descriptor for the bad block table
597 * @md: descriptor for the bad block table mirror
Linus Torvalds1da177e2005-04-16 15:20:36 -0700598 *
Brian Norris8b6e50c2011-05-25 14:59:01 -0700599 * Search and read the bad block table(s).
600 */
Brian Norris7b5a2d42012-06-22 16:35:41 -0700601static void search_read_bbts(struct mtd_info *mtd, uint8_t *buf,
602 struct nand_bbt_descr *td,
603 struct nand_bbt_descr *md)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700604{
605 /* Search the primary table */
David Woodhousee0c7d762006-05-13 18:07:53 +0100606 search_bbt(mtd, buf, td);
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000607
Linus Torvalds1da177e2005-04-16 15:20:36 -0700608 /* Search the mirror table */
609 if (md)
David Woodhousee0c7d762006-05-13 18:07:53 +0100610 search_bbt(mtd, buf, md);
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000611}
612
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000613/**
Linus Torvalds1da177e2005-04-16 15:20:36 -0700614 * write_bbt - [GENERIC] (Re)write the bad block table
Brian Norris8b6e50c2011-05-25 14:59:01 -0700615 * @mtd: MTD device structure
616 * @buf: temporary buffer
617 * @td: descriptor for the bad block table
618 * @md: descriptor for the bad block table mirror
619 * @chipsel: selector for a specific chip, -1 for all
Linus Torvalds1da177e2005-04-16 15:20:36 -0700620 *
Brian Norris8b6e50c2011-05-25 14:59:01 -0700621 * (Re)write the bad block table.
622 */
David Woodhousee0c7d762006-05-13 18:07:53 +0100623static int write_bbt(struct mtd_info *mtd, uint8_t *buf,
Thomas Gleixner9223a452006-05-23 17:21:03 +0200624 struct nand_bbt_descr *td, struct nand_bbt_descr *md,
625 int chipsel)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700626{
627 struct nand_chip *this = mtd->priv;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700628 struct erase_info einfo;
Brian Norrisb4d20d62013-07-30 17:52:56 -0700629 int i, res, chip = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700630 int bits, startblock, dir, page, offs, numblocks, sft, sftmsk;
Brian Norrisb4d20d62013-07-30 17:52:56 -0700631 int nrchips, pageoffs, ooboffs;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700632 uint8_t msk[4];
633 uint8_t rcode = td->reserved_block_code;
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200634 size_t retlen, len = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700635 loff_t to;
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200636 struct mtd_oob_ops ops;
637
638 ops.ooblen = mtd->oobsize;
639 ops.ooboffs = 0;
640 ops.datbuf = NULL;
Brian Norris0612b9d2011-08-30 18:45:40 -0700641 ops.mode = MTD_OPS_PLACE_OOB;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700642
643 if (!rcode)
644 rcode = 0xff;
Brian Norris8b6e50c2011-05-25 14:59:01 -0700645 /* Write bad block table per chip rather than per device? */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700646 if (td->options & NAND_BBT_PERCHIP) {
David Woodhousee0c7d762006-05-13 18:07:53 +0100647 numblocks = (int)(this->chipsize >> this->bbt_erase_shift);
Brian Norris8b6e50c2011-05-25 14:59:01 -0700648 /* Full device write or specific chip? */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700649 if (chipsel == -1) {
650 nrchips = this->numchips;
651 } else {
652 nrchips = chipsel + 1;
653 chip = chipsel;
654 }
655 } else {
David Woodhousee0c7d762006-05-13 18:07:53 +0100656 numblocks = (int)(mtd->size >> this->bbt_erase_shift);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700657 nrchips = 1;
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000658 }
659
Linus Torvalds1da177e2005-04-16 15:20:36 -0700660 /* Loop through the chips */
661 for (; chip < nrchips; chip++) {
Brian Norris8b6e50c2011-05-25 14:59:01 -0700662 /*
663 * There was already a version of the table, reuse the page
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000664 * This applies for absolute placement too, as we have the
Linus Torvalds1da177e2005-04-16 15:20:36 -0700665 * page nr. in td->pages.
666 */
667 if (td->pages[chip] != -1) {
668 page = td->pages[chip];
669 goto write;
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000670 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700671
Brian Norris8b6e50c2011-05-25 14:59:01 -0700672 /*
673 * Automatic placement of the bad block table. Search direction
674 * top -> down?
675 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700676 if (td->options & NAND_BBT_LASTBLOCK) {
677 startblock = numblocks * (chip + 1) - 1;
678 dir = -1;
679 } else {
680 startblock = chip * numblocks;
681 dir = 1;
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000682 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700683
684 for (i = 0; i < td->maxblocks; i++) {
685 int block = startblock + dir * i;
686 /* Check, if the block is bad */
Brian Norris771c5682013-07-30 17:52:55 -0700687 switch (bbt_get_entry(this, block)) {
688 case BBT_BLOCK_WORN:
689 case BBT_BLOCK_FACTORY_BAD:
Linus Torvalds1da177e2005-04-16 15:20:36 -0700690 continue;
691 }
Thomas Gleixner9223a452006-05-23 17:21:03 +0200692 page = block <<
693 (this->bbt_erase_shift - this->page_shift);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700694 /* Check, if the block is used by the mirror table */
695 if (!md || md->pages[chip] != page)
696 goto write;
697 }
Brian Norris9a4d4d62011-07-19 10:06:07 -0700698 pr_err("No space left to write bad block table\n");
Linus Torvalds1da177e2005-04-16 15:20:36 -0700699 return -ENOSPC;
David Woodhousee0c7d762006-05-13 18:07:53 +0100700 write:
Linus Torvalds1da177e2005-04-16 15:20:36 -0700701
702 /* Set up shift count and masks for the flash table */
703 bits = td->options & NAND_BBT_NRBITS_MSK;
Thomas Gleixner9223a452006-05-23 17:21:03 +0200704 msk[2] = ~rcode;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700705 switch (bits) {
Thomas Gleixner9223a452006-05-23 17:21:03 +0200706 case 1: sft = 3; sftmsk = 0x07; msk[0] = 0x00; msk[1] = 0x01;
707 msk[3] = 0x01;
708 break;
709 case 2: sft = 2; sftmsk = 0x06; msk[0] = 0x00; msk[1] = 0x01;
710 msk[3] = 0x03;
711 break;
712 case 4: sft = 1; sftmsk = 0x04; msk[0] = 0x00; msk[1] = 0x0C;
713 msk[3] = 0x0f;
714 break;
715 case 8: sft = 0; sftmsk = 0x00; msk[0] = 0x00; msk[1] = 0x0F;
716 msk[3] = 0xff;
717 break;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700718 default: return -EINVAL;
719 }
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000720
Brian Norris596d7452011-09-07 13:13:33 -0700721 to = ((loff_t)page) << this->page_shift;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700722
Brian Norris8b6e50c2011-05-25 14:59:01 -0700723 /* Must we save the block contents? */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700724 if (td->options & NAND_BBT_SAVECONTENT) {
725 /* Make it block aligned */
Brian Norris596d7452011-09-07 13:13:33 -0700726 to &= ~((loff_t)((1 << this->bbt_erase_shift) - 1));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700727 len = 1 << this->bbt_erase_shift;
Artem Bityutskiy329ad392011-12-23 17:30:16 +0200728 res = mtd_read(mtd, to, len, &retlen, buf);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700729 if (res < 0) {
730 if (retlen != len) {
Brian Norrisd0370212011-07-19 10:06:08 -0700731 pr_info("nand_bbt: error reading block "
732 "for writing the bad block table\n");
Linus Torvalds1da177e2005-04-16 15:20:36 -0700733 return res;
734 }
Brian Norrisd0370212011-07-19 10:06:08 -0700735 pr_warn("nand_bbt: ECC error while reading "
736 "block for writing bad block table\n");
Linus Torvalds1da177e2005-04-16 15:20:36 -0700737 }
Thomas Gleixner9223a452006-05-23 17:21:03 +0200738 /* Read oob data */
Vitaly Wool70145682006-11-03 18:20:38 +0300739 ops.ooblen = (len >> this->page_shift) * mtd->oobsize;
Thomas Gleixner8593fbc2006-05-29 03:26:58 +0200740 ops.oobbuf = &buf[len];
Artem Bityutskiyfd2819b2011-12-23 18:27:05 +0200741 res = mtd_read_oob(mtd, to + mtd->writesize, &ops);
Vitaly Wool70145682006-11-03 18:20:38 +0300742 if (res < 0 || ops.oobretlen != ops.ooblen)
Thomas Gleixner9223a452006-05-23 17:21:03 +0200743 goto outerr;
744
Linus Torvalds1da177e2005-04-16 15:20:36 -0700745 /* Calc the byte offset in the buffer */
746 pageoffs = page - (int)(to >> this->page_shift);
747 offs = pageoffs << this->page_shift;
748 /* Preset the bbt area with 0xff */
Brian Norris596d7452011-09-07 13:13:33 -0700749 memset(&buf[offs], 0xff, (size_t)(numblocks >> sft));
Thomas Gleixner9223a452006-05-23 17:21:03 +0200750 ooboffs = len + (pageoffs * mtd->oobsize);
751
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +0200752 } else if (td->options & NAND_BBT_NO_OOB) {
753 ooboffs = 0;
754 offs = td->len;
Brian Norris8b6e50c2011-05-25 14:59:01 -0700755 /* The version byte */
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +0200756 if (td->options & NAND_BBT_VERSION)
757 offs++;
758 /* Calc length */
Brian Norris596d7452011-09-07 13:13:33 -0700759 len = (size_t)(numblocks >> sft);
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +0200760 len += offs;
Brian Norris8b6e50c2011-05-25 14:59:01 -0700761 /* Make it page aligned! */
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +0200762 len = ALIGN(len, mtd->writesize);
763 /* Preset the buffer with 0xff */
764 memset(buf, 0xff, len);
765 /* Pattern is located at the begin of first page */
766 memcpy(buf, td->pattern, td->len);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700767 } else {
768 /* Calc length */
Brian Norris596d7452011-09-07 13:13:33 -0700769 len = (size_t)(numblocks >> sft);
Brian Norris8b6e50c2011-05-25 14:59:01 -0700770 /* Make it page aligned! */
Sebastian Andrzej Siewiorcda32092010-09-29 19:43:50 +0200771 len = ALIGN(len, mtd->writesize);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700772 /* Preset the buffer with 0xff */
Thomas Gleixner9223a452006-05-23 17:21:03 +0200773 memset(buf, 0xff, len +
774 (len >> this->page_shift)* mtd->oobsize);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700775 offs = 0;
Thomas Gleixner9223a452006-05-23 17:21:03 +0200776 ooboffs = len;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700777 /* Pattern is located in oob area of first page */
Thomas Gleixner9223a452006-05-23 17:21:03 +0200778 memcpy(&buf[ooboffs + td->offs], td->pattern, td->len);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700779 }
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000780
Thomas Gleixner9223a452006-05-23 17:21:03 +0200781 if (td->options & NAND_BBT_VERSION)
782 buf[ooboffs + td->veroffs] = td->version[chip];
783
Brian Norris8b6e50c2011-05-25 14:59:01 -0700784 /* Walk through the memory table */
Brian Norrisb4d20d62013-07-30 17:52:56 -0700785 for (i = 0; i < numblocks; i++) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700786 uint8_t dat;
Brian Norrisb4d20d62013-07-30 17:52:56 -0700787 int sftcnt = (i << (3 - sft)) & sftmsk;
788 dat = bbt_get_entry(this, chip * numblocks + i);
789 /* Do not store the reserved bbt blocks! */
790 buf[offs + (i >> sft)] &= ~(msk[dat] << sftcnt);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700791 }
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000792
David Woodhousee0c7d762006-05-13 18:07:53 +0100793 memset(&einfo, 0, sizeof(einfo));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700794 einfo.mtd = mtd;
Adrian Hunter69423d92008-12-10 13:37:21 +0000795 einfo.addr = to;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700796 einfo.len = 1 << this->bbt_erase_shift;
David Woodhousee0c7d762006-05-13 18:07:53 +0100797 res = nand_erase_nand(mtd, &einfo, 1);
Thomas Gleixner9223a452006-05-23 17:21:03 +0200798 if (res < 0)
799 goto outerr;
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000800
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +0200801 res = scan_write_bbt(mtd, to, len, buf,
802 td->options & NAND_BBT_NO_OOB ? NULL :
803 &buf[len]);
Thomas Gleixner9223a452006-05-23 17:21:03 +0200804 if (res < 0)
805 goto outerr;
806
Brian Norrisd0370212011-07-19 10:06:08 -0700807 pr_info("Bad block table written to 0x%012llx, version 0x%02X\n",
808 (unsigned long long)to, td->version[chip]);
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000809
Linus Torvalds1da177e2005-04-16 15:20:36 -0700810 /* Mark it as used */
811 td->pages[chip] = page;
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000812 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700813 return 0;
Thomas Gleixner9223a452006-05-23 17:21:03 +0200814
815 outerr:
Brian Norrisd0370212011-07-19 10:06:08 -0700816 pr_warn("nand_bbt: error while writing bad block table %d\n", res);
Thomas Gleixner9223a452006-05-23 17:21:03 +0200817 return res;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700818}
819
820/**
821 * nand_memory_bbt - [GENERIC] create a memory based bad block table
Brian Norris8b6e50c2011-05-25 14:59:01 -0700822 * @mtd: MTD device structure
823 * @bd: descriptor for the good/bad block search pattern
Linus Torvalds1da177e2005-04-16 15:20:36 -0700824 *
Brian Norris8b6e50c2011-05-25 14:59:01 -0700825 * The function creates a memory based bbt by scanning the device for
826 * manufacturer / software marked good / bad blocks.
827 */
David Woodhousee0c7d762006-05-13 18:07:53 +0100828static inline int nand_memory_bbt(struct mtd_info *mtd, struct nand_bbt_descr *bd)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700829{
830 struct nand_chip *this = mtd->priv;
831
David Woodhouse4bf63fc2006-09-25 17:08:04 +0100832 return create_bbt(mtd, this->buffers->databuf, bd, -1);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700833}
834
835/**
David Woodhousee0c7d762006-05-13 18:07:53 +0100836 * check_create - [GENERIC] create and write bbt(s) if necessary
Brian Norris8b6e50c2011-05-25 14:59:01 -0700837 * @mtd: MTD device structure
838 * @buf: temporary buffer
839 * @bd: descriptor for the good/bad block search pattern
Linus Torvalds1da177e2005-04-16 15:20:36 -0700840 *
Brian Norris8b6e50c2011-05-25 14:59:01 -0700841 * The function checks the results of the previous call to read_bbt and creates
842 * / updates the bbt(s) if necessary. Creation is necessary if no bbt was found
843 * for the chip/device. Update is necessary if one of the tables is missing or
844 * the version nr. of one table is less than the other.
845 */
David Woodhousee0c7d762006-05-13 18:07:53 +0100846static int check_create(struct mtd_info *mtd, uint8_t *buf, struct nand_bbt_descr *bd)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700847{
Brian Norris623978d2011-09-20 18:35:34 -0700848 int i, chips, writeops, create, chipsel, res, res2;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700849 struct nand_chip *this = mtd->priv;
850 struct nand_bbt_descr *td = this->bbt_td;
851 struct nand_bbt_descr *md = this->bbt_md;
852 struct nand_bbt_descr *rd, *rd2;
853
Brian Norris8b6e50c2011-05-25 14:59:01 -0700854 /* Do we have a bbt per chip? */
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000855 if (td->options & NAND_BBT_PERCHIP)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700856 chips = this->numchips;
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000857 else
Linus Torvalds1da177e2005-04-16 15:20:36 -0700858 chips = 1;
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000859
Linus Torvalds1da177e2005-04-16 15:20:36 -0700860 for (i = 0; i < chips; i++) {
861 writeops = 0;
Brian Norrisb61bf5b2011-09-07 13:13:35 -0700862 create = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700863 rd = NULL;
864 rd2 = NULL;
Brian Norris623978d2011-09-20 18:35:34 -0700865 res = res2 = 0;
Brian Norris8b6e50c2011-05-25 14:59:01 -0700866 /* Per chip or per device? */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700867 chipsel = (td->options & NAND_BBT_PERCHIP) ? i : -1;
Brian Norris8b6e50c2011-05-25 14:59:01 -0700868 /* Mirrored table available? */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700869 if (md) {
870 if (td->pages[i] == -1 && md->pages[i] == -1) {
Brian Norrisb61bf5b2011-09-07 13:13:35 -0700871 create = 1;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700872 writeops = 0x03;
Brian Norrisc5e8ef92011-09-07 13:13:34 -0700873 } else if (td->pages[i] == -1) {
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000874 rd = md;
Brian Norris596d7452011-09-07 13:13:33 -0700875 writeops = 0x01;
Brian Norrisc5e8ef92011-09-07 13:13:34 -0700876 } else if (md->pages[i] == -1) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700877 rd = td;
Brian Norris596d7452011-09-07 13:13:33 -0700878 writeops = 0x02;
Brian Norrisc5e8ef92011-09-07 13:13:34 -0700879 } else if (td->version[i] == md->version[i]) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700880 rd = td;
881 if (!(td->options & NAND_BBT_VERSION))
882 rd2 = md;
Brian Norrisc5e8ef92011-09-07 13:13:34 -0700883 } else if (((int8_t)(td->version[i] - md->version[i])) > 0) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700884 rd = td;
Brian Norris596d7452011-09-07 13:13:33 -0700885 writeops = 0x02;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700886 } else {
887 rd = md;
Brian Norris596d7452011-09-07 13:13:33 -0700888 writeops = 0x01;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700889 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700890 } else {
891 if (td->pages[i] == -1) {
Brian Norrisb61bf5b2011-09-07 13:13:35 -0700892 create = 1;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700893 writeops = 0x01;
Brian Norrisb61bf5b2011-09-07 13:13:35 -0700894 } else {
895 rd = td;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700896 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700897 }
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000898
Brian Norrisb61bf5b2011-09-07 13:13:35 -0700899 if (create) {
900 /* Create the bad block table by scanning the device? */
901 if (!(td->options & NAND_BBT_CREATE))
902 continue;
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000903
Brian Norrisb61bf5b2011-09-07 13:13:35 -0700904 /* Create the table in memory by scanning the chip(s) */
905 if (!(this->bbt_options & NAND_BBT_CREATE_EMPTY))
906 create_bbt(mtd, buf, bd, chipsel);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700907
Brian Norrisb61bf5b2011-09-07 13:13:35 -0700908 td->version[i] = 1;
909 if (md)
910 md->version[i] = 1;
911 }
912
Brian Norris8b6e50c2011-05-25 14:59:01 -0700913 /* Read back first? */
Brian Norris623978d2011-09-20 18:35:34 -0700914 if (rd) {
915 res = read_abs_bbt(mtd, buf, rd, chipsel);
916 if (mtd_is_eccerr(res)) {
917 /* Mark table as invalid */
918 rd->pages[i] = -1;
Brian Norrisdadc17a2011-09-20 18:35:57 -0700919 rd->version[i] = 0;
Brian Norris623978d2011-09-20 18:35:34 -0700920 i--;
921 continue;
922 }
923 }
Brian Norris8b6e50c2011-05-25 14:59:01 -0700924 /* If they weren't versioned, read both */
Brian Norris623978d2011-09-20 18:35:34 -0700925 if (rd2) {
926 res2 = read_abs_bbt(mtd, buf, rd2, chipsel);
927 if (mtd_is_eccerr(res2)) {
928 /* Mark table as invalid */
929 rd2->pages[i] = -1;
Brian Norrisdadc17a2011-09-20 18:35:57 -0700930 rd2->version[i] = 0;
Brian Norris623978d2011-09-20 18:35:34 -0700931 i--;
932 continue;
933 }
934 }
935
936 /* Scrub the flash table(s)? */
937 if (mtd_is_bitflip(res) || mtd_is_bitflip(res2))
938 writeops = 0x03;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700939
Brian Norrisdadc17a2011-09-20 18:35:57 -0700940 /* Update version numbers before writing */
941 if (md) {
942 td->version[i] = max(td->version[i], md->version[i]);
943 md->version[i] = td->version[i];
944 }
945
Brian Norris8b6e50c2011-05-25 14:59:01 -0700946 /* Write the bad block table to the device? */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700947 if ((writeops & 0x01) && (td->options & NAND_BBT_WRITE)) {
David Woodhousee0c7d762006-05-13 18:07:53 +0100948 res = write_bbt(mtd, buf, td, md, chipsel);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700949 if (res < 0)
950 return res;
951 }
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000952
Brian Norris8b6e50c2011-05-25 14:59:01 -0700953 /* Write the mirror bad block table to the device? */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700954 if ((writeops & 0x02) && md && (md->options & NAND_BBT_WRITE)) {
David Woodhousee0c7d762006-05-13 18:07:53 +0100955 res = write_bbt(mtd, buf, md, td, chipsel);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700956 if (res < 0)
957 return res;
958 }
959 }
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000960 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700961}
962
963/**
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000964 * mark_bbt_regions - [GENERIC] mark the bad block table regions
Brian Norris8b6e50c2011-05-25 14:59:01 -0700965 * @mtd: MTD device structure
966 * @td: bad block table descriptor
Linus Torvalds1da177e2005-04-16 15:20:36 -0700967 *
Brian Norris8b6e50c2011-05-25 14:59:01 -0700968 * The bad block table regions are marked as "bad" to prevent accidental
969 * erasures / writes. The regions are identified by the mark 0x02.
970 */
David Woodhousee0c7d762006-05-13 18:07:53 +0100971static void mark_bbt_region(struct mtd_info *mtd, struct nand_bbt_descr *td)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700972{
973 struct nand_chip *this = mtd->priv;
974 int i, j, chips, block, nrblocks, update;
Brian Norris771c5682013-07-30 17:52:55 -0700975 uint8_t oldval;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700976
Brian Norris8b6e50c2011-05-25 14:59:01 -0700977 /* Do we have a bbt per chip? */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700978 if (td->options & NAND_BBT_PERCHIP) {
979 chips = this->numchips;
980 nrblocks = (int)(this->chipsize >> this->bbt_erase_shift);
981 } else {
982 chips = 1;
983 nrblocks = (int)(mtd->size >> this->bbt_erase_shift);
Thomas Gleixner61b03bd2005-11-07 11:15:49 +0000984 }
985
Linus Torvalds1da177e2005-04-16 15:20:36 -0700986 for (i = 0; i < chips; i++) {
987 if ((td->options & NAND_BBT_ABSPAGE) ||
988 !(td->options & NAND_BBT_WRITE)) {
David Woodhousee0c7d762006-05-13 18:07:53 +0100989 if (td->pages[i] == -1)
990 continue;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700991 block = td->pages[i] >> (this->bbt_erase_shift - this->page_shift);
Brian Norrisb4d20d62013-07-30 17:52:56 -0700992 oldval = bbt_get_entry(this, block);
993 bbt_mark_entry(this, block, BBT_BLOCK_RESERVED);
Brian Norris771c5682013-07-30 17:52:55 -0700994 if ((oldval != BBT_BLOCK_RESERVED) &&
995 td->reserved_block_code)
Brian Norrisb4d20d62013-07-30 17:52:56 -0700996 nand_update_bbt(mtd, (loff_t)block <<
997 this->bbt_erase_shift);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700998 continue;
999 }
1000 update = 0;
1001 if (td->options & NAND_BBT_LASTBLOCK)
1002 block = ((i + 1) * nrblocks) - td->maxblocks;
Thomas Gleixner61b03bd2005-11-07 11:15:49 +00001003 else
Linus Torvalds1da177e2005-04-16 15:20:36 -07001004 block = i * nrblocks;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001005 for (j = 0; j < td->maxblocks; j++) {
Brian Norrisb4d20d62013-07-30 17:52:56 -07001006 oldval = bbt_get_entry(this, block);
1007 bbt_mark_entry(this, block, BBT_BLOCK_RESERVED);
Brian Norris771c5682013-07-30 17:52:55 -07001008 if (oldval != BBT_BLOCK_RESERVED)
David Woodhousee0c7d762006-05-13 18:07:53 +01001009 update = 1;
Brian Norrisb4d20d62013-07-30 17:52:56 -07001010 block++;
Thomas Gleixner61b03bd2005-11-07 11:15:49 +00001011 }
Brian Norris8b6e50c2011-05-25 14:59:01 -07001012 /*
1013 * If we want reserved blocks to be recorded to flash, and some
1014 * new ones have been marked, then we need to update the stored
1015 * bbts. This should only happen once.
1016 */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001017 if (update && td->reserved_block_code)
Brian Norrisb4d20d62013-07-30 17:52:56 -07001018 nand_update_bbt(mtd, (loff_t)(block - 1) <<
1019 this->bbt_erase_shift);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001020 }
1021}
1022
1023/**
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +02001024 * verify_bbt_descr - verify the bad block description
Brian Norris8b6e50c2011-05-25 14:59:01 -07001025 * @mtd: MTD device structure
1026 * @bd: the table to verify
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +02001027 *
1028 * This functions performs a few sanity checks on the bad block description
1029 * table.
1030 */
1031static void verify_bbt_descr(struct mtd_info *mtd, struct nand_bbt_descr *bd)
1032{
1033 struct nand_chip *this = mtd->priv;
Stanislav Fomichev7912a5e2011-02-07 23:48:25 +03001034 u32 pattern_len;
1035 u32 bits;
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +02001036 u32 table_size;
1037
1038 if (!bd)
1039 return;
Stanislav Fomichev7912a5e2011-02-07 23:48:25 +03001040
1041 pattern_len = bd->len;
1042 bits = bd->options & NAND_BBT_NRBITS_MSK;
1043
Brian Norrisa40f7342011-05-31 16:31:22 -07001044 BUG_ON((this->bbt_options & NAND_BBT_NO_OOB) &&
Brian Norrisbb9ebd42011-05-31 16:31:23 -07001045 !(this->bbt_options & NAND_BBT_USE_FLASH));
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +02001046 BUG_ON(!bits);
1047
1048 if (bd->options & NAND_BBT_VERSION)
1049 pattern_len++;
1050
1051 if (bd->options & NAND_BBT_NO_OOB) {
Brian Norrisbb9ebd42011-05-31 16:31:23 -07001052 BUG_ON(!(this->bbt_options & NAND_BBT_USE_FLASH));
Brian Norrisa40f7342011-05-31 16:31:22 -07001053 BUG_ON(!(this->bbt_options & NAND_BBT_NO_OOB));
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +02001054 BUG_ON(bd->offs);
1055 if (bd->options & NAND_BBT_VERSION)
1056 BUG_ON(bd->veroffs != bd->len);
1057 BUG_ON(bd->options & NAND_BBT_SAVECONTENT);
1058 }
1059
1060 if (bd->options & NAND_BBT_PERCHIP)
1061 table_size = this->chipsize >> this->bbt_erase_shift;
1062 else
1063 table_size = mtd->size >> this->bbt_erase_shift;
1064 table_size >>= 3;
1065 table_size *= bits;
1066 if (bd->options & NAND_BBT_NO_OOB)
1067 table_size += pattern_len;
1068 BUG_ON(table_size > (1 << this->bbt_erase_shift));
1069}
1070
1071/**
Linus Torvalds1da177e2005-04-16 15:20:36 -07001072 * nand_scan_bbt - [NAND Interface] scan, find, read and maybe create bad block table(s)
Brian Norris8b6e50c2011-05-25 14:59:01 -07001073 * @mtd: MTD device structure
1074 * @bd: descriptor for the good/bad block search pattern
Linus Torvalds1da177e2005-04-16 15:20:36 -07001075 *
Brian Norris8b6e50c2011-05-25 14:59:01 -07001076 * The function checks, if a bad block table(s) is/are already available. If
1077 * not it scans the device for manufacturer marked good / bad blocks and writes
1078 * the bad block table(s) to the selected place.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001079 *
Brian Norris8b6e50c2011-05-25 14:59:01 -07001080 * The bad block table memory is allocated here. It must be freed by calling
1081 * the nand_free_bbt function.
1082 */
David Woodhousee0c7d762006-05-13 18:07:53 +01001083int nand_scan_bbt(struct mtd_info *mtd, struct nand_bbt_descr *bd)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001084{
1085 struct nand_chip *this = mtd->priv;
1086 int len, res = 0;
1087 uint8_t *buf;
1088 struct nand_bbt_descr *td = this->bbt_td;
1089 struct nand_bbt_descr *md = this->bbt_md;
1090
1091 len = mtd->size >> (this->bbt_erase_shift + 2);
Brian Norris8b6e50c2011-05-25 14:59:01 -07001092 /*
1093 * Allocate memory (2bit per block) and clear the memory bad block
1094 * table.
1095 */
Burman Yan95b93a02006-11-15 21:10:29 +02001096 this->bbt = kzalloc(len, GFP_KERNEL);
Brian Norris08700662011-06-07 16:01:54 -07001097 if (!this->bbt)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001098 return -ENOMEM;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001099
Brian Norris8b6e50c2011-05-25 14:59:01 -07001100 /*
1101 * If no primary table decriptor is given, scan the device to build a
1102 * memory based bad block table.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001103 */
Artem B. Bityuckiyeeada242005-02-11 10:14:15 +00001104 if (!td) {
1105 if ((res = nand_memory_bbt(mtd, bd))) {
Brian Norrisd0370212011-07-19 10:06:08 -07001106 pr_err("nand_bbt: can't scan flash and build the RAM-based BBT\n");
David Woodhousee0c7d762006-05-13 18:07:53 +01001107 kfree(this->bbt);
Artem B. Bityuckiyeeada242005-02-11 10:14:15 +00001108 this->bbt = NULL;
1109 }
1110 return res;
1111 }
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +02001112 verify_bbt_descr(mtd, td);
1113 verify_bbt_descr(mtd, md);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001114
1115 /* Allocate a temporary buffer for one eraseblock incl. oob */
1116 len = (1 << this->bbt_erase_shift);
1117 len += (len >> this->page_shift) * mtd->oobsize;
David Woodhousec3f8abf2006-05-13 04:03:42 +01001118 buf = vmalloc(len);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001119 if (!buf) {
David Woodhousee0c7d762006-05-13 18:07:53 +01001120 kfree(this->bbt);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001121 this->bbt = NULL;
1122 return -ENOMEM;
1123 }
Thomas Gleixner61b03bd2005-11-07 11:15:49 +00001124
Brian Norris8b6e50c2011-05-25 14:59:01 -07001125 /* Is the bbt at a given page? */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001126 if (td->options & NAND_BBT_ABSPAGE) {
Brian Norris7b5a2d42012-06-22 16:35:41 -07001127 read_abs_bbts(mtd, buf, td, md);
Thomas Gleixner61b03bd2005-11-07 11:15:49 +00001128 } else {
Linus Torvalds1da177e2005-04-16 15:20:36 -07001129 /* Search the bad block table using a pattern in oob */
Brian Norris7b5a2d42012-06-22 16:35:41 -07001130 search_read_bbts(mtd, buf, td, md);
Thomas Gleixner61b03bd2005-11-07 11:15:49 +00001131 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001132
Brian Norris7b5a2d42012-06-22 16:35:41 -07001133 res = check_create(mtd, buf, bd);
Thomas Gleixner61b03bd2005-11-07 11:15:49 +00001134
Linus Torvalds1da177e2005-04-16 15:20:36 -07001135 /* Prevent the bbt regions from erasing / writing */
David Woodhousee0c7d762006-05-13 18:07:53 +01001136 mark_bbt_region(mtd, td);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001137 if (md)
David Woodhousee0c7d762006-05-13 18:07:53 +01001138 mark_bbt_region(mtd, md);
Thomas Gleixner61b03bd2005-11-07 11:15:49 +00001139
David Woodhousee0c7d762006-05-13 18:07:53 +01001140 vfree(buf);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001141 return res;
1142}
1143
Linus Torvalds1da177e2005-04-16 15:20:36 -07001144/**
Brian Norrisb32843b2013-07-30 17:52:59 -07001145 * nand_update_bbt - update bad block table(s)
Brian Norris8b6e50c2011-05-25 14:59:01 -07001146 * @mtd: MTD device structure
1147 * @offs: the offset of the newly marked block
Linus Torvalds1da177e2005-04-16 15:20:36 -07001148 *
Brian Norris8b6e50c2011-05-25 14:59:01 -07001149 * The function updates the bad block table(s).
1150 */
Brian Norrisb32843b2013-07-30 17:52:59 -07001151static int nand_update_bbt(struct mtd_info *mtd, loff_t offs)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001152{
1153 struct nand_chip *this = mtd->priv;
Brian Norris1196ac52011-09-07 13:13:32 -07001154 int len, res = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001155 int chip, chipsel;
1156 uint8_t *buf;
1157 struct nand_bbt_descr *td = this->bbt_td;
1158 struct nand_bbt_descr *md = this->bbt_md;
1159
1160 if (!this->bbt || !td)
1161 return -EINVAL;
1162
Linus Torvalds1da177e2005-04-16 15:20:36 -07001163 /* Allocate a temporary buffer for one eraseblock incl. oob */
1164 len = (1 << this->bbt_erase_shift);
1165 len += (len >> this->page_shift) * mtd->oobsize;
David Woodhousee0c7d762006-05-13 18:07:53 +01001166 buf = kmalloc(len, GFP_KERNEL);
Brian Norris08700662011-06-07 16:01:54 -07001167 if (!buf)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001168 return -ENOMEM;
Thomas Gleixner61b03bd2005-11-07 11:15:49 +00001169
Brian Norris8b6e50c2011-05-25 14:59:01 -07001170 /* Do we have a bbt per chip? */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001171 if (td->options & NAND_BBT_PERCHIP) {
David Woodhousee0c7d762006-05-13 18:07:53 +01001172 chip = (int)(offs >> this->chip_shift);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001173 chipsel = chip;
1174 } else {
1175 chip = 0;
1176 chipsel = -1;
1177 }
1178
1179 td->version[chip]++;
1180 if (md)
Thomas Gleixner61b03bd2005-11-07 11:15:49 +00001181 md->version[chip]++;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001182
Brian Norris8b6e50c2011-05-25 14:59:01 -07001183 /* Write the bad block table to the device? */
Brian Norris1196ac52011-09-07 13:13:32 -07001184 if (td->options & NAND_BBT_WRITE) {
David Woodhousee0c7d762006-05-13 18:07:53 +01001185 res = write_bbt(mtd, buf, td, md, chipsel);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001186 if (res < 0)
1187 goto out;
1188 }
Brian Norris8b6e50c2011-05-25 14:59:01 -07001189 /* Write the mirror bad block table to the device? */
Brian Norris1196ac52011-09-07 13:13:32 -07001190 if (md && (md->options & NAND_BBT_WRITE)) {
David Woodhousee0c7d762006-05-13 18:07:53 +01001191 res = write_bbt(mtd, buf, md, td, chipsel);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001192 }
1193
David Woodhousee0c7d762006-05-13 18:07:53 +01001194 out:
1195 kfree(buf);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001196 return res;
1197}
1198
Brian Norris8b6e50c2011-05-25 14:59:01 -07001199/*
1200 * Define some generic bad / good block scan pattern which are used
1201 * while scanning a device for factory marked good / bad blocks.
1202 */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001203static uint8_t scan_ff_pattern[] = { 0xff, 0xff };
1204
Brian Norris7854d3f2011-06-23 14:12:08 -07001205/* Generic flash bbt descriptors */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001206static uint8_t bbt_pattern[] = {'B', 'b', 't', '0' };
1207static uint8_t mirror_pattern[] = {'1', 't', 'b', 'B' };
1208
1209static struct nand_bbt_descr bbt_main_descr = {
Thomas Gleixner61b03bd2005-11-07 11:15:49 +00001210 .options = NAND_BBT_LASTBLOCK | NAND_BBT_CREATE | NAND_BBT_WRITE
Linus Torvalds1da177e2005-04-16 15:20:36 -07001211 | NAND_BBT_2BIT | NAND_BBT_VERSION | NAND_BBT_PERCHIP,
1212 .offs = 8,
1213 .len = 4,
1214 .veroffs = 12,
Richard Genoud61de9da2012-09-11 15:50:54 +02001215 .maxblocks = NAND_BBT_SCAN_MAXBLOCKS,
Linus Torvalds1da177e2005-04-16 15:20:36 -07001216 .pattern = bbt_pattern
1217};
1218
1219static struct nand_bbt_descr bbt_mirror_descr = {
Thomas Gleixner61b03bd2005-11-07 11:15:49 +00001220 .options = NAND_BBT_LASTBLOCK | NAND_BBT_CREATE | NAND_BBT_WRITE
Linus Torvalds1da177e2005-04-16 15:20:36 -07001221 | NAND_BBT_2BIT | NAND_BBT_VERSION | NAND_BBT_PERCHIP,
1222 .offs = 8,
1223 .len = 4,
1224 .veroffs = 12,
Richard Genoud61de9da2012-09-11 15:50:54 +02001225 .maxblocks = NAND_BBT_SCAN_MAXBLOCKS,
Linus Torvalds1da177e2005-04-16 15:20:36 -07001226 .pattern = mirror_pattern
1227};
1228
Brian Norris9fd6b372012-06-22 16:35:40 -07001229static struct nand_bbt_descr bbt_main_no_oob_descr = {
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +02001230 .options = NAND_BBT_LASTBLOCK | NAND_BBT_CREATE | NAND_BBT_WRITE
1231 | NAND_BBT_2BIT | NAND_BBT_VERSION | NAND_BBT_PERCHIP
1232 | NAND_BBT_NO_OOB,
1233 .len = 4,
1234 .veroffs = 4,
Richard Genoud61de9da2012-09-11 15:50:54 +02001235 .maxblocks = NAND_BBT_SCAN_MAXBLOCKS,
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +02001236 .pattern = bbt_pattern
1237};
1238
Brian Norris9fd6b372012-06-22 16:35:40 -07001239static struct nand_bbt_descr bbt_mirror_no_oob_descr = {
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +02001240 .options = NAND_BBT_LASTBLOCK | NAND_BBT_CREATE | NAND_BBT_WRITE
1241 | NAND_BBT_2BIT | NAND_BBT_VERSION | NAND_BBT_PERCHIP
1242 | NAND_BBT_NO_OOB,
1243 .len = 4,
1244 .veroffs = 4,
Richard Genoud61de9da2012-09-11 15:50:54 +02001245 .maxblocks = NAND_BBT_SCAN_MAXBLOCKS,
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +02001246 .pattern = mirror_pattern
1247};
1248
Brian Norris752ed6c2011-09-20 18:36:42 -07001249#define BADBLOCK_SCAN_MASK (~NAND_BBT_NO_OOB)
Brian Norris58373ff2010-07-15 12:15:44 -07001250/**
Brian Norris752ed6c2011-09-20 18:36:42 -07001251 * nand_create_badblock_pattern - [INTERN] Creates a BBT descriptor structure
Brian Norris8b6e50c2011-05-25 14:59:01 -07001252 * @this: NAND chip to create descriptor for
Brian Norris58373ff2010-07-15 12:15:44 -07001253 *
1254 * This function allocates and initializes a nand_bbt_descr for BBM detection
Brian Norris752ed6c2011-09-20 18:36:42 -07001255 * based on the properties of @this. The new descriptor is stored in
Brian Norris58373ff2010-07-15 12:15:44 -07001256 * this->badblock_pattern. Thus, this->badblock_pattern should be NULL when
1257 * passed to this function.
Brian Norris58373ff2010-07-15 12:15:44 -07001258 */
Brian Norris752ed6c2011-09-20 18:36:42 -07001259static int nand_create_badblock_pattern(struct nand_chip *this)
Brian Norris58373ff2010-07-15 12:15:44 -07001260{
1261 struct nand_bbt_descr *bd;
1262 if (this->badblock_pattern) {
Brian Norris752ed6c2011-09-20 18:36:42 -07001263 pr_warn("Bad block pattern already allocated; not replacing\n");
Brian Norris58373ff2010-07-15 12:15:44 -07001264 return -EINVAL;
1265 }
1266 bd = kzalloc(sizeof(*bd), GFP_KERNEL);
Brian Norris08700662011-06-07 16:01:54 -07001267 if (!bd)
Brian Norris58373ff2010-07-15 12:15:44 -07001268 return -ENOMEM;
Brian Norris752ed6c2011-09-20 18:36:42 -07001269 bd->options = this->bbt_options & BADBLOCK_SCAN_MASK;
Brian Norris58373ff2010-07-15 12:15:44 -07001270 bd->offs = this->badblockpos;
1271 bd->len = (this->options & NAND_BUSWIDTH_16) ? 2 : 1;
1272 bd->pattern = scan_ff_pattern;
1273 bd->options |= NAND_BBT_DYNAMICSTRUCT;
1274 this->badblock_pattern = bd;
1275 return 0;
1276}
1277
Linus Torvalds1da177e2005-04-16 15:20:36 -07001278/**
Thomas Gleixner61b03bd2005-11-07 11:15:49 +00001279 * nand_default_bbt - [NAND Interface] Select a default bad block table for the device
Brian Norris8b6e50c2011-05-25 14:59:01 -07001280 * @mtd: MTD device structure
Linus Torvalds1da177e2005-04-16 15:20:36 -07001281 *
Brian Norris8b6e50c2011-05-25 14:59:01 -07001282 * This function selects the default bad block table support for the device and
1283 * calls the nand_scan_bbt function.
1284 */
David Woodhousee0c7d762006-05-13 18:07:53 +01001285int nand_default_bbt(struct mtd_info *mtd)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001286{
1287 struct nand_chip *this = mtd->priv;
Thomas Gleixner61b03bd2005-11-07 11:15:49 +00001288
Brian Norris8b6e50c2011-05-25 14:59:01 -07001289 /* Is a flash based bad block table requested? */
Brian Norrisbb9ebd42011-05-31 16:31:23 -07001290 if (this->bbt_options & NAND_BBT_USE_FLASH) {
Thomas Gleixner61b03bd2005-11-07 11:15:49 +00001291 /* Use the default pattern descriptors */
1292 if (!this->bbt_td) {
Brian Norrisa40f7342011-05-31 16:31:22 -07001293 if (this->bbt_options & NAND_BBT_NO_OOB) {
Brian Norris9fd6b372012-06-22 16:35:40 -07001294 this->bbt_td = &bbt_main_no_oob_descr;
1295 this->bbt_md = &bbt_mirror_no_oob_descr;
Sebastian Andrzej Siewior7cba7b12010-09-30 21:28:01 +02001296 } else {
1297 this->bbt_td = &bbt_main_descr;
1298 this->bbt_md = &bbt_mirror_descr;
1299 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001300 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001301 } else {
1302 this->bbt_td = NULL;
1303 this->bbt_md = NULL;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001304 }
Brian Norrisa2f812d2011-03-18 21:53:42 -07001305
1306 if (!this->badblock_pattern)
Brian Norris752ed6c2011-09-20 18:36:42 -07001307 nand_create_badblock_pattern(this);
Brian Norrisa2f812d2011-03-18 21:53:42 -07001308
David Woodhousee0c7d762006-05-13 18:07:53 +01001309 return nand_scan_bbt(mtd, this->badblock_pattern);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001310}
1311
1312/**
Thomas Gleixner61b03bd2005-11-07 11:15:49 +00001313 * nand_isbad_bbt - [NAND Interface] Check if a block is bad
Brian Norris8b6e50c2011-05-25 14:59:01 -07001314 * @mtd: MTD device structure
1315 * @offs: offset in the device
1316 * @allowbbt: allow access to bad block table region
1317 */
David Woodhousee0c7d762006-05-13 18:07:53 +01001318int nand_isbad_bbt(struct mtd_info *mtd, loff_t offs, int allowbbt)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001319{
1320 struct nand_chip *this = mtd->priv;
Brian Norris39dbb022013-07-30 17:52:57 -07001321 int block, res;
Thomas Gleixner61b03bd2005-11-07 11:15:49 +00001322
Brian Norrisb4d20d62013-07-30 17:52:56 -07001323 block = (int)(offs >> this->bbt_erase_shift);
1324 res = bbt_get_entry(this, block);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001325
Brian Norris289c0522011-07-19 10:06:09 -07001326 pr_debug("nand_isbad_bbt(): bbt info for offs 0x%08x: "
1327 "(block %d) 0x%02x\n",
Brian Norrisb4d20d62013-07-30 17:52:56 -07001328 (unsigned int)offs, block, res);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001329
Brian Norris39dbb022013-07-30 17:52:57 -07001330 switch (res) {
Brian Norris771c5682013-07-30 17:52:55 -07001331 case BBT_BLOCK_GOOD:
David Woodhousee0c7d762006-05-13 18:07:53 +01001332 return 0;
Brian Norris771c5682013-07-30 17:52:55 -07001333 case BBT_BLOCK_WORN:
David Woodhousee0c7d762006-05-13 18:07:53 +01001334 return 1;
Brian Norris771c5682013-07-30 17:52:55 -07001335 case BBT_BLOCK_RESERVED:
David Woodhousee0c7d762006-05-13 18:07:53 +01001336 return allowbbt ? 0 : 1;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001337 }
1338 return 1;
1339}
1340
Brian Norrisb32843b2013-07-30 17:52:59 -07001341/**
1342 * nand_markbad_bbt - [NAND Interface] Mark a block bad in the BBT
1343 * @mtd: MTD device structure
1344 * @offs: offset of the bad block
1345 */
1346int nand_markbad_bbt(struct mtd_info *mtd, loff_t offs)
1347{
1348 struct nand_chip *this = mtd->priv;
1349 int block, ret = 0;
1350
1351 block = (int)(offs >> this->bbt_erase_shift);
1352
1353 /* Mark bad block in memory */
1354 bbt_mark_entry(this, block, BBT_BLOCK_WORN);
1355
1356 /* Update flash-based bad block table */
1357 if (this->bbt_options & NAND_BBT_USE_FLASH)
1358 ret = nand_update_bbt(mtd, offs);
1359
1360 return ret;
1361}
1362
David Woodhousee0c7d762006-05-13 18:07:53 +01001363EXPORT_SYMBOL(nand_scan_bbt);