Fehlerbehebung

Eine andere Operation desselben Moduls lief noch. Ein zweiter Aufruf wird nicht in eine Warteschlange gestellt; er kehrt sofort zurück und tut nichts.

Der Bild-Stream des Moduls durchsucht gerade ein Bild. Der Stream und find-template laufen auf einem Modul nie gleichzeitig.

Wenn eine andere Operation noch lief: Warten Sie, bis das laufende execute zurückkehrt, und rufen Sie die Methode dann erneut auf. Die Sperre gilt pro Modul, andere Module werden also nicht aufgehalten.

Wenn der Stream des Moduls läuft:

Wenn system/remove-module mit belegt antwortet: Stoppen Sie zuerst den Stream des Moduls. Das Entfernen eines Moduls stoppt seinen Stream.

Eine erforderliche Eingabe ist leer: input/input-image-address oder input/template-name.

Der Matching-Modus ist falsch geschrieben. input/match-mode akzeptiert TM_SQDIFF, TM_SQDIFF_NORMED, TM_CCORR, TM_CCORR_NORMED, TM_CCOEFF und TM_CCOEFF_NORMED.

Ein Suchparameter liegt außerhalb des zulässigen Bereichs, zum Beispiel input/scale/min-scale oder input/rotation/step-rot nicht größer als 0 oder eine Drehung außerhalb von 0 bis 360.

Die Bildadresse zeigt auf diese Anwendung selbst.

Ein Ordner- oder Dateiname ist ein absoluter Pfad, etwa /tmp/templates, oder ein Pfad, der aus dem Konfigurationsverzeichnis hinausführt, etwa ../../etc.

Wenn eine erforderliche Eingabe leer ist: Setzen Sie sie. input/template-name nimmt einen Eintrag von system/templates.

Wenn der Matching-Modus falsch geschrieben ist: Schreiben Sie einen der akzeptierten Namen auf input/match-mode.

Wenn ein Suchparameter außerhalb des Bereichs liegt: Korrigieren Sie ihn, siehe Die Suche abstimmen.

Wenn die Bildadresse auf diese Anwendung zeigt: Setzen Sie input/input-image-address auf den Bildknoten der Kameraanwendung, zum Beispiel hdvisionsystems/lumiscan-cam-driver/camera1/output/image.

Wenn ein Pfad absolut ist oder das Konfigurationsverzeichnis verlässt: Geben Sie ihn relativ zum Konfigurationsverzeichnis an. Ein Pfad, der innerhalb bleibt, ist auch dann in Ordnung, wenn er .. enthält.

Die Kameraanwendung läuft nicht, oder sie läuft auf einem anderen Gerät.

Die Kameraanwendung hat noch kein Bild aufgenommen.

Die Adresse in input/input-image-address ist falsch.

Der Bildknoten an der Adresse fehlt, ist leer oder inkonsistent.

Das Bild verwendet ein nicht unterstütztes Pixelformat. Unterstützt werden Mono8, Mono12, RGB8, RGB12, BGR8, BGR12, BayerGR8, BayerGR12, BayerRG8 und BayerRG12.

Wenn die Kameraanwendung nicht läuft: Starten Sie sie auf demselben Gerät und nehmen Sie ein Bild auf.

Wenn noch kein Bild aufgenommen wurde: Nehmen Sie in der Kameraanwendung ein Bild auf.

Wenn die Adresse falsch ist: Korrigieren Sie input/input-image-address.

Wenn das Pixelformat nicht unterstützt wird: Verwenden Sie eines der unterstützten Pixelformate, siehe Voraussetzungen.

Die Meldung nennt ein Verzeichnis: Der Vorlagenordner existiert nicht. Der Standardordner templates wird beim Start angelegt; entweder wurde er gelöscht, oder der Ordnername ist falsch.

Die Meldung nennt eine Datei: Der Ordner existiert, enthält aber keine solche Datei.

Die Datei ist vorhanden, wird aber nicht gefunden: Sie liegt in einem anderen Ordner als dem verwendeten. Alle Module teilen sich einen Vorlagenordner.

