RFC 1006 Lib

RFC 1006 Client- und Serverentwicklung leicht gemacht



Software Version 1.40

• Windows 10 / 8 / 7 / Vista / XP 32/64 Bit
• Linux x86 32/64 Bit
• Linux ARM / Embedded 32/64Bit

• C
• C++
• C#
• VB
• VB.net
• Delphi

Versionshistorie - Die Liste der Verbesserungen pro Version

• PC mit installiertem TCP/IP-Protokoll und Netzwerkkarte

Kopieren Sie die DLL-Datei in das Verzeichnis Ihres Programms. Um die Bibliothek systemweit zur Verfügung zu stellen, legen Sie sie im Systemverzeichnis %SystemRoot%\system32 ab.

Linken Sie die Object-Datei (.o) beim Linkeraufruf zu Ihrem Programm.

RFC1006-Lib ist eine DLL für MS-Windows, welche die Anbindung eines PC an Industrial Ethernet übre RFC-1006 ermöglicht.
Mit einfachen Funktionen kann der Anwender schnell mit C, C++, Delphi, Visual Basic oder auch Excel RFC 1006 Verbindungen aufbauen und Daten senden und Empfangen.
Zur Kopplung wird nur die IP-Adresse, DSAP, SSAP des Partners benötigt. Zur Kommunikation für RFC1006 wird standardmäßig Port 102 verwendet.

Bitte beachten Sie: Die Funktionen werden mit der Standard Socket -Schnittstelle ausgeführt, was zur Folge hat, dass die Funktion erst nach Erfüllung der Aufgabe zum Aufrufer zurückkehrt. Zum Asynchronen Betrieb rufen Sie diese Funktionen einfach von einem separaten Thread aus auf, welcher für die Kommunikation des System zuständig ist.

Zum Betrieb als Server beachte man die Funktionen:
Rfc1006OpenServer
Rfc1006GetStatus
Rfc1006StartServer

Ansonsten können die Funktionen Rfc1006Rx und Rfc1006Tx für die Kommunikation verwendet werden. Es ist ratsam in regelmäßigen Zeitabständen mit Rfc1006GetStatus zu prüfen, ob eine Verbindung besteht und dann erst die Sende und Empfangsroutinen verwenden.

Folgende Funktionen stehen zur Verfügung:

zur Initialisierung der Verbindung, dort wird nur Speicher vorbereitet. Beim ersten Aufruf der Lese- oder Schreibfunktionen wird, die TCP/IP-Verbindung / RFC 1006 Verbindung automatisch gestartet.
(Nur bei Betrieb als Client verwenden!)

C/C++

long WINAPI
Rfc1006Open (LPCSTR IPAdr,BYTE *SSAP, DWORD LenSSAP, BYTE *DSAP, DWORD LenDSAP, 
             DWORD Port, DWORD ConnectTimeout);

Delphi

FUNCTION
Rfc1006Open (IPAdr : PAnsieChar; SSAP : Pointer; LenSSAP : LongWord; DSAP : Pointer; 
             LenDSAP : LongWord; Port LongWord; ConnectTimeout : LongWord): LongInt; 
			stdcall; external 'Rfc1006Lib.dll';   

VB

Declare Function Rfc1006Open& Lib "Rfc1006Lib.dll" (ByVal IPAdr As String, _
                                                     SSAP as Byte, _
                                                     ByVal LenSSAP&, _
                                                     DSAP As Byte,  _
                                                     ByVal LenDSAP&, _
                                                     ByVal Port&, _
                                                     ByVal ConnectTimeout&)

Legt eine neue Verbindung für den Serverbetrieb an. Der Start der Verbindung wird mit Rfc1006StartServer gesteuert.
Wurde bereits „Rfc1006StartServer“ ausgeführt, so wird die „neue Verbindung“ sofort als verfügbar eingetragen.
Falls der Port bereits von einer anderen Anwendung verwendet wird kommt es zu einem Socketfehler. Mit Rfc1006GetSockErr, Rfc1006GetSockErrString kann er genaue Grund ermittelt werden.

Ab Version 1.31 wurde „Rfc1006OpenExServer“ implementiert. Hier kann der TCP-Port für die gewünschte Verbindung angegeben werden. So ist es möglich, auf verschiedenen Ports gleichzeitig Verbindungen entgegenzunehmen. (Nur bei Betrieb als Server verwenden!)

C/C++

long WINAPI
Rfc1006OpenServer (LPCSTR DstIPAdr, BYTE *SSAP, DWORD LenSSAP, BYTE *DSAP, DWORD LenDSAP); 
 
long WINAPI
Rfc1006OpenExServer (LPCSTR DstIPAdr, BYTE *SSAP, DWORD LenSSAP, BYTE *DSAP, DWORD LenDSAP, DWORD Port);

Delphi

FUNCTION
Rfc1006OpenServer (DstIPAdr : PAnsiChar; SSAP : Pointer; LenSSAP : LongWord; DSAP : Pointer; LenDSAP : LongWord): LongInt; 
			stdcall; external 'Rfc1006Lib.dll';  
 
