Fehlerbehebung

Die App-Konfiguration (lumiscan-cam-driver.json) legt fest, welche Kameramodule geladen werden.

Jede Kamerakonfiguration (zum Beispiel camera_example.json) steht für eine Kamera.

Ein fehlgeschlagenes capture über den Handshake endet bei Status 3 (waitingForClient), nicht bei seinem eigenen Fehlercode. control/capture/execute behält den eigenen Code des Capture. Siehe Wann eine Funktionalität läuft.

Ein fehlgeschlagenes capture, reset, save oder load wird gespeichert: Sein Status bleibt, bis ein reset erfolgreich ist. Jeder andere Fehler bleibt nur etwa 100 ms auf control/status/code stehen.

Prüfen Sie mit <camera name>/device-info/is-connected, ob eine Kamera verbunden ist, nicht mit dem Status.

ctrlX OS: das Systemprotokoll von ctrlX OS. Lesen Sie es im Logbuch der ctrlX-Weboberfläche oder mit journalctl. Siehe ctrlX Data Layer auf ctrlX OS.

PC: die Ausgabe des Cam Driver in seiner Konsole.

Die Kamerakonfiguration fehlt, ist ungültig oder in lumiscan-cam-driver.json nicht korrekt referenziert. Das Kameramodul wird dann nicht geladen.

Die id des Moduls enthält andere Zeichen als Kleinbuchstaben, Ziffern, - und _.

Die Datei wurde geändert, aber die Anwendung wurde nicht neu gestartet. Der Cam Driver liest seine Dateien nur beim Start.

Die gesamte Anwendung fehlt im Data Layer, zum Beispiel weil die Lizenz fehlt (ctrlX OS) oder die Anwendung einen anderen Broker verwendet (PC).

Wenn die Kamerakonfiguration fehlt, ungültig oder nicht referenziert ist: Korrigieren Sie die App-Konfiguration und die Kamerakonfiguration so, dass sie korrekt aufeinander verweisen.

Wenn die id ungültige Zeichen enthält: Schreiben Sie die ID, die das Protokoll nennt (zum Beispiel Camera1 → camera1), und starten Sie dann die Anwendung neu. Siehe Beispielinhalt einer Kameradatei.

Wenn die Anwendung im Data Layer fehlt: Auf ctrlX OS siehe Problem: "No valid license found, please purchase one. If you do have one, please try to restart ctrlX". Für einen PC und für andere Ursachen im Data Layer siehe Eine App oder ein Modul fehlt im Baum.

control/status/code ist auf jedem Modul -5 (restartRequired).

hdvisionsystems/lumiscan-cam-driver/system/restart-required ist true.

Jede execute-Methode eines Moduls antwortet mit DL_RESOURCE_UNAVAILABLE (ResourceUnavailable bei LumiScan Keryx), und die ready-Signale sind false.

Ein laufender Bild-Stream stoppt.

Die Einstellungen wurden auf dem Data Layer geändert (system/settings, activate-module, deactivate-module). Bis zum nächsten Start läuft die Anwendung mit Einstellungen, die nicht mehr die ihrer Dateien sind.

Eine geänderte Datei konnte nicht gespeichert werden: Der Schreibvorgang antwortete mit DL_CREATION_FAILED. Zuvor geänderte Dateien bleiben geändert, die Anwendung erfordert also trotzdem einen Neustart.

Wenn die Einstellungen auf dem Data Layer geändert wurden:

Wenn ein Schreibvorgang mit DL_CREATION_FAILED antwortete: Korrigieren Sie die Dateien, und starten Sie die Anwendung dann wie oben neu.

control/status/code ist -4 (missingLicense) mit dem Text No valid license found, please purchase one. If you do have one, please try to restart ctrlX.

Auf ctrlX OS beendet sich die Anwendung kurz nach dem Start.

Ab v2.2.0 protokolliert die Anwendung eine Warnung und beendet sich, wenn eine Lizenz verloren geht.

Es ist keine gültige Lizenz installiert, oder nicht genug für die konfigurierten Kameras: Sie benötigen eine Lizenz pro angeschlossener Kamera.

Ein Schlüssel der Version 1 ist installiert. Ab v2.0.0 benötigt der Cam Driver die Lizenz SWL-W-XCx-CAMDRIVERxHDVSx-V2NN.

Bis einschließlich v2.1.0: Die Lizenzen wurden getrennt installiert. Nur der erste Eintrag Cam Driver V2 wird gelesen.

Wenn keine oder nicht genug Lizenzen installiert sind: Installieren Sie eine Lizenz SWL-W-XCx-CAMDRIVERxHDVSx-V2NN pro angeschlossener Kamera. Siehe Voraussetzungen.

