Mikroelektronika MIKROE-350 Fiche De Données

263

- SOFTWARE AND HARDWARE SOLUTIONS FOR EMBEDDED WORLD

CHAPTER 6

sub function Mmc_Fat_Assign(dim byref filename as char[12], dim
file_cre_attr 

as byte) d

- 

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 no 
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.