FUNCTION
Rfc1006OpenExServer (DstIPAdr : PAnsiChar; SSAP : Pointer; LenSSAP : LongWord; DSAP : Pointer; LenDSAP : LongWord; Port : LongWord)): LongInt; 
  stdcall; external 'Rfc1006Lib.dll';

VB

Declare Function Rfc1006OpenServer& Lib "Rfc1006Lib.dll"(ByVal DstIPAdr as String, _
                                                         SSAP as Byte, _
                                                         ByVal LenSSAP&, _
                                                         DSAP as Byte, _
                                                         ByVal LenDSAP&)
 
Declare Function Rfc1006OpenExServer& Lib "Rfc1006Lib.dll"(ByVal DstIPAdr as String, _
                                                         SSAP as Byte, _
                                                         ByVal LenSSAP&, _
                                                         DSAP as Byte, _
                                                         ByVal LenDSAP&_
                                                         ByVal Port&)

(Nur bei Betrieb als Server verwenden!)

Startet den Server mit den mit Rfc1006OpenServer / Rfc1006OpenExServer angelegten Verbindungen.

Nach dem Start können Verbindungen mit den Methoden Rfc1006OpenServer und Rfc1006CloseServer dynamisch hinzugefügt oder entfernt werden.

Sollte der Port einer angelegten Verbindung bereits durch eine andere Anwendung verwendet werden, tritt ein Socketfehler auf (Returnwert E_RFC1006_SOCKERR). Mit Rfc1006GetSockErr und Rfc1006GetSockErrString kann der genaue Grund ermittelt werden - verwenden Sie bei der Abfrage Ref = -1.

C/C++

long WINAPI
Rfc1006StartServer (int Port, LPCSTR BindIPAdr, int MaxCon);

Delphi

FUNCTION
Rfc1006StartServer (Port : LongWord; BindIPAdr : PAnsiChar; MaxCon : LongWord): LongInt; 
			stdcall; external 'Rfc1006Lib.dll';   

VB

Declare Function Rfc1006StartServer& Lib "Rfc1006Lib.dll"(int Port, _
                                                          ByVal BindIPAdr as String, _
                                                          int MaxCon)

Beendet den Server.
(Nur bei Betrieb als Server verwenden!)

C/C++

long WINAPI
Rfc1006StopServer (void);

Delphi

FUNCTION
Rfc1006StopServer (): LongInt; 
			stdcall; external 'Rfc1006Lib.dll'; 

VB

Declare Sub Rfc1006StopServer& Lib "Rfc1006Lib.dll"  ()

zur Deinitialisierung der Verbindung, Speicher wird freigegeben und die TCP/IP-Verbindung wird getrennt.

C/C++

long WINAPI
Rfc1006Close (long Ref);

Delphi

FUNCTION
Rfc1006Close (Ref : LongInt) : LongInt; 
			stdcall; external 'Rfc1006Lib.dll';

VB

Declare Function  Rfc1006Close& Lib "Rfc1006Lib.dll" (ByVal Ref&)

zur Deinitialisierung der Verbindung, Speicher wird freigegeben und die TCP/IP-Verbindung wird getrennt.

C/C++

void WINAPI
Rfc1006CloseAll (void); 

Delphi

PROCEDURE
Rfc1006CloseAll (); 
			stdcall; external 'Rfc1006Lib.dll';

VB

Declare Sub Rfc1006CloseAll Lib "Rfc1006Lib.dll" ()

C/C++

long WINAPI
Rfc1006Rx (long Ref, void *Buf, DWORD MaxCnt, long RxTimeout);
 
long WINAPI
Rfc1006Tx (long Ref, void *Buf, DWORD Cnt, long Timeout);

Delphi

FUNCTION
Rfc1006Rx (Ref : LongInt; Buf : Pointer; MaxCnt : LongWord; RxTimeout : LongWord): LongInt; 
			stdcall; external 'Rfc1006Lib.dll'; 
 
FUNCTION
Rfc1006Tx (Ref : LongInt; Buf : Pointer; Cnt : LongWord; Timeout : LongWord): LongInt; 
			stdcall; external 'Rfc1006Lib.dll'; 

VB

Declare Function Rfc1006Rx& Lib "Rfc1006Lib.dll"  (ByVal Ref&, _
                                                   Buf as Byte, _
                                                   DWORD MaxCnt, _
                                                   long RxTimeout)
 
Declare Function Rfc1006Tx& Lib "Rfc1006Lib.dll"  (ByVal Ref&, _
                                                   Buf as Byte, _
                                                   ByVal Cnt&, _
                                                   ByVal Timeout&)

Liefert den letzten Socket-Fehler zurück. Dieser wird Verbindungsbezogen gespeichert. Tritt eine Socket-Fehler beim Aufruf von Rfc1006OpenServer / Rfc1006OpenExServer / RfcStartServer auf, so gibt es noch keine Verbindungsreferenz. In diesem Falle wird der Socket-Fehler „globalen“ Bereich gespeichert. Zur Abfrage dieses Wertes verwenden Sie als Ref den Wert -1.

C/C++

long WINAPI
Rfc1006GetSockErr (long Ref);

Delphi

