MscDll Referenzhandbuch > Opcodes und Parameter > Opcodes: Initialisierung > opcRMI: Lese Box-Informationen (digitales Typenschild)

Über diesen Opcode können Informationen über eine Irinos-Box abgerufen werden.

Übersicht

Opcode: 0x03

Name: opcRMI

Funktion: Lese Box-Informationen / digitales Typenschild
(Read module information)

Parameter-Typ: String

DLL-Funktion

Wird mit MSC_WriteCommand übertragen.

Anfragestring zum Irinos-System

#{Box-Nummer};{Wert 2}#

z.B. #0;2#

Box-Nummer

Nummer der Irinos-Box beginnend bei 0.

0 ist immer die Master-Box.

≥ 1 ist eine Slave-Box

Wenn die Box-Informationen aller Boxen abgefragt werden sollen, dann muss die Abfrage mit diesem Opcode für jede Irinos-Box einmal ausgeführt werden.

Wert 2

Hier muss immer der Wert 2 stehen. Fehlt dieser Teil des Parameterstrings, wird zur Kompatibilität mit älteren Systemen ein Antwortstring in einem veralteten Format zurückgesandt.

Antwortstring vom Irinos-System

#{Box-Nummer};{Geräte-Bezeichnung};{MAC-Adresse};{Serien-Nr.};{Fertigungs-Code};{Hardware-Version};{Hardware-Revision};{Firmware-Version};{Sample-Periode};{Gesamtanzahl Messkanäle};{Anzahl Messkanäle 64Bit};{Anzahl Messkanäle 32Bit};{Anzahl Messkanäle 16Bit};{Anzahl Messkanäle 8Bit};{immer 0};{immer 0};{immer 0};{immer 0};{immer 0};{Anzahl digitale Eingänge};{Anzahl digitale Ausgänge};{GUID};{Anwender-Bezeichnung};{Bestell-Nummer}#

Beispiel:
#0;0;IR-TFV-8-IET-M16-ETHIL;A0-BB-3E-E0-00-03;I123456;S-W3-28;HW V1.1;HWRev 1;SW V1.0.0.27;50;8;0;0;8;0;0;0;0;0;0;2;0;{0C003B23-2C74-49A0-BCB1-E81C7C32C42A};LBox 0;828-5006#

Box-Nummer (1)

z.B.: 0

Nummer der Box, von welcher die Box-Informationen abgefragt wurden. Stimmt mit dem Parameter Box-Nummer des Anfrage-Strings überein.

Geräte-Bezeichnung (2)

z.B. IR-TFV-8-IET-M16-ETHIL

Typ-Bezeichnung der Irinos-Box, wie sie auch auf dem Typenschild steht.

MAC-Adresse (3)

z.B. A0-BB-3E-E0-00-03

MAC-Adresse der Irinos-Box.

Jede Irinos-Box hat eine eindeutige MAC-Adresse. Diese wird bei der Produktion vergeben und steht auch auf dem Typenschild. Über die MAC-Adresse kann beispielsweise identifiziert werden, ob eine Irinos-Box gegen ein baugleiches Modell getauscht wurde.

Die MAC-Adresse ist sowohl bei Master- als auch bei Slave-Boxen vorhanden. Bei Master-Boxen wird sie auch als MAC-Adresse für die Ethernet-Schnittstelle verwendet.

Serien-Nr (4)

z.B. I123456

Von der Produktion vergebene Seriennummer der Irinos-Box. Sie steht auch auf dem Typenschild.

Wenn eine Irinos-Box zur Reparatur eingesandt wird, dann kann sich im Falle eines Hardware-Tauschs die MAC-Adresse ändern, die Seriennummer jedoch nicht.

Fertigungs-Code (5)

z.B. S-W3-28

Über den Fertigungscode können durch den Hersteller weitere Fertigungs-Informationen ermittelt werden.

Hardware-Version (6)

z.B. HW V1.1

Versionsstand der Elektronik.

Hardware-Revision (7)

z.B. HWRev 1

Kompatibilitäts-Code der Hardware zur Firmware. Dadurch wird sichergestellt, dass bei einem Firmware-Update nur die zulässige Firmware-Version auf die Irinos-Box geladen wird.

Firmware-Version (8)

z.B. SW V1.0.0.27

Versionsstand der Firmware.

