---
title: "Fehlerbehebung"
description: "Probleme und Fehlermeldungen von LumiScan Template Finder Schritt für Schritt - Statuscodes, Suchergebnisse, Vorlagen, der Bild-Stream, Module, Einstellungen und Lizenzierung."
product: "LumiScan Template Finder"
component: "lumiscan-template-finder-de"
version: "1.1.0"
display_version: "1.1.0.7"
latest_version: true
language: "de"
url: "https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html"
---

# Fehlerbehebung – LumiScan Template Finder

Diese Seite beschreibt Probleme und Fehlermeldungen von LumiScan Template Finder, nach Kategorien geordnet. Beginnen Sie mit den [allgemeinen Prüfungen](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#general-checks) und suchen Sie dann unten Ihr Symptom: Jedes Problem nennt die Symptome, die möglichen Ursachen, eine Diagnose und die Lösung. Probleme des Data Layer selbst sind in der [Fehlerbehebung des Data Layer](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html) beschrieben, Lizenzprobleme in der [Fehlerbehebung der Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html).

## Allgemeine Prüfungen {#general-checks}

1. **Prüfen Sie den Statuscode.** Lesen Sie `output/status-code` der Operation, die fehlgeschlagen ist. Erwartet: `1`. Ein Wert größer als 0 bedeutet Erfolg, `0` bedeutet, dass die Operation seit dem Start der Anwendung nicht ausgeführt wurde, und ein Wert kleiner als 0 bedeutet, dass sie fehlgeschlagen ist und nichts erzeugt hat. Die Codes stehen in [Ausführungsstatus](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/execution-status.html).
2. **Lesen Sie den Statustext.** Lesen Sie `output/status-text` derselben Operation. Er beginnt mit `ok:` oder `error:` und nennt jede ungültige Eingabe und ihren Wert. Ein fehlgeschlagener Schreibvorgang auf `execute` antwortet nur mit einem Statuscode (über REST ein bloßes `400`); der Grund steht also nur auf `output/status-text`.
3. **Lesen Sie das Protokoll der Anwendung.** Es enthält denselben Text, mit einer eigenen Warnzeile für jede ungültige Eingabe: auf ctrlX OS im ctrlX Logbook oder mit `journalctl`, auf einem PC in der Konsolenausgabe der Anwendung. Wie viel protokolliert wird, legt `logLevel` im Block `system` von `lumiscan-template-finder.json` fest (`TRACE`, `DEBUG`, `INFO`, `WARN`, `ERROR`, `FATAL` oder `OFF`); ohne den Schlüssel protokolliert die Anwendung auf `DEBUG`. Der Level wird einmal, beim Start, gelesen; starten Sie die Anwendung nach einer Änderung also neu. `TRACE` ist der Wert, den Sie setzen, bevor Sie ein Problem für einen Support-Bericht reproduzieren. Siehe [Speicherung der Vorlagen](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/template-storage.html).
4. **Prüfen Sie die Bildquelle.** Die Kameraanwendung, normalerweise LumiScan Cam Driver, muss auf **demselben Gerät** laufen - demselben ctrlX CORE oder ctrlX IPC oder demselben PC - und ein Bild aufgenommen haben. Ein Zugriff auf einen entfernten Data Layer wird nicht unterstützt. Erwartet: Der in `input/input-image-address` genannte Knoten stellt `data`, `width`, `height` und `pixel-type` bereit.
5. **Prüfen Sie die Reihenfolge der Aufrufe.** Ein Modul führt jeweils eine Operation aus, und jeder Durchlauf leert beim Start seine Ausgaben. Erwartet: Ihr Programm wartet, bis `execute` zurückkehrt, liest die Ausgaben und löst erst dann den nächsten Durchlauf aus.
6. **Prüfen Sie die Lizenz (ctrlX OS).** Erwartet: Die Anwendung läuft nach dem Start weiter. Ohne Lizenz beendet sie sich kurz nach dem Start; siehe [Problem: Die Anwendung beendet sich kurz nach dem Start](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#faq-app-stops-after-start).

Das Konfigurationsverzeichnis enthält `lumiscan-template-finder.json`, die Moduldateien `<module-id>.json`, den Ordner `templates` und `settings-history/`:

| Plattform | Konfigurationsverzeichnis |
| --- | --- |
| ctrlX OS | `/var/snap/rexroth-solutions/common/solutions/activeConfiguration/lumiscan-template-finder`, Teil der aktiven Solution |
| PC (Windows) | `%APP_RESOURCE_DIR%\etc\lumiscan-template-finder`; ohne `APP_RESOURCE_DIR` `C:\ProgramData\HD Vision Systems GmbH\LumiScan Vision Suite\lumiscan-templ-find\etc\lumiscan-template-finder` |

## Statuscodes und Fehlermeldungen {#ts-status-codes}

### Problem: Statuscode `-1` (belegt) {#faq-busy-while-streaming}

**Symptome**

`output/status-code` von `find-template` ist `-1`. Der Schreibvorgang auf `execute` antwortet mit `TooManyOperations` (ctrlX: `DL_TOO_MANY_OPERATIONS`). Es wurde nichts getan, und `output/result` behält seinen Wert. Bei einer streamenden Kamera passiert das häufig. Auch `system/remove-module` kann mit `-1` (belegt) antworten.

**Mögliche Ursachen**

- 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.

**Diagnose**

1. Prüfen Sie in Ihrem Programm, ob es erneut auf `execute` desselben Moduls schreibt, bevor der vorherige Schreibvorgang zurückgekehrt ist. Erwartet: ein Aufruf pro Modul zur Zeit.
2. Lesen Sie `<module-id>/control/subscribe/output/stream/active`. `true` bedeutet, dass der Stream dieses Moduls läuft.

**Lösung**

- **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:**

  a. Stoppen Sie den Stream, bevor Sie die Methode aufrufen: Setzen Sie `control/subscribe/input/enable` auf `false` und schreiben Sie auf `control/subscribe/execute`. Oder rufen Sie die Methode erneut auf.

  b. Um stattdessen die Ergebnisse des Streams zu verwenden, schalten Sie `control/subscribe/input/keep-latest-output` ein und lesen `find-template/output/result`.

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

Siehe [Eine Methode ausführen](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/execute-a-method.html) und [find-template bei laufendem Stream](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/processing-an-image-stream.html#while-streaming).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit der Modul-ID, der Antwort des Schreibvorgangs auf `execute` und dem Wert von `control/subscribe/output/stream/active`.

### Problem: Statuscode `-2` (ungültige Eingabe) {#faq-status-minus-2}

**Symptome**

`output/status-code` ist `-2`. `output/status-text` beginnt mit `error:` und nennt jede fehlerhafte Eingabe und ihren Wert, zum Beispiel `min-scale must be > 0, got 0`. Jede wird zusätzlich als Warnung protokolliert.

**Mögliche Ursachen**

- 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`.

**Diagnose**

1. Lesen Sie `output/status-text` der Operation. Erwartet: Er nennt jede fehlerhafte Eingabe und ihren Wert.
2. Lesen Sie das Protokoll der Anwendung. Jede fehlerhafte Eingabe wird als Warnung protokolliert.

**Lösung**

- **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](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/tuning-the-search.html).
- **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.

Führen Sie die Operation dann erneut aus. Erwartet: `output/status-code` ist `1`. Siehe [Ausführungsstatus](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/execution-status.html) und [Speicherung der Vorlagen](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/template-storage.html).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit dem Inhalt von `output/status-text`.

### Problem: Statuscode `-3` (Bild konnte nicht gelesen werden) {#faq-status-minus-3}

**Symptome**

`output/status-code` von `find-template` oder `system/create-template` ist `-3`.

**Mögliche Ursachen**

- 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`.

**Diagnose**

1. Prüfen Sie, ob die Kameraanwendung, normalerweise LumiScan Cam Driver, auf demselben Gerät läuft. Erwartet: Sie läuft auf demselben ctrlX CORE oder ctrlX IPC oder auf demselben PC.
2. Vergleichen Sie `input/input-image-address` mit der Adresse des Bildknotens der Kamera, zum Beispiel `hdvisionsystems/lumiscan-cam-driver/camera1/output/image`. Erwartet: identisch. `system/create-template` und `find-template` haben jeweils einen eigenen Adressknoten.
3. Lesen Sie `width`, `height` und `pixel-type` des Bildknotens. Erwartet: Werte größer als 0 und ein `pixel-type` aus der obigen Liste.

**Lösung**

- **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](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/requirements.html).

Führen Sie die Operation dann erneut aus. Erwartet: `output/status-code` ist `1`.

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit dem Inhalt von `output/status-text`, der Bildadresse und dem `pixel-type` des Bildknotens.

### Problem: Statuscode `-4` (Quelle nicht gefunden) {#faq-status-minus-4}

**Symptome**

`output/status-code` von `find-template` ist `-4`. `output/status-text` nennt ein Verzeichnis oder eine Datei.

**Mögliche Ursachen**

- 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.

**Diagnose**

1. Lesen Sie `output/status-text`. Erwartet: Er nennt ein Verzeichnis oder eine Datei.
2. Vergleichen Sie `input/template-name` mit `system/templates`. Erwartet: Der Name ist aufgeführt, in derselben Schreibweise.
3. Lesen Sie `system/template-dir`. Erwartet: Es nennt den Ordner, der die Datei enthält.

**Lösung**

- **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`.

Führen Sie `find-template` dann erneut aus. Erwartet: `output/status-code` ist `1`. Siehe [Speicherung der Vorlagen](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/template-storage.html).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit dem Inhalt von `output/status-text`, `input/template-name`, `system/template-dir` und `system/templates`.

### Problem: Die Ausschnittsregion passt nicht in das Bild {#ts-crop-does-not-fit}

**Symptome**

`system/create-template` antwortet mit Status `-5` (ungültige Ausschnittsregion), und `output/status-text` nennt die tatsächliche Bildgröße. Bei `find-template` nennt `output/status-text` die Eingabe und die Grenze, die sie verletzt hat, zum Beispiel:

```
crop/startX + crop/width (100 + 541 = 641) exceeds the image width 640
```

Im Bild-Stream schlägt das Bild fehl, und `control/subscribe/output/stream/last-failure` nennt eine Ausschnittsregion, die nicht in das Bild passt.

**Mögliche Ursachen**

- 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.

**Diagnose**

1. Lesen Sie die Bildgröße aus der Meldung ab, oder `width` und `height` des Bildknotens.
2. Addieren Sie `input/crop/startX` und `input/crop/width` sowie `input/crop/startY` und `input/crop/height`. Erwartet: Die Summen sind nicht größer als die Bildbreite und die Bildhöhe.
3. Bei `find-template` vergleichen Sie die Region mit der Größe der Vorlage. Erwartet: Die Region ist mindestens so groß wie die Vorlage.

**Lösung**

- **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.

Führen Sie die Operation dann erneut aus. Erwartet: `output/status-code` ist `1`. Siehe [Eine Vorlage finden](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/finding-a-template.html) und [Eine Vorlage erstellen](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/creating-a-template.html).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit dem Inhalt von `output/status-text` und den vier Werten unter `input/crop/`.

### Problem: Statuscode `-6` (Schreiben fehlgeschlagen) {#ts-status-minus-6}

**Symptome**

`output/status-code` von `system/save-module-inputs` oder `system/create-template` ist `-6`.

**Mögliche Ursachen**

- 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.

**Diagnose**

1. Lesen Sie `output/status-text` der Operation. Erwartet: Er nennt die Datei, die nicht geschrieben werden konnte.
2. Lesen Sie das Protokoll der Anwendung beim Start. Erwartet: keine Meldung, dass das Konfigurationsverzeichnis nicht beschreibbar ist.
3. Prüfen Sie das Konfigurationsverzeichnis (siehe [Allgemeine Prüfungen](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#general-checks)). Erwartet: Es existiert, und die Anwendung kann hineinschreiben.

**Lösung**

- **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.

Führen Sie die Operation dann erneut aus. Erwartet: `output/status-code` ist `1`.

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit dem Inhalt von `output/status-text` und dem Protokoll des Starts.

## Suchergebnisse {#ts-results}

### Problem: Das Ergebnis ist leer, obwohl der Statuscode `1` ist {#ts-empty-result}

**Symptome**

`output/status-code` von `find-template` ist `1`, aber `matches` in `output/result` ist leer, und `best_score` ist `0.0`.

**Mögliche Ursachen**

Eine leere Liste `matches` mit Statuscode `1` bedeutet, dass die Suche korrekt gelaufen ist und nichts gefunden hat. Das ist ein normales Ergebnis: Das Teil ist nicht da oder nicht ähnlich genug, um den Schwellwert zu erreichen. Wird ein vorhandenes Teil nicht gefunden:

- 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](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#faq-not-found-in-own-image).
- 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](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#faq-rotation-scale).
- `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.

**Diagnose**

1. Lesen Sie `output/status-code`. Erwartet: `1`. Ist er negativ, ist der Durchlauf fehlgeschlagen: Lesen Sie `output/status-text` und sehen Sie sich die Einträge unter [Statuscodes und Fehlermeldungen](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#ts-status-codes) an.
2. Durchsuchen Sie das Bild, aus dem die Vorlage ausgeschnitten wurde. Erwartet: ein Treffer in der Mitte der angegebenen Region, mit einer Konfidenz nahe 1.
3. Vergleichen Sie Ausrichtung und Größe des Teils im Bild mit der Vorlage.
4. Lesen Sie die vier Werte unter `input/crop/`. Erwartet: alle `0` (das ganze Bild) oder eine Region, die das Teil enthält.
5. Lesen Sie `match_thresh` in `output/result`: den angewendeten Schwellwert (Standard `0.9`).

**Lösung**

- **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](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#faq-not-found-in-own-image).
- **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](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#faq-rotation-scale).
- **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](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/creating-a-template.html).
- **Wenn das Teil nicht im Bild war:** Das Ergebnis ist korrekt; es muss nichts geändert werden.

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit `input/template-name`, der Vorlagendatei und `output/result`.

### Problem: Die Vorlage wird nicht einmal in dem Bild gefunden, aus dem sie ausgeschnitten wurde {#faq-not-found-in-own-image}

**Symptome**

Eine Suche in genau dem Bild, aus dem die Vorlage ausgeschnitten wurde, meldet den Treffer nicht in der Mitte der angegebenen Region mit einer Konfidenz nahe 1.

**Mögliche Ursachen**

- 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.

Die Suchparameter sind nicht die Ursache, und keine Abstimmung behebt es.

**Diagnose**

1. Vergleichen Sie `system/create-template/input/input-image-address` mit `<module>/find-template/input/input-image-address`. Erwartet: derselbe Bildknoten.
2. Lesen Sie die vier Werte unter `system/create-template/input/crop/`. Erwartet: eine Region, die das Teil in diesem Bild enthält.
3. Lesen Sie `system/create-template/output/template-path`. Erwartet: die Datei, nach der Sie suchen, zum Beispiel `templates/screw.png`.

**Lösung**

- 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.

Siehe [Eine Vorlage erstellen](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/creating-a-template.html) und [Anleitung: Ein Teil in einem Kamerabild finden](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/how-tos/match-a-part-from-a-camera-image.html).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit den Eingaben von `system/create-template`, der Vorlagendatei und `output/result`.

### Problem: Das Teil wird nicht gefunden, wenn es gedreht ist oder in einem anderen Abstand liegt {#faq-rotation-scale}

**Symptome**

Die Vorlage wird in dem Bild gefunden, aus dem sie ausgeschnitten wurde, aber nicht in einem neuen Bild, in dem das Teil gedreht ist oder näher an der Kamera oder weiter von ihr entfernt liegt.

**Mögliche Ursachen**

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

**Diagnose**

1. Lesen Sie `input/rotation/min-rot`, `max-rot` und `input/scale/min-scale`, `max-scale` des Moduls. Bei den Standardwerten (`0.0`, `0.0`, `1.0`, `1.0`) werden nur die ursprüngliche Ausrichtung und Größe gesucht.
2. Vergleichen Sie das Teil im neuen Bild mit der Vorlage. Erwartet: Sie wissen, ob es in der Ausrichtung, in der Größe oder in beidem variiert.

**Lösung**

Erweitern Sie nur, was tatsächlich variiert, einen Bereich nach dem anderen, und hören Sie auf, sobald das Teil zuverlässig gefunden wird:

- **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`).

Jede Kombination aus Skalierung und Drehung ist ein eigener Durchlauf über das Bild; 72 Drehungen und 5 Skalierungen sind also 360 Durchläufe. Liefert ein weiterer Bereich Treffer an falschen Stellen, siehe [Problem: Eine weite Suche meldet schwache Treffer an falschen Stellen](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#faq-spurious-matches). Siehe [Die Suche abstimmen](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/tuning-the-search.html).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit den Eingaben für Skalierung und Drehung und `output/result`.

### Problem: Eine weite Suche meldet schwache Treffer an falschen Stellen {#faq-spurious-matches}

**Symptome**

Mit einem Skalierungs- oder Drehungsbereich enthält `matches` den echten Treffer und daneben Treffer an Stellen, die nichts damit zu tun haben.

**Mögliche Ursachen**

- 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.

**Diagnose**

1. Lesen Sie `matches[0]` und `best_score`. Erwartet: Der echte Treffer ist der Eintrag mit der höchsten Konfidenz, an Index 0.
2. Lesen Sie die Eingaben für Skalierung und Drehung. Eine Suche mit einer Skalierung und einer Drehung verhält sich wie erwartet; ein Bereich kann Scheintreffer melden.

**Lösung**

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

Siehe [Die Suche abstimmen](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/tuning-the-search.html).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit den Eingaben von `find-template` und `output/result`.

### Problem: `output/result` ist leer, obwohl die Suche eben noch funktioniert hat {#faq-result-empty}

**Symptome**

Ein Durchlauf hat Treffer erzeugt, und kurz danach ist `output/result` leer.

**Mögliche Ursachen**

- 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.

**Diagnose**

1. Prüfen Sie die Reihenfolge der Aufrufe in Ihrem Programm. Erwartet: Es liest `output/result`, bevor es das nächste `execute` auslöst.
2. Lesen Sie `output/status-code` des letzten Durchlaufs. Ein negativer Wert bedeutet, dass dieser Durchlauf fehlgeschlagen ist und `output/result` leer hinterlassen hat.

**Lösung**

- **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.

Siehe [Eine Methode ausführen](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/execute-a-method.html).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit der Abfolge der Aufrufe Ihres Programms.

## Vorlagen {#ts-templates}

### Problem: Die Vorlagendatei liegt auf dem Gerät, fehlt aber in `system/templates` {#faq-template-not-listed}

**Symptome**

Eine `.png`-Datei liegt im Vorlagenordner, aber `system/templates` führt sie nicht auf.

**Mögliche Ursachen**

- 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.

**Diagnose**

1. Lesen Sie `system/template-dir`. Erwartet: Es nennt den Ordner, der die Datei enthält.
2. Prüfen Sie den Dateinamen. Erwartet: Er endet auf `.png` in Kleinbuchstaben.

**Lösung**

- **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.

Eine Vorlage, die bei laufender Anwendung hinzugefügt wird, kann sofort gesucht werden: Die Datei wird jedes Mal gelesen, nicht beim Start zwischengespeichert. Siehe [Speicherung der Vorlagen](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/template-storage.html).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit `system/template-dir`, `system/templates` und dem Dateinamen.

## Bild-Stream (experimentell) {#ts-stream}

### Problem: Der Bild-Stream liefert keine Ergebnisse {#ts-stream-no-results}

**Symptome**

`control/subscribe/output/stream/active` bleibt `false`, auf `control/subscribe/output/stream/result` treffen keine Ergebnisse ein, oder `control/subscribe/output/stream/statistics/failed-frames` wächst.

**Mögliche Ursachen**

- 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.

**Diagnose**

1. Lesen Sie `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/publish/output/stream/active`. Erwartet: `true`.
2. Lesen Sie `setting/stream/enable` und `setting/stream/address` des Moduls. Erwartet: `true` und der Stream-Ordner der Kamera, zum Beispiel `hdvisionsystems/lumiscan-cam-driver/camera1/control/publish/output/stream`. Sie zeigen, was zuletzt angewendet wurde.
3. Prüfen Sie die Antwort des Schreibvorgangs auf `control/subscribe/execute`. Erwartet: `Ok` (ctrlX: `DL_OK`). Diese Methoden haben keinen `status-text`; der Grund für eine Ablehnung steht im Protokoll der Anwendung.
4. Lesen Sie `control/subscribe/output/stream/active`. Erwartet: `true`.
5. Lesen Sie `received-frames`, `processed-frames` und `failed-frames` unter `control/subscribe/output/stream/statistics/`. Der erste Zähler, der nicht wächst, zeigt, wo die Kette abbricht.
6. Wächst `failed-frames`, lesen Sie `control/subscribe/output/stream/last-failure`. Er nennt den Grund für das letzte fehlgeschlagene Bild, zum Beispiel:
   ```
   a frame of 'hdvisionsystems/lumiscan-cam-driver/camera1/control/publish/output/stream' failed: invalid input: template-name is empty
   ```

**Lösung**

- **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](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#stream-nothing).
- **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`.

Siehe [Vorlagen in einem Bild-Stream finden (experimentell)](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/processing-an-image-stream.html).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit den Werten unter `setting/stream/`, den Zählern unter `control/subscribe/output/stream/statistics/`, `control/subscribe/output/stream/last-failure` und der `<module-id>.json` des Moduls.

## Module, Einstellungen und Lizenzierung {#ts-modules}

### Problem: Meine Einstellungen oder Module sind nach einem Neustart weg {#faq-settings-lost}

**Symptome**

Nach einem Neustart der Anwendung fehlt ein Modul in `system/modules`, oder die Eingaben eines Moduls stehen wieder auf ihren Standardwerten.

**Mögliche Ursachen**

- 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.

Ergebnisse werden nicht gespeichert; sie entstehen beim nächsten Durchlauf. Vorlagendateien sind bereits dauerhaft: Es sind Dateien im Konfigurationsverzeichnis, auf ctrlX OS Teil der aktiven Solution.

**Diagnose**

1. Lesen Sie `system/modules` nach dem Neustart. Erwartet: alle Ihre Module.
2. Prüfen Sie das Konfigurationsverzeichnis (siehe [Allgemeine Prüfungen](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#general-checks)). Erwartet: `lumiscan-template-finder.json` nennt Ihre Module, und für jedes Modul, dessen Einstellungen Sie gespeichert haben, gibt es eine `<module-id>.json`.
3. Lesen Sie das Protokoll der Anwendung beim Start. Erwartet: keine als unlesbar gemeldete Moduldatei, keine übersprungene Einstellung.

**Lösung**

- **Wenn die Einstellungen oder die Modulliste nicht gespeichert wurden:**

  a. Setzen Sie `system/save-module-inputs/input/module-id` (zum Beispiel `module-1`) und schreiben Sie auf `system/save-module-inputs/execute`. Tun Sie das für jedes Modul.

  b. Schreiben Sie auf `system/save-current-modules/execute`.

  c. Prüfen Sie, dass beide Status `1` melden.

- **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 Bild-Stream-Einstellungen eines Moduls brauchen keinen zusätzlichen Schritt: `control/subscribe/execute` speichert sie selbst in `<module-id>.json`. Damit das Modul selbst wieder da ist, speichern Sie zusätzlich die Modulliste. Siehe [Modulverwaltung](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/module-management.html) und [In der Einstellungsdatei gespeichert](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/processing-an-image-stream.html#saving).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit `lumiscan-template-finder.json` und den Moduldateien `<module-id>.json`.

### Problem: Die Anwendung beendet sich kurz nach dem Start {#faq-app-stops-after-start}

**Symptome**

Auf ctrlX OS beendet sich die Anwendung kurz nach dem Start. Ihre Knoten unter `hdvisionsystems/lumiscan-template-finder` verschwinden aus dem Data Layer.

**Mögliche Ursachen**

- 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)](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#ts-licence-unavailable).

**Diagnose**

1. Öffnen Sie das Systemprotokoll von ctrlX OS (ctrlX Logbook oder `journalctl`). Erwartet: Es nennt den Grund und die fehlende Lizenz.
2. Vergleichen Sie die Lizenz mit der ctrlX-Lizenz von LumiScan Template Finder, `SWL-W-XCx-TEMPLxFDxxHDVS-V1NN`. Erwartet: Sie ist auf dem Gerät installiert, auf dem die Anwendung läuft.

**Lösung**

- **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.

Siehe [Lizenz](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/requirements.html#licence) und [Meine ctrlX-App beendet sich kurz nach dem Start](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html#faq-ctrlx-app-stops).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit den Zeilen des Systemprotokolls, die die Lizenz nennen. Für Lizenzen wenden Sie sich an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com).

### Problem: Statuscode `-11` (Lizenz nicht verfügbar) {#ts-licence-unavailable}

**Symptome**

Ein Modul wird mit Statuscode `-11` abgelehnt.

**Mögliche Ursachen**

- 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.

**Diagnose**

1. Zählen Sie die Einträge von `system/modules`. Erwartet: nicht mehr als zehn Module pro Lizenz auf dem Gerät.
2. Lesen Sie `output/status-text` der Operation, die mit `-11` geantwortet hat.

**Lösung**

- **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.

Siehe [Modulverwaltung](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/module-management.html).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit `system/modules`. Für Lizenzen wenden Sie sich an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com).

## Informationen für den Support {#support-information}

Besteht ein Problem weiterhin, senden Sie diese Informationen an den Support:

- **Softwareversion:** die Version von LumiScan Template Finder, die Sie verwenden. Die Dateien in `settings-history/` im Konfigurationsverzeichnis halten sie als `software.version` fest.
- **Plattform:** ctrlX OS (ctrlX CORE oder ctrlX IPC) und die Version von ctrlX OS, oder ein PC mit Windows 11 oder Ubuntu 24.04. Nennen Sie auch die Bezugsquelle: HD Vision Systems oder ctrlX Store.
- **Data Layer:** der ctrlX Data Layer (ctrlX OS) oder LumiScan Keryx (PC). Auf einem PC auch die Data-Layer-Adresse, die die Anwendung verwendet.
- **Protokoll:** das Protokoll der Anwendung zum Zeitpunkt des Fehlers - auf ctrlX OS aus dem ctrlX Logbook oder mit `journalctl`, auf einem PC die Konsolenausgabe der Anwendung. Bevor Sie das Problem reproduzieren, setzen Sie `logLevel` im Block `system` von `lumiscan-template-finder.json` auf `TRACE` und starten Sie die Anwendung neu.
- **Zeitpunkt:** Datum und Uhrzeit des Fehlers.
- **Kommunikationsstatus:** `output/status-code` und `output/status-text` der fehlgeschlagenen Operation und die Antwort des Schreibvorgangs auf `execute` (zum Beispiel `TooManyOperations` oder `DL_TOO_MANY_OPERATIONS`).
- **Konfigurationsdateien:** `lumiscan-template-finder.json`, die `<module-id>.json` des betroffenen Moduls, die Vorlagendatei und, für den Bild-Stream, die Datei in `settings-history/`, die sein Einstellungs-Hash nennt. Wo sie liegen, steht unter [Allgemeine Prüfungen](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/troubleshooting.html#general-checks).

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 an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com). Siehe auch [Bevor Sie den Support kontaktieren](https://docs.hdvisionsystems.com/de/faq.html#faq-before-contacting-support) in der LumiScan-FAQ.