|
<< Click to Display Table of Contents >> Navigation: MscDll Referenzhandbuch > Programmierschnittstelle > Verbindung > MSC_GetDeviceState |
Diese Funktion gibt den Kommunikationsstatus zum Irinos-System zurück. Sie dient reinen Diagnose-Zwecken. Für den Normalbetrieb ist Sie nicht erforderlich. Ihre Implementierung ist jedoch empfohlen, um im Fehlerfall erweiterte Diagnose-Möglichkeiten zu haben.
Definition
MSC_STATUS
MSC_GetDeviceState(
MSC_HANDLE Handle,
unsigned long* LastMsgReceived,
unsigned long* SndErrorCounter,
unsigned long* RcvErrorCounter,
unsigned long* CmdDiscarded,
unsigned long* CmdDiscardedArray,
unsigned long Flags
);
Parameter
Handle
Handle zum Gerät, das bei einem früheren Aufruf der Funktion MSC_OpenDevice zurückgegeben wurde.
LastMsgReceived
Gibt das Zeitintervall zurück zwischen jetzt und dem Zeitpunkt des Empfangs der letzten gültigen Daten-Pakets.
SndErrorCounter
Gibt den Fehlerzähler der physikalisch gesendeten Übertragungsfehler zurück. Die Zähler werden auf null gesetzt, entweder durch die Funktion MSC_Start oder falls der Flags value MSC_RESET_ERROR_COUNTERS gesetzt ist.
RcvErrorCounter
Gibt den Fehlerzähler der physikalisch empfangenen Übertragungsfehler. Die Zähler werden auf null gesetzt, entweder durch die Funktion MSC_Start oder falls der Flags value MSC_RESET_ERROR_COUNTERS gesetzt ist.
CmdDiscarded
Gibt einen Zähler zurück, der jedes Mal ansteigt, wenn ein Opcode empfangen wird, der nicht erwartet wurde. Dieser Zähler ist Übersicht des CmdDiscardedArray. Die Zähler werden auf null gesetzt, entweder durch die Funktion MSC_Start oder falls der Flags value MSC_RESET_DISCARDED_COUNTERS gesetzt ist.
CmdDiscardedArray
Pointer zu einem nutzergestellten Array von 256 unsigned long values. Jeder Wert enthält den Fehlerzähler für einen Opcode spezifiziert durch einen Index. Die Zähler werden auf null gesetzt, entweder durch die Funktion MSC_Start oder falls der Flags value MSC_RESET_DISCARDED_COUNTERS gesetzt ist.
Flags
Enthält bitweise Informationen für die MSC DLL. Die Werte können auch kombiniert auftreten.
MSC_RESET_ERROR_COUNTERS
Dieses Bit löscht den Sende- und Empfangs Fehlerzähler.
MSC_RESET_DISCARDED_COUNTERS
Dieses Bit löscht den Zähler für ungültige Telegramme.
Rückgabewert
Die Funktion gibt im Erfolgsfall MSC_STATUS_SUCCESS zurück, bei Fehlern wird der Fehlercode zurückgegeben.
Siehe auch