TwinCAT 3 PLC Lib: Tc2_Utilities

NT_StartProcess

 nt_startprocess

The "NT_StartProcess" function block can be used to start a Windows application from the PLC. The function block can also be used to run applications on a remote PC.

 

VAR_INPUT

VAR_INPUT
    NETID     : T_AmsNetId;
    PATHSTR   : T_MaxString;
    DIRNAME   : T_MaxString;
    COMNDLINE : T_MaxString;
    START     : BOOL;
    TMOUT     : TIME := DEFAULT_ADS_TIMEOUT;
END_VAR

NETID: It is possible here to provide the AmsNetId of the TwinCAT computer on which the application is to be started (type: T_AmsNetID). If it is to be run on the local computer, an empty string can be entered.

PATHSTR: Whole path of the application to be executed as a string (type: T_MaxString, e.g. "C:\WINNT\NOTEPAD.EXE" ).

DIRNAME: Working directory of the application to be executed as a string (type: T_MaxString, e.g. "C:\WINNT" ).

COMNDLINE: Command line parameter (type: T_MaxString, e.g.: "win.ini" ).

START: the block is activated by a positive edge at this input.

TMOUT: States the length of the timeout that may not be exceeded by execution of the ADS command.

 
 

VAR_OUTPUT

VAR_OUTPUT
    BUSY   : BOOL;
    ERR    : BOOL;
    ERRID  : UDINT;
END_VAR

BUSY: When the function block is activated this output is set. It remains set until a feedback is received.

ERR: If an error should occur during the transfer of the command, then this output is set once the BUSY output was reset.

ERRID: Supplies the ADS error number or the Win32 error code when the ERR output is set (Platform SDK: Win32 API).

 
 
 

Example:

NT_StartProcess1      : NT_StartProcess;
NT_StartProcess_Busy  : BOOL;
NT_StartProcess_Err   : BOOL;
NT_StartProcess_ErrId : UDINT;
StartProcess          : BOOL;
Tmout                 : TIME;
 
 
 
 

Requirements

Development environment
Target platform
PLC libraries to be integrated (category group)
TwinCAT v3.1.0
PC or CX (x86, x64, ARM)
Tc2_Utilities (System)