FAQ

Der Cam Driver läuft auf einer ctrlX CORE (ctrlX OS, mit dem ctrlX Data Layer) oder auf einem PC mit Windows 11 oder Ubuntu 24.04 (mit LumiScan Keryx) und benötigt eine Ethernet-fähige, GenICam-konforme Kamera, versorgt über PoE oder ein externes Netzteil. Die Knotenadressen sind auf beiden Plattformen gleich. Er wurde mit ausgewählten Kameras von Basler, Baumer, IDS, LUCID Vision Labs, Hikvision und Balluff getestet; GenICam-Implementierungen unterscheiden sich, prüfen Sie also alle benötigten Funktionen vor dem Einsatz. Ab v2.0.0 kann eine Installation mehrere Kameras betreiben: Jede Kamera ist ein Modul mit eigener Konfiguration und Data-Layer-Adresse (zum Beispiel hdvisionsystems/lumiscan-cam-driver/camera1), und jede verbundene Kamera benötigt eine eigene Lizenz.

Voraussetzungen, Beschreibung, ctrlX Data Layer und LumiScan Keryx

(ctrlX OS) Das Handbuch beschreibt zwei Topologien. Weisen Sie der Kamera nach beiden eine eindeutige IP-Adresse zu, und testen Sie Werte für das Packet Delay, bis die Bildaufnahme stabil ist.

Hardware-Aufbau für ctrlX X3

Verwenden Sie die Funktion force-ip unter hdvisionsystems/lumiscan-cam-driver/system/force-ip/. Sie funktioniert auch, wenn die Kamera normalerweise nicht erkannt wird (zum Beispiel, weil ihr Subnetz nicht zu dem der ctrlX CORE oder des PCs passt), solange sie über dieselbe Netzwerkverbindung erreichbar ist.

Kamera-IP-Adresse einrichten, IP-Konfiguration der Kamera erzwingen

lumiscan-cam-driver.json enthält die Anwendungseinstellungen und listet die zu ladenden Kamerakonfigurationsdateien auf; jede weitere Datei (zum Beispiel camera_example.json) konfiguriert eine Kamera.

Kamerakonfiguration einrichten, Neue Kamera-Einstellungsdateien anlegen, Module hinzufügen und entfernen

inputFileType muss camera-configuration sein. Die Kameraeinstellungen sind id (muss über alle Kameraeinstellungen hinweg eindeutig sein; sie ist der Name des Moduls auf dem Data Layer und darf nur Kleinbuchstaben, Ziffern, - und _ enthalten), serial (eine Seriennummer, die simulation enthält, macht die Kamera zu einer simulierten), exposureTimeUS, pixelFormat (RGB8 oder Mono8), timestampSource (Camera oder System; ab v2.0.0 ist der Kamera-Zeitstempel der Standard) und, optional und experimentell, stream.tag. Parameter können auf dem Data Layer unter …​/input/ überschrieben werden. Starten Sie die Anwendung nach dem Ändern der Datei neu.

Beispielinhalt einer Kameradatei

Verbinden Sie die Kamera, und bearbeiten Sie dann die Knoten unter hdvisionsystems/lumiscan-cam-driver/<camera name>/features. Ihre Namen, Werte, Zugriffsrechte und Beschreibungen kommen direkt von der Kamera; ziehen Sie die Dokumentation des Kameraherstellers heran. Werte werden direkt in die Kamera geschrieben, seien Sie also bei Netzwerkeinstellungen vorsichtig. Diese Funktion ist als experimentell gekennzeichnet: Werte werden nicht zwischengespeichert, und wiederholtes Setzen (zum Beispiel von einer SPS aus) kann die Kamera instabil machen und die Leistung beeinträchtigen. Ein auf einen Feature-Knoten geschriebener Wert geht verloren, wenn die Kamera erneut verbunden wird; eine Feature-Datei, die in cameras[].featureFiles des Moduls aufgeführt ist, wird bei jedem Verbinden der Kamera angewendet.

GenICam-Features, Für die höchste Bildrate: TriggerOverlap, Release Notes: v2.0.0

Fügen Sie dem Abschnitt system von lumiscan-cam-driver.json einen Block storage hinzu, und starten Sie die Anwendung neu. Ohne ihn tut Save nichts.

Speichereinstellungen, Bilddateien speichern

