Tool für die Einbindung von Advance-Optima-Signalen in Windows-Applikationen (Version 1.3)

Transkript

1 Advance Operation Optima ActiveX Tool für die Einbindung von Advance-Optima-Signalen in Windows-Applikationen (Version 1.3) Technische Information 30/ DE

2 Inhaltsverzeichnis Einleitung 3 Seite Grundsätzliche Vorgehensweise bei der Programmierung 4 AOMeasure Messwerte 5 Eigenschaften 5 Funktionsübersicht 5 Events 11 AOIO Hardware IO 12 Eigenschaften 12 Funktionsübersicht 12 Events 18 AOBusIO Bus IO 19 Eigenschaften 19 Funktionsübersicht 19 Events 23 2 Technische Information Optima ActiveX 30/ DE

3 Einleitung Optima ActiveX ist ein effektives Programmiertool für die einfache Einbindung von Advance Optima Signalen in Windows Applikationen wie z.b. Microsoft Excel 97, Visual C++ oder Visual Basic. Optima ActiveX enthält ActiveX Controls. Aufrufbar über die Werkzeugbox stehen vorbereitete Funktionen, wie z.b. für die Visualisierung von Messdaten zur Verfügung. Unter anderem können folgende Daten aus Advance Optima gelesen werden: Messwerte Statussignale wie Ausfall, Wartungsbedarf, Funktionskontrolle Werte der Analogein- und -ausgänge Status der Digitalein- und -ausgänge Hilfsgrößen wie Detektortemperatur oder Durchfluss Driftwerte für Null- und Endpunkt Statusinformation von Peripheriekomponenten Neben dem reinen Lesezugriff können über die ActiveX Controls auch Steuereingänge (sogenannte BusIO) in Advance Optima angesteuert werden. In Verbindung mit einer Funktionsblock-Konfigurierung können damit über die Ethernet-Schnittstelle eine ganze Reihe von Funktionen realisiert werden, z.b.: Start einer Autokalibrierung Umschalten von Messbereichen Unter Verwendung von ActiveX unterstützender Software wie z.b. Visual C++ Visual Basic Excel 97 lassen sich somit die Gerätedaten auf einfache Weise in eigenen Applikationen integrieren. Optima ActiveX enthält folgende Dateien: AOActiveDemo Eine in Visual C++ erstellte Anwendung zur Demonstration einiger AOMeasure Funktionen in C++. Die entsprechenden Quellcodes sind im Unterverzeichnis /Optima ActiveX/VisualC zu finden. AOMeasureDemo, AOIODemo Unter Visual Basic erstellte Anwendungen zur Demonstration einiger AOMeasure bzw. AOIO Funktionen in Basic. Die entsprechenden Quellcodes sind im Unterverzeichnis /Optima ActiveX/VisualBasic zu finden. AOComponents Komponenten Eigentliche ActiveX Controls. Folgende ActiveX Komponenten sind in AOComponents enthalten: AOMeasure Messwerte AOIO Werte von Hardware I/Os AOBusIO Werte von Bus I/Os Benötigte Dateien: AOCOMPONENTS.OCX CAPIWIAO.DLL MFC42.DLL MSVCRT.DLL OLEAUT32.DLL OLEPRO32.DLL 30/ DE Technische Information Optima ActiveX 3

4 Grundsätzliche Vorgehensweise bei der Programmierung Die gewünschte ActiveX Komponente im Dialog oder Form einfügen. Die benötigten Parameter in den Komponenteneigenschaften eintragen. Innerhalb der Initialisierungsfunktion des Dialogs die Komponentenfunktion Connect mit dem Parameter TRUE aufrufen. Vor dem Auslesen der Gerätedaten sicherstellen, dass IsConnected und IsDataValid TRUE zurückliefern. Auslesen der Geräteeigenschaften (z.b. GetModuleCount ) Auslesen der Messwerte 4 Technische Information Optima ActiveX 30/ DE

