![]() |
Dokumentation zur DFComDLL.dll / DFCom_x64.dll
04.03.05.00
|
Deklarationen für die Funktionen der Geräteverbindungen und deren direktem Zugriff. Mehr ...
#include "df_defines.h"
gehe zum Quellcode dieser Datei
Funktionen | |
DF_API_EXTERN int DF_API_CALL | DFCComInit (int connectionId) |
Öffnet eine serielle Schnittstelle für die Kommunikation mit einem AEIII+ über RS232/RS485. Mehr ... | |
DF_API_EXTERN int DF_API_CALL | DFCComOpenSerial (int connectionId, char *commPort, int baudRate, int timeout) |
Oeffnet die serielle Schnittstelle fuer RS232 / RS485 Direktkommunikation. Mehr ... | |
DF_API_EXTERN int DF_API_CALL | DFCComOpen (int connectionId, char *hostAddress) |
Oeffnet die TCP/IP Schnittstelle. Mehr ... | |
DF_API_EXTERN int DF_API_CALL | DFCComOpenSocket (int connectionId, char *hostAddress, int portNumber, int timeout) |
Oeffnet die TCP/IP Schnittstelle. Mehr ... | |
DF_API_EXTERN int DF_API_CALL | DFCComOpenIV (int connectionId, int deviceAddress, int connectionType, char *connectionString, int connectionValue, int connectionTimeout) |
Oeffnet die Schnittstelle fuer die Kommunikation mit PZE Master IV. Mehr ... | |
DF_API_EXTERN void DF_API_CALL | DFCComClose (int connectionId) |
Schliessen des geoeffneten Kanals. Mehr ... | |
DF_API_EXTERN int DF_API_CALL | DFCIsChannelOpen (int connectionId) |
Prueft ob die Schnittstelle bereits Initialisiert oder auch geoeffnet wurde. Mehr ... | |
DF_API_EXTERN int DF_API_CALL | DFCWrite (int connectionId, char *buffer, int toWrite, int *written, int *errorNumber) |
Schreibt Zeichen in den Kanal. Mehr ... | |
DF_API_EXTERN int DF_API_CALL | DFCRead (int connectionId, char *buffer, int toRead, int *read, int *errorNumber) |
Liest Zeichen vom Kanal. Mehr ... | |
Deklarationen für die Funktionen der Geräteverbindungen und deren direktem Zugriff.
DF_API_EXTERN void DF_API_CALL DFCComClose | ( | int | connectionId | ) |
Schliessen des geoeffneten Kanals.
Je nach dem Typ des Kanals wird entweder die serielle Schnittstelle oder der Socket geschlossen.
connectionId | Kommunikationskanalnummer. |
DF_API_EXTERN int DF_API_CALL DFCComInit | ( | int | connectionId | ) |
Öffnet eine serielle Schnittstelle für die Kommunikation mit einem AEIII+ über RS232/RS485.
Die Funktion ruft intern die Funktion DFCComOpenSerial() mit den Standardparametern baudRate = 38400 und timeout = 800 auf.
[in] | connectionId | Zu verwendende Verbindungs-Id. Diese wird für weitere Funktionsaufrufe zur Kommunikation benötigt. Bereich [1 - 400]. |
1 | Serielle Schnittstelle erfolgreich geöffnet. |
0 | Fehler bei öffnen der seriellen Schnittstelle. |
DF_API_EXTERN int DF_API_CALL DFCComOpen | ( | int | connectionId, |
char * | hostAddress | ||
) |
Oeffnet die TCP/IP Schnittstelle.
Die Funktion ruft intern die Funktion DFCComOpenSocket() mit den Standardparametern iPortNum = 8000 und iTimeOut = 3000 auf.
connectionId | Kommunikationskanalnummer. |
hostAddress | Zeiger auf String mit Hostnamen oder IP - Adresse in Punktnotation. |
1 | Schnittstelle erfolgreich geoeffnet. |
0 | Fehler bei Initialisierung. |
DF_API_EXTERN int DF_API_CALL DFCComOpenIV | ( | int | connectionId, |
int | deviceAddress, | ||
int | connectionType, | ||
char * | connectionString, | ||
int | connectionValue, | ||
int | connectionTimeout | ||
) |
Oeffnet die Schnittstelle fuer die Kommunikation mit PZE Master IV.
Initialisiert den Kanal. Je nach angegebenem Typ wird ein anderes Initialisierungsverfahren verwendet um die entsprechend nachfolgenden Funktionsaufrufe der exportierten Funktionen richtig umzusetzen.
connectionId | Kommunikationskanalnummer. |
deviceAddress | Die von der DLL zu verwendende Busnummer. (Multimasteransatz) |
connectionType | Der zu verwendende Schnittstellentyp. 1 -> RS232 direkt oder über Umsetzter (RS232 <-> RS485) 2 -> Funk über den Umsetzer (RS232 <-> BIM2) ohne eigenen Kontroller. 3 -> TCP / IP - Verbindung. |
connectionString | Je nach Schnittstellentyp: 1,2 -> Zeiger auf Zeichenkette für die Schnittstelle. "COM1" .. "COM4". 3 -> Zeiger auf Zeichenkette mit IP - Adresse oder Hostname. |
connectionValue | Je nach Schnittstellentyp: 1,2 -> Übertragungsrate der Schnittstelle. (Standard ist: 38400) 3 -> Portnummer des TCP / IP Anschlusses. |
connectionTimeout | Je nach Schnittstellentyp: 1,2 ->Timeout für Lesen von Schnittstelle (Standard ist: 150) 3 -> Timeout für Lesen von Socket (Standard ist: 3000) |
1 | Schnittstelle erfolgreich geoeffnet. |
0 | Fehler bei Initialisierung. |
DF_API_EXTERN int DF_API_CALL DFCComOpenSerial | ( | int | connectionId, |
char * | commPort, | ||
int | baudRate, | ||
int | timeout | ||
) |
Oeffnet die serielle Schnittstelle fuer RS232 / RS485 Direktkommunikation.
Es können zusätzliche Parameter verwendet werden. Die Baudrate ist standardmaessig auf 38400bd einzustellen und der Timeout liegt bei 150ms pro Lesevorgang.
[in] | connectionId | Kommunikationskanalnummer. |
[in] | commPort | Zeiger auf String mit Namen der Schnittstelle "COM1", "COM2" usw.. |
[in] | baudRate | Baudrate mit der die Schnittstelle verwendet wird, 38400bd ist Standard. |
[in] | timeout | Zu verwendender Timeout fuer Read - Befehl. (ReadFile) |
1 | Schnittstelle erfolgreich geoeffnet. |
0 | Fehler bei Initialisierung. |
DF_API_EXTERN int DF_API_CALL DFCComOpenSocket | ( | int | connectionId, |
char * | hostAddress, | ||
int | portNumber, | ||
int | timeout | ||
) |
Oeffnet die TCP/IP Schnittstelle.
Es koennen zusaetzliche Parameter verwendet werden. Die Portnummer ist standardmaessig auf 8000 einzustellen und der Timeout (ein intern verwalteter) liegt bei 3000 pro Lesevorgang.
connectionId | Kommunikationskanalnummer. |
hostAddress | Zeiger auf String mit Hostnamen oder IP - Adresse in Punktnotation. |
portNumber | Portnummer |
timeout | Zu verwendender Timeout bei Lesevorgang. (keine ms - Einheit) |
1 | Schnittstelle erfolgreich geoeffnet. |
0 | Fehler bei Initialisierung. |
DF_API_EXTERN int DF_API_CALL DFCIsChannelOpen | ( | int | connectionId | ) |
Prueft ob die Schnittstelle bereits Initialisiert oder auch geoeffnet wurde.
connectionId | Kommunikationskanalnummer. |
-1 | Kanalobjekt noch nicht verfügbar, Schnittstelle nicht initialisiert oder geoeffnet. |
0 | Schnittstelle nicht geoeffnet. |
1 | Schnittstelle geoeffnet. |
DF_API_EXTERN int DF_API_CALL DFCRead | ( | int | connectionId, |
char * | buffer, | ||
int | toRead, | ||
int * | read, | ||
int * | errorNumber | ||
) |
Liest Zeichen vom Kanal.
Lesen von Daten aus dem Kanal.
connectionId | Kommunikationskanalnummer. |
buffer | Zeiger auf Daten. |
toRead | Laenge der zu lesenden Daten. |
read | Anzahl der gelesenen Daten. |
errorNumber | Zeiger auf Variable die nach Fehler den Fehlercode erhaelt. |
0 | Funktion konnte nicht ausgefuehrt werden. |
1 | Funktion wurde erfolgreich ausgefuehrt. |
DF_API_EXTERN int DF_API_CALL DFCWrite | ( | int | connectionId, |
char * | buffer, | ||
int | toWrite, | ||
int * | written, | ||
int * | errorNumber | ||
) |
Schreibt Zeichen in den Kanal.
Schreiben von Daten in den Kanal.
connectionId | Kommunikationskanalnummer. |
buffer | Zeiger auf Daten. |
toWrite | Laenge der zu schreiben Daten. |
written | Anzahl der geschriebenen Daten. |
errorNumber | Zeiger auf Variable die nach Fehler den Fehlercode erhaelt. |
0 | Funktion konnte nicht ausgefuehrt werden. |
1 | Funktion wurde erfolgreich ausgefuehrt. |