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

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

VxWorks

开发平台：

C/C++

flsocket.h：源码内容
  2. /*
  3.  * $Log:   P:/user/amir/lite/vcs/flsocket.h_v  $
  4.    
  5.       Rev 1.11   28 Sep 1997 18:23:28   danig
  6.    flExitSocket 
  7.    
  8.       Rev 1.10   10 Sep 1997 16:16:20   danig
  9.    Got rid of generic names
  10.    
  11.       Rev 1.9   28 Aug 1997 17:48:04   danig
  12.    Buffer & remapped per socket
  13.    
  14.       Rev 1.8   24 Jul 1997 18:05:24   amirban
  15.    FAR to FAR0
  16.    
  17.       Rev 1.7   20 Jul 1997 17:16:28   amirban
  18.    No watchDogTimer
  19.    
  20.       Rev 1.6   07 Jul 1997 15:23:46   amirban
  21.    Ver 2.0
  22.    
  23.       Rev 1.5   08 Jun 1997 17:03:16   amirban
  24.    power on callback
  25.    
  26.       Rev 1.4   08 Oct 1996 12:17:34   amirban
  27.    Defined remapped
  28.    
  29.       Rev 1.3   18 Aug 1996 13:47:44   amirban
  30.    Comments
  31.    
  32.       Rev 1.2   12 Aug 1996 15:47:42   amirban
  33.    Changed value of UNDEF_MAPPING
  34.    
  35.       Rev 1.1   31 Jul 1996 14:29:08   amirban
  36.    Defined set/getMappingContext
  38.       Rev 1.0   20 Mar 1996 13:33:20   amirban
  39.    Initial revision.
  40.  */
  42. /************************************************************************/
  43. /*                                                                      */
  44. /* FAT-FTL Lite Software Development Kit */
  45. /* Copyright (C) M-Systems Ltd. 1995-1996 */
  46. /* */
  47. /************************************************************************/
  50. #ifndef FLSOCKET_H
  51. #define FLSOCKET_H
  53. #ifdef __cplusplus
  54. extern "C" {
  55. #endif
  57. #include "flbase.h"
  58. #include "flbuffer.h"
  60. #define ATTRIBUTE_SPACE_MAPPED 0x8000
  62. typedef enum {PowerOff, PowerGoingOff, PowerOn} PowerState;
  65. /* Socket state variables */
  66. typedef struct tSocket FLSocket; /* Forward definition */
  68. struct tSocket {
  69.   unsigned volNo; /* Volume no. of socket */
  70.   unsigned  serialNo;  /* Serial no. of socket on controller */
  72.   FLBoolean cardChanged; /* need media change notification */
  74.   int  VccUsers; /* No. of current VCC users */
  75.   int  VppUsers; /* No. of current VPP users */
  77.   PowerState VccState; /* Actual VCC state */
  78.   PowerState VppState; /* Actual VPP state */
  80.   FLBoolean remapped;       /* set to TRUE whenever the socket window is moved */
  82.   void (*powerOnCallback)(void *flash); /* Notification routine for Vcc on */
  83.   void * flash; /* Flash object for callback */
  85.   struct {                      /* Window state */
  86.     unsigned int baseAddress; /* Physical base as a 4K page */
  87.     unsigned int currentPage; /* Our current window page mapping */
  88.     void FAR0 * base; /* Pointer to window base */
  89.     long int size;           /* Window size (must by power of 2) */
  90.     unsigned speed; /* in nsec. */
  91.     unsigned  busWidth; /* 8 or 16 bits */
  92.   } window;
  94. /*----------------------------------------------------------------------*/
  95. /*                 c a r d D e t e c t e d */
  96. /* */
  97. /* Detect if a card is present (inserted) */
  98. /* */
  99. /* Parameters:                                                          */
  100. /* vol : Pointer identifying drive */
  101. /*                                                                      */
  102. /* Returns:                                                             */
  103. /* 0 = card not present, other = card present */
  104. /*----------------------------------------------------------------------*/
  105.   FLBoolean (*cardDetected)(FLSocket vol);
  107. /*----------------------------------------------------------------------*/
  108. /*                      V c c O n */
  109. /* */
  110. /* Turns on Vcc (3.3/5 Volts). Vcc must be known to be good on exit. */
  111. /* */
  112. /* Parameters:                                                          */
  113. /* vol : Pointer identifying drive */
  114. /*                                                                      */
  115. /*----------------------------------------------------------------------*/
  116.   void (*VccOn)(FLSocket vol);
  118. /*----------------------------------------------------------------------*/
  119. /*                    V c c O f f */
  120. /* */
  121. /* Turns off Vcc. */
  122. /* */
  123. /* Parameters:                                                          */
  124. /* vol : Pointer identifying drive */
  125. /*                                                                      */
  126. /*----------------------------------------------------------------------*/
  127.   void (*VccOff)(FLSocket vol);
  129. #ifdef SOCKET_12_VOLTS
  131. /*----------------------------------------------------------------------*/
  132. /*                      V p p O n */
  133. /* */
  134. /* Turns on Vpp (12 Volts. Vpp must be known to be good on exit. */
  135. /* */
  136. /* Parameters:                                                          */
  137. /* vol : Pointer identifying drive */
  138. /*                                                                      */
  139. /* Returns:                                                             */
  140. /* FLStatus : 0 on success, failed otherwise */
  141. /*----------------------------------------------------------------------*/
  142.   FLStatus (*VppOn)(FLSocket vol);
  145. /*----------------------------------------------------------------------*/
  146. /*                    V p p O f f */
  147. /* */
  148. /* Turns off Vpp. */
  149. /* */
  150. /* Parameters:                                                          */
  151. /* vol : Pointer identifying drive */
  152. /*                                                                      */
  153. /*----------------------------------------------------------------------*/
  154.   void (*VppOff)(FLSocket vol);
  156. #endif /* SOCKET_12_VOLTS */
  158. /*----------------------------------------------------------------------*/
  159. /*                 i n i t S o c k e t         */
  160. /* */
  161. /* Perform all necessary initializations of the socket or controller */
  162. /* */
  163. /* Parameters:                                                          */
  164. /* vol : Pointer identifying drive */
  165. /*                                                                      */
  166. /* Returns:                                                             */
  167. /* FLStatus : 0 on success, failed otherwise */
  168. /*----------------------------------------------------------------------*/
  169.   FLStatus (*initSocket)(FLSocket vol);
  171. /*----------------------------------------------------------------------*/
  172. /*                   s e t W i n d o w */
  173. /* */
  174. /* Sets in hardware all current window parameters: Base address, size,  */
  175. /* speed and bus width. */
  176. /* The requested settings are given in the 'vol.window' structure. */
  177. /* */
  178. /* If it is not possible to set the window size requested in */
  179. /* 'vol.window.size', the window size should be set to a larger value, */
  180. /* if possible. In any case, 'vol.window.size' should contain the */
  181. /* actual window size (in 4 KB units) on exit. */
  182. /* */
  183. /* Parameters:                                                          */
  184. /* vol : Pointer identifying drive */
  185. /*                                                                      */
  186. /*----------------------------------------------------------------------*/
  187.   void (*setWindow)(FLSocket vol);
  190. /*----------------------------------------------------------------------*/
  191. /*          s e t M a p p i n g C o n t e x t */
  192. /* */
  193. /* Sets the window mapping register to a card address. */
  194. /* */
  195. /* The window should be set to the value of 'vol.window.currentPage', */
  196. /* which is the card address divided by 4 KB. An address over 128KB, */
  197. /* (page over 32K) specifies an attribute-space address. */
  198. /* */
  199. /* The page to map is guaranteed to be on a full window-size boundary. */
  200. /* */
  201. /* Parameters:                                                          */
  202. /* vol : Pointer identifying drive */
  203. /*                                                                      */
  204. /*----------------------------------------------------------------------*/
  205.   void (*setMappingContext)(FLSocket vol, unsigned page);
  207. /*----------------------------------------------------------------------*/
  208. /*       g e t A n d C l e a r C a r d C h a n g e I n d i c a t o r    */
  209. /* */
  210. /* Returns the hardware card-change indicator and clears it if set. */
  211. /* */
  212. /* Parameters:                                                          */
  213. /* vol : Pointer identifying drive */
  214. /*                                                                      */
  215. /* Returns:                                                             */
  216. /* 0 = Card not changed, other = card changed */
  217. /*----------------------------------------------------------------------*/
  218.   FLBoolean (*getAndClearCardChangeIndicator)(FLSocket vol);
  220. /*----------------------------------------------------------------------*/
  221. /*                 w r i t e P r o t e c t e d */
  222. /* */
  223. /* Returns the write-protect state of the media */
  224. /* */
  225. /* Parameters:                                                          */
  226. /* vol : Pointer identifying drive */
  227. /*                                                                      */
  228. /* Returns:                                                             */
  229. /* 0 = not write-protected, other = write-protected */
  230. /*----------------------------------------------------------------------*/
  231.   FLBoolean (*writeProtected)(FLSocket vol);
  233. /*----------------------------------------------------------------------*/
  234. /*                 f r e e S o c k e t */
  235. /* */
  236. /* Free resources that were allocated for this socket. */
  237. /* This function is called when FLite exits. */
  238. /* */
  239. /* Parameters:                                                          */
  240. /* vol : Pointer identifying drive */
  241. /*                                                                      */
  242. /*----------------------------------------------------------------------*/
  243. #ifdef EXIT
  244.   void (*freeSocket)(FLSocket vol);
  245. #endif
  246. };
  249. #define UNDEFINED_MAPPING 0x7fff
  251. typedef unsigned long CardAddress; /* Physical offset on card */
  253. /* See interface documentation of functions in socket.c */
  255. extern FLStatus flInitSockets(void);
  257. #ifdef EXIT
  258. extern void flExitSocket(FLSocket *);
  259. #endif
  261. extern unsigned flSocketNoOf(const FLSocket *);
  262. extern FLSocket * flSocketOf(unsigned volNo);
  263. extern FLBuffer *flBufferOf(unsigned volNo);
  265. extern void flNeedVcc(FLSocket *);
  266. extern void flDontNeedVcc(FLSocket *);
  267. #ifdef SOCKET_12_VOLTS
  268. extern FLStatus flNeedVpp(FLSocket *);
  269. extern void flDontNeedVpp(FLSocket *);
  270. #endif
  271. extern void flSocketSetBusy(FLSocket *, FLBoolean); /* entry/exit operations */
  272. extern FLBoolean  flWriteProtected(FLSocket *); /* write-protection status */
  273. #ifndef FIXED_MEDIA
  274. extern FLStatus flMediaCheck(FLSocket *); /* check for media status change */
  275. extern void flResetCardChanged(FLSocket *);
  276. #endif
  277. extern unsigned flGetMappingContext(FLSocket *);  /* Currently mapped 4KB page */
  278. extern void FAR0 *flMap(FLSocket *, CardAddress); /* map and point at card address */
  279. extern void flSetWindowBusWidth(FLSocket *, unsigned); /* set window data-path */
  280. extern void flSetWindowSpeed(FLSocket *, unsigned); /* set window speed (nsec.) */
  281. extern void flSetWindowSize(FLSocket *, unsigned); /* in 4KB units */
  283. extern void flSetPowerOnCallback(FLSocket *, void (*)(void *), void *);
  284. /* Set MTD notification for socket power on */
  285. extern void  flIntervalRoutine(FLSocket *); /* socket interval routine */
  288. extern unsigned noOfDrives; /* No. of drives actually registered */
  290. /* The milliseconds counter is active when socket polling is enabled. When
  291.    the socket interval routine is called, the counter is incremented by
  292.    the interval in milliseconds.
  293.    The counter can be used to avoid getting in a loop that is not guaranteed
  294.    to terminate (such as waiting for a flash status register). Save the counter
  295.    at entry to the loop, and check in the loop the amount of time that
  296.    was spent in the loop. */
  298. extern unsigned long  flMsecCounter;
  300. #ifdef __cplusplus
  301. }
  302. #endif
  304. #endif