---
title: "FAQ"
description: "Häufige Fragen zum LumiScan Cam Driver - Kamera- und Netzwerkeinrichtung, Konfigurationsdateien, Bildspeicherung, Execute-Methoden, Bild-Stream und Lizenzierung, mit Verweisen auf die Fehlerbehebung."
product: "LumiScan Cam Driver"
component: "lumiscan-cam-driver-de"
version: "2.2.1"
display_version: "2.2.1.10"
latest_version: true
language: "de"
url: "https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/faq.html"
---

# FAQ – LumiScan Cam Driver

Kurze Antworten auf häufige Fragen zu LumiScan Cam Driver. Jeder Eintrag verweist auf die Seite mit den Details. Probleme und Fehlermeldungen sind unter [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/how-tos/troubleshooting_cam_driver.html) beschrieben.

> [!TIP]
> Jeder Eintrag hat einen festen Anker (zum Beispiel `#faq-licence-v2`). Um eine Fehlermeldung zu finden, durchsuchen Sie die Seite [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/how-tos/troubleshooting_cam_driver.html) danach.

## Voraussetzungen und Einrichtung

### Welche Kameras kann ich verwenden, und wie viele pro Installation? {#faq-supported-cameras}

- **Antwort:** Der Cam Driver läuft auf einer ctrlX CORE (ctrlX OS, mit dem ctrlX Data Layer) oder auf einem PC mit Windows 11 oder Ubuntu 24.04 (mit LumiScan Keryx) und benötigt eine Ethernet-fähige, GenICam-konforme Kamera, versorgt über PoE oder ein externes Netzteil. Die Knotenadressen sind auf beiden Plattformen gleich. Er wurde mit ausgewählten Kameras von Basler, Baumer, IDS, LUCID Vision Labs, Hikvision und Balluff getestet; GenICam-Implementierungen unterscheiden sich, prüfen Sie also alle benötigten Funktionen vor dem Einsatz. Ab v2.0.0 kann eine Installation mehrere Kameras betreiben: Jede Kamera ist ein Modul mit eigener Konfiguration und Data-Layer-Adresse (zum Beispiel `hdvisionsystems/lumiscan-cam-driver/camera1`), und jede verbundene Kamera benötigt eine eigene Lizenz.
- **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/requirements.html), [Beschreibung](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/description.html), [ctrlX Data Layer und LumiScan Keryx](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/platforms.html)

### Wie schließe ich eine Kamera an eine ctrlX CORE X3 an? {#faq-x3-network-topology}

- **Antwort:** (ctrlX OS) Das Handbuch beschreibt zwei Topologien. Weisen Sie der Kamera nach beiden eine eindeutige IP-Adresse zu, und testen Sie Werte für das Packet Delay, bis die Bildaufnahme stabil ist.
  - Gemeinsamer Ethernet-Switch: Kamera, Engineering-Computer und Port XF10 an einem Switch, der Jumbo Frames unterstützt. XF10 verwendet `192.168.1.1`, weisen Sie diese Adresse also weder der Kamera noch dem Computer zu.
  - Direkte Verbindung: Kamera direkt an XF10, Engineering-Computer an XF51. Geben Sie XF51 eine statische IPv4-Adresse in einem anderen Subnetz als XF10 (zum Beispiel `192.168.42.203`) und notieren Sie sie, da ctrlX WORKS die X3 möglicherweise nicht automatisch findet.
