Fehlerbehebung

Beginnen Sie mit den Allgemeine Prüfungen: Sie helfen bei jedem Problem mit LumiScan Cockpit. Suchen Sie dann Ihr Symptom in den folgenden Abschnitten und arbeiten Sie dessen Schritte der Reihe nach ab. Der letzte Abschnitt nennt, was Sie an den Support senden, wenn das Problem weiterhin besteht.

Allgemeine Prüfungen

Prüfen Sie zuerst diese Punkte:

  • Die Anwendungen laufen auf demselben Gerät. Das Cockpit zeigt die Daten anderer Anwendungen an: Die Anwendungen, deren Bilder und Ergebnisse es zeichnet, müssen auf derselben ctrlX CORE, demselben ctrlX IPC oder demselben PC laufen. Für sich allein zeigt das Cockpit eine leere Übersicht. Siehe Voraussetzungen.

  • Die Anwendungsübersicht. Sie führt alle kompatiblen Anwendungen von HD Vision Systems auf, die gerade laufen, und die Ansichten, die jede von ihnen bietet. Siehe Das Cockpit öffnen.

  • Auf einem PC: dieselbe Broker-Adresse. Das Cockpit und die Anwendungen müssen dieselbe Adresse verwenden. Ohne Optionen tun sie das alle; eine mit --keryx-url übergebene Adresse muss jeder von ihnen übergeben werden. Ist LumiScan Keryx installiert, zeigt die Data-Layer-Seite http://127.0.0.1:7555/ den Baum. Siehe Broker, Fenster und Seiten (PC).

  • Die Einstellungsdatei wird einmal, beim Start, gelesen. Nur die Einstellungen der Live-Ansicht, die im Einstellungsfenster geändert werden, gelten sofort. Siehe Overlays.

  • Das Log.

    Plattform Log

    ctrlX OS

    das Systemprotokoll von ctrlX OS: das Logbuch der ctrlX-Weboberfläche oder journalctl. Siehe ctrlX Data Layer auf ctrlX OS

    Windows

    %LOCALAPPDATA%\LumiScan Cockpit\logs\lumiscan-cockpit.log. Aus einer Konsole als lumiscan-cockpit gestartet, schreibt das Cockpit sein Log auch in diese Konsole

Das Cockpit öffnen

Problem: Auf ctrlX OS beendet sich das Cockpit kurz nach dem Start

Symptome

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

Mögliche Ursachen
  • Die Lizenz fehlt. Die ctrlX-Lizenz für LumiScan Cockpit ist SWL-W-XCx-COCKPITxxxHDVSx-V1NN.

Diagnose
  1. Lesen Sie das Systemprotokoll von ctrlX OS - erwartet: Es nennt den Grund, warum sich die Anwendung beendet hat.

  2. Prüfen Sie die Seitenleiste der ctrlX-Weboberfläche - erwartet: der Link LumiScan Cockpit. Die Anwendung fügt ihn hinzu, wenn sie installiert ist und läuft.

Lösung
  • Wenn die Lizenz fehlt: Aktivieren Sie die ctrlX-Lizenz SWL-W-XCx-COCKPITxxxHDVSx-V1NN auf dem Gerät und starten Sie die Anwendung dann erneut. Siehe Lizenz und LumiScan Lizenzierung.

Wenn das Problem weiterhin besteht

Senden Sie die unter Informationen für den Support genannten Informationen an den Support, zusammen mit den Zeilen des Systemprotokolls, die den Grund nennen.

Problem: Auf einem PC meldet das Cockpit, dass sein Port belegt ist, und beendet sich

Symptome

Auf einem PC zeigt das Cockpit eine Meldung, dass sein Port belegt ist, und beendet sich.

Mögliche Ursachen
  • Das Cockpit liefert seine Seiten auf Port 8000 aus. Ein anderes Programm verwendet diesen Port bereits.

  • Ein mit --no-gui gestartetes Cockpit verwendet diesen Port bereits.

Diagnose
  1. Prüfen Sie, ob ein mit --no-gui gestartetes Cockpit läuft - erwartet: keines, wenn Sie das Cockpit mit seinem Fenster starten wollen.

  2. Prüfen Sie, ob ein anderes Programm Port 8000 verwendet.

Lösung
  • Wenn ein anderes Programm oder ein mit --no-gui gestartetes Cockpit den Port verwendet: Beenden Sie es und starten Sie das Cockpit dann erneut.

  • Wenn der Port beim anderen Programm bleiben muss: Starten Sie das Cockpit mit --port und einem anderen Port.

Wenn das Problem weiterhin besteht