Wenn ein Schlüssel der Version 1 installiert ist: Ersetzen Sie ihn durch eine V2-Lizenz. Schlüssel der Version 1 funktionieren ab v2.0.0 nicht.

Wenn die Lizenzen getrennt installiert wurden (v2.1.0 und älter): Installieren Sie alle Lizenzen gemeinsam, sodass die Seite Licenses einen Eintrag Cam Driver V2 zeigt, der alle Kameras abdeckt, oder aktualisieren Sie auf v2.2.0, das auch getrennt installierte Lizenzen unterstützt.

Zu anderen Bezugswegen und Lizenzproblemen siehe die FAQ zur Lizenzierung und die Fehlerbehebung Lizenzierung.

Die Kamera ist nicht mit der ctrlX CORE oder dem PC verbunden, oder (ctrlX OS) nicht mit einem unterstützten ctrlX-Port.

Die Kamera wird nicht mit Strom versorgt, weder extern noch über PoE.

Die IP-Adressen der ctrlX CORE bzw. des PCs und der Kamera sind nicht korrekt konfiguriert: Die Kamera-IP muss im selben lokalen Netzwerk liegen.

Es gibt doppelte IP-Adressen im Netzwerk.

Wenn die Kamera nicht verbunden oder nicht versorgt ist: Verbinden Sie sie mit der ctrlX CORE oder dem PC (auf ctrlX OS mit einem unterstützten ctrlX-Port), und versorgen Sie sie mit Strom. Für eine ctrlX CORE X3 siehe Hardware-Aufbau für ctrlX X3.

Wenn die IP-Adresse falsch ist: Setzen Sie sie mit der Funktion force-ip unter hdvisionsystems/lumiscan-cam-driver/system/force-ip/. Sie funktioniert auch, wenn das Subnetz der Kamera nicht zu dem der ctrlX CORE oder des PCs passt, solange die Kamera über dieselbe Netzwerkverbindung erreichbar ist. Siehe Kamera-IP-Adresse einrichten.

Wenn es doppelte IP-Adressen gibt: Geben Sie jedem Gerät eine eindeutige IP-Adresse. Auf einer ctrlX CORE X3 verwendet XF10 192.168.1.1: Weisen Sie diese Adresse weder der Kamera noch dem Computer zu.

Nach dem Handshake connect-camera bleibt /hdvisionsystems/lumiscan-cam-driver/<module>/device-info/is-connected false.

control/status/code zeigt -10000 (failedToConnectToCamera) nur etwa 100 ms lang, dann wieder 0, während die Kamera weiterhin nicht verbunden ist.

Die Kamera wird nicht erkannt, siehe Problem: Eine physisch angeschlossene Kamera wird nicht erkannt.

Die Kamera wurde abgezogen und wieder angeschlossen.

Die Ethernet-Konfiguration, etwa Puffergrößen und Jumbo Frames, passt nicht zu den Kameraspezifikationen.

Ein PC am selben Switch greift gleichzeitig auf die Kamera zu. Paralleler Zugriff kann die Kamerakommunikation stören.

Mehr als ein Prozess schreibt connect-camera/request, sodass die Anwendung den Request verpasst.

Wenn die Kamera nicht erkannt wird: Folgen Sie Problem: Eine physisch angeschlossene Kamera wird nicht erkannt.

Wenn die Kamera abgezogen und wieder angeschlossen wurde (ab v2.1.0): Führen Sie den Handshake reset aus, der failedToConnectToCamera meldet, bis er erfolgreich ist, und dann connect-camera. connect-camera hat keine execute-Methode: Verwenden Sie den Handshake auf /hdvisionsystems/lumiscan-cam-driver/<module>/control/connect-camera/request. Siehe Verbindungsschritte.

Wenn die Verbindung weiterhin fehlschlägt:

Wenn ein PC gleichzeitig auf die Kamera zugreift: Beenden Sie diesen Zugriff.

Wenn die Anwendung den Request nicht erkennt: Stellen Sie sicher, dass immer nur ein Prozess auf connect-camera/request zugreift und dass Sie dieselbe Data-Layer-Version wie die Kameraanwendung verwenden.

capture/execute hinterlässt control/status/code bei -10004 (couldNotCaptureImage).

Über den Handshake endet ein fehlgeschlagenes Capture bei Status 3, und capture/ready bleibt false, bis ein reset erfolgreich ist.

Bilder lassen sich nicht zuverlässig auslösen.

Die Kamera ist getrennt.

Die Kommunikation schlägt wegen schlechter Verbindungsqualität fehl.

Die MTU-Größe des Ethernet-Ports (ctrlX OS) oder des Netzwerkadapters (PC) ist zu klein.

