mayhem-firmware/firmware/chibios-portapack/ext/fatfs/doc/00index_e.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta http-equiv="Content-Style-Type" content="text/css">
<meta http-equiv="cache-control" content="no-cache">
<meta name="description" content="Open source FAT file system for embedded projects">
<link rel="start" title="Site Top" href="../../">
<link rel="up" title="Freewares" href="../../fsw_e.html">
<link rel="alternate" hreflang="en" title="Original" href="http://elm-chan.org/fsw/ff/00index_e.html">
<link rel="alternate" hreflang="ja" title="Japanese version" href="00index_j.html">
<link rel="stylesheet" href="css_e.css" type="text/css" media="screen" title="ELM Default">
<title>FatFs - Generic FAT File System Module (R0.12c)</title>
</head>

<body>
<h1>FatFs - Generic FAT File System Module (R0.12c)</h1>
<hr>

<div class="abst">
<img src="res/layers.png" class="rset" width="245" height="255" alt="layer">
<p>FatFs is a generic FAT/exFAT file system module for small embedded systems. The FatFs module is written in compliance with ANSI C (C89) and completely separated from the disk I/O layer. Therefore it is independent of the platform. It can be incorporated into small microcontrollers with limited resource, such as 8051, PIC, AVR, ARM, Z80, 78K and etc. Also Petit FatFs module for tiny microcontrollers is available <a href="http://elm-chan.org/fsw/ff/00index_p.html">here</a>.</p>

<h4>Features</h4>
<ul>
 <li>DOS/Windows compatible FAT/exFAT file system.</li>
 <li>Platform independent. Easy to port.</li>
 <li>Very small footprint for program code and work area.</li>
 <li>Various <a href="en/config.html">configuration options</a> to support for:
  <ul>
   <li>Multiple volumes (physical drives and partitions).</li>
   <li>Multiple ANSI/OEM code pages including DBCS.</li>
   <li>Long file name in ANSI/OEM or Unicode.</li>
   <li>exFAT file system.</li>
   <li>RTOS envilonment.</li>
   <li>Fixed or variable sector size.</li>
   <li>Read-only, optional API, I/O buffer and etc...</li>
  </ul>
 </li>
</ul>
</div>


<div class="para">
<h3>Application Interface</h3>
<img src="res/layers1.png" class="rset" width="245" height="220" alt="layer">
<p>FatFs provides various file control functions for the applications as shown below.</p>
<ul>
 <li>File Access
 <ul>
  <li><a href="en/open.html">f_open</a> - Open/Create a file</li>
  <li><a href="en/close.html">f_close</a> - Close an open file</li>
  <li><a href="en/read.html">f_read</a> - Read data</li>
  <li><a href="en/write.html">f_write</a> - Write data</li>
  <li><a href="en/lseek.html">f_lseek</a> - Move read/write pointer, Expand size</li>
  <li><a href="en/truncate.html">f_truncate</a> - Truncate size</li>
  <li><a href="en/sync.html">f_sync</a> - Flush cached data</li>
  <li><a href="en/forward.html">f_forward</a> - Forward data to the stream</li>
  <li><a href="en/expand.html">f_expand</a> - Allocate a contiguous block to the file</li>
  <li><a href="en/gets.html">f_gets</a> - Read a string</li>
  <li><a href="en/putc.html">f_putc</a> - Write a character</li>
  <li><a href="en/puts.html">f_puts</a> - Write a string</li>
  <li><a href="en/printf.html">f_printf</a> - Write a formatted string</li>
  <li><a href="en/tell.html">f_tell</a> - Get current read/write pointer</li>
  <li><a href="en/eof.html">f_eof</a> - Test for end-of-file</li>
  <li><a href="en/size.html">f_size</a> - Get size</li>
  <li><a href="en/error.html">f_error</a> - Test for an error</li>
 </ul>
 </li>
 <li>Directory Access
 <ul>
  <li><a href="en/opendir.html">f_opendir</a> - Open a directory</li>
  <li><a href="en/closedir.html">f_closedir</a> - Close an open directory</li>
  <li><a href="en/readdir.html">f_readdir</a> - Read an directory item</li>
  <li><a href="en/findfirst.html">f_findfirst</a> - Open a directory and read first item matched</li>
  <li><a href="en/findnext.html">f_findnext</a> - Read a next item matched</li>
 </ul>
 </li>
 <li>File/Directory Management
 <ul>
  <li><a href="en/stat.html">f_stat</a> - Check existance of a file or sub-directory</li>
  <li><a href="en/unlink.html">f_unlink</a> - Remove a file or sub-directory</li>
  <li><a href="en/rename.html">f_rename</a> - Rename or move a file or sub-directory</li>
  <li><a href="en/chmod.html">f_chmod</a> - Change attribute of a file or sub-directory</li>
  <li><a href="en/utime.html">f_utime</a> - Change timestamp of a file or sub-directory</li>
  <li><a href="en/mkdir.html">f_mkdir</a> - Create a sub-directory</li>
  <li><a href="en/chdir.html">f_chdir</a> - Change current directory</li>
  <li><a href="en/chdrive.html">f_chdrive</a> - Change current drive</li>
  <li><a href="en/getcwd.html">f_getcwd</a> - Retrieve the current directory and drive</li>
 </ul>
 </li>
 <li>Volume Management
 <ul>
  <li><a href="en/mount.html">f_mount</a> - Register/Unregister a work area of a volume</li>
  <li><a href="en/mkfs.html">f_mkfs</a> - Create an FAT volume on the logical drive</li>
  <li><a href="en/fdisk.html">f_fdisk</a> - Create logical drives on the physical drive</li>
  <li><a href="en/getfree.html">f_getfree</a> - Get total size and free size on the volume</li>
  <li><a href="en/getlabel.html">f_getlabel</a> - Get volume label</li>
  <li><a href="en/setlabel.html">f_setlabel</a> - Set volume label</li>
 </ul>
 </li>
