Funktion „Variable description by index“

Index-Gruppe: IdxGrp = 0x122300 + Kanal_ID

Index-Offset: IdxOffs = 0x45

Variablenbeschreibung

Diese Funktion liefert für gegebenen Index und Variablenart die zugehörige Variablenbeschreibung. Die Gesamtzahl der vorhanden Variableneinträge kann mit der Funktion „Variable element number“ abgefragt werden.
Gültiger Wertebereich des Index ist 0 bis (Anzahl der Elemente – 1).

Übergabeparameter (hier mit Angabe der Stream-Offsets):

0	4
Index der Variablen	Bezeichner für Variablenart mit Nullterminierung

wobei

Inhalt	Typ	Größe
Index der Variablen	UNS32	fest, 4 Byte
Bezeichner für Variablenart	STRING “V.G“ - Globale Variablen “V.E“ - Externe Variablen “V.A“ - Achsspezifische Variablen	variabel, max. 256 Byte

=> Streamlänge max. 260 Byte

Rückgabewert (hier mit Angabe der Stream-Offsets):

0	4	8	12	16	(20)	(24)	...	20 + 4 *m
Handle auf die Variable	Variablentyp	Zugriff	Größe	Anzahl der Arraydimensionen m	Anzahl Elemente in Dimension 1	Anzahl Elemente in Dimension 2	...	Variablenname

wobei

Inhalt	Variablentyp	Größe
Handle auf die Variable	UNS32	fest, 4 Byte
Variablentyp	Enumeration (UNS32) (*)	fest, 4 Byte
Zugriff	Enumeration (UNS32) 1 = READ_ONLY 2 = READ_WRITE	fest, 4 Byte
Größe	UNS32	fest, 4 Byte
Anzahl der Arraydimensionen m	UNS32 ( = 0, elementare Variable)	fest, 4 Byte
Anzahl der Elemente Index: 0 – (n-1) je Arraydimension	UNS32	variabel, 4 Byte * m
Variablenname	String	variabel, max. 256 Byte

=> Streamlänge 276 Byte + Anzahl Arraydimensionen n * 4 Byte, max. 2048 Byte

(*) Enumeration für Variablentyp:

1 = BOOLEAN	4 = SGN16	7 = UNS32
2 = SGN08	5 = UNS16	8 = REAL64
3 = UNS08	6 = SGN32	9 = STRING

Hinweis

Der Bezeichner für die Variablenart z.B. V.E darf abschließend keinen Punkt haben.

Beispiel

Anwendungsbeispiele

Im nachfolgenden Beispiel soll die Beschreibung der V.E. Variable mit dem Index 2 gelesen werden.

IndexGrp: 0x122301 für den ersten Kanal

IndexOffs: 0x45

Übergabeparameter:

V.E

2 für die Variable mit dem Indexeintrag 2

V.E Bezeichner der Variablenart : V.E

0 Nullterminierung

Rückgabewert:

0x2000002

V.E.Variable_3

0x2000002 Handle

1 Typ der Variablen : Boolean

1 Zugriffsrechte : Read-Only

2 Gesamtgröße in Bytes

1 Arraydimension

2 Anzahl der Arrayelemente

V.E.Variable_3 Name der Variable