Werbung
CANStartAlive
CANStartAlive — Startet den ALIVE Mechanismus, der periodisch den Status der
aktiven Netzwerk-Verbindung zur AnaGate-Hardware überprüft.
Syntax
#include <AnaGateDllCan.h>
AnaInt32 CANStartAlive(AnaInt32 hHandle, AnaUInt32 nAliveTime );
Parameter
hHandle
nAliveTime
Rückgabewert
Die Funktion gibt im Erfolgsfall Null zurück, andernfalls einen Fehlercode (Anhang A,
Rückgabewerte aus den API-Funktionen ).
Beschreibung
Das
AnaGate-Kommunikationsprotokoll
anwendungsspezifische
Verbindungsabbrüche schneller erkannt werden können.
Die CANStartAlive-Funktion startet innerhalb der API einen nebenläufigen
Thread, der periodisch definierte Alive-Telegramme (ALIVE_REQ) über die aktuelle
Netzwerkverbindung mit der AnaGate-Hardware austauscht. Wird das Alive-
Telegramm nicht innerhalb der vorgegebenen Intervallzeit vom Partner quittiert, wird
die Verbindung als disconnected markiert und explizit abgebaut.
Mit der Funktion CANDeviceConnectState kann der Netzwerk-Verbindungsstatus
überprüft werden.
Bemerkung
Die Funktion CANStartAlive ist erst ab Version 1.4-1.10 der Laufzeitbibliothek
vorhanden.
Auf der Hardware-Seite wird mindestens die Firmware-Version 1.3.8 oder höher
vorausgesetzt. Geräte vom Typ AnaGate CAN (Hardware-Version 1.1.A) unterstützen
den anwendungsspezifischen Alive-Mechanismum nicht.
Siehe auch
CANDeviceConnectState
Abschnitt 2.1, „ Besondere Protokolleigenschaften "
CAN API Funktionen
Gültiges
Zugriffs-Handle
CANOpenDevice.
Timeout-Intervall in Sekunden für den ALIVE-Mechanismus.
Verbindungsüberwachung,
eines
erfolgreichen
(siehe
[TCP-2010])
43
© 2007-2015 Analytica GmbH
Aufrufs
unterstützt
über
die
ungeplante
von
eine
Werbung
Kapitel
