1 // SPDX-License-Identifier: GPL-2.0
2 /*
3 * Copyright (C) 2016-2017 Micron Technology, Inc.
4 *
5 * Authors:
6 * Peter Pan <peterpandong@micron.com>
7 * Boris Brezillon <boris.brezillon@bootlin.com>
8 */
9
10 #define pr_fmt(fmt) "spi-nand: " fmt
11
12 #include <linux/device.h>
13 #include <linux/jiffies.h>
14 #include <linux/kernel.h>
15 #include <linux/module.h>
16 #include <linux/mtd/spinand.h>
17 #include <linux/of.h>
18 #include <linux/slab.h>
19 #include <linux/spi/spi.h>
20 #include <linux/spi/spi-mem.h>
21
spinand_read_reg_op(struct spinand_device * spinand,u8 reg,u8 * val)22 static int spinand_read_reg_op(struct spinand_device *spinand, u8 reg, u8 *val)
23 {
24 struct spi_mem_op op = SPINAND_GET_FEATURE_OP(reg,
25 spinand->scratchbuf);
26 int ret;
27
28 ret = spi_mem_exec_op(spinand->spimem, &op);
29 if (ret)
30 return ret;
31
32 *val = *spinand->scratchbuf;
33 return 0;
34 }
35
spinand_write_reg_op(struct spinand_device * spinand,u8 reg,u8 val)36 static int spinand_write_reg_op(struct spinand_device *spinand, u8 reg, u8 val)
37 {
38 struct spi_mem_op op = SPINAND_SET_FEATURE_OP(reg,
39 spinand->scratchbuf);
40
41 *spinand->scratchbuf = val;
42 return spi_mem_exec_op(spinand->spimem, &op);
43 }
44
spinand_read_status(struct spinand_device * spinand,u8 * status)45 static int spinand_read_status(struct spinand_device *spinand, u8 *status)
46 {
47 return spinand_read_reg_op(spinand, REG_STATUS, status);
48 }
49
spinand_get_cfg(struct spinand_device * spinand,u8 * cfg)50 static int spinand_get_cfg(struct spinand_device *spinand, u8 *cfg)
51 {
52 struct nand_device *nand = spinand_to_nand(spinand);
53
54 if (WARN_ON(spinand->cur_target < 0 ||
55 spinand->cur_target >= nand->memorg.ntargets))
56 return -EINVAL;
57
58 *cfg = spinand->cfg_cache[spinand->cur_target];
59 return 0;
60 }
61
spinand_set_cfg(struct spinand_device * spinand,u8 cfg)62 static int spinand_set_cfg(struct spinand_device *spinand, u8 cfg)
63 {
64 struct nand_device *nand = spinand_to_nand(spinand);
65 int ret;
66
67 if (WARN_ON(spinand->cur_target < 0 ||
68 spinand->cur_target >= nand->memorg.ntargets))
69 return -EINVAL;
70
71 if (spinand->cfg_cache[spinand->cur_target] == cfg)
72 return 0;
73
74 ret = spinand_write_reg_op(spinand, REG_CFG, cfg);
75 if (ret)
76 return ret;
77
78 spinand->cfg_cache[spinand->cur_target] = cfg;
79 return 0;
80 }
81
82 /**
83 * spinand_upd_cfg() - Update the configuration register
84 * @spinand: the spinand device
85 * @mask: the mask encoding the bits to update in the config reg
86 * @val: the new value to apply
87 *
88 * Update the configuration register.
89 *
90 * Return: 0 on success, a negative error code otherwise.
91 */
spinand_upd_cfg(struct spinand_device * spinand,u8 mask,u8 val)92 int spinand_upd_cfg(struct spinand_device *spinand, u8 mask, u8 val)
93 {
94 int ret;
95 u8 cfg;
96
97 ret = spinand_get_cfg(spinand, &cfg);
98 if (ret)
99 return ret;
100
101 cfg &= ~mask;
102 cfg |= val;
103
104 return spinand_set_cfg(spinand, cfg);
105 }
106
107 /**
108 * spinand_select_target() - Select a specific NAND target/die
109 * @spinand: the spinand device
110 * @target: the target/die to select
111 *
112 * Select a new target/die. If chip only has one die, this function is a NOOP.
113 *
114 * Return: 0 on success, a negative error code otherwise.
115 */
spinand_select_target(struct spinand_device * spinand,unsigned int target)116 int spinand_select_target(struct spinand_device *spinand, unsigned int target)
117 {
118 struct nand_device *nand = spinand_to_nand(spinand);
119 int ret;
120
121 if (WARN_ON(target >= nand->memorg.ntargets))
122 return -EINVAL;
123
124 if (spinand->cur_target == target)
125 return 0;
126
127 if (nand->memorg.ntargets == 1) {
128 spinand->cur_target = target;
129 return 0;
130 }
131
132 ret = spinand->select_target(spinand, target);
133 if (ret)
134 return ret;
135
136 spinand->cur_target = target;
137 return 0;
138 }
139
spinand_init_cfg_cache(struct spinand_device * spinand)140 static int spinand_init_cfg_cache(struct spinand_device *spinand)
141 {
142 struct nand_device *nand = spinand_to_nand(spinand);
143 struct device *dev = &spinand->spimem->spi->dev;
144 unsigned int target;
145 int ret;
146
147 spinand->cfg_cache = devm_kcalloc(dev,
148 nand->memorg.ntargets,
149 sizeof(*spinand->cfg_cache),
150 GFP_KERNEL);
151 if (!spinand->cfg_cache)
152 return -ENOMEM;
153
154 for (target = 0; target < nand->memorg.ntargets; target++) {
155 ret = spinand_select_target(spinand, target);
156 if (ret)
157 return ret;
158
159 /*
160 * We use spinand_read_reg_op() instead of spinand_get_cfg()
161 * here to bypass the config cache.
162 */
163 ret = spinand_read_reg_op(spinand, REG_CFG,
164 &spinand->cfg_cache[target]);
165 if (ret)
166 return ret;
167 }
168
169 return 0;
170 }
171
spinand_init_quad_enable(struct spinand_device * spinand)172 static int spinand_init_quad_enable(struct spinand_device *spinand)
173 {
174 bool enable = false;
175
176 if (!(spinand->flags & SPINAND_HAS_QE_BIT))
177 return 0;
178
179 if (spinand->op_templates.read_cache->data.buswidth == 4 ||
180 spinand->op_templates.write_cache->data.buswidth == 4 ||
181 spinand->op_templates.update_cache->data.buswidth == 4)
182 enable = true;
183
184 return spinand_upd_cfg(spinand, CFG_QUAD_ENABLE,
185 enable ? CFG_QUAD_ENABLE : 0);
186 }
187
spinand_ecc_enable(struct spinand_device * spinand,bool enable)188 static int spinand_ecc_enable(struct spinand_device *spinand,
189 bool enable)
190 {
191 return spinand_upd_cfg(spinand, CFG_ECC_ENABLE,
192 enable ? CFG_ECC_ENABLE : 0);
193 }
194
spinand_write_enable_op(struct spinand_device * spinand)195 static int spinand_write_enable_op(struct spinand_device *spinand)
196 {
197 struct spi_mem_op op = SPINAND_WR_EN_DIS_OP(true);
198
199 return spi_mem_exec_op(spinand->spimem, &op);
200 }
201
spinand_load_page_op(struct spinand_device * spinand,const struct nand_page_io_req * req)202 static int spinand_load_page_op(struct spinand_device *spinand,
203 const struct nand_page_io_req *req)
204 {
205 struct nand_device *nand = spinand_to_nand(spinand);
206 unsigned int row = nanddev_pos_to_row(nand, &req->pos);
207 struct spi_mem_op op = SPINAND_PAGE_READ_OP(row);
208
209 return spi_mem_exec_op(spinand->spimem, &op);
210 }
211
spinand_read_from_cache_op(struct spinand_device * spinand,const struct nand_page_io_req * req)212 static int spinand_read_from_cache_op(struct spinand_device *spinand,
213 const struct nand_page_io_req *req)
214 {
215 struct nand_device *nand = spinand_to_nand(spinand);
216 struct mtd_info *mtd = nanddev_to_mtd(nand);
217 struct spi_mem_dirmap_desc *rdesc;
218 unsigned int nbytes = 0;
219 void *buf = NULL;
220 u16 column = 0;
221 ssize_t ret;
222
223 if (req->datalen) {
224 buf = spinand->databuf;
225 nbytes = nanddev_page_size(nand);
226 column = 0;
227 }
228
229 if (req->ooblen) {
230 nbytes += nanddev_per_page_oobsize(nand);
231 if (!buf) {
232 buf = spinand->oobbuf;
233 column = nanddev_page_size(nand);
234 }
235 }
236
237 rdesc = spinand->dirmaps[req->pos.plane].rdesc;
238
239 while (nbytes) {
240 ret = spi_mem_dirmap_read(rdesc, column, nbytes, buf);
241 if (ret < 0)
242 return ret;
243
244 if (!ret || ret > nbytes)
245 return -EIO;
246
247 nbytes -= ret;
248 column += ret;
249 buf += ret;
250 }
251
252 if (req->datalen)
253 memcpy(req->databuf.in, spinand->databuf + req->dataoffs,
254 req->datalen);
255
256 if (req->ooblen) {
257 if (req->mode == MTD_OPS_AUTO_OOB)
258 mtd_ooblayout_get_databytes(mtd, req->oobbuf.in,
259 spinand->oobbuf,
260 req->ooboffs,
261 req->ooblen);
262 else
263 memcpy(req->oobbuf.in, spinand->oobbuf + req->ooboffs,
264 req->ooblen);
265 }
266
267 return 0;
268 }
269
spinand_write_to_cache_op(struct spinand_device * spinand,const struct nand_page_io_req * req)270 static int spinand_write_to_cache_op(struct spinand_device *spinand,
271 const struct nand_page_io_req *req)
272 {
273 struct nand_device *nand = spinand_to_nand(spinand);
274 struct mtd_info *mtd = nanddev_to_mtd(nand);
275 struct spi_mem_dirmap_desc *wdesc;
276 unsigned int nbytes, column = 0;
277 void *buf = spinand->databuf;
278 ssize_t ret;
279
280 /*
281 * Looks like PROGRAM LOAD (AKA write cache) does not necessarily reset
282 * the cache content to 0xFF (depends on vendor implementation), so we
283 * must fill the page cache entirely even if we only want to program
284 * the data portion of the page, otherwise we might corrupt the BBM or
285 * user data previously programmed in OOB area.
286 */
287 nbytes = nanddev_page_size(nand) + nanddev_per_page_oobsize(nand);
288 memset(spinand->databuf, 0xff, nbytes);
289
290 if (req->datalen)
291 memcpy(spinand->databuf + req->dataoffs, req->databuf.out,
292 req->datalen);
293
294 if (req->ooblen) {
295 if (req->mode == MTD_OPS_AUTO_OOB)
296 mtd_ooblayout_set_databytes(mtd, req->oobbuf.out,
297 spinand->oobbuf,
298 req->ooboffs,
299 req->ooblen);
300 else
301 memcpy(spinand->oobbuf + req->ooboffs, req->oobbuf.out,
302 req->ooblen);
303 }
304
305 wdesc = spinand->dirmaps[req->pos.plane].wdesc;
306
307 while (nbytes) {
308 ret = spi_mem_dirmap_write(wdesc, column, nbytes, buf);
309 if (ret < 0)
310 return ret;
311
312 if (!ret || ret > nbytes)
313 return -EIO;
314
315 nbytes -= ret;
316 column += ret;
317 buf += ret;
318 }
319
320 return 0;
321 }
322
spinand_program_op(struct spinand_device * spinand,const struct nand_page_io_req * req)323 static int spinand_program_op(struct spinand_device *spinand,
324 const struct nand_page_io_req *req)
325 {
326 struct nand_device *nand = spinand_to_nand(spinand);
327 unsigned int row = nanddev_pos_to_row(nand, &req->pos);
328 struct spi_mem_op op = SPINAND_PROG_EXEC_OP(row);
329
330 return spi_mem_exec_op(spinand->spimem, &op);
331 }
332
spinand_erase_op(struct spinand_device * spinand,const struct nand_pos * pos)333 static int spinand_erase_op(struct spinand_device *spinand,
334 const struct nand_pos *pos)
335 {
336 struct nand_device *nand = spinand_to_nand(spinand);
337 unsigned int row = nanddev_pos_to_row(nand, pos);
338 struct spi_mem_op op = SPINAND_BLK_ERASE_OP(row);
339
340 return spi_mem_exec_op(spinand->spimem, &op);
341 }
342
spinand_wait(struct spinand_device * spinand,u8 * s)343 static int spinand_wait(struct spinand_device *spinand, u8 *s)
344 {
345 unsigned long timeo = jiffies + msecs_to_jiffies(400);
346 u8 status;
347 int ret;
348
349 do {
350 ret = spinand_read_status(spinand, &status);
351 if (ret)
352 return ret;
353
354 if (!(status & STATUS_BUSY))
355 goto out;
356 } while (time_before(jiffies, timeo));
357
358 /*
359 * Extra read, just in case the STATUS_READY bit has changed
360 * since our last check
361 */
362 ret = spinand_read_status(spinand, &status);
363 if (ret)
364 return ret;
365
366 out:
367 if (s)
368 *s = status;
369
370 return status & STATUS_BUSY ? -ETIMEDOUT : 0;
371 }
372
spinand_read_id_op(struct spinand_device * spinand,u8 * buf)373 static int spinand_read_id_op(struct spinand_device *spinand, u8 *buf)
374 {
375 struct spi_mem_op op = SPINAND_READID_OP(0, spinand->scratchbuf,
376 SPINAND_MAX_ID_LEN);
377 int ret;
378
379 ret = spi_mem_exec_op(spinand->spimem, &op);
380 if (!ret)
381 memcpy(buf, spinand->scratchbuf, SPINAND_MAX_ID_LEN);
382
383 return ret;
384 }
385
spinand_reset_op(struct spinand_device * spinand)386 static int spinand_reset_op(struct spinand_device *spinand)
387 {
388 struct spi_mem_op op = SPINAND_RESET_OP;
389 int ret;
390
391 ret = spi_mem_exec_op(spinand->spimem, &op);
392 if (ret)
393 return ret;
394
395 return spinand_wait(spinand, NULL);
396 }
397
spinand_lock_block(struct spinand_device * spinand,u8 lock)398 static int spinand_lock_block(struct spinand_device *spinand, u8 lock)
399 {
400 return spinand_write_reg_op(spinand, REG_BLOCK_LOCK, lock);
401 }
402
spinand_check_ecc_status(struct spinand_device * spinand,u8 status)403 static int spinand_check_ecc_status(struct spinand_device *spinand, u8 status)
404 {
405 struct nand_device *nand = spinand_to_nand(spinand);
406
407 if (spinand->eccinfo.get_status)
408 return spinand->eccinfo.get_status(spinand, status);
409
410 switch (status & STATUS_ECC_MASK) {
411 case STATUS_ECC_NO_BITFLIPS:
412 return 0;
413
414 case STATUS_ECC_HAS_BITFLIPS:
415 /*
416 * We have no way to know exactly how many bitflips have been
417 * fixed, so let's return the maximum possible value so that
418 * wear-leveling layers move the data immediately.
419 */
420 return nand->eccreq.strength;
421
422 case STATUS_ECC_UNCOR_ERROR:
423 return -EBADMSG;
424
425 default:
426 break;
427 }
428
429 return -EINVAL;
430 }
431
spinand_read_page(struct spinand_device * spinand,const struct nand_page_io_req * req,bool ecc_enabled)432 static int spinand_read_page(struct spinand_device *spinand,
433 const struct nand_page_io_req *req,
434 bool ecc_enabled)
435 {
436 u8 status;
437 int ret;
438
439 ret = spinand_load_page_op(spinand, req);
440 if (ret)
441 return ret;
442
443 ret = spinand_wait(spinand, &status);
444 if (ret < 0)
445 return ret;
446
447 ret = spinand_read_from_cache_op(spinand, req);
448 if (ret)
449 return ret;
450
451 if (!ecc_enabled)
452 return 0;
453
454 return spinand_check_ecc_status(spinand, status);
455 }
456
spinand_write_page(struct spinand_device * spinand,const struct nand_page_io_req * req)457 static int spinand_write_page(struct spinand_device *spinand,
458 const struct nand_page_io_req *req)
459 {
460 u8 status;
461 int ret;
462
463 ret = spinand_write_enable_op(spinand);
464 if (ret)
465 return ret;
466
467 ret = spinand_write_to_cache_op(spinand, req);
468 if (ret)
469 return ret;
470
471 ret = spinand_program_op(spinand, req);
472 if (ret)
473 return ret;
474
475 ret = spinand_wait(spinand, &status);
476 if (!ret && (status & STATUS_PROG_FAILED))
477 ret = -EIO;
478
479 return ret;
480 }
481
spinand_mtd_read(struct mtd_info * mtd,loff_t from,struct mtd_oob_ops * ops)482 static int spinand_mtd_read(struct mtd_info *mtd, loff_t from,
483 struct mtd_oob_ops *ops)
484 {
485 struct spinand_device *spinand = mtd_to_spinand(mtd);
486 struct nand_device *nand = mtd_to_nanddev(mtd);
487 unsigned int max_bitflips = 0;
488 struct nand_io_iter iter;
489 bool enable_ecc = false;
490 bool ecc_failed = false;
491 int ret = 0;
492
493 if (ops->mode != MTD_OPS_RAW && spinand->eccinfo.ooblayout)
494 enable_ecc = true;
495
496 mutex_lock(&spinand->lock);
497
498 nanddev_io_for_each_page(nand, from, ops, &iter) {
499 ret = spinand_select_target(spinand, iter.req.pos.target);
500 if (ret)
501 break;
502
503 ret = spinand_ecc_enable(spinand, enable_ecc);
504 if (ret)
505 break;
506
507 ret = spinand_read_page(spinand, &iter.req, enable_ecc);
508 if (ret < 0 && ret != -EBADMSG)
509 break;
510
511 if (ret == -EBADMSG) {
512 ecc_failed = true;
513 mtd->ecc_stats.failed++;
514 } else {
515 mtd->ecc_stats.corrected += ret;
516 max_bitflips = max_t(unsigned int, max_bitflips, ret);
517 }
518
519 ret = 0;
520 ops->retlen += iter.req.datalen;
521 ops->oobretlen += iter.req.ooblen;
522 }
523
524 mutex_unlock(&spinand->lock);
525
526 if (ecc_failed && !ret)
527 ret = -EBADMSG;
528
529 return ret ? ret : max_bitflips;
530 }
531
spinand_mtd_write(struct mtd_info * mtd,loff_t to,struct mtd_oob_ops * ops)532 static int spinand_mtd_write(struct mtd_info *mtd, loff_t to,
533 struct mtd_oob_ops *ops)
534 {
535 struct spinand_device *spinand = mtd_to_spinand(mtd);
536 struct nand_device *nand = mtd_to_nanddev(mtd);
537 struct nand_io_iter iter;
538 bool enable_ecc = false;
539 int ret = 0;
540
541 if (ops->mode != MTD_OPS_RAW && mtd->ooblayout)
542 enable_ecc = true;
543
544 mutex_lock(&spinand->lock);
545
546 nanddev_io_for_each_page(nand, to, ops, &iter) {
547 ret = spinand_select_target(spinand, iter.req.pos.target);
548 if (ret)
549 break;
550
551 ret = spinand_ecc_enable(spinand, enable_ecc);
552 if (ret)
553 break;
554
555 ret = spinand_write_page(spinand, &iter.req);
556 if (ret)
557 break;
558
559 ops->retlen += iter.req.datalen;
560 ops->oobretlen += iter.req.ooblen;
561 }
562
563 mutex_unlock(&spinand->lock);
564
565 return ret;
566 }
567
spinand_isbad(struct nand_device * nand,const struct nand_pos * pos)568 static bool spinand_isbad(struct nand_device *nand, const struct nand_pos *pos)
569 {
570 struct spinand_device *spinand = nand_to_spinand(nand);
571 struct nand_page_io_req req = {
572 .pos = *pos,
573 .ooblen = 2,
574 .ooboffs = 0,
575 .oobbuf.in = spinand->oobbuf,
576 .mode = MTD_OPS_RAW,
577 };
578
579 memset(spinand->oobbuf, 0, 2);
580 spinand_select_target(spinand, pos->target);
581 spinand_read_page(spinand, &req, false);
582 if (spinand->oobbuf[0] != 0xff || spinand->oobbuf[1] != 0xff)
583 return true;
584
585 return false;
586 }
587
spinand_mtd_block_isbad(struct mtd_info * mtd,loff_t offs)588 static int spinand_mtd_block_isbad(struct mtd_info *mtd, loff_t offs)
589 {
590 struct nand_device *nand = mtd_to_nanddev(mtd);
591 struct spinand_device *spinand = nand_to_spinand(nand);
592 struct nand_pos pos;
593 int ret;
594
595 nanddev_offs_to_pos(nand, offs, &pos);
596 mutex_lock(&spinand->lock);
597 ret = nanddev_isbad(nand, &pos);
598 mutex_unlock(&spinand->lock);
599
600 return ret;
601 }
602
spinand_markbad(struct nand_device * nand,const struct nand_pos * pos)603 static int spinand_markbad(struct nand_device *nand, const struct nand_pos *pos)
604 {
605 struct spinand_device *spinand = nand_to_spinand(nand);
606 struct nand_page_io_req req = {
607 .pos = *pos,
608 .ooboffs = 0,
609 .ooblen = 2,
610 .oobbuf.out = spinand->oobbuf,
611 };
612 int ret;
613
614 /* Erase block before marking it bad. */
615 ret = spinand_select_target(spinand, pos->target);
616 if (ret)
617 return ret;
618
619 ret = spinand_write_enable_op(spinand);
620 if (ret)
621 return ret;
622
623 spinand_erase_op(spinand, pos);
624
625 memset(spinand->oobbuf, 0, 2);
626 return spinand_write_page(spinand, &req);
627 }
628
spinand_mtd_block_markbad(struct mtd_info * mtd,loff_t offs)629 static int spinand_mtd_block_markbad(struct mtd_info *mtd, loff_t offs)
630 {
631 struct nand_device *nand = mtd_to_nanddev(mtd);
632 struct spinand_device *spinand = nand_to_spinand(nand);
633 struct nand_pos pos;
634 int ret;
635
636 nanddev_offs_to_pos(nand, offs, &pos);
637 mutex_lock(&spinand->lock);
638 ret = nanddev_markbad(nand, &pos);
639 mutex_unlock(&spinand->lock);
640
641 return ret;
642 }
643
spinand_erase(struct nand_device * nand,const struct nand_pos * pos)644 static int spinand_erase(struct nand_device *nand, const struct nand_pos *pos)
645 {
646 struct spinand_device *spinand = nand_to_spinand(nand);
647 u8 status;
648 int ret;
649
650 ret = spinand_select_target(spinand, pos->target);
651 if (ret)
652 return ret;
653
654 ret = spinand_write_enable_op(spinand);
655 if (ret)
656 return ret;
657
658 ret = spinand_erase_op(spinand, pos);
659 if (ret)
660 return ret;
661
662 ret = spinand_wait(spinand, &status);
663 if (!ret && (status & STATUS_ERASE_FAILED))
664 ret = -EIO;
665
666 return ret;
667 }
668
spinand_mtd_erase(struct mtd_info * mtd,struct erase_info * einfo)669 static int spinand_mtd_erase(struct mtd_info *mtd,
670 struct erase_info *einfo)
671 {
672 struct spinand_device *spinand = mtd_to_spinand(mtd);
673 int ret;
674
675 mutex_lock(&spinand->lock);
676 ret = nanddev_mtd_erase(mtd, einfo);
677 mutex_unlock(&spinand->lock);
678
679 return ret;
680 }
681
spinand_mtd_block_isreserved(struct mtd_info * mtd,loff_t offs)682 static int spinand_mtd_block_isreserved(struct mtd_info *mtd, loff_t offs)
683 {
684 struct spinand_device *spinand = mtd_to_spinand(mtd);
685 struct nand_device *nand = mtd_to_nanddev(mtd);
686 struct nand_pos pos;
687 int ret;
688
689 nanddev_offs_to_pos(nand, offs, &pos);
690 mutex_lock(&spinand->lock);
691 ret = nanddev_isreserved(nand, &pos);
692 mutex_unlock(&spinand->lock);
693
694 return ret;
695 }
696
spinand_create_dirmap(struct spinand_device * spinand,unsigned int plane)697 static int spinand_create_dirmap(struct spinand_device *spinand,
698 unsigned int plane)
699 {
700 struct nand_device *nand = spinand_to_nand(spinand);
701 struct spi_mem_dirmap_info info = {
702 .length = nanddev_page_size(nand) +
703 nanddev_per_page_oobsize(nand),
704 };
705 struct spi_mem_dirmap_desc *desc;
706
707 /* The plane number is passed in MSB just above the column address */
708 info.offset = plane << fls(nand->memorg.pagesize);
709
710 info.op_tmpl = *spinand->op_templates.update_cache;
711 desc = devm_spi_mem_dirmap_create(&spinand->spimem->spi->dev,
712 spinand->spimem, &info);
713 if (IS_ERR(desc))
714 return PTR_ERR(desc);
715
716 spinand->dirmaps[plane].wdesc = desc;
717
718 info.op_tmpl = *spinand->op_templates.read_cache;
719 desc = devm_spi_mem_dirmap_create(&spinand->spimem->spi->dev,
720 spinand->spimem, &info);
721 if (IS_ERR(desc))
722 return PTR_ERR(desc);
723
724 spinand->dirmaps[plane].rdesc = desc;
725
726 return 0;
727 }
728
spinand_create_dirmaps(struct spinand_device * spinand)729 static int spinand_create_dirmaps(struct spinand_device *spinand)
730 {
731 struct nand_device *nand = spinand_to_nand(spinand);
732 int i, ret;
733
734 spinand->dirmaps = devm_kzalloc(&spinand->spimem->spi->dev,
735 sizeof(*spinand->dirmaps) *
736 nand->memorg.planes_per_lun,
737 GFP_KERNEL);
738 if (!spinand->dirmaps)
739 return -ENOMEM;
740
741 for (i = 0; i < nand->memorg.planes_per_lun; i++) {
742 ret = spinand_create_dirmap(spinand, i);
743 if (ret)
744 return ret;
745 }
746
747 return 0;
748 }
749
750 static const struct nand_ops spinand_ops = {
751 .erase = spinand_erase,
752 .markbad = spinand_markbad,
753 .isbad = spinand_isbad,
754 };
755
756 static const struct spinand_manufacturer *spinand_manufacturers[] = {
757 &gigadevice_spinand_manufacturer,
758 ¯onix_spinand_manufacturer,
759 µn_spinand_manufacturer,
760 ¶gon_spinand_manufacturer,
761 &toshiba_spinand_manufacturer,
762 &winbond_spinand_manufacturer,
763 };
764
spinand_manufacturer_detect(struct spinand_device * spinand)765 static int spinand_manufacturer_detect(struct spinand_device *spinand)
766 {
767 unsigned int i;
768 int ret;
769
770 for (i = 0; i < ARRAY_SIZE(spinand_manufacturers); i++) {
771 ret = spinand_manufacturers[i]->ops->detect(spinand);
772 if (ret > 0) {
773 spinand->manufacturer = spinand_manufacturers[i];
774 return 0;
775 } else if (ret < 0) {
776 return ret;
777 }
778 }
779
780 return -ENOTSUPP;
781 }
782
spinand_manufacturer_init(struct spinand_device * spinand)783 static int spinand_manufacturer_init(struct spinand_device *spinand)
784 {
785 if (spinand->manufacturer->ops->init)
786 return spinand->manufacturer->ops->init(spinand);
787
788 return 0;
789 }
790
spinand_manufacturer_cleanup(struct spinand_device * spinand)791 static void spinand_manufacturer_cleanup(struct spinand_device *spinand)
792 {
793 /* Release manufacturer private data */
794 if (spinand->manufacturer->ops->cleanup)
795 return spinand->manufacturer->ops->cleanup(spinand);
796 }
797
798 static const struct spi_mem_op *
spinand_select_op_variant(struct spinand_device * spinand,const struct spinand_op_variants * variants)799 spinand_select_op_variant(struct spinand_device *spinand,
800 const struct spinand_op_variants *variants)
801 {
802 struct nand_device *nand = spinand_to_nand(spinand);
803 unsigned int i;
804
805 for (i = 0; i < variants->nops; i++) {
806 struct spi_mem_op op = variants->ops[i];
807 unsigned int nbytes;
808 int ret;
809
810 nbytes = nanddev_per_page_oobsize(nand) +
811 nanddev_page_size(nand);
812
813 while (nbytes) {
814 op.data.nbytes = nbytes;
815 ret = spi_mem_adjust_op_size(spinand->spimem, &op);
816 if (ret)
817 break;
818
819 if (!spi_mem_supports_op(spinand->spimem, &op))
820 break;
821
822 nbytes -= op.data.nbytes;
823 }
824
825 if (!nbytes)
826 return &variants->ops[i];
827 }
828
829 return NULL;
830 }
831
832 /**
833 * spinand_match_and_init() - Try to find a match between a device ID and an
834 * entry in a spinand_info table
835 * @spinand: SPI NAND object
836 * @table: SPI NAND device description table
837 * @table_size: size of the device description table
838 *
839 * Should be used by SPI NAND manufacturer drivers when they want to find a
840 * match between a device ID retrieved through the READ_ID command and an
841 * entry in the SPI NAND description table. If a match is found, the spinand
842 * object will be initialized with information provided by the matching
843 * spinand_info entry.
844 *
845 * Return: 0 on success, a negative error code otherwise.
846 */
spinand_match_and_init(struct spinand_device * spinand,const struct spinand_info * table,unsigned int table_size,u16 devid)847 int spinand_match_and_init(struct spinand_device *spinand,
848 const struct spinand_info *table,
849 unsigned int table_size, u16 devid)
850 {
851 struct nand_device *nand = spinand_to_nand(spinand);
852 unsigned int i;
853
854 for (i = 0; i < table_size; i++) {
855 const struct spinand_info *info = &table[i];
856 const struct spi_mem_op *op;
857
858 if (devid != info->devid)
859 continue;
860
861 nand->memorg = table[i].memorg;
862 nand->eccreq = table[i].eccreq;
863 spinand->eccinfo = table[i].eccinfo;
864 spinand->flags = table[i].flags;
865 spinand->select_target = table[i].select_target;
866
867 op = spinand_select_op_variant(spinand,
868 info->op_variants.read_cache);
869 if (!op)
870 return -ENOTSUPP;
871
872 spinand->op_templates.read_cache = op;
873
874 op = spinand_select_op_variant(spinand,
875 info->op_variants.write_cache);
876 if (!op)
877 return -ENOTSUPP;
878
879 spinand->op_templates.write_cache = op;
880
881 op = spinand_select_op_variant(spinand,
882 info->op_variants.update_cache);
883 spinand->op_templates.update_cache = op;
884
885 return 0;
886 }
887
888 return -ENOTSUPP;
889 }
890
spinand_detect(struct spinand_device * spinand)891 static int spinand_detect(struct spinand_device *spinand)
892 {
893 struct device *dev = &spinand->spimem->spi->dev;
894 struct nand_device *nand = spinand_to_nand(spinand);
895 int ret;
896
897 ret = spinand_reset_op(spinand);
898 if (ret)
899 return ret;
900
901 ret = spinand_read_id_op(spinand, spinand->id.data);
902 if (ret)
903 return ret;
904
905 spinand->id.len = SPINAND_MAX_ID_LEN;
906
907 ret = spinand_manufacturer_detect(spinand);
908 if (ret) {
909 dev_err(dev, "unknown raw ID %*phN\n", SPINAND_MAX_ID_LEN,
910 spinand->id.data);
911 return ret;
912 }
913
914 if (nand->memorg.ntargets > 1 && !spinand->select_target) {
915 dev_err(dev,
916 "SPI NANDs with more than one die must implement ->select_target()\n");
917 return -EINVAL;
918 }
919
920 dev_info(&spinand->spimem->spi->dev,
921 "%s SPI NAND was found.\n", spinand->manufacturer->name);
922 dev_info(&spinand->spimem->spi->dev,
923 "%llu MiB, block size: %zu KiB, page size: %zu, OOB size: %u\n",
924 nanddev_size(nand) >> 20, nanddev_eraseblock_size(nand) >> 10,
925 nanddev_page_size(nand), nanddev_per_page_oobsize(nand));
926
927 return 0;
928 }
929
spinand_noecc_ooblayout_ecc(struct mtd_info * mtd,int section,struct mtd_oob_region * region)930 static int spinand_noecc_ooblayout_ecc(struct mtd_info *mtd, int section,
931 struct mtd_oob_region *region)
932 {
933 return -ERANGE;
934 }
935
spinand_noecc_ooblayout_free(struct mtd_info * mtd,int section,struct mtd_oob_region * region)936 static int spinand_noecc_ooblayout_free(struct mtd_info *mtd, int section,
937 struct mtd_oob_region *region)
938 {
939 if (section)
940 return -ERANGE;
941
942 /* Reserve 2 bytes for the BBM. */
943 region->offset = 2;
944 region->length = 62;
945
946 return 0;
947 }
948
949 static const struct mtd_ooblayout_ops spinand_noecc_ooblayout = {
950 .ecc = spinand_noecc_ooblayout_ecc,
951 .free = spinand_noecc_ooblayout_free,
952 };
953
spinand_init(struct spinand_device * spinand)954 static int spinand_init(struct spinand_device *spinand)
955 {
956 struct device *dev = &spinand->spimem->spi->dev;
957 struct mtd_info *mtd = spinand_to_mtd(spinand);
958 struct nand_device *nand = mtd_to_nanddev(mtd);
959 int ret, i;
960
961 /*
962 * We need a scratch buffer because the spi_mem interface requires that
963 * buf passed in spi_mem_op->data.buf be DMA-able.
964 */
965 spinand->scratchbuf = kzalloc(SPINAND_MAX_ID_LEN, GFP_KERNEL);
966 if (!spinand->scratchbuf)
967 return -ENOMEM;
968
969 ret = spinand_detect(spinand);
970 if (ret)
971 goto err_free_bufs;
972
973 /*
974 * Use kzalloc() instead of devm_kzalloc() here, because some drivers
975 * may use this buffer for DMA access.
976 * Memory allocated by devm_ does not guarantee DMA-safe alignment.
977 */
978 spinand->databuf = kzalloc(nanddev_page_size(nand) +
979 nanddev_per_page_oobsize(nand),
980 GFP_KERNEL);
981 if (!spinand->databuf) {
982 ret = -ENOMEM;
983 goto err_free_bufs;
984 }
985
986 spinand->oobbuf = spinand->databuf + nanddev_page_size(nand);
987
988 ret = spinand_init_cfg_cache(spinand);
989 if (ret)
990 goto err_free_bufs;
991
992 ret = spinand_init_quad_enable(spinand);
993 if (ret)
994 goto err_free_bufs;
995
996 ret = spinand_upd_cfg(spinand, CFG_OTP_ENABLE, 0);
997 if (ret)
998 goto err_free_bufs;
999
1000 ret = spinand_manufacturer_init(spinand);
1001 if (ret) {
1002 dev_err(dev,
1003 "Failed to initialize the SPI NAND chip (err = %d)\n",
1004 ret);
1005 goto err_free_bufs;
1006 }
1007
1008 ret = spinand_create_dirmaps(spinand);
1009 if (ret) {
1010 dev_err(dev,
1011 "Failed to create direct mappings for read/write operations (err = %d)\n",
1012 ret);
1013 goto err_manuf_cleanup;
1014 }
1015
1016 /* After power up, all blocks are locked, so unlock them here. */
1017 for (i = 0; i < nand->memorg.ntargets; i++) {
1018 ret = spinand_select_target(spinand, i);
1019 if (ret)
1020 goto err_manuf_cleanup;
1021
1022 ret = spinand_lock_block(spinand, BL_ALL_UNLOCKED);
1023 if (ret)
1024 goto err_manuf_cleanup;
1025 }
1026
1027 ret = nanddev_init(nand, &spinand_ops, THIS_MODULE);
1028 if (ret)
1029 goto err_manuf_cleanup;
1030
1031 /*
1032 * Right now, we don't support ECC, so let the whole oob
1033 * area is available for user.
1034 */
1035 mtd->_read_oob = spinand_mtd_read;
1036 mtd->_write_oob = spinand_mtd_write;
1037 mtd->_block_isbad = spinand_mtd_block_isbad;
1038 mtd->_block_markbad = spinand_mtd_block_markbad;
1039 mtd->_block_isreserved = spinand_mtd_block_isreserved;
1040 mtd->_erase = spinand_mtd_erase;
1041 mtd->_max_bad_blocks = nanddev_mtd_max_bad_blocks;
1042
1043 if (spinand->eccinfo.ooblayout)
1044 mtd_set_ooblayout(mtd, spinand->eccinfo.ooblayout);
1045 else
1046 mtd_set_ooblayout(mtd, &spinand_noecc_ooblayout);
1047
1048 ret = mtd_ooblayout_count_freebytes(mtd);
1049 if (ret < 0)
1050 goto err_cleanup_nanddev;
1051
1052 mtd->oobavail = ret;
1053
1054 return 0;
1055
1056 err_cleanup_nanddev:
1057 nanddev_cleanup(nand);
1058
1059 err_manuf_cleanup:
1060 spinand_manufacturer_cleanup(spinand);
1061
1062 err_free_bufs:
1063 kfree(spinand->databuf);
1064 kfree(spinand->scratchbuf);
1065 return ret;
1066 }
1067
spinand_cleanup(struct spinand_device * spinand)1068 static void spinand_cleanup(struct spinand_device *spinand)
1069 {
1070 struct nand_device *nand = spinand_to_nand(spinand);
1071
1072 nanddev_cleanup(nand);
1073 spinand_manufacturer_cleanup(spinand);
1074 kfree(spinand->databuf);
1075 kfree(spinand->scratchbuf);
1076 }
1077
spinand_probe(struct spi_mem * mem)1078 static int spinand_probe(struct spi_mem *mem)
1079 {
1080 struct spinand_device *spinand;
1081 struct mtd_info *mtd;
1082 int ret;
1083
1084 spinand = devm_kzalloc(&mem->spi->dev, sizeof(*spinand),
1085 GFP_KERNEL);
1086 if (!spinand)
1087 return -ENOMEM;
1088
1089 spinand->spimem = mem;
1090 spi_mem_set_drvdata(mem, spinand);
1091 spinand_set_of_node(spinand, mem->spi->dev.of_node);
1092 mutex_init(&spinand->lock);
1093 mtd = spinand_to_mtd(spinand);
1094 mtd->dev.parent = &mem->spi->dev;
1095
1096 ret = spinand_init(spinand);
1097 if (ret)
1098 return ret;
1099
1100 ret = mtd_device_register(mtd, NULL, 0);
1101 if (ret)
1102 goto err_spinand_cleanup;
1103
1104 return 0;
1105
1106 err_spinand_cleanup:
1107 spinand_cleanup(spinand);
1108
1109 return ret;
1110 }
1111
spinand_remove(struct spi_mem * mem)1112 static int spinand_remove(struct spi_mem *mem)
1113 {
1114 struct spinand_device *spinand;
1115 struct mtd_info *mtd;
1116 int ret;
1117
1118 spinand = spi_mem_get_drvdata(mem);
1119 mtd = spinand_to_mtd(spinand);
1120
1121 ret = mtd_device_unregister(mtd);
1122 if (ret)
1123 return ret;
1124
1125 spinand_cleanup(spinand);
1126
1127 return 0;
1128 }
1129
1130 static const struct spi_device_id spinand_ids[] = {
1131 { .name = "spi-nand" },
1132 { /* sentinel */ },
1133 };
1134
1135 #ifdef CONFIG_OF
1136 static const struct of_device_id spinand_of_ids[] = {
1137 { .compatible = "spi-nand" },
1138 { /* sentinel */ },
1139 };
1140 #endif
1141
1142 static struct spi_mem_driver spinand_drv = {
1143 .spidrv = {
1144 .id_table = spinand_ids,
1145 .driver = {
1146 .name = "spi-nand",
1147 .of_match_table = of_match_ptr(spinand_of_ids),
1148 },
1149 },
1150 .probe = spinand_probe,
1151 .remove = spinand_remove,
1152 };
1153 module_spi_mem_driver(spinand_drv);
1154
1155 MODULE_DESCRIPTION("SPI NAND framework");
1156 MODULE_AUTHOR("Peter Pan<peterpandong@micron.com>");
1157 MODULE_LICENSE("GPL v2");
1158