Der erste Teil der Firmware-Version wird bei einer umfangreichen Änderung inkrementiert.

Der zweite Teil der Firmware-Version wird inkrementiert, wenn neue Funktionen hinzugekommen sind.

Der dritte Teil der Firmware-Version wird inkrementiert, wenn ein Fehler behoben wurde.

Der vierte Teil der Firmware-Version ist ein interner Zähler.

Sample-Periode (9)

z.B. 50

Abtast-Periode für die Messwert-Aufnahme in µs.

Die Abtast-Periode ist in jeder Irinos-Box immer konstant. Sie ist unabhängig von der Abtast-Periode der statischen oder dynamischen Messung.

Die Periode einer Zeit-gesteuerten dynamischen Messung muss immer ein Vielfaches der Abtast-Periode der beteiligten Irinos-Boxen sein. Mehr dazu siehe beim Opcode opcDT.

Gesamtanzahl Messkanäle (10)

z.B. 8

Gesamtanzahl aller Messkanäle der Irinos-Box.

Anzahl Messkanäle 64 Bit (11)

immer 0

Platzhalter für zukünftige Verwendung. 64 Bit – Messkanäle werden momentan nicht unterstützt.

Anzahl Messkanäle 32 Bit (12)

z.B. 0

Anzahl aller Messkanäle der Irinos-Box mit einem internen Wertebereich von 32 Bit. Dies sind beispielsweise Inkrementalgeber-Messkanäle.

Anzahl Messkanäle 16 Bit (13)

z.B. 8

Anzahl aller Messkanäle der Irinos-Box mit einem internen Wertebereich von 16 Bit. Dies sind beispielsweise Messeingänge für induktive Messtaster oder Analog-Eingänge ±10V.

16 Bit-Messwerte werden immer als 32 Bit-Werte zur DLL übertragen. Für die Applikation gibt es nur 32 Bit-Werte.

Anzahl Messkanäle 8 Bit (14)

z.B. 0

Anzahl aller Messkanäle der Irinos-Box mit einem internen Wertebereich von 8 Bit.

8 Bit-Messwerte werden immer als 32 Bit-Werte zur DLL übertragen. Für die Applikation gibt es nur 32 Bit-Werte.

Parameter 15 - 19

Immer 0. Platzhalter für zukünftige Verwendung.

Anzahl digitale Eingänge (20)

z.B. 2

Anzahl der digitalen Eingänge der Irinos-Box.

Zur DLL hin werden die digitalen Eingänge immer zu 8 Bits zusammengefasst. Wenn es weniger Eingänge gibt, dann wird aufgerundet.

Im Beispiel gibt es 2 digitale Eingänge. Zur DLL hin werden 8 digitale Eingänge übertragen. Die Eingänge 3-8 ändern Ihren Zustand nie.

Anzahl digitale Ausgänge (21)

z.B. 0

Anzahl der digitalen Ausgänge der Irinos-Box.

Vergleichbar zu den digitalen Eingängen wird immer auf 8 digitale Ausgänge aufgerundet.

D.h. hat eine Irinos-Box beispielsweise 4 digitale Ausgänge, so entstehen „virtuelle“ Ausgänge 5-8. Diese können zwar per DLL angesprochen werden, sie sind jedoch physikalisch nicht vorhanden.

GUID (22)

z.B. 0C003B23-2C74-49A0-BCB1-E81C7C32C42A

Platzhalter für zukünftige Verwendung.

Anwender-Bezeichnung (23)

z.B. LBox 0

Platzhalter für zukünftige Verwendung

Bestell-Nummer (24)

z.B. 828-5006

Bestellnummer der Irinos-Box.

Antwortstring vom Irinos-System im Fehlerfall

#-99# wenn der prinzipielle Aufbau des Anfragestrings fehlerhaft ist.

#-1# wenn die Box-Nummer des Anfragestrings ungültig ist.

Kompatibilität zu früheren Systemen

Zur Kompatibilität mit früheren Systemen wird der Anfragestring #{Box-Nummer}# unterstützt.

Der Antwort-String hat dann das Format:

#{Box-Typ};{Box-Nummer};{Anzahl Messkanäle};{Firmware-Version 1};{Firmware-Version 2};{Interne Nummer};{Textinfo}#

Die Verwendung bei Neu-Applikation ist nicht empfohlen.