Import fatfs R0.15

[z180-stamp.git] / fatfs / source / ffsystem.c

/*------------------------------------------------------------------------*/\r
/* A Sample Code of User Provided OS Dependent Functions for FatFs        */\r
/*------------------------------------------------------------------------*/\r
\r
#include "ff.h"\r
\r
\r
#if FF_USE_LFN == 3	/* Use dynamic memory allocation */\r
\r
/*------------------------------------------------------------------------*/\r
/* Allocate/Free a Memory Block                                           */\r
/*------------------------------------------------------------------------*/\r
\r
#include <stdlib.h>		/* with POSIX API */\r
\r
\r
void* ff_memalloc (	/* Returns pointer to the allocated memory block (null if not enough core) */\r
	UINT msize		/* Number of bytes to allocate */\r
)\r
{\r
	return malloc((size_t)msize);	/* Allocate a new memory block */\r
}\r
\r
\r
void ff_memfree (\r
	void* mblock	/* Pointer to the memory block to free (no effect if null) */\r
)\r
{\r
	free(mblock);	/* Free the memory block */\r
}\r
\r
#endif\r
\r
\r
\r
\r
#if FF_FS_REENTRANT	/* Mutal exclusion */\r
/*------------------------------------------------------------------------*/\r
/* Definitions of Mutex                                                   */\r
/*------------------------------------------------------------------------*/\r
\r
#define OS_TYPE	0	/* 0:Win32, 1:uITRON4.0, 2:uC/OS-II, 3:FreeRTOS, 4:CMSIS-RTOS */\r
\r
\r
#if   OS_TYPE == 0	/* Win32 */\r
#include <windows.h>\r
static HANDLE Mutex[FF_VOLUMES + 1];	/* Table of mutex handle */\r
\r
#elif OS_TYPE == 1	/* uITRON */\r
#include "itron.h"\r
#include "kernel.h"\r
static mtxid Mutex[FF_VOLUMES + 1];		/* Table of mutex ID */\r
\r
#elif OS_TYPE == 2	/* uc/OS-II */\r
#include "includes.h"\r
static OS_EVENT *Mutex[FF_VOLUMES + 1];	/* Table of mutex pinter */\r
\r
#elif OS_TYPE == 3	/* FreeRTOS */\r
#include "FreeRTOS.h"\r
#include "semphr.h"\r
static SemaphoreHandle_t Mutex[FF_VOLUMES + 1];	/* Table of mutex handle */\r
\r
#elif OS_TYPE == 4	/* CMSIS-RTOS */\r
#include "cmsis_os.h"\r
static osMutexId Mutex[FF_VOLUMES + 1];	/* Table of mutex ID */\r
\r
#endif\r
\r
\r
\r
/*------------------------------------------------------------------------*/\r
/* Create a Mutex                                                         */\r
/*------------------------------------------------------------------------*/\r
/* This function is called in f_mount function to create a new mutex\r
/  or semaphore for the volume. When a 0 is returned, the f_mount function\r
/  fails with FR_INT_ERR.\r
*/\r
\r
int ff_mutex_create (	/* Returns 1:Function succeeded or 0:Could not create the mutex */\r
	int vol				/* Mutex ID: Volume mutex (0 to FF_VOLUMES - 1) or system mutex (FF_VOLUMES) */\r
)\r
{\r
#if OS_TYPE == 0	/* Win32 */\r
	Mutex[vol] = CreateMutex(NULL, FALSE, NULL);\r
	return (int)(Mutex[vol] != INVALID_HANDLE_VALUE);\r
\r
#elif OS_TYPE == 1	/* uITRON */\r
	T_CMTX cmtx = {TA_TPRI,1};\r
\r
	Mutex[vol] = acre_mtx(&cmtx);\r
	return (int)(Mutex[vol] > 0);\r
\r
#elif OS_TYPE == 2	/* uC/OS-II */\r
	OS_ERR err;\r
\r
	Mutex[vol] = OSMutexCreate(0, &err);\r
	return (int)(err == OS_NO_ERR);\r
\r
#elif OS_TYPE == 3	/* FreeRTOS */\r
	Mutex[vol] = xSemaphoreCreateMutex();\r
	return (int)(Mutex[vol] != NULL);\r
\r
#elif OS_TYPE == 4	/* CMSIS-RTOS */\r
	osMutexDef(cmsis_os_mutex);\r
\r
	Mutex[vol] = osMutexCreate(osMutex(cmsis_os_mutex));\r
	return (int)(Mutex[vol] != NULL);\r
\r
#endif\r
}\r
\r
\r
/*------------------------------------------------------------------------*/\r
/* Delete a Mutex                                                         */\r
/*------------------------------------------------------------------------*/\r
/* This function is called in f_mount function to delete a mutex or\r
/  semaphore of the volume created with ff_mutex_create function.\r
*/\r
\r
void ff_mutex_delete (	/* Returns 1:Function succeeded or 0:Could not delete due to an error */\r
	int vol				/* Mutex ID: Volume mutex (0 to FF_VOLUMES - 1) or system mutex (FF_VOLUMES) */\r
)\r
{\r
#if OS_TYPE == 0	/* Win32 */\r
	CloseHandle(Mutex[vol]);\r
\r
#elif OS_TYPE == 1	/* uITRON */\r
	del_mtx(Mutex[vol]);\r
\r
#elif OS_TYPE == 2	/* uC/OS-II */\r
	OS_ERR err;\r
\r
	OSMutexDel(Mutex[vol], OS_DEL_ALWAYS, &err);\r
\r
#elif OS_TYPE == 3	/* FreeRTOS */\r
	vSemaphoreDelete(Mutex[vol]);\r
\r
#elif OS_TYPE == 4	/* CMSIS-RTOS */\r
	osMutexDelete(Mutex[vol]);\r
\r
#endif\r
}\r
\r
\r
/*------------------------------------------------------------------------*/\r
/* Request a Grant to Access the Volume                                   */\r
/*------------------------------------------------------------------------*/\r
/* This function is called on enter file functions to lock the volume.\r
/  When a 0 is returned, the file function fails with FR_TIMEOUT.\r
*/\r
\r
int ff_mutex_take (	/* Returns 1:Succeeded or 0:Timeout */\r
	int vol			/* Mutex ID: Volume mutex (0 to FF_VOLUMES - 1) or system mutex (FF_VOLUMES) */\r
)\r
{\r
#if OS_TYPE == 0	/* Win32 */\r
	return (int)(WaitForSingleObject(Mutex[vol], FF_FS_TIMEOUT) == WAIT_OBJECT_0);\r
\r
#elif OS_TYPE == 1	/* uITRON */\r
	return (int)(tloc_mtx(Mutex[vol], FF_FS_TIMEOUT) == E_OK);\r
\r
#elif OS_TYPE == 2	/* uC/OS-II */\r
	OS_ERR err;\r
\r
	OSMutexPend(Mutex[vol], FF_FS_TIMEOUT, &err));\r
	return (int)(err == OS_NO_ERR);\r