5 AOMeasure Messwerte Eigenschaften ServerName IP-Adresse des Gerätes (default: ) SystemName ErrorCheckRate UpdateRate Benutzerdefinierter Name der ActiveX Komponente (default: leer) Zeitraster für Fehlerprüfungen (default: 5000 ms, Bereich ms) Aktualisierungszeit für interne Datenaktualisierung (default: 5000 ms, Bereich ms) Funktionsübersicht void Connect (boolean bstatus) Startet oder beendet die Kommunikation mit dem Gerät. bstatus: TRUE = Kommunikation starten FALSE = Kommunikation beenden double GetMainMeasVal (long nmoduleidx, long ncompidx) Liefert den Messwert einer Hauptgröße als Fließkommawert zurück. double GetAuxMeasVal (long nmoduleidx, long ncompidx) Liefert den Messwert einer Hilfsgröße als Fließkommawert zurück. Index der Hilfskomponente innerhalb des Analysators long GetMainCompCount (long nmoduleidx) Liefert die Anzahl von Hauptgrößen innerhalb eines Analysators zurück. 30/ DE Technische Information Optima ActiveX 5

6 long GetAuxCompCount (long nmoduleidx) Liefert die Anzahl von Hilfsgrößen innerhalb eines Analysators zurück. long GetModuleCount () Liefert die Anzahl der Analysator-Module des Systems zurück. BSTR GetMainCompName (long nmoduleidx, long ncompidx) Liefert den Namen einer Hauptgröße zurück. BSTR GetAuxCompName (long nmoduleidx, long ncompidx) Liefert den Namen einer Hilfsgröße zurück. Index der Hilfskomponente innerhalb des Analysators BSTR GetMainUnitName (long nmoduleidx, long ncompidx) Liefert die Einheit einer Hauptgröße zurück. BSTR GetAuxUnitName (long nmoduleidx, long ncompidx) Liefert die Einheit einer Hilfsgröße zurück. Index der Hilfskomponente innerhalb des Analysators long GetMainStatus (long nmoduleidx, long ncompidx) Liefert den Status einer Hauptgröße zurück. 0 = kein Fehler > 0 = Fehler 6 Technische Information Optima ActiveX 30/ DE

7 long GetAuxStatus (long nmoduleidx, long ncompidx) Liefert den Status einer Hilfsgröße zurück. 0 = kein Fehler > 0 = Fehler Index der Hilfskomponente innerhalb des Analysators long GetMainMeasureRangeCount (long nmoduleidx, long ncompidx) Liefert die Messbereichsanzahl einer Hauptgröße zurück. long GetAuxMeasureRangeCount (long nmoduleidx, long ncompidx) Liefert die Messbereichsanzahl einer Hilfsgröße zurück. Index der Hilfskomponente innerhalb des Analysators double GetMainOffsetDrift (long nmoduleidx, long ncompidx, long nmeasureidx) Liefert OffsetDrift einer Hauptgröße zurück. nmeasureidx: Index des Messbereichs innerhalb der Komponente double GetAuxOffsetDrift (long nmoduleidx, long ncompidx, long nmeasureidx) nicht benutzt double GetMainAmplDrift (long nmoduleidx, long ncompidx, long nmeasureidx) Liefert AmplDrift einer Hauptgröße zurück. nmeasureidx: Index des Messbereichs innerhalb der Komponente 30/ DE Technische Information Optima ActiveX 7

