flsocket.c

该程序是一个tffs文件系统的源码

/*
 * $Log:   P:/user/amir/lite/vcs/flsocket.c_v  $
 * 
 *    Rev 1.21   09 Jan 1998 17:10:00   Hdei
 * changed MALLOC FREE to MALLOC_TFFS FREE_TFFS.
 *
 *    Rev 1.21   29 Sep 1997 14:22:36   danig
 * flExitSocket
 * 
 *    Rev 1.21   28 Sep 1997 18:24:02   danig
 * flExitSocket
 * 
 *    Rev 1.20   10 Sep 1997 16:27:54   danig
 * Got rid of generic names
 * 
 *    Rev 1.19   04 Sep 1997 16:23:36   danig
 * Debug messages
 * 
 *    Rev 1.18   28 Aug 1997 17:49:24   danig
 * Buffer & remapped per socket
 * 
 *    Rev 1.17   17 Aug 1997 15:10:48   danig
 * Turn off the card change indicator in flResetCardChanged
 * 
 *    Rev 1.16   27 Jul 1997 11:59:38   amirban
 * Socket.volNo initialization
 * 
 *    Rev 1.15   27 Jul 1997 10:12:12   amirban
 * physicalToPointer and FAR -> FAR0
 * 
 *    Rev 1.14   20 Jul 1997 17:15:38   amirban
 * No watchDogTimer
 * 
 *    Rev 1.13   07 Jul 1997 15:21:46   amirban
 * Ver 2.0
 * 
 *    Rev 1.12   08 Jun 1997 17:03:22   amirban
 * power on callback
 * 
 *    Rev 1.11   15 Apr 1997 19:13:48   danig
 * Added SOCKET_12_VOLTS before a call to vppOff.
 * 
 *    Rev 1.10   25 Nov 1996 17:23:38   danig
 * Changed doNotDisturb from Boolean to counter
 * 
 *    Rev 1.9   20 Nov 1996 16:24:34   danig
 * added remapped to socketSetBusy.
 * 
 *    Rev 1.8   08 Oct 1996 12:17:52   amirban
 * Defined remapped
 * 
 *    Rev 1.7   18 Aug 1996 13:48:38   amirban
 * Comments
 * 
 *    Rev 1.6   15 Aug 1996 11:51:16   amirban
 * Wait state mistake
 *
 *    Rev 1.5   31 Jul 1996 14:31:14   amirban
 * Background stuff, and 5V Vpp
 * 
 *    Rev 1.4   09 Jul 1996 14:36:52   amirban
 * CPU_i386 define
 * 
 *    Rev 1.3   01 Jul 1996 15:41:44   amirban
 * init for all sockets
 * 
 *    Rev 1.2   09 Jun 1996 18:16:30   amirban
 * Correction of socketSetBusy
 * 
 *    Rev 1.1   03 Jun 1996 16:20:26   amirban
 * Typo fix
 * 
 *    Rev 1.0   20 Mar 1996 13:33:06   amirban
 * Initial revision.
 */

/************************************************************************/
/*                                                                      */
/*		FAT-FTL Lite Software Development Kit			*/
/*		Copyright (C) M-Systems Ltd. 1995-1996			*/
/*									*/
/************************************************************************/


#include "flsocket.h"

unsigned noOfDrives = 0;	/* No. of drives actually registered */

static FLSocket vols[DRIVES];

#ifndef SINGLE_BUFFER
#ifdef MALLOC_TFFS
static FLBuffer *volBuffers[DRIVES];
#else
static FLBuffer volBuffers[DRIVES];
#endif
#endif

/*----------------------------------------------------------------------*/
/*      	          f l S o c k e t N o O f 			*/
/*									*/
/* Gets the volume no. connected to a socket				*/
/*									*/
/* Parameters:                                                          */
/*	vol		: Pointer identifying drive			*/
/*                                                                      */
/* Returns:                                                             */
/* 	volume no. of socket						*/
/*----------------------------------------------------------------------*/

unsigned flSocketNoOf(const FLSocket vol)
{
  return vol.volNo;
}


/*----------------------------------------------------------------------*/
/*      	          f l S o c k e t O f	   			*/
/*									*/
/* Gets the socket connected to a volume no.				*/
/*									*/
/* Parameters:                                                          */
/*	volNo		: Volume no. for which to get socket		*/
/*                                                                      */
/* Returns:                                                             */
/* 	socket of volume no.						*/
/*----------------------------------------------------------------------*/

FLSocket *flSocketOf(unsigned volNo)
{
  return &vols[volNo];
}

#ifndef SINGLE_BUFFER
/*----------------------------------------------------------------------*/
/*      	          f l B u f f e r O f	   			*/
/*									*/
/* Gets the buffer connected to a volume no.				*/
/*									*/
/* Parameters:                                                          */
/*	volNo		: Volume no. for which to get socket		*/
/*                                                                      */
/* Returns:                                                             */
/* 	buffer of volume no.						*/
/*----------------------------------------------------------------------*/

