X-Git-Url: https://codewiz.org/gitweb?a=blobdiff_plain;f=bertos%2Ffs%2Ffat.h;h=df748d5b0147928cb3a8417443bf0269dd883fa6;hb=e8b0472be10fba4ca6baa62d8d483db90e28c06e;hp=77d046eeb9ae8aa58b6398556fccc290ea4d6f20;hpb=b65e60edaa04a0d0bec335198d7cf2279f3a22ae;p=bertos.git

diff --git a/bertos/fs/fat.h b/bertos/fs/fat.h
index 77d046ee..df748d5b 100644
--- a/bertos/fs/fat.h
+++ b/bertos/fs/fat.h
@@ -32,16 +32,23 @@
  *
  * \brief FatFS: kfile interface for FatFS module by ChaN.
  *
- * \version $Id$
+ * This driver needs some low level hardware access functions. An example implementation
+ * is provided in sd.h.
+ *
  *
  * \author Luca Ottaviano <lottaviano@develer.com>
  *
+ * $WIZ$ module_name = "fat"
+ * $WIZ$ module_configuration = "bertos/cfg/cfg_fat.h"
+ * $WIZ$ module_depends = "kfile", "ff", "diskio"
+ *
  */
+
 #ifndef FS_FAT_H
 #define FS_FAT_H
 
-#include <kern/kfile.h>
-#include "fatfs/src/ff.h"
+#include <io/kfile.h>
+#include "fatfs/ff.h"
 
 typedef struct FatFile
 {
@@ -60,6 +67,16 @@ INLINE FatFile * FATFILE_CAST(KFile *fd)
 
 /**
  * Initialize \a file and open \a file_path for reading.
+ *
+ * \a mode is a OR combination of various flags, you can use \a FA_READ for
+ * read access or \a FA_WRITE for write access.
+ * The function returns \a FR_OK if success, other values (defined in ff.h) in case
+ * of failure.
+ *
+ * \param file A pointer to a FatFile structure.
+ * \param file_path The file path on the filesystem.
+ * \param mode Open mode for the file, which can be OR'ed together
+ * \sa ff.h for return code meaning and \a mode flags.
  */
 FRESULT fatfile_open(FatFile *file, const char *file_path, BYTE mode);