---
title: "FAQ"
description: "Häufige Fragen zu LumiScan QR Code Reader - Bildquelle und Pixelformate, Codes lesen, das Ergebnis, fehlgeschlagene Durchläufe, der Bild-Stream, Standard- und Advanced-Lizenzen."
product: "LumiScan QR Code Reader"
component: "lumiscan-qr-code-reader-de"
version: "1.0.0"
display_version: "1.0.0.5"
latest_version: true
language: "de"
url: "https://docs.hdvisionsystems.com/de/lumiscan-qr-code-reader-de/1.0.0/faq.html"
---

# FAQ – LumiScan QR Code Reader

Kurze Antworten auf häufige Fragen und Fehlermeldungen zu LumiScan QR 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 QR-Codes, die 2D-Symbologie mit einem quadratischen Finder-Muster in drei Ecken. Jeder im Bild gefundene Code wird gemeldet; es gibt keine Begrenzung auf einen Code pro Durchlauf. Es wird keine Vorlage, kein Referenzbild, kein Trainingsschritt und keine Konfiguration benötigt: Sie geben dem Reader die Adresse eines Bildes und rufen `execute` auf.
- **Mehr:** [Beschreibung](https://docs.hdvisionsystems.com/de/lumiscan-qr-code-reader-de/1.0.0/lumiscan-qr-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` angegebenen Bildknoten, den eine andere Anwendung auf demselben Data Layer veröffentlicht - auf ctrlX OS auf **demselben ctrlX CORE oder ctrlX IPC** (ein 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-qr-code-reader-de/1.0.0/lumiscan-qr-code-reader/requirements.html), [Einen Code lesen](https://docs.hdvisionsystems.com/de/lumiscan-qr-code-reader-de/1.0.0/lumiscan-qr-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ß- und Kleinschreibung abgeglichen, und der Unterstrich darf in den Bayer-Namen fehlen (`BayerGR8` und `bayer_gr8` sind dasselbe Format). Bayer-Bilder werden vor der Suche in Farbe umgewandelt. Jedes andere Pixelformat wird abgelehnt, und der Durchlauf 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-qr-code-reader-de/1.0.0/lumiscan-qr-code-reader/requirements.html)

## Codes lesen

### Wie lese ich einen Code? {#faq-read-code}

- **Antwort:** Alle Pfade sind relativ zu `hdvisionsystems/lumiscan-qr-code-reader`.
  - Schreiben Sie die Adresse des Bildknotens in `input/image-address`. Sie wird gemerkt; setzen Sie sie also nur neu, wenn sich die Bildquelle ändert.
  - Schreiben Sie einen leeren Wert in die Methode `execute`. Der Aufruf ist blockierend und kehrt zurück, wenn die Suche beendet ist.
  - Lesen Sie `output/results`: Es enthält jeden QR-Code, der in diesem Bild gefunden wurde.
- **Mehr:** [Einen Code lesen](https://docs.hdvisionsystems.com/de/lumiscan-qr-code-reader-de/1.0.0/lumiscan-qr-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, als Strings, zurück; 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 - kein Fehler.
- **Mehr:** [Das Ergebnis](https://docs.hdvisionsystems.com/de/lumiscan-qr-code-reader-de/1.0.0/lumiscan-qr-code-reader/the-result.html)

### Wie erkenne ich, ob ein Durchlauf 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 Durchlauf 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 Durchlauf lässt `output/results` unverändert; es enthält weiterhin die Codes des vorherigen Durchlaufs.
- **Lösung:** Prüfen Sie das Anwendungsprotokoll, 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 Durchlauf und vergleichen Sie.
- **Mehr:** [Einen Code lesen](https://docs.hdvisionsystems.com/de/lumiscan-qr-code-reader-de/1.0.0/lumiscan-qr-code-reader/reading-a-code.html), [Data-Layer-Referenz](https://docs.hdvisionsystems.com/de/lumiscan-qr-code-reader-de/1.0.0/lumiscan-qr-code-reader/datalayer-reference.html)

### Kann ich die Erkennung feineinstellen, 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 Schreibzugriff darauf ändert also nichts; auch der Bild-Stream liest ihn nicht. Es gibt keine Region of Interest: Jeder Durchlauf durchsucht das gesamte 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-qr-code-reader-de/1.0.0/lumiscan-qr-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 `qr-code` 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-qr-code-reader-de/1.0.0/lumiscan-qr-code-reader/the-result.html)

### Wie lange dauert ein Lesevorgang? {#faq-timing}

- **Antwort:** Das Lesen ist synchron: Der Schreibzugriff auf `execute` kehrt zurück, wenn die Suche beendet ist. Wie lange das dauert, hängt von der Bildgröße ab, da bei jedem Durchlauf das gesamte Bild durchsucht wird.
- **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-qr-code-reader-de/1.0.0/lumiscan-qr-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: Das Schreiben einer Eingabe allein ändert nichts. Alle Pfade sind relativ zu `hdvisionsystems/lumiscan-qr-code-reader`.
  - Stellen Sie sicher, dass der Stream des Cam Driver läuft (`hdvisionsystems/lumiscan-cam-driver/<camera name>/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`, in `control/subscribe/input/address`.
  - Abonnieren Sie `control/subscribe/output/stream/result`.
  - Setzen Sie `control/subscribe/input/enable` auf `true` und schreiben Sie dann in `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-qr-code-reader-de/1.0.0/lumiscan-qr-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:** `qr-code-reader.json` liegt im Konfigurationsverzeichnis der Anwendung: auf ctrlX OS `/var/snap/rexroth-solutions/common/solutions/activeConfiguration/lumiscan-qr-code-reader`; auf einem PC (Windows) `%APP_RESOURCE_DIR%\etc\lumiscan-qr-code-reader` oder ohne `APP_RESOURCE_DIR` `C:\ProgramData\HD Vision Systems GmbH\LumiScan Vision Suite\lumiscan-qr-code\etc\lumiscan-qr-code-reader`. Auf einem PC schreibt `lumiscan-qr-code --generate-settings <folder>` ein Beispiel. Die Datei wird einmal gelesen, beim Start der Anwendung.
- **Mehr:** [In der Einstellungsdatei gespeichert](https://docs.hdvisionsystems.com/de/lumiscan-qr-code-reader-de/1.0.0/lumiscan-qr-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-qr-code-reader-de/1.0.0/troubleshooting.html) beschrieben:

- [Der Reader beendet sich beim Start](https://docs.hdvisionsystems.com/de/lumiscan-qr-code-reader-de/1.0.0/troubleshooting.html#faq-app-stops-after-start)
- [`output/results` ist ein leeres Array](https://docs.hdvisionsystems.com/de/lumiscan-qr-code-reader-de/1.0.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-qr-code-reader-de/1.0.0/troubleshooting.html#faq-stream-refused)
- [Der Stream läuft, aber es treffen keine Ergebnisse ein, oder `failed-frames` wächst](https://docs.hdvisionsystems.com/de/lumiscan-qr-code-reader-de/1.0.0/troubleshooting.html#faq-stream-no-results)
- [Nach einem Neustart streamt der Reader von selbst wieder](https://docs.hdvisionsystems.com/de/lumiscan-qr-code-reader-de/1.0.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-qr-code-reader-de/1.0.0/lumiscan-qr-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-qr-code-reader-de/1.0.0/lumiscan-qr-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 übergreifende [LumiScan-FAQ](https://docs.hdvisionsystems.com/de/faq.html) 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)