Mikroelektronika MIKROE-742 데이터 시트

278

- SOFTWARE AND HARDWARE SOLUTIONS FOR EMBEDDED WORLD

CHAPTER 6

function Mmc_Fat_Assign(var filename: array[12] of char;
file_cre_attr: byte): byte;

- 

1

- if file already exists or file does not exist but a new file is created. 

- 

0

- if file does not exist and no new file is created. 

Assigns file for file operations (read, write, delete...). All subsequent file opera-
tions will be applied on an assigned file.

Parameters:

- 

filename

: name of the file that should be assigned for file operations. File 

name should be in DOS 8.3 (file_name.extension) format. The file name and 
extension will be automatically padded with spaces by the library if they have 
less than length required (i.e. "mikro.tx" -> "mikro .tx "), so the user does not 
have to take care of that. The file name and extension are case insensitive. 
The library will convert them to proper case automatically, so the user does not 
have to take care of that. Also, in order to keep backward compatibility with the 
first version of this library, file names can be entered as UPPERCASE string of 
11 bytes in length with no dot character between file name and extension (i.e. 
"MIKROELETXT" -> MIKROELE.TXT). In this case last 3 characters of the 
string are considered to be file extension.

- 

file_cre_attr

: file creation and attributs flags. Each bit corresponds to the 

appropriate file attribut: 

Note: Long File Names (LFN) are not supported. 

MMC/SD card and MMC library must be initialized for file operations. See
Mmc_Fat_Init.

// create file with archive attribut if it does not already exist

Mmc_Fat_Assign('MIKRO007.TXT',0xA0);

0

0x01

Read Only

1

0x02

Hidden

2

0x04

System

3

0x08

Volume Label

4

0x10

Subdirectory

5

0x20

Archive

6

0x40

Device (internal use only, never found on disk)

7

0x80

File creation flag. If the file does not exist and this flag is set,
a new file with specified name will be created.