--- title: "Fehlerbehebung" description: "Probleme mit LumiScan Aztec Code Reader Schritt für Schritt - ein Reader, der sich beim Start beendet, ein Client, der ihn nach dem Update auf 1.1.0 nicht mehr findet, ein leeres Ergebnis, abgelehnte Stream-Aufrufe, ein Stream ohne Ergebnisse und ein Stream, der von selbst wieder startet." product: "LumiScan Aztec Code Reader" component: "lumiscan-aztec-code-reader-de" version: "1.2.0" display_version: "1.2.0.5" latest_version: true language: "de" url: "https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/troubleshooting.html" --- # Fehlerbehebung – LumiScan Aztec Code Reader Diese Seite beschreibt Probleme mit LumiScan Aztec Code Reader und wie Sie sie lösen. Beginnen Sie mit den [allgemeinen Prüfungen](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/troubleshooting.html#general-checks), und suchen Sie dann unten Ihr Symptom: Jedes Problem nennt seine Symptome, die möglichen Ursachen, eine Diagnose und die Lösung. Probleme des Data Layer selbst sind unter [Fehlerbehebung Data Layer](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html) beschrieben, Lizenzprobleme unter [Fehlerbehebung Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html). ## Allgemeine Prüfungen {#general-checks} 1. **Lesen Sie das Protokoll der Anwendung.** Das Protokoll der Anwendung ist das Systemprotokoll von ctrlX OS (ctrlX OS) oder die Konsolenausgabe der App (PC). Der Reader schreibt den Grund dorthin, wenn ein Lauf fehlschlägt, wenn `control/subscribe/execute` oder `control/unsubscribe/execute` abgelehnt wird, wenn die Quelle des Bild-Streams nicht abonniert werden kann (der erste Fehlschlag), wenn Frames nicht gelesen werden können (höchstens eine Zeile alle 5 Sekunden) und wenn ein Wert in seiner Einstellungsdatei nicht verwendet werden kann. 2. **Prüfen Sie die Adressen.** Alle Knoten liegen direkt unter `hdvisionsystems/lumiscan-aztec-code-reader/`; der Reader hat keine Module. Adressen sind kleingeschrieben. Erwartet: Ihre SPS oder Ihr Client verwendet genau diese Adressen, wie in der [Data-Layer-Referenz](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/datalayer-reference.html) aufgeführt. 3. **Prüfen Sie die Bildquelle.** Die Anwendung, die den Bildknoten veröffentlicht, normalerweise LumiScan Cam Driver, muss auf **demselben ctrlX CORE oder ctrlX IPC** laufen (ctrlX OS) oder mit demselben LumiScan-Keryx-Broker verbunden sein wie der Reader (PC, siehe [LumiScan Keryx auf einem PC](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/keryx.html)). Erwartet: Der in `input/image-address` genannte Knoten stellt `data`, `width`, `height` und `pixel-type` bereit. 4. **Prüfen Sie, ob ein Lauf fehlgeschlagen ist.** Dieser Reader veröffentlicht keinen Knoten `status-code` oder `status-text`. Ein fehlgeschlagener Lauf lässt `output/results` unverändert, mit den Codes des vorherigen Laufs. Lesen Sie `output/results` vor und nach dem Lauf und vergleichen Sie, oder prüfen Sie das Protokoll. Siehe [Woran erkenne ich, ob ein Lauf fehlgeschlagen ist?](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/faq.html#faq-failed-run). 5. **Prüfen Sie die Einstellungsdatei des Bild-Streams.** Der Reader speichert seine Stream-Einstellungen in `aztec-code-reader.json` im Konfigurationsverzeichnis der Anwendung: | Plattform | Konfigurationsverzeichnis | | --- | --- | | ctrlX OS | `/var/snap/rexroth-solutions/common/solutions/activeConfiguration/lumiscan-aztec-code-reader` | | PC (Windows) | `%APP_RESOURCE_DIR%\etc\lumiscan-aztec-code-reader`; ohne `APP_RESOURCE_DIR` `C:\ProgramData\HD Vision Systems GmbH\LumiScan Vision Suite\lumiscan-aztec-code\etc\lumiscan-aztec-code-reader` | Die Datei wird einmal gelesen, beim Start der Anwendung: Von Hand vorgenommene Änderungen wirken beim nächsten Start. Ein Wert, der nicht verwendet werden kann, wird ignoriert und protokolliert; eine Datei, die kein gültiges JSON ist, wird ignoriert und protokolliert. Siehe [In der Einstellungsdatei gespeichert](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/reading-codes-on-an-image-stream.html#saving). ## Problem: Der Reader beendet sich beim Start {#faq-app-stops-after-start} **Symptome** Auf ctrlX OS beendet sich der Reader kurz nach dem Start. Seine Knoten unter `hdvisionsystems/lumiscan-aztec-code-reader` verschwinden aus dem Data Layer. **Mögliche Ursachen** - Die ctrlX-Lizenz `SWL-W-XCx-AZTECCRDSxHDVSx-V1NN` ist auf dem ctrlX-OS-Gerät, auf dem der Reader läuft, nicht verfügbar. Die Lizenz wird beim Start bis zu zehn Sekunden lang geprüft; wird in dieser Zeit keine verfügbar, beendet sich der Reader. **Diagnose** 1. Öffnen Sie das Systemprotokoll von ctrlX OS - erwartet: der Grund für das Beenden. Das Systemprotokoll nennt die fehlende Lizenz. 2. Prüfen Sie die Lizenzen im License Manager von ctrlX OS - erwartet: Die ctrlX-Lizenz `SWL-W-XCx-AZTECCRDSxHDVSx-V1NN` ist auf dem Gerät verfügbar, auf dem der Reader läuft. Ein Lizenzplatz deckt den Reader ab. Die Advanced-Lizenz `SWL-W-XCx-AZTECCRDAxHDVSx-V1NN` wird für den Start nicht benötigt: Ohne sie läuft der Reader mit den Standard-Funktionen. **Lösung** - **Wenn die ctrlX-Lizenz fehlt:** a. Kaufen Sie die Lizenz `SWL-W-XCx-AZTECCRDSxHDVSx-V1NN` im ctrlX Store. b. Aktivieren Sie sie im License Manager von ctrlX OS auf dem Gerät, auf dem der Reader läuft. Folgen Sie dabei der Dokumentation von Bosch Rexroth für ctrlX OS. c. Starten Sie den Reader erneut. Erwartet: Er läuft weiter, und seine Knoten sind im Data Layer. Siehe [Lizenz](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/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-aztec-code-reader-de/1.2.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit den Zeilen des Systemprotokolls von ctrlX OS, die die Lizenz nennen. Für Lizenzen wenden Sie sich an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com). ## Problem: Meine SPS oder mein REST-Client findet den Reader nach dem Update auf 1.1.0 nicht mehr {#faq-base-path-moved} **Symptome** Nach dem Update auf Version 1.1.0 erreicht eine SPS, ein REST-Client oder ein gespeicherter App-Zustand, der vorher funktioniert hat, den Reader nicht mehr: Die Knoten, die er unter `hdvisionsystems/lumiscan-aztec-code` adressiert, werden nicht gefunden. **Mögliche Ursachen** - In 1.1.0 hat sich der Basispfad von `hdvisionsystems/lumiscan-aztec-code` zu `hdvisionsystems/lumiscan-aztec-code-reader` geändert, dem Namen, den die anderen Code Reader bereits verwenden. Alles, was den alten Pfad adressiert, muss umgestellt werden. **Diagnose** 1. Prüfen Sie die Adressen, die Ihre SPS, Ihr REST-Client oder der gespeicherte App-Zustand verwendet - erwartet: Sie beginnen mit `hdvisionsystems/lumiscan-aztec-code-reader/`. 2. Lesen Sie einen Knoten unter dem neuen Basispfad, zum Beispiel `hdvisionsystems/lumiscan-aztec-code-reader/input/image-address` - erwartet: Der Knoten wird gefunden. **Lösung** - **Wenn der Client noch den alten Basispfad verwendet:** a. Stellen Sie alles um, was `hdvisionsystems/lumiscan-aztec-code` adressiert: eine SPS, einen REST-Client, einen gespeicherten App-Zustand. b. Ändern Sie nur das Präfix in `hdvisionsystems/lumiscan-aztec-code-reader`. Die Knotennamen unterhalb der Anwendung sind unverändert. c. Lesen oder schreiben Sie erneut einen Knoten unter der neuen Adresse. Erwartet: Der Knoten wird gefunden. Siehe [Beschreibung](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/description.html), [Release Notes: v1.1.0](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/release-notes/v1-1-0.html) und [Ein Knoten ist „not found"](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#node-not-found). **Wenn das Problem weiterhin besteht** Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit der Adresse, die Ihr Client verwendet, und der Antwort, die er erhält. ## Problem: `output/results` ist ein leeres Array {#faq-empty-result} **Symptome** Nachdem `execute` zurückgekehrt ist, enthält `output/results` ein leeres Array: `CodeDetectResultArray.results` hat keinen Eintrag. Im Bild-Stream hat ein Ergebnis auf `control/subscribe/output/stream/result` ein leeres Array `results`. **Mögliche Ursachen** - Das Bild enthält keinen Aztec-Code. Ein leeres `output/results` ist kein Fehler: Es bedeutet, dass das Bild erfolgreich gelesen wurde und keinen Aztec-Code enthielt. Ein Lauf, der nichts gefunden hat, veröffentlicht ein leeres Array und keinen Fehler. - Der Code ist kein Aztec-Code. Der Reader liest Aztec-Codes, die kompakte 2D-Symbologie mit einem Bullseye-Suchmuster in der Mitte. Data-Matrix-Codes, QR-Codes und lineare Barcodes lesen seine Schwester-Apps. - `input/image-address` nennt einen Bildknoten, der den Code nicht zeigt. Jeder Lauf liest den gesamten aktuellen Inhalt des dort genannten Bildknotens. - Der letzte Lauf ist fehlgeschlagen, und das leere Array ist das Ergebnis eines früheren Laufs. Ein fehlgeschlagener Lauf lässt `output/results` unverändert. Ein Lauf schlägt fehl, wenn das Bild nicht gelesen werden kann: keine Adresse gesetzt, eine Adresse, die sich nicht auflösen lässt, ein fehlender oder zu kurzer `data`-Puffer oder ein nicht unterstütztes Pixelformat. **Diagnose** 1. Lesen Sie das Protokoll der Anwendung zum Zeitpunkt des Laufs - erwartet: kein Fehlschlag. Ein fehlgeschlagener Lauf schreibt seinen Grund dorthin: in das Systemprotokoll von ctrlX OS (ctrlX OS) oder die Konsolenausgabe der App (PC). 2. Lesen Sie `input/image-address` - erwartet: die Adresse des Bildknotens der Kamera, die den Code sieht, zum Beispiel `hdvisionsystems/lumiscan-cam-driver/camera1/output/image`. 3. Prüfen Sie die Art des Codes - erwartet: ein Aztec-Code, mit einem Bullseye-Suchmuster in der Mitte. **Lösung** - **Wenn das Bild keinen Aztec-Code enthält:** Mit dem Reader ist alles in Ordnung. Rufen Sie `execute` erneut auf, wenn der Bildknoten ein Bild mit dem Code enthält. - **Wenn der Code kein Aztec-Code ist:** Verwenden Sie die Schwester-App für seine Symbologie: LumiScan DMC Reader, LumiScan QR Code Reader oder LumiScan Barcode Reader. Sie arbeiten auf dieselbe Weise. - **Wenn `input/image-address` einen anderen Bildknoten nennt:** a. Schreiben Sie die Adresse des richtigen Bildknotens in `input/image-address`. Es ist die Adresse des Bildknotens selbst, nicht die seines Kindknotens `data`. Die Adresse wird gemerkt. b. Schreiben Sie einen leeren Wert in `execute`. Erwartet: `output/results` enthält einen Eintrag pro Code. - **Wenn der letzte Lauf fehlgeschlagen ist:** Beseitigen Sie den Grund, den das Protokoll nennt: Setzen Sie `input/image-address`, korrigieren Sie eine Adresse, die sich nicht auflösen lässt, oder sorgen Sie dafür, dass die Bildquelle vollständige `data` in einem unterstützten Pixelformat liefert (siehe [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/requirements.html)). Schreiben Sie dann erneut einen leeren Wert in `execute`. Erwartet: Das Protokoll zeigt für diesen Lauf keinen Fehlschlag. Siehe [Einen Code lesen](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/reading-a-code.html) und [Das Ergebnis](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/the-result.html). **Wenn das Problem weiterhin besteht** Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit dem Wert von `input/image-address`, `width`, `height` und `pixel-type` dieses Bildknotens und der Symbologie des Codes. ## Problem: `control/subscribe/execute` antwortet mit `Rejected` (ctrlX `DL_INVALID_VALUE`) oder `CreationFailed` (ctrlX `DL_CREATION_FAILED`) {#faq-stream-refused} **Symptome** Ein Schreibvorgang auf `control/subscribe/execute` (oder auf `control/unsubscribe/execute`) antwortet mit `Rejected` (ctrlX `DL_INVALID_VALUE`) oder `CreationFailed` (ctrlX `DL_CREATION_FAILED`) statt mit `Ok` (ctrlX `DL_OK`). Nichts hat sich geändert: `setting/stream/` zeigt weiterhin die zuvor angewendeten Werte. **Mögliche Ursachen** - `Rejected` / `DL_INVALID_VALUE` von `control/subscribe/execute`: Stream-Modus ohne Adresse oder eine Warteschlangengröße außerhalb von `1` bis `64`. - `Rejected` / `DL_INVALID_VALUE` von `control/unsubscribe/execute`: Die Adresse ist nicht die Quelle, oder es gibt keine Quelle. - `CreationFailed` / `DL_CREATION_FAILED`: Die Einstellungsdatei `aztec-code-reader.json` konnte nicht geschrieben werden, zum Beispiel weil sie kein gültiges JSON ist. **Diagnose** 1. Lesen Sie die Antwort des Methodenaufrufs - erwartet: `Ok` oder `DL_OK`. `Rejected` oder `DL_INVALID_VALUE` weist auf eine Eingabe hin, `CreationFailed` oder `DL_CREATION_FAILED` auf die Einstellungsdatei. 2. Lesen Sie das Protokoll der Anwendung - erwartet: der Grund für die Ablehnung. Auf dem ctrlX Data Layer trägt ein abgelehnter Aufruf keinen Grund; der Reader schreibt ihn in sein Protokoll. 3. Lesen Sie nach einem abgelehnten `control/subscribe/execute` die Knoten `control/subscribe/input/enable`, `control/subscribe/input/address` und `control/subscribe/input/queue-size` - erwartet: eine Adresse, sobald `enable` `true` ist, und eine Warteschlangengröße von `1` bis `64`. 4. Vergleichen Sie nach einem abgelehnten `control/unsubscribe/execute` den Wert von `control/unsubscribe/input/address` mit `setting/stream/address` - erwartet: dieselbe Adresse. Ein `/` an einem der beiden Enden zählt nicht. 5. Öffnen Sie nach `CreationFailed` oder `DL_CREATION_FAILED` die Datei `aztec-code-reader.json` im Konfigurationsverzeichnis (siehe [Allgemeine Prüfungen](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/troubleshooting.html#general-checks)) - erwartet: eine gültige JSON-Datei. **Lösung** - **Wenn der Stream-Modus keine Adresse hat:** Schreiben Sie den Stream-Ordner der Kamera, zum Beispiel `hdvisionsystems/lumiscan-cam-driver/camera1/control/publish/output/stream`, in `control/subscribe/input/address`, und schreiben Sie dann erneut auf `control/subscribe/execute`. Erwartet: `Ok` oder `DL_OK`. - **Wenn die Warteschlangengröße außerhalb von `1` bis `64` liegt:** Schreiben Sie einen Wert von `1` bis `64` in `control/subscribe/input/queue-size`, und schreiben Sie dann erneut auf `control/subscribe/execute`. Erwartet: `Ok` oder `DL_OK`. - **Wenn die zu entfernende Adresse nicht die Quelle ist:** Schreiben Sie die Adresse, die `setting/stream/address` anzeigt, in `control/unsubscribe/input/address`, und schreiben Sie dann erneut auf `control/unsubscribe/execute`. Ist `setting/stream/address` leer, gibt es keine Quelle, die entfernt werden kann. - **Wenn die Einstellungsdatei nicht geschrieben werden konnte:** a. Korrigieren Sie `aztec-code-reader.json`, sodass die Datei gültiges JSON ist. Auf einem PC schreibt `lumiscan-aztec-code --generate-settings ` ein Beispiel, mit dem Sie beginnen können. b. Schreiben Sie erneut auf `control/subscribe/execute`. Erwartet: `Ok` oder `DL_OK`, und `setting/stream/` zeigt die neuen Werte. Von Hand vorgenommene Änderungen an der Datei wirken beim nächsten Start der Anwendung. Siehe [Die Quelle ändern](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/reading-codes-on-an-image-stream.html#subscribing) und [Ergebnisse eines Methodenaufrufs](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/status-codes.html#method-results). **Wenn das Problem weiterhin besteht** Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit der Antwort des Methodenaufrufs, den Werten der Eingaben von `control/subscribe` (oder von `control/unsubscribe/input/address`) und `aztec-code-reader.json`. ## Problem: Der Stream läuft, aber es treffen keine Ergebnisse ein, oder `failed-frames` steigt {#faq-stream-no-results} **Symptome** Nach `control/subscribe/execute` trifft auf `control/subscribe/output/stream/result` kein Ergebnis ein, oder der Zähler `control/subscribe/output/stream/statistics/failed-frames` steigt. **Mögliche Ursachen** - Der Stream des Readers läuft nicht: Die Eingaben von `control/subscribe` wurden geschrieben, aber `control/subscribe/execute` wurde nicht aufgerufen. Eine Eingabe allein zu schreiben ändert nichts. - Von der Quelle treffen keine Frames ein: Der Stream des Cam Driver läuft nicht, oder `control/subscribe/input/address` ist nicht der Stream-Ordner der Kamera. Der Stream des Cam Driver bleibt über einen Neustart des Cam Driver nicht erhalten. - Die Quelle kann nicht abonniert werden. Der Reader versucht es dann alle 5 Sekunden erneut, solange der Stream läuft. - Frames treffen ein, können aber nicht gelesen werden, zum Beispiel Frames in einem Pixelformat, das der Reader nicht unterstützt, oder Frames, deren Pixel die angegebene Größe nicht ausfüllen. - Ergebnisse werden veröffentlicht, aber Ihr Client abonniert `control/subscribe/output/stream/result` nicht. Ein Lesen des Knotens liefert nur das neueste Ergebnis. **Diagnose** 1. Lesen Sie `control/subscribe/output/stream/active` - erwartet: `true`. Ist der Wert `false`, lesen Sie `setting/stream/enable` und `setting/stream/address` - erwartet: `true` und der Stream-Ordner der Kamera. 2. Lesen Sie `hdvisionsystems/lumiscan-cam-driver//control/publish/output/stream/active` - erwartet: `true`. 3. Lesen Sie `control/subscribe/output/stream/statistics/received-frames` zweimal, im Abstand von einigen Sekunden - erwartet: Der Wert steigt. Die Zähler werden etwa viermal pro Sekunde aktualisiert, solange der Stream läuft. 4. Lesen Sie `statistics/failed-frames` und `control/subscribe/output/stream/last-failure` - erwartet: `failed-frames` steigt nicht, und `last-failure` ist leer. `last-failure` sagt, warum der letzte Frame, der nicht gelesen werden konnte, fehlgeschlagen ist; der Knoten wird geleert, wenn der Stream startet. 5. Lesen Sie `statistics/processed-frames` - erwartet: Der Wert steigt. Für jeden verarbeiteten Frame wird ein Ergebnis auf `control/subscribe/output/stream/result` veröffentlicht. 6. Lesen Sie das Protokoll der Anwendung - erwartet: kein Fehlschlag beim Abonnieren der Quelle und keine fehlgeschlagenen Frames. **Lösung** - **Wenn der Stream des Readers nicht läuft:** a. Schreiben Sie den Stream-Ordner der Kamera in `control/subscribe/input/address`. b. Setzen Sie `control/subscribe/input/enable` auf `true`. c. Schreiben Sie auf `control/subscribe/execute`. Erwartet: `Ok` oder `DL_OK`, danach ist `control/subscribe/output/stream/active` `true`. - **Wenn der Stream des Cam Driver nicht läuft:** Starten Sie ihn, siehe das Handbuch des Cam Driver, *Bilder streamen*. Sein Stream bleibt über einen Neustart nicht erhalten: Verbinden Sie nach jedem Start des Cam Driver die Kamera, und rufen Sie seine Methode `control/publish/execute` mit `enable` = `true` auf. Der Stream des Readers kann vor dem Stream des Cam Driver gestartet werden; Ergebnisse treffen ein, sobald Frames eintreffen. - **Wenn die Adresse nicht der Stream-Ordner der Kamera ist:** Schreiben Sie den Ordner, zum Beispiel `hdvisionsystems/lumiscan-cam-driver/camera1/control/publish/output/stream`, in `control/subscribe/input/address`, und schreiben Sie auf `control/subscribe/execute`. Der Reader liest den Knoten `frame` des Ordners. Erwartet: `received-frames` steigt. - **Wenn die Quelle nicht abonniert werden kann:** Stellen Sie sicher, dass der Cam Driver läuft und den in `control/subscribe/input/address` genannten Stream-Ordner veröffentlicht. Solange der Stream läuft, versucht der Reader die Quelle alle 5 Sekunden erneut; bei derselben Adresse müssen Sie nicht erneut ausführen. - **Wenn Frames nicht gelesen werden können:** Lesen Sie den Grund in `control/subscribe/output/stream/last-failure`. Stellen Sie sicher, dass die Frames ein unterstütztes Pixelformat verwenden: `Mono8`, `Mono12`, `RGB8`, `RGB12`, `BGR8`, `BGR12`, `Bayer_GR8`, `Bayer_RG8`, `Bayer_GR12` oder `Bayer_RG12` (siehe [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/requirements.html)). Erwartet: `failed-frames` steigt nicht mehr. - **Wenn `processed-frames` steigt, Ihr Client aber nichts erhält:** Abonnieren Sie `control/subscribe/output/stream/result`, um jedes Ergebnis zu erhalten. Oder setzen Sie `control/subscribe/input/keep-latest-output` auf `true`, und schreiben Sie auf `control/subscribe/execute`: Der Reader schreibt dann jedes Stream-Ergebnis zusätzlich in `output/results`. `krxclient subscribe hdvisionsystems/lumiscan-aztec-code-reader/control/subscribe/output/stream/result --count 5` zeigt, dass Ergebnisse eintreffen; es zeigt einen Flatbuffer nur mit seiner Größe an. Ein Frame ohne Aztec-Code ergibt ein Ergebnis mit einem leeren Array `results`, siehe [Problem: `output/results` ist ein leeres Array](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/troubleshooting.html#faq-empty-result). Siehe auch [Die Statistik lesen](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/reading-codes-on-an-image-stream.html#statistics) und [Ein Stream liefert nichts](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#stream-nothing). **Wenn das Problem weiterhin besteht** Der Bild-Stream ist experimentell. Auf ctrlX OS wurde er nicht unter Linux, nicht auf dem ctrlX Data Layer und nicht mit einer echten Kamera verifiziert. Auf einem PC wurde er nur unter Windows mit LumiScan Keryx und simulierten Bildern getestet; er wurde nicht mit einer echten Kamera verifiziert. Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit den Werten von `control/subscribe/output/stream/active`, `control/subscribe/output/stream/last-failure`, den Zählern unter `control/subscribe/output/stream/statistics/` und `setting/stream/` sowie dem Wert von `control/publish/output/stream/active` des Cam Driver. ## Problem: Nach einem Neustart streamt der Reader von selbst wieder {#faq-stream-restart} **Symptome** Nach einem Neustart der Anwendung ist `control/subscribe/output/stream/active` `true`, und auf `control/subscribe/output/stream/result` treffen Ergebnisse ein, obwohl Ihr Programm nichts ausgeführt hat. **Mögliche Ursachen** - Der Reader startet so, wie er war. Das ist beabsichtigt: `control/subscribe/execute` und `control/unsubscribe/execute` speichern, was sie anwenden, im Abschnitt `stream` von `aztec-code-reader.json`. Nach einem Neustart abonniert der Reader dieselbe Quelle und startet, wenn `stream.enable` `true` ist, seinen Stream sofort. - `stream.enable` wurde in `aztec-code-reader.json` von Hand auf `true` gesetzt. `true` startet den Stream beim Start der Anwendung. **Diagnose** 1. Lesen Sie `setting/stream/enable` und `setting/stream/address` - sie zeigen, was zuletzt angewendet wurde, so wie die Einstellungsdatei es speichert. Erwartet, wenn der Reader nach einem Start nicht streamen soll: `setting/stream/enable` ist `false`. 2. Öffnen Sie `aztec-code-reader.json` im Konfigurationsverzeichnis (siehe [Allgemeine Prüfungen](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/troubleshooting.html#general-checks)) - erwartet, wenn der Reader nach einem Start nicht streamen soll: `stream.enable` ist `false` oder fehlt. **Lösung** - **Wenn der Reader nach einem Start nicht streamen soll:** Setzen Sie `control/subscribe/input/enable` auf `false`, und schreiben Sie dann auf `control/subscribe/execute`. Das stoppt den Stream sofort und wird in `aztec-code-reader.json` gespeichert; der Reader startet beim nächsten Mal also außerhalb des Stream-Modus. Der Frame, der gerade gelesen wird, wird zuerst abgeschlossen. Erwartet: `control/subscribe/output/stream/active` ist `false`, und `setting/stream/enable` ist `false`. - **Wenn der Reader auch die Quelle nicht behalten soll:** Schreiben Sie die Adresse, die `setting/stream/address` anzeigt, in `control/unsubscribe/input/address`, und schreiben Sie dann auf `control/unsubscribe/execute`. Damit endet der Stream-Modus. Erwartet: `setting/stream/address` ist leer. Siehe [In der Einstellungsdatei gespeichert](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/reading-codes-on-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-aztec-code-reader-de/1.2.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit `aztec-code-reader.json` und den Werten von `setting/stream/`. ## Informationen für den Support {#support-information} Besteht ein Problem weiterhin, senden Sie diese Informationen an den Support: - **Software-Version:** die Version von LumiScan Aztec Code Reader, die Sie einsetzen. Die Dateien, die der Bild-Stream in `settings-history/` im Konfigurationsverzeichnis ablegt, 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. - **Data Layer:** der ctrlX Data Layer (ctrlX OS) oder LumiScan Keryx (PC). Auf einem PC zusätzlich die Broker-Adresse, die der Reader verwendet; jede App nennt sie beim Start in ihrem Protokoll. - **Protokoll:** das Protokoll der Anwendung aus der Zeit des Fehlers: das Systemprotokoll von ctrlX OS (ctrlX OS) oder die Konsolenausgabe der App (PC). - **Zeitpunkt:** Datum und Uhrzeit des Fehlers. - **Kommunikationsstatus:** die Antwort eines abgelehnten Methodenaufrufs (zum Beispiel `Rejected` oder `DL_INVALID_VALUE`) und die Knotenwerte, die der Eintrag des Problems nennt. - **Konfigurationsdateien:** `aztec-code-reader.json` und die Dateien in `settings-history/` aus dem Konfigurationsverzeichnis (siehe [Allgemeine Prüfungen](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.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).