---
title: "Voraussetzungen"
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/lumiscan-barcode-reader/requirements.html"
---

# Voraussetzungen – LumiScan Barcode Reader

## Lizenz {#licence}

Wie LumiScan Barcode Reader lizenziert wird, hängt davon ab, wo Sie es gekauft haben und wo es läuft:

| Gekauft bei | Läuft auf | Lizenzierung |
| --- | --- | --- |
| HD Vision Systems | Windows 11 oder Ubuntu 24.04 | Die Lizenz liegt auf Ihrem LumiScan Key. Sie ist ein Einmalkauf und wird nicht verlängert.<br><br>[Lizenzierungsweg: gekauft bei HD Vision Systems](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/path-hdvs.html) |
| ctrlX Store | Windows 11 | Die Lizenz liegt in ctrlX WORKS. Zusätzlich ist der LumiScan Key erforderlich; er schützt die Software vor Reverse Engineering.<br><br>[Lizenzierungsweg: ctrlX Store, Windows](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/path-ctrlx-windows.html) |
| ctrlX Store | ctrlX OS (ctrlX CORE oder IPC) | ctrlX-Lizenz `SWL-W-XCx-BARxxCRDSxHDVSx-V1NN`, eine Lizenz pro App-Instanz. Advanced-Funktionen benötigen zusätzlich `SWL-W-XCx-BARxxCRDAxHDVSx-V1NN`.<br><br>[Lizenzierungsweg: ctrlX Store, ctrlX OS](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/path-ctrlx-os.html) |

Jedes Gerät, auf dem LumiScan Barcode Reader gleichzeitig läuft, benötigt einen eigenen LumiScan Key. Keys können zwischen Geräten ausgetauscht werden.

Wie Sie die CodeMeter Runtime installieren und Lizenzen anfordern, verlängern und an einem anderen PC verwenden, steht in [LumiScan Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/index.html).

Auf ctrlX OS wird die Lizenz beim Start bis zu zehn Sekunden lang geprüft; wird in dieser Zeit keine verfügbar, beendet sich der Reader, und der Grund wird in das Systemprotokoll geschrieben.

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.

## Eine Bildquelle auf demselben Data Layer

Die Anwendung liest ihre Bilder vom Data-Layer-Bildknoten einer anderen Anwendung.

**Auf ctrlX OS:** Diese Anwendung muss auf **demselben Gerät** laufen (ctrlX CORE oder ctrlX IPC) - der Zugriff auf einen entfernten Data Layer wird nicht unterstützt.

**Auf einem PC:** Diese Anwendung muss mit **demselben LumiScan Keryx** verbunden sein wie der Reader.

In der Praxis ist das LumiScan Cam Driver, aber jede Anwendung funktioniert, solange der in `input/image-address` genannte Knoten diese vier Kindknoten bereitstellt:

| Knoten | Typ | Beschreibung |
| --- | --- | --- |
| `data` | Array von uint8 | Rohe, unkomprimierte Pixeldaten |
| `width` | uint64 | Bildbreite in Pixeln |
| `height` | uint64 | Bildhöhe in Pixeln |
| `pixel-type` | string | Name des GenICam-Pixelformats |

### Unterstützte Pixelformate

`Mono8`, `Mono12`, `RGB8`, `RGB12`, `BGR8`, `BGR12`, `Bayer_GR8`, `Bayer_RG8`, `Bayer_GR12`, `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.

> [!NOTE]
> Die Bilddaten müssen für das angegebene Format **mindestens** `width x height x bytes-per-pixel` Bytes umfassen. Ein Puffer, der kürzer ist, als die Metadaten versprechen, wird abgelehnt, statt über sein Ende hinaus gelesen zu werden.

## Speicherung

Das Lesen eines Codes speichert nichts: Es gibt kein Referenzbild und keine Modulliste, und die Adresse in `input/image-address` liegt auf dem Data Layer.

Der Bild-Stream (experimentell) hält zwei Dinge im Konfigurationsverzeichnis der Anwendung: seinen Stream-Modus und das, was er abonniert, in `barcode-reader.json`, dort gespeichert, sobald sie sich ändern, und wofür jeder Einstellungs-Hash steht, in `settings-history/` - eine kleine JSON-Datei pro Hash, die nie gelöscht wird. Wo dieses Verzeichnis auf ctrlX OS und auf einem PC liegt, steht in [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).

## Zeitverhalten

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 nach Codes durchsucht wird.