DirOpen (FB; Prefix fildop)

FUNCTION_BLOCK DirOpen EXTENDS CBM.ETrig

This function block opens a directory. The entries (files and sub-directories) of which should be read with the help of the function block ”FILE.DirList”. The return value is a handle. There may be restrictions concerning the specification of the directory name, e.g. only capital letters allowed, for different targets. The function ”FILE.GetProperty” shows these restrictions.

InOut:

Scope

Name

Type

Comment

Inherited from

Input

xExecute

BOOL

Rising edge: Action starts

Falling edge: Resets outputs

If a falling edge occurs before the function block has completed its action, the outputs operate in the usual manner and are only reset if either the action is completed or in the event of an error. In this case, the corresponding output values (xDone, xError) are present at the outputs for exactly one cycle.

ETrig

Output

xDone

BOOL

TRUE: Action successfully completed

ETrig

xBusy

BOOL

TRUE: Function block active

ETrig

xError

BOOL

TRUE: Error occurred, function block aborts action

FALSE: No error

ETrig

Input

sDirName

CAA.FILENAME

Directory name, absolute or relative path specification

Output

eError

ERROR

Local library error ID (0: no error; 5101: time out)

hDir

CAA.HANDLE

Directory handle