--- title: "FAQ" description: "Häufige Fragen zu LumiScan Aztec Code Reader - Bildquelle und Pixelformate, Codes lesen, das Ergebnis, fehlgeschlagene Läufe, der Bild-Stream, Standard- und Advanced-Lizenzen." 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/faq.html" --- # FAQ – LumiScan Aztec Code Reader Kurze Antworten auf häufige Fragen und Fehlermeldungen zu LumiScan Aztec Code Reader. Jeder Eintrag verweist auf die Seite mit den Details. > [!TIP] > Durchsuchen Sie diese Seite nach der genauen Fehlermeldung. Jeder Eintrag hat einen festen Anker (zum Beispiel `#faq-failed-run`). ## Voraussetzungen und Einrichtung ### Welche Codes liest der Reader? {#faq-what-codes} - **Antwort:** Er liest Aztec-Codes, die kompakte 2D-Symbologie mit einem Bullseye-Suchmuster in der Mitte, die keine Ruhezone benötigt. Jeder im Bild gefundene Code wird gemeldet; es gibt keine Begrenzung auf einen Code pro Lauf. Es sind keine Vorlage, kein Referenzbild, kein Trainingsschritt und keine Konfiguration nötig: Sie geben dem Reader die Adresse eines Bildes und rufen `execute` auf. - **Mehr:** [Beschreibung](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/description.html) ### Welche Bildquelle benötigt der Reader? {#faq-image-source} - **Antwort:** Der Reader spricht nicht selbst mit einer Kamera. Er liest den in `input/image-address` genannten Bildknoten, den eine andere Anwendung auf demselben Data Layer veröffentlicht - auf ctrlX OS auf **derselben ctrlX CORE oder demselben ctrlX IPC** (der Zugriff auf einen entfernten Data Layer wird nicht unterstützt), auf einem PC über denselben LumiScan-Keryx-Broker - normalerweise LumiScan Cam Driver, zum Beispiel `hdvisionsystems/lumiscan-cam-driver/camera1/output/image`. Der Knoten muss `data` (rohe, unkomprimierte uint8-Pixeldaten), `width`, `height` und `pixel-type` (Name des GenICam-Pixelformats) bereitstellen. Geben Sie die Adresse des Bildknotens selbst an, nicht die seines Kindknotens `data`: Der Reader hängt `/data`, `/width`, `/height` und `/pixel-type` an. - **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/requirements.html), [Einen Code lesen](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/reading-a-code.html) ### Welche Pixelformate werden unterstützt? {#faq-pixel-formats} - **Antwort:** `Mono8`, `Mono12`, `RGB8`, `RGB12`, `BGR8`, `BGR12`, `Bayer_GR8`, `Bayer_RG8`, `Bayer_GR12` und `Bayer_RG12`. Der Name wird ohne Rücksicht auf Groß-/Kleinschreibung verglichen, und bei den Bayer-Namen darf der Unterstrich weggelassen werden (`BayerGR8` und `bayer_gr8` sind dasselbe Format). Bayer-Bilder werden vor der Suche in Farbbilder umgewandelt. Jedes andere Pixelformat wird abgelehnt, und der Lauf liefert kein Ergebnis. Die Bilddaten müssen für das angegebene Format mindestens `width x height x bytes-per-pixel` Bytes umfassen; ein kürzerer Puffer wird abgelehnt. - **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/requirements.html) ## Codes lesen ### Wie lese ich einen Code? {#faq-read-code} - **Antwort:** Alle Pfade sind relativ zu `hdvisionsystems/lumiscan-aztec-code-reader`. - Schreiben Sie die Adresse des Bildknotens nach `input/image-address`. Sie wird gemerkt; setzen Sie sie also nur neu, wenn sich die Bildquelle ändert. - Schreiben Sie einen leeren Wert auf die Methode `execute`. Der Aufruf ist blockierend und kehrt zurück, wenn die Suche abgeschlossen ist. - Lesen Sie `output/results`: Der Knoten enthält jeden in diesem Bild gefundenen Aztec-Code. - **Mehr:** [Einen Code lesen](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/reading-a-code.html) ### Was enthält ein Ergebniseintrag? {#faq-result-fields} - **Antwort:** `output/results` ist ein FlatBuffer (`CodeDetectResultArray.results`) mit einem Eintrag pro Code: `center` (ein `Point2f` mit `x` und `y` in Bildpixeln), `text` (der dekodierte Inhalt), `score` (wie sicher das Leseergebnis ist) und `polygons` (die Eckpunkte, die den Code umreißen). Auf ctrlX OS kommen die Zahlen über die ctrlX REST API in Anführungszeichen zurück, als Strings; parsen Sie sie also als Zahlen. `center` und `text` sind immer vorhanden; `polygons` kann bei einem Eintrag fehlen, was bedeutet, dass kein Umriss angegeben wurde, nicht, dass ein Fehler vorliegt. - **Mehr:** [Das Ergebnis](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/the-result.html) ### Woran erkenne ich, ob ein Lauf fehlgeschlagen ist? Es gibt keinen Knoten `status-code`. {#faq-failed-run} - **Ursache:** Dieser Reader veröffentlicht keinen Knoten `status-code` oder `status-text` und gibt keinen Identifier zurück. 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. Ein fehlgeschlagener Lauf lässt `output/results` unverändert; der Knoten enthält weiterhin die Codes des vorherigen Laufs. - **Lösung:** Prüfen Sie das Protokoll der Anwendung, in das der Grund geschrieben wird (auf ctrlX OS das Systemprotokoll von ctrlX OS, auf einem PC die Konsolenausgabe der App), oder lesen Sie `output/results` vor und nach dem Lauf und vergleichen Sie. - **Mehr:** [Einen Code lesen](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/reading-a-code.html), [Data-Layer-Referenz](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/datalayer-reference.html) ### Kann ich die Erkennung einstellen, eine Region of Interest setzen oder Module anlegen? {#faq-no-settings} - **Antwort:** Nein, nicht in dieser Version. `input/parameter` enthält keine Einstellungen (seine Tabelle `DetectionParameters` ist leer), ein Schreibvorgang darauf ändert also nichts; der Bild-Stream liest ihn ebenfalls nicht. Es gibt keine Region of Interest: Jeder Lauf durchsucht das ganze Bild. Es gibt keine Module: ein Reader pro Installation, unter einem einzigen Basispfad. Es gibt auch kein Ergebnisbild; verwenden Sie LumiScan Cockpit, um die Codes zu sehen. - **Mehr:** [Data-Layer-Referenz](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/datalayer-reference.html) ### Wie kann ich die Codes im Bild gezeichnet sehen? {#faq-see-results} - **Antwort:** Öffnen Sie LumiScan Cockpit. Es führt den Reader als Ansicht namens `aztec-code` auf und zeichnet ein Rechteck um jeden Code, beschriftet mit dem dekodierten Text und dem Score. Ein Code, der gefunden, aber nicht dekodiert wurde, hat keinen Text und wird nur mit seinem Score beschriftet. Cockpit zeichnet die Ergebnisse des Bild-Streams noch nicht. - **Mehr:** [Das Ergebnis](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/the-result.html) ### Wie lange dauert ein Lesevorgang? {#faq-timing} - **Antwort:** Das Lesen ist synchron: Der Schreibvorgang auf `execute` kehrt zurück, wenn die Suche abgeschlossen ist. Wie lange das dauert, hängt von der Bildgröße ab, da bei jedem Lauf das ganze Bild durchsucht wird. - **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/requirements.html) ## Bild-Stream (experimentell) ### Wie lese ich die Codes in jedem Frame eines Kamera-Streams? {#faq-stream-setup} - **Antwort:** Verwenden Sie den Bild-Stream (experimentell). Nur `control/subscribe/execute` wendet seine Eingaben an: Eine Eingabe allein zu schreiben ändert nichts. Alle Pfade sind relativ zu `hdvisionsystems/lumiscan-aztec-code-reader`. - Stellen Sie sicher, dass der Stream des Cam Driver läuft (`hdvisionsystems/lumiscan-cam-driver//control/publish/output/stream/active` ist `true`). - Schreiben Sie den Stream-Ordner der Kamera, zum Beispiel `hdvisionsystems/lumiscan-cam-driver/camera1/control/publish/output/stream`, nach `control/subscribe/input/address`. - Abonnieren Sie `control/subscribe/output/stream/result`. - Setzen Sie `control/subscribe/input/enable` auf `true` und schreiben Sie dann auf `control/subscribe/execute`. Die Ergebnisse treffen ein, sobald `control/subscribe/output/stream/active` `true` ist. - **Mehr:** [Codes auf einem Bild-Stream 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#setting-up), [Streams](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/streams.html) ### Wo liegt die Einstellungsdatei des Readers? {#faq-settings-file} - **Antwort:** `aztec-code-reader.json` liegt im Konfigurationsverzeichnis der Anwendung: auf ctrlX OS `/var/snap/rexroth-solutions/common/solutions/activeConfiguration/lumiscan-aztec-code-reader`; auf einem PC (Windows) `%APP_RESOURCE_DIR%\etc\lumiscan-aztec-code-reader` oder ohne `APP_RESOURCE_DIR` `C:\ProgramData\HD Vision Systems GmbH\LumiScan Vision Suite\lumiscan-aztec-code\etc\lumiscan-aztec-code-reader`. Auf einem PC schreibt `lumiscan-aztec-code --generate-settings ` ein Beispiel. Die Datei wird einmal gelesen, beim Start der Anwendung. - **Mehr:** [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) ## Fehlerbehebung {#troubleshooting} Probleme und Fehlermeldungen sind Schritt für Schritt unter [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/troubleshooting.html) beschrieben: - [Der Reader beendet sich beim Start](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/troubleshooting.html#faq-app-stops-after-start) - [Meine SPS oder mein REST-Client findet den Reader nach dem Update auf 1.1.0 nicht mehr](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/troubleshooting.html#faq-base-path-moved) - [`output/results` ist ein leeres Array](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/troubleshooting.html#faq-empty-result) - [`control/subscribe/execute` antwortet mit `Rejected` (ctrlX `DL_INVALID_VALUE`) oder `CreationFailed` (ctrlX `DL_CREATION_FAILED`)](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/troubleshooting.html#faq-stream-refused) - [Der Stream läuft, aber es treffen keine Ergebnisse ein, oder `failed-frames` steigt](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/troubleshooting.html#faq-stream-no-results) - [Nach einem Neustart streamt der Reader von selbst wieder](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/troubleshooting.html#faq-stream-restart) ## Lizenzierung und Support ### Standard- oder Advanced-Lizenz - welche verwendet der Reader? {#faq-standard-advanced} - **Antwort:** Ist eine Advanced-Lizenz verfügbar, verwendet die Anwendung sie automatisch. Ist keine verfügbar, läuft sie mit den Standard-Funktionen, statt den Start zu verweigern. - **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/requirements.html#licence), [FAQ zur Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/faq.html) ### Welche Lizenz benötige ich? {#faq-licence} - **Antwort:** Ein Lizenzplatz deckt den Reader ab, da es einen Reader pro Installation gibt. Bezugswege: - Bei HD Vision Systems gekauft: Die Lizenz liegt auf einem LumiScan Key (Windows 11 oder Ubuntu 24.04). Pro Gerät, auf dem die Software gleichzeitig läuft, wird ein LumiScan Key benötigt; Keys können zwischen Geräten getauscht werden. - Im ctrlX Store für Windows 11 gekauft: ctrlX WORKS plus ein LumiScan Key. - Im ctrlX Store für ctrlX OS (ctrlX CORE oder IPC) gekauft: eine ctrlX-Lizenz, kein Key. - **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-aztec-code-reader-de/1.2.0/lumiscan-aztec-code-reader/requirements.html#licence), [FAQ zur Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/faq.html) ### Wo finde ich weitere Antworten oder Support? {#faq-support} - **Antwort:** Siehe die [LumiScan-FAQ](https://docs.hdvisionsystems.com/de/faq.html) der gesamten Dokumentation und für den Data Layer auf beiden Plattformen die [Data Layer FAQ](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/faq.html). 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). - **Mehr:** [FAQ zur Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/faq.html)