SRTF – Set run-time flags

Block SymbolLicensing group: ADVANCED

Function Description
The SRTF block (Set Run-Time Flags) can be used to influence the execution of tasks , subsystems (sequences) and blocks of the REXYGEN system. This block is not meant for use in Matlab-Simulink. When describing this block, the term object refers to a REXYGEN system object running in real-time, i.e. input/output driver, one of the tasks, subsystem or a simple function block of the REXYGEN system.

All the operations described below affect the object, whose full path is given by the bname parameter. Should the parameter be left blank (empty string), the operation applies to the nearest owner of the SRTF object, i.e. the subsystem in which the block is directly included or the task containing the block. The full path to the block (object) is case sensitive. Individual layers are separated by dots, object names except tasks (TASK, QTASK) begin with one of the following special characters:

^ – computational level (Level), e.g. ^0 for Level0
& – input-output driver (I/O Driver), e.g. &WcnDrv

The name of the task executed by the I/O controller (IOTASK) is entered in the form &<driver_name>.<task_name>.

The run-time flags allow the following operations:

Disable execution of the object by setting the EXDIS input to on. The execution can be enabled again by using the input signal $EXDIS = off$ . The EXDIS input sets the same run-time flag as the Halt/Run button in the upper right corner of the Workspace tab in the Diagnostics of the REXYGEN Studio program.
One-shot execution of the object. If the object execution is disabled by the $EXDIS = on$ input or by the Diagnostics section of the REXYGEN Studio program, it is possible to trigger one-shot execution by $EXOSH = on$ .
Enable diagnostics for the given object by $DGEN = on$ . The result is equivalent to ticking the Enable checkbox in the Diagnostics section of the corresponding tab (I/O Driver, Level, Quick Task, Task, I/O Task, Sequence) of the REXYGEN Studio program.
Reset diagnostic data of the given object by $DGRES = on$ . The same flag can be set by the Reset button in the Diagnostics section of the corresponding tab in the REXYGEN Studio program. The flag is automatically set back to 0 when the data reset is performed.

The following table shows the flags available for various objects in the REXYGEN system.


Object type	EXDIS	EXOSH	DGEN	DGRES


I/O Driver	$\sqrt$	$\sqrt$	$\sqrt$	$\sqrt$
Level	$\sqrt$	$\times$	$\sqrt$	$\sqrt$
Task	$\sqrt$	$\sqrt$	$\sqrt$	$\sqrt$
Quick Task	$\sqrt$	$\sqrt$	$\sqrt$	$\sqrt$
I/O Task	$\sqrt$	$\sqrt$	$\sqrt$	$\sqrt$
Sequence, subsystem	$\sqrt$	$\times$	$\sqrt$	$\sqrt$
Block	$\sqrt$	$\times$	$\times$	$\times$

This block does not propagate the signal quality. More information can be found in the 1.4 section.

Input

EXDIS	Disable execution	Bool
EXOSH	One-shot execution	Bool
DGEN	Enable diagnostics	Bool
DGRES	Reset diagnostic data	Bool
DGLOG	Enable verbose diagnostics	Bool

Parameter

bname	Full path to the controlled task or block	String

Output

E	Error indicator	Bool
	off .. No error on ... An error occurred
iE	Error code	Long (I32)
	0 .... No error 1 .... Object not found (invalid bname parameter) 2 .... REXYGEN internal error (invalid pointers) 3 .... Flag could not be set (timeout)

[Previous] [Back to top] [Up] [Next]