8 double GetAuxAmplDrift (long nmoduleidx, long ncompidx, long nmeasureidx) nicht benutzt double GetMainDeltaOffsetDrift (long nmoduleidx, long ncompidx, long nmeasureidx) Liefert DeltaOffsetDrift einer Hauptgröße zurück. nmeasureidx: Index des Messbereichs innerhalb der Komponente double GetAuxDeltaOffsetDrift (long nmoduleidx, long ncompidx, long nmeasureidx) nicht benutzt double GetMainDeltaAmplDrift (long nmoduleidx, long ncompidx, long nmeasureidx) Liefert DeltaAmplDrift einer Hauptgröße zurück. nmeasureidx: Index des Messbereichs innerhalb der Komponente double GetAuxDeltaAmplDrift (long nmoduleidx, long ncompidx, long nmeasureidx) nicht benutzt double GetMainDeltaOffset (long nmoduleidx, long ncompidx) Liefert DeltaOffset einer Hauptgröße zurück. double GetAuxDeltaOffset (long nmoduleidx, long ncompidx) nicht benutzt 8 Technische Information Optima ActiveX 30/ DE

9 double GetMainDeltaAmpl (long nmoduleidx, long ncompidx) Liefert DeltaAmpl einer Hauptgröße zurück. double GetAuxDeltaAmpl (long nmoduleidx, long ncompidx) nicht benutzt double GetMainOffsetOver (long nmoduleidx, long ncompidx) Liefert OffsetOver einer Hauptgröße zurück. double GetAuxOffsetOver (long nmoduleidx, long ncompidx) nicht benutzt double GetMainAmplOver (long nmoduleidx, long ncompidx) Liefert AmplOver einer Hauptgröße zurück. double GetAuxAmplOver (long nmoduleidx, long ncompidx) nicht benutzt BSTR GetModuleName (long nmoduleidx) Liefert den Namen eines Analysatormoduls zurück. BSTR GetUsertext (long nmoduleidx) Liefert den Benutzertext eines Analysatormoduls zurück. 30/ DE Technische Information Optima ActiveX 9

10 BSTR GetSerialNo (long nmoduleidx) Liefert die Seriennummer eines Analysatormoduls zurück. BSTR GetSoftwareVersion () Liefert die Softwareversion des Syscon boolean IsConnected () Liefert den Verbindungsstatus zurück. TRUE = Verbindung korrekt FALSE = Verbindung unterbrochen boolean IsDataValid () Liefert den Status der Daten zurück. TRUE = Daten korrekt eingelesen FALSE = Daten (noch) nicht gültig long GetNoErrors () Liefert die Anzahl Fehler zurück. 0 = keine Fehler > 0 = Fehler long GetNoMaintReq () Liefert die Anzahl Wartungsbedarf zurück. 0 = keine Fehler > 0 = Fehler long GetNoMaintMode () Liefert die Anzahl Funktionskontrolle zurück. 0 = keine Fehler > 0 = Fehler 10 Technische Information Optima ActiveX 30/ DE

11 Events Connection (boolean bconnected) Meldet dem Client die Änderung des Verbindungsstatus. bconnected: TRUE = Verbindung korrekt FALSE = Verbindung unterbrochen NoErrors (long nstatus) Meldet dem Client die Änderung von Anzahl Fehler. nstatus: 0 = kein Fehler > 0 = Fehler NoMaintReq (long nstatus) Meldet dem Client die Änderung von Anzahl Wartungsbedarf. nstatus: 0 = kein Wartungsbedarf > 0 = Wartungsbedarf NoMaintMode (long nstatus) Meldet dem Client die Änderung von Anzahl Funktionskontrolle. nstatus: 0 = keine Funktionskontrolle > 0 = Funktionskontrolle 30/ DE Technische Information Optima ActiveX 11

12 AOIO Hardware IO Eigenschaften ServerName IP-Adresse des Gerätes (default: ) SystemName ErrorCheckRate UpdateRateAI UpdateRateAO Benutzerdefinierter Name der ActiveX Komponente (default: leer) Zeitraster für Fehlerprüfungen (default: 5000 ms, Bereich ms) Aktualisierungszeit für interne Datenaktualisierung der analogen Eingänge (default: 5000 ms, Bereich ms) Aktualisierungszeit für interne Datenaktualisierung der analogen Ausgänge (default: 5000 ms, Bereich ms) Funktionsübersicht Index 0 entspricht System-Controller, Index 1 entspricht 1. I/O-Karte usw. void Connect (boolean bstatus) Startet oder beendet die Kommunikation mit dem Gerät. bstatus: TRUE = Kommunikation starten FALSE = Kommunikation beenden long GetIOCardCount () Liefert die Anzahl der vorhandenen IO-Karten zurück. BSTR GetUsertext (long niocardidx) Liefert den Benutzertext einer IO-Karte zurück. BSTR GetIODevicename (long niocardidx) Liefert den Namen einer IO-Karte zurück. 12 Technische Information Optima ActiveX 30/ DE