Wenn der Ordner nicht existiert: Wechseln Sie mit system/set-template-dir zu einem vorhandenen Ordner, oder korrigieren Sie seinen Namen. Der Ordner muss bereits vorhanden sein; er wird nicht für Sie angelegt.

Wenn der Ordner keine solche Datei enthält: Korrigieren Sie die Schreibweise von input/template-name, oder erstellen Sie die Vorlage mit system/create-template.

Wenn die Datei in einem anderen Ordner liegt: Verschieben Sie die Datei in den Ordner, den system/template-dir nennt, oder wechseln Sie mit system/set-template-dir.

Die Region reicht über einen Rand des Bildes hinaus. Eine Region, die über einen Rand hinausreicht, wird abgelehnt und nicht beschnitten.

Bei find-template ist die Region kleiner als die Vorlage. Das wird mit Status -5 abgelehnt.

Bei system/create-template ist input/crop/width oder input/crop/height 0. Beide müssen größer als 0 sein.

Wenn die Region über einen Rand hinausreicht: Korrigieren Sie input/crop/startX, startY, width oder height, sodass die Region in das Bild passt. Eine Breite oder Höhe von null reicht bis zum rechten bzw. unteren Rand.

Wenn die Region kleiner als die Vorlage ist: Vergrößern Sie die Region.

Wenn Breite oder Höhe 0 ist (create-template): Setzen Sie beide auf die Größe der Region, größer als 0.

Eine Datei konnte nicht geschrieben werden - meist ein Berechtigungsproblem oder ein voller Datenträger.

Das Konfigurationsverzeichnis ist nicht beschreibbar. Dasselbe Problem wird beim Start im Protokoll gemeldet.

Wenn das Konfigurationsverzeichnis nicht beschreibbar ist: Machen Sie es für die Anwendung beschreibbar.

Wenn der Datenträger voll ist: Geben Sie auf dem Gerät Speicherplatz frei.

Die Vorlage wurde aus der falschen Region oder dem falschen Bild ausgeschnitten, siehe Problem: Die Vorlage wird nicht einmal in dem Bild gefunden, aus dem sie ausgeschnitten wurde.

Das Teil ist gedreht oder liegt in einem anderen Abstand als in der Vorlage, siehe Problem: Das Teil wird nicht gefunden, wenn es gedreht ist oder in einem anderen Abstand liegt.

input/crop schließt das Teil aus.

Die Vorlage berührt den Bildrand. Eine solche Vorlage kann nahe dem gegenüberliegenden Rand nicht gefunden werden, weil die Vorlage vollständig in das durchsuchte Bild passen muss.

Die Vorlage enthält Hintergrund, der sich von Teil zu Teil ändert; er senkt jeden Score.

Wenn die Vorlage nicht in ihrem eigenen Bild gefunden wird: Folgen Sie Problem: Die Vorlage wird nicht einmal in dem Bild gefunden, aus dem sie ausgeschnitten wurde.

Wenn das Teil gedreht ist oder in einem anderen Abstand liegt: Folgen Sie Problem: Das Teil wird nicht gefunden, wenn es gedreht ist oder in einem anderen Abstand liegt.

Wenn der Ausschnitt das Teil ausschließt: Vergrößern Sie die Region, oder setzen Sie alle vier Werte unter input/crop/ auf 0.

Wenn die Vorlage den Bildrand berührt oder wechselnden Hintergrund enthält: Erstellen Sie die Vorlage erneut aus einer Region, die vom Bildrand Abstand hält, das enthält, was das Teil kennzeichnet, und das ausschließt, was variiert. Siehe Eine Vorlage erstellen.

Wenn das Teil nicht im Bild war: Das Ergebnis ist korrekt; es muss nichts geändert werden.

Die beim Erstellen der Vorlage angegebene Region ist falsch.

Die Bildadresse ist falsch: Die Vorlage wurde aus einem anderen Bild ausgeschnitten als dem durchsuchten. system/create-template/input/input-image-address und <module>/find-template/input/input-image-address sind getrennte Knoten.

