fformat

#include <rtl.h>

int fformat  (
    const char* drive);    /* drive to format */

The function fformat formats an EFS or FAT storage media for using a file system. The parameter drive is a pointer specifying the drive letter. Optionally, a drive label (for FAT) and options can be include in the parameter. The function closes all open files on the drive. Existing file handles become invalid.

The function is included in the RL-FlashFS library. The prototype is defined in the file rtl.h.

The general form for drive is:

drive := "[driveLetter][driveLabel] [/options]"

The following values are allowed for driveLetter:

The driveLabel characteristics are:

The options are:

note

LOW and LOW_EB options are used to low-level format the NAND drive. LOW will erase all good blocks, but will preserve bad blocks. LOW_EB will also erase bad blocks - this is particulary usefull at the NAND driver development time, when blocks may be accidentally marked as bad - this is often the cause of fformat failure on NAND devices.

• 0 - on success.
• non-zero value - on failure.

fcheck, fdelete

#include <rtl.h>

void tst_fformat (void)  {

  if (fformat ("F:") != 0) {                                 /* Format a Flash Drive. */
    printf ("Formatting failure.\n");
  }
  else  {
    printf ("File System initialized.\n");
  }


  if (fformat ("M:SD_CARD") != 0)  {                         /* Format with Volume Label. */
    printf ("Formatting failure.\n");
  }
  else  {
    printf ("SD Memory Card formatted.\n");
  }


  if (fformat ("M:SD_CARD /FAT32 /WIPE") != 0)  {            /* Use FAT32; clear data. */
    printf ("Formatting failure.\n");
  }
  else  {
    printf ("Formatted for FAT32.\n");
  }
}