2 * linux/include/linux/mtd/nand.h
4 * Copyright (c) 2000 David Woodhouse <dwmw2@mvhi.com>
5 * Steven J. Hill <sjhill@cotw.com>
6 * Thomas Gleixner <gleixner@autronix.de>
8 * $Id: nand.h,v 1.7 2003/07/24 23:30:46 a0384864 Exp $
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License version 2 as
12 * published by the Free Software Foundation.
15 * Contains standard defines and IDs for NAND flash devices
18 * 01-31-2000 DMW Created
19 * 09-18-2000 SJH Moved structure out of the Disk-On-Chip drivers
20 * so it can be used by other NAND flash device
21 * drivers. I also changed the copyright since none
22 * of the original contents of this file are specific
23 * to DoC devices. David can whack me with a baseball
24 * bat later if I did something naughty.
25 * 10-11-2000 SJH Added private NAND flash structure for driver
26 * 10-24-2000 SJH Added prototype for 'nand_scan' function
27 * 10-29-2001 TG changed nand_chip structure to support
28 * hardwarespecific function for accessing control lines
29 * 02-21-2002 TG added support for different read/write adress and
30 * ready/busy line access function
31 * 02-26-2002 TG added chip_delay to nand_chip structure to optimize
32 * command delay times for different chips
33 * 04-28-2002 TG OOB config defines moved from nand.c to avoid duplicate
34 * defines in jffs2/wbuf.c
36 #ifndef __LINUX_MTD_NAND_LEGACY_H
37 #define __LINUX_MTD_NAND_LEGACY_H
39 #ifndef CFG_NAND_LEGACY
40 #error This module is for the legacy NAND support
44 * Standard NAND flash commands
46 #define NAND_CMD_READ0 0
47 #define NAND_CMD_READ1 1
48 #define NAND_CMD_PAGEPROG 0x10
49 #define NAND_CMD_READOOB 0x50
50 #define NAND_CMD_ERASE1 0x60
51 #define NAND_CMD_STATUS 0x70
52 #define NAND_CMD_SEQIN 0x80
53 #define NAND_CMD_READID 0x90
54 #define NAND_CMD_ERASE2 0xd0
55 #define NAND_CMD_RESET 0xff
58 * NAND Private Flash Chip Data
62 * IO_ADDR - address to access the 8 I/O lines of the flash device
64 * hwcontrol - hardwarespecific function for accesing control-lines
66 * dev_ready - hardwarespecific function for accesing device ready/busy line
68 * chip_lock - spinlock used to protect access to this structure
70 * wq - wait queue to sleep on if a NAND operation is in progress
72 * state - give the current state of the NAND device
74 * page_shift - number of address bits in a page (column address bits)
76 * data_buf - data buffer passed to/from MTD user modules
78 * data_cache - data cache for redundant page access and shadow for
81 * ecc_code_buf - used only for holding calculated or read ECCs for
82 * a page read or written when ECC is in use
84 * reserved - padding to make structure fall on word boundary if
90 unsigned char curmode;
91 /* Also some erase/write/pipeline info when we get that far */
99 u_char ecc_code_buf[6];
101 char ChipID; /* Type of DiskOnChip */
105 unsigned long erasesize;
106 unsigned long mfr; /* Flash IDs - only one type of flash per device */
112 unsigned long IO_ADDR; /* address to access the 8 I/O lines to the flash device */
113 unsigned long totlen;
114 uint oobblock; /* Size of OOB blocks (e.g. 512) */
115 uint oobsize; /* Amount of OOB data per block (e.g. 16) */
121 * NAND Flash Manufacturer ID Codes
123 #define NAND_MFR_TOSHIBA 0x98
124 #define NAND_MFR_SAMSUNG 0xec
127 * NAND Flash Device ID Structure
129 * Structure overview:
131 * name - Complete name of device
133 * manufacture_id - manufacturer ID code of device.
135 * model_id - model ID code of device.
137 * chipshift - total number of address bits for the device which
138 * is used to calculate address offsets and the total
139 * number of bytes the device is capable of.
141 * page256 - denotes if flash device has 256 byte pages or not.
143 * pageadrlen - number of bytes minus one needed to hold the
144 * complete address into the flash array. Keep in
145 * mind that when a read or write is done to a
146 * specific address, the address is input serially
147 * 8 bits at a time. This structure member is used
148 * by the read/write routines as a loop index for
149 * shifting the address out 8 bits at a time.
151 * erasesize - size of an erase block in the flash device.
153 struct nand_flash_dev {
160 unsigned long erasesize;
165 * Constants for oob configuration
167 #define NAND_NOOB_ECCPOS0 0
168 #define NAND_NOOB_ECCPOS1 1
169 #define NAND_NOOB_ECCPOS2 2
170 #define NAND_NOOB_ECCPOS3 3
171 #define NAND_NOOB_ECCPOS4 6
172 #define NAND_NOOB_ECCPOS5 7
173 #define NAND_NOOB_BADBPOS -1
174 #define NAND_NOOB_ECCVPOS -1
176 #define NAND_JFFS2_OOB_ECCPOS0 0
177 #define NAND_JFFS2_OOB_ECCPOS1 1
178 #define NAND_JFFS2_OOB_ECCPOS2 2
179 #define NAND_JFFS2_OOB_ECCPOS3 3
180 #define NAND_JFFS2_OOB_ECCPOS4 6
181 #define NAND_JFFS2_OOB_ECCPOS5 7
182 #define NAND_JFFS2_OOB_BADBPOS 5
183 #define NAND_JFFS2_OOB_ECCVPOS 4
185 #define NAND_JFFS2_OOB8_FSDAPOS 6
186 #define NAND_JFFS2_OOB16_FSDAPOS 8
187 #define NAND_JFFS2_OOB8_FSDALEN 2
188 #define NAND_JFFS2_OOB16_FSDALEN 8
190 unsigned long nand_probe(unsigned long physadr);
191 #endif /* __LINUX_MTD_NAND_LEGACY_H */