Datafox DFCom - API 04.03.22
Dokumentation zur Datafox Kommunikationsbibliothek (DFComDLL.dll / DFCom_x64.dll)
Über die Kommunikationsbibliothek
Zu beachten
Entwickler und alle anderen Interessierten, die bereits mit der DFCom - API vertraut sind, werden ab der Dokumentationsversion 04.03.10 ggf. die Begriffe Kanalnummer und Busnummer vermissen.
  • Änderung des Begriffs Kanalnummer zu Verbindungsnummer.
    Fast alle Funktionen der DFCom-API verwenden als ersten Parameter eine Verbindungsnummer. Diese gibt an, über welche Verbindung die Funktion mit einem Gerät kommunizieren soll.
    Die Vergangenheit hat gezeigt, dass der Begriff Kanal für eine Verbindung immer wieder zu Missverständnissen geführt hat. Deswegen wurde entschieden, ab der API-Version 04.03.10 von einer Verbindung zu sprechen. Um bei der API in sich konsistent zu sein, wurde durchgängig bei den Funktionen der Parametername channelID in connectionId umbenannt.
  • Änderung des Begriffs Busnummer zu Geräteadresse.
    Auch die Geräteadresse wird bei fast allen Funktionen der DFCom-API als Parameter angegeben. Und zwar rührt sie aus Zeiten, als noch RS485 Busse die meisten Installationen beim Kunden bestimmten.
    Sie wird benötigt, um über eine Verbindung mit mehreren Geräten ein bestimmtes Gerät ansprechen zu können. Bei den Timeboy-Dockingstationen, die mehrere Einsteckplätze haben, kommt sie ebenfalls zum Einsatz, um anzugeben, auf welchen Einsteckplatz zugegriffen werden soll. Somit stellt die Geräteadresse zusammen mit der Verbindungsnummer einen eindeutigen Kommunikationsendpunkt dar.
    Auch bei der Busnummer hat die Vergangenheit gezeigt, dass immer wieder Missverständnisse aufgetreten sind. Auch hier wurde, um bei der API konsistent zu sein, durchgängig bei den Funktionen der Parametername deviceID in deviceAddress umbenannt.

Mit Hilfe der Kommunikationsbibliothek "DFComDLL, DFCom_x64" können die Datafox-Geräte konfiguriert werden. Erzeugte Datensätze können von den Geräten gelesen und Listendaten auf die Geräte geschrieben werden. All diese Aufgaben können über unterschiedliche Kommunikationswege wie RS232, USB, bzw. RS485 sowie LAN/WLAN geschehen.

Auch die Datafox Konfigurationssoftware DatafoxStudioIV verwendet für die unterschiedlichen Aufgaben und den Datenaustausch diese Kommunikationsbibliothek. Durch die Abwärtskompatibilität werden durch die Kommunikationsroutinen unter anderen, das AEIII+, die MasterIV-Serie und EVO-Line Geräte unterstützt. Somit unterstützen Sie durch den Einsatz der Kommunikationsbibliothek gleich eine ganze Menge an unterschiedlichster Hardware von Datafox.

Einbindungsmethoden zur Datenübertragung.

Datatafox Studio

Einstellung der Geräte für die jeweilige Aufgabe der Datenerfassung. Die Konfigurationssoftware DatafoxStudioIV stellt die Anwendung zur Einrichtung der Datafox-Geräte dar.

Kommunikationsbibliothek (Direkte DLL Anbindung)

Über die Kommunikationsbibliothek ist eine direkte Kommunikation zwischen der Anwendungssoftware und Gerät möglich. Dies ist damit die beste Art der Anbindung für Softwarehersteller (OEMs). Die Kommunikation über die Kommunikationsbibliothek ist bidirektional und kann sowohl online als auch offline erfolgen.

HTTP (Webserver)

Die Datafox-Geräte können Datensätze über das Http-Protokoll an einen ggf. Webserver senden. Über die Rückantwort können unterschiedliche zusätzliche Aktionen angestoßen werden, z. B. stellen der Uhrzeit oder anzeigen einer Nachricht auf der Geräteanzeige.

Auf der Produkt-DVD stellt Datafox Ihnen ein PHP-Muster-Script zur Datenentgegennahme und Quittierung bereit.

Datafox-Talk

Ein bereits entwickeltes Schnittstellenprogramm mit entsprechendem Funktionsumfang zum Datenaustausch über Dateien oder Datenbank. Diese Lösung ist ideal für Endkunden oder Händler, die Datafox-Produkte an z.B. Warenwirtschaft, ERP, ... anbinden wollen.


© 2003-2024 Datafox GmbH