TcCOM-Parameter

Folgend sind die Parameter der drei TcCOM-Module Image Acquisition, GVCP und GVSP beschrieben. Die Anpassung dieser Parameter kann bei bestimmten Kameras helfen, eine stabile Verbindung aufzubauen. Zur Veränderung der Parameter sollte der Konfigurationsbaum genutzt werden.

Zunächst ist hier nur der Parameter InitializationAutoMode relevant. Die Einstellung der restlichen Parameter kann allerdings bei Verbindungs- oder Initialisierungsproblemen der Kamera nötig sein.

	Neuladen bei Parameteränderungen Damit Parameteränderungen wirksam werden, müssen die entsprechenden Objekte neu geladen werden.

Image Acquisition Module

Feature	Beschreibung
CameraIPAddress	IP-Adresse der Kamera. Diese IP-Adresse wird bei dem Force-IP-Kommando benutzt. Wenn diese IP-Adresse geändert wird, müssen anschließend die Initialization Commands neu erstellt werden, damit die Änderung wirksam wird. Zudem muss für das Force-IP-Kommando die entsprechende Option in der Konfiguration aktiviert sein.
InitializationTimeout	Maximale Zeit zur Übertragung der Initialisierungsparameter auf die Kamera. Abhängig von der verwendeten Kamera kann die Übertragung auch länger dauern, sodass eine Anpassung des Parameters erforderlich ist. Einheit: Millisekunden (ms) Standard: 2.000
InitializationAutoMode	Auswahl, inwiefern die Initialisierung der Kamera von dem ImageAcquisition TcCOM-Objekt automatisch ausgeführt werden soll. Wenn die Kamera nicht initialisiert wurde, kann nicht mit ihr kommuniziert werden. AUTOINIT_SO: Die Kamera wird während der Aufstartphase des TcCOM-Objekts initialisiert. In dieser Phase steht nur begrenzt Zeit zu Verfügung. Falls Initialisierungsparameter genutzt werden, kann die Initialisierung auf Grund der potenziellen Timeouts im Normalfall nicht innerhalb dieser Aufstartphase durchgeführt werden. In diesem Fall wird das Verhalten von AUTOINIT_AFTER_SO angewendet, selbst wenn AUTOINIT_SO ausgewählt ist. AUTOINIT_AFTER_SO: Das TcCOM-Objekt fährt in den OP-Zustand hoch ohne die Kamera zu initialisieren. Erst wenn aus der SPS die Verbindung zur Kamera geöffnet wird (z. B. mit `FB_VN_SimpleCameraControl.StartAcquisition()` oder mit `FB_VN_GevCameraControl.OpenCamera()`), wird die Kamera automatisch initialisiert. NO_AUTOINIT: Die Kamera wird nur dann initialisiert, wenn `GevCameraController.InitializeCamera()` aufgerufen wird. Diese Option ist für den Fall gedacht, dass man die vollständige Kontrolle über die Initialisierung benötigt, um diese zu einem bestimmten Zeitpunkt durchzuführen. Standard: AUTOINIT_AFTER_SO.
EnableConcatenatedCommands	Auswahl, ob beim Schreiben von mehreren Befehlen auf die Kamera, zum Beispiel bei den Initialisierungsparametern, die dazugehörigen Befehle verknüpft oder einzeln versendet werden sollen. Das Verknüpfen der Befehle macht die Übertragung schneller, kann allerdings bei einigen Kameras zu Problemen führen. Standard: aktiviert.

GVCP Module

Feature	Beschreibung
LocalPort	Der lokale UDP Port, über den das GVCP Modul kommuniziert. Ist der Wert null, wird ein automatisch generierter Port verwendet. Standard: 0
MaxTimeouts	Die maximale Anzahl an TransmissionTimeouts, die auftreten dürfen, bevor ein GVCP Paket verworfen wird. Nach jedem Timeout wird das GVCP Paket erneut geschickt. Wenn die maximale Timeout-Anzahl erreicht wird, wird ein Fehler geworfen. Standard: 3 (angepasst an Kamera)
TransmissionTimeout	Nach dem Senden eines GVCP-Pakets wird auf eine Antwort gewartet. Benötigt die Antwort länger als die TransmissionTimeout-Zeit, so wird angenommen, dass das Paket nicht angekommen ist, und es wird ggfs. erneut gesendet. Einheit: Millisekunden (ms) Standard: 600 (angepasst an Kamera) Der TransmissionTimeout sollte kleiner als die HeartbeatRate sein.
HeartbeatRate	Der Control Channel der Applikation sendet ein Heartbeat Signal an die Kamera, um zu überprüfen, ob die Verbindung noch gültig ist. Die HeartbeatRate beschreibt die Zeit, nach welcher das nächste Signal gesendet wird. Einheit: Millisekunden (ms) Standard: 1.000 Die HeartbeatRate sollte nicht beliebig hoch gesetzt werden, da viele Kameras nach einigen Sekunden ohne Heartbeat einen Timeout auslösen.
DiscoveryTimeout	Das DiscoveryTimeout beschreibt die Zeit, die auf Antworten eines Discovery Kommandos gewartet wird. Das Discovery Kommando wird gesendet, wenn nach Kameras im Netzwerk gesucht werden soll. Einheit: Millisekunden (ms) Standard: 1.000

GVSP Module

Feature	Beschreibung
LocalPort	Der lokale UDP Port, über den das GVCP Modul kommuniziert. Ist der Wert null, wird ein automatisch generierter Port verwendet. Standard: 0
MaxPacketSize	Die MaxPacketSize beschreibt die maximale Paketgröße eines GVSP Paketes. In dieser Größe ist der Header des Ethernet Frames nicht mit inbegriffen. Einheit: Byte Standard: 1.500 Abhängig vom installierten TwinCAT Realtime Ethernet Treiber und der in den Eigenschaften eingestellten Jumbo Packet Größe, können bis zu 9000 Byte verwendet werden.
MinPacketDelay	Wird das MinPacketDelay erhöht, so werden die GVSP Pakete künstlich verzögert. Dadurch kann die Bandbreite reduziert werden. Einheit: Timestamp counter unit(s) Standard: 0
MaxResendRequests	Die maximale Anzahl an Resend-Requests für ein einzelnes GVSP Paket, welches fehlerhaft war oder zu viel Zeit benötigt hat. Ein Bild wird in einem GVSP Block übertragen, welcher aus mehreren Paketen besteht. Wenn ein Paket eines Blocks nicht erfolgreich übertragen werden konnte, ist das Bild ungültig. Standard: 1
MaxBlockNumber	Maximale Anzahl an GVSP Blöcken, die gleichzeitig bearbeitet werden dürfen. Ist der Wert null, so wird die Anzahl nicht begrenzt. Standard: 5
MaxPacketNumber	Die Maximale Anzahl an GVSP Paketen in einem Block. Blöcke, die mehr Pakete beinhalten, können nicht als gültiges Bild interpretiert werden. Standard: 25.000 Die Anzahl wird automatisch berechnet, wenn die Option „Automatically calculate the MaxPacketNumber“ in den Preferences Einstellungen aktiv ist.
BlockTimeout	Das BlockTimeout beschreibt die Zeit, die zwischen einzelnen Paketen eines Blocks vergehen darf. Einheit: Mikrosekunden (µs) Standard: 5.000