2 * Copyright (C) 2016 Sigma Designs
4 * This program is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU General Public License
6 * version 2 as published by the Free Software Foundation.
11 #include <linux/clk.h>
12 #include <linux/iopoll.h>
13 #include <linux/module.h>
14 #include <linux/mtd/rawnand.h>
15 #include <linux/dmaengine.h>
16 #include <linux/dma-mapping.h>
17 #include <linux/platform_device.h>
19 /* Offsets relative to chip->base */
24 /* Offsets relative to reg_base */
25 #define NFC_STATUS 0x00
26 #define NFC_FLASH_CMD 0x04
27 #define NFC_DEVICE_CFG 0x08
28 #define NFC_TIMING1 0x0c
29 #define NFC_TIMING2 0x10
30 #define NFC_XFER_CFG 0x14
31 #define NFC_PKT_0_CFG 0x18
32 #define NFC_PKT_N_CFG 0x1c
33 #define NFC_BB_CFG 0x20
34 #define NFC_ADDR_PAGE 0x24
35 #define NFC_ADDR_OFFSET 0x28
36 #define NFC_XFER_STATUS 0x2c
38 /* NFC_STATUS values */
39 #define CMD_READY BIT(31)
41 /* NFC_FLASH_CMD values */
45 /* NFC_XFER_STATUS values */
46 #define PAGE_IS_EMPTY BIT(16)
48 /* Offsets relative to mem_base */
49 #define METADATA 0x000
50 #define ERROR_REPORT 0x1c0
53 * Error reports are split in two bytes:
54 * byte 0 for the first packet in the page (PKT_0)
55 * byte 1 for other packets in the page (PKT_N, for N > 0)
56 * ERR_COUNT_PKT_N is the max error count over all but the first packet.
58 #define ERR_COUNT_PKT_0(v) (((v) >> 0) & 0x3f)
59 #define ERR_COUNT_PKT_N(v) (((v) >> 8) & 0x3f)
60 #define DECODE_FAIL_PKT_0(v) (((v) & BIT(7)) == 0)
61 #define DECODE_FAIL_PKT_N(v) (((v) & BIT(15)) == 0)
63 /* Offsets relative to pbus_base */
64 #define PBUS_CS_CTRL 0x83c
65 #define PBUS_PAD_MODE 0x8f0
67 /* PBUS_CS_CTRL values */
68 #define PBUS_IORDY BIT(31)
71 * PBUS_PAD_MODE values
72 * In raw mode, the driver communicates directly with the NAND chips.
73 * In NFC mode, the NAND Flash controller manages the communication.
74 * We use NFC mode for read and write; raw mode for everything else.
77 #define MODE_NFC BIT(31)
79 #define METADATA_SIZE 4
81 #define FIELD_ORDER 15
86 struct nand_controller hw
;
87 void __iomem
*reg_base
;
88 void __iomem
*mem_base
;
89 void __iomem
*pbus_base
;
90 struct tango_chip
*chips
[MAX_CS
];
91 struct dma_chan
*chan
;
95 #define to_tango_nfc(ptr) container_of(ptr, struct tango_nfc, hw)
98 struct nand_chip nand_chip
;
108 #define to_tango_chip(ptr) container_of(ptr, struct tango_chip, nand_chip)
110 #define XFER_CFG(cs, page_count, steps, metadata_size) \
111 ((cs) << 24 | (page_count) << 16 | (steps) << 8 | (metadata_size))
113 #define PKT_CFG(size, strength) ((size) << 16 | (strength))
115 #define BB_CFG(bb_offset, bb_size) ((bb_offset) << 16 | (bb_size))
117 #define TIMING(t0, t1, t2, t3) ((t0) << 24 | (t1) << 16 | (t2) << 8 | (t3))
119 static void tango_cmd_ctrl(struct mtd_info
*mtd
, int dat
, unsigned int ctrl
)
121 struct tango_chip
*tchip
= to_tango_chip(mtd_to_nand(mtd
));
124 writeb_relaxed(dat
, tchip
->base
+ PBUS_CMD
);
127 writeb_relaxed(dat
, tchip
->base
+ PBUS_ADDR
);
130 static int tango_dev_ready(struct mtd_info
*mtd
)
132 struct nand_chip
*chip
= mtd_to_nand(mtd
);
133 struct tango_nfc
*nfc
= to_tango_nfc(chip
->controller
);
135 return readl_relaxed(nfc
->pbus_base
+ PBUS_CS_CTRL
) & PBUS_IORDY
;
138 static u8
tango_read_byte(struct mtd_info
*mtd
)
140 struct tango_chip
*tchip
= to_tango_chip(mtd_to_nand(mtd
));
142 return readb_relaxed(tchip
->base
+ PBUS_DATA
);
145 static void tango_read_buf(struct mtd_info
*mtd
, u8
*buf
, int len
)
147 struct tango_chip
*tchip
= to_tango_chip(mtd_to_nand(mtd
));
149 ioread8_rep(tchip
->base
+ PBUS_DATA
, buf
, len
);
152 static void tango_write_buf(struct mtd_info
*mtd
, const u8
*buf
, int len
)
154 struct tango_chip
*tchip
= to_tango_chip(mtd_to_nand(mtd
));
156 iowrite8_rep(tchip
->base
+ PBUS_DATA
, buf
, len
);
159 static void tango_select_chip(struct mtd_info
*mtd
, int idx
)
161 struct nand_chip
*chip
= mtd_to_nand(mtd
);
162 struct tango_nfc
*nfc
= to_tango_nfc(chip
->controller
);
163 struct tango_chip
*tchip
= to_tango_chip(chip
);
166 return; /* No "chip unselect" function */
168 writel_relaxed(tchip
->timing1
, nfc
->reg_base
+ NFC_TIMING1
);
169 writel_relaxed(tchip
->timing2
, nfc
->reg_base
+ NFC_TIMING2
);
170 writel_relaxed(tchip
->xfer_cfg
, nfc
->reg_base
+ NFC_XFER_CFG
);
171 writel_relaxed(tchip
->pkt_0_cfg
, nfc
->reg_base
+ NFC_PKT_0_CFG
);
172 writel_relaxed(tchip
->pkt_n_cfg
, nfc
->reg_base
+ NFC_PKT_N_CFG
);
173 writel_relaxed(tchip
->bb_cfg
, nfc
->reg_base
+ NFC_BB_CFG
);
177 * The controller does not check for bitflips in erased pages,
178 * therefore software must check instead.
180 static int check_erased_page(struct nand_chip
*chip
, u8
*buf
)
182 struct mtd_info
*mtd
= nand_to_mtd(chip
);
183 u8
*meta
= chip
->oob_poi
+ BBM_SIZE
;
184 u8
*ecc
= chip
->oob_poi
+ BBM_SIZE
+ METADATA_SIZE
;
185 const int ecc_size
= chip
->ecc
.bytes
;
186 const int pkt_size
= chip
->ecc
.size
;
187 int i
, res
, meta_len
, bitflips
= 0;
189 for (i
= 0; i
< chip
->ecc
.steps
; ++i
) {
190 meta_len
= i
? 0 : METADATA_SIZE
;
191 res
= nand_check_erased_ecc_chunk(buf
, pkt_size
, ecc
, ecc_size
,
195 mtd
->ecc_stats
.failed
++;
197 mtd
->ecc_stats
.corrected
+= res
;
199 bitflips
= max(res
, bitflips
);
207 static int decode_error_report(struct nand_chip
*chip
)
210 struct mtd_info
*mtd
= nand_to_mtd(chip
);
211 struct tango_nfc
*nfc
= to_tango_nfc(chip
->controller
);
213 status
= readl_relaxed(nfc
->reg_base
+ NFC_XFER_STATUS
);
214 if (status
& PAGE_IS_EMPTY
)
217 res
= readl_relaxed(nfc
->mem_base
+ ERROR_REPORT
);
219 if (DECODE_FAIL_PKT_0(res
) || DECODE_FAIL_PKT_N(res
))
222 /* ERR_COUNT_PKT_N is max, not sum, but that's all we have */
223 mtd
->ecc_stats
.corrected
+=
224 ERR_COUNT_PKT_0(res
) + ERR_COUNT_PKT_N(res
);
226 return max(ERR_COUNT_PKT_0(res
), ERR_COUNT_PKT_N(res
));
229 static void tango_dma_callback(void *arg
)
234 static int do_dma(struct tango_nfc
*nfc
, enum dma_data_direction dir
, int cmd
,
235 const void *buf
, int len
, int page
)
237 void __iomem
*addr
= nfc
->reg_base
+ NFC_STATUS
;
238 struct dma_chan
*chan
= nfc
->chan
;
239 struct dma_async_tx_descriptor
*desc
;
240 enum dma_transfer_direction tdir
;
241 struct scatterlist sg
;
242 struct completion tx_done
;
246 sg_init_one(&sg
, buf
, len
);
247 if (dma_map_sg(chan
->device
->dev
, &sg
, 1, dir
) != 1)
250 tdir
= dir
== DMA_TO_DEVICE
? DMA_MEM_TO_DEV
: DMA_DEV_TO_MEM
;
251 desc
= dmaengine_prep_slave_sg(chan
, &sg
, 1, tdir
, DMA_PREP_INTERRUPT
);
255 desc
->callback
= tango_dma_callback
;
256 desc
->callback_param
= &tx_done
;
257 init_completion(&tx_done
);
259 writel_relaxed(MODE_NFC
, nfc
->pbus_base
+ PBUS_PAD_MODE
);
261 writel_relaxed(page
, nfc
->reg_base
+ NFC_ADDR_PAGE
);
262 writel_relaxed(0, nfc
->reg_base
+ NFC_ADDR_OFFSET
);
263 writel_relaxed(cmd
, nfc
->reg_base
+ NFC_FLASH_CMD
);
265 dmaengine_submit(desc
);
266 dma_async_issue_pending(chan
);
268 res
= wait_for_completion_timeout(&tx_done
, HZ
);
270 err
= readl_poll_timeout(addr
, val
, val
& CMD_READY
, 0, 1000);
272 writel_relaxed(MODE_RAW
, nfc
->pbus_base
+ PBUS_PAD_MODE
);
275 dma_unmap_sg(chan
->device
->dev
, &sg
, 1, dir
);
280 static int tango_read_page(struct mtd_info
*mtd
, struct nand_chip
*chip
,
281 u8
*buf
, int oob_required
, int page
)
283 struct tango_nfc
*nfc
= to_tango_nfc(chip
->controller
);
284 int err
, res
, len
= mtd
->writesize
;
287 chip
->ecc
.read_oob(mtd
, chip
, page
);
289 err
= do_dma(nfc
, DMA_FROM_DEVICE
, NFC_READ
, buf
, len
, page
);
293 res
= decode_error_report(chip
);
295 chip
->ecc
.read_oob_raw(mtd
, chip
, page
);
296 res
= check_erased_page(chip
, buf
);
302 static int tango_write_page(struct mtd_info
*mtd
, struct nand_chip
*chip
,
303 const u8
*buf
, int oob_required
, int page
)
305 struct tango_nfc
*nfc
= to_tango_nfc(chip
->controller
);
306 int err
, status
, len
= mtd
->writesize
;
308 /* Calling tango_write_oob() would send PAGEPROG twice */
312 writel_relaxed(0xffffffff, nfc
->mem_base
+ METADATA
);
313 err
= do_dma(nfc
, DMA_TO_DEVICE
, NFC_WRITE
, buf
, len
, page
);
317 status
= chip
->waitfunc(mtd
, chip
);
318 if (status
& NAND_STATUS_FAIL
)
324 static void aux_read(struct nand_chip
*chip
, u8
**buf
, int len
, int *pos
)
326 struct mtd_info
*mtd
= nand_to_mtd(chip
);
331 /* skip over "len" bytes */
332 nand_change_read_column_op(chip
, *pos
, NULL
, 0, false);
334 tango_read_buf(mtd
, *buf
, len
);
339 static void aux_write(struct nand_chip
*chip
, const u8
**buf
, int len
, int *pos
)
341 struct mtd_info
*mtd
= nand_to_mtd(chip
);
346 /* skip over "len" bytes */
347 nand_change_write_column_op(chip
, *pos
, NULL
, 0, false);
349 tango_write_buf(mtd
, *buf
, len
);
355 * Physical page layout (not drawn to scale)
357 * NB: Bad Block Marker area splits PKT_N in two (N1, N2).
359 * +---+-----------------+-------+-----+-----------+-----+----+-------+
360 * | M | PKT_0 | ECC_0 | ... | N1 | BBM | N2 | ECC_N |
361 * +---+-----------------+-------+-----+-----------+-----+----+-------+
363 * Logical page layout:
365 * +-----+---+-------+-----+-------+
366 * oob = | BBM | M | ECC_0 | ... | ECC_N |
367 * +-----+---+-------+-----+-------+
369 * +-----------------+-----+-----------------+
370 * buf = | PKT_0 | ... | PKT_N |
371 * +-----------------+-----+-----------------+
373 static void raw_read(struct nand_chip
*chip
, u8
*buf
, u8
*oob
)
375 struct mtd_info
*mtd
= nand_to_mtd(chip
);
377 const int page_size
= mtd
->writesize
;
378 const int ecc_size
= chip
->ecc
.bytes
;
379 const int pkt_size
= chip
->ecc
.size
;
380 int pos
= 0; /* position within physical page */
381 int rem
= page_size
; /* bytes remaining until BBM area */
386 aux_read(chip
, &oob
, METADATA_SIZE
, &pos
);
388 while (rem
> pkt_size
) {
389 aux_read(chip
, &buf
, pkt_size
, &pos
);
390 aux_read(chip
, &oob
, ecc_size
, &pos
);
391 rem
= page_size
- pos
;
394 aux_read(chip
, &buf
, rem
, &pos
);
395 aux_read(chip
, &oob_orig
, BBM_SIZE
, &pos
);
396 aux_read(chip
, &buf
, pkt_size
- rem
, &pos
);
397 aux_read(chip
, &oob
, ecc_size
, &pos
);
400 static void raw_write(struct nand_chip
*chip
, const u8
*buf
, const u8
*oob
)
402 struct mtd_info
*mtd
= nand_to_mtd(chip
);
403 const u8
*oob_orig
= oob
;
404 const int page_size
= mtd
->writesize
;
405 const int ecc_size
= chip
->ecc
.bytes
;
406 const int pkt_size
= chip
->ecc
.size
;
407 int pos
= 0; /* position within physical page */
408 int rem
= page_size
; /* bytes remaining until BBM area */
413 aux_write(chip
, &oob
, METADATA_SIZE
, &pos
);
415 while (rem
> pkt_size
) {
416 aux_write(chip
, &buf
, pkt_size
, &pos
);
417 aux_write(chip
, &oob
, ecc_size
, &pos
);
418 rem
= page_size
- pos
;
421 aux_write(chip
, &buf
, rem
, &pos
);
422 aux_write(chip
, &oob_orig
, BBM_SIZE
, &pos
);
423 aux_write(chip
, &buf
, pkt_size
- rem
, &pos
);
424 aux_write(chip
, &oob
, ecc_size
, &pos
);
427 static int tango_read_page_raw(struct mtd_info
*mtd
, struct nand_chip
*chip
,
428 u8
*buf
, int oob_required
, int page
)
430 nand_read_page_op(chip
, page
, 0, NULL
, 0);
431 raw_read(chip
, buf
, chip
->oob_poi
);
435 static int tango_write_page_raw(struct mtd_info
*mtd
, struct nand_chip
*chip
,
436 const u8
*buf
, int oob_required
, int page
)
438 nand_prog_page_begin_op(chip
, page
, 0, NULL
, 0);
439 raw_write(chip
, buf
, chip
->oob_poi
);
440 return nand_prog_page_end_op(chip
);
443 static int tango_read_oob(struct mtd_info
*mtd
, struct nand_chip
*chip
,
446 nand_read_page_op(chip
, page
, 0, NULL
, 0);
447 raw_read(chip
, NULL
, chip
->oob_poi
);
451 static int tango_write_oob(struct mtd_info
*mtd
, struct nand_chip
*chip
,
454 nand_prog_page_begin_op(chip
, page
, 0, NULL
, 0);
455 raw_write(chip
, NULL
, chip
->oob_poi
);
456 return nand_prog_page_end_op(chip
);
459 static int oob_ecc(struct mtd_info
*mtd
, int idx
, struct mtd_oob_region
*res
)
461 struct nand_chip
*chip
= mtd_to_nand(mtd
);
462 struct nand_ecc_ctrl
*ecc
= &chip
->ecc
;
464 if (idx
>= ecc
->steps
)
467 res
->offset
= BBM_SIZE
+ METADATA_SIZE
+ ecc
->bytes
* idx
;
468 res
->length
= ecc
->bytes
;
473 static int oob_free(struct mtd_info
*mtd
, int idx
, struct mtd_oob_region
*res
)
475 return -ERANGE
; /* no free space in spare area */
478 static const struct mtd_ooblayout_ops tango_nand_ooblayout_ops
= {
483 static u32
to_ticks(int kHz
, int ps
)
485 return DIV_ROUND_UP_ULL((u64
)kHz
* ps
, NSEC_PER_SEC
);
488 static int tango_set_timings(struct mtd_info
*mtd
, int csline
,
489 const struct nand_data_interface
*conf
)
491 const struct nand_sdr_timings
*sdr
= nand_get_sdr_timings(conf
);
492 struct nand_chip
*chip
= mtd_to_nand(mtd
);
493 struct tango_nfc
*nfc
= to_tango_nfc(chip
->controller
);
494 struct tango_chip
*tchip
= to_tango_chip(chip
);
495 u32 Trdy
, Textw
, Twc
, Twpw
, Tacc
, Thold
, Trpw
, Textr
;
496 int kHz
= nfc
->freq_kHz
;
501 if (csline
== NAND_DATA_IFACE_CHECK_ONLY
)
504 Trdy
= to_ticks(kHz
, sdr
->tCEA_max
- sdr
->tREA_max
);
505 Textw
= to_ticks(kHz
, sdr
->tWB_max
);
506 Twc
= to_ticks(kHz
, sdr
->tWC_min
);
507 Twpw
= to_ticks(kHz
, sdr
->tWC_min
- sdr
->tWP_min
);
509 Tacc
= to_ticks(kHz
, sdr
->tREA_max
);
510 Thold
= to_ticks(kHz
, sdr
->tREH_min
);
511 Trpw
= to_ticks(kHz
, sdr
->tRC_min
- sdr
->tREH_min
);
512 Textr
= to_ticks(kHz
, sdr
->tRHZ_max
);
514 tchip
->timing1
= TIMING(Trdy
, Textw
, Twc
, Twpw
);
515 tchip
->timing2
= TIMING(Tacc
, Thold
, Trpw
, Textr
);
520 static int tango_attach_chip(struct nand_chip
*chip
)
522 struct nand_ecc_ctrl
*ecc
= &chip
->ecc
;
524 ecc
->mode
= NAND_ECC_HW
;
525 ecc
->algo
= NAND_ECC_BCH
;
526 ecc
->bytes
= DIV_ROUND_UP(ecc
->strength
* FIELD_ORDER
, BITS_PER_BYTE
);
528 ecc
->read_page_raw
= tango_read_page_raw
;
529 ecc
->write_page_raw
= tango_write_page_raw
;
530 ecc
->read_page
= tango_read_page
;
531 ecc
->write_page
= tango_write_page
;
532 ecc
->read_oob
= tango_read_oob
;
533 ecc
->write_oob
= tango_write_oob
;
538 static const struct nand_controller_ops tango_controller_ops
= {
539 .attach_chip
= tango_attach_chip
,
542 static int chip_init(struct device
*dev
, struct device_node
*np
)
546 struct mtd_info
*mtd
;
547 struct nand_chip
*chip
;
548 struct tango_chip
*tchip
;
549 struct nand_ecc_ctrl
*ecc
;
550 struct tango_nfc
*nfc
= dev_get_drvdata(dev
);
552 tchip
= devm_kzalloc(dev
, sizeof(*tchip
), GFP_KERNEL
);
556 res
= of_property_count_u32_elems(np
, "reg");
561 return -ENOTSUPP
; /* Multi-CS chips are not supported */
563 err
= of_property_read_u32_index(np
, "reg", 0, &cs
);
570 chip
= &tchip
->nand_chip
;
572 mtd
= nand_to_mtd(chip
);
574 chip
->read_byte
= tango_read_byte
;
575 chip
->write_buf
= tango_write_buf
;
576 chip
->read_buf
= tango_read_buf
;
577 chip
->select_chip
= tango_select_chip
;
578 chip
->cmd_ctrl
= tango_cmd_ctrl
;
579 chip
->dev_ready
= tango_dev_ready
;
580 chip
->setup_data_interface
= tango_set_timings
;
581 chip
->options
= NAND_USE_BOUNCE_BUFFER
|
582 NAND_NO_SUBPAGE_WRITE
|
584 chip
->controller
= &nfc
->hw
;
585 tchip
->base
= nfc
->pbus_base
+ (cs
* 256);
587 nand_set_flash_node(chip
, np
);
588 mtd_set_ooblayout(mtd
, &tango_nand_ooblayout_ops
);
589 mtd
->dev
.parent
= dev
;
591 err
= nand_scan(chip
, 1);
595 tchip
->xfer_cfg
= XFER_CFG(cs
, 1, ecc
->steps
, METADATA_SIZE
);
596 tchip
->pkt_0_cfg
= PKT_CFG(ecc
->size
+ METADATA_SIZE
, ecc
->strength
);
597 tchip
->pkt_n_cfg
= PKT_CFG(ecc
->size
, ecc
->strength
);
598 tchip
->bb_cfg
= BB_CFG(mtd
->writesize
, BBM_SIZE
);
600 err
= mtd_device_register(mtd
, NULL
, 0);
606 nfc
->chips
[cs
] = tchip
;
611 static int tango_nand_remove(struct platform_device
*pdev
)
614 struct tango_nfc
*nfc
= platform_get_drvdata(pdev
);
616 dma_release_channel(nfc
->chan
);
618 for (cs
= 0; cs
< MAX_CS
; ++cs
) {
620 nand_release(&nfc
->chips
[cs
]->nand_chip
);
626 static int tango_nand_probe(struct platform_device
*pdev
)
630 struct resource
*res
;
631 struct tango_nfc
*nfc
;
632 struct device_node
*np
;
634 nfc
= devm_kzalloc(&pdev
->dev
, sizeof(*nfc
), GFP_KERNEL
);
638 res
= platform_get_resource(pdev
, IORESOURCE_MEM
, 0);
639 nfc
->reg_base
= devm_ioremap_resource(&pdev
->dev
, res
);
640 if (IS_ERR(nfc
->reg_base
))
641 return PTR_ERR(nfc
->reg_base
);
643 res
= platform_get_resource(pdev
, IORESOURCE_MEM
, 1);
644 nfc
->mem_base
= devm_ioremap_resource(&pdev
->dev
, res
);
645 if (IS_ERR(nfc
->mem_base
))
646 return PTR_ERR(nfc
->mem_base
);
648 res
= platform_get_resource(pdev
, IORESOURCE_MEM
, 2);
649 nfc
->pbus_base
= devm_ioremap_resource(&pdev
->dev
, res
);
650 if (IS_ERR(nfc
->pbus_base
))
651 return PTR_ERR(nfc
->pbus_base
);
653 writel_relaxed(MODE_RAW
, nfc
->pbus_base
+ PBUS_PAD_MODE
);
655 clk
= devm_clk_get(&pdev
->dev
, NULL
);
659 nfc
->chan
= dma_request_chan(&pdev
->dev
, "rxtx");
660 if (IS_ERR(nfc
->chan
))
661 return PTR_ERR(nfc
->chan
);
663 platform_set_drvdata(pdev
, nfc
);
664 nand_controller_init(&nfc
->hw
);
665 nfc
->hw
.ops
= &tango_controller_ops
;
666 nfc
->freq_kHz
= clk_get_rate(clk
) / 1000;
668 for_each_child_of_node(pdev
->dev
.of_node
, np
) {
669 err
= chip_init(&pdev
->dev
, np
);
671 tango_nand_remove(pdev
);
679 static const struct of_device_id tango_nand_ids
[] = {
680 { .compatible
= "sigma,smp8758-nand" },
683 MODULE_DEVICE_TABLE(of
, tango_nand_ids
);
685 static struct platform_driver tango_nand_driver
= {
686 .probe
= tango_nand_probe
,
687 .remove
= tango_nand_remove
,
689 .name
= "tango-nand",
690 .of_match_table
= tango_nand_ids
,
694 module_platform_driver(tango_nand_driver
);
696 MODULE_LICENSE("GPL");
697 MODULE_AUTHOR("Sigma Designs");
698 MODULE_DESCRIPTION("Tango4 NAND Flash controller driver");