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
, int page
)
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");