</ul>
</div>


<div class="para">
<h3>Media Access Interface</h3>
<img src="res/layers2.png" class="rset" width="245" height="220" alt="layer">
<p>Since the FatFs module is just a file system layer independent of platform and storage device. It is completely separated from the physical devices, such as memory card, harddisk and any type of storage device. The low level device control module is <em>not a part of FatFs module</em> and it needs to be provided by implementer. FatFs accesses the storage devices via a simple media access interface shown below. Also sample implementations for some platforms are available in the downloads.</p>
<ul>
 <li><a href="en/dstat.html">disk_status</a> - Get device status</li>
 <li><a href="en/dinit.html">disk_initialize</a> - Initialize device</li>
 <li><a href="en/dread.html">disk_read</a> - Read sector(s)</li>
 <li><a href="en/dwrite.html">disk_write</a> - Write sector(s)</li>
 <li><a href="en/dioctl.html">disk_ioctl</a> - Control device dependent functions</li>
 <li><a href="en/fattime.html">get_fattime</a> - Get current time</li>
</ul>
</div>


<div class="para">
<h3>Resources</h3>
<p>The FatFs module is a free software opened for education, research and development. You can use, modify and/or redistribute it for personal projects or commercial products without any restriction under your responsibility. For further information, refer to the application note.</p>
<ul>
 <li>Read first: <a href="en/appnote.html">FatFs module application note</a></li>
 <li>Community: <a href="http://elm-chan.org/fsw/ff/bd/">FatFs User Forum</a></li>
 <li><a href="https://msdn.microsoft.com/en-us/windows/hardware/gg463080.aspx">FAT32 Specification by Microsoft</a>↗ (The authorized document on FAT file system)</li>
 <li><a href="http://elm-chan.org/docs/fat.html">The basics of FAT file system [ja]</a></li>
 <li><a href="http://elm-chan.org/docs/mmc/mmc_e.html">How to Use MMC/SDC</a></li>
 <li><a href="http://elm-chan.org/junk/fa/faff.html">Playing with FlashAir and FatFs</a></li>
 <li><a href="http://stm32f4-discovery.com/2014/07/library-21-read-sd-card-fatfs-stm32f4xx-devices/">Read SD card with FatFs on STM32F4xx devices by Tilen Majerle</a>↗ (Quick and easy implementation for STM32F4-Discovery)</li>
 <li><a href="http://nemuisan.blog.bai.ne.jp/">Nemuisan's Blog</a>↗ (Well written implementations for STM32F/SPI &amp; SDIO and LPC4088/SDMMC)</li>
 <li><a href="http://www.siwawi.arubi.uni-kl.de/avr_projects/arm_projects/arm_memcards/index.html">ARM-Projects by Martin THOMAS</a>↗ (Examples for LPC2000, AT91SAM and STM32)</li>
 <li><a href="res/rwtest1.png">Benchmark 1</a> (ATmega1284/20MHz with MMC via USART in SPI, CFC via GPIO)</li>
 <li><a href="res/rwtest2.png">Benchmark 2</a> (LPC2368/72MHz with MMC via MCI)</li>
