--- title: "Fehlerbehebung" description: "Probleme und Fehlermeldungen von LumiScan AI Object Matching - eine Inferenz, die nicht startet oder ohne Ergebnis endet, die Statuscodes 3, 100001, 100002 und -5, abgelehnte execute-Aufrufe und Meldungen beim Lesen der Ergebnisse in ctrlX PLC Engineering." product: "LumiScan AI Object Matching" component: "lumiscan-ai-object-matching-de" version: "2.1.0" display_version: "2.1.0.9" latest_version: true language: "de" url: "https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html" --- # Fehlerbehebung – LumiScan AI Object Matching Diese Seite beginnt mit den allgemeinen Prüfungen, die für jedes Problem gelten. Danach folgen die Probleme, gruppiert nach Inferenz ausführen und Ergebnisse in ctrlX PLC Engineering lesen. Führen Sie zuerst die allgemeinen Prüfungen durch und suchen Sie dann Ihr Symptom. ## Allgemeine Prüfungen {#general-checks} - Lesen Sie den Status des Moduls: `hdvisionsystems/lumiscan-ai-object-matching//control/status/code` und `hdvisionsystems/lumiscan-ai-object-matching//control/status/text`. Die Bedeutung jedes Codes steht unter [Statuscode-Werte](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/initializing-the-inference.html#status-code-values). - Lesen Sie den Status der Anwendung: `hdvisionsystems/lumiscan-ai-object-matching/system/restart-required` und `hdvisionsystems/lumiscan-ai-object-matching/system/status-text`. Ist `restart-required` `true`, siehe [Problem: Jedes Modul meldet Status -5 (restartRequired)](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html#faq-restart-required). - Ist ein Modul nicht gestartet, lesen Sie `hdvisionsystems/lumiscan-ai-object-matching/system/settings`. Eine Moduldatei, die nicht gelesen werden konnte, erscheint dort als `{"$file": ..., "$error": ...}`; `"$error"` nennt den Grund. Siehe [Was der Knoten zeigt](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/settings-on-the-data-layer.html#what-the-node-shows). - Lesen Sie das Log. Auf ctrlX OS schreibt die Anwendung ihre Meldungen in das Systemprotokoll von ctrlX OS. Lesen Sie sie im Logbuch der ctrlX-Weboberfläche oder mit `journalctl` (siehe [ctrlX Data Layer auf ctrlX OS](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/ctrlx-data-layer.html)). - Prüfen Sie die Lizenz. Auf ctrlX OS beendet sich die Anwendung kurz nach dem Start, wenn die Lizenz fehlt; der Grund steht im Systemprotokoll. Eine fehlende Lizenz wird als Status `-4` (`MissingLicense`) gemeldet. Siehe [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/requirements.html#licence). - Starten Sie die Anwendung neu, nachdem Sie eine Konfigurationsdatei geändert haben. Auch eine Änderung der Einstellungen auf dem Data Layer wirkt erst mit dem nächsten Start. - Probleme, die alle LumiScan-Apps gemeinsam haben - eine App oder ein Modul fehlt im Baum, ein Knoten ist „not found", ein Methodenaufruf wird abgelehnt -, sind unter [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html) im Handbuch LumiScan Keryx beschrieben. ## Inferenz ausführen ### Problem: inference/ready bleibt False, oder die Inferenz endet mit Status 100001 {#faq-no-new-external-image} **Symptome** - `/control/inference/ready` bleibt `False`, Sie können also keine Inferenz anfordern. - `inference/ready` ist `True`, aber der Request wird nie quittiert: `ready` fällt nicht, nachdem Sie `request` auf `True` gesetzt haben. - `control/status/code` ist `100001` (`ImageQueueEmpty`). Frühere Versionen meldeten Status `10001` (`noNewExternalImage`); dieser Code wird nicht mehr verwendet. **Mögliche Ursachen** - Status `100001`: Das Bild konnte nicht gelesen werden. Der Bildknoten (`input/image` oder die externe Bildadresse) enthält keine Daten oder konnte nicht gelesen werden. Das ist kein Fehler. - Die Anwendung lädt noch die Konfiguration und richtet das Netz ein. - Der Bild-Stream des Moduls läuft. - Es ist keine Lizenz installiert. - Die Einstellungen wurden auf dem Data Layer geändert, und die Anwendung wartet auf einen Neustart (Status `-5`). - `ready` ist `True`, aber der Request wird nicht quittiert: Die letzte Inferenz ist fehlgeschlagen, und das Modul hat einen Fehler. Es ignoriert jeden Request außer `reset`. - Mehr als ein Prozess schreibt `control/inference/request`. **Diagnose** 1. Lesen Sie `control/status/code` und `control/status/text` des Moduls und schlagen Sie den Code unter [Statuscode-Werte](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/initializing-the-inference.html#status-code-values) nach: - `1` (`settingUp`): Das Modul wird noch eingerichtet. - `100001` (`ImageQueueEmpty`): Das Bild konnte nicht gelesen werden. - `100002` (`StreamActive`): Der Bild-Stream läuft, siehe [Problem: Eine Inferenz-Anfrage wird mit Status 100002 (StreamActive) beantwortet](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html#faq-stream-active). - `-4` (`MissingLicense`): Die Lizenz fehlt. - `-5` (`restartRequired`): Ein Neustart ist erforderlich, siehe [Problem: Jedes Modul meldet Status -5 (restartRequired)](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html#faq-restart-required). 2. Prüfen Sie bei Status `100001` den Bildknoten. Mit einer externen Bildadresse (`externalImagePath` in der Modulkonfigurationsdatei) prüfen Sie, ob `
/data`, `
/height`, `
/width` und `
/pixel-type` (`Mono8` oder `RGB8`) Werte haben. Ohne externe Bildadresse prüfen Sie `hdvisionsystems/lumiscan-ai-object-matching//input/image`. 3. Lesen Sie `control/subscribe/output/stream/active`. Erwartet für eine Inferenz auf Anfrage: `false`. 4. Ist `ready` `True`, fällt aber nach Ihrem Request nicht, suchen Sie im Log nach einer fehlgeschlagenen Inferenz. 5. Prüfen Sie, ob nur ein Prozess auf `control/inference/request` zugreift. **Lösung** - **Wenn das Bild nicht gelesen werden konnte (Status `100001`):** Stellen Sie ein Bild aus der Bildquelle bereit, zum Beispiel eine Aufnahme mit dem LumiScan Cam Driver, und führen Sie die Inferenz erneut aus. Für ein Bild auf `input/image` schreiben Sie das Rohbild und setzen seine Breite, Höhe und sein Pixelformat, siehe [Inferenz starten](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/initializing-the-inference.html). Die Anwendung prüft nicht, ob das Bild neu ist: Ein Bild, das sich seit der letzten Inferenz nicht geändert hat, wird erneut inferiert. - **Wenn das Modul noch eingerichtet wird:** Warten Sie, bis `inference/ready` `True` ist. - **Wenn der Bild-Stream läuft:** Stoppen Sie zuerst den Stream, siehe [Problem: Eine Inferenz-Anfrage wird mit Status 100002 (StreamActive) beantwortet](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html#faq-stream-active). - **Wenn keine Lizenz installiert ist:** Installieren Sie die Lizenz, siehe [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/requirements.html#licence). - **Wenn ein Neustart erforderlich ist (Status `-5`):** Starten Sie die Anwendung neu, siehe [Problem: Jedes Modul meldet Status -5 (restartRequired)](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html#faq-restart-required). - **Wenn das Modul nach einer fehlgeschlagenen Inferenz einen Fehler hat:** 1. Fordern Sie `reset` an (mit dem Handshake auf `control/reset/` oder mit `control/reset/execute`). 2. Prüfen Sie das Log der Anwendung auf die Ursache. 3. Fordern Sie die Inferenz erneut an. - **Wenn mehr als ein Prozess `request` schreibt:** Stellen Sie sicher, dass jeweils nur ein Prozess auf `control/inference/request` zugreift. Andernfalls ist das Ergebnis des Handshakes undefiniert. **Wenn das Problem weiterhin besteht** Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit den Werten von `control/status/code`, `control/status/text`, `control/inference/ready` und `output/package-identifier` und der Angabe, ob Sie den Handshake oder `control/inference/execute` verwenden. ### Problem: status/code ist nach jeder Inferenz 3 {#faq-status-3-after-inference} **Symptome** Nach jeder über den Handshake angeforderten Inferenz ist `control/status/code` `3` (`waitingForClient`), unabhängig davon, ob die Inferenz erfolgreich war. **Mögliche Ursachen** - So arbeitet der Handshake: Eine über den Handshake angeforderte Inferenz endet unabhängig von ihrem Ausgang mit Status `3`. `status/code` zeigt nicht, ob sie erfolgreich war. **Diagnose** 1. Merken Sie sich vor dem Anfordern der Inferenz den Wert von `/output/package-identifier`. 2. Wenn `inference/ready` wieder `True` ist, lesen Sie `output/package-identifier` erneut. Erwartet: Er ist um eins gestiegen. Er steigt mit jeder erfolgreichen Inferenz um eins, und nur dann (siehe [Ausgang einer Inferenz](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/general-concept-of-handshake.html#outcome-of-an-inference)). 3. Ist er nicht gestiegen, ist die Inferenz fehlgeschlagen. Fordern Sie die nächste Inferenz an: Fällt `inference/ready` nicht, hat das Modul nach einer fehlgeschlagenen Inferenz einen Fehler. **Lösung** - **Wenn `output/package-identifier` um eins gestiegen ist:** Die Inferenz war erfolgreich. Lesen Sie das Ergebnis unter `/output/result`. - **Wenn er nicht gestiegen ist, weil das Bild nicht gelesen werden konnte (es gab kein Bild, oder es war leer):** Stellen Sie ein Bild bereit und fordern Sie die Inferenz erneut an. - **Wenn er nicht gestiegen ist, weil die Inferenz selbst fehlgeschlagen ist:** Das Modul hat einen Fehler und ignoriert jeden Request außer `reset`. Fordern Sie `reset` an und prüfen Sie das Log der Anwendung auf die Ursache. - **Wenn Sie den Ausgang direkt auf `status/code` lesen möchten:** Starten Sie die Inferenz stattdessen mit `control/inference/execute` (ab v2.1.0). `status/code` behält dann den Ausgang: `0`, `100001` oder `-1`. Siehe [Eine Methode ausführen](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/initializing-the-inference.html#execute-a-method). **Wenn das Problem weiterhin besteht** Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit dem Wert von `output/package-identifier` vor und nach der Inferenz. ### Problem: Ein Schreibvorgang auf execute wird abgelehnt {#faq-execute-refused} **Symptome** Ab v2.1.0. Ein Schreibvorgang auf `/control//execute` wird mit einem der folgenden Ergebnisse beantwortet. Die Funktion läuft nicht; ein abgelehnter Schreibvorgang wird nie in eine Warteschlange gestellt. | ctrlX Data Layer | LumiScan Keryx | | --- | --- | | `DL_TOO_MANY_OPERATIONS` | `TooManyOperations` | | `DL_INVALID_OPERATION_MODE` | `InvalidOperationMode` | | `DL_RESOURCE_UNAVAILABLE` | `ResourceUnavailable` | **Mögliche Ursachen** - `DL_TOO_MANY_OPERATIONS` / `TooManyOperations`: Eine andere Funktion des Moduls läuft, über den Handshake oder ein anderes `execute`. - `DL_INVALID_OPERATION_MODE` / `InvalidOperationMode`: Das `ready`-Signal der Funktion ist `False`, das Modul kann sie also nicht ausführen - zum Beispiel `inference`, solange der Bild-Stream läuft. - `DL_RESOURCE_UNAVAILABLE` / `ResourceUnavailable`: Die Anwendung wird beendet; oder die Einstellungen wurden auf dem Data Layer geändert und ein Neustart ist erforderlich (Status `-5`); oder das Modul hat nach einer fehlgeschlagenen Inferenz einen Fehler. `reset/execute` wird wegen des Fehlers nie abgelehnt. **Diagnose** 1. Notieren Sie das genaue Ergebnis des Schreibvorgangs und schlagen Sie es unter [Eine Methode ausführen](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/initializing-the-inference.html#execute-a-method) nach (siehe auch [Ein Methodenaufruf wird abgelehnt](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#refused) im Handbuch LumiScan Keryx). 2. Bei `DL_INVALID_OPERATION_MODE` / `InvalidOperationMode`: Lesen Sie den `ready`-Knoten der Funktion (für eine Inferenz `control/inference/ready`) und `control/status/code`. Lesen Sie `control/subscribe/output/stream/active`: `true` bedeutet, dass der Bild-Stream läuft. 3. Bei `DL_RESOURCE_UNAVAILABLE` / `ResourceUnavailable`: Lesen Sie `hdvisionsystems/lumiscan-ai-object-matching/system/restart-required`. `true` bedeutet, dass ein Neustart erforderlich ist. 4. Lesen Sie das Log. Die Apps protokollieren die erste Ablehnung einer Methode, danach höchstens eine Zeile alle zehn Sekunden für dieselbe Methode und dasselbe Ergebnis. **Lösung** - **Wenn eine andere Funktion läuft (`DL_TOO_MANY_OPERATIONS` / `TooManyOperations`):** Wiederholen Sie den Aufruf. Der Schreibvorgang gelingt, sobald diese Operation abgeschlossen ist. - **Wenn das `ready`-Signal `False` ist (`DL_INVALID_OPERATION_MODE` / `InvalidOperationMode`):** Bringen Sie das Modul zuerst in den passenden Zustand; bloßes Wiederholen schlägt weiter fehl. Wiederholen Sie den Aufruf nicht in einer Schleife. Läuft der Bild-Stream, stoppen Sie ihn zuerst, siehe [Problem: Eine Inferenz-Anfrage wird mit Status 100002 (StreamActive) beantwortet](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html#faq-stream-active). - **Wenn ein Neustart erforderlich ist:** Starten Sie die Anwendung neu, siehe [Problem: Jedes Modul meldet Status -5 (restartRequired)](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html#faq-restart-required). - **Wenn das Modul nach einer fehlgeschlagenen Inferenz einen Fehler hat:** Führen Sie `reset` aus (`control/reset/execute`) und wiederholen Sie dann den Aufruf. - **Wenn die Anwendung beendet wird:** Die Funktion kann nicht laufen. Wenn die Anwendung wieder gestartet ist, können ihre Knoten wieder gelesen werden; wiederholen Sie dann den Aufruf. **Wenn das Problem weiterhin besteht** Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit dem genauen Ergebnis des Schreibvorgangs, der aufgerufenen Funktion und dem Wert von `control/status/code`. ### Problem: Eine Inferenz-Anfrage wird mit Status 100002 (StreamActive) beantwortet {#faq-stream-active} **Symptome** Ab v2.2.0 (Bild-Stream, experimentell). - Nach einem Request auf `control/inference/request` ist `control/status/code` `100002` (`StreamActive`), und der Request wird nicht quittiert. - `control/inference/ready` ist `False`. - `control/inference/execute` antwortet mit `DL_INVALID_OPERATION_MODE` (LumiScan Keryx: `InvalidOperationMode`). **Mögliche Ursachen** - Das Modul inferiert seinen Bild-Stream. Der Stream und die Inferenz auf Anfrage verwenden dasselbe Netz, deshalb laufen sie nie gleichzeitig (siehe [Inferenz auf Anfrage, während der Stream läuft](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/inference-on-an-image-stream.html#while-streaming)). Das ist kein Fehler, und kein Reset ist nötig. - Das Modul ist im Stream-Modus gestartet: `stream.enable` ist in der Modulkonfigurationsdatei `true`. `control/subscribe/execute` speichert `enable`, sodass das Modul nach einem Neustart seinen Stream sofort wieder startet. **Diagnose** 1. Lesen Sie `control/subscribe/output/stream/active`. `true` bedeutet, dass das Modul seinen Bild-Stream inferiert. 2. Lesen Sie `setting/stream/enable` und `setting/stream/address`: Sie zeigen, was das Modul jetzt anwendet, wie im Abschnitt `stream` der Modulkonfigurationsdatei gespeichert. **Lösung** - **Wenn Sie eine Inferenz auf Anfrage benötigen:** 1. Stoppen Sie den Stream: Schreiben Sie `false` auf `control/subscribe/input/enable` und `true` auf `control/subscribe/execute`. Das wird gespeichert: Das Modul startet wieder so, wie es verlassen wurde. 2. Prüfen Sie, ob `control/subscribe/output/stream/active` `false` und `control/inference/ready` `True` ist. 3. Fordern Sie die Inferenz an. - **Wenn Sie die Ergebnisse des Streams benötigen:** Abonnieren Sie `control/subscribe/output/stream/result` und lesen Sie die Ergebnisse dort. **Wenn das Problem weiterhin besteht** Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit den Werten von `control/subscribe/output/stream/active` und `setting/stream/enable` und dem Abschnitt `stream` der Modulkonfigurationsdatei. ### Problem: Jedes Modul meldet Status -5 (restartRequired) {#faq-restart-required} **Symptome** - Jedes Modul meldet Status `-5` (`restartRequired`). Es beantwortet keinen Request, und seine `ready`-Signale sind `false`. - `hdvisionsystems/lumiscan-ai-object-matching/system/restart-required` ist `true`. - Jede `execute`-Methode eines Moduls antwortet mit `DL_RESOURCE_UNAVAILABLE` / `ResourceUnavailable`. Das schließt `reset` ein. - Ein laufender Bild-Stream stoppt. - Das Log enthält die Meldung auf der Stufe Fehler. **Mögliche Ursachen** - Die Einstellungen wurden auf dem Data Layer geändert (`hdvisionsystems/lumiscan-ai-object-matching/system/settings`). Die Änderung ist gespeichert, wirkt aber erst mit dem nächsten Start (siehe [Neustart erforderlich](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/settings-on-the-data-layer.html#restart-required)). - `activate-module` oder `deactivate-module` wurde aufgerufen. Die Änderung gilt ab dem nächsten Start. - Eine Datei konnte nicht gespeichert werden: Der Schreibvorgang antwortete mit `DL_CREATION_FAILED` / `CreationFailed`. Zuvor geänderte Dateien bleiben geändert, sodass die Anwendung trotzdem einen Neustart erfordert. **Diagnose** 1. Lesen Sie `hdvisionsystems/lumiscan-ai-object-matching/system/restart-required`. Erwartet in diesem Zustand: `true`. 2. Lesen Sie `hdvisionsystems/lumiscan-ai-object-matching/system/status-text`. Er nennt die geänderten Dateien. 3. Lesen Sie `hdvisionsystems/lumiscan-ai-object-matching/system/settings`. Er zeigt die Dateien wie gespeichert, also das, was der nächste Start lädt. 4. Hat ein Schreibvorgang auf `settings` mit `DL_CREATION_FAILED` / `CreationFailed` geantwortet, suchen Sie im Log nach der Datei, die nicht gespeichert werden konnte. **Lösung** Ein Reset beendet diesen Zustand nicht; nur ein Neustart. - **Wenn die Einstellungen auf dem Data Layer geändert oder ein Modul aktiviert oder deaktiviert wurde:** 1. Rufen Sie `hdvisionsystems/lumiscan-ai-object-matching/system/control/restart/execute` auf. Die Methode antwortet mit `DL_OK` / `Ok`, sobald der Neustart begonnen hat. Auf ctrlX OS startet ctrlX OS die Anwendung nach etwa fünf Sekunden erneut. 2. Warten Sie, bis `hdvisionsystems/lumiscan-ai-object-matching/system/restart-required` wieder gelesen werden kann. Erwartet: `false`. - **Wenn eine Datei nicht gespeichert werden konnte (`DL_CREATION_FAILED` / `CreationFailed`):** Korrigieren Sie die Dateien und starten Sie die Anwendung dann wie oben beschrieben neu. **Wenn das Problem weiterhin besteht** Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit dem Inhalt von `system/status-text` und `system/settings`. ## Ergebnisse in ctrlX PLC Engineering lesen ### Problem: Der Ordner schemas existiert nicht {#faq-schemas-folder-missing} **Symptome** Auf ctrlX OS existiert in **Manage app data** der Ordner `lumiscan-ai-object-matching/schemas` nicht, Sie können `object_detection.fbs` also nicht aus `lumiscan-ai-object-matching/schemas/flatbuffers` herunterladen. **Mögliche Ursachen** - Die Anwendung ist nicht erfolgreich gestartet. Der Ordner `schemas` wird beim Start angelegt, nach der Lizenzprüfung. - Die Lizenz fehlt. Die Anwendung beendet sich dann kurz nach dem Start. **Diagnose** 1. Lesen Sie das Systemprotokoll von ctrlX OS im Logbuch der ctrlX-Weboberfläche oder mit `journalctl`. Fehlt die Lizenz, steht der Grund dort. 2. Prüfen Sie, ob die ctrlX-Lizenz `SWL-W-XCx-OBJxMATCHxHDVSx-V2NN` installiert ist. **Lösung** - **Wenn die Lizenz fehlt:** Installieren Sie eine gültige Lizenz, siehe [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/requirements.html#licence) und [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html) im Handbuch LumiScan Lizenzierung. Prüfen Sie dann in **Manage app data**, ob der Ordner `lumiscan-ai-object-matching/schemas/flatbuffers` existiert. - **Wenn die Anwendung aus einem anderen Grund nicht gestartet ist:** Der Grund steht im Systemprotokoll. Wenden Sie sich an den Support. Bearbeiten Sie keine Dateien in `schemas`: Die Anwendung löscht den Ordner bei jedem Start und legt ihn neu an. **Wenn das Problem weiterhin besteht** Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit den Meldungen der Anwendung aus dem Systemprotokoll von ctrlX OS. ### Problem: Import from FlatBuffers file… fehlt im Kontextmenü {#ts-import-command-missing} **Symptome** Sie klicken in ctrlX PLC Engineering im Gerätebaum mit der rechten Maustaste auf **Application**. Das Kontextmenü enthält **Import from FlatBuffers file…** nicht. **Mögliche Ursachen** - Die ctrlX-Data-Layer-Bibliothek `CXA_Datalayer` fehlt. **Diagnose** 1. Prüfen Sie, ob Sie ctrlX PLC Engineering 2.6 oder neuer verwenden. 2. Prüfen Sie im **Library Manager** des SPS-Projekts, ob `CXA_Datalayer` und `CXA_Flatbuffers` referenziert sind. **Lösung** - **Wenn die ctrlX-Data-Layer-Bibliothek fehlt:** 1. Wählen Sie in der Menüleiste von PLC Engineering **Tools** > **Library Repository…**. 2. Suchen Sie nach `CXA_Datalayer`, wählen Sie die Bibliothek aus und klicken Sie auf **Open**. 3. Wiederholen Sie den Import: Klicken Sie mit der rechten Maustaste auf **Application**, wählen Sie **Import from FlatBuffers file…** und wählen Sie `object_detection.fbs`. Die Screenshots finden Sie unter [Die ctrlX-Data-Layer-Bibliothek installieren](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/accessing-flatbuffers-data.html#lumiscan-install-datalayer-library). - **Wenn nach dem Import eine andere Bibliothek fehlt:** Fügen Sie sie im **Library Manager** hinzu. **Wenn das Problem weiterhin besteht** Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit der Version von ctrlX PLC Engineering und den im **Library Manager** aufgeführten Bibliotheken. ### Problem: Nach dem Import erscheint die Meldung "Identifier 'VectorT' not defined" {#faq-vectort-not-defined} **Symptome** Nach dem Import von `object_detection.fbs` zeigt der Editor des Funktionsbausteins `hdv_object_detection2d_InstanceTVec` die Meldung `Identifier 'VectorT' not defined` (beobachtet mit ctrlX PLC Engineering 3.6). ![Editor von hdv_object_detection2d_InstanceTVec mit der Meldung Identifier 'VectorT' not defined in der Zeile FUNCTION_BLOCK hdv_object_detection2d_InstanceTVec EXTENDS flatbuffers.VectorT](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/_images/plc-vectort-not-defined.png) *Abbildung 1. Meldung im Editor von hdv_object_detection2d_InstanceTVec* **Mögliche Ursachen** - Der Funktionsbaustein `hdv_object_detection2d_InstanceTVec` erweitert `flatbuffers.VectorT`. Die Version der Bibliothek `CXA_Flatbuffers`, die für ctrlX PLC Engineering 3.6 verfügbar ist (0.1.3.3), enthält diesen Funktionsbaustein nicht. **Diagnose** 1. Öffnen Sie den Editor von `hdv_object_detection2d_InstanceTVec`. Erwartet: Die Meldung erscheint in der Zeile `FUNCTION_BLOCK hdv_object_detection2d_InstanceTVec EXTENDS flatbuffers.VectorT`. 2. Prüfen Sie im **Library Manager**, welche Version von `CXA_Flatbuffers` das SPS-Projekt referenziert. **Lösung** Die Meldung beeinträchtigt das Lesen der Ergebnisse nicht. - **Wenn die Meldung erscheint:** - Verwenden Sie `hdv_object_detection2d_InstanceTVec` nicht in Ihrem Programm. Er wird zum Lesen der Ergebnisse nicht benötigt. Auf einzelne Instanzen greifen Sie mit `getInstances` von `hdv_object_detection2d_Result` zu, siehe [Beispiel: Position und Score einer Instanz lesen](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/lumiscan-ai-object-matching/accessing-flatbuffers-data.html#lumiscan-example-instance). - Stört die Meldung, löschen Sie den Funktionsbaustein `hdv_object_detection2d_InstanceTVec` aus der Anwendung. Kein anderer erzeugter Funktionsbaustein verweist auf ihn. **Wenn das Problem weiterhin besteht** Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-ai-object-matching-de/2.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit der Version von ctrlX PLC Engineering, der Version von `CXA_Flatbuffers` und der genauen Meldung. ## Informationen für den Support {#support-information} Besteht ein Problem weiter, senden Sie die folgenden Informationen an den Support: - Die Version von LumiScan AI Object Matching. - Die Plattform: ctrlX OS auf einer ctrlX CORE oder einem ctrlX IPC, mit der Version von ctrlX OS (mit TPU-Beschleunigung auch die Version von App Hardware Support); oder ein PC mit Windows 11 oder Ubuntu 24.04 und LumiScan Keryx. - Bei Problemen in ctrlX PLC Engineering: die Version von ctrlX PLC Engineering und der Bibliotheken `CXA_Datalayer` und `CXA_Flatbuffers`. - Das Log der Anwendung. Auf ctrlX OS die Meldungen der Anwendung aus dem Systemprotokoll von ctrlX OS (Logbuch der ctrlX-Weboberfläche oder `journalctl`). Auf einem PC das Log der Anwendung. - Datum und Uhrzeit des Fehlers. - Den Status auf dem Data Layer: welchen Data Layer Sie verwenden (ctrlX Data Layer oder LumiScan Keryx; auf einem PC die Data-Layer-Adresse), die Werte von `control/status/code` und `control/status/text` des Moduls, `system/restart-required` und `system/status-text` und bei einem abgelehnten Methodenaufruf das genaue Ergebnis des Schreibvorgangs. - Die Konfigurationsdateien aus dem Ordner `lumiscan-ai-object-matching`: die Konfigurationsdatei der Anwendung `ai-object-matching.json`, die Modulkonfigurationsdatei und die Modellbeschreibungsdatei (`.json`) in `models`. Alternativ senden Sie den Inhalt von `hdvisionsystems/lumiscan-ai-object-matching/system/settings`: Jeder Wert mit dem Namen `password` erscheint dort als `"***"`. Wenden Sie sich an den Customer Success von HD Vision Systems unter [customer.success@hdvisionsystems.com](mailto:customer.success@hdvisionsystems.com) oder +49 6221 6721905. Für Lizenzen wenden Sie sich an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com).