Operator '__VARINFO'

Der Operator ist eine Erweiterung der Norm IEC 61131-3.

Der Operator liefert Informationen zu einer Variablen zurück. Sie können die Informationen als Datenstruktur in einer Variablen des Datentyps ‎__SYSTEM.VAR_INFO‎ speichern.

Syntax in der Deklaration

<name of the info variable> : __SYSTEM.VAR_INFO; // Data structure for info variable

Syntax beim Aufruf

<name of the info variable> := __VARINFO( <variable name> ); // Call of the operator

Beispiel

FUNCTION_BLOCK FB_Velocity
VAR_INPUT	
	rVelocity: REAL := 1.2;
END_VAR
VAR_OUTPUT
END_VAR
VAR	
	infoVelocity: __SYSTEM.VAR_INFO; //Info of Velocity
END_VAR

infoVelocity := __VARINFO(rVelocity); // Gets the info of Velocity locally

PROGRAM PLC_PRG
VAR
	iCounter : INT := 0; // Counts the calls
	infoCounter : __SYSTEM.VAR_INFO; //Info of Counter
	arrA : ARRAY [1..2, 1..2, 1..2] OF INT := [0, 1, 2, 3, 4, 5, 6, 7]; // Stores the A data
	infoA : __SYSTEM.VAR_INFO; //Info of A
	fbVel : FB_Velocity;
END_VAR

iCounter := iCounter + 1;
infoCounter := __VARINFO(iCounter);
infoA := __VARINFO(arrA);
fbVel();

Im Applikationscode sind die Variablen ‎iCounter‎ und ‎arrA‎ bekannt. Die Variableninformationen werden in den Variablen ‎infoCounter‎ und ‎infoA‎ abgelegt. Außerdem ist der Funktionsbaustein ‎FB_Velocity‎ instanziert.

Datentyp ‎__SYSTEM.VAR_INFO‎

Name	Datentyp	Initialisierung	Beschreibung
`‎ByteAddress‎`	`‎DWORD‎`	0	Adresse der Variablen Beispiel: `‎16#072E35EC‎` Hinweis: Beim Bitzugriff einer Variablen `‎<variable name>.<bit index>‎` wird die Adresse der Variablen angegeben, die das Bit enthält.
`‎ByteOffset‎`	`‎DWORD‎`	0	Offset der Variablenadresse in Bytes. Beispiel: `‎13936‎` Bytes. Hinweis: Wenn die Variable global ist, dann ist der Offset relativ zum Beginn der Area. Wenn die Variable eine lokale Variable in einer Funktion oder Methode ist, dann ist der Offset relativ zum aktuellen Stack-Frame. Wenn die Variable eine lokale Variable in einem Funktionsbaustein ist, dann ist der Offset relativ zur Funktionsbaustein-Instanz.
`‎Area‎`	`‎DINT‎`	0	Speicherbereichsnummer `‎Area‎` im Laufzeitsystem. Beispiel: `‎-1‎`. Bedeutet, dass die Variable nicht global im Speicher liegt, sondern relativ zu einer Instanz oder auf dem Stack. Hinweis: Die Speicherbereiche sind geräteabhängig.
`‎BitNr‎`	`‎INT‎`	0	Anzahl der Bits in Bytes Beispiel: `‎16#00FF‎` Bytes Hinweis: Wenn die Variable kein ganzzahliger Datentyp ist, gilt: `‎BitNr = -1 = 16#FFFF‎`
`‎BitSize‎`	`‎INT‎`	0	Speicherplatzgröße der Variablen in Bits Beispiel: `‎16‎` Bits
`‎BitAddress‎`	`‎UDINT‎`	0	Bitadresse der Variablen Voraussetzung: Die Variable liegt im Eingangsspeicherbereich `‎I‎`, Ausgangsspeicherbereich `‎Q‎` oder Merkerspeicherbereich `‎M‎`. Ansonsten ist der Wert undefiniert.
`‎TypeClass‎`	`‎TYPE_CLASS‎`	`‎TYPE_BOOL‎`	Datentypklasse der Variablen Beispiel: `‎TYPE_INT‎`, `‎TYPE_ARRAY‎` Hinweis: Bei benutzerdefinierten Datentypen oder Funktionsbaustein-Instanzen wird als Datantypklasse `‎TYPE_USERDEF‎` ausgegeben.
`‎TypeName‎`	`‎STRING(79)‎`	''	Datentypname der Variablen als `‎STRING(79)‎` Hinweis: Bei benutzerdefinierten Datentypen ist der Funktionsbausteinname oder der DUT-Name angegeben. Beispiel: `‎'INT'‎`, `‎'ARRAY'‎`
`‎NumElements‎`	`‎UDINT‎`	0	Anzahl der Arrayelemente Voraussetzung: Die Variable hat den Datentyp `‎ARRAY‎`. Beispiel: `‎8‎`
`‎BaseTypeClass‎`	`‎TYPE_CLASS‎`	`‎TYPE_BOOL‎`	Elementarer Basisdatentyp der Arrayelemente. Voraussetzung: Die Variable hat den Datentyp `‎ARRAY‎`. Beispiel: `‎TYPE_INT‎` bei `‎arrA : ARRAY [1..2,1..2,1..2] OF INT;‎`
`‎ElemBitSize‎`	`‎UDINT‎`	0	Speicherplatzgröße des Arrayelements in Bits Voraussetzung: Die Variable hat den Datentyp `‎ARRAY‎`. Beispiel: `‎16‎` Bits bei `‎arrA : ARRAY [1..2,1..2,1..2] OF INT;‎`
`‎MemoryArea‎`	`‎MEMORY_AREA‎`	`‎MEM_MEMORY‎`	Information zum Speicherbereich `‎MEM_GLOBAL‎`: Globaler Speicherbereich Beispielsweise in `‎Area 0‎` `‎MEM_LOCAL‎`: Lokaler Speicherbereich in `‎Area -1‎` `‎MEM_MEMORY‎`: Merkerspeicherbereich `‎%M‎` Beispielsweise in `‎16#10‎` in `‎Area 1‎` `‎MEM_INPUT‎`: Eingangsspeicherbereich `‎%I‎` Beispielsweise in `‎16#04‎` in `‎Area 2‎` `‎MEM_OUTPUT‎`: Ausgangsspeicherbereich `‎%Q‎` Beispielsweise in `‎16#08‎` in `‎Area 3‎` `‎MEM_RETAIN‎`: Retain-Speicherbereich Beispielsweise in `‎16#20‎` in `‎Area 0‎` Beispiel: `‎MEM_GLOBAL‎` Hinweis: Die Speicherbereichkonfiguration ist geräteabhängig.
`‎Symbol‎`	`‎STRING(39)‎`	''	Variablenname als `‎STRING(39)‎` Beispiel : `‎'iCounter'‎`, `‎'arrA'‎`
`‎Comment‎`	`‎STRING(79)‎`	''	Kommentar der Variablendeklaration Beispiel: `‎'Counts the calls'‎` oder `‎'Stores the A data'‎`