Unterstützte Bildeinzugsschnittstellen
Derzeit werden die folgenden Bildeinzugsschnittstellen der folgenden Industriestandards unterstützt:
- GenICam GenTL
- GigEVision2
- USB3 Vision
MERLIC verwendet die entsprechenden Bildeinzugsschnittstellen von HALCON Bei MVTec HALCON handelt es sich um die umfassende Standardsoftware für die Bildverarbeitung mit einer integrierten Entwicklungsumgebung (HDevelop). MERLIC verwendet verschiedene HALCON-Prozeduren und andere Programmfunktionen.. Registrierte Kunden können daher die aktuelle Version der Schnittstellen über den MVTec Interfaces-Download vom MVTec-Server herunterladen.
Die folgenden Abschnitte enthalten eine allgemeine Dokumentation der Schnittstellen für den Zugriff auf alle kompatiblen Kameras. Eine ausführlichere Dokumentation mit weiteren technischen Informationen finden Sie in der HALCON-Dokumentation der Schnittstellen auf der MVTec-Website.
GenICam GenTL
- Intel-kompatibler PC mit Windows 10 (64-Bit) oder neuer, der auch vom verwendeten GenTL Producer unterstützt wird.
- GenICam GenTL Producer ordnungsgemäß installiert. Die entsprechende .cti-Datei muss sich in einem der Verzeichnisse befinden, die über die Umgebungsvariable GENICAM_GENTL64_PATH angegeben werden.
- Stellen Sie abhängig von der verwendeten Transportschicht sicher, dass Sie auf das Gerät zugreifen können. Achten Sie darauf, dass alle Anforderungen und Empfehlungen der jeweiligen GenTL Producer eingehalten werden, um einen einwandfreien und effektiven Zugriff auf die Geräte zu gewährleisten. Insbesondere für (Gigabit) Ethernet müssen die folgenden Punkte geprüft werden:
- Es wird empfohlen, einen PCIe-Netzwerkadapter zu verwenden, der Jumbo-Frames unterstützt. Konfigurieren Sie den Netzwerkadapter entsprechend, z. B. mit einem MTU-Wert von 9000. Darüber hinaus sollte die Kamera direkt an den Netzwerkadapter angeschlossen werden, um Störungen durch anderen Netzwerkverkehr zu vermeiden. Beachten Sie bitte, dass Netzwerkeinrichtungen wie Switches nicht notwendigerweise Jumbo-Frames unterstützen.
- Stellen Sie bei Verwendung einer Firewall sicher, dass die Firewall-Einstellungen abhängig von der verwendeten Transportschicht eine Kommunikation mit der Kamera für Erkennung, Steuerung und Streaming ermöglichen. Bei Windows besteht die einfachste Möglichkeit, dies zu erreichen, darin, die Anwendung, d. h. MERLIC oder Ihre kompilierte Anwendung, in der Firewall zuzulassen.
- GenICam-Version 3.4.2: Die entsprechenden Dateien sind Bestandteil der MERLIC-Installation und befinden sich im Verzeichnis genicam im MERLIC-Installationsverzeichnis. Da die GenICamTL-Schnittstelle alle erforderlichen Umgebungsvariablen selbst festlegt, müssen keine Umgebungsvariablen festgelegt oder geändert werden.
- Im Standardbildeinzugsmodus wird vorausgesetzt, dass der Computer schnell genug ist, um alle Puffer der Kamera zu verarbeiten. Andernfalls werden sie stillschweigend verworfen (vom GenTL Producer).
- Es wird lediglich Kanal 0 für das Streaming unterstützt. Das heißt, dass ein gleichzeitiger Bildeinzug mehrerer Datenströme eines Geräts derzeit nicht möglich ist.
- Keine Unterstützung des Bildeinzugs von Geräten mit Lesezugriffsmodus.
- Eingeschränkte Unterstützung von Geräten mit Funktionen für mehrere ROIs.
-
Falls Sie das veraltete Tool „Bild von Kamera einziehen“ für den Bildeinzug verwenden, gilt auch die folgende Einschränkung: Einige Kamerageräte unterstützen die Funktion zum Speichern und Laden von geänderten Konfigurationseinstellungen nicht. In diesem Fall können Sie Ihre Anpassungen der Kameraparameter nicht in der MERLIC-Vision-App speichern! Wenn ein solches Gerät verwendet wird, werden die Standardkameraeinstellungen wiederhergestellt, sobald das Tool erneut geladen wird. Doch auch wenn das ausgewählte Kameragerät die Funktion zum Speichern und Laden grundsätzlich unterstützt, hängt es vom jeweiligen Gerät ab, welche Kameraparameter tatsächlich gespeichert werden.
Wenn eine GigE Vision-Kamera im veralteten Tool „Bild von Kamera einziehen“ verbunden ist, wird der Parameter [Stream]GevStreamAbortCheckPeriod der Kamera automatisch auf einen Wert von 500 µs festgelegt, um die Bildeinzugszeit zu verkürzen. Der Wert wird automatisch bei jedem Laden der Kamera, d. h. beim Laden der MVApp, festgelegt. Um einen anderen Wert zu verwenden, müssen Sie den Wert nach dem Laden der MVApp manuell anpassen.
Die Schnittstelle kann über mehrere Umgebungsvariablen gesteuert werden:
- GENICAM_GENTL64_PATH ist eine GenTL-Standardvariable mit einer Liste der Verzeichnisse, in denen die einzelnen GenTL Producer installiert sind. Das Installationsprogramm eines GenTL Producers passt diese Variablen normalerweise automatisch an.
GigEVision2
- Intel-kompatibler PC mit Windows 10 (64-Bit) oder neuer.
- Gigabit Ethernet-Netzwerkadapter. Es wird empfohlen, einen PCIe-Netzwerkadapter zu verwenden, der Jumbo-Frames unterstützt. Konfigurieren Sie den Netzwerkadapter entsprechend, z. B. mit einem MTU-Wert von 9000, um die Anzahl der Unterbrechungen zu reduzieren. Darüber hinaus sollte die Kamera direkt an den Netzwerkadapter angeschlossen werden, um Störungen durch anderen Netzwerkverkehr zu vermeiden. Beachten Sie bitte, dass Netzwerkeinrichtungen wie Switches nicht notwendigerweise Jumbo-Frames unterstützen.
- Achten Sie bei Verwendung einer Firewall bitte darauf, dass die Firewall-Einstellungen eine Verbindung von Ihrer Anwendung oder MERLIC zur Kamera und dem Empfang eingehender Bilder zulassen. Andernfalls ist keine Erfassung möglich.
- MVTec GigE Vision Streaming Filter unter Windows x64: Die GigEVision2-Schnittstelle verwendet automatisch einen Filtertreiber, um die Leistung beim Streamen von Bildern zu verbessern. Bei der Installation von MERLIC wird der Filtertreiber automatisch installiert, wenn Sie das entsprechende Kontrollkästchen bei der Installation aktivieren.
Vergewissern Sie sich bitte, dass mindestens die Treiberversion v2.2.8.4 verfügbar ist. Ältere Treiberversionen funktionieren nicht. - GenICam-Version 3.4.2: Die entsprechenden Dateien sind Bestandteil des Schnittstellenpakets und befinden sich im Verzeichnis genicam im MERLIC-Installationsverzeichnis. Da die Schnittstelle alle erforderlichen Umgebungsvariablen selbst festlegt, müssen keine Umgebungsvariablen festgelegt oder geändert werden.
- Im Standardpufferverarbeitungsmodus wird vorausgesetzt, dass der Computer schnell genug ist, um alle Puffer der Kamera zu verarbeiten. Andernfalls werden sie stillschweigend verworfen.
- Es wird lediglich Kanal 0 für das Streaming unterstützt. Das heißt, dass ein gleichzeitiger Bildeinzug mehrerer Datenströme eines Geräts derzeit nicht möglich ist.
-
Falls Sie das veraltete Tool „Bild von Kamera einziehen“ für den Bildeinzug verwenden, gilt auch die folgende Einschränkung: Einige Kamerageräte unterstützen die Funktion zum Speichern und Laden von geänderten Konfigurationseinstellungen nicht. In diesem Fall können Sie Ihre Anpassungen der Kameraparameter nicht in der MERLIC-Vision-App speichern! Wenn ein solches Gerät verwendet wird, werden die Standardkameraeinstellungen wiederhergestellt, sobald das Tool erneut geladen wird. Doch auch wenn das ausgewählte Kameragerät die Funktion zum Speichern und Laden grundsätzlich unterstützt, hängt es vom jeweiligen Gerät ab, welche Kameraparameter tatsächlich gespeichert werden.
Wenn eine GigE Vision-Kamera im veralteten Tool „Bild von Kamera einziehen“ verbunden ist, wird der Parameter [Stream]GevStreamAbortCheckPeriod der Kamera automatisch auf einen Wert von 500 µs festgelegt, um die Bildeinzugszeit zu verkürzen. Der Wert wird automatisch bei jedem Laden der Kamera, d. h. beim Laden der MVApp, festgelegt. Um einen anderen Wert zu verwenden, müssen Sie den Wert nach dem Laden der MVApp manuell anpassen.
USB3 Vision
- Intel-kompatibler PC mit Windows 10 (64-Bit) oder neuer.
- Der Computer muss über eine USB 3.0-Schnittstelle verfügen. Achten Sie darauf, dass Sie die neuesten Treiber für den USB 3.0-Hostcontroller verwenden. Auf Windows-Systemen reicht eine Suche mit dem integrierten Mechanismus normalerweise nicht aus, sodass Sie die neueste Version auf der Website des Herstellers des Hostcontrollers suchen müssen.
- Achten Sie darauf, dass die Verbindung zum Gerät über den entsprechenden Treiber hergestellt wurde. Überprüfen Sie dazu im Meldungsfenster, das angezeigt wird, wenn das Gerät erstmals angeschlossen wird, ob der betreffende Treiber installiert ist.
- GenICam-Version 3.4.2: Die entsprechenden Dateien sind Bestandteil der MERLIC-Installation und befinden sich im Verzeichnis genicam im MERLIC-Installationsverzeichnis. Da die HALCON GenICamTL-Schnittstelle alle erforderlichen Umgebungsvariablen selbst festlegt, müssen keine Umgebungsvariablen festgelegt oder geändert werden.
- Im Standardbildeinzugsmodus wird vorausgesetzt, dass der Computer schnell genug ist, um alle Puffer der Kamera zu verarbeiten. Andernfalls werden sie stillschweigend verworfen.
- Geräte mit mehreren USB-Konfigurationen werden nicht vollständig unterstützt.
-
Falls Sie das veraltete Tool „Bild von Kamera einziehen“ für den Bildeinzug verwenden, gilt auch die folgende Einschränkung: Einige Kamerageräte unterstützen die Funktion zum Speichern und Laden von geänderten Konfigurationseinstellungen nicht. In diesem Fall können Sie Ihre Anpassungen der Kameraparameter nicht in der MERLIC-Vision-App speichern! Wenn ein solches Gerät verwendet wird, werden die Standardkameraeinstellungen wiederhergestellt, sobald das Tool erneut geladen wird. Doch auch wenn das ausgewählte Kameragerät die Funktion zum Speichern und Laden grundsätzlich unterstützt, hängt es vom jeweiligen Gerät ab, welche Kameraparameter tatsächlich gespeichert werden.
Wenn eine GigE Vision-Kamera im veralteten Tool „Bild von Kamera einziehen“ verbunden ist, wird der Parameter [Stream]GevStreamAbortCheckPeriod der Kamera automatisch auf einen Wert von 500 µs festgelegt, um die Bildeinzugszeit zu verkürzen. Der Wert wird automatisch bei jedem Laden der Kamera, d. h. beim Laden der MVApp, festgelegt. Um einen anderen Wert zu verwenden, müssen Sie den Wert nach dem Laden der MVApp manuell anpassen.
Einschränkungen
Hardwaretrigger werden von MERLIC nur unterstützt, wenn der Image Source Manager verwendet wird.
Informationen zum Einrichten einer Kamera, die von einem Hardwaretrigger ausgelöst wird, finden Sie unter Bildquellen konfigurieren.
Kamerageräte, die für den Bildeinzug über den Image Source Manager konfiguriert sind, können nicht im Tool „Bild von Kamera einziehen“ verwendet werden, wenn sie Teil der derzeit aktiven Konfiguration sind.
Fehlerbehebung
- Überprüfen Sie, ob die neueste Revision der Schnittstelle verwendet wird.
- Überprüfen Sie die Systemanforderungen.
- Überprüfen Sie, ob die neueste Firmware auf dem Gerät installiert ist.
- Überprüfen Sie den Toolstatus-Wert, um weitere Informationen zum Problem zu erhalten.
- Überprüfen Sie, ob die richtigen GenICam-Binärdateien verwendet werden. MERLIC verwendet die offiziellen Binärdateien in einer privaten Installation (Verzeichnis genicam im MERLIC-Installationsverzeichnis). Falls sich andere GenICam-Binärdateien in Ihrem Pfad oder in einem Systempfad befinden, z. B. in C:\Windows\System32\, muss es sich dabei um die offiziellen Dateien handeln. Vergleichen Sie diese Dateien mit denen in der MERLIC-Installation, um dies festzustellen. Die Verwendung von inoffiziellen Binärdateien kann zu Problemen führen.
- Überprüfen Sie, ob eine neuere Version des verwendeten GenICamTL Producers verfügbar ist.
- Überprüfen Sie, ob die Kamera GigE Vision-kompatibel ist.
- Überprüfen Sie, ob der Filtertreiber verwendet wird (siehe Parameter [Stream]GevStreamActiveEngine).
- Überprüfen Sie, ob die Einstellungen der Firewall (Windows oder andere) eine Kommunikation mit der GigE Vision-Kamera zulassen. Für die Gerätesteuerung (GVCP) und Streamingdaten (GVSP) werden verschiedene Verbindungen verwendet. Es kann erforderlich sein, den Zugriff für die jeweilige Anwendung (z. B. MERLIC) im Windows-Dialog „Firewalleinstellungen“ explizit zuzulassen. Es reicht nicht aus, den Windows-Standarddialog zu verwenden, der angezeigt wird, wenn eine Anwendung zum ersten Mal von der Firewall blockiert wird.
Weiterhin können die folgenden Hinweise hilfreich sein, um einige spezielle Probleme zu lösen.
- Ursache: Dafür kommen mehrere Ursachen infrage, z. B. falsche Netzwerkeinstellungen oder störende Programme.
- Vorschlag a): Überprüfen Sie die Firewall-Einstellungen.
- Vorschlag b): Überprüfen Sie die Miniport-Treiber der Kamera, die möglicherweise die Pakete „stehlen“.
- Vorschlag c): Überprüfen Sie, ob die Kamera im Netzwerk erreichbar ist (z. B. mit ping).
- Vorschlag d): Überprüfen Sie, ob die Kamera GigE Vision-kompatibel ist oder die Firmware der Kamera aktualisiert werden muss.
- Vorschlag e): Bei Anzeige des Fehlers „no exclusive access“:
- Die Kamera wird anderweitig verwendet (z. B. von einer anderen Person oder einem anderen Programm).
- Versuchen Sie, die Kamera aus- und wieder einzuschalten.
- Die Kamera ist im aktuellen Netzwerk nicht erreichbar.
- Ursache: Dafür kommen mehrere Ursachen infrage, z. B. blockierende Programme, Netzwerkprobleme oder Parametereinstellungen.
- Vorschlag a): Überprüfen Sie die Firewall-Einstellungen.
- Vorschlag b): Überprüfen Sie die Miniport-Treiber der Kamera, die möglicherweise die Pakete „stehlen“.
- Ursache: Das System kann nicht alle erforderlichen Pakete empfangen oder verarbeiten und eine Neuübertragung schlägt aufgrund von langsamen Ethernet-Karten, von langsamen Computern, eines langsamen Netzwerkzugriffs oder eines langsamen bzw. stark belasteten Bus fehl.
- Vorschlag a): Überprüfen Sie, ob der Filtertreiber verwendet wird.
- Vorschlag b): Legen Sie GevSCPD auf einen höheren Wert fest, um eine Burstübertragung von Paketen zu vermeiden, die zu einer Überlastung führt.
- Vorschlag c): Erhöhen Sie die Paketgröße (Netzwerkkarte und Kamera), um Verarbeitungsunterbrechungen und Verarbeitungsaufwand zu verringern.
- Vorschlag d): Verringern Sie die Busbelastung durch andere Anwendungen oder Kameras.
- Ursache: Bildeinzug wird ausgeführt.
- Lösung: Beenden Sie den Bildeinzug, indem Sie die Ausführung der MVApp beenden.
- Ursache: Die Kamera braucht mehr Zeit zum Einstellen der Parameter.
- Lösung: Vergrößern Sie den Parameter [Device]LinkCommandTimeout.
Wenden Sie sich bitte an Ihren lokalen Distributor, wenn weiterhin Probleme auftreten. Um unnötige Nachfragen zu vermeiden, werden für Supportanfragen folgende Informationen benötigt.
- Verwendete Version von MERLIC und Bildeinzugsschnittstelle.
- Kamerahersteller, Modell und Firmware-Version.
- Details zum Computersystem, z. B. Betriebssystem, RAM und CPU.
- Fehlermeldung der Ausgabekonsole in MERLIC und generierte Log-Dateien.
- Minimale MERLIC-Vision-App als Musteranwendung, um das Problem zu reproduzieren.
- Beschreibung des beobachteten und des erwarteten Verhaltens.
- Bei Verwendung einer GenICamTL-Schnittstelle:
- Details zum verwendeten GenICam GenTL Producer (zumindest Name und Version).
- Bei Verwendung einer GigEVision2-Schnittstelle:
- Details zur Netzwerkkarte (PCI, CardBus, Jumbo-Frames, Verbindungsgeschwindigkeit, ...).
- Details zur Netzwerktopologie (Direktanschluss, Switches, ...).