Senden Sie die unter Informationen für den Support genannten Informationen an den Support, zusammen mit der Meldung des Cockpits und den Optionen, mit denen es gestartet wurde.

Problem: Unter Windows öffnet sich das Cockpit im Browser statt in seinem eigenen Fenster

Symptome

Unter Windows öffnet das Cockpit seine Seiten im Standardbrowser statt in seinem eigenen Fenster und zeigt eine Meldung. Ein Klick auf OK in der Meldung beendet das Cockpit.

Mögliche Ursachen
  • Die Microsoft Edge WebView2 Runtime fehlt. Das Fenster des Cockpits zeigt seine Seiten mit ihr.

Diagnose
  1. Prüfen Sie, ob das Cockpit mit --no-gui gestartet wurde - erwartet: nein, wenn Sie sein Fenster wollen. Mit --no-gui öffnet das Cockpit bestimmungsgemäß kein Fenster.

  2. Prüfen Sie, ob die Microsoft Edge WebView2 Runtime auf dem PC installiert ist.

Lösung
  • Wenn die WebView2 Runtime fehlt: Installieren Sie sie und starten Sie das Cockpit dann erneut. Oder verwenden Sie das Cockpit im Browser.

Wenn das Problem weiterhin besteht

Senden Sie die unter Informationen für den Support genannten Informationen an den Support, zusammen mit der Meldung des Cockpits.

Problem: Die Übersicht zeigt keine Anwendungen

Symptome

Die Anwendungsübersicht führt keine Anwendungen auf.

Mögliche Ursachen
  • Die Anwendungen laufen nicht.

  • Die Anwendungen laufen nicht auf demselben Gerät wie das Cockpit.

  • Auf einem PC: Das Cockpit und die Anwendungen verwenden nicht denselben Broker. Eine mit --keryx-url übergebene Adresse wurde nicht jeder von ihnen übergeben.

  • Auf einem PC: Es wurde kein Broker gestartet. Das passiert bei einer ipc://-Adresse relativ zu dem Ordner, in dem ein Programm gestartet wird, und bei --no-keryx-autostart oder LUMISCAN_KERYX_AUTOSTART=0.

Diagnose
  1. Prüfen Sie, ob die Anwendungen auf demselben Gerät wie das Cockpit laufen.

  2. Vergleichen Sie auf einem PC die Optionen, mit denen das Cockpit und die Anwendungen gestartet wurden - erwartet: dieselbe --keryx-url oder keine.

  3. Öffnen Sie auf einem PC mit LumiScan Keryx die Data-Layer-Seite http://127.0.0.1:7555/ - erwartet: Der Baum zeigt die laufenden Anwendungen.

Lösung
  • Wenn die Anwendungen nicht laufen: Starten Sie sie.

  • Wenn die Anwendungen auf einem anderen Gerät laufen: Betreiben Sie sie auf demselben Gerät wie das Cockpit.

  • Wenn sie unterschiedliche Broker-Adressen verwenden: Übergeben Sie jeder Anwendung, auch dem Cockpit, dieselbe --keryx-url, oder starten Sie alle ohne die Option.

  • Wenn kein Broker gestartet wurde: Starten Sie zuerst selbst krxsystem --backend hdv --url <address>. Bei einer relativen ipc://-Adresse starten Sie den Broker und jede Anwendung aus demselben Ordner.

Wenn das Problem weiterhin besteht

Senden Sie die unter Informationen für den Support genannten Informationen an den Support, zusammen mit den Optionen, mit denen das Cockpit und die Anwendungen gestartet wurden.

Ansichten und Ergebnisse

Problem: Eine Ansicht zeigt eine Meldung statt eines Bildes

Symptome

Eine Ansicht nennt den Grund, warum sie nichts zu zeigen hat, statt einen leeren Frame zu zeigen.

Mögliche Ursachen
Diagnose
  1. Lesen Sie den Grund, den die Ansicht nennt.

  2. Bei einer veröffentlichenden Anwendung: Prüfen Sie, ob sie seit ihrem Start gelaufen ist.

  3. Bei einer der acht Anwendungen, die Funde zeichnen: Lesen Sie die input-image-address des Moduls - erwartet: der Bildknoten einer Kamera.

Lösung
Wenn das Problem weiterhin besteht

Senden Sie die unter Informationen für den Support genannten Informationen an den Support, zusammen mit dem Grund, den die Ansicht nennt, und der input-image-address des Moduls.

Problem: Funde werden nicht gezeichnet, und ein Hinweis nennt die Größe, zu der das Ergebnis gehört

