---
title: "FAQ"
description: "Häufige Fragen und Lösungen zu LumiScan-Produkten - Lizenzierung, Installation, Kamera LumiScan X, ctrlX-Apps, LumiScan VGR."
product: "LumiScan Dokumentation"
component: "ROOT"
language: "de"
url: "https://docs.hdvisionsystems.com/de/faq.html"
---

# FAQ – LumiScan Dokumentation

Antworten auf die Fragen und Fehlermeldungen, die Kunden am häufigsten melden, für alle LumiScan-Produkte. Jeder Eintrag nennt die betroffenen Produkte, die genaue Meldung (falls vorhanden), die Ursache und die Lösung und 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-acquisition-timeout`), auf den Sie direkt verlinken können.

## Bevor Sie den Support kontaktieren {#faq-before-contacting-support}

Halten Sie diese Informationen bereit. Damit finden HD Vision Systems - oder ein Assistent, der Ihnen hilft - die Ursache schnell:

- Produkt und Version (im Versionsauswahlmenü jedes Handbuchs; LumiScan VGR zeigt seine Version mit `Strg+Umschalt+V`).
- Plattform: Windows 11, Ubuntu 24.04 oder ctrlX OS (ctrlX CORE oder IPC).
- Bezugsquelle: HD Vision Systems oder ctrlX Store.
- Die genaue Fehlermeldung, ein Screenshot und der Zeitpunkt.
- Protokolle: `LumiScanVGR.log` bei LumiScan VGR, das Systemprotokoll von ctrlX OS bei ctrlX-Apps.
- Seriennummern: LumiScan Key (`3-…`, auf dem Key aufgedruckt) und gegebenenfalls Kamera.

Kundensupport: +49 6221 6721905, [customer.success@hdvisionsystems.com](mailto:customer.success@hdvisionsystems.com). Lizenzanforderungen und Fragen zur Lizenzierung: [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com).

## Lizenzierung

Fragen zur Lizenzierung - LumiScan Key, CodeMeter, Lizenz-Updates, Verlängerung und ctrlX-Lizenzen - beantwortet die [FAQ zur Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/faq.html). Die häufigsten:

### Welche Lizenz brauche ich? {#faq-licensing-path}

- **Betrifft:** Alle Produkte
- **Antwort:** Das hängt davon ab, wo Sie die Software gekauft haben und wo sie läuft: bei HD Vision Systems gekauft, liegt die Lizenz auf dem LumiScan Key; im ctrlX Store für Windows 11 gekauft, liegt sie in ctrlX WORKS, zusätzlich ist ein LumiScan Key nötig; im ctrlX Store für ctrlX OS gekauft, ist es eine ctrlX-Lizenz auf dem Gerät. Die Seite **Voraussetzungen** bzw. **Requirements** jedes Produkthandbuchs zeigt die Wege, die für das Produkt gelten.
- **Mehr:** [Welcher Lizenzierungsweg gilt](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/which-licensing-path.html)

### Brauche ich für jeden PC einen LumiScan Key? {#faq-one-key-per-device}

- **Betrifft:** Mit dem LumiScan Key lizenzierte Software (Windows 11, Ubuntu 24.04)
- **Antwort:** Ja - einen LumiScan Key für jedes Gerät, auf dem die Software gleichzeitig läuft. Keys können jederzeit zwischen Geräten ausgetauscht werden.
- **Mehr:** [Ein Key pro Gerät](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/lumiscan-key.html#one-key-per-device)

### „User maximum reached!" {#faq-user-maximum}

- **Betrifft:** Mit dem LumiScan Key lizenzierte Software
- **Meldung:** `User maximum reached!`
- **Ursache:** Alle Lizenzen des Keys für diese Anwendung sind belegt.
- **Lösung:** Schließen Sie andere Instanzen der Anwendung, die diesen Key verwenden, und klicken Sie auf **Retry**. Verwenden Sie einen LumiScan Key pro Gerät.
- **Mehr:** [Fehlerbehebung Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html#user-maximum-reached)

### „Not enough license." (Software zur LumiScan X) {#faq-not-enough-license}

- **Betrifft:** LumiScan X, LumiScan-Software unter Windows
- **Meldung:** `Not enough license.`
- **Ursache:** Die Lizenz reicht nicht aus, wird von einem anderen Programm verwendet oder wurde nach dem Beenden des vorherigen Programms noch nicht freigegeben.
- **Lösung:**
  - Stellen Sie sicher, dass kein anderes LumiScan-Programm geöffnet ist, auch nicht von anderen Benutzern.
  - Versuchen Sie es nach 5 bis 10 Sekunden erneut.
- **Mehr:** [Fehlerbehebung LumiScan X](https://docs.hdvisionsystems.com/de/lumiscan-x-de/2.0.0/troubleshooting.html#faq-not-enough-license)

### Eine Engineering-App startet nicht mehr {#faq-engineering-app-expired}

- **Betrifft:** LumiScan Annotation Framework, LumiScan Training Framework, LumiScan VGR Engineering (bei HD Vision Systems gekauft)
- **Ursache:** Das Jahresabonnement ist abgelaufen.
- **Lösung:** Prüfen Sie das Ablaufdatum und verlängern Sie mit einem Lizenz-Update; die Verlängerung setzt ein gültiges Abonnement voraus. Projekte und Daten sind nicht betroffen.
- **Mehr:** [Engineering-Lizenzen verlängern](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/renewing-engineering-licences.html)

### Eine ctrlX-App beendet sich kurz nach dem Start {#faq-ctrlx-app-stops}

- **Betrifft:** Alle LumiScan-Apps unter ctrlX OS
- **Ursache:** Auf dem Gerät fehlt eine benötigte ctrlX-Lizenz, oder die App benötigt mehr Lizenzen als installiert sind (zum Beispiel eine pro Kamera bei LumiScan CamDriver).
- **Lösung:** Suchen Sie die fehlende Lizenz im Systemprotokoll von ctrlX OS und vergleichen Sie sie mit der Lizenzübersicht.
- **Mehr:** [Lizenzübersicht](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/licence-reference.html)

## Installation und Plattformen

### Welche Betriebssysteme werden unterstützt? {#faq-supported-platforms}

- **Antwort:** Die LumiScan-Runtimes und Vision Apps laufen unter Windows 11, Ubuntu 24.04 und Bosch Rexroth ctrlX OS. LumiScan VGR, VGR Lite und die Engineering-Apps (Annotation Framework, Training Framework, VGR Engineering) laufen derzeit nur unter Windows 11.

### Welche Version der CodeMeter Runtime wird benötigt? {#faq-codemeter-version}

- **Betrifft:** Alle mit dem LumiScan Key lizenzierten Produkte
- **Antwort:** CodeMeter Runtime 9.00 oder neuer. Apps, die nativ unter ctrlX OS laufen, benötigen keine CodeMeter Runtime.
- **Mehr:** [CodeMeter Runtime installieren](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/installing-codemeter.html)

## Kamera LumiScan X und Netzwerk

### Nur ein schwarzes Bild / Timeout-Meldung, obwohl die Kamera angezeigt wird {#faq-black-image-timeout}

- **Betrifft:** LumiScan X, LumiScan VGR, alle LumiScan-Produkte mit der Kamera unter Windows
- **Symptom:** Eine Timeout-Meldung erscheint und bei der Aufnahme wird nur ein schwarzes Bild angezeigt, obwohl der angeschlossene Sensor erkannt wird und im Auswahlmenü erscheint.
- **Ursache:** Die Windows-Firewall oder der Virenschutz blockiert die Kommunikation mit der Kamera.
- **Lösung:** Prüfen Sie die Netzwerkkonfiguration der LumiScan X, damit die Geräte nicht von Firewall oder Virenschutz blockiert werden.
- **Mehr:** [Windows-Firewall](https://docs.hdvisionsystems.com/de/lumiscan-x-de/2.0.0/installation.html#sec-windows-firewall), [Virenschutz](https://docs.hdvisionsystems.com/de/lumiscan-x-de/2.0.0/installation.html#sec-virus-protection)

### „Acquisition timeout." {#faq-acquisition-timeout}

- **Betrifft:** LumiScan X
- **Meldung:** `Acquisition timeout.`
- **Ursache:** Falsche Einstellungen oder Netzwerkverbindung.
- **Lösung:**
  - Prüfen Sie, ob die Belichtungszeit länger als der Timeout ist.
  - Prüfen Sie bei Hardware-Trigger, ob das Triggersignal die Kamera tatsächlich erreicht.
  - Prüfen und optimieren Sie die Netzwerkkonfiguration (Firewall, Virenschutz).
  - Hilft das nicht, lassen Sie den Timeout-Schwellwert von HD Vision Systems prüfen.
- **Mehr:** [Fehlerbehebung LumiScan X](https://docs.hdvisionsystems.com/de/lumiscan-x-de/2.0.0/troubleshooting.html#faq-acquisition-timeout)

### „Device not found." {#faq-device-not-found}

- **Betrifft:** LumiScan X
- **Meldung:** `Device not found.`
- **Ursache:** Fehler beim Hardwarestart oder in der Netzwerkkonfiguration.
- **Lösung:**
  - Trennen Sie die Kamera, warten Sie 10 Sekunden und schließen Sie sie wieder an.
  - Prüfen Sie die IP-Adresse des PCs.
  - Stellen Sie sicher, dass die Kamera nicht von Firewall oder Virenschutz blockiert wird.
- **Mehr:** [Netzwerkeinstellungen](https://docs.hdvisionsystems.com/de/lumiscan-x-de/2.0.0/installation.html#sec-network-settings)

### „Access denied." {#faq-access-denied}

- **Betrifft:** LumiScan X
- **Meldung:** `Access denied.`
- **Ursache:** Ein anderes Programm verwendet die Kamera, oder ein vorheriges Programm wurde nicht normal beendet.
- **Lösung:** Schließen Sie das andere Programm. Läuft keines, schalten Sie die Kamera aus und nach 15 Sekunden wieder ein.

### „Incomplete Frames" oder fehlende Bilder {#faq-incomplete-frames}

- **Betrifft:** LumiScan X
- **Meldung:** `Incomplete Frames`
- **Ursache:** Falsche Netzwerkeinstellungen; bei Hardware-Trigger führt ein Triggerintervall, das kürzer als die Bildaufnahmezeit ist, zu fehlenden Bildern.
- **Lösung:** Prüfen Sie die Netzwerkeinstellungen. Wählen Sie das Hardware-Triggerintervall größer als die minimale Bildaufnahmezeit.
- **Mehr:** [Netzwerkeinstellungen](https://docs.hdvisionsystems.com/de/lumiscan-x-de/2.0.0/installation.html#sec-network-settings)

### Keine oder eine schlechte Punktwolke {#faq-no-point-cloud}

- **Betrifft:** LumiScan X
- **Lösung:**
  - Prüfen Sie, ob die Seriennummer im Namen der Kalibrierdatei (`*.hdvcal`) zur angeschlossenen Kamera passt.
  - Prüfen Sie minimale und maximale Tiefe der Punktwolke und ob die Bilder weder zu hell noch zu dunkel sind.
  - Verringern Sie das Konfidenzintervall und passen Sie die Vor- und Nachverarbeitungsfilter an.
  - Reinigen Sie das Frontglas. Hilft das nicht, muss die Kamera von HD Vision Systems neu kalibriert werden.
- **Mehr:** [Fehlerbehebung LumiScan X](https://docs.hdvisionsystems.com/de/lumiscan-x-de/2.0.0/troubleshooting.html#faq-no-point-cloud)

### Die LumiScan X wird auch nach mehreren Neustarts nicht gefunden und nimmt etwa 80 mA auf {#faq-camera-80ma}

- **Betrifft:** LumiScan X
- **Ursache:** Ein Firmwarefehler (normal sind 160 bis 250 mA).
- **Lösung:** Die Kamera muss zur Reparatur an HD Vision Systems geschickt werden. Wenden Sie sich an den Kundensupport.

## ctrlX-Apps

### Ein Modul oder eine Kamera erscheint nicht im Data Layer {#faq-module-not-in-datalayer}

- **Betrifft:** LumiScan CamDriver, LumiScan Calibration und die anderen ctrlX-Apps
- **Ursache:** Die Modulkonfigurationsdatei fehlt, ist ungültig oder in der App-Konfiguration nicht richtig referenziert.
- **Lösung:**
  1. Prüfen Sie unter **Manage App Data > active > \<App>**, ob die Modulkonfigurationsdatei vorhanden ist.
  2. Prüfen Sie, ob sie in der App-Konfigurationsdatei referenziert ist und keine ungültigen oder fehlenden Parameter enthält.
  3. Starten Sie die App nach Änderungen neu. Besteht das Problem weiter, prüfen Sie das Systemprotokoll von ctrlX OS.
- **Mehr:** [Fehlerbehebung Cam Driver](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/how-tos/troubleshooting_cam_driver.html#faq-camera-not-in-data-layer), [Fehlerbehebung Calibration](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/how-tos/troubleshooting.html#faq-module-not-in-data-layer)

### LumiScan CamDriver erkennt eine angeschlossene Kamera nicht {#faq-camera-not-detected}

- **Betrifft:** LumiScan CamDriver
- **Lösung:** Prüfen Sie, ob die Kamera an einem unterstützten Anschluss des ctrlX-Geräts angeschlossen und versorgt ist (extern oder über PoE), ob die IP-Adressen von ctrlX-Gerät und Kamera richtig konfiguriert sind und ob es im Netzwerk keine doppelten IP-Adressen gibt. Greift ein PC am selben Switch ebenfalls auf die Kamera zu, beenden Sie das: Paralleler Zugriff stört die Kommunikation mit der Kamera.
- **Mehr:** [Fehlerbehebung Cam Driver](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/how-tos/troubleshooting_cam_driver.html#faq-camera-not-detected)

### Was bedeutet ein negativer `status-code`? {#faq-status-codes}

- **Betrifft:** LumiScan Template Finder, Object Finder, Area Detector, Text Reader
- **Antwort:** `output/status-code` meldet das Ergebnis jeder Operation, `output/status-text` beschreibt es. `1` ist OK (auch eine Suche ohne Treffer ist OK), `0` heißt Leerlauf, negative Werte sind Fehler - zum Beispiel `-1` belegt (eine andere Operation desselben Moduls läuft), `-2` ungültige Eingabe, `-3` Bild konnte nicht gelesen werden (prüfen Sie, ob die Kamera-App läuft und ein Bild aufgenommen hat), `-5` Bildausschnitt außerhalb des Bildes, `-9` Modul nicht gefunden.
- **Mehr:** Die Seite **Execution Status** jeder App, zum Beispiel [Template Finder](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/execution-status.html)

### Kalibrierte Koordinaten passen nicht zum Bild {#faq-calibration-coordinates}

- **Betrifft:** LumiScan Calibration
- **Lösung:** Prüfen Sie die Achsrichtung (ein Objekt in bekannter Richtung bewegen), den Bezugspunkt (er wird nicht automatisch festgelegt), einheitliche Einheiten (nicht Millimeter und Pixel mischen) und ob die richtige TIFF-Kalibrierdatei für Kamera und Ebene konfiguriert ist.
- **Mehr:** [Fehlerbehebung Calibration](https://docs.hdvisionsystems.com/de/lumiscan-calibration-de/2.0.0/how-tos/troubleshooting.html#faq-coordinates-wrong)

## LumiScan VGR

### Es kann kein Punktwolken-Matching durchgeführt werden {#faq-vgr-no-matching}

- **Betrifft:** LumiScan VGR
- **Ursache:** Die HALCON-Lizenz ist nicht installiert, oder die HALCON-Installation ist nicht in der Umgebungsvariablen `PATH` enthalten.
- **Lösung:** Installieren Sie eine gültige HALCON-Lizenz und prüfen Sie in PowerShell, ob `PATH` den absoluten Pfad zum HALCON-Verzeichnis `bin` enthält.
- **Mehr:** [Fehlerbehebung: LumiScan VGR](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/troubleshooting.html#ts-no-point-cloud-matching)

### LumiScan VGR reagiert nach `GripBestResult` nicht mehr {#faq-vgr-hangs}

- **Betrifft:** LumiScan VGR mit PROFINET
- **Lösung:**
  1. Prüfen Sie, ob das Lebensbit läuft und PROFINET verbunden ist: Im Admin-Modus müssen `IN_HeartBeat` und `OUT_HeartBeat` rot und grün blinken.
  2. Prüfen Sie den Handshake (Signale `…Request`, `…Ready`, `…Running`) und den Rückgabecode `OUT_ReturnCode` (`0` oder `10`).
  3. Notieren Sie Datum und Uhrzeit, exportieren Sie das Protokoll und suchen Sie in `LumiScanVGR.log` nach `PLC - Procedure "<FunctionName>" called` und `… finished`.
  4. Senden Sie diese Informationen und die VGR-Version an HD Vision Systems.
- **Mehr:** [Fehlerbehebung: LumiScan VGR](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/troubleshooting.html#faq-no-reaction-plc-request), [SPS-Prozessablauf](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/plc-settings.html#process-flow)

### Hand-Auge-Kalibrierung: „Can not be interpreted", „Bad pose quality" oder schlechtes Ergebnis {#faq-hand-eye-poor}

- **Betrifft:** LumiScan Hand-Eye Calibration
- **Lösung:**
  - **Can not be interpreted:** Die von der SPS gelesene Position scheint falsch - verwenden Sie den Pose-Modus SPS, prüfen Sie die SPS-Verbindung und den Namen der cifX-Karte (meist `cifx0;0`).
  - **Bad pose quality** oder kein Bild hinzugefügt: Bild löschen, Ausrichtung der Kalibrierplatte ändern und neu aufnehmen; Über- und Unterbelichtung vermeiden.
  - **Schlechtes Ergebnis:** 6 bis 15 Bilder aus deutlich unterschiedlichen Blickwinkeln aufnehmen, die Platte nicht zu weit von der Kamera entfernt.
- **Mehr:** [Fehlerbehebung: Hand-Auge-Kalibrierung](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/troubleshooting.html#hand-eye-troubleshooting)