Inhaltsverzeichnis
Werbung
6.
LSTEP
Anhang
LSTEP_API
6.2 DLL-Schnittstelle
6.2.1 LSTEP-API
Hauptbestandteil des LSTEP-APIs ist die Datei LSTEP4.DLL. Diese DLL verwenden Sie bei
der Entwicklung eigener Programme, um eine LSTEP zu konfigurieren, Befehle zu senden,
Positionswerte,
Ein-/Ausgänge
abzufragen
etc.
Bitte
verwenden
Sie
für
Neuentwicklungen nur noch die LStep4XDLL.
6.2.2 LSTEP4X-API
Hauptbestandteil des LStep4X-APIs ist die Datei LSTEP4X.DLL. Diese DLL verwenden Sie
bei der Entwicklung eigener Programme, um eine oder mehrere LSTEPs zu konfigurieren,
Befehle zu senden, Positionswerte, Ein-/Ausgänge abzufragen etc.
6.2.3 Allgemeine Hinweise
6.2.3.1 LSTEP4.DLL
Die DLL LSTEP4.DLL implementiert die Befehle des LSTEP-API. Alle Funktionen sind mit
einem 32-Bit Integer als Rückgabewert deklariert. Eine 0 als Rückgabewert zeigt die
fehlerfreie Ausführung der Funktion an, bei Fehlern (z. B. Timeouts) wird der
entsprechende Fehlercode (siehe Tabelle) zurückgeliefert.
Bei Funktionen wie LS_MoveAbs werden immer die Werte für 4 Achsen übergeben.
Handelt es sich um eine Steuerung mit 1-3 Achsen, werden die Werte für die nicht
vorhandenen Achsen ignoriert, sie können auf 0 gesetzt werden.
6.2.3.2 LSTEP4X.DLL
Die DLL LSTEP4X.DLL implementiert die Befehle des LSTEP4X-API. Alle Funktionen sind
mit einem 32-Bit Integer als Rückgabewert deklariert. Eine 0 als Rückgabewert zeigt die
fehlerfreie Ausführung der Funktion an, bei Fehlern (z. B. Timeouts) wird der
entsprechende Fehlercode (siehe Tabelle) zurückgeliefert.
Als erster Parameter wird bei sämtlichen Funktionen des API ein 32-bit Integer-Wert
übergeben (zwischen 1 und 32), welcher die Nummer der LStep angibt, an die der Befehl
gesendet werden soll.
Die Funktion LSX_CreateLSID kann verwendet werden, um einen solchen ID-Wert zu
erzeugen. Mit einem Aufruf von LSX_FreeLSID wird ein ID-Wert wieder freigegeben. (siehe
Delphi-Beispiel)
Bei Funktionen wie LSX_MoveAbs werden immer die Werte für 4 Achsen übergeben.
Handelt es sich um eine Steuerung mit 1-3 Achsen, werden die Werte für die nicht
vorhandenen Achsen ignoriert, sie können auf 0 gesetzt werden.
6.2.3.3 Unterschiede im Vergleich zur LSTEP4.DLL
Am Funktionsumfang hat sich bei der LSTEP4X.DLL im Vergleich zur LSTEP4.DLL nichts
geändert, die Funktionsnamen sind identisch. Das normale LStep API (LSTEP4.DLL) wird
weitergeführt, bestehender Quellcode, welcher das LStep API nutzt muss also nicht
modifiziert werden.
6 2
D31105-0400-0de
Werbung
Inhaltsverzeichnis
