X-Git-Url: https://codewiz.org/gitweb?a=blobdiff_plain;f=bertos%2Ffs%2Ffat.h;h=3e7dc787a1a8da95b1d4ee127640ab4fde373947;hb=aea9c54dbb7ea4b957f675ffee7266e0432cfd42;hp=e407c1ba6890b8612e15c8d2787809a6a3e1e02f;hpb=4dd546b5af72301784b05bd2ea7e6ffeb4475c87;p=bertos.git

diff --git a/bertos/fs/fat.h b/bertos/fs/fat.h
index e407c1ba..3e7dc787 100644
--- a/bertos/fs/fat.h
+++ b/bertos/fs/fat.h
@@ -32,6 +32,9 @@
  *
  * \brief FatFS: kfile interface for FatFS module by ChaN.
  *
+ * This driver needs some low level hardware access functions. An example implementation
+ * is provided in sd.h.
+ *
  * \version $Id$
  *
  * \author Luca Ottaviano <lottaviano@develer.com>
@@ -46,7 +49,7 @@
 #define FS_FAT_H
 
 #include <kern/kfile.h>
-#include "fatfs/src/ff.h"
+#include "fatfs/ff.h"
 
 typedef struct FatFile
 {
@@ -65,6 +68,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);