FLBuffer *flBufferOf(unsigned volNo)
{
#ifdef MALLOC_TFFS
  return volBuffers[volNo];
#else
  return &volBuffers[volNo];
#endif
}
#endif /* SINGLE_BUFFER */

/*----------------------------------------------------------------------*/
/*      	        f l W r i t e P r o t e c t e d			*/
/*									*/
/* Returns the write-protect state of the media				*/
/*									*/
/* Parameters:                                                          */
/*	vol		: Pointer identifying drive			*/
/*                                                                      */
/* Returns:                                                             */
/*	0 = not write-protected, other = write-protected		*/
/*----------------------------------------------------------------------*/

FLBoolean flWriteProtected(FLSocket vol)
{
  return vol.writeProtected(&vol);
}


#ifndef FIXED_MEDIA

/*----------------------------------------------------------------------*/
/*      	      f l R e s e t C a r d C h a n g e d		*/
/*									*/
/* Acknowledges a media-change condition and turns off the condition.	*/
/*									*/
/* Parameters:                                                          */
/*	vol		: Pointer identifying drive			*/
/*                                                                      */
/*----------------------------------------------------------------------*/

void flResetCardChanged(FLSocket vol)
{
  if (vol.getAndClearCardChangeIndicator)
      vol.getAndClearCardChangeIndicator(&vol);  /* turn off the indicator */

  vol.cardChanged = FALSE;
}


/*----------------------------------------------------------------------*/
/*      	          f l M e d i a C h e c k			*/
/*									*/
/* Checks the presence and change status of the media			*/
/*									*/
/* Parameters:                                                          */
/*	vol		: Pointer identifying drive			*/
/*                                                                      */
/* Returns:                                                             */
/* 	flOK		->	Media present and not changed		*/
/*	driveNotReady   ->	Media not present			*/
/*	diskChange	->	Media present but changed		*/
/*----------------------------------------------------------------------*/

FLStatus flMediaCheck(FLSocket vol)
{
  if (!vol.cardDetected(&vol)) {
    vol.cardChanged = TRUE;
    return flDriveNotReady;
  }

  if (vol.getAndClearCardChangeIndicator &&
      vol.getAndClearCardChangeIndicator(&vol))
    vol.cardChanged = TRUE;

  return vol.cardChanged ? flDiskChange : flOK;
}

#endif

/*----------------------------------------------------------------------*/
/*      	         f l I n i t S o c k e t s		        */
/*									*/
/* First call to this module: Initializes the controller and all sockets*/
/*									*/
/* Parameters:                                                          */
/*	vol		: Pointer identifying drive			*/
/*                                                                      */
/* Returns:                                                             */
/*	FLStatus	: 0 on success, failed otherwise		*/
/*----------------------------------------------------------------------*/

FLStatus flInitSockets(void)
{
  unsigned volNo;
  FLSocket vol = vols;

  for (volNo = 0; volNo < noOfDrives; volNo++, pVol++) {
    flSetWindowSpeed(&vol, 250);
    flSetWindowBusWidth(&vol, 16);
    flSetWindowSize(&vol, 2);		/* make it 8 KBytes */

    vol.cardChanged = FALSE;

  #ifndef SINGLE_BUFFER
  #ifdef MALLOC_TFFS
    /* allocate buffer for this socket */
    volBuffers[volNo] = (FLBuffer *)MALLOC_TFFS(sizeof(FLBuffer));
    if (volBuffers[volNo] == NULL) {
    #ifdef DEBUG_PRINT
      DEBUG_PRINT("Debug: failed allocating sector buffer.\n");
    #endif
      return flNotEnoughMemory;
    }
  #endif
  #endif

    checkStatus(vol.initSocket(&vol));

  #ifdef SOCKET_12_VOLTS
    vol.VppOff(&vol);
    vol.VppState = PowerOff;
    vol.VppUsers = 0;
  #endif
    vol.VccOff(&vol);
    vol.VccState = PowerOff;
    vol.VccUsers = 0;
  }

  return flOK;
}


/*----------------------------------------------------------------------*/
/*      	     f l G e t M a p p i n g C o n t e x t		*/
/*									*/
/* Returns the currently mapped window page (in 4KB units)		*/
/*									*/
/* Parameters:                                                          */
/*	vol		: Pointer identifying drive			*/
/*                                                                      */
/* Returns:                                                             */
/*	unsigned int	: Current mapped page no.			*/
/*----------------------------------------------------------------------*/

unsigned flGetMappingContext(FLSocket vol)
{
  return vol.window.currentPage;
}


/*----------------------------------------------------------------------*/
/*      	                f l M a p			        */
/*									*/
/* Maps the window to a specified card address and returns a pointer to */
/* that location (some offset within the window).			*/
/*									*/