</div>


<hr>
<p class="foot"><a href="http://elm-chan.org/fsw/ff/00index_e.html">FatFs Homepage</a></p>
</body>
</html>
Initial firmware commit. 2015-07-08 15:39:24 +00:00			`<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">`
			`<html lang="en">`
			`<head>`
			`<meta http-equiv="Content-Type" content="text/html; charset=utf-8">`
			`<meta http-equiv="Content-Style-Type" content="text/css">`
			`<meta http-equiv="cache-control" content="no-cache">`
			`<meta name="description" content="Open source FAT file system for embedded projects">`
			`<link rel="start" title="Site Top" href="../../">`
			`<link rel="up" title="Freewares" href="../../fsw_e.html">`
			`<link rel="alternate" hreflang="en" title="Original" href="http://elm-chan.org/fsw/ff/00index_e.html">`
			`<link rel="alternate" hreflang="ja" title="Japanese version" href="00index_j.html">`
			`<link rel="stylesheet" href="css_e.css" type="text/css" media="screen" title="ELM Default">`
FatFs: Update to release R0.12c. 2017-05-03 11:39:05 +00:00			`<title>FatFs - Generic FAT File System Module (R0.12c)</title>`
Initial firmware commit. 2015-07-08 15:39:24 +00:00			`</head>`

			`<body>`
FatFs: Update to release R0.12c. 2017-05-03 11:39:05 +00:00			`<h1>FatFs - Generic FAT File System Module (R0.12c)</h1>`
Initial firmware commit. 2015-07-08 15:39:24 +00:00			`<hr>`

			`<div class="abst">`
FatFs: Update to R0.12a. 2016-07-29 06:06:21 +00:00			`<img src="res/layers.png" class="rset" width="245" height="255" alt="layer">`
			`<p>FatFs is a generic FAT/exFAT file system module for small embedded systems. The FatFs module is written in compliance with ANSI C (C89) and completely separated from the disk I/O layer. Therefore it is independent of the platform. It can be incorporated into small microcontrollers with limited resource, such as 8051, PIC, AVR, ARM, Z80, 78K and etc. Also Petit FatFs module for tiny microcontrollers is available <a href="http://elm-chan.org/fsw/ff/00index_p.html">here</a>.</p>`
Initial firmware commit. 2015-07-08 15:39:24 +00:00
			`<h4>Features</h4>`
			`<ul>`
FatFs: Update to release R0.12c. 2017-05-03 11:39:05 +00:00			`<li>DOS/Windows compatible FAT/exFAT file system.</li>`
Initial firmware commit. 2015-07-08 15:39:24 +00:00			`<li>Platform independent. Easy to port.</li>`
FatFs: Update to R0.12a. 2016-07-29 06:06:21 +00:00			`<li>Very small footprint for program code and work area.</li>`
			`<li>Various <a href="en/config.html">configuration options</a> to support for:`
Initial firmware commit. 2015-07-08 15:39:24 +00:00			`<ul>`
			`<li>Multiple volumes (physical drives and partitions).</li>`
			`<li>Multiple ANSI/OEM code pages including DBCS.</li>`
FatFs: Update to R0.12a. 2016-07-29 06:06:21 +00:00			`<li>Long file name in ANSI/OEM or Unicode.</li>`
			`<li>exFAT file system.</li>`
			`<li>RTOS envilonment.</li>`
			`<li>Fixed or variable sector size.</li>`
			`<li>Read-only, optional API, I/O buffer and etc...</li>`
Initial firmware commit. 2015-07-08 15:39:24 +00:00			`</ul>`
			`</li>`
			`</ul>`
			`</div>`


			`<div class="para">`
			`<h3>Application Interface</h3>`
