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 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$

Inputs

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

Outputs

E	Error flag	Bool
	off .. No error on ... An error occurred
iE	Error code (for $E = on$ )	Long (I32)
	0 .... No error 1 .... The object specified by the bname parameter was not found 2 .... REXYGEN system internal error (invalid pointers) 3 .... Flag could not be set (timeout)

Parameter

bname	Full path to the block/object. Case sensitive. Individual layers are separated by dots, the object names excluding tasks (TASK, QTASK) start with the following special characters:	String
	^ .... Computational level, e.g. ^0 for Level0 & .... Input/Output Driver, e.g. &WcnDrv
	Name of the task triggered by input/output driver (IOTASK) has the form &<driver_name>.<task_name>.

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