Eine Netzwerkkomponente unterstützt den erforderlichen Datendurchsatz nicht.

Wenn die Kamera getrennt ist: Verbinden Sie sie erneut. Ein fehlgeschlagenes Capture wird gespeichert: Führen Sie reset und dann connect-camera mit dem Handshake aus.

Wenn die Verbindungsqualität schlecht ist: Verwenden Sie ein "Foil Shielded Twisted Pair"-Kabel.

Wenn die MTU-Größe zu klein ist: Setzen Sie sie auf 8000 oder 9000. Kann der Port auf ctrlX OS die MTU-Größe nicht ändern, verwenden Sie einen Ethernet-Port, der große MTU-Größen unterstützt. Siehe MTU-Größe ändern.

Wenn die Netzwerkbandbreite nicht ausreicht: Stellen Sie sicher, dass alle Netzwerkkomponenten den erforderlichen Datendurchsatz unterstützen. Testen Sie auf einer ctrlX CORE X3 verschiedene Werte für das Packet Delay, bis die Bildaufnahme stabil ist, siehe Kameraeinrichtung abschließen. Kameraparameter können mit der Software des Herstellers, über die Feature-Knoten der Kamera unter /hdvisionsystems/lumiscan-cam-driver/<module>/features oder in einer Feature-Datei angepasst werden, die in cameras[].featureFiles des Moduls aufgeführt ist. Siehe GenICam-Features.

Die Kamera ist gerade mit einer anderen Operation belegt.

Der Bild-Stream startet oder stoppt gerade. Nach dem Stoppen des Streams wird die Kamera erneut verbunden; bis dahin antwortet capture/execute mit DL_TOO_MANY_OPERATIONS.

Wenn die Kamera belegt ist: Wiederholen Sie den Aufruf. Ein abgelehnter Schreibvorgang wird nie in eine Warteschlange gestellt; derselbe Schreibvorgang gelingt, sobald die laufende Operation abgeschlossen ist.

Wenn der Stream startet oder stoppt: Warten Sie, bis capture/ready true ist. Das dauert bei der von uns getesteten Kamera etwa zwei Sekunden.

Ein Schreibvorgang auf <camera name>/control/<operation>/execute antwortet mit DL_INVALID_OPERATION_MODE (ctrlX Data Layer) oder InvalidOperationMode (LumiScan Keryx). Das gilt für v2.2.0 und neuer; frühere Versionen meldeten diesen Fall als DL_TOO_MANY_OPERATIONS.

capture/execute wird immer wieder abgelehnt, auch nachdem die Kamera einmal aufgenommen hat.

capture: Die Kamera ist nicht verbunden, ein Capture-Fehler ist gespeichert (nach einem fehlgeschlagenen Capture), oder der Bild-Stream läuft.

save: Es ist noch kein Bild verfügbar.

load, remove: <camera name>/output/image-files ist leer.

trigger: Die Kamera ist nicht verbunden.

Wenn die Kamera nicht verbunden ist oder ein Capture-Fehler gespeichert ist: Führen Sie reset und dann connect-camera mit dem Handshake aus (reset gibt eine getrennte Kamera zurück). Beide haben keine execute-Methode; ein Programm, das nur execute verwendet, muss sich daher über den Handshake verbinden und einen gespeicherten Fehler darüber beheben.

Wenn der Bild-Stream läuft: Stoppen Sie ihn und warten Sie, bis capture/ready true ist, siehe Problem: Capture wird abgelehnt, während der Bild-Stream läuft.

Wenn für save kein Bild verfügbar ist: Nehmen Sie zuerst ein Bild auf oder laden Sie eines.

Wenn output/image-files leer ist: Führen Sie zuerst list-images aus oder speichern Sie ein Bild.

control/status/code ist -10006 (saveImageFailed) oder -10005 (noImageTaken).

Save tut nichts, oder im Speicherordner liegt kein Bild.

noImageTaken: Es wurde noch kein Bild aufgenommen.

saveImageFailed: Der Speicher kann nicht beschrieben werden - ip, username oder password in den Speichereinstellungen sind falsch, die IP ist von der ctrlX CORE oder dem PC aus nicht erreichbar, oder der freigegebene Ordner hat nicht genügend freien Speicherplatz.

Der Speicher ist nicht oder falsch konfiguriert: Ohne einen Block storage im Abschnitt system von lumiscan-cam-driver.json tut Save nichts.

(ctrlX OS) Das USB-Speichergerät oder die SD-Karte ist nicht eingebunden oder verwendet weder FAT32 noch EXT4.

Wenn kein Bild aufgenommen wurde (noImageTaken): Nehmen Sie vor dem Speichern ein Bild auf.

