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 * Enumeration for NAND flash chip state
70 * NAND Private Flash Chip Data
74 * IO_ADDR - address to access the 8 I/O lines of the flash device
76 * hwcontrol - hardwarespecific function for accesing control-lines
78 * dev_ready - hardwarespecific function for accesing device ready/busy line
80 * chip_lock - spinlock used to protect access to this structure
82 * wq - wait queue to sleep on if a NAND operation is in progress
84 * state - give the current state of the NAND device
86 * page_shift - number of address bits in a page (column address bits)
88 * data_buf - data buffer passed to/from MTD user modules
90 * data_cache - data cache for redundant page access and shadow for
93 * ecc_code_buf - used only for holding calculated or read ECCs for
94 * a page read or written when ECC is in use
96 * reserved - padding to make structure fall on word boundary if
101 unsigned long curadr;
102 unsigned char curmode;
103 /* Also some erase/write/pipeline info when we get that far */
111 u_char ecc_code_buf[6];
113 char ChipID; /* Type of DiskOnChip */
117 unsigned long erasesize;
118 unsigned long mfr; /* Flash IDs - only one type of flash per device */
124 unsigned long IO_ADDR; /* address to access the 8 I/O lines to the flash device */
125 unsigned long totlen;
126 uint oobblock; /* Size of OOB blocks (e.g. 512) */
127 uint oobsize; /* Amount of OOB data per block (e.g. 16) */
133 * NAND Flash Manufacturer ID Codes
135 #define NAND_MFR_TOSHIBA 0x98
136 #define NAND_MFR_SAMSUNG 0xec
139 * NAND Flash Device ID Structure
141 * Structure overview:
143 * name - Complete name of device
145 * manufacture_id - manufacturer ID code of device.
147 * model_id - model ID code of device.
149 * chipshift - total number of address bits for the device which
150 * is used to calculate address offsets and the total
151 * number of bytes the device is capable of.
153 * page256 - denotes if flash device has 256 byte pages or not.
155 * pageadrlen - number of bytes minus one needed to hold the
156 * complete address into the flash array. Keep in
157 * mind that when a read or write is done to a
158 * specific address, the address is input serially
159 * 8 bits at a time. This structure member is used
160 * by the read/write routines as a loop index for
161 * shifting the address out 8 bits at a time.
163 * erasesize - size of an erase block in the flash device.
165 struct nand_flash_dev {
172 unsigned long erasesize;
177 * Constants for oob configuration
179 #define NAND_NOOB_ECCPOS0 0
180 #define NAND_NOOB_ECCPOS1 1
181 #define NAND_NOOB_ECCPOS2 2
182 #define NAND_NOOB_ECCPOS3 3
183 #define NAND_NOOB_ECCPOS4 6
184 #define NAND_NOOB_ECCPOS5 7
185 #define NAND_NOOB_BADBPOS -1
186 #define NAND_NOOB_ECCVPOS -1
188 #define NAND_JFFS2_OOB_ECCPOS0 0
189 #define NAND_JFFS2_OOB_ECCPOS1 1
190 #define NAND_JFFS2_OOB_ECCPOS2 2
191 #define NAND_JFFS2_OOB_ECCPOS3 3
192 #define NAND_JFFS2_OOB_ECCPOS4 6
193 #define NAND_JFFS2_OOB_ECCPOS5 7
194 #define NAND_JFFS2_OOB_BADBPOS 5
195 #define NAND_JFFS2_OOB_ECCVPOS 4
197 #define NAND_JFFS2_OOB8_FSDAPOS 6
198 #define NAND_JFFS2_OOB16_FSDAPOS 8
199 #define NAND_JFFS2_OOB8_FSDALEN 2
200 #define NAND_JFFS2_OOB16_FSDALEN 8
202 unsigned long nand_probe(unsigned long physadr);
203 #endif /* __LINUX_MTD_NAND_LEGACY_H */