CARME-M4 BSP  V1.5
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.