Wenn der Speicher nicht beschrieben werden kann (saveImageFailed): Korrigieren Sie ip, username und password, machen Sie die IP erreichbar, oder schaffen Sie freien Speicherplatz im freigegebenen Ordner.

Wenn der Speicher nicht oder falsch konfiguriert ist:

Wenn das USB-Speichergerät oder die SD-Karte nicht eingebunden ist (ctrlX OS): Binden Sie es unter Settings > Storage Devices mit For data exchange ein, und beginnen Sie rootPath mit dem dort angezeigten Pfad.

Die Kameraeinstellungen werden nicht korrekt gespeichert oder angewendet.

Ein Wert wurde auf einen Feature-Knoten unter features geschrieben. Ein solcher Wert geht verloren, wenn die Kamera erneut verbunden wird.

Die Belichtungszeit auf input/exposure-time und das Inter-Packet-Delay werden nicht angewendet, solange der Bild-Stream läuft.

Wenn die Einstellungen nicht gespeichert oder angewendet werden: Wenn die Kamera es unterstützt, exportieren Sie die Kamerakonfiguration, zum Beispiel im GenICam-Format, und importieren Sie sie in LumiScan, um die Einstellungen konsistent zu halten.

Wenn ein auf einen Feature-Knoten geschriebener Wert verloren ging: Tragen Sie das Feature in eine Feature-Datei ein, die in cameras[].featureFiles des Moduls aufgeführt ist. Siehe GenICam-Features.

Wenn der Bild-Stream läuft: Stoppen Sie den Stream, ändern Sie die Kamera-Features, und starten Sie den Stream dann erneut.

control/capture/execute antwortet mit DL_INVALID_OPERATION_MODE, solange der Stream läuft, und mit DL_TOO_MANY_OPERATIONS, während der Stream startet oder stoppt.

Ein Capture-Request über den Handshake endet mit Status -3 (invalidInput) und dem Text capture refused: the image stream (experimental) is active.

control/capture/ready ist false.

Der experimentelle Bild-Stream läuft. Der Stream und capture nutzen die Kamera auf unterschiedliche Weise und laufen daher nie gleichzeitig.

Der Stream wurde gerade gestoppt, und die Kamera wird erneut verbunden.

Wenn Sie ein Capture benötigen: Stoppen Sie den Stream. Ein reset ist nicht nötig: Die Ablehnung speichert keinen Fehler.

Wenn Sie während des Streamings einzelne Bilder benötigen: Nehmen Sie sie aus control/publish/output/stream/frame, statt den Stream zu stoppen, oder wenden Sie keep-latest-output an und lesen Sie output/image, wenn sich output/package-identifier ändert.

Der Stream läuft nicht: Die Eingaben wurden geschrieben, aber control/publish/execute wurde nicht aufgerufen; der Stream konnte nicht starten; oder der Cam Driver wurde neu gestartet - nach einem Start ist der Stream aus.

frames bleibt bei 0: Der Cam Driver triggert die Kamera nicht von selbst.

frames wächst langsamer als die Zahl der gesendeten Trigger: Die Kamera ignoriert Trigger, die schneller kommen, als sie Bilder aufnehmen kann.

lost-frames oder incomplete-frames wachsen: Bilder gingen im Netzwerk verloren.

published-frames entspricht frames, aber Ihr Programm erhält weniger: Ihr Abonnent fällt weit zurück, und der Data Layer verwirft Bilder.

Wenn der Stream nicht läuft: Verbinden Sie die Kamera, setzen Sie control/publish/input/enable auf true und rufen Sie control/publish/execute auf. Tun Sie das nach jedem Start des Cam Driver. Bleibt control/publish/output/stream/active false, steht der Grund im Protokoll; der Start wird erst wieder versucht, wenn control/publish/execute erneut aufgerufen wird. Siehe Einen Stream betreiben.

Wenn frames bei 0 bleibt: Triggern Sie die Kamera per Hardware oder mit control/trigger/execute, oder schalten Sie ihren Trigger-Modus aus. Siehe Die Kamera triggern.

Wenn frames langsamer wächst als die Trigger: Triggern Sie seltener, verkürzen Sie die Belichtung, oder setzen Sie TriggerOverlap der Kamera in einer Feature-Datei auf einen Overlap, den sie unterstützt, etwa PreviousFrame. Siehe Für die höchste Bildrate: TriggerOverlap.

Wenn lost-frames oder incomplete-frames wachsen: Prüfen Sie das Netzwerk wie in Problem: Die Bildaufnahme schlägt fehl oder ist unzuverlässig (Status -10004 "couldNotCaptureImage") beschrieben.

Wenn Ihr Programm weniger Bilder erhält als published-frames: Stellen Sie sicher, dass Ihr Abonnent jedes Bild schnell verarbeitet.