Korrigieren Sie input/input-image-address und die Ausschnittsregion, und erstellen Sie die Vorlage dann erneut. Bei einer Suche im selben Bild muss sie genau in der Mitte der angegebenen Region gefunden werden - (195, 250) für eine Region, die bei (100, 200) beginnt und 190 x 100 Pixel groß ist -, mit einer Konfidenz nahe 1.

Die Standardwerte suchen die Vorlage nur in ihrer ursprünglichen Größe und Ausrichtung.

Wenn sich das Teil dreht: Setzen Sie input/rotation/max-rot (zum Beispiel 360) mit einem groben input/rotation/step-rot (zum Beispiel 5).

Wenn sich der Abstand des Teils ändert: Setzen Sie input/scale/min-scale, input/scale/max-scale und input/scale/step-scale (zum Beispiel 0.9, 1.1, 0.05).

Die Konfidenz ist kein absolutes Maß. Die Score-Karte wird für jeden Skalierungs-/Drehungsschritt neu skaliert, sodass die beste Stelle jedes Schritts eine Konfidenz nahe 1 erreicht und input/match-thresh pro Schritt wirkt. Nur Wiederholungen an derselben Stelle werden entfernt; ein schwacher Treffer an einer anderen Stelle kann also weiterhin erscheinen.

Erhöhen Sie input/match-thresh, zum Beispiel auf 0.95, oder verkleinern Sie den Skalierungs- und Drehungsbereich.

Der nächste Durchlauf hat begonnen. Jeder Durchlauf löscht seine eigenen Ausgaben, sobald er beginnt, noch vor allem, was fehlschlagen kann. Wer execute erneut auslöst und dann liest, erhält den neuen Durchlauf - möglicherweise fehlgeschlagen oder noch leer -, nicht den vorherigen.

Ein mit -1 (belegt) abgelehnter Aufruf löscht nichts; wurde der zweite Aufruf abgelehnt, ist das also nicht die Ursache.

Wenn der nächste Durchlauf zu früh begonnen hat: Warten Sie, bis execute zurückkehrt, lesen Sie die Ausgaben, und lösen Sie erst dann den nächsten Durchlauf aus.

Wenn der letzte Durchlauf fehlgeschlagen ist: Folgen Sie dem Eintrag zu seinem Statuscode.

Die Datei ist auf anderem Weg in den Ordner gelangt - durch ein Hochladen über die ctrlX-Weboberfläche auf ctrlX OS oder durch Kopieren in den Ordner auf einem PC -, und die Liste wurde nicht aktualisiert. Die Liste wird beim Start aktualisiert, wenn system/set-template-dir erfolgreich ist und wenn system/create-template eine Vorlage speichert.

Die Erweiterung ist nicht .png in Kleinbuchstaben. SCREW.PNG wird ignoriert.

Die Datei liegt in einem anderen Ordner als dem verwendeten.

Wenn die Erweiterung nicht .png in Kleinbuchstaben ist: Benennen Sie die Datei mit .png in Kleinbuchstaben um.

Wenn die Liste nicht aktualisiert wurde: Führen Sie system/set-template-dir erneut mit demselben Ordner aus. Erwartet: Sein Statuscode ist 1, und system/templates führt die Vorlage auf.

Nur die Eingaben wurden geschrieben. control/subscribe/input/enable allein zu schreiben startet nichts; control/subscribe/execute wendet die Eingaben an.

control/subscribe/execute wurde abgelehnt (Rejected, ctrlX: DL_INVALID_VALUE): Stream-Modus ohne Adresse oder eine Warteschlangengröße außerhalb von 1 bis 64.

Die Einstellungsdatei <module-id>.json konnte nicht geschrieben werden, zum Beispiel weil sie kein gültiges JSON ist (CreationFailed, ctrlX: DL_CREATION_FAILED). Nichts wurde geändert.

Der Stream des Cam Driver läuft nicht, es treffen also keine Bilder ein.

