1 /*------------------------------------------------------------------------*/
2 /* A Sample Code of User Provided OS Dependent Functions for FatFs */
3 /*------------------------------------------------------------------------*/
4
5 #include "ff.h"
6
7
8 #if FF_USE_LFN == 3 /* Use dynamic memory allocation */
9
10 /*------------------------------------------------------------------------*/
11 /* Allocate/Free a Memory Block */
12 /*------------------------------------------------------------------------*/
13
14 #include <stdlib.h> /* with POSIX API */
15
16
ff_memalloc(UINT msize)17 void* ff_memalloc ( /* Returns pointer to the allocated memory block (null if not enough core) */
18 UINT msize /* Number of bytes to allocate */
19 )
20 {
21 return malloc((size_t)msize); /* Allocate a new memory block */
22 }
23
24
ff_memfree(void * mblock)25 void ff_memfree (
26 void* mblock /* Pointer to the memory block to free (no effect if null) */
27 )
28 {
29 free(mblock); /* Free the memory block */
30 }
31
32 #endif
33
34
35
36
37 #if FF_FS_REENTRANT /* Mutal exclusion */
38 /*------------------------------------------------------------------------*/
39 /* Definitions of Mutex */
40 /*------------------------------------------------------------------------*/
41
42 #define OS_TYPE 0 /* 0:Win32, 1:uITRON4.0, 2:uC/OS-II, 3:FreeRTOS, 4:CMSIS-RTOS */
43
44
45 #if OS_TYPE == 0 /* Win32 */
46 #include <windows.h>
47 static HANDLE Mutex[FF_VOLUMES + 1]; /* Table of mutex handle */
48
49 #elif OS_TYPE == 1 /* uITRON */
50 #include "itron.h"
51 #include "kernel.h"
52 static mtxid Mutex[FF_VOLUMES + 1]; /* Table of mutex ID */
53
54 #elif OS_TYPE == 2 /* uc/OS-II */
55 #include "includes.h"
56 static OS_EVENT *Mutex[FF_VOLUMES + 1]; /* Table of mutex pinter */
57
58 #elif OS_TYPE == 3 /* FreeRTOS */
59 #include "FreeRTOS.h"
60 #include "semphr.h"
61 static SemaphoreHandle_t Mutex[FF_VOLUMES + 1]; /* Table of mutex handle */
62
63 #elif OS_TYPE == 4 /* CMSIS-RTOS */
64 #include "cmsis_os.h"
65 static osMutexId Mutex[FF_VOLUMES + 1]; /* Table of mutex ID */
66
67 #endif
68
69
70
71 /*------------------------------------------------------------------------*/
72 /* Create a Mutex */
73 /*------------------------------------------------------------------------*/
74 /* This function is called in f_mount function to create a new mutex
75 / or semaphore for the volume. When a 0 is returned, the f_mount function
76 / fails with FR_INT_ERR.
77 */
78
ff_mutex_create(int vol)79 int ff_mutex_create ( /* Returns 1:Function succeeded or 0:Could not create the mutex */
80 int vol /* Mutex ID: Volume mutex (0 to FF_VOLUMES - 1) or system mutex (FF_VOLUMES) */
81 )
82 {
83 #if OS_TYPE == 0 /* Win32 */
84 Mutex[vol] = CreateMutex(NULL, FALSE, NULL);
85 return (int)(Mutex[vol] != INVALID_HANDLE_VALUE);
86
87 #elif OS_TYPE == 1 /* uITRON */
88 T_CMTX cmtx = {TA_TPRI,1};
89
90 Mutex[vol] = acre_mtx(&cmtx);
91 return (int)(Mutex[vol] > 0);
92
93 #elif OS_TYPE == 2 /* uC/OS-II */
94 OS_ERR err;
95
96 Mutex[vol] = OSMutexCreate(0, &err);
97 return (int)(err == OS_NO_ERR);
98
99 #elif OS_TYPE == 3 /* FreeRTOS */
100 Mutex[vol] = xSemaphoreCreateMutex();
101 return (int)(Mutex[vol] != NULL);
102
103 #elif OS_TYPE == 4 /* CMSIS-RTOS */
104 osMutexDef(cmsis_os_mutex);
105
106 Mutex[vol] = osMutexCreate(osMutex(cmsis_os_mutex));
107 return (int)(Mutex[vol] != NULL);
108
109 #endif
110 }
111
112
113 /*------------------------------------------------------------------------*/
114 /* Delete a Mutex */
115 /*------------------------------------------------------------------------*/
116 /* This function is called in f_mount function to delete a mutex or
117 / semaphore of the volume created with ff_mutex_create function.
118 */
119
ff_mutex_delete(int vol)120 void ff_mutex_delete ( /* Returns 1:Function succeeded or 0:Could not delete due to an error */
121 int vol /* Mutex ID: Volume mutex (0 to FF_VOLUMES - 1) or system mutex (FF_VOLUMES) */
122 )
123 {
124 #if OS_TYPE == 0 /* Win32 */
125 CloseHandle(Mutex[vol]);
126
127 #elif OS_TYPE == 1 /* uITRON */
128 del_mtx(Mutex[vol]);
129
130 #elif OS_TYPE == 2 /* uC/OS-II */
131 OS_ERR err;
132
133 OSMutexDel(Mutex[vol], OS_DEL_ALWAYS, &err);
134
135 #elif OS_TYPE == 3 /* FreeRTOS */
136 vSemaphoreDelete(Mutex[vol]);
137
138 #elif OS_TYPE == 4 /* CMSIS-RTOS */
139 osMutexDelete(Mutex[vol]);
140
141 #endif
142 }
143
144
145 /*------------------------------------------------------------------------*/
146 /* Request a Grant to Access the Volume */
147 /*------------------------------------------------------------------------*/
148 /* This function is called on enter file functions to lock the volume.
149 / When a 0 is returned, the file function fails with FR_TIMEOUT.
150 */
151
ff_mutex_take(int vol)152 int ff_mutex_take ( /* Returns 1:Succeeded or 0:Timeout */
153 int vol /* Mutex ID: Volume mutex (0 to FF_VOLUMES - 1) or system mutex (FF_VOLUMES) */
154 )
155 {
156 #if OS_TYPE == 0 /* Win32 */
157 return (int)(WaitForSingleObject(Mutex[vol], FF_FS_TIMEOUT) == WAIT_OBJECT_0);
158
159 #elif OS_TYPE == 1 /* uITRON */
160 return (int)(tloc_mtx(Mutex[vol], FF_FS_TIMEOUT) == E_OK);
161
162 #elif OS_TYPE == 2 /* uC/OS-II */
163 OS_ERR err;
164
165 OSMutexPend(Mutex[vol], FF_FS_TIMEOUT, &err));
166 return (int)(err == OS_NO_ERR);
167
168 #elif OS_TYPE == 3 /* FreeRTOS */
169 return (int)(xSemaphoreTake(Mutex[vol], FF_FS_TIMEOUT) == pdTRUE);
170
171 #elif OS_TYPE == 4 /* CMSIS-RTOS */
172 return (int)(osMutexWait(Mutex[vol], FF_FS_TIMEOUT) == osOK);
173
174 #endif
175 }
176
177
178
179 /*------------------------------------------------------------------------*/
180 /* Release a Grant to Access the Volume */
181 /*------------------------------------------------------------------------*/
182 /* This function is called on leave file functions to unlock the volume.
183 */
184
ff_mutex_give(int vol)185 void ff_mutex_give (
186 int vol /* Mutex ID: Volume mutex (0 to FF_VOLUMES - 1) or system mutex (FF_VOLUMES) */
187 )
188 {
189 #if OS_TYPE == 0 /* Win32 */
190 ReleaseMutex(Mutex[vol]);
191
192 #elif OS_TYPE == 1 /* uITRON */
193 unl_mtx(Mutex[vol]);
194
195 #elif OS_TYPE == 2 /* uC/OS-II */
196 OSMutexPost(Mutex[vol]);
197
198 #elif OS_TYPE == 3 /* FreeRTOS */
199 xSemaphoreGive(Mutex[vol]);
200
201 #elif OS_TYPE == 4 /* CMSIS-RTOS */
202 osMutexRelease(Mutex[vol]);
203
204 #endif
205 }
206
207 #endif /* FF_FS_REENTRANT */
208
209