13 BSTR GetSerialNo (long niocardidx) Liefert die Seriennummer einer IO-Karte zurück. BSTR GetSoftwareVersion () Liefert die Softwareversion des Syscon long GetSlotNo (long niocardidx) Liefert die Slotnummer einer IO-Karte zurück. long GetDIHardwareLink (long niocardidx, long ndiidx) Liefert den Hardwarelink eines Digitaleingangs zurück. ndiidx: Index des Digitaleingangs auf der Karte. long GetDOHardwareLink (long niocardidx, long ndoidx) Liefert den Hardwarelink eines Digitalausgangs zurück. ndoidx: Index des Digitalausgangs auf der Karte. long GetAIHardwareLink (long niocardidx, long naiidx) Liefert den Hardwarelink eines Analogeingangs zurück. naiidx: Index des Analogeingangs auf der Karte. long GetAOHardwareLink (long niocardidx, long naoidx) Liefert den Hardwarelink eines Analogausgangs zurück. naoidx: Index des Analogausgangs auf der Karte. 30/ DE Technische Information Optima ActiveX 13

14 long GetDIVal (long niocardidx, long ndiidx) Liefert den Wert eines Digitaleingangs zurück. ndiidx: Index des Digitaleingangs auf der Karte. long GetDOVal (long niocardidx, long ndoidx) Liefert den Wert eines Digitalausgangs zurück. ndoidx: Index des Digitalausgangs auf der Karte. double GetAIVal (long niocardidx, long naiidx); Liefert den Wert eines Analogeingangs zurück. naiidx: Index des Analogeingangs auf der Karte. double GetAOVal (long niocardidx, long naoidx) Liefert den Wert eines Analogausgangs zurück. naoidx: Index des Analogausgangs auf der Karte. long GetDIStatus (long niocardidx, long ndiidx) Liefert den Status eines Digitaleingangs zurück. ndiidx: Index des Digitaleingangs auf der Karte. long GetDOStatus (long niocardidx, long ndoidx) Liefert den Status eines Digitalausgangs zurück. ndoidx: Index des Digitalausgangs auf der Karte. 14 Technische Information Optima ActiveX 30/ DE

15 long GetAIStatus (long niocardidx, long naiidx) Liefert den Status eines Analogeingangs zurück. naiidx: Index des Analogeingangs auf der Karte. long GetAOStatus (long niocardidx, long naoidx) Liefert den Status eines Analogausgangs zurück. naoidx: Index des Analogausgangs auf der Karte. BSTR GetDIName (long niocardidx, long ndiidx) Liefert den Namen eines Digitaleingangs zurück. ndiidx: Index des Digitaleingangs auf der Karte. BSTR GetDOName (long niocardidx, long ndoidx) Liefert den Namen eines Digitalausgangs zurück. ndoidx: Index des Digitalausgangs auf der Karte. BSTR GetAIName (long niocardidx, long naiidx) Liefert den Namen eines Analogeingangs zurück. naiidx: Index des Analogeingangs auf der Karte. BSTR GetAOName (long niocardidx, long naoidx) Liefert den Namen eines Analogausgangs zurück. naoidx: Index des Analogausgangs auf der Karte. 30/ DE Technische Information Optima ActiveX 15

