Mikroelektronika MIKROE-724 データシート

396

mikoBasic PRO for dsPIC30/33 and PIC24

MikroElektronika

Prototype

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

as byte) as word

Description Assigns file for file operations (read, write, delete...). All subsequent file operations 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 attributes flags. Each bit corresponds to the appropriate file

attribute:

Returns

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

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

Requires

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

Example

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

Mmc_Fat_Assign(“MIKRO007.TXT”,0xA0)

Notes

Long File Names (LFN) are not supported.

Mmc_Fat_Assign

Bit

Mask

Description

0x01

Read Only

0x02

Hidden

0x04

System

0x08

Volume Label

0x10

Subdirectory

0x20