Beide führen zum selben Ergebnis. Ab v2.1.0 können capture, save, load, remove und list-images mit einem Schreibvorgang auf <camera name>/control/<operation>/execute gestartet werden, der zurückkehrt, wenn die Operation abgeschlossen ist; ab v2.3.0 wird trigger nur als execute-Methode angeboten. connect-camera, disconnect-camera und reset haben keinen execute-Knoten und müssen den Handshake verwenden. Es darf immer nur ein Prozess request schreiben, und in beiden Fällen prüfen Sie danach control/status/code und control/status/text. Handshake-Schritte:

Eine Methode ausführen, Wann eine Funktionalität läuft, Handshake

Das Bild wird auf hdvisionsystems/lumiscan-cam-driver/<camera name>/output/image zusammen mit Breite, Höhe und Pixeltyp veröffentlicht, unabhängig davon, wie das Capture gestartet wurde. Das sind Sensor-Rohdaten, die die meisten Bildbetrachter nicht anzeigen können. Ab v2.1.0 schalten Sie <camera id>/input/preview/enable ein, um nach jedem erfolgreichen Capture oder Load ein PNG auf <camera id>/output/preview/encoded-data zu erhalten; <camera id>/input/preview/scale (0.0 bis 1.0) verkleinert es. Vergleichen Sie output/package-identifier, um zu prüfen, ob die Vorschau zum neuesten Bild gehört. Um jedes Bild zu erhalten, das die Kamera liefert, verwenden Sie den experimentellen Bild-Stream auf <camera name>/control/publish/output/stream/frame (ab v2.3.0).

Beschreibung, Bilder streamen (experimentell), Release Notes: v2.1.0

Geben Sie der Kamera eine serial, die simulation enthält (zum Beispiel simulation); das Modul sucht dann keine echte Kamera und verbindet sich mit keiner. Ob eine Kamera simuliert wird, hängt von ihrer Seriennummer ab, nicht von ihrer id. Ein Aufruf von Capture lädt ein Bild aus dem konfigurierten Speicherordner und springt für das nächste Capture zum nächsten Bild. Seit v2.0.0 werden die Bilder aus images/<camera id> statt aus images genommen (verschieben Sie vorhandene Bilder vor dem Update), und der Ordner wird beim Verbinden eingelesen, sodass ein Aufruf von list-images nicht nötig ist. Ab v2.2.0 verwendet unifiedStorage auf true den Speicherordner direkt.

Bilder laden, Beispielinhalt einer Kameradatei, Release Notes: v2.0.0

Verwenden Sie ab v2.3.0 den experimentellen Bild-Stream. Verbinden Sie die Kamera, setzen Sie ihre Features (für die höchste Bildrate TriggerOverlap nicht Off), abonnieren Sie <camera name>/control/publish/output/stream/frame, setzen Sie control/publish/input/enable auf true und rufen Sie control/publish/execute auf. Der Cam Driver triggert die Kamera nicht von selbst: Bilder kommen bei einem Hardware-Trigger, bei control/trigger/execute oder kontinuierlich bei ausgeschaltetem Trigger-Modus. Solange der Stream läuft, ist capture nicht verfügbar; nach dem Stoppen des Streams wird die Kamera erneut verbunden, was bei der von uns getesteten Kamera etwa zwei Sekunden dauert.

Einen Stream betreiben, Streams

Ab v2.0.0 benötigt der Cam Driver die Lizenz SWL-W-XCx-CAMDRIVERxHDVSx-V2NN; Schlüssel der Version 1 funktionieren nicht. Sie benötigen eine Lizenz pro verbundener Kamera. Auf ctrlX OS (ctrlX CORE oder IPC) ist eine im ctrlX Store gekaufte Lizenz eine ctrlX-Lizenz und benötigt keinen LumiScan Key. Zu anderen Bezugswegen siehe die FAQ zur Lizenzierung.

Voraussetzungen, FAQ zur Lizenzierung

Siehe die LumiScan-FAQ der gesamten Dokumentation und für Fragen zum Data Layer selbst die FAQ zum Data Layer. Kontaktieren Sie den Customer Success von HD Vision Systems unter customer.success@hdvisionsystems.com oder +49 6221 6721905; für Lizenzen licenses@hdvisionsystems.com.

FAQ zur Lizenzierung