16 BSTR GetAIUnit (long niocardidx, long naiidx) Liefert die Einheit eines Analogeingangs zurück. naiidx: Index des Analogeingangs auf der Karte. BSTR GetAOUnit (long niocardidx, long naoidx) Liefert die Einheit eines Analogausgangs zurück. naoidx: Index des Analogausgangs auf der Karte. long GetDIInvert (long niocardidx, long ndiidx) Liefert den Invert-Wert eines Digitaleingangs zurück. ndiidx: Index des Digitaleingangs auf der Karte. long GetDOInvert (long niocardidx, long ndoidx) Liefert den Invert-Wert eines Digitalausgangs zurück. ndoidx: Index des Digitalausgangs auf der Karte. double GetAIRangeLow (long niocardidx, long naiidx) Liefert den RangeLow eines Analogeingangs zurück. naiidx: Index des Analogeingangs auf der Karte. double GetAORangeLow (long niocardidx, long naoidx) Liefert den RangeLow eines Analogausgangs zurück. naoidx: Index des Analogausgangs auf der Karte. 16 Technische Information Optima ActiveX 30/ DE

17 double GetAIRangeHigh (long niocardidx, long naiidx) Liefert den RangeHigh eines Analogeingangs zurück. naiidx: Index des Analogeingangs auf der Karte. double GetAORangeHigh (long niocardidx, long naoidx) Liefert den RangeHigh eines Analogausgangs zurück. naoidx: Index des Analogausgangs auf der Karte. long GetDICount (long niocardidx) Liefert die Anzahl von digitalen Eingängen auf einer IO-Karte zurück. long GetDOCount (long niocardidx) Liefert die Anzahl von digitalen Ausgängen auf einer IO-Karte zurück. long GetAICount (long niocardidx) Liefert die Anzahl von analogen Eingängen auf einer IO-Karte zurück. long GetAOCount (long niocardidx) Liefert die Anzahl von analogen Ausgängen auf einer IO-Karte zurück. 30/ DE Technische Information Optima ActiveX 17

18 boolean IsConnected () Liefert den Verbindungsstatus zurück. TRUE = Verbindung korrekt FALSE = Verbindung unterbrochen boolean IsDataValid () Liefert den Status der Daten zurück. TRUE = Daten korrekt eingelesen FALSE = Daten (noch) nicht gültig Events Connection (boolean bconnected) Meldet dem Client die Änderung des Verbindungsstatus. bconnected: TRUE = Verbindung korrekt FALSE = Verbindung unterbrochen 18 Technische Information Optima ActiveX 30/ DE

19 AOBusIO Bus IO Eigenschaften ServerName IP-Adresse des Gerätes (default: ) SystemName ErrorCheckRate Benutzerdefinierter Name der ActiveX Komponente (default: leer) Zeitraster für Fehlerprüfungen (default: 5000 ms, Bereich ms) Funktionsübersicht void Connect (boolean bstatus) Startet oder beendet die Kommunikation mit dem Gerät. bstatus: TRUE = Kommunikation starten FALSE = Kommunikation beenden long GetIOModuleCount () Liefert die Anzahl vorhandener Module im System zurück (z.z. immer 1). long GetDICount (long nmoduleno) Liefert die Anzahl vorhandener digitaler Eingänge auf angegebenem Modul zurück long GetDOCount (long nmoduleno) Liefert die Anzahl vorhandener digitaler Ausgänge auf angegebenem Modul zurück. long GetDIVal (long nmoduleno, long ndiidx) Liefert den Wert eines Digitaleingangs zurück. ndiidx: Index des Digitaleingangs 30/ DE Technische Information Optima ActiveX 19

