diff --git a/doc/00index_e.html b/doc/00index_e.html index 33e84f5..82fc65a 100644 --- a/doc/00index_e.html +++ b/doc/00index_e.html @@ -3,8 +3,6 @@ - - ELM - FAT File System Module @@ -39,8 +37,8 @@

Application Interface

FatFs/Tiny-FatFs module provides following functions.

@@ -79,16 +83,18 @@

Resources

The FatFs/Tiny-FatFs module is a free software and is opened for education, research and development. You can use, modify and/or republish it for personal, non-profit or commercial use without any restriction under your responsibility.

-

FatFs Home Page

+

Return

diff --git a/doc/00index_j.html b/doc/00index_j.html index bd200d3..28a40e8 100644 --- a/doc/00index_j.html +++ b/doc/00index_j.html @@ -3,8 +3,6 @@ - - ELM - 汎用FATファイルシステム・モジュール @@ -22,8 +20,8 @@
  • ファイル・システム用とファイルI/O用バッファを分離し、複数ファイルの高速アクセスに適する
  • 複数ドライブ、複数パーテーションをサポート
  • FAT12, FAT16, FAT32に対応
    • -
  • 8.3形式ファイル名に対応(LFN未対応)
    • -
  • FDISKフォーマットおよびSFDフォーマットに対応
    • +
  • 8.3形式ファイル名に対応(LFNは未対応)
    • +
  • 2種類のパーテーショニング形式(FDISKおよびSFD)に対応
  • 8/16ビットマイコン向けにコードを最適化

    • Tiny-FatFsの特徴(FatFsとの相違)

    @@ -56,6 +54,11 @@
  • f_utime - ファイル/ディレクトリのタイムスタンプの変更
  • f_rename - ファイル/ディレクトリの名前変更・移動
  • f_mkfs - ディスクのフォーマット
    • +
  • f_forward - ファイル・データをストリーム関数に直接転送する
    • +
  • fgets - 文字列の読み込み
    • +
  • fputc - 文字の書き込み
    • +
  • fputs - 文字列の書き込み
    • +
  • fprintf - 書式化文字列の書き込み
    • @@ -78,16 +81,18 @@

    資料

    FatFs/Tiny-FatFsモジュールはフリー・ソフトウェアとして教育・研究・開発用に公開しています。どのような利用目的（個人・非商用・商用）でも使用・改変・配布について一切の制限はありませんが、全て利用者の責任の下での利用とします。

    -

    FatFs Home Page

    +

    戻る

    diff --git a/doc/css_e.css b/doc/css_e.css index 79f7848..9159576 100644 --- a/doc/css_e.css +++ b/doc/css_e.css @@ -38,8 +38,8 @@ p.hdd {float: right; text-align: right; margin-top: 0.5em;} hr.hds {clear: both; margin-bottom: 1em;} h2 {font-size: 1.5em; font-family: sans-serif; margin: 0 0 0.5em;} -h3 {font-size: 1.5em; font-family: sans-serif; margin: 2em 0 0.5em;} -h4 {font-size: 1.2em; font-family: sans-serif; margin: 1.5em 0 0.2em;} +h3 {font-size: 1.5em; font-family: sans-serif; margin: 1.5em 0 0.5em;} +h4 {font-size: 1.2em; font-family: sans-serif; margin: 1em 0 0.2em;} h5 {font-size: 1em; font-family: sans-serif; margin: 0.5em 0 0em;} small {font-size: 80%;} .indent {margin-left: 2em;} diff --git a/doc/css_j.css b/doc/css_j.css index a6346db..a49a2e4 100644 --- a/doc/css_j.css +++ b/doc/css_j.css @@ -2,7 +2,7 @@ /* Common style sheet for Tech Notes */ * {margin: 0; padding: 0; border-width: 0;} -body {margin: 8px; background-color: #e0ffff; font-color: black; line-height: 133%; letter-spacing: 1px; max-width: 1024px;} +body {margin: 8px; background-color: #e0ffff; font-color: black; line-height: 150%; letter-spacing: 1px; max-width: 1024px;} a:link {color: blue;} a:visited {color: darkmagenta;} a:hover {background-color: #a0ffff;} @@ -41,8 +41,8 @@ p.hdd {float: right; text-align: right; margin-top: 0.5em;} hr.hds {clear: both; margin-bottom: 1em;} h2 {font-size: 1.5em; font-family: sans-serif; margin: 0 0 0.5em;} -h3 {font-size: 1.5em; font-family: sans-serif; margin: 2em 0 0.5em;} -h4 {font-size: 1.2em; font-family: sans-serif; margin: 1.5em 0 0.2em;} +h3 {font-size: 1.5em; font-family: sans-serif; margin: 1.5em 0 0.5em;} +h4 {font-size: 1.2em; font-family: sans-serif; margin: 1em 0 0.2em;} h5 {font-size: 1em; font-family: sans-serif; margin: 0.5em 0 0em;} small {font-size: 80%;} .indent {margin-left: 2em;} diff --git a/doc/en/appnote.html b/doc/en/appnote.html index 8f63215..69ff944 100644 --- a/doc/en/appnote.html +++ b/doc/en/appnote.html @@ -24,24 +24,24 @@ These correspondence are defined in integer.h. This will not be a problem on mos
    -

    Memory Usage (R0.05a)

    +

    Memory Usage (R0.06)

    These are the memory usage on some target systems. The memory sizes are in unit of byte, D means number of logical drives and F means number of open files. All samples are optimezed in code size.

    - - - - - - - - - - - - - - - + + + + + + + + + + + + + + +
    AVRH8/300HPICMSP430TLCS-870/CV850ESSH2
    CompilergccCH38C30(gcc)CL430CC870CCA850SHC
    _MCU_ENDIAN1222112
    FatFs Code
    (Full, R/W)    		91469218915566627430
    FatFs Code
    (Minimum, R/W)    		58245756586140964710
    FatFs Code
    (Full, R/O)    		42684116418729863382
    FatFs Code
    (Minimum, R/O)    		30763134314322002610
    FatFs Work (Static)D*2+2D*4+2D*2+2D*4+2D*4+2
    FatFs Work (Dynamic)D*554+F*544D*554+F*550D*554+F*544D*554+F*550D*554+F*550
    Tiny-FatFs Code
    (Full, R/W)    		7566762673716894931459266580
    Tiny-FatFs Code
    (Minimum, R/W)    		4730481446834306628536704236
    Tiny-FatFs Code
    (Full, R/O)    		3564353235223226438926783022
    Tiny-FatFs Code
    (Minimum, R/O)    		2554267425952372337618562300
    Tiny-FatFs Wrok (Static)4644466
    Tiny-FatFs Work (Dynamic)544+F*28544+F*32544+F*28544+F*28544+F*28544+F*32544+F*32
    AVRH8/300HPICMSP430TLCS-870/CV850ESSH2ARM7
    Compilergcc(WinAVR)CH38gcc(C30)CL430CC870CCA850SHCgcc(WinARM)
    _MCU_ENDIAN12221122
    FatFs Code (Full, R/W)9280934893876728753811820
    FatFs Code (Min, R/W)58145798591340944742
    FatFs Code (Full, R/O)44024236437130543474
    FatFs Code (Min, R/O)30663158321321722630
    FatFs Work (Static)D*2+2D*4+2D*2+2D*4+2D*4+2
    FatFs Work (Dynamic)D*554+F*544D*554+F*550D*554+F*544D*554+F*550D*554+F*550D*554+F*550
    Tiny-FatFs Code (Full, R/W)7628766875607108950159786640
    Tiny-FatFs Code (Min, R/W)4684482046984390632236784236
    Tiny-FatFs Code (Full, R/O)3634360036183382455427223072
    Tiny-FatFs Code (Min, R/O)2524270026012398339018622300
    Tiny-FatFs Wrok (Static)4644466
    Tiny-FatFs Work (Dynamic)544+F*28544+F*32544+F*28544+F*28544+F*28544+F*32544+F*32544+F*32
    @@ -111,7 +111,7 @@ Currently the file object structure is held by application layer. This is not a
  • Efficient sector buffer management
    The FatFs module has only one sector buffer per logical drive. There is an ineffciency on random file access with many files simultanesously. When additional memory for the sector buffer is available, the file access performance will able to be improved with an advanced cache mechanism.
  • Long file name
    -There is an extended feature to handle long file name (LFN) up to 255 characters, in addition to 8.3 format file name, on FAT file system. To support this, 512 byte string buffer for file name and UCS-2 - Shift_JIS mutual conversion table are required. Therefore memory consumption of code and work area will be increased drastically. The FatFs module does not support this feature. The LFN on the FAT file system is a patent of Microsoft. When support it on the commercial products, you have to be licensed.
    • +There is an extended feature to handle long file name (LFN) up to 255 characters in addition to 8.3 format file name on the FAT file system. To support this feature, 512 byte string buffer for file name and Unicode - Local code mutual conversion table which occupies 256KB is required. Therefore memory consumption of code and work area will be increased drastically. The FatFs module currently does not support this feature. The LFN on the FAT file system is a patent of Microsoft. When use it on the commercial products, you have to be licensed.
  • Porting to RTOS
    When use FatFs module from only one task, no consideration is needed. However when make access to a logical drive from two or more tasks simultanesously, any exclusion control will be required. The FatFs module is also ported to a free RTOS based on μITRON by TOPPERS Project.
    • diff --git a/doc/en/chmod.html b/doc/en/chmod.html index 88758d4..c587dbf 100644 --- a/doc/en/chmod.html +++ b/doc/en/chmod.html @@ -23,18 +23,18 @@ FRESULT f_chmod (
    -

    Parameter

    +

    Parameters

    FileName
    Pointer to the null-terminated string that specifies a file or directory to be changed
    Attribute
    Attribute flags to be set in one or more combination of the following flags. The specified flags are set and others are cleard.
    - - - - - + + + + +
    AttributeDescription
    AM_RDORead only
    AM_ARCArchive
    AM_SYSSystem
    AM_HIDHidden
    AttributeDescription
    AM_RDORead only
    AM_ARCArchive
    AM_SYSSystem
    AM_HIDHidden
    AttributeMask
    diff --git a/doc/en/dinit.html b/doc/en/dinit.html index 939e505..f488b01 100644 --- a/doc/en/dinit.html +++ b/doc/en/dinit.html @@ -21,7 +21,7 @@ DSTATUS disk_initialize (
    -

    Parameters

    +

    Parameter

    Drive
    Specifies the physical drive number to initialize.
    diff --git a/doc/en/dioctl.html b/doc/en/dioctl.html index 3536040..aa19c4a 100644 --- a/doc/en/dioctl.html +++ b/doc/en/dioctl.html @@ -53,9 +53,10 @@ DRESULT disk_ioctl (

    Description

    The FatFs module uses only device independent commands described below. Any device dependent function is not used.

    +

    In read-only configuration, the disk_ioctl function is not needed.

    - - + +
    CommandDescription
    CTRL_SYNCMake sure that the disk drive has finished pending write process. When the disk I/O module has a write back cache, flush the dirty sector immediately. In read-only configuration, this command is not needed.
    CommandDescription
    CTRL_SYNCMake sure that the disk drive has finished pending write process. When the disk I/O module has a write back cache, flush the dirty sector immediately.
    GET_SECTOR_COUNTReturns total sectors on the drive into the DWORD variable pointed by Buffer. This command is used in only f_mkfs function.
    GET_BLOCK_SIZEReturns erase block size of the memory array in unit of sector into the DWORD variable pointed by Buffer. When the erase block size is unknown or magnetic disk device, return 1. This command is used in only f_mkfs function.
    diff --git a/doc/en/dread.html b/doc/en/dread.html index 8766939..d0f1015 100644 --- a/doc/en/dread.html +++ b/doc/en/dread.html @@ -17,7 +17,7 @@ DRESULT disk_read ( BYTE Drive, /* Physical drive number */ BYTE* Buffer, /* Pointer to the read data buffer */ - DWORD SectorNumber, /* Sector number to read from */ + DWORD SectorNumber, /* Start sector number */ BYTE SectorCount /* Number of sectros to read */ ); @@ -44,7 +44,7 @@ DRESULT disk_read (
    RES_OK (0)
    The function succeeded.
    RES_ERROR
    -
    Any error occured during the read operation.
    +
    Any hard error occured during the read operation and could not recover it.
    RES_PARERR
    Invalid parameter.
    RES_NOTRDY
    diff --git a/doc/en/dstat.html b/doc/en/dstat.html index b0cfb58..14560a7 100644 --- a/doc/en/dstat.html +++ b/doc/en/dstat.html @@ -21,7 +21,7 @@ DSTATUS disk_status (
    -

    Parameters

    +

    Parameter

    Drive
    Specifies the physical drive number to be confirmed.
    @@ -34,7 +34,7 @@ DSTATUS disk_status (

    The disk status is returned in combination of following flags.

    STA_NOINIT
    -
    Indicates that the disk drive has not been initialiezed. This flag is set on: system reset, disk removal and disk_initialize function failed, and cleared on: disk_initialize function succeeded.
    +
    Indicates that the disk drive has not been initialized. This flag is set on: system reset, disk removal and disk_initialize function failed, and cleared on: disk_initialize function succeeded.
    STA_NODISK
    Indicates that no medium in the drive. This is always cleared on fixed disk drive.
    STA_PROTECTED
    diff --git a/doc/en/dwrite.html b/doc/en/dwrite.html index 4d8b87c..7178dc8 100644 --- a/doc/en/dwrite.html +++ b/doc/en/dwrite.html @@ -30,7 +30,7 @@ DRESULT disk_write (
    Specifies the physical drive number.
    Buffer
    Pointer to the data to be written.
    -
    SectorNumber +
    SectorNumber
    Specifies the start sector number in logical block address (LBA).
    SectorCount
    Specifies the number of sectors to write. The value can be 1 to 255.
    @@ -44,7 +44,7 @@ DRESULT disk_write (
    RES_OK (0)
    The function succeeded.
    RES_ERROR
    -
    Any error occured during the write operation.
    +
    Any hard error occured during the write operation and could not recover it.
    RES_WRPRT
    The disk is write protected.
    RES_PARERR
    diff --git a/doc/en/filename.html b/doc/en/filename.html index ab54249..9157a23 100644 --- a/doc/en/filename.html +++ b/doc/en/filename.html @@ -12,7 +12,7 @@

    File and Path name on the FatFs module

    -

    The format of file and path name on the FatFs module is similer to MS-DOS. However it does not have a concept of current directory, all objects on the drive are specified in full path name from the root directory.

    +

    The format of file and path name on the FatFs module is similer to MS-DOS. However it does not have a concept of current directory like OS oriented file system. All objects on the drive are specified in full path name from the root directory.

     
  "[drive#:][/]directory/file"
@@ -28,7 +28,7 @@

    The FatFs module supports only 8.3 format file name and long file name is currentry not supported. For directory separator, a '/' is used, not a '\'. Heading '/' is ignored and can be omitted.

    -

    The logical drive number is specified in a numeral with a colon. When the drive number is omitted, it means the default drive (0). As for the Tiny-FatFs, it has only one logical drive and always works as drive 0. Any drive number cannot be contained in the path name.

    +

    The logical drive number is specified in a numeral with a colon. When the drive number is omitted, it is assumed default drive (0:). As for the Tiny-FatFs, it has only one logical drive and always works as drive 0. Any drive number cannot be contained in the path name.


    diff --git a/doc/en/forward.html b/doc/en/forward.html new file mode 100644 index 0000000..22bfc79 --- /dev/null +++ b/doc/en/forward.html @@ -0,0 +1,135 @@ + + + + + + + +FatFs - f_forward + + + + +
    +

    f_forward

    +

    The f_forward function reads the file data and forward it to the data streaming device.

    +
    +FRESULT f_forward (
+  FIL* FileObject,                 /* File object */
+  UINT (*Func)(const BYTE*,UINT),  /* Data streaming function */
+  UINT ByteToFwd,                  /* Number of bytes to forward */
+  UINT* ByteFwd                    /* Number of bytes forwarded */
+);
+
    +
    + +
    +

    Parameters

    +
    +
    FileObject
    +
    Pointer to the open file object.
    +
    Func
    +
    Pointer to the user-defined data streaming function. For details, refer to the sample code.
    +
    ByteToFwd
    +
    Number of bytes to forward in range of UINT.
    +
    ByteFwd
    +
    Pointer to the UINT variable to return number of bytes forwarded.
    +
    +
    + + +
    +

    Return Values

    +
    +
    FR_OK (0)
    +
    The function succeeded.
    +
    FR_DENIED
    +
    The function denied due to the file has been opened in non-read mode.
    +
    FR_RW_ERROR
    +
    The function failed due to a disk error or an internal error.
    +
    FR_NOT_READY
    +
    The disk drive cannot work due to no medium in the drive or any other reason.
    +
    FR_INVALID_OBJECT
    +
    The file object is invalid.
    +
    +
    + + +
    +

    Description

    +

    The f_forward() is for only Tiny-FatFs and not supported on FatFs. It reads the data from the file and forward it to the outgoing stream without data buffer. This is suitable for small memory system because it does not require any data buffer at application module. The file pointer of the file object increases in number of bytes forwarded. In case of *ByteFwd < ByteToFwd without error, it means the requested bytes could not be transferred due to end of file or stream goes busy during transfering process.

    +

    This function is available when _USE_FORWARD == 1.

    +
    + + +
    +

    Example (Audio playback)

    +
    +/*-----------------------------------------------------------------------*/
+/* Sample code of data transfer function to be called from f_forward     */
+/*-----------------------------------------------------------------------*/
+
+UINT out_stream (   /* Returns number of bytes sent or stream status */
+    const BYTE *p,  /* Pointer to the data block to be sent */
+    UINT btf        /* >0: Transfer call (Number of bytes to be sent). 0: Sense call */
+)
+{
+    UINT cnt = 0;
+
+
+    if (btf == 0) {     /* Sense call */
+        /* Return stream status (0: Busy, 1: Ready) */
+        /* When once it returned ready to sense call, it must accept a byte at least */
+        /* at subsequent transfer call, or f_forward will result FR_RW_ERROR. */
+        if (FIFO_READY) cnt = 1;
+    }
+    else {              /* Transfer call */
+        do {    /* Repeat while there is any data to be sent and the stream is ready */
+            FIFO_PORT = *p++;
+            cnt++;
+        } while (cnt < btf && FIFO_READY);
+    }
+
+    return cnt;
+}
+
+
+/*-----------------------------------------------------------------------*/
+/* Sample code using f_forward function                                  */
+/*-----------------------------------------------------------------------*/
+
+FRESULT play_file (
+    char *fn        /* Pointer to the audio file name to be played */
+)
+{
+    FRESULT rc;
+    FIL fil;
+    UINT dmy;
+
+    /* Open the audio file in read only mode */
+    rc = f_open(&fil, fn, FA_READ);
+
+    /* Repeat until the file pointer reaches end of the file */
+    while (rc == FR_OK && fil.fptr < fil.fsize) {
+
+        /* any other processes... */
+
+        /* Fill output stream periodicaly or on-demand */
+        rc = f_forward(&fil, out_stream, 1000, &dmy);
+    }
+
+    /* The read-only file object may be discarded without close */
+    return rc;
+}
+
    +
    + + +
    +

    References

    +

    f_open, fgets, f_write, f_close, FIL

    +
    + +

    Return

    + + diff --git a/doc/en/getfree.html b/doc/en/getfree.html index ab91028..a721b96 100644 --- a/doc/en/getfree.html +++ b/doc/en/getfree.html @@ -56,7 +56,7 @@ FRESULT f_getfree (

    Descriptions

    -

    The f_getfree function gets number of free clusters on the drive. The sects_clust member in the file system object is refreting number of sectors per cluster, so that the free space in unit of sector can be calcurated with this. When _USE_FSINFO option is enabled, this function might return an inaccurate free cluster count on FAT32 volume. When it is disabled, this function will take a time on FAT32 volume.

    +

    The f_getfree function gets number of free clusters on the drive. The member csize in the file system object is refreting number of sectors per cluster, so that the free space in unit of sector can be calcurated with this. When _USE_FSINFO option is enabled, this function might return an inaccurate free cluster count on FAT32 volume. When it is disabled, this function will take a time on FAT32 volume.

    This function is not supported in read-only configuration and minimization level of >= 1.

    @@ -69,14 +69,14 @@ FRESULT f_getfree ( // Get free clusters - res = f_getfree("", &clust, &fs); + res = f_getfree("", &clust, &fs); if (res) die(res); // Get free space printf("%lu KB total disk space.\n" "%lu KB available on the disk.\n", - (DWORD)(fs->max_clust - 2) * fs->sects_clust / 2, - clust * fs->sects_clust / 2); + (DWORD)(fs->max_clust - 2) * fs->csize / 2, + clust * fs->csize / 2);
    diff --git a/doc/en/gets.html b/doc/en/gets.html new file mode 100644 index 0000000..9b4b218 --- /dev/null +++ b/doc/en/gets.html @@ -0,0 +1,58 @@ + + + + + + + +FatFs - fgets + + + + +
    +

    fgets

    +

    The fgets reads a string from the file.

    +
    +char* fgets (
+  char* Str,        /* Read buffer */
+  int Size,         /* Size of the read buffer */
+  FIL* FileObject   /* File object */
+);
+
    +
    + +
    +

    Parameters

    +
    +
    Str
    +
    Pointer to read buffer to store the read string.
    +
    Size
    +
    Size of the read buffer.
    +
    FileObject
    +
    Pointer to the open file object structure.
    +
    +
    + + +
    +

    Return Values

    +

    When the function succeeded, Str will be returuned.

    +
    + + +
    +

    Description

    +

    The fgets() is a wrapper function of f_read(). The read operation continues until a '\n' is stored, reached end of file or buffer is filled with Size - 1 characters. The read string is terminated with a '\0'. When the file is already reached end of file or any error occured during read operation, fgets() returns a NULL. The EOF status can be examined with feof() macro.

    +

    This function is available when _USE_STRFUNC is 1 or 2. When it is set to 2, '\r' contained in the file is stripped.

    +
    + + +
    +

    References

    +

    f_open, f_read, fputc, fputs, fprintf, f_close, FIL

    +
    + +

    Return

    + + diff --git a/doc/en/lseek.html b/doc/en/lseek.html index 0a81d71..e90e4a2 100644 --- a/doc/en/lseek.html +++ b/doc/en/lseek.html @@ -50,7 +50,7 @@ FRESULT f_lseek (

    Description

    -

    The f_lseek function moves the file R/W pointer of an open file. The offset can be specified in only origin from top of the file. When an offset above the file size is specified in write mode, the file size is extended to the offset and the data in the extended area is undefined. This is suitable to create a large file quickly, for fast write operation without cluster allocation delay. After the f_lseek function succeeded, member fptr in the file object should be checked in order to make sure the R/W pointer has been moved correctry. In case of fptr is less than Offset, any of the followings has been occured.

    +

    The f_lseek function moves the file R/W pointer of an open file. The offset can be specified in only origin from top of the file. When an offset above the file size is specified in write mode, the file size is extended to the offset and the data in the extended area is undefined. This is suitable to create a large file quickly, for fast write operation without cluster allocation delay. After the f_lseek function succeeded, member fptr in the file object should be checked in order to make sure the R/W pointer has been moved correctry. In case of fptr is less than expected value, any of the followings has been occured.

    • In read-only mode, the Offset was clipped in file size.
    • The drive gets full during the file extending process.
      • @@ -63,16 +63,16 @@ FRESULT f_lseek (

      Example

           // Move to offset of 5000 from top of the file.
-    res = f_lseek(&file, 5000);
+    res = f_lseek(&file, 5000);
 
     // Forward 3000 bytes
-    res = f_lseek(&file, file.fptr + 3000);
+    res = f_lseek(&file, file.fptr + 3000);
 
     // Rewind 2000 bytes (take care on overflow)
-    res = f_lseek(&file, file.fptr - 2000);
+    res = f_lseek(&file, file.fptr - 2000);
 
     // Move to end of the file to append data
-    res = f_lseek(&file, file.fsize);
+    res = f_lseek(&file, file.fsize);
    diff --git a/doc/en/mkdir.html b/doc/en/mkdir.html index b0bd73d..dbb9c92 100644 --- a/doc/en/mkdir.html +++ b/doc/en/mkdir.html @@ -61,8 +61,6 @@ FRESULT f_mkdir (

    Description

    The f_mkdir function creates a new directory. This function is not supported in read-only configuration and minimization level of >= 1.

    -

    -

    diff --git a/doc/en/mkfs.html b/doc/en/mkfs.html index 1c98f57..dde6dda 100644 --- a/doc/en/mkfs.html +++ b/doc/en/mkfs.html @@ -30,7 +30,7 @@ FRESULT f_mkfs (
    PartitioningRule
    When 0 is given, a partition table is created into first sector on the drive and then the file system is created on the partition. This is called FDISK format. When 1 is given, the file system starts from the first sector without partition table. This is often called super floppy (SFD) format.
    AllocSize
    -
    Specifies allocation unit size (number of bytes per cluster). The value must be power of 2 in range of from 512 to 32768.
    +
    Specifies allocation unit size in number of bytes per cluster. The value must be power of 2 in range of from 512 to 32768. FAT64 (64KB/cluster on FAT16) is not supported.
    @@ -62,9 +62,9 @@ FRESULT f_mkfs (

    Description

    -

    The f_mkfs function creates a FAT file system on the drive. There are two partitioning rules, FDISK and SFD, for removable media. It can be selected with an argument. The FDISK format is recommended for most case. This function currently does not support multiple partition, so that existing partitions on the physical dirve will be deleted and re-created a partition occupies entire disk space.

    -

    The FAT sub-type, FAT12/FAT16/FAT32, is determined by only how many clusters on the drive and nothing else, according to the FAT specification issued by Microsoft. Thus which FAT sub-type is selected, is depends on the drive size and specified cluster size. The cluster size affects performance of file system and large cluster increases the performance, so that 32768 bytes per cluster is recommended for most case except for small drive.

    -

    This function is supported on only FatFs with _USE_MKFS option.

    +

    The f_mkfs function creates a FAT file system on the drive. There are two partitioning rules, FDISK and SFD, for removable media. It can be selected with an argument. The FDISK format is recommended for most case. This function currently does not support multiple partition, so that existing partitions on the physical dirve will be deleted and re-created a new partition occupies entire disk space.

    +

    The FAT sub-type, FAT12/FAT16/FAT32, is determined by number of clusters on the drive and nothing else, according to the FAT specification issued by Microsoft. Thus which FAT sub-type is selected, is depends on the drive size and the specified cluster size. The cluster size affects performance of file system and large cluster increases the performance, so that 32768 bytes per cluster is recommended for most case except for small drive.

    +

    This function is supported on only FatFs with _USE_MKFS option.

    diff --git a/doc/en/mount.html b/doc/en/mount.html index aed5691..7865690 100644 --- a/doc/en/mount.html +++ b/doc/en/mount.html @@ -44,8 +44,8 @@ FRESULT f_mount (

    Description

    -

    The f_mount function registers/unregisters a work area to the FatFs module. The work area must be given to the logical drive with this function before any other file function. To unregister a work area, specify a NULL to the FileSystemObject, and then the work area can be discarded.

    -

    This function only initializes the work area and registers its address to the internal table, any access to the disk I/O layer does not occure. The actual mounting process is performed depends on requirement in any other file funcitons with path name.

    +

    The f_mount function registers/unregisters a work area to the FatFs module. The work area must be given to the logical drive with this function prior to any other file function. To unregister a work area, specify a NULL to the FileSystemObject, and then the work area can be discarded.

    +

    This function only initializes the given work area and registers its address to the internal table, any access to the disk I/O layer does not occure. The volume mount process is performed on first file access after f_mount or media change.

    diff --git a/doc/en/open.html b/doc/en/open.html index c44488b..3d281e7 100644 --- a/doc/en/open.html +++ b/doc/en/open.html @@ -81,7 +81,7 @@ FRESULT f_open (

    Description

    -

    The created file object is used for subsequent calls to refer to the file. When close an open file object, use f_close function. If modified file is not closed correctly, the file will be collapsed.

    +

    The created file object is used for subsequent calls to refer to the file. When close an open file object, use f_close function. If modified file is not closed correctly, the file may be collapsed.

    Before using any file function, a work area (file system object) must be given to the logical drive with f_mount function. All file functions can work after this procedure.

    The mode flags, FA_WRITE, FA_CREATE_ALWAYS, FA_CREATE_NEW, FA_OPEN_ALWAYS, are not supported in read-only configuration.

    @@ -100,27 +100,27 @@ void main () // Register a work area for logical drive 0 - f_mount(0, &fs); + f_mount(0, &fs); // Open source file - res = f_open(&fsrc, "srcfile.dat", FA_OPEN_EXISTING | FA_READ); + res = f_open(&fsrc, "srcfile.dat", FA_OPEN_EXISTING | FA_READ); if (res) die(res); // Create destination file - res = f_open(&fdst, "dstfile.dat", FA_CREATE_ALWAYS | FA_WRITE); + res = f_open(&fdst, "dstfile.dat", FA_CREATE_ALWAYS | FA_WRITE); if (res) die(res); // Copy source to destination for (;;) { - res = f_read(&fsrc, buffer, sizeof(buffer), &br); + res = f_read(&fsrc, buffer, sizeof(buffer), &br); if (res || br == 0) break; // error or eof - res = f_write(&fdst, buffer, br, &bw); + res = f_write(&fdst, buffer, br, &bw); if (res || bw < br) break; // error or disk full } // Close all files - f_close(&fsrc); - f_close(&fdst); + f_close(&fsrc); + f_close(&fdst); // Unregister a work area before discard it f_mount(0, NULL); diff --git a/doc/en/opendir.html b/doc/en/opendir.html index 2e2ff39..0ab74ee 100644 --- a/doc/en/opendir.html +++ b/doc/en/opendir.html @@ -22,7 +22,7 @@ FRESULT f_opendir (
    -

    Parameter

    +

    Parameters

    DirObject
    Pointer to the blank directory object to be created.
    @@ -37,8 +37,6 @@ FRESULT f_opendir (
    FR_OK (0)
    The function succeeded and the directory object is created. It is used for subsequent calls to read the directory entries.
    -
    FR_NO_FILE
    -
    Could not find the directory.
    FR_NO_PATH
    Could not find the path.
    FR_INVALID_NAME
    diff --git a/doc/en/printf.html b/doc/en/printf.html new file mode 100644 index 0000000..d5857a3 --- /dev/null +++ b/doc/en/printf.html @@ -0,0 +1,72 @@ + + + + + + + +FatFs - fprintf + + + + +
    +

    fprintf

    +

    The fprintf function writes formatted string to the file.

    +
    +int fprintf (
+  FIL* FileObject,     /* File object */
+  const char* Foramt,  /* Format stirng */
+  ...
+);
+
    +
    + +
    +

    Parameters

    +
    +
    FileObject
    +
    Pointer to the open file object structure.
    +
    Format
    +
    Pointer to the null-terminated format string.
    +
    ...
    +
    Optional arguments.
    + +
    +
    + + +
    +

    Return Values

    +

    When the function succeeded, number of characters written is returned. When the function failed due to disk full or any error, an EOF will be returned.

    +
    + + +
    +

    Description

    +

    The fprintf() is a wrapper function of fputc() and fputs(). The format control directive is a sub-set of standard library. It supports c s d u X for the data type, l for the precision and 0 for the flags.

    +

    This function is available when read-write configuration and _USE_STRFUNC is 1 or 2.

    +
    + + +
    +

    Example

    +
    +    fprintf(&fil, "%6d", -200);         // "  -200"
+    fprintf(&fil, "%02u", 5);           // "05"
+    fprintf(&fil, "%ld", 12345678L);    // "12345678"
+    fprintf(&fil, "%08lX", 1194684UL);  // "00123ABC"
+    fprintf(&fil, "%s", "String");      // "String"
+    fprintf(&fil, "%c", 'a');           // "a"
+
    +
    + + +
    +

    References

    +

    f_open, fputc, fputs, fgets, f_close, FIL

    +
    + +

    Return

    + + diff --git a/doc/en/putc.html b/doc/en/putc.html new file mode 100644 index 0000000..882d2a5 --- /dev/null +++ b/doc/en/putc.html @@ -0,0 +1,54 @@ + + + + + + + +FatFs - fputc + + + + +
    +

    fputc

    +

    The fputc funciton puts a character to the file.

    +
    +int fputc (
+  int Chr,          /* A character to put */
+  FIL* FileObject   /* File object */
+);
+
    +
    + +
    +

    Parameters

    +
    +
    Chr
    +
    A character to be put.
    +
    FileObject
    +
    Pointer to the open file object structuer.
    +
    +
    + + +
    +

    Return Values

    +

    When the character was written successfuly, the function returns the character. When the function failed due to disk full or any error, an EOF will be returned.

    +
    + + +
    +

    Description

    +

    The fputc() is a wrapper function of f_write(). This function is available when read-write configuration and _USE_STRFUNC is 1 or 2. When it is set 2, a '\n' is extended to "\r\n".

    +
    + + +
    +

    Reference

    +

    f_open, fputs, fprintf, fgets, f_close, FIL

    +
    + +

    Return

    + + diff --git a/doc/en/puts.html b/doc/en/puts.html new file mode 100644 index 0000000..32faae7 --- /dev/null +++ b/doc/en/puts.html @@ -0,0 +1,54 @@ + + + + + + + +FatFs - fputs + + + + +
    +

    fputs

    +

    The fputs function writes a string to the file.

    +
    +int fputs (
+  const char* Str,  /* String */
+  FIL* FileObject   /* File object */
+);
+
    +
    + +
    +

    Parameters

    +
    +
    Str
    +
    Pointer to the null terminated string to be written. The null character will not be written.
    +
    FileObject
    +
    Pointer to the open file object structure.
    +
    +
    + + +
    +

    Return Value

    +

    When the function succeeded, number of characters written (not minus value) is returned. When the function failed due to disk full or any error, an EOF will be returned.

    +
    + + +
    +

    Description

    +

    The fputs() is a wrapper function of fputc(). This function is available when read-write configuration and _USE_STRFUNC is 1 or 2. When it is set 2, a '\n' is extended to "\r\n".

    +
    + + +
    +

    Reference

    +

    f_open, fputc, fprintf, fgets, f_close, FIL

    +
    + +

    Return

    + + diff --git a/doc/en/read.html b/doc/en/read.html index fa4984e..a843200 100644 --- a/doc/en/read.html +++ b/doc/en/read.html @@ -34,7 +34,7 @@ FRESULT f_read (
    Number of bytes to read in range of UINT.
    ByteRead
    Pointer to the UINT variable to return number of bytes read.
    - +
    @@ -57,13 +57,13 @@ FRESULT f_read (

    Description

    -

    The file pointer in the file object increases in number of bytes read. The ByteRead will become less than ByteToRead when the read pointer reached to end of the file or any error occured during the read operation.

    +

    The file pointer of the file object increases in number of bytes read. After the function succeeded, *ByteRead should be checked to detect end of file. In case of *ByteRead < ByteToRead, it means the R/W pointer reached end of file during read operation.

    References

    -

    f_open, f_write, f_close, FIL

    +

    f_open, fgets, f_write, f_close, FIL

    Return

    diff --git a/doc/en/readdir.html b/doc/en/readdir.html index 996d683..97d21fb 100644 --- a/doc/en/readdir.html +++ b/doc/en/readdir.html @@ -62,15 +62,15 @@ void scan_files (char* path) DIR dirs; int i; - if (f_opendir(&dirs, path) == FR_OK) { + if (f_opendir(&dirs, path) == FR_OK) { i = strlen(path); - while ((f_readdir(&dirs, &finfo) == FR_OK) && finfo.fname[0]) { - if (finfo.fattrib & AM_DIR) { - sprintf(&path[i], "/%s", &finfo.fname[0]); + while ((f_readdir(&dirs, &finfo) == FR_OK) && finfo.fname[0]) { + if (finfo.fattrib & AM_DIR) { + sprintf(&path[i], "/%s", &finfo.fname[0]); scan_files(path); path[i] = 0; } else { - printf("%s/%s\n", path, &finfo.fname[0]); + printf("%s/%s\n", path, &finfo.fname[0]); } } } diff --git a/doc/en/rename.html b/doc/en/rename.html index 503b896..e38ca10 100644 --- a/doc/en/rename.html +++ b/doc/en/rename.html @@ -22,7 +22,7 @@ FRESULT f_rename (
    -

    Parameter

    +

    Parameters

    OldName
    Pointer to a null-terminated string specifies the old file/directory name to be renamed.
    diff --git a/doc/en/sfatfs.html b/doc/en/sfatfs.html index 72a70a0..18c14bc 100644 --- a/doc/en/sfatfs.html +++ b/doc/en/sfatfs.html @@ -27,7 +27,7 @@ typedef struct _FATFS { DWORD last_clust; /* Last allocated cluster */ DWORD free_clust; /* Number of free clusters */ BYTE fs_type; /* FAT type (0:Not mounted) */ - BYTE sects_clust; /* Sectors per cluster */ + BYTE csize; /* Sectors per cluster */ BYTE n_fats; /* Number of FAT copies */ BYTE drive; /* Physical drive number */ BYTE winflag; /* win[] dirty flag (1:must be written back) */ @@ -50,7 +50,7 @@ typedef struct _FATFS { CLUST last_clust; /* Last allocated cluster */ CLUST free_clust; /* Number of free clusters */ BYTE fs_type; /* FAT type (0:Not mounted) */ - BYTE sects_clust; /* Sectors per cluster */ + BYTE csize; /* Sectors per cluster */ BYTE n_fats; /* Number of FAT copies */ BYTE winflag; /* win[] dirty flag (1:must be written back) */ BYTE win[512]; /* Disk access window for Directory/FAT/File */ diff --git a/doc/en/sfile.html b/doc/en/sfile.html index 1b50210..2b2ed67 100644 --- a/doc/en/sfile.html +++ b/doc/en/sfile.html @@ -19,7 +19,7 @@ typedef struct _FIL { WORD id; /* Owner file system mount ID (inverted) */ BYTE flag; /* File status flags */ - BYTE sect_clust; /* Left sectors in cluster */ + BYTE csect; /* Sector address in the cluster */ FATFS* fs; /* Pointer to the owner file system object */ DWORD fptr; /* File R/W pointer */ DWORD fsize; /* File size */ @@ -37,7 +37,7 @@ typedef struct _FIL { typedef struct _FIL { WORD id; /* Owner file system mount ID (inverted) */ BYTE flag; /* File status flags */ - BYTE sect_clust; /* Left sectors in cluster */ + BYTE csect; /* Sector address in the cluster */ FATFS* fs; /* Pointer to owner file system */ DWORD fptr; /* File R/W pointer */ DWORD fsize; /* File size */ diff --git a/doc/en/sync.html b/doc/en/sync.html index de93af1..a6e304d 100644 --- a/doc/en/sync.html +++ b/doc/en/sync.html @@ -12,7 +12,7 @@

    f_sync

    -

    The f_sync function flushes the cached information of a wriiting file.

    +

    The f_sync function flushes the cached information of a writing file.

     FRESULT f_sync (
   FIL* FileObject     /* Pointer to the file object */
@@ -21,7 +21,7 @@ FRESULT f_sync (
    -

    Parameters

    +

    Parameter

    FileObject
    Pointer to the open file object to be flushed.
    diff --git a/doc/en/truncate.html b/doc/en/truncate.html index 847f3b1..f0fb55e 100644 --- a/doc/en/truncate.html +++ b/doc/en/truncate.html @@ -21,7 +21,7 @@ FRESULT f_truncate (
    -

    Parameters

    +

    Parameter

    FileObject
    Pointer to the open file object to be truncated.
    @@ -48,7 +48,7 @@ FRESULT f_truncate (

    Description

    -

    The f_truncate function truncates the file size to the current file R/W point. When the file R/W pointer is pointing end of the file, there is no effect. This function is not supported in read-only configuration and minimization level of >=1.

    +

    The f_truncate function truncates the file size to the current file R/W point. When the file R/W pointer is already pointing end of the file, there is no effect. This function is not supported in read-only configuration and minimization level of >=1.

    diff --git a/doc/en/unlink.html b/doc/en/unlink.html index 33a0e73..6cfa50b 100644 --- a/doc/en/unlink.html +++ b/doc/en/unlink.html @@ -21,7 +21,7 @@ FRESULT f_unlink (
    -

    Parameters

    +

    Parameter

    FileName
    Pointer to the null-terminated string that specifies a file or directory to be removed.
    diff --git a/doc/en/utime.html b/doc/en/utime.html index b203581..0bea3a8 100644 --- a/doc/en/utime.html +++ b/doc/en/utime.html @@ -22,7 +22,7 @@ FRESULT f_utime (
    -

    Parameter

    +

    Parameters

    FileName
    Pointer to the null-terminated string that specifies a file or directory to be changed.
    diff --git a/doc/en/write.html b/doc/en/write.html index 3e14a5b..58cf54b 100644 --- a/doc/en/write.html +++ b/doc/en/write.html @@ -24,7 +24,7 @@ FRESULT f_write (
    -

    Parameter

    +

    Parameters

    FileObject
    Pointer to the open file object structure.
    @@ -57,13 +57,14 @@ FRESULT f_write (

    Description

    -

    The read/write pointer in the file object is increased in number of bytes written. The ByteWritten will become less than ByteToWrite when the drive gets full during the write operation. This function is not supported in read-only configuration.

    +

    The read/write pointer in the file object is increased in number of bytes written. After the function succeeded, *ByteWritten should be checked to detect disk full. In case of *ByteWritten < ByteToWrite, it means the disk got full during write operation.

    +

    This function is not supported in read-only configuration.

    References

    -

    f_open, f_read, f_close, FIL

    +

    f_open, f_read, fputc, fputs, fprintf, f_close, FIL

    Return

    diff --git a/doc/img/rw_ata.jpeg b/doc/img/rw_ata.jpeg deleted file mode 100644 index 2b97d93..0000000 Binary files a/doc/img/rw_ata.jpeg and /dev/null differ diff --git a/doc/img/rw_cfc.jpeg b/doc/img/rw_cfc.jpeg deleted file mode 100644 index c92d5fe..0000000 Binary files a/doc/img/rw_cfc.jpeg and /dev/null differ diff --git a/doc/img/rw_mmc.jpeg b/doc/img/rw_mmc.jpeg deleted file mode 100644 index 5f8115e..0000000 Binary files a/doc/img/rw_mmc.jpeg and /dev/null differ diff --git a/doc/img/rwtest.png b/doc/img/rwtest.png index f3cacfb..a34bf06 100644 Binary files a/doc/img/rwtest.png and b/doc/img/rwtest.png differ diff --git a/doc/img/rwtest2.png b/doc/img/rwtest2.png new file mode 100644 index 0000000..7fde6f3 Binary files /dev/null and b/doc/img/rwtest2.png differ diff --git a/doc/ja/appnote.html b/doc/ja/appnote.html index c99a125..549febd 100644 --- a/doc/ja/appnote.html +++ b/doc/ja/appnote.html @@ -17,29 +17,29 @@

    FatFsモジュールは移植性に関して次の点を前提としています。

    • 処理系はANSI C準拠であること。
      -FatFsモジュールはANSI C準拠で記述されているので、ANSI C準拠のコンパイラなら特に処理系依存な点はありません。ただし、FATというシステム間でポータブルな構造体を操作するため、プロセッサのエンディアンの違いは意識する必要があります。これは ff.h(tff.h) で定義されているので、最初にこれを適切に設定します(忘れている場合はエラーを出す)。
      • -
    • char/short/long のサイズは、それぞれ 8/16/32ビット で、intは 16または32ビット であること。
      +FatFsモジュールはANSI C準拠で記述されているので、ANSI C準拠のコンパイラなら特に処理系依存な点はありません。ただし、FATというシステム間でポータブルな構造体を操作するため、プロセッサのエンディアンの違いは意識する必要があります。これは ff.h(tff.h) で定義されているので、最初にこれを適切に設定します。
      • +
    • char/short/longのサイズは、それぞれ8/16/32ビットで、intは16または32ビットであること。
      使用される整数の型は integer.h 内で typedef されています。整数の型とサイズに関しては、まっとうな処理系なら問題ないはずですが、既存の定義と衝突した場合は矛盾がないように注意しなければなりません。
    -

    メモリ使用量 (R0.05a)

    +

    メモリ使用量 (R0.06)

    各種環境でのモジュールのメモリ使用量の例を示します。数値の単位はバイトで、Dは論理ドライブ数、Fは同時オープン・ファイル数を示します。最適化オプションはコード・サイズとしています。

    - - + + - - - - + + + + - - - - + + + +
    AVRH8/300HPICMSP430TLCS-870/CV850ESSH2
    コンパイラgccCH38C30(gcc)CL430CC870CCA850SHC
    AVRH8/300HPICMSP430TLCS870CV850ESSH2
    コンパイラWinAVR(gcc)CH38C30(gcc)CL430CC870CCA850SHC
    _MCU_ENDIAN1222112
    FatFs Code
    (Full, R/W)    		91469218915566627430
    FatFs Code
    (Minimum, R/W)    		58245756586140964710
    FatFs Code
    (Full, R/O)    		42684116418729863382
    FatFs Code
    (Minimum, R/O)    		30763134314322002610
    FatFs Code
    (Full, R/W)    		92809348938767287538
    FatFs Code
    (Minimum, R/W)    		58145798591340944742
    FatFs Code
    (Full, R/O)    		44024236437130543474
    FatFs Code
    (Minimum, R/O)    		30663158321321722630
    FatFs Work (Static)D*2+2D*4+2D*2+2D*4+2D*4+2
    FatFs Work (Dynamic)D*554+F*544D*554+F*550D*554+F*544D*554+F*550D*554+F*550
    Tiny-FatFs Code
    (Full, R/W)    		7566762673716894931459266580
    Tiny-FatFs Code
    (Minimum, R/W)    		4730481446834306628536704236
    Tiny-FatFs Code
    (Full, R/O)    		3564353235223226438926783022
    Tiny-FatFs Code
    (Minimum, R/O)    		2554267425952372337618562300
    Tiny-FatFs Code
    (Full, R/W)    		7628766875607108950159786640
    Tiny-FatFs Code
    (Minimum, R/W)    		4684482046984390632236784236
    Tiny-FatFs Code
    (Full, R/O)    		3634360036183382455427223072
    Tiny-FatFs Code
    (Minimum, R/O)    		2524270026012398339018622300
    Tiny-FatFs Wrok (Static)4644466
    Tiny-FatFs Work (Dynamic)544+F*28544+F*32544+F*28544+F*28544+F*28544+F*32544+F*32
    @@ -47,7 +47,7 @@ FatFs

    FatFs vs. Tiny-FatFs

    -

    ポータブル・オーディオやデータ・ロガーなど、よくある用途ではTiny-FatFsで十分です。しかし、Tiny-FatFsは標準構成ではFAT32に対応していないので、使用できるディスクは2GB(FAT64で4GB)までという制約があります。_FAT32オプションでFAT32対応を追加できますが、その分コード・サイズが膨らみます。フル機能のFatFsは、複数ファイルを高速アクセスする場合や、複数ドライブの対応が必要な場合に有効です。

    +

    ポータブル・オーディオやデータ・ロガーなど、よくある用途ではTiny-FatFsで十分です。しかし、Tiny-FatFsは標準構成ではFAT32に対応していないので、使用できるディスクは2GBまでという制約があります。_FAT32オプションでFAT32対応を追加できますが、その分コード・サイズが膨らみます。FatFsは、複数ファイルを高速アクセスする場合や、複数ドライブの対応が必要な用途に適しています。

    @@ -112,9 +112,9 @@ FatFs
  • セクタ・バッファ管理の改善
    現在はセクタ・バッファを固定して使用しているため、無駄なディスクアクセスが多く効率が悪い。メモリの潤沢なシステムでは、複数のセクタ・バッファを使用してディスク・キャッシュを構成すれば性能を向上させることができます。
  • 長いファイル名への対応
    -FATの拡張仕様ではMS-DOSの8.3形式ファイル名に加え、255文字までの長いファイル名(LFN)を扱えるようになっていますが、現リビジョンでは未対応で8.3形式しか使用できません。これに対応するには、ファイル名だけでも500バイト以上のバッファが必要になったり、UCS-2とShift_JISの相互変換(巨大な変換テーブルを使う)が必要となるなど、メモリの消費が爆発的に増えてしまいます。なお、LFNの機能はMicrosoft社の特許になっているため、これを製品に使うにはライセンス契約が必要です。
    • +FATの拡張仕様ではMS-DOSの8.3形式ファイル名に加え、255文字までの長いファイル名(LFN)を扱えるようになっていますが、現リビジョンでは未対応で8.3形式しか使用できません。これに対応するには、ファイル名1個で500バイト以上のバッファが必要になったり、Unicodeとローカル・コードの相互変換(256Kバイトの変換テーブルを使う)が必要になるなど、メモリの消費が爆発的に増えてしまいます。なお、LFNの機能はMicrosoft社の特許になっているため、これを製品に使うにはライセンス契約が必要です。
  • RTOSへの対応
    -FatFsモジュールを使用するタスクを一つに限るなら特に意識する必要はありませんが、同じ論理ドライブに複数のタスクから同時アクセスするには、何らかの排他制御が必要になってきます。FatFsモジュールのRTOSへの対応作業は、TOPPERSプロジェクトで行われています。
    • +FatFsモジュールを使用するタスクを一つに限るなら特に意識する必要はありませんが、同じ論理ドライブに対して複数のタスクから再入するには、何らかの排他制御が必要になってきます。FatFsモジュールのRTOSへの対応作業は、TOPPERSプロジェクトで行われています。

    そして、これらの機能拡張を行うとそれだけ多くのリソースが要求されるようになり、このプロジェクトの対象とする8/16ビット・マイコンのシステムに載せられなくなってしまうという問題もあります(これが一番の問題かも知れません)。

    diff --git a/doc/ja/chmod.html b/doc/ja/chmod.html index 02b12a1..6b70386 100644 --- a/doc/ja/chmod.html +++ b/doc/ja/chmod.html @@ -30,11 +30,11 @@ FRESULT f_chmod (
    Attribute
    設定する属性。指定可能な属性は次の通りで、これらの組み合わせで指定します。指定されなかった属性は解除されます。
    メモリ容量FATタイプ
    - - - - - + + + + +
    値意味
    AM_RDOリード・オンリー
    AM_ARCアーカイブ
    AM_SYSシステム
    AM_HIDヒドゥン
    値意味
    AM_RDOリード・オンリー
    AM_ARCアーカイブ
    AM_SYSシステム
    AM_HIDヒドゥン
    AttributeMask
    diff --git a/doc/ja/dioctl.html b/doc/ja/dioctl.html index 51262c7..b43b406 100644 --- a/doc/ja/dioctl.html +++ b/doc/ja/dioctl.html @@ -50,10 +50,11 @@ DRESULT disk_ioctl (

    解説

    -

    物理ドライブの種類によりサポートされるコマンドは異なりますが、FatFsモジュールでは、ドライブの種類に依存した制御は行いません。次のドライブ共通コマンドを使用します。

    +

    物理ドライブの種類によりサポートされるコマンドは異なりますが、FatFsモジュールでは、次の汎用コマンドのみ使用し、ドライブの種類に依存した制御は行いません。

    +

    この関数はリード・オンリー構成では必要とされません。

    - - + +
    コマンド解説
    CTRL_SYNCドライブがデータの書き込みを完了するのを待ちます。ライト・バック・キャッシュを持っている場合は、書き込まれていないデータを即時書き戻します。リード・オンリー構成では使用されません。
    コマンド解説
    CTRL_SYNCドライブがデータの書き込みを完了するのを待ちます。ライト・バック・キャッシュがある場合は、書き込まれていないデータを即時書き戻します。
    GET_SECTOR_COUNTBufferの指すDWORD変数にドライブ上の総セクタ数を返します。f_mkfs内でのみ使用。
    GET_BLOCK_SIZEBufferの指すDWORD変数にメモリ・アレーの消去ブロックサイズをセクタ単位で返します。不明な場合またはHDDでは1を返します。f_mkfs内でのみ使用。
    diff --git a/doc/ja/dread.html b/doc/ja/dread.html index 2b46292..7b12215 100644 --- a/doc/ja/dread.html +++ b/doc/ja/dread.html @@ -44,7 +44,7 @@ DRESULT disk_read (
    RES_OK (0)
    正常終了。
    RES_ERROR
    -
    読み込み中にエラーが発生した。
    +
    読み込み中にエラーが発生し、その回復にも失敗した。
    RES_PARERR
    パラメータが不正。
    RES_NOTRDY
    diff --git a/doc/ja/dwrite.html b/doc/ja/dwrite.html index bdb10ca..44941c8 100644 --- a/doc/ja/dwrite.html +++ b/doc/ja/dwrite.html @@ -44,7 +44,7 @@ DRESULT disk_write (
    RES_OK (0)
    正常終了。
    RES_ERROR
    -
    書き込み中にエラーが発生した。
    +
    書き込み中にエラーが発生し、その回復にも失敗した。
    RES_WRPRT
    ディスクが書き込み禁止状態。
    RES_PARERR
    diff --git a/doc/ja/filename.html b/doc/ja/filename.html index dc6f606..825fdb8 100644 --- a/doc/ja/filename.html +++ b/doc/ja/filename.html @@ -11,7 +11,7 @@

    ファイル・ディレクトリの指定方法

    -

    FatFsモジュールでのファイル、ディレクトリ、ドライブの指定方法はMS-DOSとほぼ同じです。ただし、MS-DOSのようなカレント・ディレクトリの概念は無いので、常にルート・ディレクトリから辿る絶対パスでの指定となります。パス名の指定方法と例は次の通りです。

    +

    FatFsモジュールでのファイル、ディレクトリ、ドライブの指定方法はMS-DOSとほぼ同じです。ただし、一般的なOSのようなカレント・ディレクトリの概念は無いので、常にルート・ディレクトリから辿る絶対パスでの指定となります。パス名の指定方法と例は次の通りです。

     
  "[論理ドライブ番号:][/]ディレクトリ名/ファイル名"
diff --git a/doc/ja/forward.html b/doc/ja/forward.html
new file mode 100644
index 0000000..f0e23cf
--- /dev/null
+++ b/doc/ja/forward.html
@@ -0,0 +1,134 @@
+
+
+
+
+
+
+
+FatFs - f_forward
+
+
+
+
+
    
+
    f_forward
    
+
    ファイルからデータを読み出し、送信ストリームに直接転送します。
    
+
    +FRESULT f_forward (
+  FIL* FileObject,                 /* ファイル・オブジェクト構造体 */
+  UINT (*Func)(const BYTE*,UINT),  /* データ転送関数 */
+  UINT ByteToFwd,                  /* 転送するバイト数 */
+  UINT* ByteFwd                    /* 転送されたバイト数 */
+);
+
    
+
    
+
+
    
+
    引数
    
+
    
+
    FileObject
    
+
    ファイル・オブジェクト構造体へのポインタを指定します。
    
+
    Func
    
+
    データを渡すユーザ定義関数へのポインタを指定します。この関数の仕様はサンプルを参照してください。
    
+
    ByteToRead
    
+
    転送するバイト数(0〜UINTの最大値)を指定します。
    
+
    ByteRead
    
+
    実際に転送されたバイト数を格納する変数を指すポインタを指定します。
    
+
    
+
    
+
+
+
    
+
    戻り値
    
+
    
+
    FR_OK (0)
    
+
    正常終了。
    
+
    FR_DENIED
    
+
    非読み込みモードで開いたファイルから読み込もうとした。
    
+
    FR_RW_ERROR
    
+
    ディスク・エラーまたは内部エラーによる失敗。
    
+
    FR_NOT_READY
    
+
    メディアがセットされていないなど、ディスク・ドライブが動作不能状態。
    
+
    FR_INVALID_OBJECT
    
+
    無効なファイル・オブジェクト。
    
+
    
+
    
+
+
+
    
+
    解説
    
+
    Tiny-FatFs専用関数です。ファイルのデータをバッファに読み出さずに送信ストリームに直接転送します。アプリケーション側でデータ・バッファを必要としないので、メモリの限られた環境で有効です。転送開始位置は、現在のファイルR/Wポインタからになります。ファイルR/Wポインタは転送されたバイト数だけ進みます。指定されたバイト数の転送中にファイルの終端に達した場合や送信ストリームがビジーになった場合、*ByteFwdはByteToFwdよりも小さくなります。
    
+
    この関数は、_USE_FORWARD == 0および、FatFsではサポートされません。
    
+
    
+
+
+
    
+
    使用例（オーディオ再生）
    
+
    +/*-----------------------------------------------------------------------*/
+/* f_forward関数から呼ばれるデータ送信関数の例                           */
+/*-----------------------------------------------------------------------*/
+
+UINT out_stream (   /* 戻り値: 転送されたバイト数またはストリームの状態 */
+    const BYTE *p,  /* 転送するデータを指すポインタ */
+    UINT btf        /* >0: 転送を行う(バイト数). 0: ストリームの状態を調べる */
+)
+{
+    UINT cnt = 0;
+
+
+    if (btf == 0) {     /* センス要求 */
+        /* ストリームの状態を返す (0: ビジー, 1: レディ) */
+        /* 一旦、レディを返したら、続く転送要求で少なくとも1バイトは */
+        /* 転送されないと f_forward関数は FR_RW_ERROR となる。 */
+        if (FIFO_READY) cnt = 1;
+    }
+    else {              /* 転送要求 */
+        do {    /* 全てのバイトを転送するか、ストリームがビジーになるまで繰り返す */
+            FIFO_PORT = *p++;
+            cnt++;
+        } while (cnt < btf && FIFO_READY);
+    }
+
+    return cnt;
+}
+
+
+/*-----------------------------------------------------------------------*/
+/* f_forward関数の使用例                                                 */
+/*-----------------------------------------------------------------------*/
+
+FRESULT play_file (
+    char *fn        /* 再生するオーディオ・ファイル名を指すポインタ */
+)
+{
+    FRESULT rc;
+    FIL fil;
+    UINT dmy;
+
+    /* ファイルを読み出しモードで開く */
+    rc = f_open(&fil, fn, FA_READ);
+
+    /* 全てのデータが転送されるかエラーが発生するまで続ける */
+    while (rc == FR_OK && fil.fptr < fil.fsize) {
+
+        /* ほかの処理... */
+
+        /* 定期的または要求に応じてデータをストリームに送出する */
+        rc = f_forward(&fil, out_stream, 1000, &dmy);
+    }
+
+    return rc;	/* FR_OK: 正常終了, ほか:異常終了 */
+}
+
    
+
    
+
+
+
    
+
    参照
    
+
    f_open, fgets, f_write, f_close, FIL
    
+
    
+
+
    戻る
    
+
+
diff --git a/doc/ja/getfree.html b/doc/ja/getfree.html
index 0f43c00..4717bf2 100644
--- a/doc/ja/getfree.html
+++ b/doc/ja/getfree.html
@@ -56,7 +56,7 @@ FRESULT f_getfree (
 
 
    
 
    解説
    
-
    論理ドライブ上の空きクラスタ数を取得します。返されたファイル・システム・オブジェクトのsects_clustメンバがクラスタあたりのセクタ数を示しているので、これを元に実際の空きサイズが計算できます。FAT32ボリュームにおいて、_USE_FSINFOが指定されているときは不正確な値を返す可能性があり、指定されていないときは処理に時間がかかります。
    
+
    論理ドライブ上の空きクラスタ数を取得します。返されたファイル・システム・オブジェクトのcsizeメンバがクラスタあたりのセクタ数を示しているので、これを元に実際の空きサイズが計算できます。FAT32ボリュームにおいて、_USE_FSINFOが指定されているときは不正確な値を返す可能性があり、指定されていないときは処理に時間がかかります。
    
 
    リードオンリー構成および_FS_MINIMIZE >= 1ではこの関数はサポートされません。
    
 
    
 
@@ -69,14 +69,14 @@ FRESULT f_getfree (
 
 
     // Get free clusters
-    res = f_getfree("", &clust, &fs);
+    res = f_getfree("", &clust, &fs);
     if (res) die(res);
 
     // Get free space
     printf("%lu KB total disk space.\n"
            "%lu KB available on the disk.\n",
-           (DWORD)(fs->max_clust - 2) * fs->sects_clust / 2,
-           clust * fs->sects_clust / 2);
+           (DWORD)(fs->max_clust - 2) * fs->csize / 2,
+           clust * fs->csize / 2);
    diff --git a/doc/ja/gets.html b/doc/ja/gets.html new file mode 100644 index 0000000..023ed97 --- /dev/null +++ b/doc/ja/gets.html @@ -0,0 +1,58 @@ + + + + + + + +FatFs - fgets + + + + +
    +

    fgets

    +

    ファイルから文字列を読み出します。

    +
    +char* fgets (
+  char* Str,        /* バッファ */
+  int Size,         /* バッファのサイズ */
+  FIL* FileObject   /* ファイル・オブジェクト */
+);
+
    +
    + +
    +

    引数

    +
    +
    Str
    +
    文字列を読み出すバッファを指すポインタを指定します。
    +
    Size
    +
    バッファのサイズを指定します。
    +
    FileObject
    +
    ファイル・オブジェクト構造体へのポインタを指定します。
    +
    +
    + + +
    +

    戻り値

    +

    関数が成功するとStrが返されます。

    +
    + + +
    +

    解説

    +

    この関数はf_read()のラッパー関数です。読み出し動作は、最初の'\n'を読み込むか、ファイル終端に達するか、Size - 1文字を読み出すまで続きます。読み込まれた文字列の終端には'\0'が付加されます。既にファイル終端で1文字も読み込まれなかったとき、または何らかのエラーが発生したときはNULLを返します。ファイル終端に達しているかどうかはfeof()マクロで調べられます。

    +

    _USE_STRFUNCが1または2のときこの関数がサポートされます。2のときは、ファイルに含まれる'\r'が取り除かれてバッファに読み込まれます。

    +
    + + +
    +

    参照

    +

    f_open, f_read, fputc, fputs, fprintf, f_close, FIL

    +
    + +

    戻る

    + + diff --git a/doc/ja/lseek.html b/doc/ja/lseek.html index 6570041..f98312d 100644 --- a/doc/ja/lseek.html +++ b/doc/ja/lseek.html @@ -63,16 +63,16 @@ FRESULT f_lseek (

    使用例

         // ファイル・オフセット5000へ移動
-    res = f_lseek(&file, 5000);
+    res = f_lseek(&file, 5000);
 
     // 3000バイト進める
-    res = f_lseek(&file, file.fptr + 3000);
+    res = f_lseek(&file, file.fptr + 3000);
 
     // 2000バイト戻す(オーバーフローに注意)
-    res = f_lseek(&file, file.fptr - 2000);
+    res = f_lseek(&file, file.fptr - 2000);
 
     // ファイル追記の準備(ファイル終端へ移動)
-    res = f_lseek(&file, file.fsize);
+    res = f_lseek(&file, file.fsize);
    diff --git a/doc/ja/mkdir.html b/doc/ja/mkdir.html index 26d59e9..773cfb1 100644 --- a/doc/ja/mkdir.html +++ b/doc/ja/mkdir.html @@ -61,8 +61,6 @@ FRESULT f_mkdir (

    解説

    空のディレクトリを作成します。リード・オンリー構成および_FS_MINIMIZE >= 1ではこの関数はサポートされません。

    -

    -

    diff --git a/doc/ja/mkfs.html b/doc/ja/mkfs.html index bcb76ca..7ffef74 100644 --- a/doc/ja/mkfs.html +++ b/doc/ja/mkfs.html @@ -28,9 +28,9 @@ FRESULT f_mkfs (
    Drive
    フォーマットする論理ドライブ(0-9)。
    PartitioningRule
    -
    0を指定すると、区画テーブルを作成したあとその区画にファイル・システムを作成します(FDISKフォーマット)。1を指定すると、先頭セクタから直接ファイル・システムを構築します(super floppy (SFD) フォーマット)。
    +
    0を指定すると、ドライブの全領域を占める基本DOS区画を作成したあとその区画にファイル・システムを作成します(FDISKフォーマット)。1を指定すると、区画テーブルを作成せずドライブの先頭セクタから直接ファイル・システムを作成します(super floppy (SFD) フォーマット)。
    AllocSize
    -
    クラスタ・サイズをバイト単位で指定します。512〜32768の範囲でかつ2の累乗でなければなりません。
    +
    クラスタ・サイズをバイト単位で指定します。512〜32768の範囲でかつ2の累乗でなければなりません。FAT64(64KB/クラスタ)は選択できません。
    @@ -62,9 +62,9 @@ FRESULT f_mkfs (

    説明

    -

    f_mkfs関数はFATファイル・システムをドライブ上に作成します。リムーバブル・メディアのパーテーショニング・ルールとしては、FDISK形式とSFD形式がありますが、FDISK形式が一般的です。この関数は複数区画には対応していないので、その物理ドライブの既存の区画は全て削除され、全体が一つの区画になります。

    +

    f_mkfs関数はFATファイル・システムをドライブ上に作成します。リムーバブル・メディアのパーテーショニング・ルールとしてはFDISK形式とSFD形式があり、メモリ・カードではFDISK形式が一般的です。この関数は複数区画には対応していないので、その物理ドライブの既存の区画は全て削除され、全体が一つの区画になります。

    FATタイプ(FAT12/FAT16/FAT32)は、ディスク上のクラスタ数によってのみ決定される[FAT仕様書より]決まりになっていて、それ以外の要因はありません。したがって、どのFATタイプになるかは、ディスク・サイズとクラスタ・サイズに依存します。クラスタ・サイズは大きいほど性能が上がるので、特に小容量のドライブでなければ32768バイトを選択しておけばよいです。

    -

    この関数は、FatFsで構成オプション_USE_MKFSを選択したときにサポートされます。また、Tiny-FatFsではサポートされません。

    +

    この関数は、FatFsで構成オプション_USE_MKFSを選択したときにサポートされます。また、Tiny-FatFsではサポートされません。

    diff --git a/doc/ja/mount.html b/doc/ja/mount.html index 02e9b7e..87bfb15 100644 --- a/doc/ja/mount.html +++ b/doc/ja/mount.html @@ -45,7 +45,7 @@ FRESULT f_mount (

    解説

    FatFsモジュールではそれぞれの論理ドライブにファイル・システム・オブジェクトというワーク・エリアが必要です。この関数は論理ドライブにそのワーク・エリアを登録したり抹消したりします。何らかのファイル関数を使用する前にこの関数でその論理ドライブのワーク・エリアを与えておかなければなりません。FileSystemObjectにヌル・ポインタを指定するとその論理ドライブのワーク・エリアの登録は抹消され、登録されていたワーク・エリアは破棄できます。

    -

    この関数内では物理ドライブへのアクセスは発生せず、ワーク・エリアを初期化して内部配列にそのアドレスを登録するだけです。実際のマウント動作は、他のファイル関数(パス名を指定するもの)の中で必要に応じて行われます。

    +

    この関数内では物理ドライブへのアクセスは発生せず、ワーク・エリアを初期化して内部配列にそのアドレスを登録するだけです。実際のマウント動作は、f_mount()またはメディア交換後、最初のファイル・アクセスのときに行われます。

    diff --git a/doc/ja/open.html b/doc/ja/open.html index 1f29bd4..383967e 100644 --- a/doc/ja/open.html +++ b/doc/ja/open.html @@ -32,7 +32,7 @@ FRESULT f_open (
    ModeFlags
    ファイルのアクセス方法やオープン方法を決めるフラグです。このパラメータには次の組み合わせを指定します。
    - + @@ -78,8 +78,8 @@ FRESULT f_open (

    解説

    -

    作成されたファイル・オブジェクトは、以降そのファイルに対するアクセスに使用します。ファイルを閉じるときは、f_close()を使用します。書き込みが行われたファイルが閉じられなかった場合、そのファイルは破損します。

    -

    ファイル操作関数を使用する前にまず、f_mount()を使ってそれぞれの論理ドライブにワーク・エリア(ファイル・システム・オブジェクト)を与えなければなりません。この初期化の後、その論理ドライブに対して全てのファイル関数が使えるようになります。

    +

    作成されたファイル・オブジェクトは、以降そのファイルに対するアクセスに使用します。ファイルを閉じるときは、f_close()を使用します。何らかの変更が行われたファイルが正しく閉じられなかった場合、そのファイルが破損する場合があります。

    +

    ファイル・アクセスを開始する前に、f_mount()を使ってそれぞれの論理ドライブにワーク・エリア(ファイル・システム・オブジェクト)を与える必要があります。この初期化の後、その論理ドライブに対して全てのファイル関数が使えるようになります。

    リードオンリー構成では、FA_WRITE, FA_CREATE_ALWAYS, FA_CREATE_NEW, FA_OPEN_ALWAYSの各フラグはサポートされません。

    @@ -96,27 +96,27 @@ void main () UINT br, bw; // File R/W count // ドライブ0のワーク・エリアを与える - f_mount(0, &fs); + f_mount(0, &fs); // ソース・ファイルを開く - res = f_open(&fsrc, "srcfile.dat", FA_OPEN_EXISTING | FA_READ); + res = f_open(&fsrc, "srcfile.dat", FA_OPEN_EXISTING | FA_READ); if (res) die(res); // デスティネーション・ファイルを作成する - res = f_open(&fdst, "dstfile.dat", FA_CREATE_ALWAYS | FA_WRITE); + res = f_open(&fdst, "dstfile.dat", FA_CREATE_ALWAYS | FA_WRITE); if (res) die(res); // ソースからデスティネーションにコピーする for (;;) { - res = f_read(&fsrc, buffer, sizeof(buffer), &br); + res = f_read(&fsrc, buffer, sizeof(buffer), &br); if (res || br == 0) break; // error or eof - res = f_write(&fdst, buffer, br, &bw); + res = f_write(&fdst, buffer, br, &bw); if (res || bw < br) break; // error or disk full } // 全てのファイルを閉じる - f_close(&fsrc); - f_close(&fdst); + f_close(&fsrc); + f_close(&fdst); // ワーク・エリアを開放する f_mount(0, NULL); diff --git a/doc/ja/opendir.html b/doc/ja/opendir.html index b0dedeb..0cfccfb 100644 --- a/doc/ja/opendir.html +++ b/doc/ja/opendir.html @@ -37,8 +37,6 @@ FRESULT f_opendir (
    FR_OK (0)
    正常終了。
    -
    FR_NO_FILE
    -
    ディレクトリが見つからない。
    FR_NO_PATH
    パスが見つからない。
    FR_INVALID_NAME
    diff --git a/doc/ja/printf.html b/doc/ja/printf.html new file mode 100644 index 0000000..f2d2504 --- /dev/null +++ b/doc/ja/printf.html @@ -0,0 +1,71 @@ + + + + + + + +FatFs - fprintf + + + + +
    +

    fprintf

    +

    ファイルに書式化文字列を書き込みます。

    +
    +int fprintf (
+  FIL* FileObject,     /* ファイル・オブジェクト */
+  const char* Foramt,  /* 書式制御文字列 */
+  ...
+);
+
    +
    + +
    +

    引数

    +
    +
    FileObject
    +
    ファイル・オブジェクト構造体へのポインタを指定します。
    +
    Format
    +
    '\0'で終わる書式制御文字列を指すポインタを指定します。'\0'は書き込まれません。
    +
    ...
    +
    オプションの引数。
    + +
    +
    + + +
    +

    戻り値

    +

    文字列が正常に書き込まれると書き込んだ文字数が返されます。ディスクが満杯またはその他エラーにより正常に書き込まれなかったときはEOF(-1)が返されます。

    +
    + + +
    +

    解説

    +

    この関数はfputc()およびfputs()のラッパー関数です。書式制御機能はサブセットとなっていて、使用可能はタイプはc s d u X、精度指定はl、フラグは0となっています。リード・ライト構成で_USE_STRFUNCが1または2のときこの関数がサポートされます。

    +
    + + +
    +

    使用例

    +
    +    fprintf(&fil, "%6d", -200);         // "  -200"
+    fprintf(&fil, "%02u", 5);           // "05"
+    fprintf(&fil, "%ld", 12345678L);    // "12345678"
+    fprintf(&fil, "%08lX", 1194684UL);  // "00123ABC"
+    fprintf(&fil, "%s", "String");      // "String"
+    fprintf(&fil, "%c", 'a');           // "a"
+
    +
    + + +
    +

    参照

    +

    f_open, fputc, fputs, fgets, f_close, FIL

    +
    + +

    戻る

    + + diff --git a/doc/ja/putc.html b/doc/ja/putc.html new file mode 100644 index 0000000..26dd660 --- /dev/null +++ b/doc/ja/putc.html @@ -0,0 +1,54 @@ + + + + + + + +FatFs - fputc + + + + +
    +

    fputc

    +

    ファイルに文字を書き込みます。

    +
    +int fputc (
+  int Chr,          /* 書き込む文字 */
+  FIL* FileObject   /* ファイル・オブジェクト */
+);
+
    +
    + +
    +

    引数

    +
    +
    Chr
    +
    書き込む文字を指定します。
    +
    FileObject
    +
    ファイル・オブジェクト構造体へのポインタを指定します。
    +
    +
    + + +
    +

    戻り値

    +

    文字が正常に書き込まれると書き込んだ文字が返されます。ディスクが満杯またはその他エラーにより書き込まれなかったときはEOFが返されます。

    +
    + + +
    +

    解説

    +

    この関数はf_write()のラッパー関数です。リード・ライト構成で、_USE_STRFUNCが1または2のときこの関数がサポートされます。2を指定すると、'\n'は"\r\n"に変換されて書き込まれます。

    +
    + + +
    +

    参照

    +

    f_open, fputs, fprintf, fgets, f_close, FIL

    +
    + +

    戻る

    + + diff --git a/doc/ja/puts.html b/doc/ja/puts.html new file mode 100644 index 0000000..7be5548 --- /dev/null +++ b/doc/ja/puts.html @@ -0,0 +1,54 @@ + + + + + + + +FatFs - fputs + + + + +
    +

    fputs

    +

    ファイルに文字列を書き込みます。

    +
    +int fputs (
+  const char* Str,  /* 文字列 */
+  FIL* FileObject   /* ファイル・オブジェクト */
+);
+
    +
    + +
    +

    引数

    +
    +
    Str
    +
    書き込む'\0'で終わる文字列を指すポインタを指定します。'\0'は書き込まれません。
    +
    FileObject
    +
    ファイル・オブジェクト構造体へのポインタを指定します。
    +
    +
    + + +
    +

    戻り値

    +

    文字列が正常に書き込まれると書き込んだ文字数が返されます。ディスクが満杯またはその他エラーにより正常に書き込まれなかったときはEOFが返されます。

    +
    + + +
    +

    解説

    +

    この関数はfputc()のラッパー関数です。リード・ライト構成で、_USE_STRFUNCが1または2のときこの関数がサポートされます。2を指定すると、文字列中の'\n'が"\r\n"に変換されて書き込まれます。

    +
    + + +
    +

    参照

    +

    f_open, fputc, fprintf, fgets, f_close, FIL

    +
    + +

    戻る

    + + diff --git a/doc/ja/read.html b/doc/ja/read.html index ba55840..813052a 100644 --- a/doc/ja/read.html +++ b/doc/ja/read.html @@ -34,7 +34,7 @@ FRESULT f_read (
    読み出すバイト数(0〜UINTの最大値)を指定します。
    ByteRead
    実際に読み出されたバイト数を格納する変数を指すポインタを指定します。
    - +
    @@ -63,7 +63,7 @@ FRESULT f_read (

    参照

    -

    f_open, f_write, f_close, FIL

    +

    f_open, fgets, f_write, f_close, FIL

    戻る

    diff --git a/doc/ja/readdir.html b/doc/ja/readdir.html index 3cc0821..2dea683 100644 --- a/doc/ja/readdir.html +++ b/doc/ja/readdir.html @@ -62,15 +62,15 @@ void scan_files (char* path) DIR dirs; int i; - if (f_opendir(&dirs, path) == FR_OK) { + if (f_opendir(&dirs, path) == FR_OK) { i = strlen(path); - while ((f_readdir(&dirs, &finfo) == FR_OK) && finfo.fname[0]) { - if (finfo._attrib & AM_DIR) { - sprintf(&path[i], "/%s", &finfo.fname[0]); + while ((f_readdir(&dirs, &finfo) == FR_OK) && finfo.fname[0]) { + if (finfo._attrib & AM_DIR) { + sprintf(&path[i], "/%s", &finfo.fname[0]); scan_files(path); path[i] = 0; } else { - printf("%s/%s\n", path, &finfo.fname[0]); + printf("%s/%s\n", path, &finfo.fname[0]); } } } diff --git a/doc/ja/sfatfs.html b/doc/ja/sfatfs.html index 0aa63e3..e149629 100644 --- a/doc/ja/sfatfs.html +++ b/doc/ja/sfatfs.html @@ -27,7 +27,7 @@ typedef struct _FATFS { DWORD last_clust; /* Last allocated cluster */ DWORD free_clust; /* Number of free clusters */ BYTE fs_type; /* FAT type (0:Not mounted) */ - BYTE sects_clust; /* Sectors per cluster */ + BYTE csize; /* Sectors per cluster */ BYTE n_fats; /* Number of FAT copies */ BYTE drive; /* Physical drive number */ BYTE winflag; /* win[] dirty flag (1:must be written back) */ @@ -50,7 +50,7 @@ typedef struct _FATFS { CLUST last_clust; /* Last allocated cluster */ CLUST free_clust; /* Number of free clusters */ BYTE fs_type; /* FAT type (0:Not mounted) */ - BYTE sects_clust; /* Sectors per cluster */ + BYTE csize; /* Sectors per cluster */ BYTE n_fats; /* Number of FAT copies */ BYTE winflag; /* win[] dirty flag (1:must be written back) */ BYTE win[512]; /* Disk access window for Directory/FAT/File */ diff --git a/doc/ja/sfile.html b/doc/ja/sfile.html index 7ae1ce8..1877c19 100644 --- a/doc/ja/sfile.html +++ b/doc/ja/sfile.html @@ -18,7 +18,7 @@ typedef struct _FIL { WORD id; /* Owner file system mount ID (inverted) */ BYTE flag; /* File status flags */ - BYTE sect_clust; /* Left sectors in cluster */ + BYTE csect; /* Sector address in the cluster */ FATFS* fs; /* Pointer to the owner file system object */ DWORD fptr; /* File R/W pointer */ DWORD fsize; /* File size */ @@ -36,7 +36,7 @@ typedef struct _FIL { typedef struct _FIL { WORD id; /* Owner file system mount ID (inverted) */ BYTE flag; /* File status flags */ - BYTE sect_clust; /* Left sectors in cluster */ + BYTE csect; /* Sector address in the cluster */ FATFS* fs; /* Pointer to owner file system */ DWORD fptr; /* File R/W pointer */ DWORD fsize; /* File size */ diff --git a/doc/ja/stat.html b/doc/ja/stat.html index d301e03..f1a5e74 100644 --- a/doc/ja/stat.html +++ b/doc/ja/stat.html @@ -12,7 +12,6 @@

    f_stat

    -

     FRESULT f_stat (
   const char* FileName,  /* ファイルまたはディレクトリ名へのポインタ */
@@ -43,7 +42,7 @@ FRESULT f_stat (
 
    パスが見つからない。
    
 
    FR_INVALID_NAME
    
 
    パス名が不正。
    
-
    FR_INVALID_NAME
    
+
    FR_INVALID_DRIVE
    
 
    ドライブ番号が不正。
    
 
    FR_NOT_READY
    
 
    メディアがセットされていないなど、ディスク・ドライブが動作不能状態。
    
diff --git a/doc/ja/write.html b/doc/ja/write.html
index 4609c97..c4fb76b 100644
--- a/doc/ja/write.html
+++ b/doc/ja/write.html
@@ -44,7 +44,7 @@ FRESULT f_write (
 
    FR_OK (0)
    
 
    正常終了。
    
 
    FR_DENIED
    
-
    非書き込みモードで開いたファイルに書き込もうとした。
    
+
    非書き込みモードで開かれたファイルに書き込もうとした。
    
 
    FR_RW_ERROR
    
 
    ディスク・エラーまたは内部エラーによる失敗。
    
 
    FR_NOT_READY
    
@@ -57,13 +57,14 @@ FRESULT f_write (
 
 
    
 
    解説
    
-
    書き込み開始位置は、ファイルR/Wポインタの現在位置からになります。ファイルR/Wポインタは実際に書き込まれたバイト数だけ進みます。書き込み中にディスクが一杯になったときは、*ByteWrittenはByteToWriteよりも小さくなります。リード・オンリー構成ではこの関数はサポートされません。
    
+
    書き込み開始位置は、ファイルR/Wポインタの位置からになります。ファイルR/Wポインタは実際に書き込まれたバイト数だけ進みます。関数が正常終了した後、要求したバイト数が書き込まれたかどうか*ByteWrittenをチェックすべきです。*ByteWritten < ByteToWriteのときは、ディスク・フルを意味します。
    
+
    リード・オンリー構成ではこの関数はサポートされません。
    
 
    
 
 
 
    
 
    参照
    
-
    f_open, f_read, f_close, FIL
    
+
    f_open, f_read, fputc, fputs, fprintf, f_close, FIL
    
 
    
 
 
    戻る
    
diff --git a/doc/updates.txt b/doc/updates.txt
index 49b943d..f0e22f1 100644
--- a/doc/updates.txt
+++ b/doc/updates.txt
@@ -1,3 +1,8 @@
+R0.06, Apr 01, 2008
+  Added f_forward. (Tiny-FatFs)
+  Added string functions: fgets, fputc, fputs and fprintf.
+  Improved performance of f_lseek on moving to the same or following cluster.
+
 R0.05a, Feb 03, 2008
   Added f_truncate.
   Added f_utime.
diff --git a/patches.txt b/patches.txt
new file mode 100644
index 0000000..aa383ab
--- /dev/null
+++ b/patches.txt
@@ -0,0 +1,63 @@
+Patches for FatFs and Tiny-FatFs R0.06
+
+April 16, 2008 - FatFs and Tiny-FatFs
+------------------------------------------------------------------------------
+The va_arg(arp,char) used in fprintf() will cause an incorrect behavior on
+the big-endian processor due to type promotion rules. Thus the corresponding
+code should be changed to va_arg(arp,int).
+
+
+
+October 11, 2008 - FatFs and Tiny-FatFs
+------------------------------------------------------------------------------
+Warnings due to wrong cast may occure in the get_fileinfo function. To
+eliminate it, remove const attribute of the argument, "const BYTE *dir".
+
+
+
+October 22, 2008 - FatFs and Tiny-FatFs
+------------------------------------------------------------------------------
+Improving write performance. On sector misaligned long writes, FatFs issues
+sector write requests out of the sector order. It will decrease the write
+performance of flash memory storages. This is not the case on short writes
+without direct transfer. To solve this problem, apply following patches. 
+
+--- ff.c	Tue Apr  1 21:49:26 2008
++++ ff_new.c	Tue Oct 21 23:27:44 2008
+@@ -1018,6 +1018,11 @@
+ 				fp->curr_clust = clust;				/* Update current cluster */
+ 				fp->csect = 0;						/* Reset sector address in the cluster */
+ 			}
++			if (fp->flag & FA__DIRTY) {				/* Write back file I/O buffer prior to following direct transfer */
++				if (disk_write(fp->fs->drive, fp->buffer, fp->curr_sect, 1) != RES_OK)
++					goto fw_error;
++				fp->flag &= (BYTE)~FA__DIRTY;
++			}
+ 			sect = clust2sect(fp->fs, fp->curr_clust) + fp->csect;	/* Get current sector */
+ 			cc = btw / SS(fp->fs);					/* When remaining bytes >= sector size, */
+ 			if (cc) {								/* Write maximum contiguous sectors directly */
+@@ -1030,11 +1035,6 @@
+ 				continue;
+ 			}
+ 			if (sect != fp->curr_sect) {			/* Is window offset changed? */
+-				if (fp->flag & FA__DIRTY) {			/* Write back file I/O buffer if needed */
+-					if (disk_write(fp->fs->drive, fp->buffer, fp->curr_sect, 1) != RES_OK)
+-						goto fw_error;
+-					fp->flag &= (BYTE)~FA__DIRTY;
+-				}
+ 				if (fp->fptr < fp->fsize &&  		/* Fill file I/O buffer with file data */
+ 					disk_read(fp->fs->drive, fp->buffer, sect, 1) != RES_OK)
+ 						goto fw_error;
+
+
+--- tff.c	Tue Apr  1 21:49:28 2008
++++ tff_new.c	Wed Oct 22 02:13:05 2008
+@@ -1037,6 +1037,8 @@
+ 		if (wcnt > btw) wcnt = btw;
+ 		memcpy(&fp->fs->win[fp->fptr % 512U], wbuff, wcnt);
+ 		fp->fs->winflag = 1;
++		if (((UINT)fp->fptr + wcnt) % 512U == 0		/* Flush sector window when last byte is written */
++			&& !move_window(0)) goto fw_error;
+ 	}
+ 
+ 	if (fp->fptr > fp->fsize) fp->fsize = fp->fptr;	/* Update file size if needed */
diff --git a/src/00readme.txt b/src/00readme.txt
index 1934e6a..8510b3e 100644
--- a/src/00readme.txt
+++ b/src/00readme.txt
@@ -1,4 +1,4 @@
-FatFs/Tiny-FatFs Module Source Files R0.05a   (C)ChaN, 2008
+FatFs/Tiny-FatFs Module Source Files R0.06                  (C)ChaN, 2008
 
 
 FILES
@@ -27,30 +27,37 @@ CONFIGURATION OPTIONS
   _MCU_ENDIAN
 
   This is the most impotant option that depends on the processor architecture.
-  When the target device corresponds to either or both of following terms, the
-  _MCU_ENDIAN must be set to 2 to force FatFs to access FAT structure in
-  byte-by-byte.
+  The value 2 is compatible with all MCUs. It forces FatFs to access FAT
+  structures in byte-by-byte. When the target device corresponds to either or
+  both of following cases, it must always be set 2.
 
   - Muti-byte integers (short, long) are stored in Big-Endian.
   - Address miss-aligned memory access results in an incorrect behavior.
 
-  If not the case, this can also be set to 1 for good code efficiency. The
-  initial value is 0. (must be set to 1 or 2 properly)
+  If not the case, setting 1 is recommended rather than 2 for good code
+  efficiency. The initial value is 0. (Must set 1 or 2 properly)
 
 
   _FS_READONLY
 
-  When application program does not require any write function, _FS_READONLY
-  can be set to 1 to eliminate writing code to reduce the module size. This
+  When application program does not require write functions, _FS_READONLY can
+  be set to 1 to eliminate writing code to reduce the module size. This
   setting should be reflected to configurations of low level disk I/O module
   if available. The initial value is 0. (Read and Write)
 
 
   _FS_MINIMIZE
 
-  When application program requires only file read/write function, _FS_MINIMIZE
-  can be changed to eliminate some functions to reduce the module size. The
-  initial value is 0. (full function)
+  When application program requires only file read/write function and nothing
+  else, _FS_MINIMIZE can be changed to eliminate some functions to reduce the
+  module size. The initial value is 0. (Full function)
+
+
+  _USE_STRFUNC
+
+  When _USE_STRFUNC is set to 1, the string functions, fputc, fputs, fprintf
+  and fgets are enabled. The initial value is 0. (String functions are not
+  available)
 
 
   _DRIVES
@@ -62,7 +69,7 @@ CONFIGURATION OPTIONS
 
   When _FAT32 is set to 1, the FAT32 support is added with an additional
   code size. This option is for only Tiny-FatFs. FatFs always supports all
-  FAT sub-types. The initial value is 0. (no FAT32 support)
+  FAT sub-types. The initial value is 0. (No FAT32 support)
 
 
   _USE_FSINFO
@@ -93,26 +100,31 @@ CONFIGURATION OPTIONS
 
   Following table shows which function is removed by configuration options.
 
-                _FS_MINIMIZE   _FS_READONLY  _USE_MKFS 
-                (1)  (2)  (3)       (1)         (0)    
-   f_mount                                             
-   f_open                                              
-   f_close                                             
-   f_read                                              
-   f_write                           x                 
-   f_sync                            x                 
-   f_lseek                 x                           
-   f_opendir          x    x                           
-   f_readdir          x    x                           
-   f_stat        x    x    x                           
-   f_getfree     x    x    x         x                 
-   f_truncate    x    x    x         x                 
-   f_unlink      x    x    x         x                 
-   f_mkdir       x    x    x         x                 
-   f_chmod       x    x    x         x                 
-   f_utime       x    x    x         x                 
-   f_rename      x    x    x         x                 
-   f_mkfs        x    x    x         x          x      
+                _FS_MINIMIZE  _FS_READONLY _USE_STRFUNC _USE_MKFS _USE_FORWARD
+                (1)  (2)  (3)      (1)         (0)         (0)        (0)     
+   f_mount                                                                    
+   f_open                                                                     
+   f_close                                                                    
+   f_read                                                                     
+   f_write                          x                                         
+   f_sync                           x                                         
+   f_lseek                 x                                                  
+   f_opendir          x    x                                                  
+   f_readdir          x    x                                                  
+   f_stat        x    x    x                                                  
+   f_getfree     x    x    x        x                                         
+   f_truncate    x    x    x        x                                         
+   f_unlink      x    x    x        x                                         
+   f_mkdir       x    x    x        x                                         
+   f_chmod       x    x    x        x                                         
+   f_utime       x    x    x        x                                         
+   f_rename      x    x    x        x                                         
+   f_mkfs                           x                       x                 
+   f_forward                                                           x      
+   fputc                            x           x                             
+   fputs                            x           x                             
+   fprintf                          x           x                             
+   fgets                                        x                             
 
 
 
@@ -120,8 +132,8 @@ AGREEMENTS
 
   The FatFs/Tiny-FatFs module is a free software and there is no warranty.
   The FatFs/Tiny-FatFs module is opened for education, reserch and development.
-  You can use and/or modify it for personal, non-profit or commercial use
-  without any restriction under your responsibility.
+  There is no restriction on use. You can use it for personal, non-profit or
+  commercial use under your responsibility.
 
 
 
@@ -171,3 +183,7 @@ REVISION HISTORY
                        Fixed off by one error at FAT sub-type determination.
                        Fixed btr in f_read() can be mistruncated.
                        Fixed cached sector is not flushed when create and close without write.
+
+  Apr 01, 2008  R0.06  Added f_forward(). (Tiny-FatFs)
+                       Added string functions: fputc(), fputs(), fprintf() and fgets().
+                       Improved performance of f_lseek() on move to the same or following cluster.
diff --git a/src/diskio.h b/src/diskio.h
index d02178d..ae7aa27 100644
--- a/src/diskio.h
+++ b/src/diskio.h
@@ -1,5 +1,5 @@
 /*-----------------------------------------------------------------------
-/  Low level disk interface modlue include file  R0.05x  (C)ChaN, 2007
+/  Low level disk interface modlue include file  R0.06   (C)ChaN, 2007
 /-----------------------------------------------------------------------*/
 
 #ifndef _DISKIO
@@ -48,7 +48,7 @@ void	disk_timerproc (void);
 /* Command code for disk_ioctrl() */
 
 /* Generic command */
-#define CTRL_SYNC			0	/* Mandatory for write functions */
+#define CTRL_SYNC			0	/* Mandatory for read/write configuration */
 #define GET_SECTOR_COUNT	1	/* Mandatory for only f_mkfs() */
 #define GET_SECTOR_SIZE		2
 #define GET_BLOCK_SIZE		3	/* Mandatory for only f_mkfs() */
diff --git a/src/ff.c b/src/ff.c
index 2ca7adc..e030ab0 100644
--- a/src/ff.c
+++ b/src/ff.c
@@ -1,6 +1,6 @@
-/*--------------------------------------------------------------------------/
-/  FatFs - FAT file system module  R0.05a                    (C)ChaN, 2008
-/---------------------------------------------------------------------------/
+/*----------------------------------------------------------------------------/
+/  FatFs - FAT file system module  R0.06                     (C)ChaN, 2008
+/-----------------------------------------------------------------------------/
 / The FatFs module is an experimenal project to implement FAT file system to
 / cheap microcontrollers. This is a free software and is opened for education,
 / research and development under license policy of following trems.
@@ -9,45 +9,49 @@
 /
 / * The FatFs module is a free software and there is no warranty.
 / * You can use, modify and/or redistribute it for personal, non-profit or
-/   profit use without any restriction under your responsibility.
+/   commercial use without restriction under your responsibility.
 / * Redistributions of source code must retain the above copyright notice.
 /
-/---------------------------------------------------------------------------/
-/  Feb 26, 2006  R0.00  Prototype.
+/-----------------------------------------------------------------------------/
+/ Feb 26,'06 R0.00  Prototype.
 /
-/  Apr 29, 2006  R0.01  First stable version.
+/ Apr 29,'06 R0.01  First stable version.
 /
-/  Jun 01, 2006  R0.02  Added FAT12 support.
-/                       Removed unbuffered mode.
-/                       Fixed a problem on small (<32M) patition.
-/  Jun 10, 2006  R0.02a Added a configuration option (_FS_MINIMUM).
+/ Jun 01,'06 R0.02  Added FAT12 support.
+/                   Removed unbuffered mode.
+/                   Fixed a problem on small (<32M) patition.
+/ Jun 10,'06 R0.02a Added a configuration option (_FS_MINIMUM).
 /
-/  Sep 22, 2006  R0.03  Added f_rename().
-/                       Changed option _FS_MINIMUM to _FS_MINIMIZE.
-/  Dec 11, 2006  R0.03a Improved cluster scan algolithm to write files fast.
-/                       Fixed f_mkdir() creates incorrect directory on FAT32.
+/ Sep 22,'06 R0.03  Added f_rename().
+/                   Changed option _FS_MINIMUM to _FS_MINIMIZE.
+/ Dec 11,'06 R0.03a Improved cluster scan algolithm to write files fast.
+/                   Fixed f_mkdir() creates incorrect directory on FAT32.
 /
-/  Feb 04, 2007  R0.04  Supported multiple drive system.
-/                       Changed some interfaces for multiple drive system.
-/                       Changed f_mountdrv() to f_mount().
-/                       Added f_mkfs().
-/  Apr 01, 2007  R0.04a Supported multiple partitions on a plysical drive.
-/                       Added a capability of extending file size to f_lseek().
-/                       Added minimization level 3.
-/                       Fixed an endian sensitive code in f_mkfs().
-/  May 05, 2007  R0.04b Added a configuration option _USE_NTFLAG.
-/                       Added FSInfo support.
-/                       Fixed DBCS name can result FR_INVALID_NAME.
-/                       Fixed short seek (<= csize) collapses the file object.
+/ Feb 04,'07 R0.04  Supported multiple drive system.
+/                   Changed some interfaces for multiple drive system.
+/                   Changed f_mountdrv() to f_mount().
+/                   Added f_mkfs().
+/ Apr 01,'07 R0.04a Supported multiple partitions on a plysical drive.
+/                   Added a capability of extending file size to f_lseek().
+/                   Added minimization level 3.
+/                   Fixed an endian sensitive code in f_mkfs().
+/ May 05,'07 R0.04b Added a configuration option _USE_NTFLAG.
+/                   Added FSInfo support.
+/                   Fixed DBCS name can result FR_INVALID_NAME.
+/                   Fixed short seek (<= csize) collapses the file object.
 /
-/  Aug 25, 2007  R0.05  Changed arguments of f_read(), f_write() and f_mkfs().
-/                       Fixed f_mkfs() on FAT32 creates incorrect FSInfo.
-/                       Fixed f_mkdir() on FAT32 creates incorrect directory.
-/  Feb 03, 2008  R0.05a Added f_truncate().
-/                       Added f_utime().
-/                       Fixed off by one error at FAT sub-type determination.
-/                       Fixed btr in f_read() can be mistruncated.
-/                       Fixed cached sector is not flushed when create and close without write.
+/ Aug 25,'07 R0.05  Changed arguments of f_read(), f_write() and f_mkfs().
+/                   Fixed f_mkfs() on FAT32 creates incorrect FSInfo.
+/                   Fixed f_mkdir() on FAT32 creates incorrect directory.
+/ Feb 03,'08 R0.05a Added f_truncate() and f_utime().
+/                   Fixed off by one error at FAT sub-type determination.
+/                   Fixed btr in f_read() can be mistruncated.
+/                   Fixed cached sector is not flushed when create and close
+/                   without write.
+/
+/ Apr 01,'08 R0.06  Added fputc(), fputs(), fprintf() and fgets().
+/                   Improved performance of f_lseek() on moving to the same
+/                   or following cluster.
 /---------------------------------------------------------------------------*/
 
 #include 
@@ -211,7 +215,7 @@ BOOL put_cluster (	/* TRUE: successful, FALSE: failed */
 		p = &fs->win[bc & (SS(fs) - 1)];
 		*p = (clust & 1) ? ((*p & 0x0F) | ((BYTE)val << 4)) : (BYTE)val;
 		bc++;
-		fs->winflag = 1; 
+		fs->winflag = 1;
 		if (!move_window(fs, fatsect + (bc / SS(fs)))) return FALSE;
 		p = &fs->win[bc & (SS(fs) - 1)];
 		*p = (clust & 1) ? (BYTE)(val >> 4) : ((*p & 0xF0) | ((BYTE)(val >> 8) & 0x0F));
@@ -309,8 +313,8 @@ DWORD create_chain (	/* 0: No free cluster, 1: Error, >=2: New cluster number */
 		if (ncl == scl) return 0;		/* No free custer */
 	}
 
-	if (!put_cluster(fs, ncl, 0x0FFFFFFF)) return 1;		/* Mark the new cluster "in use" */
-	if (clust && !put_cluster(fs, clust, ncl)) return 1;	/* Link it to previous one if needed */
+	if (!put_cluster(fs, ncl, 0x0FFFFFFF)) return 1;			/* Mark the new cluster "in use" */
+	if (clust != 0 && !put_cluster(fs, clust, ncl)) return 1;	/* Link it to previous one if needed */
 
 	fs->last_clust = ncl;				/* Update fsinfo */
 	if (fs->free_clust != 0xFFFFFFFF) {
@@ -339,7 +343,7 @@ DWORD clust2sect (	/* !=0: sector number, 0: failed - invalid cluster# */
 {
 	clust -= 2;
 	if (clust >= (fs->max_clust - 2)) return 0;		/* Invalid cluster# */
-	return clust * fs->sects_clust + fs->database;
+	return clust * fs->csize + fs->database;
 }
 
 
@@ -361,10 +365,10 @@ BOOL next_dir_entry (	/* TRUE: successful, FALSE: could not move next */
 	idx = dj->index + 1;
 	if ((idx & ((SS(dj->fs) - 1) / 32)) == 0) {		/* Table sector changed? */
 		dj->sect++;				/* Next sector */
-		if (!dj->clust) {		/* In static table */
+		if (dj->clust == 0) {	/* In static table */
 			if (idx >= dj->fs->n_rootdir) return FALSE;	/* Reached to end of table */
 		} else {					/* In dynamic table */
-			if (((idx / (SS(dj->fs) / 32)) & (dj->fs->sects_clust - 1)) == 0) {	/* Cluster changed? */
+			if (((idx / (SS(dj->fs) / 32)) & (dj->fs->csize - 1)) == 0) {	/* Cluster changed? */
 				clust = get_cluster(dj->fs, dj->clust);			/* Get next cluster */
 				if (clust < 2 || clust >= dj->fs->max_clust)	/* Reached to end of table */
 					return FALSE;
@@ -566,10 +570,10 @@ FRESULT reserve_direntry (	/* FR_OK: successful, FR_DENIED: no free entry, FR_RW
 
 	/* Re-initialize directory object */
 	clust = dj->sclust;
-	if (clust) {	/* Dyanmic directory table */
+	if (clust != 0) {	/* Dyanmic directory table */
 		dj->clust = clust;
 		dj->sect = clust2sect(fs, clust);
-	} else {		/* Static directory table */
+	} else {			/* Static directory table */
 		dj->sect = fs->dirbase;
 	}
 	dj->index = 0;
@@ -585,13 +589,13 @@ FRESULT reserve_direntry (	/* FR_OK: successful, FR_DENIED: no free entry, FR_RW
 	/* Reached to end of the directory table */
 
 	/* Abort when it is a static table or could not stretch dynamic table */
-	if (!clust || !(clust = create_chain(fs, dj->clust))) return FR_DENIED;
+	if (clust == 0 || !(clust = create_chain(fs, dj->clust))) return FR_DENIED;
 	if (clust == 1 || !move_window(fs, 0)) return FR_RW_ERROR;
 
 	/* Cleanup the expanded table */
 	fs->winsect = sector = clust2sect(fs, clust);
 	memset(fs->win, 0, SS(fs));
-	for (n = fs->sects_clust; n; n--) {
+	for (n = fs->csize; n; n--) {
 		if (disk_write(fs->drive, fs->win, sector, 1) != RES_OK)
 			return FR_RW_ERROR;
 		sector++;
@@ -711,13 +715,13 @@ FRESULT auto_mount (	/* FR_OK(0): successful, !=0: any error occured */
 	fs->n_fats = fs->win[BPB_NumFATs];					/* Number of FAT copies */
 	fatsize *= fs->n_fats;								/* (Number of sectors in FAT area) */
 	fs->fatbase = bootsect + LD_WORD(&fs->win[BPB_RsvdSecCnt]); /* FAT start sector (lba) */
-	fs->sects_clust = fs->win[BPB_SecPerClus];			/* Number of sectors per cluster */
+	fs->csize = fs->win[BPB_SecPerClus];				/* Number of sectors per cluster */
 	fs->n_rootdir = LD_WORD(&fs->win[BPB_RootEntCnt]);	/* Nmuber of root directory entries */
 	totalsect = LD_WORD(&fs->win[BPB_TotSec16]);		/* Number of sectors on the file system */
 	if (!totalsect) totalsect = LD_DWORD(&fs->win[BPB_TotSec32]);
 	fs->max_clust = maxclust = (totalsect				/* max_clust = Last cluster# + 1 */
 		- LD_WORD(&fs->win[BPB_RsvdSecCnt]) - fatsize - fs->n_rootdir / (SS(fs)/32)
-		) / fs->sects_clust + 2;
+		) / fs->csize + 2;
 
 	fmt = FS_FAT12;										/* Determine the FAT sub type */
 	if (maxclust >= 0xFF7) fmt = FS_FAT16;
@@ -822,7 +826,7 @@ FRESULT f_open (
 	char fn[8+3+1];
 
 
-	fp->fs = NULL;
+	fp->fs = NULL;		/* Clear file object */
 #if !_FS_READONLY
 	mode &= (FA_READ|FA_WRITE|FA_CREATE_ALWAYS|FA_OPEN_ALWAYS|FA_CREATE_NEW);
 	res = auto_mount(&path, &dj.fs, (BYTE)(mode & (FA_WRITE|FA_CREATE_ALWAYS|FA_OPEN_ALWAYS|FA_CREATE_NEW)));
@@ -881,7 +885,6 @@ FRESULT f_open (
 		if ((mode & FA_WRITE) && (dir[DIR_Attr] & AM_RDO)) /* R/O violation */
 			return FR_DENIED;
 	}
-
 	fp->dir_sect = dj.fs->winsect;		/* Pointer to the directory entry */
 	fp->dir_ptr = dir;
 #endif
@@ -889,8 +892,8 @@ FRESULT f_open (
 	fp->org_clust =						/* File start cluster */
 		((DWORD)LD_WORD(&dir[DIR_FstClusHI]) << 16) | LD_WORD(&dir[DIR_FstClusLO]);
 	fp->fsize = LD_DWORD(&dir[DIR_FileSize]);	/* File size */
-	fp->fptr = 0;						/* Initialze file pointer */
-	fp->sect_clust = 1;					/* Initialize sector counter */
+	fp->fptr = 0; fp->csect = 255;		/* File pointer */
+	fp->curr_sect = 0;
 	fp->fs = dj.fs; fp->id = dj.fs->id;	/* Owner file system object of the file */
 
 	return FR_OK;
@@ -922,46 +925,46 @@ FRESULT f_read (
 	if (fp->flag & FA__ERROR) return FR_RW_ERROR;	/* Check error flag */
 	if (!(fp->flag & FA_READ)) return FR_DENIED;	/* Check access mode */
 	remain = fp->fsize - fp->fptr;
-	if (btr > remain) btr = (UINT)remain;			/* Truncate read count by number of bytes left */
+	if (btr > remain) btr = (UINT)remain;			/* Truncate btr by remaining bytes */
 
 	for ( ;  btr;									/* Repeat until all data transferred */
 		rbuff += rcnt, fp->fptr += rcnt, *br += rcnt, btr -= rcnt) {
-		if ((fp->fptr & (SS(fp->fs) - 1)) == 0) {	/* On the sector boundary */
-			if (--fp->sect_clust) {					/* Decrement left sector counter */
-				sect = fp->curr_sect + 1;			/* Get current sector */
-			} else {								/* On the cluster boundary, get next cluster */
-				clust = (fp->fptr == 0) ?
+		if ((fp->fptr % SS(fp->fs)) == 0) {			/* On the sector boundary? */
+			if (fp->csect >= fp->fs->csize) {		/* On the cluster boundary? */
+				clust = (fp->fptr == 0) ?			/* On the top of the file? */
 					fp->org_clust : get_cluster(fp->fs, fp->curr_clust);
-				if (clust < 2 || clust >= fp->fs->max_clust)
-					goto fr_error;
-				fp->curr_clust = clust;				/* Current cluster */
-				sect = clust2sect(fp->fs, clust);	/* Get current sector */
-				fp->sect_clust = fp->fs->sects_clust;	/* Re-initialize the left sector counter */
+				if (clust < 2 || clust >= fp->fs->max_clust) goto fr_error;
+				fp->curr_clust = clust;				/* Update current cluster */
+				fp->csect = 0;						/* Reset sector address in the cluster */
 			}
-#if !_FS_READONLY
-			if (fp->flag & FA__DIRTY) {				/* Flush file I/O buffer if needed */
-				if (disk_write(fp->fs->drive, fp->buffer, fp->curr_sect, 1) != RES_OK)
-					goto fr_error;
-				fp->flag &= (BYTE)~FA__DIRTY;
-			}
-#endif
-			fp->curr_sect = sect;					/* Update current sector */
-			cc = btr / SS(fp->fs);					/* When left bytes >= SS, */
+			sect = clust2sect(fp->fs, fp->curr_clust) + fp->csect;	/* Get current sector */
+			cc = btr / SS(fp->fs);					/* When remaining bytes >= sector size, */
 			if (cc) {								/* Read maximum contiguous sectors directly */
-				if (cc > fp->sect_clust) cc = fp->sect_clust;
+				if (fp->csect + cc > fp->fs->csize)	/* Clip at cluster boundary */
+					cc = fp->fs->csize - fp->csect;
 				if (disk_read(fp->fs->drive, rbuff, sect, (BYTE)cc) != RES_OK)
 					goto fr_error;
-				fp->sect_clust -= (BYTE)(cc - 1);
-				fp->curr_sect += cc - 1;
-				rcnt = cc * SS(fp->fs);
+				fp->csect += (BYTE)cc;				/* Next sector address in the cluster */
+				rcnt = SS(fp->fs) * cc;				/* Number of bytes transferred */
 				continue;
 			}
-			if (disk_read(fp->fs->drive, fp->buffer, sect, 1) != RES_OK)	/* Load the sector into file I/O buffer */
-				goto fr_error;
+			if (sect != fp->curr_sect) {			/* Is window offset changed? */
+#if !_FS_READONLY
+				if (fp->flag & FA__DIRTY) {			/* Write back file I/O buffer if needed */
+					if (disk_write(fp->fs->drive, fp->buffer, fp->curr_sect, 1) != RES_OK)
+						goto fr_error;
+					fp->flag &= (BYTE)~FA__DIRTY;
+				}
+#endif
+				if (disk_read(fp->fs->drive, fp->buffer, sect, 1) != RES_OK)	/* Fill file I/O buffer with file data */
+					goto fr_error;
+				fp->curr_sect = sect;
+			}
+			fp->csect++;							/* Next sector address in the cluster */
 		}
-		rcnt = SS(fp->fs) - (fp->fptr & (SS(fp->fs) - 1));	/* Copy fractional bytes from file I/O buffer */
+		rcnt = SS(fp->fs) - (fp->fptr % SS(fp->fs));	/* Get partial sector from file I/O buffer */
 		if (rcnt > btr) rcnt = btr;
-		memcpy(rbuff, &fp->buffer[fp->fptr & (SS(fp->fs) - 1)], rcnt);
+		memcpy(rbuff, &fp->buffer[fp->fptr % SS(fp->fs)], rcnt);
 	}
 
 	return FR_OK;
@@ -1001,46 +1004,47 @@ FRESULT f_write (
 
 	for ( ;  btw;									/* Repeat until all data transferred */
 		wbuff += wcnt, fp->fptr += wcnt, *bw += wcnt, btw -= wcnt) {
-		if ((fp->fptr & (SS(fp->fs) - 1)) == 0) {	/* On the sector boundary */
-			if (--fp->sect_clust) {					/* Decrement left sector counter */
-				sect = fp->curr_sect + 1;			/* Get current sector */
-			} else {								/* On the cluster boundary, get next cluster */
-				if (fp->fptr == 0) {				/* Is top of the file */
-					clust = fp->org_clust;
-					if (clust == 0)					/* No cluster is created yet */
+		if ((fp->fptr % SS(fp->fs)) == 0) {			/* On the sector boundary? */
+			if (fp->csect >= fp->fs->csize) {		/* On the cluster boundary? */
+				if (fp->fptr == 0) {				/* On the top of the file? */
+					clust = fp->org_clust;			/* Follow from the origin */
+					if (clust == 0)					/* When there is no cluster chain, */
 						fp->org_clust = clust = create_chain(fp->fs, 0);	/* Create a new cluster chain */
-				} else {							/* Middle or end of file */
+				} else {							/* Middle or end of the file */
 					clust = create_chain(fp->fs, fp->curr_clust);			/* Trace or streach cluster chain */
 				}
-				if (clust == 0) break;				/* Disk full */
+				if (clust == 0) break;				/* Could not allocate a new cluster (disk full) */
 				if (clust == 1 || clust >= fp->fs->max_clust) goto fw_error;
-				fp->curr_clust = clust;				/* Current cluster */
-				sect = clust2sect(fp->fs, clust);	/* Get current sector */
-				fp->sect_clust = fp->fs->sects_clust;	/* Re-initialize the left sector counter */
+				fp->curr_clust = clust;				/* Update current cluster */
+				fp->csect = 0;						/* Reset sector address in the cluster */
 			}
-			if (fp->flag & FA__DIRTY) {				/* Flush file I/O buffer if needed */
-				if (disk_write(fp->fs->drive, fp->buffer, fp->curr_sect, 1) != RES_OK)
-					goto fw_error;
-				fp->flag &= (BYTE)~FA__DIRTY;
-			}
-			fp->curr_sect = sect;					/* Update current sector */
-			cc = btw / SS(fp->fs);					/* When left bytes >= SS, */
+			sect = clust2sect(fp->fs, fp->curr_clust) + fp->csect;	/* Get current sector */
+			cc = btw / SS(fp->fs);					/* When remaining bytes >= sector size, */
 			if (cc) {								/* Write maximum contiguous sectors directly */
-				if (cc > fp->sect_clust) cc = fp->sect_clust;
+				if (fp->csect + cc > fp->fs->csize)	/* Clip at cluster boundary */
+					cc = fp->fs->csize - fp->csect;
 				if (disk_write(fp->fs->drive, wbuff, sect, (BYTE)cc) != RES_OK)
 					goto fw_error;
-				fp->sect_clust -= (BYTE)(cc - 1);
-				fp->curr_sect += cc - 1;
-				wcnt = cc * SS(fp->fs);
+				fp->csect += (BYTE)cc;				/* Next sector address in the cluster */
+				wcnt = SS(fp->fs) * cc;				/* Number of bytes transferred */
 				continue;
 			}
-			if (fp->fptr < fp->fsize &&  			/* Fill sector buffer with file data if needed */
-				disk_read(fp->fs->drive, fp->buffer, sect, 1) != RES_OK)
-					goto fw_error;
+			if (sect != fp->curr_sect) {			/* Is window offset changed? */
+				if (fp->flag & FA__DIRTY) {			/* Write back file I/O buffer if needed */
+					if (disk_write(fp->fs->drive, fp->buffer, fp->curr_sect, 1) != RES_OK)
+						goto fw_error;
+					fp->flag &= (BYTE)~FA__DIRTY;
+				}
+				if (fp->fptr < fp->fsize &&  		/* Fill file I/O buffer with file data */
+					disk_read(fp->fs->drive, fp->buffer, sect, 1) != RES_OK)
+						goto fw_error;
+				fp->curr_sect = sect;
+			}
+			fp->csect++;							/* Next sector address in the cluster */
 		}
-		wcnt = SS(fp->fs) - (fp->fptr & (SS(fp->fs) - 1));	/* Copy fractional bytes to file I/O buffer */
+		wcnt = SS(fp->fs) - (fp->fptr % SS(fp->fs));	/* Put partial sector into file I/O buffer */
 		if (wcnt > btw) wcnt = btw;
-		memcpy(&fp->buffer[fp->fptr & (SS(fp->fs) - 1)], wbuff, wcnt);
+		memcpy(&fp->buffer[fp->fptr % SS(fp->fs)], wbuff, wcnt);
 		fp->flag |= FA__DIRTY;
 	}
 
@@ -1134,65 +1138,78 @@ FRESULT f_lseek (
 )
 {
 	FRESULT res;
-	DWORD clust, csize;
-	BYTE csect;
+	DWORD clust, csize, nsect, ifptr;
 
 
 	res = validate(fp->fs, fp->id);		/* Check validity of the object */
 	if (res != FR_OK) return res;
 	if (fp->flag & FA__ERROR) return FR_RW_ERROR;
+	if (ofs > fp->fsize					/* In read-only mode, clip offset with the file size */
 #if !_FS_READONLY
-	if (fp->flag & FA__DIRTY) {			/* Write-back dirty buffer if needed */
-		if (disk_write(fp->fs->drive, fp->buffer, fp->curr_sect, 1) != RES_OK)
-			goto fk_error;
-		fp->flag &= (BYTE)~FA__DIRTY;
-	}
-	if (ofs > fp->fsize && !(fp->flag & FA_WRITE))
-#else
-	if (ofs > fp->fsize)
+		 && !(fp->flag & FA_WRITE)
 #endif
-		ofs = fp->fsize;
-	fp->fptr = 0; fp->sect_clust = 1;		/* Set file R/W pointer to top of the file */
+		) ofs = fp->fsize;
 
-	/* Move file R/W pointer if needed */
-	if (ofs) {
-		clust = fp->org_clust;	/* Get start cluster */
+	ifptr = fp->fptr;
+	fp->fptr = 0; fp->csect = 255;
+	nsect = 0;
+	if (ofs > 0) {
+		csize = (DWORD)fp->fs->csize * SS(fp->fs);	/* Cluster size (byte) */
+		if (ifptr > 0 &&
+			(ofs - 1) / csize >= (ifptr - 1) / csize) {/* When seek to same or following cluster, */
+			fp->fptr = (ifptr - 1) & ~(csize - 1);	/* start from the current cluster */
+			ofs -= fp->fptr;
+			clust = fp->curr_clust;
+		} else {									/* When seek to back cluster, */
+			clust = fp->org_clust;					/* start from the first cluster */
 #if !_FS_READONLY
-		if (!clust) {			/* If the file does not have a cluster chain, create new cluster chain */
-			clust = create_chain(fp->fs, 0);
-			if (clust == 1) goto fk_error;
-			fp->org_clust = clust;
+			if (clust == 0) {						/* If no cluster chain, create a new chain */
+				clust = create_chain(fp->fs, 0);
+				if (clust == 1) goto fk_error;
+				fp->org_clust = clust;
+			}
+#endif
+			fp->curr_clust = clust;
 		}
-#endif
-		if (clust) {			/* If the file has a cluster chain, it can be followed */
-			csize = (DWORD)fp->fs->sects_clust * SS(fp->fs);	/* Cluster size in unit of byte */
-			for (;;) {									/* Loop to skip leading clusters */
-				fp->curr_clust = clust;					/* Update current cluster */
-				if (ofs <= csize) break;
+		if (clust != 0) {
+			while (ofs > csize) {					/* Cluster following loop */
 #if !_FS_READONLY
-				if (fp->flag & FA_WRITE)				/* Check if in write mode or not */
+				if (fp->flag & FA_WRITE) {			/* Check if in write mode or not */
 					clust = create_chain(fp->fs, clust);	/* Force streached if in write mode */
-				else
+					if (clust == 0) {				/* When disk gets full, clip file size */
+						ofs = csize; break;
+					}
+				} else
 #endif
-					clust = get_cluster(fp->fs, clust);	/* Only follow cluster chain if not in write mode */
-				if (clust == 0) {						/* Stop if could not follow the cluster chain */
-					ofs = csize; break;
-				}
-				if (clust == 1 || clust >= fp->fs->max_clust) goto fk_error;
-				fp->fptr += csize;						/* Update R/W pointer */
+					clust = get_cluster(fp->fs, clust);	/* Follow cluster chain if not in write mode */
+				if (clust < 2 || clust >= fp->fs->max_clust) goto fk_error;
+				fp->curr_clust = clust;
+				fp->fptr += csize;
 				ofs -= csize;
 			}
-			csect = (BYTE)((ofs - 1) / SS(fp->fs));		/* Sector offset in the cluster */
-			fp->curr_sect = clust2sect(fp->fs, clust) + csect;	/* Current sector */
-			if ((ofs & (SS(fp->fs) - 1)) &&				/* Load current sector if needed */
-				disk_read(fp->fs->drive, fp->buffer, fp->curr_sect, 1) != RES_OK)
-				goto fk_error;
-			fp->sect_clust = fp->fs->sects_clust - csect;	/* Left sector counter in the cluster */
-			fp->fptr += ofs;								/* Update file R/W pointer */
+			fp->fptr += ofs;
+			fp->csect = (BYTE)(ofs / SS(fp->fs));	/* Sector offset in the cluster */
+			if (ofs & (SS(fp->fs) - 1)) {
+				nsect = clust2sect(fp->fs, clust) + fp->csect;	/* Current sector */
+				fp->csect++;
+			}
 		}
 	}
+	if (nsect && nsect != fp->curr_sect) {
 #if !_FS_READONLY
-	if ((fp->flag & FA_WRITE) && fp->fptr > fp->fsize) {	/* Set updated flag if in write mode */
+		if (fp->flag & FA__DIRTY) {			/* Write-back dirty buffer if needed */
+			if (disk_write(fp->fs->drive, fp->buffer, fp->curr_sect, 1) != RES_OK)
+				goto fk_error;
+			fp->flag &= (BYTE)~FA__DIRTY;
+		}
+#endif
+		if (disk_read(fp->fs->drive, fp->buffer, nsect, 1) != RES_OK)
+			goto fk_error;
+		fp->curr_sect = nsect;
+	}
+
+#if !_FS_READONLY
+	if (fp->fptr > fp->fsize) {			/* Set changed flag if the file was extended */
 		fp->fsize = fp->fptr;
 		fp->flag |= FA__WRITTEN;
 	}
@@ -1499,7 +1516,7 @@ FRESULT f_mkdir (
 
 	fw = dj.fs->win;
 	memset(fw, 0, SS(dj.fs));				/* Clear the new directory table */
-	for (n = 1; n < dj.fs->sects_clust; n++) {
+	for (n = 1; n < dj.fs->csize; n++) {
 		if (disk_write(dj.fs->drive, fw, ++dsect, 1) != RES_OK)
 			return FR_RW_ERROR;
 	}
@@ -1643,19 +1660,24 @@ FRESULT f_rename (
 	return sync(dj.fs);
 }
 
+#endif /* !_FS_READONLY */
+#endif /* _FS_MINIMIZE == 0 */
+#endif /* _FS_MINIMIZE <= 1 */
+#endif /* _FS_MINIMIZE <= 2 */
 
 
-#if _USE_MKFS
+
+#if _USE_MKFS && !_FS_READONLY
 /*-----------------------------------------------------------------------*/
 /* Create File System on the Drive                                       */
 /*-----------------------------------------------------------------------*/
-
 #define N_ROOTDIR	512			/* Multiple of 32 and <= 2048 */
 #define N_FATS		1			/* 1 or 2 */
 #define MAX_SECTOR	64000000UL	/* Maximum partition size */
 #define MIN_SECTOR	2000UL		/* Minimum partition size */
 
 
+
 FRESULT f_mkfs (
 	BYTE drv,			/* Logical drive number */
 	BYTE partition,		/* Partitioning rule 0:FDISK, 1:SFD */
@@ -1781,12 +1803,15 @@ FRESULT f_mkfs (
 	ST_WORD(&tbl[BPB_SecPerTrk], 63);			/* Number of sectors per track */
 	ST_WORD(&tbl[BPB_NumHeads], 255);			/* Number of heads */
 	ST_DWORD(&tbl[BPB_HiddSec], b_part);		/* Hidden sectors */
+	n = get_fattime();							/* Use current time as a VSN */
 	if (fmt != FS_FAT32) {
+		ST_DWORD(&tbl[BS_VolID], n);			/* Volume serial number */
 		ST_WORD(&tbl[BPB_FATSz16], n_fat);		/* Number of secters per FAT */
 		tbl[BS_DrvNum] = 0x80;					/* Drive number */
 		tbl[BS_BootSig] = 0x29;					/* Extended boot signature */
 		memcpy(&tbl[BS_VolLab], "NO NAME    FAT     ", 19);	/* Volume lavel, FAT signature */
 	} else {
+		ST_DWORD(&tbl[BS_VolID32], n);			/* Volume serial number */
 		ST_DWORD(&tbl[BPB_FATSz32], n_fat);		/* Number of secters per FAT */
 		ST_DWORD(&tbl[BPB_RootClus], 2);		/* Root directory cluster (2) */
 		ST_WORD(&tbl[BPB_FSInfo], 1);			/* FSInfo record (bs+1) */
@@ -1842,9 +1867,170 @@ FRESULT f_mkfs (
 	return (disk_ioctl(drv, CTRL_SYNC, NULL) == RES_OK) ? FR_OK : FR_RW_ERROR;
 }
 
-#endif /* _USE_MKFS */
-#endif /* !_FS_READONLY */
-#endif /* _FS_MINIMIZE == 0 */
-#endif /* _FS_MINIMIZE <= 1 */
-#endif /* _FS_MINIMIZE <= 2 */
+#endif /* _USE_MKFS && !_FS_READONLY */
 
+
+
+
+#if _USE_STRFUNC >= 1
+/*-----------------------------------------------------------------------*/
+/* Get a string from the file                                            */
+/*-----------------------------------------------------------------------*/
+char* fgets (
+	char* buff,	/* Pointer to the string buffer to read */
+	int len,	/* Size of string buffer */
+	FIL* fil	/* Pointer to the file object */
+)
+{
+	int i = 0;
+	char *p = buff;
+	UINT rc;
+
+
+	while (i < len - 1) {			/* Read bytes until buffer gets filled */
+		f_read(fil, p, 1, &rc);
+		if (rc != 1) break;			/* Break when no data to read */
+#if _USE_STRFUNC >= 2
+		if (*p == '\r') continue;	/* Strip '\r' */
+#endif
+		i++;
+		if (*p++ == '\n') break;	/* Break when reached end of line */
+	}
+	*p = 0;
+	return i ? buff : 0;			/* When no data read (eof or error), return with error. */
+}
+
+
+
+#if !_FS_READONLY
+#include 
+/*-----------------------------------------------------------------------*/
+/* Put a character to the file                                           */
+/*-----------------------------------------------------------------------*/
+int fputc (
+	int chr,	/* A character to be output */
+	FIL* fil	/* Ponter to the file object */
+)
+{
+	UINT bw;
+	char c;
+
+
+#if _USE_STRFUNC >= 2
+	if (chr == '\n') fputc ('\r', fil);	/* LF -> CRLF conversion */
+#endif
+	if (!fil) {	/* Special value may be used to switch the destination to any other device */
+	/*	put_console(chr);	*/
+		return chr;
+	}
+	c = (char)chr;
+	f_write(fil, &c, 1, &bw);	/* Write a byte to the file */
+	return bw ? chr : EOF;		/* Return the resulut */
+}
+
+
+
+
+/*-----------------------------------------------------------------------*/
+/* Put a string to the file                                              */
+/*-----------------------------------------------------------------------*/
+int fputs (
+	const char* str,	/* Pointer to the string to be output */
+	FIL* fil			/* Pointer to the file object */
+)
+{
+	int n;
+
+
+	for (n = 0; *str; str++, n++) {
+		if (fputc(*str, fil) == EOF) return EOF;
+	}
+	return n;
+}
+
+
+
+
+/*-----------------------------------------------------------------------*/
+/* Put a formatted string to the file                                    */
+/*-----------------------------------------------------------------------*/
+int fprintf (
+	FIL* fil,			/* Pointer to the file object */
+	const char* str,	/* Pointer to the format string */
+	...					/* Optional arguments... */
+)
+{
+	va_list arp;
+	UCHAR c, f, r;
+	ULONG val;
+	char s[16];
+	int i, w, res, cc;
+
+
+	va_start(arp, str);
+
+	for (cc = res = 0; cc != EOF; res += cc) {
+		c = *str++;
+		if (c == 0) break;			/* End of string */
+		if (c != '%') {				/* Non escape cahracter */
+			cc = fputc(c, fil);
+			if (cc != EOF) cc = 1;
+			continue;
+		}
+		w = f = 0;
+		c = *str++;
+		if (c == '0') {				/* Flag: '0' padding */
+			f = 1; c = *str++;
+		}
+		while (c >= '0' && c <= '9') {	/* Precision */
+			w = w * 10 + (c - '0');
+			c = *str++;
+		}
+		if (c == 'l') {				/* Prefix: Size is long int */
+			f |= 2; c = *str++;
+		}
+		if (c == 's') {				/* Type is string */
+			cc = fputs(va_arg(arp, char*), fil);
+			continue;
+		}
+		if (c == 'c') {				/* Type is character */
+			cc = fputc(va_arg(arp, char), fil);
+			if (cc != EOF) cc = 1;
+			continue;
+		}
+		r = 0;
+		if (c == 'd') r = 10;		/* Type is signed decimal */
+		if (c == 'u') r = 10;		/* Type is unsigned decimal */
+		if (c == 'X') r = 16;		/* Type is unsigned hexdecimal */
+		if (r == 0) break;			/* Unknown type */
+		if (f & 2) {				/* Get the value */
+			val = (ULONG)va_arg(arp, long);
+		} else {
+			val = (c == 'd') ? (ULONG)(long)va_arg(arp, int) : (ULONG)va_arg(arp, unsigned int);
+		}
+		/* Put numeral string */
+		if (c == 'd') {
+			if (val >= 0x80000000) {
+				val = 0 - val;
+				f |= 4;
+			}
+		}
+		i = sizeof(s) - 1; s[i] = 0;
+		do {
+			c = (UCHAR)(val % r + '0');
+			if (c > '9') c += 7;
+			s[--i] = c;
+			val /= r;
+		} while (i && val);
+		if (i && (f & 4)) s[--i] = '-';
+		w = sizeof(s) - 1 - w;
+		while (i && i > w) s[--i] = (f & 1) ? '0' : ' ';
+		cc = fputs(&s[i], fil);
+	}
+
+	va_end(arp);
+	return (cc == EOF) ? cc : res;
+}
+
+#endif /* !_FS_READONLY */
+#endif /* _USE_STRFUNC >= 1*/
diff --git a/src/ff.h b/src/ff.h
index 8cd63d1..cbb86ab 100644
--- a/src/ff.h
+++ b/src/ff.h
@@ -1,5 +1,5 @@
 /*--------------------------------------------------------------------------/
-/  FatFs - FAT file system module include file  R0.05a       (C)ChaN, 2008
+/  FatFs - FAT file system module include file  R0.06        (C)ChaN, 2008
 /---------------------------------------------------------------------------/
 / FatFs module is an experimenal project to implement FAT file system to
 / cheap microcontrollers. This is a free software and is opened for education,
@@ -9,7 +9,7 @@
 /
 / * The FatFs module is a free software and there is no warranty.
 / * You can use, modify and/or redistribute it for personal, non-profit or
-/   profit use without any restriction under your responsibility.
+/   commercial use without any restriction under your responsibility.
 / * Redistributions of source code must retain the above copyright notice.
 /
 /---------------------------------------------------------------------------*/
@@ -36,13 +36,16 @@
 /  2: f_opendir and f_readdir are removed in addition to level 1.
 /  3: f_lseek is removed in addition to level 2. */
 
-#define _DRIVES		2
-/* Number of logical drives to be used. This affects the size of internal table. */
+#define	_USE_STRFUNC	0
+/* To enable string functions, set _USE_STRFUNC to 1 or 2. */
 
 #define	_USE_MKFS	0
 /* When _USE_MKFS is set to 1 and _FS_READONLY is set to 0, f_mkfs function is
 /  enabled. */
 
+#define _DRIVES		2
+/* Number of logical drives to be used. This affects the size of internal table. */
+
 #define	_MULTI_PARTITION	0
 /* When _MULTI_PARTITION is set to 0, each logical drive is bound to same
 /  physical drive number and can mount only 1st primaly partition. When it is
@@ -65,11 +68,11 @@
 
 
 /* Definitions corresponds to multiple sector size (not tested) */
-#define	S_MAX_SIZ	512			/* Do not change */
-#if S_MAX_SIZ > 512
+#define	S_MAX_SIZ	512U			/* Do not change */
+#if S_MAX_SIZ > 512U
 #define	SS(fs)	((fs)->s_size)
 #else
-#define	SS(fs)	512
+#define	SS(fs)	512U
 #endif
 
 
@@ -93,8 +96,8 @@ typedef struct _FATFS {
 #endif
 #endif
 	BYTE	fs_type;		/* FAT sub type */
-	BYTE	sects_clust;	/* Sectors per cluster */
-#if S_MAX_SIZ > 512
+	BYTE	csize;			/* Number of sectors per cluster */
+#if S_MAX_SIZ > 512U
 	WORD	s_size;			/* Sector size */
 #endif
 	BYTE	n_fats;			/* Number of FAT copies */
@@ -120,7 +123,7 @@ typedef struct _DIR {
 typedef struct _FIL {
 	WORD	id;				/* Owner file system mount ID */
 	BYTE	flag;			/* File status flags */
-	BYTE	sect_clust;		/* Left sectors in cluster */
+	BYTE	csect;			/* Sector address in the cluster */
 	FATFS*	fs;				/* Pointer to the owner file system object */
 	DWORD	fptr;			/* File R/W pointer */
 	DWORD	fsize;			/* File size */
@@ -209,7 +212,14 @@ FRESULT f_chmod (const char*, BYTE, BYTE);			/* Change file/dir attriburte */
 FRESULT f_utime (const char*, const FILINFO*);		/* Change file/dir timestamp */
 FRESULT f_rename (const char*, const char*);		/* Rename/Move a file or directory */
 FRESULT f_mkfs (BYTE, BYTE, WORD);					/* Create a file system on the drive */
-
+#if _USE_STRFUNC
+#define feof(fp) ((fp)->fptr == (fp)->fsize)
+#define EOF -1
+int fputc (int, FIL*);								/* Put a character to the file */
+int fputs (const char*, FIL*);						/* Put a string to the file */
+int fprintf (FIL*, const char*, ...);				/* Put a formatted string to the file */
+char* fgets (char*, int, FIL*);						/* Get a string from the file */
+#endif
 
 /* User defined function to give a current time to fatfs module */
 
diff --git a/src/integer.h b/src/integer.h
index 54f74ca..2d14ec8 100644
--- a/src/integer.h
+++ b/src/integer.h
@@ -5,7 +5,7 @@
 #ifndef _INTEGER
 
 /* These types must be 16-bit, 32-bit or larger integer */
-typedef signed int		INT;
+typedef int				INT;
 typedef unsigned int	UINT;
 
 /* These types must be 8-bit integer */
@@ -14,12 +14,12 @@ typedef unsigned char	UCHAR;
 typedef unsigned char	BYTE;
 
 /* These types must be 16-bit integer */
-typedef signed short	SHORT;
+typedef short			SHORT;
 typedef unsigned short	USHORT;
 typedef unsigned short	WORD;
 
 /* These types must be 32-bit integer */
-typedef signed long		LONG;
+typedef long			LONG;
 typedef unsigned long	ULONG;
 typedef unsigned long	DWORD;
 
diff --git a/src/tff.c b/src/tff.c
index c76dba8..dec3e71 100644
--- a/src/tff.c
+++ b/src/tff.c
@@ -1,6 +1,6 @@
-/*--------------------------------------------------------------------------/
-/  FatFs - Tiny FAT file system module  R0.05a                (C)ChaN, 2008
-/---------------------------------------------------------------------------/
+/*----------------------------------------------------------------------------/
+/  FatFs - Tiny FAT file system module  R0.06                 (C)ChaN, 2008
+/-----------------------------------------------------------------------------/
 / The FatFs module is an experimenal project to implement FAT file system to
 / cheap microcontrollers. This is a free software and is opened for education,
 / research and development under license policy of following trems.
@@ -9,42 +9,46 @@
 /
 / * The FatFs module is a free software and there is no warranty.
 / * You can use, modify and/or redistribute it for personal, non-profit or
-/   profit use without any restriction under your responsibility.
+/   commercial use without any restriction under your responsibility.
 / * Redistributions of source code must retain the above copyright notice.
 /
-/---------------------------------------------------------------------------/
-/  Feb 26, 2006  R0.00  Prototype.
+/-----------------------------------------------------------------------------/
+/ Feb 26,'06 R0.00  Prototype.
 /
-/  Apr 29, 2006  R0.01  First stable version.
+/ Apr 29,'06 R0.01  First stable version.
 /
-/  Jun 01, 2006  R0.02  Added FAT12 support.
-/                       Removed unbuffered mode.
-/                       Fixed a problem on small (<32M) patition.
-/  Jun 10, 2006  R0.02a Added a configuration option (_FS_MINIMUM).
+/ Jun 01,'06 R0.02  Added FAT12 support.
+/                   Removed unbuffered mode.
+/                   Fixed a problem on small (<32M) patition.
+/ Jun 10,'06 R0.02a Added a configuration option (_FS_MINIMUM).
 /
-/  Sep 22, 2006  R0.03  Added f_rename().
-/                       Changed option _FS_MINIMUM to _FS_MINIMIZE.
-/  Dec 09, 2006  R0.03a Improved cluster scan algolithm to write files fast.
+/ Sep 22,'06 R0.03  Added f_rename().
+/                   Changed option _FS_MINIMUM to _FS_MINIMIZE.
+/ Dec 09,'06 R0.03a Improved cluster scan algolithm to write files fast.
 /
-/  Feb 04, 2007  R0.04  Added FAT32 supprt.
-/                       Changed some interfaces incidental to FatFs.
-/                       Changed f_mountdrv() to f_mount().
-/  Apr 01, 2007  R0.04a Added a capability of extending file size to f_lseek().
-/                       Added minimization level 3.
-/                       Fixed a problem in FAT32 support.
-/  May 05, 2007  R0.04b Added a configuration option _USE_NTFLAG.
-/                       Added FSInfo support.
-/                       Fixed some problems corresponds to FAT32 support.
-/                       Fixed DBCS name can result FR_INVALID_NAME.
-/                       Fixed short seek (<= csize) collapses the file object.
+/ Feb 04,'07 R0.04  Added FAT32 supprt.
+/                   Changed some interfaces incidental to FatFs.
+/                   Changed f_mountdrv() to f_mount().
+/ Apr 01,'07 R0.04a Added a capability of extending file size to f_lseek().
+/                   Added minimization level 3.
+/                   Fixed a problem in FAT32 support.
+/ May 05,'07 R0.04b Added a configuration option _USE_NTFLAG.
+/                   Added FSInfo support.
+/                   Fixed some problems corresponds to FAT32 support.
+/                   Fixed DBCS name can result FR_INVALID_NAME.
+/                   Fixed short seek (<= csize) collapses the file object.
 /
-/  Aug 25, 2007  R0.05  Changed arguments of f_read() and f_write().
-/  Feb 03, 2008  R0.05a Added f_truncate().
-/                       Added f_utime().
-/                       Fixed off by one error at FAT sub-type determination.
-/                       Fixed btr in f_read() can be mistruncated.
-/                       Fixed cached sector is not flushed when create and close without write.
-/---------------------------------------------------------------------------*/
+/ Aug 25,'07 R0.05  Changed arguments of f_read() and f_write().
+/ Feb 03,'08 R0.05a Added f_truncate() and f_utime().
+/                   Fixed off by one error at FAT sub-type determination.
+/                   Fixed btr in f_read() can be mistruncated.
+/                   Fixed cached sector is not flushed when create and close
+/                   without write.
+/
+/ Apr 01,'08 R0.06  Added f_forward(), fputc(), fputs(), fprintf() and fgets().
+/                   Improved performance of f_lseek() on moving to the same
+/                   or following cluster.
+/----------------------------------------------------------------------------*/
 
 #include 
 #include "tff.h"		/* Tiny-FatFs declarations */
@@ -122,7 +126,7 @@ FRESULT sync (void)		/* FR_OK: successful, FR_RW_ERROR: failed */
 	/* Update FSInfo sector if needed */
 	if (fs->fs_type == FS_FAT32 && fs->fsi_flag) {
 		fs->winsect = 0;
-		memset(fs->win, 0, 512);
+		memset(fs->win, 0, 512U);
 		ST_WORD(&fs->win[BS_55AA], 0xAA55);
 		ST_DWORD(&fs->win[FSI_LeadSig], 0x41615252);
 		ST_DWORD(&fs->win[FSI_StrucSig], 0x61417272);
@@ -161,19 +165,19 @@ CLUST get_cluster (	/* 0,>=2: successful, 1: failed */
 		switch (fs->fs_type) {
 		case FS_FAT12 :
 			bc = (WORD)clust * 3 / 2;
-			if (!move_window(fatsect + bc / 512)) break;
-			wc = fs->win[bc % 512]; bc++;
-			if (!move_window(fatsect + bc / 512)) break;
-			wc |= (WORD)fs->win[bc % 512] << 8;
+			if (!move_window(fatsect + bc / 512U)) break;
+			wc = fs->win[bc % 512U]; bc++;
+			if (!move_window(fatsect + bc / 512U)) break;
+			wc |= (WORD)fs->win[bc % 512U] << 8;
 			return (clust & 1) ? (wc >> 4) : (wc & 0xFFF);
 
 		case FS_FAT16 :
 			if (!move_window(fatsect + clust / 256)) break;
-			return LD_WORD(&fs->win[((WORD)clust * 2) % 512]);
+			return LD_WORD(&fs->win[((WORD)clust * 2) % 512U]);
 #if _FAT32
 		case FS_FAT32 :
 			if (!move_window(fatsect + clust / 128)) break;
-			return LD_DWORD(&fs->win[((WORD)clust * 4) % 512]) & 0x0FFFFFFF;
+			return LD_DWORD(&fs->win[((WORD)clust * 4) % 512U]) & 0x0FFFFFFF;
 #endif
 		}
 	}
@@ -205,24 +209,24 @@ BOOL put_cluster (	/* TRUE: successful, FALSE: failed */
 	switch (fs->fs_type) {
 	case FS_FAT12 :
 		bc = (WORD)clust * 3 / 2;
-		if (!move_window(fatsect + bc / 512)) return FALSE;
-		p = &fs->win[bc % 512];
+		if (!move_window(fatsect + bc / 512U)) return FALSE;
+		p = &fs->win[bc % 512U];
 		*p = (clust & 1) ? ((*p & 0x0F) | ((BYTE)val << 4)) : (BYTE)val;
 		bc++;
-		fs->winflag = 1; 
-		if (!move_window(fatsect + bc / 512)) return FALSE;
-		p = &fs->win[bc % 512];
+		fs->winflag = 1;
+		if (!move_window(fatsect + bc / 512U)) return FALSE;
+		p = &fs->win[bc % 512U];
 		*p = (clust & 1) ? (BYTE)(val >> 4) : ((*p & 0xF0) | ((BYTE)(val >> 8) & 0x0F));
 		break;
 
 	case FS_FAT16 :
 		if (!move_window(fatsect + clust / 256)) return FALSE;
-		ST_WORD(&fs->win[((WORD)clust * 2) % 512], (WORD)val);
+		ST_WORD(&fs->win[((WORD)clust * 2) % 512U], (WORD)val);
 		break;
 #if _FAT32
 	case FS_FAT32 :
 		if (!move_window(fatsect + clust / 128)) return FALSE;
-		ST_DWORD(&fs->win[((WORD)clust * 4) % 512], val);
+		ST_DWORD(&fs->win[((WORD)clust * 4) % 512U], val);
 		break;
 #endif
 	default :
@@ -308,8 +312,8 @@ CLUST create_chain (	/* 0: No free cluster, 1: Error, >=2: New cluster number */
 		if (ncl == scl) return 0;		/* No free custer */
 	}
 
-	if (!put_cluster(ncl, (CLUST)0x0FFFFFFF)) return 1;	/* Mark the new cluster "in use" */
-	if (clust && !put_cluster(clust, ncl)) return 1;	/* Link it to previous one if needed */
+	if (!put_cluster(ncl, (CLUST)0x0FFFFFFF)) return 1;		/* Mark the new cluster "in use" */
+	if (clust != 0 && !put_cluster(clust, ncl)) return 1;	/* Link it to previous one if needed */
 
 	fs->last_clust = ncl;				/* Update fsinfo */
 	if (fs->free_clust != (CLUST)0xFFFFFFFF) {
@@ -340,7 +344,7 @@ DWORD clust2sect (	/* !=0: sector number, 0: failed - invalid cluster# */
 
 	clust -= 2;
 	if (clust >= (fs->max_clust - 2)) return 0;		/* Invalid cluster# */
-	return (DWORD)clust * fs->sects_clust + fs->database;
+	return (DWORD)clust * fs->csize + fs->database;
 }
 
 
@@ -362,10 +366,10 @@ BOOL next_dir_entry (	/* TRUE: successful, FALSE: could not move next */
 	idx = dj->index + 1;
 	if ((idx & 15) == 0) {		/* Table sector changed? */
 		dj->sect++;				/* Next sector */
-		if (!dj->clust) {		/* In static table */
+		if (dj->clust == 0) {	/* In static table */
 			if (idx >= dj->fs->n_rootdir) return FALSE;	/* Reached to end of table */
 		} else {				/* In dynamic table */
-			if (((idx / 16) & (dj->fs->sects_clust - 1)) == 0) {	/* Cluster changed? */
+			if (((idx / 16) & (dj->fs->csize - 1)) == 0) {	/* Cluster changed? */
 				clust = get_cluster(dj->clust);		/* Get next cluster */
 				if (clust < 2 || clust >= dj->fs->max_clust)	/* Reached to end of table */
 					return FALSE;
@@ -456,7 +460,7 @@ char make_dirfile (		/* 1: error - detected an invalid format, '\0'or'/': next c
 			}
 			break;
 		}
-		if (_USE_SJIS && 
+		if (_USE_SJIS &&
 			((c >= 0x81 && c <= 0x9F) ||		/* Accept S-JIS code */
 		    (c >= 0xE0 && c <= 0xFC))) {
 			if (n == 0 && c == 0xE5)		/* Change heading \xE5 to \x05 */
@@ -573,10 +577,10 @@ FRESULT reserve_direntry (	/* FR_OK: successful, FR_DENIED: no free entry, FR_RW
 
 	/* Re-initialize directory object */
 	clust = dj->sclust;
-	if (clust) {	/* Dyanmic directory table */
+	if (clust != 0) {	/* Dyanmic directory table */
 		dj->clust = clust;
 		dj->sect = clust2sect(clust);
-	} else {		/* Static directory table */
+	} else {			/* Static directory table */
 		dj->sect = fs->dirbase;
 	}
 	dj->index = 0;
@@ -592,12 +596,12 @@ FRESULT reserve_direntry (	/* FR_OK: successful, FR_DENIED: no free entry, FR_RW
 	/* Reached to end of the directory table */
 
 	/* Abort when static table or could not stretch dynamic table */
-	if (!clust || !(clust = create_chain(dj->clust))) return FR_DENIED;
+	if (clust == 0 || !(clust = create_chain(dj->clust))) return FR_DENIED;
 	if (clust == 1 || !move_window(0)) return FR_RW_ERROR;
 
 	fs->winsect = sector = clust2sect(clust);	/* Cleanup the expanded table */
-	memset(fs->win, 0, 512);
-	for (n = fs->sects_clust; n; n--) {
+	memset(fs->win, 0, 512U);
+	for (n = fs->csize; n; n--) {
 		if (disk_write(0, fs->win, sector, 1) != RES_OK)
 			return FR_RW_ERROR;
 		sector++;
@@ -695,7 +699,7 @@ FRESULT auto_mount (	/* FR_OK(0): successful, !=0: any error occured */
 			fmt = check_fs(bootsect);					/* Check the partition */
 		}
 	}
-	if (fmt || LD_WORD(&fs->win[BPB_BytsPerSec]) != 512)	/* No valid FAT patition is found */
+	if (fmt || LD_WORD(&fs->win[BPB_BytsPerSec]) != 512U)	/* No valid FAT patition is found */
 		return FR_NO_FILESYSTEM;
 
 	/* Initialize the file system object */
@@ -705,13 +709,13 @@ FRESULT auto_mount (	/* FR_OK(0): successful, !=0: any error occured */
 	fs->n_fats = fs->win[BPB_NumFATs];					/* Number of FAT copies */
 	fatsize *= fs->n_fats;								/* (Number of sectors in FAT area) */
 	fs->fatbase = bootsect + LD_WORD(&fs->win[BPB_RsvdSecCnt]);	/* FAT start sector (lba) */
-	fs->sects_clust = fs->win[BPB_SecPerClus];			/* Number of sectors per cluster */
+	fs->csize = fs->win[BPB_SecPerClus];				/* Number of sectors per cluster */
 	fs->n_rootdir = LD_WORD(&fs->win[BPB_RootEntCnt]);	/* Nmuber of root directory entries */
 	totalsect = LD_WORD(&fs->win[BPB_TotSec16]);		/* Number of sectors on the file system */
 	if (!totalsect) totalsect = LD_DWORD(&fs->win[BPB_TotSec32]);
 	fs->max_clust = maxclust = (totalsect				/* max_clust = Last cluster# + 1 */
 		- LD_WORD(&fs->win[BPB_RsvdSecCnt]) - fatsize - fs->n_rootdir / 16
-		) / fs->sects_clust + 2;
+		) / fs->csize + 2;
 
 	fmt = FS_FAT12;										/* Determine the FAT sub type */
 	if (maxclust >= 0xFF7) fmt = FS_FAT16;
@@ -819,7 +823,7 @@ FRESULT f_open (
 	char fn[8+3+1];
 
 
-	fp->fs = NULL;
+	fp->fs = NULL;		/* Clear file object */
 #if !_FS_READONLY
 	mode &= (FA_READ|FA_WRITE|FA_CREATE_ALWAYS|FA_OPEN_ALWAYS|FA_CREATE_NEW);
 	res = auto_mount(&path, (BYTE)(mode & (FA_WRITE|FA_CREATE_ALWAYS|FA_OPEN_ALWAYS|FA_CREATE_NEW)));
@@ -883,20 +887,18 @@ FRESULT f_open (
 		if ((mode & FA_WRITE) && (dir[DIR_Attr] & AM_RDO)) /* R/O violation */
 			return FR_DENIED;
 	}
-
-	fp->dir_sect = dj.fs->winsect;			/* Pointer to the directory entry */
+	fp->dir_sect = dj.fs->winsect;		/* Pointer to the directory entry */
 	fp->dir_ptr = dir;
 #endif
-	fp->flag = mode;						/* File access mode */
-	fp->org_clust =							/* File start cluster */
+	fp->flag = mode;					/* File access mode */
+	fp->org_clust =						/* File start cluster */
 #if _FAT32
 		((DWORD)LD_WORD(&dir[DIR_FstClusHI]) << 16) |
 #endif
 		LD_WORD(&dir[DIR_FstClusLO]);
 	fp->fsize = LD_DWORD(&dir[DIR_FileSize]);	/* File size */
-	fp->fptr = 0;							/* File ptr */
-	fp->sect_clust = 1;						/* Sector counter */
-	fp->fs = dj.fs; fp->id = dj.fs->id;		/* Owner file system object of the file */
+	fp->fptr = 0; fp->csect = 255;		/* File pointer */
+	fp->fs = dj.fs; fp->id = dj.fs->id;	/* Owner file system object of the file */
 
 	return FR_OK;
 }
@@ -928,38 +930,36 @@ FRESULT f_read (
 	if (fp->flag & FA__ERROR) return FR_RW_ERROR;	/* Check error flag */
 	if (!(fp->flag & FA_READ)) return FR_DENIED;	/* Check access mode */
 	remain = fp->fsize - fp->fptr;
-	if (btr > remain) btr = (UINT)remain;			/* Truncate read count by number of bytes left */
+	if (btr > remain) btr = (UINT)remain;			/* Truncate btr by remaining bytes */
 
 	for ( ;  btr;									/* Repeat until all data transferred */
 		rbuff += rcnt, fp->fptr += rcnt, *br += rcnt, btr -= rcnt) {
-		if ((fp->fptr % 512) == 0) {				/* On the sector boundary */
-			if (--fp->sect_clust) {					/* Decrement left sector counter */
-				sect = fp->curr_sect + 1;			/* Get current sector */
-			} else {								/* On the cluster boundary, get next cluster */
-				clust = (fp->fptr == 0) ?
+		if ((fp->fptr % 512U) == 0) {				/* On the sector boundary? */
+			if (fp->csect >= fp->fs->csize) {		/* On the cluster boundary? */
+				clust = (fp->fptr == 0) ?			/* On the top of the file? */
 					fp->org_clust : get_cluster(fp->curr_clust);
-				if (clust < 2 || clust >= fp->fs->max_clust)
-					goto fr_error;
-				fp->curr_clust = clust;				/* Current cluster */
-				sect = clust2sect(clust);			/* Get current sector */
-				fp->sect_clust = fp->fs->sects_clust;	/* Re-initialize the left sector counter */
+				if (clust < 2 || clust >= fp->fs->max_clust) goto fr_error;
+				fp->curr_clust = clust;				/* Update current cluster */
+				fp->csect = 0;						/* Reset sector address in the cluster */
 			}
-			fp->curr_sect = sect;					/* Update current sector */
-			cc = btr / 512;							/* When left bytes >= 512, */
+			sect = clust2sect(fp->curr_clust) + fp->csect;	/* Get current sector */
+			cc = btr / 512U;						/* When remaining bytes >= sector size, */
 			if (cc) {								/* Read maximum contiguous sectors directly */
-				if (cc > fp->sect_clust) cc = fp->sect_clust;
+				if (fp->csect + cc > fp->fs->csize)	/* Clip at cluster boundary */
+					cc = fp->fs->csize - fp->csect;
 				if (disk_read(0, rbuff, sect, (BYTE)cc) != RES_OK)
 					goto fr_error;
-				fp->sect_clust -= (BYTE)(cc - 1);
-				fp->curr_sect += cc - 1;
-				rcnt = cc * 512;
+				fp->csect += (BYTE)cc;				/* Next sector address in the cluster */
+				rcnt = 512U * cc;					/* Number of bytes transferred */
 				continue;
 			}
+			fp->csect++;							/* Next sector address in the cluster */
 		}
-		if (!move_window(fp->curr_sect)) goto fr_error;	/* Move sector window */
-		rcnt = 512 - (fp->fptr % 512);				/* Copy fractional bytes from sector window */
+		sect = clust2sect(fp->curr_clust) + fp->csect - 1;	/* Get current sector */
+		if (!move_window(sect)) goto fr_error;		/* Move sector window */
+		rcnt = 512U - (fp->fptr % 512U);			/* Get partial sector from sector window */
 		if (rcnt > btr) rcnt = btr;
-		memcpy(rbuff, &fp->fs->win[fp->fptr % 512], rcnt);
+		memcpy(rbuff, &fp->fs->win[fp->fptr % 512U], rcnt);
 	}
 
 	return FR_OK;
@@ -1000,50 +1000,48 @@ FRESULT f_write (
 
 	for ( ;  btw;									/* Repeat until all data transferred */
 		wbuff += wcnt, fp->fptr += wcnt, *bw += wcnt, btw -= wcnt) {
-		if ((fp->fptr % 512) == 0) {				/* On the sector boundary */
-			if (--fp->sect_clust) {					/* Decrement left sector counter */
-				sect = fp->curr_sect + 1;			/* Get current sector */
-			} else {								/* On the cluster boundary, get next cluster */
-				if (fp->fptr == 0) {				/* Is top of the file */
-					clust = fp->org_clust;
-					if (clust == 0)					/* No cluster is created yet */
+		if ((fp->fptr % 512U) == 0) {				/* On the sector boundary? */
+			if (fp->csect >= fp->fs->csize) {		/* On the cluster boundary? */
+				if (fp->fptr == 0) {				/* On the top of the file? */
+					clust = fp->org_clust;			/* Follow from the origin */
+					if (clust == 0)					/* When there is no cluster chain, */
 						fp->org_clust = clust = create_chain(0);	/* Create a new cluster chain */
-				} else {							/* Middle or end of file */
+				} else {							/* Middle or end of the file */
 					clust = create_chain(fp->curr_clust);			/* Trace or streach cluster chain */
 				}
-				if (clust == 0) break;				/* Disk full */
+				if (clust == 0) break;				/* Could not allocate a new cluster (disk full) */
 				if (clust == 1 || clust >= fp->fs->max_clust) goto fw_error;
-				fp->curr_clust = clust;				/* Current cluster */
-				sect = clust2sect(clust);			/* Get current sector */
-				fp->sect_clust = fp->fs->sects_clust;	/* Re-initialize the left sector counter */
+				fp->curr_clust = clust;				/* Update current cluster */
+				fp->csect = 0;						/* Reset sector address in the cluster */
 			}
-			fp->curr_sect = sect;					/* Update current sector */
-			cc = btw / 512;							/* When left bytes >= 512, */
+			sect = clust2sect(fp->curr_clust) + fp->csect;	/* Get current sector */
+			cc = btw / 512U;						/* When remaining bytes >= sector size, */
 			if (cc) {								/* Write maximum contiguous sectors directly */
-				if (cc > fp->sect_clust) cc = fp->sect_clust;
+				if (fp->csect + cc > fp->fs->csize)	/* Clip at cluster boundary */
+					cc = fp->fs->csize - fp->csect;
 				if (disk_write(0, wbuff, sect, (BYTE)cc) != RES_OK)
 					goto fw_error;
-				fp->sect_clust -= (BYTE)(cc - 1);
-				fp->curr_sect += cc - 1;
-				wcnt = cc * 512;
+				fp->csect += (BYTE)cc;				/* Next sector address in the cluster */
+				wcnt = 512U * cc;					/* Number of bytes transferred */
 				continue;
 			}
-			if (fp->fptr >= fp->fsize) {			/* Flush R/W window if needed */
+			if (fp->fptr >= fp->fsize) {			/* Flush R/W window without reading if needed */
 				if (!move_window(0)) goto fw_error;
-				fp->fs->winsect = fp->curr_sect;
+				fp->fs->winsect = sect;
 			}
+			fp->csect++;							/* Next sector address in the cluster */
 		}
-		if (!move_window(fp->curr_sect))			/* Move sector window */
-			goto fw_error;
-		wcnt = 512 - (fp->fptr % 512);				/* Copy fractional bytes bytes to sector window */
+		sect = clust2sect(fp->curr_clust) + fp->csect - 1;	/* Get current sector */
+		if (!move_window(sect)) goto fw_error;		/* Move sector window */
+		wcnt = 512U - (fp->fptr % 512U);			/* Put partial sector into sector window */
 		if (wcnt > btw) wcnt = btw;
-		memcpy(&fp->fs->win[fp->fptr % 512], wbuff, wcnt);
+		memcpy(&fp->fs->win[fp->fptr % 512U], wbuff, wcnt);
 		fp->fs->winflag = 1;
 	}
 
 	if (fp->fptr > fp->fsize) fp->fsize = fp->fptr;	/* Update file size if needed */
 	fp->flag |= FA__WRITTEN;						/* Set file changed flag */
-	return FR_OK;
+	return res;
 
 fw_error:	/* Abort this file due to an unrecoverable error */
 	fp->flag |= FA__ERROR;
@@ -1127,57 +1125,62 @@ FRESULT f_lseek (
 {
 	FRESULT res;
 	CLUST clust;
-	DWORD csize;
-	BYTE csect;
+	DWORD csize, ifptr;
 
 
 	res = validate(fp->fs, fp->id);			/* Check validity of the object */
 	if (res != FR_OK) return res;
 	if (fp->flag & FA__ERROR) return FR_RW_ERROR;
+	if (ofs > fp->fsize					/* In read-only mode, clip offset with the file size */
 #if !_FS_READONLY
-	if (ofs > fp->fsize && !(fp->flag & FA_WRITE))
-#else
-	if (ofs > fp->fsize)
+		 && !(fp->flag & FA_WRITE)
 #endif
-		ofs = fp->fsize;
-	fp->fptr = 0; fp->sect_clust = 1;		/* Set file R/W pointer to top of the file */
+		) ofs = fp->fsize;
 
-	/* Move file R/W pointer if needed */
-	if (ofs) {
-		clust = fp->org_clust;	/* Get start cluster */
+	ifptr = fp->fptr;
+	fp->fptr = 0; fp->csect = 255;
+	if (ofs > 0) {
+		csize = (DWORD)fp->fs->csize * 512U;		/* Cluster size (byte) */
+		if (ifptr > 0 &&
+			(ofs - 1) / csize >= (ifptr - 1) / csize) {/* When seek to same or following cluster, */
+			fp->fptr = (ifptr - 1) & ~(csize - 1);	/* start from the current cluster */
+			ofs -= fp->fptr;
+			clust = fp->curr_clust;
+		} else {									/* When seek to back cluster, */
+			clust = fp->org_clust;					/* start from the first cluster */
 #if !_FS_READONLY
-		if (!clust) {			/* If the file does not have a cluster chain, create new cluster chain */
-			clust = create_chain(0);
-			if (clust == 1) goto fk_error;
-			fp->org_clust = clust;
+			if (clust == 0) {						/* If no cluster chain, create a new chain */
+				clust = create_chain(0);
+				if (clust == 1) goto fk_error;
+				fp->org_clust = clust;
+			}
+#endif
+			fp->curr_clust = clust;
 		}
-#endif
-		if (clust) {			/* If the file has a cluster chain, it can be followed */
-			csize = (DWORD)fp->fs->sects_clust * 512;	/* Cluster size in unit of byte */
-			for (;;) {									/* Loop to skip leading clusters */
-				fp->curr_clust = clust;					/* Update current cluster */
-				if (ofs <= csize) break;
+		if (clust != 0) {
+			while (ofs > csize) {					/* Cluster following loop */
 #if !_FS_READONLY
-				if (fp->flag & FA_WRITE)				/* Check if in write mode or not */
-					clust = create_chain(clust);		/* Force streached if in write mode */
-				else
+				if (fp->flag & FA_WRITE) {			/* Check if in write mode or not */
+					clust = create_chain(clust);	/* Force streached if in write mode */
+					if (clust == 0) {				/* When disk gets full, clip file size */
+						ofs = csize; break;
+					}
+				} else
 #endif
-					clust = get_cluster(clust);			/* Only follow cluster chain if not in write mode */
-				if (clust == 0) {						/* Stop if could not follow the cluster chain */
-					ofs = csize; break;
-				}
-				if (clust == 1 || clust >= fp->fs->max_clust) goto fk_error;
-				fp->fptr += csize;						/* Update R/W pointer */
+					clust = get_cluster(clust);		/* Follow cluster chain if not in write mode */
+				if (clust < 2 || clust >= fp->fs->max_clust) goto fk_error;
+				fp->curr_clust = clust;
+				fp->fptr += csize;
 				ofs -= csize;
 			}
-			csect = (BYTE)((ofs - 1) / 512);			/* Sector offset in the cluster */
-			fp->curr_sect = clust2sect(clust) + csect;	/* Current sector */
-			fp->sect_clust = fp->fs->sects_clust - csect;	/* Left sector counter in the cluster */
-			fp->fptr += ofs;							/* Update file R/W pointer */
+			fp->fptr += ofs;
+			fp->csect = (BYTE)(ofs / 512U);	/* Sector offset in the cluster */
+			if (ofs % 512U) fp->csect++;
 		}
 	}
+
 #if !_FS_READONLY
-	if ((fp->flag & FA_WRITE) && fp->fptr > fp->fsize) {	/* Set updated flag if in write mode */
+	if (fp->fptr > fp->fsize) {			/* Set changed flag if the file was extended */
 		fp->fsize = fp->fptr;
 		fp->flag |= FA__WRITTEN;
 	}
@@ -1497,8 +1500,8 @@ FRESULT f_mkdir (
 	if (!move_window(dsect)) return FR_RW_ERROR;
 
 	fw = dj.fs->win;
-	memset(fw, 0, 512);						/* Clear the directory table */
-	for (n = 1; n < dj.fs->sects_clust; n++) {
+	memset(fw, 0, 512U);					/* Clear the directory table */
+	for (n = 1; n < dj.fs->csize; n++) {
 		if (disk_write(0, fw, ++dsect, 1) != RES_OK)
 			return FR_RW_ERROR;
 	}
@@ -1652,3 +1655,222 @@ FRESULT f_rename (
 #endif /* _FS_MINIMIZE <= 1 */
 #endif /* _FS_MINIMIZE <= 2 */
 
+
+#if _USE_FORWARD
+/*-----------------------------------------------------------------------*/
+/* Forward data to the stream directly                                   */
+/*-----------------------------------------------------------------------*/
+
+FRESULT f_forward (
+	FIL *fp, 						/* Pointer to the file object */
+	UINT (*func)(const BYTE*,UINT),	/* Pointer to the streaming function */
+	UINT btr,						/* Number of bytes to forward */
+	UINT *br						/* Pointer to number of bytes forwarded */
+)
+{
+	FRESULT res;
+	DWORD remain;
+	UINT rcnt;
+	CLUST clust;
+
+
+	*br = 0;
+	res = validate(fp->fs, fp->id);					/* Check validity of the object */
+	if (res != FR_OK) return res;
+	if (fp->flag & FA__ERROR) return FR_RW_ERROR;	/* Check error flag */
+	if (!(fp->flag & FA_READ)) return FR_DENIED;	/* Check access mode */
+	remain = fp->fsize - fp->fptr;
+	if (btr > remain) btr = (UINT)remain;			/* Truncate btr by remaining bytes */
+
+	for ( ;  btr && (*func)(NULL, 0);				/* Repeat until all data transferred */
+		fp->fptr += rcnt, *br += rcnt, btr -= rcnt) {
+		if ((fp->fptr % 512U) == 0) {				/* On the sector boundary? */
+			if (fp->csect >= fp->fs->csize) {		/* On the cluster boundary? */
+				clust = (fp->fptr == 0) ?			/* On the top of the file? */
+					fp->org_clust : get_cluster(fp->curr_clust);
+				if (clust < 2 || clust >= fp->fs->max_clust) goto ff_error;
+				fp->curr_clust = clust;				/* Update current cluster */
+				fp->csect = 0;						/* Reset sector address in the cluster */
+			}
+			fp->csect++;							/* Next sector address in the cluster */
+		}
+		if (!move_window(clust2sect(fp->curr_clust) + fp->csect - 1))	/* Move sector window */
+			goto ff_error;
+		rcnt = 512U - (WORD)(fp->fptr % 512U);		/* Forward data from sector window */
+		if (rcnt > btr) rcnt = btr;
+		rcnt = (*func)(&fp->fs->win[(WORD)fp->fptr % 512U], rcnt);
+		if (rcnt == 0) goto ff_error;
+	}
+
+	return FR_OK;
+
+ff_error:	/* Abort this function due to an unrecoverable error */
+	fp->flag |= FA__ERROR;
+	return FR_RW_ERROR;
+}
+#endif /* _USE_FORWARD */
+
+
+
+#if _USE_STRFUNC >= 1
+/*-----------------------------------------------------------------------*/
+/* Get a string from the file                                            */
+/*-----------------------------------------------------------------------*/
+char* fgets (
+	char* buff,	/* Pointer to the string buffer to read */
+	int len,	/* Size of string buffer */
+	FIL* fil	/* Pointer to the file object */
+)
+{
+	int i = 0;
+	char *p = buff;
+	UINT rc;
+
+
+	while (i < len - 1) {			/* Read bytes until buffer gets filled */
+		f_read(fil, p, 1, &rc);
+		if (rc != 1) break;			/* Break when no data to read */
+#if _USE_STRFUNC >= 2
+		if (*p == '\r') continue;	/* Strip '\r' */
+#endif
+		i++;
+		if (*p++ == '\n') break;	/* Break when reached end of line */
+	}
+	*p = 0;
+	return i ? buff : 0;			/* When no data read (eof or error), return with error. */
+}
+
+
+
+#if !_FS_READONLY
+#include 
+/*-----------------------------------------------------------------------*/
+/* Put a character to the file                                           */
+/*-----------------------------------------------------------------------*/
+int fputc (
+	int chr,	/* A character to be output */
+	FIL* fil	/* Ponter to the file object */
+)
+{
+	UINT bw;
+	char c;
+
+
+#if _USE_STRFUNC >= 2
+	if (chr == '\n') fputc ('\r', fil);	/* LF -> CRLF conversion */
+#endif
+	if (!fil) {	/* Special value may be used to switch the destination to any other device */
+	/*	put_console(chr);	*/
+		return chr;
+	}
+	c = (char)chr;
+	f_write(fil, &c, 1, &bw);	/* Write a byte to the file */
+	return bw ? chr : EOF;		/* Return the resulut */
+}
+
+
+
+
+/*-----------------------------------------------------------------------*/
+/* Put a string to the file                                              */
+/*-----------------------------------------------------------------------*/
+int fputs (
+	const char* str,	/* Pointer to the string to be output */
+	FIL* fil			/* Pointer to the file object */
+)
+{
+	int n;
+
+
+	for (n = 0; *str; str++, n++) {
+		if (fputc(*str, fil) == EOF) return EOF;
+	}
+	return n;
+}
+
+
+
+
+/*-----------------------------------------------------------------------*/
+/* Put a formatted string to the file                                    */
+/*-----------------------------------------------------------------------*/
+int fprintf (
+	FIL* fil,			/* Pointer to the file object */
+	const char* str,	/* Pointer to the format string */
+	...					/* Optional arguments... */
+)
+{
+	va_list arp;
+	UCHAR c, f, r;
+	ULONG val;
+	char s[16];
+	int i, w, res, cc;
+
+
+	va_start(arp, str);
+
+	for (cc = res = 0; cc != EOF; res += cc) {
+		c = *str++;
+		if (c == 0) break;			/* End of string */
+		if (c != '%') {				/* Non escape cahracter */
+			cc = fputc(c, fil);
+			if (cc != EOF) cc = 1;
+			continue;
+		}
+		w = f = 0;
+		c = *str++;
+		if (c == '0') {				/* Flag: '0' padding */
+			f = 1; c = *str++;
+		}
+		while (c >= '0' && c <= '9') {	/* Precision */
+			w = w * 10 + (c - '0');
+			c = *str++;
+		}
+		if (c == 'l') {				/* Prefix: Size is long int */
+			f |= 2; c = *str++;
+		}
+		if (c == 's') {				/* Type is string */
+			cc = fputs(va_arg(arp, char*), fil);
+			continue;
+		}
+		if (c == 'c') {				/* Type is character */
+			cc = fputc(va_arg(arp, char), fil);
+			if (cc != EOF) cc = 1;
+			continue;
+		}
+		r = 0;
+		if (c == 'd') r = 10;		/* Type is signed decimal */
+		if (c == 'u') r = 10;		/* Type is unsigned decimal */
+		if (c == 'X') r = 16;		/* Type is unsigned hexdecimal */
+		if (r == 0) break;			/* Unknown type */
+		if (f & 2) {				/* Get the value */
+			val = (ULONG)va_arg(arp, long);
+		} else {
+			val = (c == 'd') ? (ULONG)(long)va_arg(arp, int) : (ULONG)va_arg(arp, unsigned int);
+		}
+		/* Put numeral string */
+		if (c == 'd') {
+			if (val >= 0x80000000) {
+				val = 0 - val;
+				f |= 4;
+			}
+		}
+		i = sizeof(s) - 1; s[i] = 0;
+		do {
+			c = (UCHAR)(val % r + '0');
+			if (c > '9') c += 7;
+			s[--i] = c;
+			val /= r;
+		} while (i && val);
+		if (i && (f & 4)) s[--i] = '-';
+		w = sizeof(s) - 1 - w;
+		while (i && i > w) s[--i] = (f & 1) ? '0' : ' ';
+		cc = fputs(&s[i], fil);
+	}
+
+	va_end(arp);
+	return (cc == EOF) ? cc : res;
+}
+
+#endif /* !_FS_READONLY */
+#endif /* _USE_STRFUNC >= 1*/
diff --git a/src/tff.h b/src/tff.h
index cdccab4..264afe9 100644
--- a/src/tff.h
+++ b/src/tff.h
@@ -1,5 +1,5 @@
 /*--------------------------------------------------------------------------/
-/  Tiny-FatFs - FAT file system module include file  R0.05a   (C)ChaN, 2008
+/  Tiny-FatFs - FAT file system module include file  R0.06    (C)ChaN, 2008
 /---------------------------------------------------------------------------/
 / FatFs module is an experimenal project to implement FAT file system to
 / cheap microcontrollers. This is a free software and is opened for education,
@@ -9,7 +9,7 @@
 /
 / * The FatFs module is a free software and there is no warranty.
 / * You can use, modify and/or redistribute it for personal, non-profit or
-/   profit use without any restriction under your responsibility.
+/   commercial use without any restriction under your responsibility.
 / * Redistributions of source code must retain the above copyright notice.
 /
 /---------------------------------------------------------------------------*/
@@ -36,6 +36,12 @@
 /  2: f_opendir and f_readdir are removed in addition to level 1.
 /  3: f_lseek is removed in addition to level 2. */
 
+#define	_USE_STRFUNC	0
+/* To enable string functions, set _USE_STRFUNC to 1 or 2. */
+
+#define	_USE_FORWARD	0
+/* To enable f_forward function, set _USE_FORWARD to 1. */
+
 #define _FAT32	0
 /* To enable FAT32 support in addition of FAT12/16, set _FAT32 to 1. */
 
@@ -84,7 +90,7 @@ typedef struct _FATFS {
 #endif
 #endif
 	BYTE	fs_type;		/* FAT sub type */
-	BYTE	sects_clust;	/* Sectors per cluster */
+	BYTE	csize;			/* Number of sectors per cluster */
 	BYTE	n_fats;			/* Number of FAT copies */
 	BYTE	winflag;		/* win[] dirty flag (1:must be written back) */
 	BYTE	win[512];		/* Disk access window for Directory/FAT/File */
@@ -106,7 +112,7 @@ typedef struct _DIR {
 typedef struct _FIL {
 	WORD	id;				/* Owner file system mount ID */
 	BYTE	flag;			/* File status flags */
-	BYTE	sect_clust;		/* Left sectors in cluster */
+	BYTE	csect;			/* Sector address in the cluster */
 	FATFS*	fs;				/* Pointer to owner file system */
 	DWORD	fptr;			/* File R/W pointer */
 	DWORD	fsize;			/* File size */
@@ -145,13 +151,14 @@ typedef enum {
 	FR_WRITE_PROTECTED,	/* 9 */
 	FR_NOT_ENABLED,		/* 10 */
 	FR_NO_FILESYSTEM,	/* 11 */
-	FR_INVALID_OBJECT	/* 12 */
+	FR_INVALID_OBJECT,	/* 12 */
+	FR_MKFS_ABORTED		/* 13 (not used) */
 } FRESULT;
 
 
 
 /*-----------------------------------------------------*/
-/* FatFs module application interface                  */
+/* Tiny-FatFs module application interface             */
 
 FRESULT f_mount (BYTE, FATFS*);						/* Mount/Unmount a logical drive */
 FRESULT f_open (FIL*, const char*, BYTE);			/* Open or create a file */
@@ -170,6 +177,15 @@ FRESULT	f_mkdir (const char*);						/* Create a new directory */
 FRESULT f_chmod (const char*, BYTE, BYTE);			/* Change file/dir attriburte */
 FRESULT f_utime (const char*, const FILINFO*);		/* Change file/dir timestamp */
 FRESULT f_rename (const char*, const char*);		/* Rename/Move a file or directory */
+FRESULT f_forward (FIL*, UINT(*)(const BYTE*,UINT), UINT, UINT*);	/* Forward data to the stream */
+#if _USE_STRFUNC
+#define feof(fp) ((fp)->fptr == (fp)->fsize)
+#define EOF -1
+int fputc (int, FIL*);								/* Put a character to the file */
+int fputs (const char*, FIL*);						/* Put a string to the file */
+int fprintf (FIL*, const char*, ...);				/* Put a formatted string to the file */
+char* fgets (char*, int, FIL*);						/* Get a string from the file */
+#endif
 
 
 /* User defined function to give a current time to fatfs module */
    値意味
    値意味
    FA_READ読み出しモードで開きます。読み書きする場合はFA_WRITEと共に指定します。
    FA_WRITE書き込みモードで開きます。読み書きする場合はFA_READと共に指定します。
    FA_OPEN_EXISTING既存のファイルを開きます。ファイルが無いときはエラーになります。(デフォルト)