FUNCTION
Rfc1006GetSockErr (Ref : LongInt) : LongInt; 
			stdcall; external 'Rfc1006Lib.dll';

VB

Declare Function Rfc1006GetSockErr& Lib "Rfc1006Lib.dll" (ByVal Ref&)

Liefert den Socketfehler in Textform zurück

C/C++

const char * WINAPI
Rfc1006GetSockErrString(long SockErr, LPSTR ErrStr, DWORD MaxLen); 

Delphi

FUNCTION
Rfc1006GetSockErrString (SockErr : LongInt; ErrStr : PAnsiChar; MaxLen LongWord) : PAnsiStr; 
			stdcall; external 'Rfc1006Lib.dll';

VB

Declare Function Rfc1006GetSockErrString& Lib "Rfc1006Lib.dll" (ByVal SockErr&, _
                                                     ByVal ErrStr As String, _
                                                     ByVal MaxLen&) as String

Liefert den Status der Verbindung

C/C++

long WINAPI
Rfc1006GetStatus (long Ref);

Delphi

FUNCTION
Rfc1006GetStatus (Ref : LongInt) : LongInt; 
			stdcall; external 'Rfc1006Lib.dll'; 

VB

Declare Function Rfc1006GetStatus& Lib "Rfc1006Lib.dll"(ByVal Ref&)

Führt die Verbindung zum Partner aus

C/C++

long WINAPI
Rfc1006Close (long Ref);

Delphi

FUNCTION
Rfc1006Connect (Ref : LongInt) : LongInt; 
			stdcall; external 'Rfc1006Lib.dll';

VB

Declare Function Rfc1006Connect& Lib "Rfc1006Lib.dll"(ByVal Ref&)

Trennt die Verbindung zum Partner.

C/C++

long WINAPI
Rfc1006Disconnect (long Ref);

Delphi

FUNCTION
Rfc1006Disconnect (Ref : LongInt) : LongInt; 
			stdcall; external 'Rfc1006Lib.dll';

VB

Declare Function Rfc1006Disconnect& Lib "Rfc1006Lib.dll"(ByVal Ref&)

Aktiviert/daktiviert FastAcknowlege Antwort, default: deaktiviert

C/C++

long WINAPI 
Rfc1006SetFastAck (long Ref, DWORD Mode); 

Delphi

FUNCTION 
Rfc1006SetFastAck (Ref : LongInt; Mode : LongWord): LongInt; 
			stdcall; external 'Rfc1006Lib.dll'; 

VB

Declare Function Rfc1006SetFastAck& Lib "Rfc1006Lib.dll" (ByVal Ref&, _
                                     ByVal Mode&)

Setzt individuelle TCP/IP KeepAlive Zeiten für die mit Ref angegebene Verbindung. Muss nur verwendet werden, wenn die Standardwerte nicht gelten sollen.

Sie sollten diese Funktion unmittelbar nach dem „Open“-Aufruf ausführen.

C/C++

long WINAPI 
Rfc1006SetKeepAlive (long Ref, DWORD AliveInterval, DWORD AliveTime); 

Delphi

FUNCTION 
Rfc1006SetKeepAlive (Ref : LongInt; AliveInterval : LongWord; AliveTime : LongWord): LongInt; 
			stdcall; external 'Rfc1006Lib.dll';

VB

Declare Function Rfc1006SetKeepAlive& Lib "Rfc1006Lib.dll"(ByVal Ref&, _
                                       ByVal AliveInterval&, _
                                       ByVal AliveTime&)

Rfc1006TxUnlocked sendet Daten an den Partner ohne die Verbindungdaten zu locken. Diese Funktion kann bei MultiThreading Anwednung finden, wenn ein Receive-Thread die Verbindung gerade blockiert.
VORSICHT! Der Aufrufer hat dafür zu sorgen, dass während der Ausführung das Objekt mit der angegebenen Referenz geöffnet bleibt!
Die Funktion und Returnwerte wie bei Rfc1006Tx

C/C++

long WINAPI
Rfc1006TxUnlocked (long Ref, void *Buf, DWORD Cnt, long Timeout); 

Delphi

FUNCTION
Rfc1006TxUnlocked (Ref : LongInt; Buf : PChar; Cnt : LongWord; Timeout : LongWordt): LongInt; 
			stdcall; external 'Rfc1006Lib.dll';

VB

Declare Function Rfc1006TxUnlocked& Lib "Rfc1006Lib.dll"(ByVal Ref&, _
                                     void *Buf, _
                                     ByVal Cnt&, _
                                     ByVal Timeout&)

Rfc1006PacketInQ liefert zurück, ob ein Paket zum Empfangen in der Empfangsqueue vorhanden ist.

C/C++

long WINAPI 
Rfc1006PacketInQ (long Ref); 

Delphi

FUNCTION 
Rfc1006PacketInQ (Ref : LongInt) : LongInt; 
			stdcall; external 'Rfc1006Lib.dll'; 

VB

Declare Function Rfc1006PacketInQ& Lib "Rfc1006Lib.dll" (ByVal Ref&)

Diese Liste erhebt keinen Anspruch auf Vollständigkeit