Symptome

Die Ansicht zeigt das Bild ohne Funde, und ein Hinweis nennt die Bildgröße, zu der das Ergebnis gehört.

Mögliche Ursachen
  • Das letzte Ergebnis wurde in einem Kamerabild mit einer anderen Größe als dem angezeigten gefunden, meist weil sich die Kameraauflösung nach dem letzten Lauf geändert hat.

Diagnose
  1. Vergleichen Sie die Größe im Hinweis mit der aktuellen Kameraauflösung - erwartet: Sie unterscheiden sich.

Lösung
  • Wenn sich die Kameraauflösung nach dem letzten Lauf geändert hat: Führen Sie die Anwendung erneut aus, um das Ergebnis für die neue Auflösung zu erneuern.

Wenn das Problem weiterhin besteht

Senden Sie die unter Informationen für den Support genannten Informationen an den Support, zusammen mit der Größe aus dem Hinweis und der Kameraauflösung.

Problem: Eine Ansicht von AI Object Matching auf einem Stream zeigt approximate

Symptome

Die Live-Ansicht eines Moduls von AI Object Matching zeigt den Hinweis approximate. Während sich die Szene bewegt, kann eine Box etwas versetzt sein.

Mögliche Ursachen
  • Das Modul hat für die Inferenz länger gebraucht, als das Cockpit die letzten Frames der Kamera (64 MB) vorhält. Der Frame, in dem das Ergebnis gefunden wurde, wird nicht mehr vorgehalten; die Boxen werden daher auf den neuesten Frame gezeichnet.

Diagnose
  1. Prüfen Sie, ob das Modul auf dem Bild-Stream einer Kamera inferiert - erwartet: Seine control/subscribe/output/stream/active ist true. Der Hinweis erscheint nur in einer solchen Live-Ansicht.

Lösung
  • Wenn der Frame nicht mehr vorgehalten wird: Es ist nichts zu tun. Die Boxen werden auf den neuesten Frame gezeichnet und mit approximate markiert. Kommt ein Ergebnis rechtzeitig, werden seine Boxen auf genau den Frame gezeichnet, in dem es gefunden wurde.

Wenn das Problem weiterhin besteht

Wenden Sie sich mit den unter Informationen für den Support genannten Informationen an den Support, wenn etwas versetzte Boxen für Ihre Anwendung ein Problem sind.

Live-Aktualisierung

Problem: Eine Ansicht aktualisiert sich nur alle zwei Sekunden

Symptome

Eine Ansicht zeigt nur alle zwei Sekunden ein neues Bild.

Mögliche Ursachen
  • Mehr als acht Ansichten streamen gleichzeitig, Einzelbilder oder live. Darüber hinaus fällt eine Ansicht darauf zurück, ihr Bild alle zwei Sekunden neu zu holen.

  • Die Verbindung über einen Proxy erlaubt kein Streaming.

Diagnose
  1. Zählen Sie die geöffneten Ansichten - erwartet: acht oder weniger.

  2. Prüfen Sie, ob der Browser das Cockpit über einen Proxy erreicht.

Lösung
  • Wenn mehr als acht Ansichten geöffnet sind: Schließen Sie Ansichten, die Sie nicht brauchen.

  • Wenn ein Proxy kein Streaming erlaubt: Die Ansicht holt ihr Bild weiterhin alle zwei Sekunden neu. Das Bild bleibt korrekt; es kommt nur später an.

Wenn das Problem weiterhin besteht

Senden Sie die unter Informationen für den Support genannten Informationen an den Support, zusammen mit der Anzahl der geöffneten Ansichten und der Angabe, ob ein Proxy verwendet wird.

Problem: Eine Kamera streamt, aber ihre Ansicht zeigt Einzelbilder statt LIVE

Symptome

Die Kamera streamt ihre Bilder, aber ihre Ansicht zeigt Einzelbilder, und LIVE erscheint nicht neben dem Namen der Ansicht.

Mögliche Ursachen
  • Mehr als vier Live-Ansichten sind gleichzeitig offen, jeden Tab und jedes Fenster mitgezählt. Darüber hinaus zeigt eine Live-Ansicht Einzelbilder und versucht es alle fünf Sekunden erneut.

  • Der Stream wurde nicht mit control/publish/execute von LumiScan Cam Driver gestartet. Erst dann wird eine Ansicht live. Die Ansicht eines Moduls von AI Object Matching wird live, wenn das Modul auf Kamera-Streams inferiert.

  • Auf ctrlX OS: Die ctrlX-Weboberfläche reicht die Live-Ansicht nicht durch. Ob sie das tut, wurde noch nicht auf einem Gerät geprüft.

