Tani Item Syntax 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet ...
←
→
Transkription von Seiteninhalten
Wenn Ihr Browser die Seite nicht korrekt rendert, bitte, lesen Sie den Inhalt der Seite unten
Tani Item Syntax © 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.de
Tani GmbH
Networks in industry
.
Der Name Tani steht für Kommunik ation in der industriellen Fertigung.
Der Schwerpunk t sind Kommunik ationssysteme:
- OPC Server für weit verbreitete Steuerungen.
- Geräte und Software zum Verbinden von Steuerungen, SCADA Systeme und Datenbank en.
- Feldbus Diagnosesysteme.Tani Item Syntax
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354,
Internet: https://tanindustrie.de, Email: info@tanindustrie.de
Die in dieser Anleitung gemachten Angaben entsprechen dem Stand der Technik zum Zeitpunkt der Drucklegung
und werden nach bestem Wissen weitergegeben. Garantieansprüche auf Grund der in dieser Anleitung gemachten
Angaben, insbesondere eine Beschaffenheits- und Haltbarkeitsgarantie gemäß § 443 BGB, werden von uns nicht
übernommen. Wir behalten uns vor, Verbesserungen, Ergänzungen und neue Erkenntnisse ohne Vorankündigung
in diese Anleitung neu aufzunehmen. Die tatsächliche Ausführung von Produkten kann gegenüber den in der
Anleitung gemachten Angaben abweichen, falls technische Änderungen infolge von Produktverbesserungen dies
notwendig machen.
Nachdruck und Vervielfältigung sowie die Übernahme in elektronische Form, auch auszugsweise, sind nicht
zulässig.
Erstellt: März 2019 in Nürnberg, Deutschland
Tani GmbH
Freiligrathstraße 12
D-90482 Nürnberg
Internet: https://tanindustrie.de
Email: info@tanindustrie.de
Tel.: +49 911 980 373 54
HRB: Amtsgericht Nürnberg 29562
USt-Id: DE 289 906 8524 Tani Item Syntax
Inhaltsverzeichnis
Kapitel 1 Item Syntax 5
1 S7 Item
...................................................................................................................................
Syntax 5
2 S5 Item
...................................................................................................................................
Syntax 9
3 Modbus
...................................................................................................................................
Item Syntax 12
4 PLC-5...................................................................................................................................
/ SLC Item Syntax 15
5 MELSEC-Q
...................................................................................................................................
Item Syntax 17
6 Send/Receive
...................................................................................................................................
Item Syntax 19
7 BrowsingTree
................................................................................................................................... 19
8 Systemelement
...................................................................................................................................
Baum 20
9 Redundanz
................................................................................................................................... 25
10 Bit Maskierung
................................................................................................................................... 26
11 Arrays
................................................................................................................................... 26
12 Suffixe
................................................................................................................................... 26
13 Item Syntax
...................................................................................................................................
für symbolische Steuerungen 30
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.deItem Syntax 5
1 Item Syntax
Das Kapitel beschreibt die Tani Item-Syntax, die zum Anlegen von Items (Tags) für die entsprechende
Verbindung (Access Path) verwendet werden kann.
Allgemeine Informationen
Browsing Tree
Systemelem Baum
Redundanz
Item Syntax der verschiedenen SPSen
S7 Item Syntax
S5 Item Syntax
Modbus Item-Syntax
PLC-5 / SLC Item Syntax
MELSEC-Q Item Syntax
Send/Receive Item Syntax
Informationen für Steuerungen mit Online-Symbolen
S7-1200/S7-1500, Rockwell CompactLogix/ControlLogix, BACnet
Die folgenden Kapitel gelten allgemein:
Bit Maskierung
Arrays
Suffixe
1.1 S7 Item Syntax
Die S7-Item-Syntax hat folgenden Aufbau:
[.ArrayGröße][Suffix]
Ist der Datentyp BOOL, ist die Angabe der Bitnummer erforderlich:
[.ArrayGröße]
Ist der Datentyp STRING, ist die Angabe der Stringlänge erforderlich:
[.ArrayGröße]
[Suffix]
Legende: zwingend erforderlich [ ] optional
Syntax Orientierung1 Zugriffsrechte Hinweise
Datenbausteine DBx. BYTE Lesen / Schreiben Bei Bausteinen ist die
V Synonym für Angabe einer
DB1 Bausteinnummer x
erforderlich (x = 1 bis
65535). Nach der
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.de6 Tani Item Syntax
Instanz Baustein DIx. BYTE Lesen / Schreiben Bausteinnummer muss
ein Punkt oder Komma
stehen.
Merker M oder F BYTE Lesen / Schreiben
Timer T WORD Lesen Direkt dahinter die Timer
Nummer.
Der Datentyp ist REAL,
mit Suffix S5T STRING
Zähler Z oder C WORD Lesen / Schreiben Direkt dahinter die Zähler
Nummer.
Eingang E oder I BYTE Lesen
Ausgang A oder O oder Q BYTE Lesen / Schreiben
Peripherie-Eingang PE oder PI BYTE Lesen
Peripherie- PA oder PO oder BYTE Lesen / Schreiben
Ausgang PQ
1
BYTE-orientiert bedeutet, dass je physikalische Adresse ein Byte angesprochen wird.
WORD-orientiert bedeutet, dass je physikalische Adresse ein Wort (16 Bit) angesprochen wird.
Typ Syntax DB / DI M E/A PE /PA C/T mit Array sinnvolle
Suffixe
BIT X DB5.X4.3 MX1.3 --- --- --- --- ---
VT_BOOL
BIT DB5.4.3 M1.3 E4.3 PE4.5 --- --- ---
VT_BOOL I4.3 PI4.5
A4.3 PA1.3
O4.3 PO1.3
BYTE B DB5.B2 MB4 EB4 PEB4 --- DB5.B2.4 KF
VT_UI1 Byte DB5.Byte2 MByte4 EByte4 PEByte4 DB5.Byte2 BCD
FB4 IB4 PIB4 .4
FByte4 IByte4 PIByte4 MB4.3
AB5 PAB5 MByte4.3
AByte5 PAByte5 FB4.4
OB5 POB5 FByte4.4
OByte5 POByte5 POB5.3
usw.
WORD W DB5.W3 MW4 EW4 PEW4 C5 DB5.W3.2 KF
VT_UI2 Word DB5.Word MWord4 EWord4 PEWord4 Z5 DB5.Word BCD
VT_I4* 3 FW4 IW4 PIW4 T5 3.2 KT
FWord4 IWord4 PIWord4 MW4.2 S5T
AW5 PAWord5 EWord4.2 TR
AWord5 PAWord5 PAWord5. D
OW5 POW5 3
OWord5 POWord5 C5.3
QWord5 Z5.10
T5.2
usw.
INT I DB5.I3 MI4 EI4 PEI4 --- DB5.I3.2 ---
VT_I2 Int DB5.Int3 MInt4 EInt4 PEInt4 DB5.Int3.2
FI4 II4 PII4 MI4.4
FInt4 IInt4 PIInt4 FInt4.3
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.deItem Syntax 7
AI5 PAI5 AInt5.3
AInt5 PAInt5 OI5.2
OI5 POI5 OInt5.5
OInt5 POInt5 POInt5.4
usw.
REAL R DB5.R2 MR4 ER4 PER4 ---- DB5.R2.2 ---
VT_R4 Real DB5.REAL MREAL4 EREAL4 PEREAL4 DB5.REAL
2 IR4 PIR4 2.4
IREAL4 PIREAL4 MR4.5
AR4 PAR4 ER4.4
AREAL4 PAREAL4 AREAL4.5
OR4 POR4 PER4.2
OREAL4 POREAL4 PAR4.7
POR4.3
usw.
STRING S DB5.S1.80 MS2.80 --- --- --- DB5.S1.80 KA1
VT_BSTR String DB5.String MString2.8 .5
1.80 0 DB5.String
1.80.5
MS2.80.3
MString2.8
0.3
S7- G DB5.G2.80 MG2.80 --- --- --- DB5.G2.80 ---
STRING SS DB5.SS2. MSS2.80 .5
VT_BSTR 80 DB5.SS2.
80.5
MG2.80.5
MSS2.80.
5
S5- SF DB5.SF2.8 MSF2.80 --- --- --- DB5.SF2.8 ---
STRING 0 0.5
VT_BSTR MSF2.80.5
DOUBLE DW DB5.DW3 MDW4 EDW4 PEDW4 --- DB5.DW3 KF
WORD Dword DB5.Dwor MDWord4 EDWord4 PEDWord MDW4.2 BCD
VT_UI4 d3 FDW4 IDW4 4 FDW4.2 KG
FDWord4 IDWord4 PIDW4 EDW4.4 T
ADW5 PIDWord4 ADWord5. TOD
ADWord5 PADW5 8
ODW5 PADWord PEDW4.8
ODWord5 5 PADW5.4
QDW5 PODW5 PODW5.4
PODWord usw.
5
DOUBLE D DB5.D3 2 MDI4 EDI4 PEDI4 --- DB5.D3.2 BCD
INT DI DB5.DI3 MDInt4 EDInt4 PEDInt4 DB5.DI3.2 T
VT_I4 DInt DB5.DInt3 FDI4 IDI4 PIDI4 DB5.DInt3. TOD
FDInt4 IDInt4 PIDInt4 4
ADI5 PADI5 MDI4.5
ADInt5 PADInt5 EDI4.5
ODI5 PODI5 ADI5.2
ODInt5 PODInt5 PEDI4.5
QDI5 PADInt5.2
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.de8 Tani Item Syntax
usw.
QUAD QW DB5.QW3 MQW4 EQW4 PEQW4 --- DB5.QW3 KF
WORD Qword DB5.Qwor MQWord4 EQWord4 PEQWord MQW4.2 BCD
VT_UI8 d3 FQW4 IQW4 4 FQW4.2
FQWord4 IQWord4 PIQW4 EQW4.4
AQW5 PIQWord4 AQWord5.
AQWord5 PAQW5 8
OQW5 PAQWord PEQW4.8
OQWord5 5 PAQW5.4
QQW5 POQW5 POQW5.4
POQWord usw.
5
QUAD INT Q DB5.Q3 MQI4 EQI4 PEQI4 --- DB5.Q3.2 ---
VT_I8 QI DB5.QI3 MQInt4 EQInt4 PEQInt4 DB5.QI3.2
QInt DB5.QInt3 FQI4 IQI4 PIQI4 DB5.QInt3.
FQInt4 IQInt4 PIQInt4 4
AQI5 PAQI5 MQI4.5
AQInt5 PAQInt5 EQI4.5
OQI5 POQI5 AQI5.2
OQInt5 POQInt5 PEQI4.5
QQI5 PAQInt5.2
usw.
DOUBLE QR DB5.QR2 MQR4 EQR4 PEQR4 ---- DB5.QR2. ---
VT_R8 QReal DB5.QRE MQREAL4 EQREAL4 PEQREAL 2
AL2 IQR4 4 DB5.QRE
IQREAL4 PIQR4 AL2.4
AQR4 PIQREAL4 MQR4.5
AQREAL4 PAQR4 EQR4.4
OQR4 PAQREAL AQREAL4.
OQREAL4 4 5
POQR4 PEQR4.2
POQREAL PAQR4.7
4 POQR4.3
usw.
Date and DT DB5.DT3 MDT4 EDT4 PEDT4 --- DB5.DT3.2 ISO
Time IDT4 PIDT4 MDT4.2
VT_DATE ADT5 PADT5 EDT4.2
ODT5 PODT5 PEDT4.2
QDI5 usw.
1
KA Suffix geht nicht bei String Arrays
2
Achtung! Verwechslungsgefahr mit S5-Syntax für Bit (DB5D1.1)
Hinweise zu Countern und Timern
Counter und Timer werden immer wortweise adressiert. Aus diesem Grund ist die Angabe eines
Datentyps nicht erforderlich! An den Bereich "T" bzw. "C/Z" wird direkt die Startadresse
angeschlossen. Timer können nur gelesen werden! Counter können gelesen und geschrieben werden.
Timerwerte werden in Sekunden angezeigt z.B. T = 0.7 => T = 0,7s = 700ms.
Die Darstellung der Counter erfolgt dezimal (0 bis 999).
Die Startadresse gibt die Adresse an, ab der gelesen bzw. geschrieben wird.
Beispiel: DB5.DW6: Doppelwort 6 des Datenbausteins 5 ist die Startadresse
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.deItem Syntax 9
Beispiel: MB17: Merkerbyte 17 ist die Startadresse
Ist die Startadresse ein bestimmtes Bit, ist zusätzlich die Angabe der Bitnummer erforderlich.
Immer dann, wenn der Datentyp BOOL ist, ist die Angabe der Bitnummer erforderlich!
Beispiel: E4.3: Bit 3 des Eingangsbytes 4 - hier wird ein Eingangsbit adressiert
Beispiel: MX12.1: Bit 1 des Merkerbytes 12 - hier wird ein Merkerbit adressiert
[.ArrayGröße]
Unter einem Array (engl. = Feld, Reihe, Datenbereich) versteht man eine Reihe von gleichen Elementen.
Ein Array fasst mehrere Einheiten eines Datentyps zu einem Feld zusammen. Sollen beispielsweise
mehrere Wörter aus einem Datenbaustein ausgelesen werden, dann handelt es sich um ein Array von
Wörtern. Um ein Array zu bilden, wird an die Standard-Syntax die Länge des Arrays angefügt, getrennt
durch einen Punkt.
Beispiel: DB10.REAL2.5.
Mehr über Arrays erfahren Sie hier.
[Suffix]
Mit Hilfe eines Suffixes kann ein Wert in einem anderen Format dargestellt werden.
Mehr über Suffixe erfahren Sie hier.
1.2 S5 Item Syntax
Die S5-Item-Syntax hat folgenden Aufbau:
[.ArrayGröße][Suffix]
Ist der Datentyp BOOL, ist die Angabe der Bitnummer erforderlich:
[.ArrayGröße]
Ist der Datentyp STRING, ist die Angabe der Stringlänge erforderlich:
[.ArrayGröße]
[Suffix]
Legende: zwingend erforderlich [ ] optional
Syntax Orientierung1 Zugriffsrechte Hinweise
Datenbausteine DBx. WORD Lesen / Schreiben Bei Bausteinen ist
Erweiterter DXx. WORD Lesen / Schreiben die Angabe einer
Baustein Bausteinnummer
x erforderlich (x =
1 bis 65535).
Merker M oder F BYTE Lesen / Schreiben
Timer T WORD Lesen
Zähler Z oder C WORD Lesen
Eingang E oder I BYTE Lesen
Ausgang A oder O oder Q BYTE Lesen / Schreiben
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.de10 Tani Item Syntax
Peripherie P BYTE Lesen / Schreiben
Erweiterte OB BYTE Lesen / Schreiben
Peripherie
Systembereich WORD Lesen
Absolut AS WORD Lesen
adressierte
Speicherzellen
1
BYTE-orientiert bedeutet, dass je physikalische Adresse ein Byte angesprochen wird.
WORD-orientiert bedeutet, dass je physikalische Adresse ein Wort (16 Bit) angesprochen wird.
für Datenbausteine und erweiterte Datenbausteine
Typ Syntax Beispiel mit Array sinnv. Suffixe
VT_Typ
BIT D DB5D4.12 --- ---
VT_BOOL
BYTE DB DB5DB3 DB5DB3.5 KF, BCD
VT_UI1
LEFT BYTE DL DB5DL4 DB5DL4.2 ---
VT_UI1
RIGHT BYTE DR DB5DR2 DB5DR2.5 ---
VT_UI1
WORD DW DB5DW4 DB5DW4.5 KF, BCD, KT,
VT_UI2 S5T, TR
DOUBLE WORD DD DB5DD3 DB5DD3.2 KF, BCD, KG, T,
VT_UI4 TOD
QUAD WORD DQ DB5DQ3 DB5DQ3.2 KF, BCD
VT_UI8
STRING S DB5S2.80 DB5S2.80.3 1
KA
VT_BSTR
S7-STRING SS DB5SS2.80 DB5SS2.80.3 ---
VT_BSTR
S5-STRING SF DB5SF2.80 DB5SF2.80.3 ---
VT_BSTR
für alle anderen Bereiche
Syntax M E/A P / OB C / T / RS / mit Array sinnvolle
AS Suffixe
BIT M4.3 E4.3 --- --- --- ---
VT_BOOL F4.3 I4.3
A4.3
Q4.3
BYTE B MB4 EB4 PB4 --- MB4.3 KF
VT_UI1 FB4 IB4 OB4 FB4.4 BCD
AB5 EB4.4
QB5 IB4.5
AB5.2
QB5.5
PB4.2
OB4.3
WORD W MW4 EW4 PW2 C5 MW4.2 KF
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.deItem Syntax 11
VT_UI2 FW4 IW4 OW2 T5 FW4.4 BCD
AW5 RS4 EW4.5 KT
QW5 BS4 IW4.2 S5T
AS5 AW5.5 TR
QW5.2
PW2.10
OW2.3
C5.5
T5.3
RS4.2
BS4.7
AS5.2
DOUBLE D MD4 ED4 PD5 --- MD4.4 KF
WORD FD4 ID4 OD5 FD4.2 BCD
VT_UI4 AD5 ED4.6 KG
QD5 ID4.2 T
AD5.6 TOD
QD5.2
PD5.4
OD5.9
QUAD Q MQ4 EQ4 PQ5 --- MQ4.4 KF
WORD FQ4 IQ4 OQ5 FQ4.2 BCD
VT_UI8 AQ5 EQ4.6
QQ5 IQ4.2
AQ5.6
QQ5.2
PQ5.4
OQ5.9
STRING S MS4.80 --- --- --- MS4.80.3 1
KA
VT_BSTR FS4.80 FS4.80.3
S7-STRING SS MSS4.80 --- --- --- MSS4.80.3 ---
VT_BSTR FSS4.80 FSS4.80.3
S5-STRING SF MSF4.80 --- --- --- MSF4.80.3 ---
VT_BSTR FSF4.80 FSF4.80.3
1
KA Suffix geht nicht bei String Arrays
Hinweise zu Countern und Timern
Counter und Timer werden immer wortweise adressiert. Aus diesem Grund ist die Angabe eines
Datentyps nicht erforderlich! An den Bereich "T" bzw. "C/Z" wird direkt die Startadresse
angeschlossen. Timer können nur gelesen werden! Counter können gelesen und geschrieben werden.
Timerwerte werden in Sekunden angezeigt z.B. T = 0.7 => T = 0,7s = 700ms.
Die Darstellung der Counter erfolgt dezimal (0 bis 999).
Die Startadresse gibt die Adresse an, ab der gelesen bzw. geschrieben wird.
Beispiel: DB5DD6: Doppelwort 6 des Datenbausteins 5 ist die Startadresse
Beispiel: MB17: Merkerbyte 17 ist die Startadresse
Ist die Startadresse ein bestimmtes Bit, ist zusätzlich die Angabe der Bitnummer erforderlich
Immer dann, wenn der Datentyp BOOL ist, ist die Angabe der Bitnummer erforderlich!
Beispiel: E4.3: Bit 3 des Eingangsbytes 4: hier wird ein Eingangsbit adressiert
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.de12 Tani Item Syntax
Beispiel: M12.1: Bit 1 des Merkerbytes 12: hier wird ein Merkerbit adressiert
[.ArrayGröße]
Unter einem Array (engl. = Feld, Reihe, Datenbereich) versteht man eine Reihe von gleichen Elementen.
Ein Array fasst von einem Datentyp mehrere Einheiten zu einem Feld zusammen. Sollen beispielsweise
mehrere Wörter aus einem Datenbaustein ausgelesen werden, dann handelt es sich um ein Array von
Wörtern. Um ein Array zu bilden, wird an die Standard-Syntax die Länge des Arrays angefügt, getrennt
durch einen Punkt.
Beispiel: DB10DW3.4.
Mehr über Arrays erfahren Sie hier.
[Suffix]
Mit Hilfe eines Suffixes kann ein Wert in einem anderen Format dargestellt werden.
Mehr über Suffixe erfahren Sie hier.
1.3 Modbus Item Syntax
Die Modbus Item Syntax hat folgenden Aufbau:
[.ArrayGröße][Suffix]
Ist der Datentyp BOOL, ist die Angabe der Bitnummer erforderlich:
[.ArrayGröße]
Mit der folgenden Item Syntax kann eine abweichende UnitID adressiert werden, als die, die bei der
Verbindung angegeben worden ist. Es ergibt sich folgendes:
[UnitID.]
[.ArrayGröße]
[Suffix]
Legende: zwingend erforderlich [ ] optional
[UnitID.]
Die UnitID wird für dieses Item mit der Itemsyntax angegeben.
Dazu wird einfach vor den Itemnamen der Unitidname gesetzt und durch einen Punkt getrennt
(Unitidname.Itemname).
Der Unitidname setzt sich zusammen aus der Zeichenfolge Id und der Nummer.
Der Bereich: 0 - 255
Fehlt die UnitID in der Itemsyntax, so wird die parametrierte UnitID zur SPS verwendet.
Beispiel:
Id1.40001
Id2.R2
Id3.S5.30
Syntax Kürzel Kürzel Nummer Orientierung1 Zugriffsrechte
Discrete Inputs I 1xxxxx BIT Lesen
E
DI
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.deItem Syntax 13
DE
Discrete Outputs A 0xxxxx BIT Lesen / Schreiben
O
Q
DA
DO
DQ
Input Register ER 3xxxxx WORD Lesen
IR
Register R 4xxxxx WORD Lesen / Schreiben
(Holding Register) HR
Discrete Inputs J - BIT Lesen
Oktal 2
Discrete Outputs P - BIT Lesen / Schreiben
Oktal 2
1
BIT-orientiert bedeutet, dass je physikalische Adresse ein Bit angesprochen wird.
WORD-orientiert bedeutet, dass je physikalische Adresse ein Wort (16 Bit) angesprochen wird.
2
Die Eingabe der Startadresse ist Oktal, damit sind die Zahlen 8 und 9 ungültige Zeichen. Intern wird die
Adresse Dezimal verwaltet und ist bei Logger und Status zu Berücksichtigen.
Bereiche können entweder über die oben genannte Buchstabenfolge oder über eine Nummer
adressiert werden. So kann ein Discrete Input über das Kürzel "E" ebenso angesprochen werden wie
über die Nummer "1", Discrete Output "O", "A" oder Nummer "0", Input Register "ER", "IR" oder Nummer
"3", Register "R", "HR" oder Nummer "4".
Datentyp Syntax Syntax R Syntax Syntax mit Array sinnv. Suffixe
VT-Typ E/A ER
1
BIT X RX5.2 1 E5 ERX5.2 1 ----
VT_BOOL HRX5.2 1 I5 3X5.2 1
4X5.2 1 DE5
DI5
100005
A5
O5
Q5
DA5
DO5
DQ5
000005
LEFT CHAR LC RLC5 --- ERLC5 RLC5.2
RIGHT CHAR RC RRC5 --- ERRC5 RRC5.2
VT_I1
LEFT BYTE LB RLB5 --- ERLB5 RLB5.2
RIGHT BYTE RB RRB5 --- ERRB5 RRB5.2
VT_UI1
INT ohne R5 --- ER5 R5.2
VT_I2 HR5 IR5 HR5.2
45 35 45.2
I RI5 ERI5 ERI5.2
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.de14 Tani Item Syntax
HRI5 IRI5 IRI5.2
4I5 3I5 3I5.2
WORD W RW5 ---- ERW5 RW5.2
VT_I2 HRW5 IRW5 HRW5.2
4W5 3W5 4W5.2
ERW5.2
IRW5.2
3W5.2
DOUBLE INT D RD5 --- ERD5 RD5.2 TOD
VT_I4 HRD5 HRD5.2
4D5 4D5.2
DI RDI5
HRDI5
4DI5
DOUBLE D RDW5 --- ERDW5 RDW5.2 TOD
WORD HRDW5 IRDW5 HRDW5.2
VT_I4 4DW5 3DW5 4DW5.2
ERDW5.2
IRDW5.2
3DW5.2
QUAD INT Q RQ5 --- ERQ5 ERQ5.2
VT_I8 QI HRQ5 IRQ5 IRQ5.2
4Q5 3Q5 3Q5.2
RQI5
HRQI5
4QI5
QUAD WORD QW RQW5 --- ERQW5 RQW5.2
VT_UI8 HRQW5 IRQW5 HRQW5.2
4QW5 3QW5 4QW5.2
ERQW5.2
IRQW5.2
3QW5.2
REAL R RR5 ---- ERR5 RR5.2
VT_R4 ERR5.2
DOUBLE QR RQR5 --- ERQR5 RQR5.2
VT_R8 ERQR5.2
STRING2 S RS5.80 ---- ERS5.80 SWAP 2
RS5.80.3
2
VT_BSTR KA 3
1
Diskrete Ein- und Ausgänge belegen in der SPS 1 Bit. Beim Lesen aus dem Register und Input
Register Bereich wird das ganze Wort gelesen und das Bit extrahiert.
Hinweis:
Schreiben von einzelnen Bits im Register und Input Register Bereich ist nicht zulässig.
Bitte Lesen Sie das ganze Register, setzen das entsprechende Bit und schreiben das Register
wieder zurück.
2
Bei String ist der Suffix SWAP möglich, um die Bytes die richtige Reihenfolge zu geben.
3
KA Suffix geht nicht bei String Arrays
Die Startadresse gibt die Adresse an, ab der gelesen bzw. geschrieben wird.
Beispiel:
ER5 -> Input Register 5
A12 -> Ausgang 12
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.deItem Syntax 15
Immer dann, wenn der Datentyp BOOL ist, ist die Angabe der Bitnummer erforderlich!
Beispiel: HRX5.2: Bit 2 des Holding Register 5
[.ArrayGröße]
Um von einem Datentyp mehrere Einheiten zu einem Feld zusammenzufassen, werden Arrays gebildet.
Beispiel: HRD5.3
Mehr über Arrays
[Suffix]
Mit Hilfe eines Suffixes kann ein Wert in einem anderen Format dargestellt werden.
Mehr über Suffixe erfahren Sie hier.
1.4 PLC-5 / SLC Item Syntax
Die Item Syntax für PLC-5 und SLC hat folgenden Aufbau:
[Filenummer][.ArrayGröße][Suffix]
Legende: zwingend erforderlich [ ] optional
File Typ Syntax Orientierung* Zugrifssrechte Default Adressangabe
Filenummer
Output O BIT Lesen / 0 oktal
Schreiben
Input I BIT Lesen 1 oktal
Integer N WORD Lesen / 7 dezimal
Schreiben
Binary B WORD Lesen / 3 dezimal
Schreiben
Float F DOUBLE WORD Lesen / 8 dezimal
Schreiben
String ST SLC-String Lesen / 3 dezimal
Schreiben
SFC-Status SC WORD Lesen / 3 dezimal
Schreiben
Status S WORD Lesen / 2 dezimal
Schreiben
Timer T WORD Lesen / 4 dezimal
Schreiben
Counter C WORD Lesen / 5 dezimal
Schreiben
Control R WORD Lesen / 6 dezimal
Schreiben
ASCII A WORD Lesen / 3 dezimal
Schreiben
* BIT-orientiert bedeutet, dass je physikalische Adresse ein Bit angesprochen wird.
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.de16 Tani Item Syntax
WORD-orientiert bedeutet, dass je physikalische Adresse ein Wort (16 Bit) angesprochen wird.
DOPPELWORT-orientiert bedeutet, dass je physikalische Adresse ein Doppelwort (32 Bit)
angesprochen wird.
[Filenummer]
Die Filenummer kann optional angegeben werden. Wird Sie nicht angegeben, wird die Default-
Filenummer verwendet. Siehe Spalte Default Filenummer in der Tabelle.
Die Startadresse gibt die Adresse an, ab der gelesen bzw. geschrieben wird. Die Startadresse kann aus
2 Angaben bestehen: Wort- (Float-) Nummer und wenn ein einzelnes Bit angesprochen wird, dann Bit-
Nummer. Bei einem Bit kann die Wortnummer weggelassen werden. Die Wort-Nummer bzw. Float-
Nummer wird mit einem Doppelpunkt (:) eingeleitet. Die Bit-Nummer mit einem Slash (/) bzw.
bzw. . Hinter dem Doppelpunkt kann noch ein Format angegeben werden. Wenn nicht gilt
das Datenformat aus der Spalte Orientierung
Format Syntax Item-Format
String S STRING
High Byte H WORD
Low Byte L WORD
Byte B WORD
Die Adressangabe erfolgt bei einigen Bereichen oktal, bei anderen dezimal. Siehe Spalte Adressangabe
Als Startadresse wird entweder die Wortnummer, die Floatnummer oder die Bitnummer angegeben:
bzw. bzw.
Zur Adressierung eines bestimmten Bits innerhalb eines Wortes, wird folgende Syntax verwendet:
HINWEIS:
Beim Schreiben von Bits wird das ganze Wort geschrieben!
Syntax Erklärung
O:0 Wort 0 im Ausgangs-File 0
O:0/12 Bit 10 (12 oktal = 10 dezimal) im Ausgangs-File 0
O/12 Bit 10 (12 oktal = 10 dezimal) im Ausgangs-File 0
I:37 Wort 31 (37 oktal = 31 dezimal) im Eingangs-File 1
I4:37/2 Bit 2 in Wort 31 ( (37 oktal = 31 dezimal) im Eingangs-File 4
I:1/0 Bit 0 in Wort 1 im Eingangs-File 1
B3/26 Bit 26 im Binary-File 3
B12:5.15 Array von 15 Wörtern im Binary-File 12, ab Wort 5
B12:5/15 Bit 15 im Wort 5 des Binary-Files 12
F8:0 Float 0
F9:10.16 Array von 16 Doppelwörtern des Float-Files 9, ab Doppelwort 10
N23:4 Wort 4 des Integer-Files 23
N23:4.10 Array von 10 Worten im Integer File 23, ab Wort 4
N23:4/2 Bit 2 im Wort 4 des Integer Files 23 = Bit 66 im Integer File 23
N23/66 Bit 66 im Integer File 23
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.deItem Syntax 17
[.ArrayGröße]
Um von einem Datentyp mehrere Einheiten zu einem Feld zusammenzufassen, werden Arrays gebildet.
Arrays sind nur möglich für Wortbereiche und Floatbereiche.
Beispiele: N23:4.10
[Suffix]
Mit Hilfe eines Suffixes kann ein Wert in einem anderen Format dargestellt werden. Wird kein Suffix
angegeben, gelten die Formate aus der Spalte Orientierung
Mehr über Suffixe
1.5 MELSEC-Q Item Syntax
Für das Anlegen von Items, stehen zwei Syntax-Varianten zur Verfügung:
1. Einfache Variante:
[.ArrayGröße][Suffix]
2. Erweiterte Variante:
[.ArrayGröße][Suffix]
Legende: zwingend erforderlich [ ] optional
BITTE BEACHTEN SIE:
Bei der erweiterten Variante ist zwischen dem und dem ein Punkt oder Komma
erforderlich. Wird der Punkt bzw. das Komma weggelassen, entspricht die Syntax der einfachen
Variante. Der entspricht dann dem Default Typ (bei Bit-Bereichen Bit, bei Wort-Bereichen
WORD - siehe Tabelle ).
Ist die Repräsentation der Startadresse des Bereichs HEX, so sind alle Zahlenangaben für diesen
Bereich ebenfalls HEX
Die Zahlenangaben HEX / Dezimal kann mit den folgenden Präfixen geändert werden:
Umwandlung HEX -> DEZ: Eingabe von 0d (Zahl Null + Buchstabe d) vor der dezimalen Adresse
Umwandlung DEZ -> HEX: Eingabe von 0x (Zahl 0 + Buchstabe x) vor der hexadezimalen Adresse
Werden Worte, Doppelworte oder Strings in einem Bit-Bereich angemeldet, so ist die Startadresse
eine Bit-Adresse und nur an Wortgrenzen möglich (Dez: 0/16/32... bzw. Hex: 0/10/20...)
z.B. Y.D10.3
Bitmaskierung ist möglich. Die Bit-Maske wird vor dem Suffix angegeben (siehe Bit-Maskierung).
Syntax Orientierung* Repräsentation der
Startadresse
Special Relay SM BIT Dezimal
Special Register SD WORD Dezimal
Input Relay X BIT HEX
Output Relay Y BIT HEX
Internal Relay M BIT Dezimal
Latch Relay L BIT Dezimal
Annunciator F BIT Dezimal
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.de18 Tani Item Syntax
Edge Relay V BIT Dezimal
Link Relay B BIT HEX
Data Register D WORD Dezimal
Link Register W WORD HEX
Timer Contact TS BIT Dezimal
Timer Coil TC BIT Dezimal
Timer Current Value TN WORD Dezimal
Retentive Timer Contact STS BIT Dezimal
Retentive Timer Coil STC BIT Dezimal
Retentive Timer Current STN WORD Dezimal
Value
Counter Contact CS BIT Dezimal
Counter Coil CC BIT Dezimal
Counter Current Value CN WORD Dezimal
Special Link Relay SB BIT HEX
Special Link Register SW WORD HEX
Step Relay S BIT Dezimal
Direct Input DX BIT HEX
Direct Output DY BIT HEX
Index Register Z WORD Dezimal
File Register R WORD Dezimal
(Normal Access by block
Switching)
File Register ZR WORD Dezimal
(Serial No. Access)
* BIT-orientiert bedeutet, dass je physikalische Adresse ein Bit angesprochen wird. WORD-orientiert
bedeutet, dass je physikalische Adresse ein Wort (16 Bit) angesprochen wird.
Typ Syntax Einfache Beispiel Bit- Beispiel mit Array mit Array sinnvolle
VT_Typ Syntax Bereich Word- Bit-Bereich Word- Suffixe
Bereich Bereich
BIT X DY1 ----- D.X1.2 ----- ----- -----
VT_BOOL
BIT 1 ----- DY1 ----- D.1.2 ----- ----- -----
VT_BOOL
BYTE B ----- Y.B10 R.B1 Y.B10.5 R.B1.3 -----
VT_UI2 BYTE Y.BYTE10 R.BYTE1 Y.BYTE10.5 R.BYTE1.
3
INT I Y.I10 Y.I10 R.I2 Y.I10.3 R.I2.3 -----
VT_I2 INT Y.INT10 Y.INT10 R.INT2 Y.INT10.3 R.INT2.3
WORD W R20 Y.W10 R.W2 Y.W10.3 R.W2.3 -----
VT_UI2 WORD Y.WORD10 R.WORD2 Y.WORD10. R.WORD2
3 .3
DOUBLE D ----- Y.D10 R.D2 Y.D10.3 R.D2.3 -----
WORD DW Y.DWORD1 R.DWORD Y.DWORD1 R.DWORD
VT_UI4 DWORD 0 2 0.3 2.3
DOUBLE DI ----- Y.DI10 R.DI2 Y.DI10.3 R.DI2.3 -----
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.deItem Syntax 19
INT DINT Y.DINT10 R.DINT2 Y.DINT10.3 R.DINT2.3
VT_I4
REAL R ----- Y.R10
R.R2 Y.R10.3 R.R2.3 -----
VT_R4 REAL Y.REAL10
R.REAL2 Y.REAL10.3 R.REAL2.
3
STRING S ----- Y.S10.20 R.S2 ----- ----- -----
VT_BSTR STRING Y.STRING10 R.STRING
.20 2.20
1
Vorsicht: Bei HEX-Adressen wählen Sie besser die Variante mit dem X
[.ArrayGröße]
Um von einem Datentyp mehrere Einheiten zu einem Feld zusammenzufassen, werden Arrays gebildet.
Beispiele:
X10.5
D20.300
Mehr über Arrays
[Suffix]
Mit Hilfe eines Suffixes kann ein Wert in einem anderen Format dargestellt werden.
Beispiel: D20.300KF
Mehr über Suffixe
1.6 Send/Receive Item Syntax
Die Send/Receive Telegramme werden als Byte Array behandelt.
Der Name ist raw.
Die Telegramme werden immer an einem Stück gesendet und empfangen. Beim Verbindungen ohne ein
Protokoll wie PLC Header oder RFC1006 oder OSI/H1 kann nicht sichergestellt werden das nicht
mehrere Telegramme zusammengefasst werden. Es können auch an einem Stück gesendete
Telegramme beim Partner in mehreren Teilen ankommen.
Idealerweise werden RAW Daten in der PLC Engine verarbeitet. Dort existieren viele Zugriffsfunktionen
wie Suchen, Wandeln und Weitere.
1.7 BrowsingTree
Der Adressraum des Servers kann mit Hilfe des Online Browsing erforscht werden.
Der Adressraum liegt bei OPC Classic und OPCPipe in der Wurzel.
Beispiele: .flag0. Oder "System.Topics..Status
Bei OPC UA liegt in der Wurzel "Objects". Darunter liegen je nach OPC Konfiguration mehrere
Elemente. Wichtig ist das Element "Topics" unter dem alle weiteren Elemente liegen die sich auf die
Anlage bezieht.
Falls Sie in der OPC UA Serververbindung den Dateizugriff erlaubt haben so finden Sie unter
"Objects"auch das Element "FileSystem".
Beispiele:
Objects.Topics..flag0
Objects.Topics.System.Topics..Status
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.de20 Tani Item Syntax
Wenn Sie bei OPC UA anstatt Browsing die Itemsyntax direkt nutzen wollen so wird ein Prefix
benötigt.Welches Prefix Ihr OPC UA Server benötigt entnehmen Sie bitte der Dokumentation des
jeweiligen UA Servers. Leider hat sich kein Standard etabliert, die UA Norm sieht alles vor von Namen,
UUIDs, Nummern bis zu beliebigen binären Daten. Eine Längenbegrenzung existiert nicht, auch ist nicht
festgelegt ob dieser Prefix über ein Neuaufbau einer Verbindung gleich bleibt.
Der Tani OPC Server benötigt wenn Sie nicht browsen am Anfang nach dem UA
Verbindungsnamen"#ns=1;s=" ein. Lassen Sie "Objects.Topics" weg.
Beispiel: Mit dem Tani Test Client Lesen des Merkerworts 0 aus einer Siemens S7 300, sie OPC
Verbindung heisst "OPC", die SPS Verbindung heisst "s7": "OPC.#ns=1;s=s7.mw0
1.8 Systemelement Baum
In dem System Baum befinden sich die Speziellen Items, die vom Server fest vorgegeben sind. Sie
erlauben den Zugriff auf interne Variablen und Zustände, das Anlegen weiterer Variablen und Symbole
und vieles mehr.
Der System Baum "System" befindet sich bei
OPC-DA und OpcPipe: direkt im Hauptverzeichnis
OPC-UA unter "Objects.Topics"
Die Speziellen Items erlauben einige Funktionen, so kann z.B. durch Schreiben auf das Spezielle Item
"AddTopic" weitere Verbindungen zu SPS Steuerungen hinzugefügt werden, ohne die
Konfigurationssoftware zu verwenden. Dabei ist die erforderliche Syntax einzuhalten.
Beispiele:
SPS Verbindungsstatus: Wenn eine Verbindung namens "S7" konfiguriert ist so liegt der
Verbindungsstatus unter
System.Topics.s7.Status (für OPC-DA ind OpcPipe)
Objects.Topics.System.Topics.s7.Status (für OPC-UA)
Der Betriebsmodus der Steuerung liegt unter
System.Topics.s7.PlcDetails.PlcMode (für OPC-DA ind OpcPipe)
Objects.Topics.System.Topics.s7.PlcDetails.PlcMode (für OPC-UA)
Verbindung erstellen mit Schreiben der Verbindungsparameter auf System.AddTopic.
"s7.tcp://192.168.2.200:102?name=\"my name
\",typ=client,ownTSAP=0101,destinationTSAP=0302,slave=9,start1=1,WriteAllowed=1"
Der System Baum kann mit der Konfiguration unter "Station" - "Allgemeine Systemeinstellungen"
"System Topic benutzen" abgeschaltet werden.
Elemente auf der Startebene
Bei OpcPipe und OPC DA liegt die Startebene im Hauptverzeichnis.
Unter OPC-UA liegt die Startebene unter "Objects.Topics"
Topicname Beschreibung
System Systemdaten wie Liste der Topics, Versionsstände
Memory Temporäre Variablen und Strukturen, die im Arbeitsspeicher liegen.Item Syntax 21
defined> erstellte Topics
System
Topicname Beschreibung
AddTopic Hinzufügen von Verbindungen zu Steuerungen.
Durch Schreiben eines Strings mit einer bestimmten Syntax werden
Verbindungen hinzugefügt. Die Syntax ist in einer Tabelle weiter unten
beschrieben. Siehe: AddTopic.
Topics Das vordefinierte Item "System.Topics" enthält die Liste der konfigurierten
Verbindungen zu Steuerungen. Diese Elemente erlauben über OPC interne
Zustände des OPC Servers und der Verbindungen zu den Steuerungen zu
überwachen.
Zusätzlich können Details der Steuerung ausgelesen werden wie der Name der
Steuerung, der Betriebszustand und mehr.
Versions Versionen der Softwareteile des OPC Servers oder der PlcEngine
Internal Bitte nicht benutzen. Spezielle Individualanwendungen nutzen das.
Werte für System.Topics.
Topicname Beschreibung
Status Liefert den Status der Verbindung.
0 -> OK
3 -> Keine Verbindung
5 -> Zugriff verweigert
6 -> Warte auf Daten
7 -> Warte auf Senden fertig
29 -> Nicht aktiv, kein OPC Client und keine Logiktabelle nutzt ein Element
30 -> Osi Reset By Peer. Eine Verbindung mit TSAP wird vom Partner
zurückgewiesen.
31 -> Der Port ist bereits von einem anderen Programm belegt
32 -> Ein Domainname wird nicht gefunden
33 -> Das Netzwerk ist nicht erreichbar
ReadCount Anzahl der synchronen Leseaufträge. Diese Variable kann geschrieben werden.
WriteCount Anzahl der Schreibaufträge. Diese Variable kann geschrieben werden.
ActiveCoun Anzahl aktiver angemeldeter Elemente.
t
ServerCycl Anzahl der Cyclen mit Datenänderungen in der Steuerung. Diese Variable kann
e geschrieben werden.
Redundanc Das existiert nur bei Verbindungen für Redundanz. Details hier.
y
AddVariabl Das Element existiert nur im Element Menory.
e Fügt eine Variable dynamisch in die Speichervariablen ein, Topic Memory. Das
Element kann nur geschrieben werden.
Die Syntax ist
=
Variablentyp kann sein: u8, u16, u32, u64. i8, i16, i32, i64, f32, f64, bit, string.
Beispiel: MyVariable=u16[10];Array of UINT 16 with 10 elements
Sie können auch Nodes anlegen. Wenn der Variablenname Punkte enthält so
werden diese Punkte als Trenner der Nodes und Variablen genutzt.
Hinweis: Die mit AddVariable erstellten Symbole werden beim Beenden des
OPC Servers oder der PLC Engine gelöscht.
DeleteVari Löscht eine mit AddVariable erstellte Variable. Der Variablenname muss
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.de22 Tani Item Syntax
able angegeben werden. Das Element kann nur geschrieben werden.
Jede Variable oder jeder Node muss einzeln gelöscht werden.
Hinweis: Versuchen Sie eine Variable zu löschen die nicht mit AddVariable
erstellt wurde so wird der Zugriff verweigert.
AddSymbol Fügt ein Symbol hinzu. Dazu wird die Itemsyntax der SPS benutzt die das
Topic abbildet.
Diese Funktion wird nicht für alle SPS Typen angeboten. Sie macht nur für
Steuerungen die keine Symbole beinhalten einen Sinn. Oft sind das Siemens
S7 300/400, Modbus oder Mitsubishi Steuerungen.
SymbolName=
Beispiel für eine S7 300: MyFlag=mw0;Flag word zero
Der Symbolname kann das Trennzeichen . beinhalten. So können mehrere
Ebenen angelegt werden.
Hinweis: Die mit AddSymbol erstellten Symbole werden beim Beenden des
OPC Servers oder der PLC Engine gelöscht.
DeletSymb Löscht ein mit AddSymbol angelegtes Symbol.
ol
AddStructu Noch nicht verfügbar
re
DeleteStru Noch nicht verfügbar
cture
DeleteTopi Ist eine Verbindung dynamisch hinzugefügt worden, so ist dieses Item sichtbar.
c Wird darauf geschrieben, so wird diese dynamisch angelegte Verbindung
gelöscht.
Werte für System.Topics..PlcDetail
Kann die Information aus der SPS nicht gelesen werden, so ist die Quality BAD (Sensor Failure).
Topicname Beschreibung
PlcMode 0 -> SPS in Stop, 1 -> SPS in RUN/STOP, 2 -> SPS in RUN.
KeySwitch 0 -> Schlüsselschalter in Position Stop, 1 -> Run/Prog, 2 -> Run, 3 -> Mres
PlcName Der Name der der Steuerung vergeben wurde. Nicht jede Steuerung enthält den
Namen.
PlcType Der SPS Typ den der Hersteller vergeben hat. Nicht jede SPS enthält diese
Information.
OrderNumb die Bestellnummer
er
Force Information ob Force Elemente im SPS Programm vorliegen.Manche
Steuerungen liefern auch die Anzahl geforcter Elemente.
Battery Zustand der Batterie. 0 -> Ok, 1 -> Leer, 2 -> keine Batterie, 3 -> nicht
unterstützt
Nicht jede Steuerung und jeder Steuerungstyp liefert alle Elemente unter PlcDetails. So wird
OrderNumber nur bei Siemens S7 angeboten. Die genauen Details bestimmen Sie mit der SPS
Programmiersoftware, sie sind auch im entsprechenden SPS Systemhandbuch beschrieben.
Werte für System.AddTopic
Es können weitere Topics über OPC erzeugt werden.
Wichtig: Über AddTopic angelegte Verbindungen werden nicht dauerhaft gespeichert. Bei Rechner
Neustart oder Geräte Netzein sind sie wieder weg und müssen erneut angelegt werden.
Ein unter System.Topics. angelegtes Topic kann über System.Topics.DeleteTopic wieder gelöscht werden.
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.deItem Syntax 23
Topicname Beschreibung
Name . Das ist der Name der Verbindung. Beachten Sie bei den
verwendeten Zeichen die Regeln der OPC Clients.
PlcType Möglich sind:
Wert Beschreibung
s7 Siemens S7-200, 300, 400 und Kompatible wie Speed7.
Auch über MPI Adapter von Hilscher, Process Informatik,
IBH Softec, Softing, Helmholz.
tia Siemens 1500 und 1200. Die optimierten Bausteine werden
unterstützt.
s5 Siemens S5 mit Netzwerk CP Alle Racks wie 135, 155, 188.
Alle CPU Typen.
compactlogic Rockwell Control Logix und Compact Logix.
s
slc Rockwell SLC Familie.
modbus Modbus TCP und kompatible Systeme wie Wago, Beckhoff,
Modicon, Omron und Weitere.
melsecQ Mitsubishi Melsec Familie.
raw Rohdaten.
NetworkProtoc Möglich sind:
ol Wert Alternativer Beschreibung
Wert
ip tcp TCP/IP TCP über IpV4 (192.168.1.1) oder IpV624 Tani Item Syntax
1 -> Ungültige Verbindungsparameter. Oft tritt das bei zu langen TSAPs
auf.
5 -> ungültiger Adapter. Das tritt z.B. bei USB Ethernetadaptern auf die
entfernt wurden.
17 -> Kein Speicher mehr frei.
101 -> Nicht unterstützt. Das tritt z.B. bei SPS Protokollen auf die nicht
vorhanden sind.
1319 -> Nicht untertützt. Das geschieht z.B. bei IPV6 was im
Betriebssystem nicht konfiguriert ist.
1324 -> Lizenzgrenze erreicht. Mehr Verbindungen können nicht angelegt
werden.
1325 -> Nicht lizensiert.
AddTopic Kann statt der Untervariablen Name, PlcType, NetworkProtocol,
NetworkAddress, Port, ConnectType, OwnTSAP, DestinationTSAP
direkt eine Verbindung erstellt werden. Diese Variable kann nur geschrieben
werden. Die Syntax dazu ist am Beispiel einer S7 Verbindung mit dem
Namen "s7"
"s7.tcp://192.168.2.200:102?name=\"my name
\",typ=client,ownTSAP=0101,destinationTSAP=0302"
Das Element Create wird dann nicht benutzt.
Werte für System.Versions
Eine Versionsnummer ist Null wenn die entsprechende Bibliothek nicht geladen ist.
Topicname Beschreibung
PlcEngine Versionsnummer des Kerns von PlcEngine und OPC Server
Wmk Versionsnummer der Wmk Bibliothek. Diese Bibliothek enthält allgemeine
Funktionen.
IpLib Versionsnummer der TCPIP Bibliothek. Diese Bibliothek enthält alle IP Socket
Funktionen.
H1 Versionsnummer des Osi/H1 Treibers.
OpcDA Versionsnummer der OPC DA Bibliothek. Diese Bibliothek enthält Classic
OPC und ist nur für Windows verfügbar.
OpcUA Versionsnummer der OPC UA Bibliothek. Diese Bibliothek enthält OPC UA.
OpcPipe Versionsnummer der OpcPipe Bibliothek. Diese Bibliothek enthält das Item
Management.
PlcLib Versionsnummer der SPS Protokoll Bibliothek. Diese Bibliothek enthält alle
SPS Protokolle und das Management dazu.
ItemSyntax Versionsnummer der Item Syntax Bibliothek. Diese Bibliothek wandelt
Symbole in Elemente.
ConfigSubs Versionsnummer der Configuration Allgemein Bibliothek. Diese Bibliothek
vermittelt die Konfigurationsdaten.
.. Je nach Software und Ausgabestand werden weitere Versionen gezeigt.
Werte für System.Licenses
Die Lizenzen und deren Details stehen hier bereit
Itemname Beschreibung
BaseLicense Bestellnummer des gewählten Produkts. Der Produktname ist im
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.deItem Syntax 25
Kommentar des Items enthalten.
BaseLicenseE Ablaufdatum bei zeitlich befristeten Lizenzen wie Demoversionen oder
xpires zeitlich befristeten Lizenzen im Format in the format jjjj-mm-tt hh:mm
z.B.: 2017-12-31 23:59
BaseLicenseSt Bitkodierter Wert:
ate Bit 0: Eine permanente Lizenz ist vorhanden und sie ist OK.
Bit 1: Der Dongle ist erkannt und OK.
Bit 2: Der Dongle war in der Vergangenheit erkannt, nun ist er aber nicht
auffindbar.
Bit 3: Lizenzierung über Software Freischaltcode.
Bit 4: Ein Software Freischaltcode ist erkannt und OK.
Bit 5: Ein zeitlich begrenzter Freischaltcode ist erkannt. Die Ablaufzeit wird
in dem item BaseLicenseExpires ausgegeben.
Bit 6: Ein zeitlich begrenzter Freischaltcode ist erkannt und abgelaufen.
Bit 7: Die Hardware (Netzwerkkarte) an die die Lizenz gebunden war ist
nicht mehr vorhanden.
Bit 8: Keine Lizenz ist erkannt, es ist eine Testversion. Die Ablaufzeit wird in
dem item BaseLicenseExpires ausgegeben.
Bit 9: Die Testphase ist abgelaufen, ein Neustart ist erforderlich.
Bit 10: Freie Lizenz eingestellt, keine Lizenzierung erforderlich
AddonLicense Bestellnummer eines Addons. X ist eine fortlaufende Nummer und startet mit
X 1. Wenn mehrere Addons lizenziert sind dann sind entsprechend viele
AddonLicenseX vorhanden. Der Kommentar des Items enthält den Namen
des Addons.
1.9 Redundanz
Bei Verbindungen mit Netzwerkredundanz existiert im Statusbereich das Element Redundancy.
Elementname Beschreibung
CurrentMaster Lesen liefert den aktuellen Master. 1 ist die erste Verbindung.
Schreiben auf diese Variable ändert die Masterverbindung auf die
angegebene Verbindung.
Hinweis:
Wird ein ungültiger Wert geschrieben so geschieht nichts.
Bei dynamischem Master wird auf die neue Verbindung geschaltet.
Arbeitet diese Verbindung stabil wo wird sie beibehalten. Andernfalls wird
eine andere Verbindung Master.
Bei statischem Master wird von der neuen Masterverbindung nach einer
Minute wieder zur ersten Verbindung geschaltet wenn diese stabil
arbeitet. Ist die neue Verbindung gestört so wird direkt auf den Master
geschaltet wenn diese stabil arbeitet. Andernfalls wird auf eine andere
Verbindung gewechselt die stabil ist.
Connection Diese Variable ist so oft vorhanden wie Redundanzverbindungen angelegt
sind.
In jeder Connection Variablen liegen
Status
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.de26 Tani Item Syntax
ServerCycle
ReadCount
WriteCount.
Diese Variablen arbeiten genauso wie die von nicht redundanten
Verbindungen. Details hier.
1.10 Bit Maskierung
Einzelne Bits eines Datentyps können zu einem Wert zusammengefasst werden. Diese ergeben dann
einen dezimalen Wert. Auch eine Bitmaskierung über mehrere Felder eines Datentyps ist möglich
(Bitmaskierte_Arrays).
Syntax
Wenn aus dem Datenwort 0 des Datenbausteins 5 ab dem zweiten Bit insgesamt 8 Bits gelesen werden
sollen, wird folgende Syntax verwendet:
- db5.w0#2.8 oder
- db5.w0#2,8 oder
- db5.w0#2#8
Beispiele
DB10.W03.4
DB10.DWord2#20.10
DB10.DWord6#20.10KF
DB10.DInt10#20#10
Hinweis:
Funktioniert nicht bei Left Byte oder Right Byte (DL, DR) und Suffix BA
Hinweis:
Bits aus einem Real oder KG sollten Sie nicht maskieren, da dies zu unerwarteten Ergebnissen führt.
1.11 Arrays
Unter einem Array (engl. = Feld, Reihe, Datenbereich) versteht man eine Reihe von gleichen Elementen.
Ein Array fasst mehrere Einheiten von eines Datentyps zu einem Feld zusammen. Um ein Array zu
bilden, wird an die Standard-Syntax die Länge des Arrays angefügt, getrennt durch einen Punkt.
Arrays sind NICHT möglich bei:
bei allen Suffixes, die zum Client hin String sind:
o ISO
1.12 Suffixe
Mit Hilfe eines Suffixes kann ein Wert in einem anderen Format dargestellt werden.
Suffixes Synt Anwendbar Bereich Datenty Variant Kommentar
ax bei p Data Type
Date and ISO DT 1990-1-1- STRING VT_BSTR Mit dem Suffix ISO werden
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.deItem Syntax 27
Time in 00:00:00.000 bis die in der SPS
String 2098-12-31- gespeicherten Daten als
Format 24:59:59.999* zusammengesetzter
Datentyp DATE_AND_TIME
dargestellt und als String
übertragen. Die Darstellung
enthält das Jahr, den Monat,
den Tag, die Stunde, die
Minute, die Sekunde und die
Millisekunde. Auf die
Trennzeichen (Bindestrich,
Doppelpunkt und Punkt) ist
zu achten!
BCD BCD Byte Byte: 0 bis 99 VT_I1 VT_I1 Mit dem Suffix BCD werden
Word Word: 0 bis 999 VT_I2 VT_I2 die in der SPS
DWord DWord: 0 bis VT_I4 VT_I4 gespeicherten Daten als
QWord 9999999 VT_I8 VT_I8 vorzeichenloser,
QWord: 0 bis binärcodierter Wert
9999999999999999 dargestellt. So wird
beispielsweise der
Dezimalwert "65535" als
"9999" dargestellt.
ASCII to KA String HEX: 0 bis 9, A bis F STRING VT_BSTR Mit dem Suffix KA werden
Hex die in der SPS
gespeicherten Daten als
Hexzeichen dargestellt. geht
nicht bei String Arrays
Signed KF Byte Byte: -128 bis 127 CHAR VT_I1 Mit dem Suffix KF werden
Word Word: -32768 bis SHORT VT_I2 die in der SPS
DWord 32767 LONG VT_I4 gespeicherten Daten als
QWord DWord: -2147483648 LLONG VT_I8 vorzeichenbehaftete
bis 2147483647 Festpunktzahl dargestellt.
QWord
775.808 bis
9.223.372.036.854.77
5.807
S5-KG KG DWord 0,1469368E-38 bis REAL VT_R4 Mit dem Suffix KG werden
0,1701412E39 die in der SPS
Achtung! Der KG- gespeicherten Daten als 4
Bereich ist in der Byte Gleitpunktzahl
SPS Größer als im (Floating Point) behandelt.
PC!
S5-KT- KT Word 000.0 bis 999.3 STRING VT_BSTR Mit dem Suffix KT werden
Format die in der SPS
gespeicherten Daten als 2
Byte Zeitkonstante
dargestellt. Neben dem
Zeitwert wird dabei die
Zeitbasis mitgeliefert. Der
Wertebereich geht von 000.0
bis 999.3
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.de28 Tani Item Syntax
S5 Time S5T Word 0ms bis 2h46m30 STRING VT_BSTR Mit dem Suffix S5T werden
die in der SPS
gespeicherten Daten als
Simatic-Zeit S5TIME
dargestellt. Der Datentyp
S5TIME belegt ein 16-Bit-
Wort und ist das Produkt
aus Zeitwert und Zeitraster.
Die Zeitdauer wird in
Stunden, Minuten,
Sekunden und
Millisekunden angegeben.
Die interne Darstellung
erfolgt als BCD-Zahl. Der
Wertebereich geht von 0 ms
bis 2h46m30s. Der kleinste
Wert ist 10ms.
Date D Word 1990-01-01 bis STRING VT_BSTR Das Suffix D wird verwendet,
2168-12-31 um die in der SPS
gespeicherten Daten als
Datentyp DATE (Datum)
darzustellen. Der Datentyp
DATE belegt ein Wort. Der
Inhalt entspricht der Anzahl
der Tage seit 01.01.1990.
Die Darstellung enthält das
Jahr, den Tag und den
Monat, jeweils getrennt
durch einen Bindestrich. Der
01. September 2006 wird
dargestellt als 2006-01-09.
Der Wertebereich geht von 0
(0 Tage seit 01.01.1990:
1990-01-01) bis 65378
(65378 Tage seit
01.01.1990: 2168-12-31).
Regeln zur Verwendung des
Suffix D:
Die Jahre 1990 bis
einschließlich 2089
können 2- oder 4-stellig
angegeben werden. Die
Jahre ab 2090 müssen 4-
stellig eingegeben
werden.
90 bis 99 ==> 1990 bis
1999
00 bis 89 ==> 2000 bis
2089
Die Monate und Tage
können 1-oder 2-stellig
angegeben werden.
Als Trennzeichen ist alles
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.deItem Syntax 29
erlaubt außer Zahlen (z.B.
89/01/17). Die Anzahl der
Trennzeichen ist beliebig
Time T DWord - STRING VT_BSTR Mit dem Suffix T werden die
24d20h31m23s648m in der SPS gespeicherten
s Daten als Datentyp TIME
bis dargestellt. Der Datentyp
24d20h31m23s647m TIME belegt ein Doppelwort
s (32 Bit). Die Darstellung
enthält die Angaben für Tage
(d), Stunden (h), Minuten
(m), Sekunden (s) und
Millisekunden (ms).
Milisekunden könnenn
weggelassen werden.
Der Wertebereich geht von -
2147483648 (-
24d20h31m23s648ms) bis
2147483647
(24d20h31m23s647ms)
Time of TOD DWord, DInt 0:0:0.0 bis STRING VT_BSTR Mit dem Suffix TOD werden
Day 23:59:59.999 die in der SPS
gespeicherten Daten als
Datentyp TIME_OF_DAY
dargestellt. Der Datentyp
TIME_OF_DAY belegt ein
Doppelwort (32 Bit). Die
Darstellung enthält die
Angaben für
Stunden:Minuten:Sekunden
und .Millisekunden.
Milisekunden könnenn
weggelassen werden.
Der Wertebereich geht von
0:0:0.0 bis 23:59:59.999
TimeReal TR Word 0.01 bis 9990.0 REAL VT_R4 Mit dem Suffix TR werden
die in der SPS
gespeicherten Daten als
Datentyp TIME REAL
dargestellt.
Der Wertebereich geht von
0.01 bis 9990.0 (s)
Swap SWA String Tauscht High Byte STRING VT_BSTR Es werden High Byte und
Bytes P und Low Byte Low Byte der in der SPS
gespeicherten Strings
getauscht. Wichtig bei
Modbus SPSen.
* ms können weggelassen werden.
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.de30 Tani Item Syntax
1.13 Item Syntax für symbolische Steuerungen
Moderne Steuerungen benötigen keine Itemsyntax. Alle Symbole sind in den Steuerungen vorhanden
und werden online ausgelesen. Dies betrifft alle Rockwell ControlLogix und CompactLogix Steuerungen,
die Siemens S7-1500 und S7-1200 Modelle und BACnet Geräte.
Ein Tag ist durch seinen Namen komplett definiert, der Datentyp wird durch die Steuerung vorgegeben.
Im Normalfall muss nichts hinzugefügt werden.
Es gibt jedoch einige Ausnahmen:
Adressierung eines einzelnen Elements aus einem Array:
der null basierte Index wird in eckigen Klammern hinter dem Tagnamen angegeben.
[]
Falls Sie trotzdem Offline-Symbole anlegen wollen so können Sie das tun. Dies kann notwendig werden:
um ohne Zugriff auf die Steuerung Symbole zu haben,
um Symbole umzubenennen,
oder für Simulatorverbindungen.
Dazu geben Sie als "Itemsyntax" den realen Symbolnamen in der Steuerung an.
Da ein Symbol ohne Zugriff auf die Steuerung keinen Datentyp liefert können Sie am Ende des Symbols
einen Datentypen angeben.
Die Regel dazu:
{{}}
oder für Arrays:
{{,}}
Die {{ und }} am Ende markieren die Zusatzinformationen.
Diese Datentypen sind möglich (Groß-/Kleinschreibung ist wichtig, ebenso die Leerzeichen in der Mitte):
Bool
Int 8
Int 16
Int 32
Int 64
Uint 8
Uint 16
Uint 32
Uint 64
Float
Double
Timestamp
String
Der Symbolname (ohne {{ }} )muss natürlich in der Steuerung vorhanden sein (außer bei reinen
Simulatorverbindungen).
© 2019 Tani GmbH, Freiligrathstraße 12, 90482 Nürnberg, Telefon: +49 911 98037354, Internet: https://tanindustrie.de, Email: info@tanindustrie.deSie können auch lesen