20 long GetDOVal (long nmoduleno, long ndoidx) Liefert den Wert eines Digitalausgangs zurück. ndoidx: Index des Digitalausgangs long GetDIStatus (long nmoduleno, long ndiidx) Liefert den Status eines Digitaleingangs zurück. ndiidx: Index des Digitaleingangs long GetDOStatus (long nmoduleno, long ndoidx) Liefert den Status eines Digitalausgangs zurück. ndoidx: Index des Digitalausgangs long GetDIInvert (long nmoduleno, long ndiidx) Liefert den Invert-Wert eines Digitaleingangs zurück. ndiidx: Index des Digitaleingangs long GetDOInvert (long nmoduleno, long ndoidx) Liefert den Invert-Wert eines Digitalausgangs zurück. ndoidx: Index des Digitalausgangs BSTR GetDIName (long nmoduleno, long ndiidx) Liefert den Namen eines Digitaleingangs zurück. ndiidx: Index des Digitaleingangs 20 Technische Information Optima ActiveX 30/ DE

21 BSTR GetDOName(long nmoduleno, long ndoidx) Liefert den Namen eines Digitalausgangs zurück. ndoidx: Index des Digitalausgangs BSTR GetSoftwareVersion () Liefert die Softwareversion des Syscon void SetDIVal (long nmoduleno, long ndiidx, long nvalue) Setzt den Wert eines Digitaleingangs. ndiidx: Index des Digitaleingangs nvalue: Neuer Wert (0 oder 1) boolean IsConnected () Liefert den Verbindungsstatus zurück. TRUE = Verbindung korrekt FALSE = Verbindung unterbrochen boolean IsDataValid () Liefert den Status der Daten zurück. TRUE = Daten korrekt eingelesen FALSE = Daten (noch) nicht gültig boolean SetDIValue (long nmoduleno, long ndiidx, long nvalue) ndiidx: nvalue: Index des Digitaleingangs Zu setzender Wert Liefert TRUE bei Erfolg zurück, sonst FALSE. 30/ DE Technische Information Optima ActiveX 21

22 BOOL CAOModbusIOCtrl::GetAICount(long nmoduleno) Liefert die Anzahl vorhandener analoger Eingänge auf angegebenem Modul zurück. BOOL CAOModbusIOCtrl::GetAOCount(long nmoduleno) Liefert die Anzahl vorhandener analoger Ausgänge auf angegebenem Modul zurück. double CAOModbusIOCtrl::GetAIVal(long nmoduleno, long naiidx) naiidx: Index des analogen Eingangs Liefert den Wert eines Analogeingangs zurück. double CAOModbusIOCtrl::GetAOVal(long nmoduleno, long naoidx) naoidx: Index des analogen Ausgangs Liefert den Wert eines Analogausgangs zurück. long CAOModbusIOCtrl::GetAIStatus(long nmoduleno, long naiidx) naiidx: Index des analogen Eingangs Liefert den Status eines Analogeingangs zurück. long CAOModbusIOCtrl::GetAOStatus(long nmoduleno, long naoidx) naoidx: Index des analogen Ausgangs Liefert den Status eines Analogausgangs zurück. 22 Technische Information Optima ActiveX 30/ DE

23 BSTR CAOModbusIOCtrl::GetAIName(long nmoduleno, long naiidx) naiidx: Index des analogen Eingangs Liefert den Namen eines Analogeingangs zurück. BSTR CAOModbusIOCtrl::GetAOName(long nmoduleno, long naoidx) naoidx: Index des analogen Ausgangs Liefert den Namen eines Analogausgangs zurück. BOOL CAOModbusIOCtrl::SetAIValue (long nmoduleno, long naoidx, double nvalue) naoidx: nvalue: Index des analogen Ausgangs Zu setzender Wert Liefert TRUE bei Erfolg zurück, sonst FALSE. Events Connection (boolean bconnected) Meldet dem Client die Änderung des Verbindungsstatus. bconnected: TRUE = Verbindung korrekt FALSE = Verbindung unterbrochen SetDIFailed Dieser Event wird gesendet, falls das Setzen eines Digitaleingangs mit der Funktion SetDIVal fehlschlägt. 30/ DE Technische Information Optima ActiveX 23

24 Technische Änderungen vorbehalten Printed in the Fed. Rep. of Germany 30/ DE 12.00