2 * Copyright (C) 2003 Rick Bronson
4 * Derived from drivers/mtd/nand/autcpu12.c
5 * Copyright (c) 2001 Thomas Gleixner (gleixner@autronix.de)
7 * Derived from drivers/mtd/spia.c
8 * Copyright (C) 2000 Steven J. Hill (sjhill@cotw.com)
11 * Add Hardware ECC support for AT91SAM9260 / AT91SAM9263
12 * Richard Genoud (richard.genoud@gmail.com), Adeneo Copyright (C) 2007
14 * Derived from Das U-Boot source code
15 * (u-boot-1.1.5/board/atmel/at91sam9263ek/nand.c)
16 * (C) Copyright 2006 ATMEL Rousset, Lacressonniere Nicolas
19 * This program is free software; you can redistribute it and/or modify
20 * it under the terms of the GNU General Public License version 2 as
21 * published by the Free Software Foundation.
25 #include <linux/slab.h>
26 #include <linux/module.h>
27 #include <linux/moduleparam.h>
28 #include <linux/platform_device.h>
29 #include <linux/mtd/mtd.h>
30 #include <linux/mtd/nand.h>
31 #include <linux/mtd/partitions.h>
33 #include <linux/gpio.h>
36 #include <mach/board.h>
39 #ifdef CONFIG_MTD_NAND_ATMEL_ECC_HW
45 #ifdef CONFIG_MTD_NAND_ATMEL_ECC_NONE
51 static int on_flash_bbt = 0;
52 module_param(on_flash_bbt, int, 0);
54 /* Register access macros */
55 #define ecc_readl(add, reg) \
56 __raw_readl(add + ATMEL_ECC_##reg)
57 #define ecc_writel(add, reg, value) \
58 __raw_writel((value), add + ATMEL_ECC_##reg)
60 #include "atmel_nand_ecc.h" /* Hardware ECC registers */
62 /* oob layout for large page size
63 * bad block info is on bytes 0 and 1
64 * the bytes have to be consecutives to avoid
65 * several NAND_CMD_RNDOUT during read
67 static struct nand_ecclayout atmel_oobinfo_large = {
69 .eccpos = {60, 61, 62, 63},
75 /* oob layout for small page size
76 * bad block info is on bytes 4 and 5
77 * the bytes have to be consecutives to avoid
78 * several NAND_CMD_RNDOUT during read
80 static struct nand_ecclayout atmel_oobinfo_small = {
82 .eccpos = {0, 1, 2, 3},
88 struct atmel_nand_host {
89 struct nand_chip nand_chip;
91 void __iomem *io_base;
92 struct atmel_nand_data *board;
100 static void atmel_nand_enable(struct atmel_nand_host *host)
102 if (host->board->enable_pin)
103 gpio_set_value(host->board->enable_pin, 0);
109 static void atmel_nand_disable(struct atmel_nand_host *host)
111 if (host->board->enable_pin)
112 gpio_set_value(host->board->enable_pin, 1);
116 * Hardware specific access to control-lines
118 static void atmel_nand_cmd_ctrl(struct mtd_info *mtd, int cmd, unsigned int ctrl)
120 struct nand_chip *nand_chip = mtd->priv;
121 struct atmel_nand_host *host = nand_chip->priv;
123 if (ctrl & NAND_CTRL_CHANGE) {
125 atmel_nand_enable(host);
127 atmel_nand_disable(host);
129 if (cmd == NAND_CMD_NONE)
133 writeb(cmd, host->io_base + (1 << host->board->cle));
135 writeb(cmd, host->io_base + (1 << host->board->ale));
139 * Read the Device Ready pin.
141 static int atmel_nand_device_ready(struct mtd_info *mtd)
143 struct nand_chip *nand_chip = mtd->priv;
144 struct atmel_nand_host *host = nand_chip->priv;
146 return gpio_get_value(host->board->rdy_pin) ^
147 !!host->board->rdy_pin_active_low;
151 * Minimal-overhead PIO for data access.
153 static void atmel_read_buf(struct mtd_info *mtd, u8 *buf, int len)
155 struct nand_chip *nand_chip = mtd->priv;
157 __raw_readsb(nand_chip->IO_ADDR_R, buf, len);
160 static void atmel_read_buf16(struct mtd_info *mtd, u8 *buf, int len)
162 struct nand_chip *nand_chip = mtd->priv;
164 __raw_readsw(nand_chip->IO_ADDR_R, buf, len / 2);
167 static void atmel_write_buf(struct mtd_info *mtd, const u8 *buf, int len)
169 struct nand_chip *nand_chip = mtd->priv;
171 __raw_writesb(nand_chip->IO_ADDR_W, buf, len);
174 static void atmel_write_buf16(struct mtd_info *mtd, const u8 *buf, int len)
176 struct nand_chip *nand_chip = mtd->priv;
178 __raw_writesw(nand_chip->IO_ADDR_W, buf, len / 2);
184 * function called after a write
186 * mtd: MTD block structure
187 * dat: raw data (unused)
188 * ecc_code: buffer for ECC
190 static int atmel_nand_calculate(struct mtd_info *mtd,
191 const u_char *dat, unsigned char *ecc_code)
193 struct nand_chip *nand_chip = mtd->priv;
194 struct atmel_nand_host *host = nand_chip->priv;
195 uint32_t *eccpos = nand_chip->ecc.layout->eccpos;
196 unsigned int ecc_value;
198 /* get the first 2 ECC bytes */
199 ecc_value = ecc_readl(host->ecc, PR);
201 ecc_code[0] = ecc_value & 0xFF;
202 ecc_code[1] = (ecc_value >> 8) & 0xFF;
204 /* get the last 2 ECC bytes */
205 ecc_value = ecc_readl(host->ecc, NPR) & ATMEL_ECC_NPARITY;
207 ecc_code[2] = ecc_value & 0xFF;
208 ecc_code[3] = (ecc_value >> 8) & 0xFF;
214 * HW ECC read page function
216 * mtd: mtd info structure
217 * chip: nand chip info structure
218 * buf: buffer to store read data
220 static int atmel_nand_read_page(struct mtd_info *mtd,
221 struct nand_chip *chip, uint8_t *buf)
223 int eccsize = chip->ecc.size;
224 int eccbytes = chip->ecc.bytes;
225 uint32_t *eccpos = chip->ecc.layout->eccpos;
227 uint8_t *oob = chip->oob_poi;
232 * Errata: ALE is incorrectly wired up to the ECC controller
233 * on the AP7000, so it will include the address cycles in the
236 * Workaround: Reset the parity registers before reading the
239 if (cpu_is_at32ap7000()) {
240 struct atmel_nand_host *host = chip->priv;
241 ecc_writel(host->ecc, CR, ATMEL_ECC_RST);
245 chip->read_buf(mtd, p, eccsize);
247 /* move to ECC position if needed */
248 if (eccpos[0] != 0) {
249 /* This only works on large pages
250 * because the ECC controller waits for
251 * NAND_CMD_RNDOUTSTART after the
253 * anyway, for small pages, the eccpos[0] == 0
255 chip->cmdfunc(mtd, NAND_CMD_RNDOUT,
256 mtd->writesize + eccpos[0], -1);
259 /* the ECC controller needs to read the ECC just after the data */
260 ecc_pos = oob + eccpos[0];
261 chip->read_buf(mtd, ecc_pos, eccbytes);
263 /* check if there's an error */
264 stat = chip->ecc.correct(mtd, p, oob, NULL);
267 mtd->ecc_stats.failed++;
269 mtd->ecc_stats.corrected += stat;
271 /* get back to oob start (end of page) */
272 chip->cmdfunc(mtd, NAND_CMD_RNDOUT, mtd->writesize, -1);
275 chip->read_buf(mtd, oob, mtd->oobsize);
283 * function called after a read
285 * mtd: MTD block structure
286 * dat: raw data read from the chip
287 * read_ecc: ECC from the chip (unused)
290 * Detect and correct a 1 bit error for a page
292 static int atmel_nand_correct(struct mtd_info *mtd, u_char *dat,
293 u_char *read_ecc, u_char *isnull)
295 struct nand_chip *nand_chip = mtd->priv;
296 struct atmel_nand_host *host = nand_chip->priv;
297 unsigned int ecc_status;
298 unsigned int ecc_word, ecc_bit;
300 /* get the status from the Status Register */
301 ecc_status = ecc_readl(host->ecc, SR);
303 /* if there's no error */
304 if (likely(!(ecc_status & ATMEL_ECC_RECERR)))
307 /* get error bit offset (4 bits) */
308 ecc_bit = ecc_readl(host->ecc, PR) & ATMEL_ECC_BITADDR;
309 /* get word address (12 bits) */
310 ecc_word = ecc_readl(host->ecc, PR) & ATMEL_ECC_WORDADDR;
313 /* if there are multiple errors */
314 if (ecc_status & ATMEL_ECC_MULERR) {
315 /* check if it is a freshly erased block
316 * (filled with 0xff) */
317 if ((ecc_bit == ATMEL_ECC_BITADDR)
318 && (ecc_word == (ATMEL_ECC_WORDADDR >> 4))) {
319 /* the block has just been erased, return OK */
322 /* it doesn't seems to be a freshly
324 * We can't correct so many errors */
325 dev_dbg(host->dev, "atmel_nand : multiple errors detected."
326 " Unable to correct.\n");
330 /* if there's a single bit error : we can correct it */
331 if (ecc_status & ATMEL_ECC_ECCERR) {
332 /* there's nothing much to do here.
333 * the bit error is on the ECC itself.
335 dev_dbg(host->dev, "atmel_nand : one bit error on ECC code."
336 " Nothing to correct\n");
340 dev_dbg(host->dev, "atmel_nand : one bit error on data."
341 " (word offset in the page :"
342 " 0x%x bit offset : 0x%x)\n",
344 /* correct the error */
345 if (nand_chip->options & NAND_BUSWIDTH_16) {
347 ((unsigned short *) dat)[ecc_word] ^= (1 << ecc_bit);
350 dat[ecc_word] ^= (1 << ecc_bit);
352 dev_dbg(host->dev, "atmel_nand : error corrected\n");
357 * Enable HW ECC : unused on most chips
359 static void atmel_nand_hwctl(struct mtd_info *mtd, int mode)
361 if (cpu_is_at32ap7000()) {
362 struct nand_chip *nand_chip = mtd->priv;
363 struct atmel_nand_host *host = nand_chip->priv;
364 ecc_writel(host->ecc, CR, ATMEL_ECC_RST);
368 #ifdef CONFIG_MTD_PARTITIONS
369 static const char *part_probes[] = { "cmdlinepart", NULL };
373 * Probe for the NAND device.
375 static int __init atmel_nand_probe(struct platform_device *pdev)
377 struct atmel_nand_host *host;
378 struct mtd_info *mtd;
379 struct nand_chip *nand_chip;
380 struct resource *regs;
381 struct resource *mem;
384 #ifdef CONFIG_MTD_PARTITIONS
385 struct mtd_partition *partitions = NULL;
386 int num_partitions = 0;
389 mem = platform_get_resource(pdev, IORESOURCE_MEM, 0);
391 printk(KERN_ERR "atmel_nand: can't get I/O resource mem\n");
395 /* Allocate memory for the device structure (and zero it) */
396 host = kzalloc(sizeof(struct atmel_nand_host), GFP_KERNEL);
398 printk(KERN_ERR "atmel_nand: failed to allocate device structure.\n");
402 host->io_base = ioremap(mem->start, mem->end - mem->start + 1);
403 if (host->io_base == NULL) {
404 printk(KERN_ERR "atmel_nand: ioremap failed\n");
406 goto err_nand_ioremap;
410 nand_chip = &host->nand_chip;
411 host->board = pdev->dev.platform_data;
412 host->dev = &pdev->dev;
414 nand_chip->priv = host; /* link the private data structures */
415 mtd->priv = nand_chip;
416 mtd->owner = THIS_MODULE;
418 /* Set address of NAND IO lines */
419 nand_chip->IO_ADDR_R = host->io_base;
420 nand_chip->IO_ADDR_W = host->io_base;
421 nand_chip->cmd_ctrl = atmel_nand_cmd_ctrl;
423 if (host->board->rdy_pin)
424 nand_chip->dev_ready = atmel_nand_device_ready;
426 regs = platform_get_resource(pdev, IORESOURCE_MEM, 1);
427 if (!regs && hard_ecc) {
428 printk(KERN_ERR "atmel_nand: can't get I/O resource "
429 "regs\nFalling back on software ECC\n");
432 nand_chip->ecc.mode = NAND_ECC_SOFT; /* enable ECC */
434 nand_chip->ecc.mode = NAND_ECC_NONE;
435 if (hard_ecc && regs) {
436 host->ecc = ioremap(regs->start, regs->end - regs->start + 1);
437 if (host->ecc == NULL) {
438 printk(KERN_ERR "atmel_nand: ioremap failed\n");
440 goto err_ecc_ioremap;
442 nand_chip->ecc.mode = NAND_ECC_HW;
443 nand_chip->ecc.calculate = atmel_nand_calculate;
444 nand_chip->ecc.correct = atmel_nand_correct;
445 nand_chip->ecc.hwctl = atmel_nand_hwctl;
446 nand_chip->ecc.read_page = atmel_nand_read_page;
447 nand_chip->ecc.bytes = 4;
450 nand_chip->chip_delay = 20; /* 20us command delay time */
452 if (host->board->bus_width_16) { /* 16-bit bus width */
453 nand_chip->options |= NAND_BUSWIDTH_16;
454 nand_chip->read_buf = atmel_read_buf16;
455 nand_chip->write_buf = atmel_write_buf16;
457 nand_chip->read_buf = atmel_read_buf;
458 nand_chip->write_buf = atmel_write_buf;
461 platform_set_drvdata(pdev, host);
462 atmel_nand_enable(host);
464 if (host->board->det_pin) {
465 if (gpio_get_value(host->board->det_pin)) {
466 printk(KERN_INFO "No SmartMedia card inserted.\n");
473 printk(KERN_INFO "atmel_nand: Use On Flash BBT\n");
474 nand_chip->options |= NAND_USE_FLASH_BBT;
477 /* first scan to find the device and get the page size */
478 if (nand_scan_ident(mtd, 1)) {
483 if (nand_chip->ecc.mode == NAND_ECC_HW) {
484 /* ECC is calculated for the whole page (1 step) */
485 nand_chip->ecc.size = mtd->writesize;
487 /* set ECC page size and oob layout */
488 switch (mtd->writesize) {
490 nand_chip->ecc.layout = &atmel_oobinfo_small;
491 ecc_writel(host->ecc, MR, ATMEL_ECC_PAGESIZE_528);
494 nand_chip->ecc.layout = &atmel_oobinfo_large;
495 ecc_writel(host->ecc, MR, ATMEL_ECC_PAGESIZE_1056);
498 nand_chip->ecc.layout = &atmel_oobinfo_large;
499 ecc_writel(host->ecc, MR, ATMEL_ECC_PAGESIZE_2112);
502 nand_chip->ecc.layout = &atmel_oobinfo_large;
503 ecc_writel(host->ecc, MR, ATMEL_ECC_PAGESIZE_4224);
506 /* page size not handled by HW ECC */
507 /* switching back to soft ECC */
508 nand_chip->ecc.mode = NAND_ECC_SOFT;
509 nand_chip->ecc.calculate = NULL;
510 nand_chip->ecc.correct = NULL;
511 nand_chip->ecc.hwctl = NULL;
512 nand_chip->ecc.read_page = NULL;
513 nand_chip->ecc.postpad = 0;
514 nand_chip->ecc.prepad = 0;
515 nand_chip->ecc.bytes = 0;
520 /* second phase scan */
521 if (nand_scan_tail(mtd)) {
526 #ifdef CONFIG_MTD_PARTITIONS
527 #ifdef CONFIG_MTD_CMDLINE_PARTS
528 mtd->name = "atmel_nand";
529 num_partitions = parse_mtd_partitions(mtd, part_probes,
532 if (num_partitions <= 0 && host->board->partition_info)
533 partitions = host->board->partition_info(mtd->size,
536 if ((!partitions) || (num_partitions == 0)) {
537 printk(KERN_ERR "atmel_nand: No partitions defined, or unsupported device.\n");
539 goto err_no_partitions;
542 res = add_mtd_partitions(mtd, partitions, num_partitions);
544 res = add_mtd_device(mtd);
550 #ifdef CONFIG_MTD_PARTITIONS
557 atmel_nand_disable(host);
558 platform_set_drvdata(pdev, NULL);
562 iounmap(host->io_base);
569 * Remove a NAND device.
571 static int __exit atmel_nand_remove(struct platform_device *pdev)
573 struct atmel_nand_host *host = platform_get_drvdata(pdev);
574 struct mtd_info *mtd = &host->mtd;
578 atmel_nand_disable(host);
582 iounmap(host->io_base);
588 static struct platform_driver atmel_nand_driver = {
589 .remove = __exit_p(atmel_nand_remove),
591 .name = "atmel_nand",
592 .owner = THIS_MODULE,
596 static int __init atmel_nand_init(void)
598 return platform_driver_probe(&atmel_nand_driver, atmel_nand_probe);
602 static void __exit atmel_nand_exit(void)
604 platform_driver_unregister(&atmel_nand_driver);
608 module_init(atmel_nand_init);
609 module_exit(atmel_nand_exit);
611 MODULE_LICENSE("GPL");
612 MODULE_AUTHOR("Rick Bronson");
613 MODULE_DESCRIPTION("NAND/SmartMedia driver for AT91 / AVR32");
614 MODULE_ALIAS("platform:atmel_nand");