X-Git-Url: https://codewiz.org/gitweb?a=blobdiff_plain;f=bertos%2Ffs%2Ffat.h;h=df748d5b0147928cb3a8417443bf0269dd883fa6;hb=6fffd0614f75137e8fed424c87835d4e7d478ef7;hp=d0da925d75ce113595837ea92513bd0592b2db89;hpb=efcdac5c593b00b2ff79bb6a92849c7ee9358bb3;p=bertos.git

diff --git a/bertos/fs/fat.h b/bertos/fs/fat.h
index d0da925d..df748d5b 100644
--- a/bertos/fs/fat.h
+++ b/bertos/fs/fat.h
@@ -32,20 +32,22 @@
  *
  * \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"
+ * $WIZ$ module_depends = "kfile", "ff", "diskio"
  *
  */
 
 #ifndef FS_FAT_H
 #define FS_FAT_H
 
-#include <kern/kfile.h>
+#include <io/kfile.h>
 #include "fatfs/ff.h"
 
 typedef struct FatFile
@@ -65,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);