FatFs: Update to R0.12a. 2016-07-29 06:06:21 +00:00			`<img src="res/layers1.png" class="rset" width="245" height="220" alt="layer">`
FatFs: Update to release R0.12c. 2017-05-03 11:39:05 +00:00			`<p>FatFs provides various file control functions for the applications as shown below.</p>`
Initial firmware commit. 2015-07-08 15:39:24 +00:00			`<ul>`
FatFs update to R0.11a. 2016-04-19 16:51:31 +00:00			`<li>File Access`
			`<ul>`
			`<li><a href="en/open.html">f_open</a> - Open/Create a file</li>`
			`<li><a href="en/close.html">f_close</a> - Close an open file</li>`
			`<li><a href="en/read.html">f_read</a> - Read data</li>`
			`<li><a href="en/write.html">f_write</a> - Write data</li>`
			`<li><a href="en/lseek.html">f_lseek</a> - Move read/write pointer, Expand size</li>`
			`<li><a href="en/truncate.html">f_truncate</a> - Truncate size</li>`
			`<li><a href="en/sync.html">f_sync</a> - Flush cached data</li>`
			`<li><a href="en/forward.html">f_forward</a> - Forward data to the stream</li>`
FatFs: Update to R0.12a. 2016-07-29 06:06:21 +00:00			`<li><a href="en/expand.html">f_expand</a> - Allocate a contiguous block to the file</li>`
FatFs update to R0.11a. 2016-04-19 16:51:31 +00:00			`<li><a href="en/gets.html">f_gets</a> - Read a string</li>`
			`<li><a href="en/putc.html">f_putc</a> - Write a character</li>`
			`<li><a href="en/puts.html">f_puts</a> - Write a string</li>`
			`<li><a href="en/printf.html">f_printf</a> - Write a formatted string</li>`
			`<li><a href="en/tell.html">f_tell</a> - Get current read/write pointer</li>`
			`<li><a href="en/eof.html">f_eof</a> - Test for end-of-file</li>`
			`<li><a href="en/size.html">f_size</a> - Get size</li>`
			`<li><a href="en/error.html">f_error</a> - Test for an error</li>`
			`</ul>`
			`</li>`
			`<li>Directory Access`
			`<ul>`
			`<li><a href="en/opendir.html">f_opendir</a> - Open a directory</li>`
			`<li><a href="en/closedir.html">f_closedir</a> - Close an open directory</li>`
FatFs: Update to R0.12a. 2016-07-29 06:06:21 +00:00			`<li><a href="en/readdir.html">f_readdir</a> - Read an directory item</li>`
			`<li><a href="en/findfirst.html">f_findfirst</a> - Open a directory and read first item matched</li>`
			`<li><a href="en/findnext.html">f_findnext</a> - Read a next item matched</li>`
FatFs update to R0.11a. 2016-04-19 16:51:31 +00:00			`</ul>`
			`</li>`
			`<li>File/Directory Management`
			`<ul>`
			`<li><a href="en/stat.html">f_stat</a> - Check existance of a file or sub-directory</li>`
			`<li><a href="en/unlink.html">f_unlink</a> - Remove a file or sub-directory</li>`
			`<li><a href="en/rename.html">f_rename</a> - Rename or move a file or sub-directory</li>`
			`<li><a href="en/chmod.html">f_chmod</a> - Change attribute of a file or sub-directory</li>`
			`<li><a href="en/utime.html">f_utime</a> - Change timestamp of a file or sub-directory</li>`
			`<li><a href="en/mkdir.html">f_mkdir</a> - Create a sub-directory</li>`
			`<li><a href="en/chdir.html">f_chdir</a> - Change current directory</li>`
			`<li><a href="en/chdrive.html">f_chdrive</a> - Change current drive</li>`
			`<li><a href="en/getcwd.html">f_getcwd</a> - Retrieve the current directory and drive</li>`
			`</ul>`
			`</li>`
			`<li>Volume Management`
			`<ul>`
			`<li><a href="en/mount.html">f_mount</a> - Register/Unregister a work area of a volume</li>`
			`<li><a href="en/mkfs.html">f_mkfs</a> - Create an FAT volume on the logical drive</li>`
			`<li><a href="en/fdisk.html">f_fdisk</a> - Create logical drives on the physical drive</li>`
			`<li><a href="en/getfree.html">f_getfree</a> - Get total size and free size on the volume</li>`
			`<li><a href="en/getlabel.html">f_getlabel</a> - Get volume label</li>`
			`<li><a href="en/setlabel.html">f_setlabel</a> - Set volume label</li>`
			`</ul>`
			`</li>`
Initial firmware commit. 2015-07-08 15:39:24 +00:00			`</ul>`
			`</div>`


			`<div class="para">`
