FB_FileSeek

FB_FileSeek 1:

With this function block the file pointer of an opened file can be set to a definable position.

VAR_INPUT

VAR_INPUT
    sNetId      : T_AmsNetId;          
    hFile       : UINT;         
    nSeekPos    : DINT;         (* new seek pointer position *)
    eOrigin     : E_SeekOrigin:= SEEK_SET;
    bExecute    : BOOL;     
    tTimeout    : TIME;
END_VAR

sNetId    : Is a string containing the AMS network identifier of the target device to which the ADS command is directed.

hFile    : Is occupied by the file handle already created by FB_FileOpen

nSeekPos : Contains the desired (new) target position of the file pointer.

eOrigin : Contains the relative position for the move.

bExecute    : The ADS command is triggered by a rising edge at this input.

tTimeout    : States the time before the function is cancelled.

VAR_OUTPUT

VAR_OUTPUT
    bBusy       : BOOL;
    bError      : BOOL;
    nErrId      : UDINT;
END_VAR

bBusy:    This output remains TRUE until the block has executed a command, but at the longest for the duration supplied to the ‘tTimeout’ input. While bBusy = TRUE, no new command will be accepted at the inputs. Please note that it is not the execution of the service but its acceptance whose time is monitored.

bError:    This output is switched to TRUE if an error occurs during the execution of a command. The command-specific error code is contained in ‘nErrId’.

nErrId:    Contains the command-specific ADS error code of the most recently executed command.

 

Function specific ADS error code

Possible reason

0x703

Invalid or unknown file handle.

0x70E

File was opened with wrong method ( e.g. with 'obsolete' FILEOPEN function block ).

 

Example of calling the block in FBD:

PROGRAM Test
VAR
    fbFileSeek      : FB_FileSeek;
    hFile           : UINT;
    nSeekPos        : DINT;
    bFileSeek       : BOOL;
    bFileSeekBusy   : BOOL;
    bFileSeekError  : BOOL;
    nFileSeekErrorId: UDINT;
END_VAR

FB_FileSeek 2:

Requirements

Development environment

Target system type

PLC libraries to include

TwinCAT v2.8.0

PC or CX (x86)

TcSystem.Lib

TwinCAT v2.10.0 Build >= 1301

CX (ARM)

TcSystem.Lib