Die Quelle kann nicht abonniert werden. Das Modul versucht es alle 5 Sekunden erneut, solange der Stream läuft, und protokolliert den ersten Fehlschlag.

Bilder können nicht durchsucht werden, aus den Gründen, die find-template in seinem status-text nennt.

Wenn nur die Eingaben geschrieben wurden: Setzen Sie control/subscribe/input/enable auf true und schreiben Sie auf control/subscribe/execute. Warten Sie, bis control/subscribe/output/stream/active true ist.

Wenn der Aufruf abgelehnt wurde (Rejected, DL_INVALID_VALUE): Schreiben Sie den Stream-Ordner der Kamera auf control/subscribe/input/address, setzen Sie control/subscribe/input/queue-size auf einen Wert von 1 bis 64 und schreiben Sie erneut auf control/subscribe/execute.

Wenn die Einstellungsdatei nicht geschrieben werden konnte (CreationFailed, DL_CREATION_FAILED): Machen Sie <module-id>.json im Konfigurationsverzeichnis wieder zu gültigem JSON, ohne Kommentare, und schreiben Sie dann erneut auf control/subscribe/execute.

Wenn der Stream des Cam Driver nicht läuft: Starten Sie ihn. Er bleibt nach einem Neustart nicht erhalten: Rufen Sie nach jedem Start sein control/publish/execute mit enable = true auf, und verbinden Sie zuerst die Kamera. Siehe Ein Stream liefert nichts.

Wenn die Quelle nicht abonniert werden kann: Prüfen Sie, ob control/subscribe/input/address der Stream-Ordner der Kamera ist und der Cam Driver auf demselben Gerät läuft.

Wenn Bilder fehlschlagen: Korrigieren Sie die Eingabe, die last-failure nennt, wie bei einem einzelnen Aufruf von find-template.

Die Modulliste wurde nicht gespeichert. Einstellungen und neue Module sind sofort wirksam, aber erst dauerhaft, wenn sie gespeichert werden; die Modulliste und die Einstellungen jedes Moduls werden getrennt gespeichert.

Die Einstellungen des Moduls wurden nicht gespeichert.

Ein Speichern ist fehlgeschlagen: system/save-module-inputs oder system/save-current-modules hat nicht Status 1 gemeldet.

<module-id>.json enthält Kommentare. Der Stream liest eine solche Datei, aber die Eingaben des Moduls werden dann beim Start nicht wiederhergestellt; das Protokoll meldet die Datei als unlesbar.

Eine Einstellung, deren Knoten nach einem Software-Update nicht mehr existiert, wird mit einem Protokolleintrag übersprungen.

Wenn die Einstellungen oder die Modulliste nicht gespeichert wurden:

Wenn die Moduldatei Kommentare enthält: Entfernen Sie sie aus <module-id>.json. Von Hand an der Datei vorgenommene Änderungen wirken beim nächsten Start.

Wenn nach einem Update eine Einstellung übersprungen wurde: Setzen Sie die Eingabe erneut und speichern Sie die Einstellungen des Moduls.

Die Lizenz fehlt. Der Grund wird in das Systemprotokoll geschrieben.

Die Anwendung benötigt mehr Lizenzen, als installiert sind. Eine Lizenz deckt zehn Module ab, siehe Problem: Statuscode -11 (Lizenz nicht verfügbar).

Wenn die Lizenz fehlt: Installieren Sie eine gültige Lizenz auf dem Gerät und starten Sie die Anwendung erneut. Erwartet: Sie läuft weiter, und ihre Knoten sind im Data Layer.

Keine Lizenz auf dem Gerät deckt das Modul ab. Eine Lizenz deckt zehn Module ab; das elfte Modul belegt eine zweite Lizenz desselben Schlüssels.

Wenn mehr Module existieren, als die Lizenzen abdecken: Entfernen Sie die nicht benötigten Module mit system/remove-module und speichern Sie die Modulliste mit system/save-current-modules, oder beschaffen Sie eine weitere Lizenz.