tmfat32sd.h

PNX1500上Fat32文件系统源代码

/* -------------------------------------------------------------------------- */
/* (C) Copyright 2000,2002, 2003 Koninklijke Philips Electronics N.V.,        */
/*     All rights reserved                                                    */
/*                                                                            */
/* This source code and any compilation or derivative thereof is the          */
/* proprietary information of Konlinklijke Philips Electronics N.V. and is    */
/* Confidential in nature.                                                    */
/* Under no circumstances is this software to be exposed to or placed under an*/
/* Open Source License of any type without the expressed written permission of*/
/* Koninklijke Philips Electronics N.V.                                       */
/* -------------------------------------------------------------------------- */
/* FILE NAME:    tmFat32Sd.h                                                 */
/*                                                                            */
/* DESCRIPTION:  This is the API for tmFat32 SD device driver                */
/*                                                                            */
/* DOCUMENT REF: tbd                                                          */
/* 																			  */
/* NOTES:        tbd                                                          */
/*                                                                            */
/* -------------------------------------------------------------------------- */

#ifndef _TMFAT32_SD_H_
#define _TMFAT32_SD_H_

/* -------------------------------------------------------------------------- */
/* Define extern c for C++ prototypes                                         */
/* -------------------------------------------------------------------------- */

#if defined(__cplusplus)
extern "C"{
#endif

/* -------------------------------------------------------------------------- */
/*    Types and defines:                                                      */
/* -------------------------------------------------------------------------- */

#define     TMFAT_SD_SECTORSIZE    512

/*
 * Useful information about the tmFat32 SD device driver
 */
typedef struct tmFat32_Sd
{
    tmFat32_Dev_t           common;     // Info common to all tmFat32 devices
    Bool                    installed;  // True if installed
    tmFat32_DeviceDriver_t  driver;     // Device driver info for tmFat32
    UInt32                  init_count; // One for each opened volume (partition)
    Bool                    connected;  // True if connected
    tmInstance_t            sdInstance; // tmdlSd instance
} tmFat32_Sd_t, *ptmFat32_Sd_t;

/* -------------------------------------------------------------------------- */
/*    Exported functions:                                                     */
/* -------------------------------------------------------------------------- */

//-----------------------------------------------------------------------------
// FUNCTION:    tmFat32_Sd_Install
//
// DESCRIPTION: Install SD Card tmFat32 device driver
//
// RETURN:      Pointer ptmFat32_DeviceDriver_t. Return Null on failure.
//
// NOTES:
//-----------------------------------------------------------------------------
//
ptmFat32_DeviceDriver_t
tmFat32_Sd_Install (
    UInt32     unit   // I: Unit number
    );

//-----------------------------------------------------------------------------
// FUNCTION:    tmFat32_Sd_Uninstall
//
// DESCRIPTION: Uninstall SD Card tmFat32 device driver
//
// RETURN:      void
//
// NOTES:
//-----------------------------------------------------------------------------
//
void
tmFat32_Sd_Uninstall (
    ptmFat32_DeviceDriver_t     p   // IO: Pointer to tmFat32_DeviceDriver_t structure
    );

//-----------------------------------------------------------------------------
// FUNCTION:    tmFat32_Sd_GetInfo
//
// DESCRIPTION: Get information about the Sd disk tmFat32 device driver
//
// RETURN:      void
//
// NOTES:       Return numUnits (number of units supported). No other
//              fields are set.
//-----------------------------------------------------------------------------
//
void
tmFat32_Sd_GetInfo (
    ptmFat32_Dev_t     p   // IO: Pointer to tmFat32_Dev_t structure
    );


//-----------------------------------------------------------------------------
// FUNCTION:    tmFat32_Sd_Event
//
// DESCRIPTION: USB tmFat32 device event notification
//
// RETURN:      tmErrorCode_t: Status of operation (TM_OK = PASS)
//
// NOTES:       This function is called whenever an SD device is inserted
//              or removed. It must be called by the application after a device
//              is inserted but before the application mounts a tmFat32 file
//              system with tmFat32_Init() for this SD device. It should be
//              called by the application after a device is removed but before
//              the application dismounts a tmFat32 file system with
//              tmFat32_Term(). The function passes an array of UInt32 values
//              which contain the following information:
//
//              data[0]   Event (TM_FAT32_EVENT_INSERT or TM_FAT32_EVENT_EJECT).
//              data[1]   Unit number for the SD device. First unit is 0. The
//                        tmdlSd component assumes unit 0 is the internal device
//                        and unit 1 and higher are removable devices.
//                        The following are provided for an insert event only.
//              data[2]   tmdlSd instance.
//-----------------------------------------------------------------------------
//
tmErrorCode_t
tmFat32_Sd_Event (
    UInt32     *data   // I: Pointer to data describing the event
);

/* -------------------------------------------------------------------------- */
/* End of extern c for C++ prototypes                                         */
/* -------------------------------------------------------------------------- */

#if defined(__cplusplus)
}
#endif

#endif	/* !defined(_TMFAT32_Sd_H_) */