FatFs – Generic FAT Filesystem Module
- DOS/Windows compatible FAT/exFAT filesystem.
- Platform independent. Easy to port.
- Very small footprint for program code and work area.
- Various configuration options to support for:
- Multiple volumes (physical drives and partitions).
- Multiple code pages including DBCS.
- Long file name in OEM code or Unicode.
- exFAT filesystem.
- Thread safe.
- Fixed or variable sector size.
- Read-only, optional API, I/O buffer and etc…
FatFs provides various filesystem functions for the applications as shown below.
- File Access
- f_open – Open/Create a file
- f_close – Close an open file
- f_read – Read data from the file
- f_write – Write data to the file
- f_lseek – Move read/write pointer, Expand size
- f_truncate – Truncate file size
- f_sync – Flush cached data
- f_forward – Forward data to the stream
- f_expand – Allocate a contiguous block to the file
- f_gets – Read a string
- f_putc – Write a character
- f_puts – Write a string
- f_printf – Write a formatted string
- f_tell – Get current read/write pointer
- f_eof – Test for end-of-file
- f_size – Get size
- f_error – Test for an error
- Directory Access
- File and Directory Management
- f_stat – Check existance of a file or sub-directory
- f_unlink – Remove a file or sub-directory
- f_rename – Rename/Move a file or sub-directory
- f_chmod – Change attribute of a file or sub-directory
- f_utime – Change timestamp of a file or sub-directory
- f_mkdir – Create a sub-directory
- f_chdir – Change current directory
- f_chdrive – Change current drive
- f_getcwd – Retrieve the current directory and drive
- Volume Management and System Configuration
- f_mount – Register/Unregister the work area of the volume
- f_mkfs – Create an FAT volume on the logical drive
- f_fdisk – Create logical drives on the physical drive
- f_getfree – Get total size and free size on the volume
- f_getlabel – Get volume label
- f_setlabel – Set volume label
- f_setcp – Set active code page
Media Access Interface
Since the FatFs module is the filesystem layer independent of platforms and storage media, 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 not a part of FatFs module 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. A function checker for low level disk I/O module is available here.
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.
- Read first: FatFs module application note May 21, 2017
- Download: FatFs R0.13 | Changes | Latest Patch Jul 4, 2017
- Download: FatFs sample projects for various platforms May 21, 2017
- Download: Previous Releases
- Community: FatFs User Forum
- FAT32 Specification by Microsoft↗ (The authorized document on FAT filesystem)
- The basics of FAT filesystem
- The basics of exFAT filesystem
- How to use MMC/SDC
- Playing with FlashAir and FatFs
- Read SD card with FatFs on STM32F4xx devices by Tilen Majerle↗ (Quick and easy implementation for STM32F4-Discovery)
- Nemuisan’s Blog↗ (Well written implementations for STM32F/SPI & SDIO and LPC4088/SDMMC)
- Benchmark 1 (ATmega1284/20MHz with MMC via USART in SPI, CFC via GPIO)
- Benchmark 2 (LPC2368/72MHz with MMC via MCI)
- Demo movie of an application (this project is in ffsample.zip/lpc23xx)