- **Mehr:** [Hardware-Aufbau für ctrlX X3](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/hardware-setup-for-ctrlx-x3.html#overview)

### Wie setze ich die IP-Adresse einer Kamera? {#faq-set-camera-ip}

- **Antwort:** Verwenden Sie die Funktion force-ip unter `hdvisionsystems/lumiscan-cam-driver/system/force-ip/`. Sie funktioniert auch, wenn die Kamera normalerweise nicht erkannt wird (zum Beispiel, weil ihr Subnetz nicht zu dem der ctrlX CORE oder des PCs passt), solange sie über dieselbe Netzwerkverbindung erreichbar ist.
  - Lesen Sie die MAC-Adresse der Kamera aus `system/found-camera-mac-addresses` (gleiche Position in der Liste wie ihre Seriennummer in `system/found-camera-serials`).
  - Setzen Sie `gateway`, `ip`, `subnet` und die MAC-Adresse der Kamera.
  - Warten Sie, bis `ready` true ist, setzen Sie `request` auf true und dann wieder auf false.
  - Wenn `ready` wieder true ist, zeigt `system/found-camera-ip-addresses` die neue Adresse. Falls nicht, setzen Sie die IP mit dem Programm des Kameraherstellers.
- **Mehr:** [Kamera-IP-Adresse einrichten](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/how-tos/setup-camera-ip-address.html), [IP-Konfiguration der Kamera erzwingen](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/initializing-the-camera.html#force-ip-configuration-of-camera)

## Konfiguration

### Wo liegen die Konfigurationsdateien, und wie füge ich eine Kamera hinzu? {#faq-config-files}

- **Antwort:** `lumiscan-cam-driver.json` enthält die Anwendungseinstellungen und listet die zu ladenden Kamerakonfigurationsdateien auf; jede weitere Datei (zum Beispiel `camera_example.json`) konfiguriert eine Kamera.
  - Auf ctrlX OS: Öffnen Sie in der ctrlX-OS-Weboberfläche **Home** > **Manage app data**, wählen Sie im Drei-Punkte-Menü **File View** und öffnen Sie den Ordner `lumiscan-cam-driver`. Um eine Kamera hinzuzufügen, kopieren Sie eine vorhandene Kameradatei (drei Punkte > **COPY**), geben ihr einen neuen Namen, tragen diesen Namen in die Liste der Kamerakonfigurationsdateien in `lumiscan-cam-driver.json` ein und starten die Anwendung neu.
  - Auf einem PC: Die Dateien sind gewöhnliche Dateien in dem Ordner, aus dem der Cam Driver seine Einstellungen liest; der Cam Driver nennt ihn, wenn Sie mit `--generate-settings` ein Beispiel schreiben. Unter Windows ist das `%APP_RESOURCE_DIR%\etc\lumiscan-cam-driver` oder standardmäßig `C:\ProgramData\HD Vision Systems GmbH\LumiScan Vision Suite\lumiscan-cam-driver\etc\lumiscan-cam-driver`. Kopieren Sie eine Kameradatei unter neuem Namen, tragen Sie sie in `lumiscan-cam-driver.json` ein und starten Sie den Cam Driver neu.
  - Auf beiden: `system/settings` zeigt und ändert die Dateien auf dem Data Layer, und `system/control/create-module` und `activate-module` fügen ein Kameramodul hinzu; starten Sie danach mit `system/control/restart/execute` neu.
- **Mehr:** [Kamerakonfiguration einrichten](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/setup-camera-configuration.html#edit-with-built-in-website), [Neue Kamera-Einstellungsdateien anlegen](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/creating-new-camera-settings-files.html), [Module hinzufügen und entfernen](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/settings-on-the-data-layer.html#adding-and-removing-modules)

### Welche Einstellungen enthält eine Kamerakonfigurationsdatei? {#faq-camera-parameters}

- **Antwort:** `inputFileType` muss `camera-configuration` sein. Die Kameraeinstellungen sind `id` (muss über alle Kameraeinstellungen hinweg eindeutig sein; sie ist der Name des Moduls auf dem Data Layer und darf nur Kleinbuchstaben, Ziffern, `-` und `_` enthalten), `serial` (eine Seriennummer, die `simulation` enthält, macht die Kamera zu einer simulierten), `exposureTimeUS`, `pixelFormat` (`RGB8` oder `Mono8`), `timestampSource` (`Camera` oder `System`; ab v2.0.0 ist der Kamera-Zeitstempel der Standard) und, optional und experimentell, `stream.tag`. Parameter können auf dem Data Layer unter `…/input/` überschrieben werden. Starten Sie die Anwendung nach dem Ändern der Datei neu.
- **Mehr:** [Beispielinhalt einer Kameradatei](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/camera-example-file-content-example.html)

### Wie ändere ich andere GenICam-Features der Kamera? {#faq-genicam-features}

- **Antwort:** Verbinden Sie die Kamera, und bearbeiten Sie dann die Knoten unter `hdvisionsystems/lumiscan-cam-driver/<camera name>/features`. Ihre Namen, Werte, Zugriffsrechte und Beschreibungen kommen direkt von der Kamera; ziehen Sie die Dokumentation des Kameraherstellers heran. Werte werden direkt in die Kamera geschrieben, seien Sie also bei Netzwerkeinstellungen vorsichtig. Diese Funktion ist als experimentell gekennzeichnet: Werte werden nicht zwischengespeichert, und wiederholtes Setzen (zum Beispiel von einer SPS aus) kann die Kamera instabil machen und die Leistung beeinträchtigen. Ein auf einen Feature-Knoten geschriebener Wert geht verloren, wenn die Kamera erneut verbunden wird; eine Feature-Datei, die in `cameras[].featureFiles` des Moduls aufgeführt ist, wird bei jedem Verbinden der Kamera angewendet.
- **Mehr:** [GenICam-Features](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/initializing-the-camera.html#genicam-features), [Für die höchste Bildrate: TriggerOverlap](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/streaming-images.html#trigger-overlap), [Release Notes: v2.0.0](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/release-notes/v2-0-0-2026-06-02.html)

### Wie speichere ich Bilder intern, auf USB/SD-Karte oder auf einer Samba-Freigabe? {#faq-image-storage}

- **Antwort:** Fügen Sie dem Abschnitt `system` von `lumiscan-cam-driver.json` einen Block `storage` hinzu, und starten Sie die Anwendung neu. Ohne ihn tut **Save** nichts.
  - `type`: `Null`, `Internal` (interner Speicher; auf ctrlX OS auch ein USB-Speichergerät oder eine SD-Karte) oder `Samba` (freigegebener Windows-Ordner).
  - `Internal`: `rootPath`. Ein relativer Pfad speichert im internen Verzeichnis der Anwendung. Auf ctrlX OS speichert ein Pfad, der mit dem Pfad des eingebundenen Geräts beginnt (zum Beispiel `/media/sdb1/myCapturedImages`), auf diesem Gerät; USB/SD-Geräte müssen FAT32 oder EXT4 verwenden und unter **Settings** > **Storage Devices** eingebunden sein.
  - `Samba`: `ip`, `remotePath`, `domain` (`""`, wenn es keine gibt), `username`, `password`. Das Passwort wird im Klartext gespeichert, verwenden Sie also kein reguläres Benutzerkonto.
  - Ab v2.2.0 bewirkt `unifiedStorage` (Standard `false`: ein Ordner pro Kamera) auf `true`, dass alle Kameras den Speicherordner direkt verwenden.
- **Mehr:** [Speichereinstellungen](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/application-settings-content-example.html#storage-settings), [Bilddateien speichern](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/initializing-the-camera.html#saving-image-files)

## Betrieb

### Soll ich die Execute-Methode oder den ready/request-Handshake verwenden? {#faq-execute-or-handshake}

- **Antwort:** Beide führen zum selben Ergebnis. Ab v2.1.0 können `capture`, `save`, `load`, `remove` und `list-images` mit einem Schreibvorgang auf `<camera name>/control/<operation>/execute` gestartet werden, der zurückkehrt, wenn die Operation abgeschlossen ist; ab v2.3.0 wird `trigger` nur als `execute`-Methode angeboten. `connect-camera`, `disconnect-camera` und `reset` haben keinen `execute`-Knoten und müssen den Handshake verwenden. Es darf immer nur ein Prozess `request` schreiben, und in beiden Fällen prüfen Sie danach `control/status/code` und `control/status/text`. Handshake-Schritte:
  - Warten Sie, bis `ready` true ist.
  - Setzen Sie `request` auf true, und warten Sie, bis `ready` auf false wechselt: Die Anwendung hat den Request erkannt.
  - Setzen Sie `request` auf false, warten Sie, bis die Operation abgeschlossen ist, und lesen Sie ihren Ausgang auf `control/status/code`.
  - Ein fehlgeschlagenes `capture` über den Handshake endet bei Status `3` (`waitingForClient`), nicht bei seinem eigenen Fehlercode, und `capture/ready` bleibt false, bis ein `reset` erfolgreich ist. `capture/execute` behält den eigenen Code des Capture.
- **Mehr:** [Eine Methode ausführen](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/execute-a-method.html#choosing-between-the-two), [Wann eine Funktionalität läuft](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/general-concept-of-handshake.html#when-a-functionality-runs), [Handshake](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/handshake.html)

### Wo finde ich das aufgenommene Bild, und wie kann ich es ansehen? {#faq-image-output}

- **Antwort:** Das Bild wird auf `hdvisionsystems/lumiscan-cam-driver/<camera name>/output/image` zusammen mit Breite, Höhe und Pixeltyp veröffentlicht, unabhängig davon, wie das Capture gestartet wurde. Das sind Sensor-Rohdaten, die die meisten Bildbetrachter nicht anzeigen können. Ab v2.1.0 schalten Sie `<camera id>/input/preview/enable` ein, um nach jedem erfolgreichen Capture oder Load ein PNG auf `<camera id>/output/preview/encoded-data` zu erhalten; `<camera id>/input/preview/scale` (0.0 bis 1.0) verkleinert es. Vergleichen Sie `output/package-identifier`, um zu prüfen, ob die Vorschau zum neuesten Bild gehört. Um jedes Bild zu erhalten, das die Kamera liefert, verwenden Sie den experimentellen Bild-Stream auf `<camera name>/control/publish/output/stream/frame` (ab v2.3.0).
- **Mehr:** [Beschreibung](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/description.html), [Bilder streamen (experimentell)](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/streaming-images.html), [Release Notes: v2.1.0](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/release-notes/v2-1-0-2026-07-17.html)

### Wie funktioniert der Simulationsmodus? {#faq-simulation-mode}

- **Antwort:** Geben Sie der Kamera eine `serial`, die `simulation` enthält (zum Beispiel `simulation`); das Modul sucht dann keine echte Kamera und verbindet sich mit keiner. Ob eine Kamera simuliert wird, hängt von ihrer Seriennummer ab, nicht von ihrer `id`. Ein Aufruf von **Capture** lädt ein Bild aus dem konfigurierten Speicherordner und springt für das nächste Capture zum nächsten Bild. Seit v2.0.0 werden die Bilder aus `images/<camera id>` statt aus `images` genommen (verschieben Sie vorhandene Bilder vor dem Update), und der Ordner wird beim Verbinden eingelesen, sodass ein Aufruf von `list-images` nicht nötig ist. Ab v2.2.0 verwendet `unifiedStorage` auf `true` den Speicherordner direkt.
- **Mehr:** [Bilder laden](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/initializing-the-camera.html#loading-images), [Beispielinhalt einer Kameradatei](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/camera-example-file-content-example.html), [Release Notes: v2.0.0](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/release-notes/v2-0-0-2026-06-02.html)

### Wie erhalte ich jedes Bild statt eines pro Capture? {#faq-image-stream}

- **Antwort:** Verwenden Sie ab v2.3.0 den experimentellen Bild-Stream. Verbinden Sie die Kamera, setzen Sie ihre Features (für die höchste Bildrate `TriggerOverlap` nicht `Off`), abonnieren Sie `<camera name>/control/publish/output/stream/frame`, setzen Sie `control/publish/input/enable` auf `true` und rufen Sie `control/publish/execute` auf. Der Cam Driver triggert die Kamera nicht von selbst: Bilder kommen bei einem Hardware-Trigger, bei `control/trigger/execute` oder kontinuierlich bei ausgeschaltetem Trigger-Modus. Solange der Stream läuft, ist `capture` nicht verfügbar; nach dem Stoppen des Streams wird die Kamera erneut verbunden, was bei der von uns getesteten Kamera etwa zwei Sekunden dauert.
- **Mehr:** [Einen Stream betreiben](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/streaming-images.html#running-a-stream), [Streams](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/streams.html)

## Fehlerbehebung {#troubleshooting}

Probleme und Fehlermeldungen sind Schritt für Schritt unter [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/how-tos/troubleshooting_cam_driver.html) beschrieben:

- [Eine konfigurierte Kamera erscheint nicht im Data Layer](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/how-tos/troubleshooting_cam_driver.html#faq-camera-not-in-data-layer)
- [Module beantworten keinen Request, und der Status ist -5 "restartRequired"](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/how-tos/troubleshooting_cam_driver.html#faq-restart-required)
- ["No valid license found, please purchase one. If you do have one, please try to restart ctrlX"](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/how-tos/troubleshooting_cam_driver.html#faq-missing-license)
- [Eine physisch angeschlossene Kamera wird nicht erkannt](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/how-tos/troubleshooting_cam_driver.html#faq-camera-not-detected)
- [Die Kamera verbindet sich nicht (Status -10000 "failedToConnectToCamera")](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/how-tos/troubleshooting_cam_driver.html#faq-failed-to-connect-to-camera)
- [Die Bildaufnahme schlägt fehl oder ist unzuverlässig (Status -10004 "couldNotCaptureImage")](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/how-tos/troubleshooting_cam_driver.html#faq-could-not-capture-image)
- [Ein Schreibvorgang auf execute antwortet mit "DL_TOO_MANY_OPERATIONS" oder "TooManyOperations"](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/how-tos/troubleshooting_cam_driver.html#faq-dl-too-many-operations)
- [Ein Schreibvorgang auf execute antwortet mit "DL_INVALID_OPERATION_MODE", oder capture wird immer wieder abgelehnt](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/how-tos/troubleshooting_cam_driver.html#faq-dl-invalid-operation-mode)
- [Bilder werden nicht gespeichert (Status -10006 "saveImageFailed" oder -10005 "noImageTaken")](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/how-tos/troubleshooting_cam_driver.html#faq-save-image-failed)
- [Bilder entsprechen nicht den Erwartungen](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/how-tos/troubleshooting_cam_driver.html#ts-images-not-as-expected)
- [Capture wird abgelehnt, während der Bild-Stream läuft](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/how-tos/troubleshooting_cam_driver.html#faq-capture-refused-streaming)
- [Der Bild-Stream liefert keine Bilder oder weniger als erwartet](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/how-tos/troubleshooting_cam_driver.html#ts-stream-missing-images)

## Lizenzierung und Support

### Welche Lizenz benötige ich, und warum funktioniert meine alte Lizenz nicht mehr? {#faq-licence-v2}

- **Antwort:** Ab v2.0.0 benötigt der Cam Driver die Lizenz `SWL-W-XCx-CAMDRIVERxHDVSx-V2NN`; Schlüssel der Version 1 funktionieren nicht. Sie benötigen eine Lizenz pro verbundener Kamera. Auf ctrlX OS (ctrlX CORE oder IPC) ist eine im ctrlX Store gekaufte Lizenz eine ctrlX-Lizenz und benötigt keinen LumiScan Key. Zu anderen Bezugswegen siehe die FAQ zur Lizenzierung.
- **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/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 Fragen zum Data Layer selbst die [FAQ zum Data Layer](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/faq.html). Kontaktieren Sie den Customer Success von HD Vision Systems unter [customer.success@hdvisionsystems.com](mailto:customer.success@hdvisionsystems.com) oder +49 6221 6721905; für Lizenzen [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com).
- **Mehr:** [FAQ zur Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/faq.html)