1 // SPDX-License-Identifier: GPL-2.0
6  *	Boris Brezillon <boris.brezillon@free-electrons.com>
16  * nanddev_isbad() - Check if a block is bad
35 			if (nand->ops->isbad(nand, pos))  in nanddev_isbad()
50 	return nand->ops->isbad(nand, pos);  in nanddev_isbad()
55  * nanddev_markbad() - Mark a block as bad
60  * calls the low-level markbad hook (nand->ops->markbad()).
73 	ret = nand->ops->markbad(nand, pos);  in nanddev_markbad()
90 		mtd->ecc_stats.badblocks++;  in nanddev_markbad()
97  * nanddev_isreserved() - Check whether an eraseblock is reserved or not
121  * nanddev_erase() - Erase a NAND portion
134 		return -EIO;  in nanddev_erase()
137 	return nand->ops->erase(nand, pos);  in nanddev_erase()
141  * nanddev_mtd_erase() - Generic mtd->_erase() implementation for NAND devices
145  * This is a simple mtd->_erase() implementation iterating over all blocks
146  * concerned by @einfo and calling nand->ops->erase() on each of them.
148  * Note that mtd->_erase should not be directly assigned to this helper,
161 	nanddev_offs_to_pos(nand, einfo->addr, &pos);  in nanddev_mtd_erase()
162 	nanddev_offs_to_pos(nand, einfo->addr + einfo->len - 1, &last);  in nanddev_mtd_erase()
166 			einfo->fail_addr = nanddev_pos_to_offs(nand, &pos);  in nanddev_mtd_erase()
179  * nanddev_mtd_max_bad_blocks() - Get the maximum number of bad eraseblock on
185  * Default implementation for mtd->_max_bad_blocks(). Only works if
186  * nand->memorg.max_bad_eraseblocks_per_lun is > 0.
197 	if (!nand->memorg.max_bad_eraseblocks_per_lun)  in nanddev_mtd_max_bad_blocks()
198 		return -ENOTSUPP;  in nanddev_mtd_max_bad_blocks()
206 		max_bb += nand->memorg.max_bad_eraseblocks_per_lun;  in nanddev_mtd_max_bad_blocks()
213  * nanddev_get_ecc_engine() - Find and get a suitable ECC engine
220 	/* Read the user desires in terms of ECC engine/configuration */  in nanddev_get_ecc_engine()
223 	engine_type = nand->ecc.user_conf.engine_type;  in nanddev_get_ecc_engine()
225 		engine_type = nand->ecc.defaults.engine_type;  in nanddev_get_ecc_engine()
231 		nand->ecc.engine = nand_ecc_get_sw_engine(nand);  in nanddev_get_ecc_engine()
234 		nand->ecc.engine = nand_ecc_get_on_die_hw_engine(nand);  in nanddev_get_ecc_engine()
237 		nand->ecc.engine = nand_ecc_get_on_host_hw_engine(nand);  in nanddev_get_ecc_engine()
238 		if (PTR_ERR(nand->ecc.engine) == -EPROBE_DEFER)  in nanddev_get_ecc_engine()
239 			return -EPROBE_DEFER;  in nanddev_get_ecc_engine()
242 		pr_err("Missing ECC engine type\n");  in nanddev_get_ecc_engine()
245 	if (!nand->ecc.engine)  in nanddev_get_ecc_engine()
246 		return  -EINVAL;  in nanddev_get_ecc_engine()
252  * nanddev_put_ecc_engine() - Dettach and put the in-use ECC engine
257 	switch (nand->ecc.ctx.conf.engine_type) {  in nanddev_put_ecc_engine()
272  * nanddev_find_ecc_configuration() - Find a suitable ECC configuration
279 	if (!nand->ecc.engine)  in nanddev_find_ecc_configuration()
280 		return -ENOTSUPP;  in nanddev_find_ecc_configuration()
287 …pr_warn("WARNING: %s: the ECC used on your system is too weak compared to the one required by the …  in nanddev_find_ecc_configuration()
288 			nand->mtd.name);  in nanddev_find_ecc_configuration()
294  * nanddev_ecc_engine_init() - Initialize an ECC engine for the chip
301 	/* Look for the ECC engine to use */  in nanddev_ecc_engine_init()
304 		if (ret != -EPROBE_DEFER)  in nanddev_ecc_engine_init()
305 			pr_err("No ECC engine found\n");  in nanddev_ecc_engine_init()
310 	/* No ECC engine requested */  in nanddev_ecc_engine_init()
311 	if (!nand->ecc.engine)  in nanddev_ecc_engine_init()
314 	/* Configure the engine: balance user input and chip requirements */  in nanddev_ecc_engine_init()
317 		pr_err("No suitable ECC configuration\n");  in nanddev_ecc_engine_init()
328  * nanddev_ecc_engine_cleanup() - Cleanup ECC engine initializations
333 	if (nand->ecc.engine)  in nanddev_ecc_engine_cleanup()
341  * nanddev_init() - Initialize a NAND device
347  * @nand->memorg. Also takes care of initializing the BBT.
358 		return -EINVAL;  in nanddev_init()
360 	if (!ops->erase || !ops->markbad || !ops->isbad)  in nanddev_init()
361 		return -EINVAL;  in nanddev_init()
363 	if (!memorg->bits_per_cell || !memorg->pagesize ||  in nanddev_init()
364 	    !memorg->pages_per_eraseblock || !memorg->eraseblocks_per_lun ||  in nanddev_init()
365 	    !memorg->planes_per_lun || !memorg->luns_per_target ||  in nanddev_init()
366 	    !memorg->ntargets)  in nanddev_init()
367 		return -EINVAL;  in nanddev_init()
369 	nand->rowconv.eraseblock_addr_shift =  in nanddev_init()
370 					fls(memorg->pages_per_eraseblock - 1);  in nanddev_init()
371 	nand->rowconv.lun_addr_shift = fls(memorg->eraseblocks_per_lun - 1) +  in nanddev_init()
372 				       nand->rowconv.eraseblock_addr_shift;  in nanddev_init()
374 	nand->ops = ops;  in nanddev_init()
376 	mtd->type = memorg->bits_per_cell == 1 ?  in nanddev_init()
378 	mtd->flags = MTD_CAP_NANDFLASH;  in nanddev_init()
379 	mtd->erasesize = memorg->pagesize * memorg->pages_per_eraseblock;  in nanddev_init()
380 	mtd->writesize = memorg->pagesize;  in nanddev_init()
381 	mtd->writebufsize = memorg->pagesize;  in nanddev_init()
382 	mtd->oobsize = memorg->oobsize;  in nanddev_init()
383 	mtd->size = nanddev_size(nand);  in nanddev_init()
384 	mtd->owner = owner;  in nanddev_init()
391  * nanddev_cleanup() - Release resources allocated in nanddev_init()
404 MODULE_AUTHOR("Boris Brezillon <boris.brezillon@free-electrons.com>");