The f_mkfs fucntion creates an FAT file system on the logical drive.
+The f_mkfs fucntion creates an FAT/exFAT volume on the logical drive.
FRESULT f_mkfs ( const TCHAR* path, /* [IN] Logical drive number */ - BYTE sfd, /* [IN] Partitioning rule */ - UINT au /* [IN] Size of the allocation unit */ + BYTE opt, /* [IN] Format options */ + DWORD au, /* [IN] Size of the allocation unit */ + void* work, /* [-] Working buffer */ + UINT len /* [IN] Size of working buffer */ );
The f_mkfs() function creates an FAT volume on the logical drive. When FDISK format is specified, a primary partition occupies the entire disk space is created and then an FAT volume is created on the partition. When SFD format is specified, the FAT volume starts from the first sector of the physical drive.
-If the logical drive has been bound to any partition (1-4) by multiple partition feature (_MULTI_PARTITION), the FAT volume is created into the specified partition. In this case, the second argument sfd is ignored. The physical drive must have been partitioned with f_fdisk() function or any other partitioning tool prior to use this function.
-Note that there are two partitioning rules, FDISK and SFD. The FDISK partitioning is usually used for harddisk, MMC, SDC, CFC and U Disk. It can divide a physical drive into one or more partitions with a partition table on the MBR. However Windows does not support multiple partition on the removable media. The SFD is non-partitioned method. The FAT volume starts from the first sector on the physical drive without partition table. It is usually used for floppy disk, Microdrive, optical disk and super-floppy media.
-The FAT sub-type, FAT12/FAT16/FAT32, is determined by number of clusters on the volume and nothing else, according to the FAT specification issued by Microsoft. Thus which FAT sub-type is selected, is depends on the volume size and the specified cluster size. The cluster size affects performance of the file system and large cluster increases the performance.
-When the number of clusters gets near the FAT sub-type boundaries, the function can fail with FR_MKFS_ABORTED.
+The FAT sub-type, FAT12/FAT16/FAT32, of FAT volume except exFAT is determined by only number of clusters on the volume and nothing else, according to the FAT specification issued by Microsoft. Thus which FAT sub-type is selected, is depends on the volume size and the specified cluster size. In case of the combination of FAT type and cluter size specified by argument cannot be valid on the volume, the function will fail with FR_MKFS_ABORTED.
+The allocation unit, also called 'cluster', is a unit of disk space allocation for files. When the size of allocation unit is 32768 bytes, a file with 100 bytes in size occupies 32768 bytes of disk space. The space efficiency of disk usage gets worse as increasing size of allocation unit, but, on the other hand, the read/write performance increases as the size of allocation unit. Therefore the allocation unit is a trade-off between space efficiency and performance. For the large storages in GB order, 32768 bytes or larger cluster (this is automatically selected by default) is recommended for most case unless extremely many files are created on a volume.
+There are two disk formats, FDISK and SFD. The FDISK format is usually used for harddisk, MMC, SDC, CFC and U Disk. It can divide a physical drive into one or more partitions with a partition table on the MBR (maser boot record, the first sector of the physical drive). The SFD (super-floppy disk) is non-partitioned disk format. The FAT volume starts at the first sector of the physical drive without any disk partitioning. It is usually used for floppy disk, Microdrive, optical disk and most type of super-floppy media. Some systems support only either one of two formats and other is not supported.
+When FM_SFD is not specified, a primary partition occupies whole drive space is created and then the FAT volume is created in it. When FM_SFD is specified, the FAT volume occupies from the first sector of the drive is created.
+If the logical drive to be formatted is bound to the specific partition (1-4) by support of multiple partition, _MULTI_PARTITION, the FAT volume is created into the partition and FM_SFD flag is ignored. The physical drive needs to be partitioned with f_fdisk function or any other partitioning tools prior to create the FAT volume with this function.
Available when _FS_READOLNY == 0 and _USE_MKFS == 1.
+/* Format default drive and create a file */ +int main (void) +{ + FATFS fs; /* File system object */ + FIL fil; /* File object */ + FRESULT res; /* API result code */ + UINT bw; /* Bytes written */ + BYTE work[_MAX_SS]; /* Work area (larger is better for process time) */ + + + /* Create FAT volume */ + res = f_mkfs("", FM_ANY, 0, work, sizeof work); + if (res) ... + + /* Register work area */ + f_mount(&fs, "", 0); + + /* Create a file as new */ + res = f_open(&fil, "hello.txt", FA_CREATE_NEW | FA_WRITE); + if (res) ... + + /* Write a message */ + f_write(&fil, "Hello, World!\r\n", 15, &bw); + if (bw != 15) ... + + /* Close the file */ + f_close(&fil); + + /* Unregister work area */ + f_mount(0, "", 0); + + ... ++