Diagnose
  1. Zählen Sie die Live-Ansichten, die in allen Tabs und Fenstern offen sind - erwartet: vier oder weniger.

  2. Lesen Sie an der Kamera control/publish/output/stream/active von LumiScan Cam Driver - erwartet: true. Siehe Der Produzent: der Cam Driver.

Lösung
  • Wenn mehr als vier Live-Ansichten offen sind: Schließen Sie Live-Ansichten, die Sie nicht brauchen. Die Ansicht versucht es alle fünf Sekunden erneut.

  • Wenn der Stream nicht gestartet wurde: Starten Sie ihn mit control/publish/execute des Cam Driver. Siehe das Handbuch des Cam Driver, „Bilder streamen".

  • Wenn die ctrlX-Weboberfläche die Live-Ansicht nicht durchreicht: Die Ansicht zeigt Einzelbilder. Das Bild bleibt korrekt; es kommt nur später an.

Siehe Live-Ansicht.

Wenn das Problem weiterhin besteht

Senden Sie die unter Informationen für den Support genannten Informationen an den Support, zusammen mit der Anzahl der offenen Live-Ansichten und dem Wert von control/publish/output/stream/active.

Overlays

Problem: Eine Overlay-Änderung hat keine Wirkung, oder eine Form wird weiß gezeichnet

Symptome

Nachdem Sie die Einstellungsdatei des Cockpits bearbeitet haben, ändert sich das Overlay nicht; oder eine Form wird weiß statt in ihrer Farbe gezeichnet.

Mögliche Ursachen
  • Das Cockpit wurde seit der Änderung nicht neu gestartet. Die Einstellungsdatei wird nur einmal, beim Start, gelesen.

  • Der Wert von color kann nicht gelesen werden. Eine Farbe, die nicht gelesen werden kann, wird weiß gezeichnet statt abgelehnt.

  • Eine Position oder Größe von 1.0 oder darüber ist in absoluten Pixeln angegeben: 1.0 ist ein Pixel, nicht der gegenüberliegende Rand oder die volle Breite.

Diagnose
  1. Prüfen Sie, ob das Cockpit nach dem Bearbeiten der Datei neu gestartet wurde.

  2. Prüfen Sie den Wert von color jeder weißen Form - erwartet: red, green, blue, black, white, yellow, cyan, magenta oder sechs Hexadezimalziffern RRGGBB (das darf entfallen).

  3. Prüfen Sie centerX, centerY, width und height - erwartet: Werte unter 1.0, wo Sie relative Werte meinen.

Lösung
  • Wenn das Cockpit nicht neu gestartet wurde: Starten Sie die Anwendung Cockpit neu.

  • Wenn die Farbe nicht gelesen werden kann: Korrigieren Sie den Tippfehler im Wert von color und starten Sie das Cockpit dann neu.

  • Wenn ein Wert von 1.0 als gegenüberliegender Rand oder volle Breite gemeint war: Verwenden Sie einen Wert knapp unter 1.0 und starten Sie das Cockpit dann neu.

Siehe Overlays.

Wenn das Problem weiterhin besteht

Senden Sie die unter Informationen für den Support genannten Informationen an den Support, zusammen mit der Einstellungsdatei des Cockpits.

Informationen für den Support

Wenden Sie sich an den Customer Success von HD Vision Systems unter customer.success@hdvisionsystems.com oder +49 6221 6721905; für Lizenzen an licenses@hdvisionsystems.com. Senden Sie bitte:

  • die Version von LumiScan Cockpit;

  • die Plattform: ctrlX OS mit seiner Version auf einer ctrlX CORE oder einem ctrlX IPC, oder einen PC und sein Betriebssystem;

  • Datum und Uhrzeit des Fehlers;

  • das Log: auf ctrlX OS aus dem Systemprotokoll (Logbuch der ctrlX-Weboberfläche oder journalctl); unter Windows %LOCALAPPDATA%\LumiScan Cockpit\logs\lumiscan-cockpit.log;

  • den Kommunikationsstatus: die Anwendungen und Ansichten, die die Übersicht aufführt, und auf einem PC die Data-Layer-Adresse (--keryx-url), die dem Cockpit und den Anwendungen übergeben wurde;

  • die Meldung oder den Hinweis, den die Ansicht zeigt;

  • die Konfiguration: die Einstellungsdatei des Cockpits (lumiscan-cockpit.json auf einem PC) und auf einem PC die Optionen, mit denen das Cockpit gestartet wurde.