开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 嵌入式/单片机编程 > VxWorks > 查看源码
flflash.h
资源名称：ixp425BSP.rar　[点击查看]
上传用户：luoyougen
上传日期：2008-05-12
资源大小：23136k
文件大小：9k
源码类别：

VxWorks

开发平台：

C/C++

flflash.h：源码内容
  2. /*
  3.  * $Log:   P:/user/amir/lite/vcs/flflash.h_v  $
  4.    
  5.       Rev 1.10   03 Nov 1997 16:12:52   danig
  6.    amdCmdRoutine receives FlashPTR
  7.    
  8.       Rev 1.9   28 Jul 1997 14:46:20   danig
  9.    setPowerOnCallback
  10.    
  11.       Rev 1.8   24 Jul 1997 17:55:08   amirban
  12.    FAR to FAR0
  13.    
  14.       Rev 1.7   21 Jul 1997 14:45:26   danig
  15.    No parallelLimit
  16.    
  17.       Rev 1.6   07 Jul 1997 15:23:44   amirban
  18.    Ver 2.0
  19.    
  20.       Rev 1.5   08 Jun 1997 19:19:10   danig
  21.    BIG_PAGE & FULL_PAGE
  22.    
  23.       Rev 1.4   18 May 1997 17:34:14   amirban
  24.    Defined write mode flags
  25.    
  26.       Rev 1.3   18 Aug 1996 13:47:46   amirban
  27.    Comments
  28.    
  29.       Rev 1.2   31 Jul 1996 14:29:34   amirban
  30.    New flash.erase definition
  31.    
  32.       Rev 1.1   04 Jul 1996 18:19:52   amirban
  33.    New flag field
  34.    
  35.       Rev 1.0   20 Mar 1996 13:33:20   amirban
  36.    Initial revision.
  37.  */
  39. /************************************************************************/
  40. /*                                                                      */
  41. /* FAT-FTL Lite Software Development Kit */
  42. /* Copyright (C) M-Systems Ltd. 1995-1996 */
  43. /* */
  44. /************************************************************************/
  47. #ifndef FLFLASH_H
  48. #define FLFLASH_H
  50. #ifdef __cplusplus
  51. extern "C" {
  52. #endif
  54. #include "flsocket.h"
  56. /* Some useful types for mapped Flash locations */
  58. typedef volatile unsigned char FAR0 * FlashPTR;
  59. typedef volatile unsigned short int FAR0 * FlashWPTR;
  60. typedef volatile unsigned long FAR0 * FlashDPTR;
  62. typedef unsigned short FlashType; /* JEDEC id */
  64. #define NOT_FLASH 0
  66. /* page characteristics flags */
  67. #define  BIG_PAGE    0x0100             /* page size > 100H*/
  68. #define  FULL_PAGE  0x0200           /* no partial page programming*/
  70. /* MTD write routine mode flags */
  71. #define OVERWRITE 1 /* Overwriting non-erased area  */
  72. #define EDC 2 /* Activate ECC/EDC */
  73. #define EXTRA 4 /* Read/write spare area */
  76. /*----------------------------------------------------------------------*/
  77. /*          Flash array identification structure */
  78. /* */
  79. /* This structure contains a description of the Flash array and */
  80. /* routine pointers for the map, read, write & erase functions. */
  81. /*  */
  82. /* The structure is initialized by the MTD that identifies the Flash */
  83. /* array.                                                               */
  84. /* On entry to an MTD, the Flash structure contains default routines */
  85. /* for all operations. This routines are sufficient forread-only access */
  86. /* to NOR Flash on a memory-mapped socket. The MTD should override the */
  87. /* default routines with MTD specific ones when appropriate. */
  88. /*----------------------------------------------------------------------*/
  90. /* Flash array identification structure */
  92. typedef struct tFlash FLFlash; /* Forward definition */
  94. struct tFlash {
  95.   FlashType type; /* Flash device type (JEDEC id) */
  96.   long int erasableBlockSize; /* Smallest physically erasable size
  97.    (with interleaving taken in account) */
  98.   long int chipSize; /* chip size */
  99.   int noOfChips; /* no of chips in array */
  100.   int interleaving; /* chip interleaving
  101.    (The interleaving is defined as
  102.    the address difference between
  103.    two consecutive bytes on a chip) */
  104.   unsigned flags; /* Special capabilities & options
  105.    Bits 0-7 may be used by FLite.
  106.    Bits 8-15 are not used bt FLite
  107.    and may be used by MTD's for MTD-
  108.    specific purposes. */
  109.   void * mtdVars; /* Points to MTD private area for
  110.    this socket.
  111.    This field, if used by the MTD, is
  112.    initialized by the MTD identification
  113.    routine */
  114.   FLSocket * socket; /* Socket of this drive */
  117. /* Flag bit values */
  119. #define SUSPEND_FOR_WRITE 1 /* MTD provides suspend for write */
  120. #define NFTL_ENABLED 2 /* Flash can run NFTL */
  123. /*----------------------------------------------------------------------*/
  124. /*                 f l a s h . m a p */
  125. /* */
  126. /* MTD specific map routine */
  127. /*                                                                      */
  128. /* The default routine maps by socket mapping, and is suitable for all  */
  129. /* NOR Flash.                                                           */
  130. /* NAND or other type Flash should use map-through-copy emulation: Read */
  131. /* a block of Flash to an internal buffer and return a pointer to that */
  132. /* buffer. */
  133. /* */
  134. /* Parameters:                                                          */
  135. /* vol : Pointer identifying drive */
  136. /*      address : Card address to map */
  137. /* length : Length to map */
  138. /*                                                                      */
  139. /* Returns:                                                             */
  140. /* Pointer to required card address */
  141. /*----------------------------------------------------------------------*/
  142.   void FAR0 * (*map)(FLFlash *, CardAddress, int);
  144. /*----------------------------------------------------------------------*/
  145. /*                 f l a s h . r e a d */
  146. /* */
  147. /* MTD specific Flash read routine */
  148. /* */
  149. /* The default routine reads by copying from a mapped window, and is */
  150. /* suitable for all NOR Flash. */
  151. /* */
  152. /* Parameters:                                                          */
  153. /* vol : Pointer identifying drive */
  154. /*      address : Card address to read */
  155. /* buffer : Area to read into */
  156. /* length : Length to read */
  157. /*                                                                      */
  158. /*----------------------------------------------------------------------*/
  159.   FLStatus (*read)(FLFlash *, CardAddress, void FAR1 *, int, int);
  161. /*----------------------------------------------------------------------*/
  162. /*                       f l a s h . w r i t e */
  163. /* */
  164. /* MTD specific Flash write routine */
  165. /* */
  166. /* The default routine returns a write-protect error. */
  167. /* */
  168. /* Parameters:                                                          */
  169. /* vol : Pointer identifying drive */
  170. /*      address : Card address to write to */
  171. /*      buffer : Address of data to write */
  172. /* length : Number of bytes to write */
  173. /* modes : See write mode flags definition above */
  174. /*                                                                      */
  175. /* Returns:                                                             */
  176. /* FLStatus : 0 on success, failed otherwise */
  177. /*----------------------------------------------------------------------*/
  178.   FLStatus  (*write)(FLFlash *, CardAddress, const void FAR1 *, int, int);
  180. /*----------------------------------------------------------------------*/
  181. /*                       f l a s h . e r a s e */
  182. /* */
  183. /* Erase one or more contiguous Flash erasable blocks */
  184. /* */
  185. /* The default routine returns a write-protect error. */
  186. /* */
  187. /* Parameters:                                                          */
  188. /* vol : Pointer identifying drive */
  189. /*      firstErasableBlock : Number of first block to erase */
  190. /* numOfErasableBlocks: Number of blocks to erase */
  191. /*                                                                      */
  192. /* Returns:                                                             */
  193. /* FLStatus : 0 on success, failed otherwise */
  194. /*----------------------------------------------------------------------*/
  195.   FLStatus  (*erase)(FLFlash *, int, int);
  197. /*----------------------------------------------------------------------*/
  198. /*        f l a s h . s e t P o w e r O n C a l l b a c k */
  199. /* */
  200. /* Register power on callback routine. Default: no routine is  */
  201. /* registered. */
  202. /* */
  203. /* Parameters:                                                          */
  204. /* vol : Pointer identifying drive */
  205. /*                                                                      */
  206. /*----------------------------------------------------------------------*/
  207.   void  (*setPowerOnCallback)(FLFlash *);
  208. };
  212. /* MTD registration information */
  214. extern int noOfMTDs; /* No. of MTDs actually registered */
  216. typedef FLStatus (*MTDidentifyRoutine) (FLFlash vol);
  218. extern MTDidentifyRoutine mtdTable[];
  221. /* See interface documentation of functions in flash.c */
  223. extern void flIntelIdentify(FLFlash *, 
  224.                             void (*)(FLFlash *, CardAddress, unsigned char, FlashPTR), 
  225.                             CardAddress);
  227. extern FLStatus flIntelSize(FLFlash *, 
  228.                             void (*)(FLFlash *, CardAddress, unsigned char, FlashPTR), 
  229.                             CardAddress);
  231. extern FLStatus flIdentifyFlash(FLSocket *socket, FLFlash *flash);
  233. #ifdef __cplusplus
  234. }
  235. #endif
  237. #endif