Locale and Namespace

Locale and Namespace Configurations. More...

Collaboration diagram for Locale and Namespace:

Macros
#define	_CODE_PAGE   1252
	The _CODE_PAGE specifies the OEM code page to be used on the target system. Incorrect setting of the code page can cause a file open failure. More...
#define	_USE_LFN   0
	The _USE_LFN option switches the LFN feature. More...
#define	_MAX_LFN   255
	Maximum LFN length to handle. More...
#define	_LFN_UNICODE   0
	To switch the character encoding on the FatFs API to Unicode, enable LFN feature and set _LFN_UNICODE to 1. More...
#define	_STRF_ENCODE   3
	When Unicode API is enabled, character encoding on the all FatFs API is switched to Unicode. This option selects the character encoding on the file to be read/written via string functions, f_gets(), f_putc(), f_puts and f_printf(). This option has no effect when _LFN_UNICODE is 0. More...
#define	_FS_RPATH   0
	The _FS_RPATH option configures relative path feature. More...

Detailed Description

Locale and Namespace Configurations.

Macro Definition Documentation

#define _CODE_PAGE   1252

The _CODE_PAGE specifies the OEM code page to be used on the target system. Incorrect setting of the code page can cause a file open failure.

Value:

• 932: Japanese Shift-JIS (DBCS, OEM, Windows)
• 936: Simplified Chinese GBK (DBCS, OEM, Windows)
• 949: Korean (DBCS, OEM, Windows)
• 950: Traditional Chinese Big5 (DBCS, OEM, Windows)
• 1250: Central Europe (Windows)
• 1251: Cyrillic (Windows)
• 1252: Latin 1 (Windows)
• 1253: Greek (Windows)
• 1254: Turkish (Windows)
• 1255: Hebrew (Windows)
• 1256: Arabic (Windows)
• 1257: Baltic (Windows)
• 1258: Vietnam (OEM, Windows)
• 437: U.S. (OEM)
• 720: Arabic (OEM)
• 737: Greek (OEM)
• 775: Baltic (OEM)
• 850: Multilingual Latin 1 (OEM)
• 858: Multilingual Latin 1 + Euro (OEM)
• 852: Latin 2 (OEM)
• 855: Cyrillic (OEM)
• 866: Russian (OEM)
• 857: Turkish (OEM)
• 862: Hebrew (OEM)
• 874: Thai (OEM, Windows)
• 1: ASCII (Valid for only non-LFN cfg.)

Definition at line 181 of file ffconf.h.

#define _FS_RPATH   0

The _FS_RPATH option configures relative path feature.

Value:

• 0: Disable relative path feature and remove related functions.
• 1: Enable relative path. f_chdrive() and f_chdir() function are available.
• 2: f_getcwd() function is available in addition to 1.

Note

Note that output of the f_readdir() function is affected by this option.

Definition at line 252 of file ffconf.h.

#define _LFN_UNICODE   0

To switch the character encoding on the FatFs API to Unicode, enable LFN feature and set _LFN_UNICODE to 1.

Value:

• 0: ANSI/OEM
• 1: Unicode

Definition at line 221 of file ffconf.h.

#define _MAX_LFN   255

Maximum LFN length to handle.

Value:

• 12 to 255

Definition at line 210 of file ffconf.h.

#define _STRF_ENCODE   3

When Unicode API is enabled, character encoding on the all FatFs API is switched to Unicode. This option selects the character encoding on the file to be read/written via string functions, f_gets(), f_putc(), f_puts and f_printf().
This option has no effect when _LFN_UNICODE is 0.

Value:

• 0: ANSI/OEM
• 1: UTF-16LE
• 2: UTF-16BE
• 3: UTF-8

Definition at line 237 of file ffconf.h.

#define _USE_LFN   0

The _USE_LFN option switches the LFN feature.

Value:

• 0: Disable LFN feature. _MAX_LFN has no effect.
• 1: Enable LFN with static working buffer on the BSS. Always NOT reentrant.
• 2: Enable LFN with dynamic working buffer on the STACK.
• 3: Enable LFN with dynamic working buffer on the HEAP.

Note

To enable LFN feature, Unicode handling functions ff_convert() and ff_wtoupper() function must be added to the project. The LFN working buffer occupies (_MAX_LFN + 1) * 2 bytes. When use stack for the working buffer, take care on stack overflow. When use heap memory for the working buffer, memory management functions, ff_memalloc() and ff_memfree(), must be added to the project.

Definition at line 202 of file ffconf.h.