include/linux/mtd/nand_legacy.h

   1 /*
   2  *  linux/include/linux/mtd/nand.h
   3  *
   4  *  Copyright (c) 2000 David Woodhouse <dwmw2@mvhi.com>
   5  *                     Steven J. Hill <sjhill@cotw.com>
   6  *                     Thomas Gleixner <gleixner@autronix.de>
   7  *
   8  * $Id: nand.h,v 1.7 2003/07/24 23:30:46 a0384864 Exp $
   9  *
  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.
  13  *
  14  *  Info:
  15  *   Contains standard defines and IDs for NAND flash devices
  16  *
  17  *  Changelog:
  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
  35  */
  36 #ifndef __LINUX_MTD_NAND_LEGACY_H
  37 #define __LINUX_MTD_NAND_LEGACY_H
  38
  39 #ifndef CFG_NAND_LEGACY
  40 #error This module is for the legacy NAND support
  41 #endif
  42
  43 /*
  44  * Standard NAND flash commands
  45  */
  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
  56
  57 /*
  58  * NAND Private Flash Chip Data
  59  *
  60  * Structure overview:
  61  *
  62  *  IO_ADDR - address to access the 8 I/O lines of the flash device
  63  *
  64  *  hwcontrol - hardwarespecific function for accesing control-lines
  65  *
  66  *  dev_ready - hardwarespecific function for accesing device ready/busy line
  67  *
  68  *  chip_lock - spinlock used to protect access to this structure
  69  *
  70  *  wq - wait queue to sleep on if a NAND operation is in progress
  71  *
  72  *  state - give the current state of the NAND device
  73  *
  74  *  page_shift - number of address bits in a page (column address bits)
  75  *
  76  *  data_buf - data buffer passed to/from MTD user modules
  77  *
  78  *  data_cache - data cache for redundant page access and shadow for
  79  *               ECC failure
  80  *
  81  *  ecc_code_buf - used only for holding calculated or read ECCs for
  82  *                 a page read or written when ECC is in use
  83  *
  84  *  reserved - padding to make structure fall on word boundary if
  85  *             when ECC is in use
  86  */
  87 struct Nand {
  88         char floor, chip;
  89         unsigned long curadr;
  90         unsigned char curmode;
  91         /* Also some erase/write/pipeline info when we get that far */
  92 };
  93
  94 struct nand_chip {
  95         int             page_shift;
  96         u_char          *data_buf;
  97         u_char          *data_cache;
  98         int             cache_page;
  99         u_char          ecc_code_buf[6];
 100         u_char          reserved[2];
 101         char ChipID; /* Type of DiskOnChip */
 102         struct Nand *chips;
 103         int chipshift;
 104         char* chips_name;
 105         unsigned long erasesize;
 106         unsigned long mfr; /* Flash IDs - only one type of flash per device */
 107         unsigned long id;
 108         char* name;
 109         int numchips;
 110         char page256;
 111         char pageadrlen;
 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) */
 116         uint eccsize;
 117         int bus16;
 118 };
 119
 120 /*
 121  * NAND Flash Manufacturer ID Codes
 122  */
 123 #define NAND_MFR_TOSHIBA        0x98
 124 #define NAND_MFR_SAMSUNG        0xec
 125
 126 /*
 127  * NAND Flash Device ID Structure
 128  *
 129  * Structure overview:
 130  *
 131  *  name - Complete name of device
 132  *
 133  *  manufacture_id - manufacturer ID code of device.
 134  *
 135  *  model_id - model ID code of device.
 136  *
 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.
 140  *
 141  *  page256 - denotes if flash device has 256 byte pages or not.
 142  *
 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.
 150  *
 151  *  erasesize - size of an erase block in the flash device.
 152  */
 153 struct nand_flash_dev {
 154         char * name;
 155         int manufacture_id;
 156         int model_id;
 157         int chipshift;
 158         char page256;
 159         char pageadrlen;
 160         unsigned long erasesize;
 161         int bus16;
 162 };
 163
 164 /*
 165 * Constants for oob configuration
 166 */
 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
 175
 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
 184
 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
 189
 190 unsigned long nand_probe(unsigned long physadr);
 191 #endif /* __LINUX_MTD_NAND_LEGACY_H */