FatFs: Update to release R0.12c. 2017-05-03 11:39:05 +00:00			`<h3>Media Access Interface</h3>`
FatFs: Update to R0.12a. 2016-07-29 06:06:21 +00:00			`<img src="res/layers2.png" class="rset" width="245" height="220" alt="layer">`
FatFs: Update to release R0.12c. 2017-05-03 11:39:05 +00:00			`<p>Since the FatFs module is just a file system layer independent of platform and storage device. It is completely separated from the physical devices, such as memory card, harddisk and any type of storage device. The low level device control module is <em>not a part of FatFs module</em> and it needs to be provided by implementer. FatFs accesses the storage devices via a simple media access interface shown below. Also sample implementations for some platforms are available in the downloads.</p>`
Initial firmware commit. 2015-07-08 15:39:24 +00:00			`<ul>`
			`<li><a href="en/dstat.html">disk_status</a> - Get device status</li>`
			`<li><a href="en/dinit.html">disk_initialize</a> - Initialize device</li>`
			`<li><a href="en/dread.html">disk_read</a> - Read sector(s)</li>`
			`<li><a href="en/dwrite.html">disk_write</a> - Write sector(s)</li>`
FatFs: Update to R0.12a. 2016-07-29 06:06:21 +00:00			`<li><a href="en/dioctl.html">disk_ioctl</a> - Control device dependent functions</li>`
Initial firmware commit. 2015-07-08 15:39:24 +00:00			`<li><a href="en/fattime.html">get_fattime</a> - Get current time</li>`
			`</ul>`
			`</div>`


			`<div class="para">`
			`<h3>Resources</h3>`
			`<p>The FatFs module is a free software opened for education, research and development. You can use, modify and/or redistribute it for personal projects or commercial products without any restriction under your responsibility. For further information, refer to the application note.</p>`
			`<ul>`
FatFs: Update to release R0.12c. 2017-05-03 11:39:05 +00:00			`<li>Read first: <a href="en/appnote.html">FatFs module application note</a></li>`
FatFs update to R0.11a. 2016-04-19 16:51:31 +00:00			`<li>Community: <a href="http://elm-chan.org/fsw/ff/bd/">FatFs User Forum</a></li>`
FatFs: Update to R0.12a. 2016-07-29 06:06:21 +00:00			`<li><a href="https://msdn.microsoft.com/en-us/windows/hardware/gg463080.aspx">FAT32 Specification by Microsoft</a>↗ (The authorized document on FAT file system)</li>`
FatFs update to R0.11a. 2016-04-19 16:51:31 +00:00			`<li><a href="http://elm-chan.org/docs/fat.html">The basics of FAT file system [ja]</a></li>`
			`<li><a href="http://elm-chan.org/docs/mmc/mmc_e.html">How to Use MMC/SDC</a></li>`
FatFs: Update to R0.12a. 2016-07-29 06:06:21 +00:00			`<li><a href="http://elm-chan.org/junk/fa/faff.html">Playing with FlashAir and FatFs</a></li>`
			`<li><a href="http://stm32f4-discovery.com/2014/07/library-21-read-sd-card-fatfs-stm32f4xx-devices/">Read SD card with FatFs on STM32F4xx devices by Tilen Majerle</a>↗ (Quick and easy implementation for STM32F4-Discovery)</li>`
			`<li><a href="http://nemuisan.blog.bai.ne.jp/">Nemuisan's Blog</a>↗ (Well written implementations for STM32F/SPI & SDIO and LPC4088/SDMMC)</li>`
			`<li><a href="http://www.siwawi.arubi.uni-kl.de/avr_projects/arm_projects/arm_memcards/index.html">ARM-Projects by Martin THOMAS</a>↗ (Examples for LPC2000, AT91SAM and STM32)</li>`
			`<li><a href="res/rwtest1.png">Benchmark 1</a> (ATmega1284/20MHz with MMC via USART in SPI, CFC via GPIO)</li>`
			`<li><a href="res/rwtest2.png">Benchmark 2</a> (LPC2368/72MHz with MMC via MCI)</li>`
Initial firmware commit. 2015-07-08 15:39:24 +00:00			`</div>`


			`<hr>`
FatFs: Update to release R0.12c. 2017-05-03 11:39:05 +00:00			`<p class="foot"><a href="http://elm-chan.org/fsw/ff/00index_e.html">FatFs Homepage</a></p>`
Initial firmware commit. 2015-07-08 15:39:24 +00:00			`</body>`
			`</html>`