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

# FAQ – LumiScan Barcode Reader

Kurze Antworten auf häufige Fragen und Fehlermeldungen zu LumiScan Barcode 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

### Läuft der Reader auf ctrlX OS und auf einem PC? {#faq-platforms}

- **Antwort:** Ja. Auf ctrlX OS (ctrlX CORE oder ctrlX IPC) verwendet er den ctrlX Data Layer; auf einem PC (Windows 11 oder Ubuntu 24.04) verwendet er LumiScan Keryx, den Data Layer von HD Vision Systems für PCs. Die Knotenadressen, Typen und das Verhalten sind auf beiden gleich; ein Programm, das für den einen geschrieben wurde, funktioniert also auch mit dem anderen.
- **Mehr:** [Data-Layer-Referenz](https://docs.hdvisionsystems.com/de/lumiscan-barcode-reader-de/1.0.0/lumiscan-barcode-reader/datalayer-reference.html), [ctrlX Data Layer und LumiScan Keryx](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/platforms.html)

### Welche Barcodes liest der Reader? {#faq-what-codes}

- **Antwort:** Er liest lineare (1D-)Barcodes. Der Reader ist für die gesamte lineare Familie von ZXing konfiguriert und nicht für eine einzelne Symbologie; Code 128, Code 39, EAN-13 und UPC-A werden also unter anderem alle mit demselben Aufruf gelesen. Die Symbologie muss nicht vorab bekannt sein. Jeder im Bild gefundene Code wird gemeldet; es gibt keine Beschränkung auf einen Code pro Lauf. Es werden weder Vorlage, Referenzbild, Trainingsschritt noch Konfiguration benötigt: Sie geben dem Reader die Adresse eines Bildes und rufen `execute` auf.
- **Mehr:** [Beschreibung](https://docs.hdvisionsystems.com/de/lumiscan-barcode-reader-de/1.0.0/lumiscan-barcode-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 veröffentlicht: auf ctrlX OS eine auf **demselben Gerät** (der Zugriff auf einen entfernten Data Layer wird nicht unterstützt), auf einem PC eine, die mit **demselben LumiScan Keryx** verbunden ist. Normalerweise ist das 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-barcode-reader-de/1.0.0/lumiscan-barcode-reader/requirements.html), [Einen Code lesen](https://docs.hdvisionsystems.com/de/lumiscan-barcode-reader-de/1.0.0/lumiscan-barcode-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 Beachtung der Groß- und Kleinschreibung verglichen, und bei den Bayer-Namen darf der Unterstrich entfallen (`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-barcode-reader-de/1.0.0/lumiscan-barcode-reader/requirements.html)

## Codes lesen

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

- **Antwort:** Alle Pfade sind relativ zu `hdvisionsystems/lumiscan-barcode-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 abgeschlossen ist.
  - Lesen Sie `output/results`: Es enthält jeden in diesem Bild gefundenen Barcode.
- **Mehr:** [Einen Code lesen](https://docs.hdvisionsystems.com/de/lumiscan-barcode-reader-de/1.0.0/lumiscan-barcode-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 keine Umrandung angegeben wurde, nicht, dass ein Fehler vorliegt.
- **Mehr:** [Das Ergebnis](https://docs.hdvisionsystems.com/de/lumiscan-barcode-reader-de/1.0.0/lumiscan-barcode-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, mit den Codes des vorherigen Laufs.
- **Lösung:** Prüfen Sie das Protokoll der Anwendung (auf ctrlX OS das Systemprotokoll), in das der Grund geschrieben wird, oder lesen Sie `output/results` vor und nach dem Lauf und vergleichen Sie.
- **Mehr:** [Einen Code lesen](https://docs.hdvisionsystems.com/de/lumiscan-barcode-reader-de/1.0.0/lumiscan-barcode-reader/reading-a-code.html), [Data-Layer-Referenz](https://docs.hdvisionsystems.com/de/lumiscan-barcode-reader-de/1.0.0/lumiscan-barcode-reader/datalayer-reference.html)

### Kann ich die Erkennung feineinstellen, eine Region of Interest festlegen 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, und auch der Bild-Stream liest ihn 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-barcode-reader-de/1.0.0/lumiscan-barcode-reader/datalayer-reference.html)

### Wie kann ich die Codes im Bild eingezeichnet sehen? {#faq-see-results}

- **Antwort:** Öffnen Sie LumiScan Cockpit. Es führt den Reader als Ansicht namens `bar-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.
- **Mehr:** [Das Ergebnis](https://docs.hdvisionsystems.com/de/lumiscan-barcode-reader-de/1.0.0/lumiscan-barcode-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-barcode-reader-de/1.0.0/lumiscan-barcode-reader/requirements.html)

## Bild-Stream (experimentell)

### Kann der Reader jeden Frame eines Kamera-Streams lesen? {#faq-image-stream}

- **Antwort:** Ja, als experimentelle Funktion. Der Reader abonniert den Stream einer Kamera von LumiScan Cam Driver und liest jeden Barcode in jedem Frame, sobald er eintrifft, genau so, wie `execute` ein Bild liest. Alle Pfade sind relativ zu `hdvisionsystems/lumiscan-barcode-reader`.
  - 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`: ein Ergebnis pro Frame, mit der Lineage des Frames.
  - Setzen Sie `control/subscribe/input/enable` auf `true`, und schreiben Sie auf `control/subscribe/execute`. Eine Eingabe allein zu schreiben ändert nichts.
- **Mehr:** [Codes auf einem Bild-Stream lesen](https://docs.hdvisionsystems.com/de/lumiscan-barcode-reader-de/1.0.0/lumiscan-barcode-reader/reading-codes-on-an-image-stream.html), [Streams](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/streams.html)

### Wo speichert der Reader seine Stream-Einstellungen? {#faq-settings-file}

- **Antwort:** In `barcode-reader.json` im Konfigurationsverzeichnis der Anwendung: auf ctrlX OS `/var/snap/rexroth-solutions/common/solutions/activeConfiguration/lumiscan-barcode-reader`, unter Windows `C:\ProgramData\HD Vision Systems GmbH\LumiScan Vision Suite\lumiscan-barcode\etc\lumiscan-barcode-reader` (oder `%APP_RESOURCE_DIR%\etc\lumiscan-barcode-reader`). `control/subscribe/execute` und `control/unsubscribe/execute` speichern dort, was sie anwenden, und nach einem Neustart streamt ein Reader, der gestreamt hat, sofort wieder. Auf einem PC schreibt `lumiscan-barcode --generate-settings <folder>` ein Beispiel, mit dem Sie beginnen können.
- **Mehr:** [In der Einstellungsdatei gespeichert](https://docs.hdvisionsystems.com/de/lumiscan-barcode-reader-de/1.0.0/lumiscan-barcode-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-barcode-reader-de/1.0.0/troubleshooting.html) beschrieben:

- [Der Reader beendet sich beim Start](https://docs.hdvisionsystems.com/de/lumiscan-barcode-reader-de/1.0.0/troubleshooting.html#faq-app-stops-after-start)
- [`output/results` ist ein leeres Array](https://docs.hdvisionsystems.com/de/lumiscan-barcode-reader-de/1.0.0/troubleshooting.html#faq-empty-result)
- [`control/subscribe/execute` wird abgelehnt](https://docs.hdvisionsystems.com/de/lumiscan-barcode-reader-de/1.0.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-barcode-reader-de/1.0.0/troubleshooting.html#ts-stream-no-results)
- [Nach einem Neustart streamt der Reader von selbst wieder](https://docs.hdvisionsystems.com/de/lumiscan-barcode-reader-de/1.0.0/troubleshooting.html#ts-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-barcode-reader-de/1.0.0/lumiscan-barcode-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-barcode-reader-de/1.0.0/lumiscan-barcode-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 erhalte Support? {#faq-support}

- **Antwort:** Siehe die übergreifende [LumiScan-FAQ](https://docs.hdvisionsystems.com/de/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)