\r
#elif OS_TYPE == 3	/* FreeRTOS */\r
	return (int)(xSemaphoreTake(Mutex[vol], FF_FS_TIMEOUT) == pdTRUE);\r
\r
#elif OS_TYPE == 4	/* CMSIS-RTOS */\r
	return (int)(osMutexWait(Mutex[vol], FF_FS_TIMEOUT) == osOK);\r
\r
#endif\r
}\r
\r
\r
\r
/*------------------------------------------------------------------------*/\r
/* Release a Grant to Access the Volume                                   */\r
/*------------------------------------------------------------------------*/\r
/* This function is called on leave file functions to unlock the volume.\r
*/\r
\r
void ff_mutex_give (\r
	int vol			/* Mutex ID: Volume mutex (0 to FF_VOLUMES - 1) or system mutex (FF_VOLUMES) */\r
)\r
{\r
#if OS_TYPE == 0	/* Win32 */\r
	ReleaseMutex(Mutex[vol]);\r
\r
#elif OS_TYPE == 1	/* uITRON */\r
	unl_mtx(Mutex[vol]);\r
\r
#elif OS_TYPE == 2	/* uC/OS-II */\r
	OSMutexPost(Mutex[vol]);\r
\r
#elif OS_TYPE == 3	/* FreeRTOS */\r
	xSemaphoreGive(Mutex[vol]);\r
\r
#elif OS_TYPE == 4	/* CMSIS-RTOS */\r
	osMutexRelease(Mutex[vol]);\r
\r
#endif\r
}\r
\r
#endif	/* FF_FS_REENTRANT */\r
\r