Other Build Options


This section gives more detail on those configuration options which do more than simply enable/disable a single function.

F_WILDCARD

This enables use of wildcards. The default is 1.

QUICK_WILDCARD_SEARCH

This enables quick wildcard search; this is useful if F_MAX_FILE is large. The default is 0.

F_CHECKNAME 

This enables checking for valid name characters. If this is enabled (the default), the system:

This enables checking for valid name characters. If this is enabled (the default), the system:

  • Accepts multiple * characters in wildcards.
  • Handles a / at the end of a dirname if f_mkdir() is called (for example, a/b/).
  • Handles a / at the end of a filename if f_open() is called.
  • Handles upper and lower case characters.

F_CHECKMEDIA

This enables checking for different media at startup (TINY with different drive geometry). The default is 1.

F_DIRECTORIES

This enables use of directories, making the directory API functions available. The default is 1.

F_DIR_OPTIMIZE

This enables directory storage optimization. The default is 1.

F_SEEK_WRITE

This enables seeking for write. The default is 1.

F_LOW_POWER

This enables low power support. The default is 0.

SMALL_FILE_OPT

This enables small file optimization. The default is 1.

QUICK_FILE_SEARCH

This enables quick search; this is useful if F_MAX_FILE is large. The default is 1.

USE_ECC

This enables use of ECC on file management pages. The default is 0.

RTOS_SUPPORT

This enables RTOS support. The default is 0.

F_FILE_CHANGED_EVENT

Set this to 1 if you want to a file state change to be treated as an event. The default is 0.

F_FILE_CHANGED_MAXPATH

The maximum path length the file system will handle if long filenames are not used. This is only used if  F_FILE_CHANGED_EVENT is enabled.

F_MAX_OPEN_FILE

The maximum number of files that can be open simultaneously. The default is 2.

F_MAX_FILE_NAME_LENGTH

The maximum length of a file or directory name. The default is 16.

F_MAX_FILE

The maximum number of files in the system. The default is 32.

F_MAX_DIR

The maximum number of directories in the system. The default is 16.

F_ATTR_SIZE

The size of the directory attribute in bytes (1, 2 or 4). The default is 1.

F_COPY_BUF_SIZE

The size of a copy buffer. The default is 32.

F_ATTR_DIR

The directory attribute (this must be in the F_ATTR_SIZE range). The default is 0x10.

System Features

The following options specify system features:

_SUC

The size of an unsigned char in bits. The default is 8.

_SUS

The size of an unsigned size of unsigned short in bits. The default is 16.

_SUL

The size of an unsigned long in bits. The default is 32.

_PTRQ

Pointer qualifiers for consts. For some microcontrollers pointers may need special qualifiers to specify their range; for example, far on a PIC. By default this is set to nothing.