--- title: "FAQ" description: "Häufig gestellte Fragen zu LumiScan VGR - Systemanforderungen, Installation, Start, PROFINET- und OPC-UA-Kommunikation, Rückgabewerte und Fehlerbehebung." product: "LumiScan VGR" component: "lumiscan-vgr-de" version: "1.8.4" display_version: "1.8.4.6" latest_version: true language: "de" url: "https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/faq.html" --- # FAQ – LumiScan VGR Kurze Antworten auf häufige Fragen und Fehlermeldungen zu LumiScan VGR. 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-return-codes`). ## Anforderungen, Installation und Lizenzierung ### Was benötigt der IPC, um LumiScan VGR auszuführen? {#faq-system-requirements} - **Antwort:** - Windows 11 - Eine NVIDIA-GPU, die CUDA 11.8 unterstützt, mit CUDA Toolkit 11.8 und cuDNN 8.8.1 (die Installer stellt HD Vision Systems bereit) - Eine LumiScanX-Kamera, die über Ethernet mit dem IPC verbunden ist - Mindestens eine Schnittstelle zur Steuerung: PROFINET oder OPC UA - **Mehr:** [Systemanforderungen](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/system-requirements.html) ### Was muss vor der Installation von LumiScan VGR installiert und geprüft werden? {#faq-install-prerequisites} - **Antwort:** - CodeMeter Runtime 9.00 oder neuer, mit eingestecktem LumiScan Key. - CUDA 11.8.0 und cuDNN 8.8.1. - Die LumiScanX-Kamera, installiert und konfiguriert gemäß dem LumiScanX-Handbuch, einschließlich Netzwerk-, Windows-Firewall- und Virenschutzeinstellungen. - **Mehr:** [Installation](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/installation.html#installing-lumiscan-vgr) ### Wie wird LumiScan VGR lizenziert? {#faq-licence} - **Antwort:** - Bei HD Vision Systems gekauft: Die Lizenz liegt auf dem LumiScan Key. Installieren Sie die CodeMeter Runtime 9.00 oder neuer und stecken Sie den Key ein. - Im ctrlX Store für Windows 11 gekauft: Sie benötigen ctrlX WORKS und einen LumiScan Key. - Pro Gerät, auf dem die Software gleichzeitig läuft, ist ein LumiScan Key erforderlich. Keys können zwischen Geräten getauscht werden. - **Mehr:** [Lizenz](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/system-requirements.html#licence), [FAQ zur Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/faq.html) ## Start und Konfiguration ### Wie starte ich LumiScan VGR? {#faq-start} - **Antwort:** Geben Sie im Startmenü-Fenster den Pfad zur Konfigurationsdatei ein (oder klicken Sie auf **Load** und wählen Sie sie aus) und klicken Sie auf **Start**. Über die Kommandozeile geben Sie mindestens die Einstellungsdatei mit `-s` oder `--settings ` an; `-v` zeigt die Version, `-h` die Kommandozeilen-Hilfe. - **Mehr:** [LumiScan VGR starten](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/start-menu.html) ### Kann ich LumiScan VGR ohne Kamera oder SPS testen? {#faq-simulation} - **Antwort:** Ja. Aktivieren Sie die Simulationsoptionen im Startmenü oder verwenden Sie die Kommandozeilenoptionen: - `--simulate-camera`: Bilder und Punktwolken werden statt von einer Kamera von der Festplatte geladen. Der Pfad wird mit `loadFilePath` festgelegt; ein Center-Bild (`.png`) und eine Punktwolke (`.ply`) mit demselben Basisnamen müssen vorhanden sein. - `--simulate-sps`: Es wird keine physische SPS benötigt; die SPS-Kommunikation kann über den Tab **PROFINET** simuliert werden. - **Mehr:** [LumiScan VGR starten](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/start-menu.html), [RecordingSystemSettings](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/api/settings/recording-system-settings.html#recording-system-settings-load-file-path) ### Was enthält die JSON-Einstellungsdatei, und wie stelle ich eine alte Datei um? {#faq-settings-file} - **Antwort:** Die Einstellungsdatei enthält die Abschnitte `cameras`, `recordings`, `networks`, `robots`, `objects` und `pipelines` sowie die optionalen Abschnitte `user` und `system`. Das Metadatenformat hat sich nach Version 1.7.0.0 geändert: Die Dateiinformationen (`inputFileType`, `inputFileVersion`, `targetMachine`, `programName`, `programVersion`) stehen jetzt in einem Objekt `meta` statt in Feldern auf oberster Ebene wie `VGRVersion`. Neue Konfigurationen sollten die Struktur `meta` verwenden. `--gen-settings` erstellt eine Einstellungsdatei. - **Mehr:** [JSON-Einstellungen](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/json-settings.html), [Meta-Einstellungen](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/json-settings/meta.html) ### Wie öffne ich den Admin- oder Debug-Modus, und warum sind die Admin-Steuerelemente inaktiv? {#faq-admin-debug-mode} - **Antwort:** - **Strg + Umschalt + A** schaltet den Admin-Modus ein oder aus, **Strg + Umschalt + D** den Debug-Modus; **Strg + Umschalt + V** zeigt die Build-Version an. - Die Tabs **Scene** und **PROFINET** sind nur im Admin-Modus sichtbar. - Die Admin-Steuerelemente (A2 bis A14) sind nur im manuellen Modus aktiv, damit der automatische Ablauf angehalten ist. - Passwörter lassen sich mit `adminPassword` und `manualModePassword` im Abschnitt `user` festlegen; bleiben sie leer, ist kein Passwort erforderlich. Ist `system/enableExternalAdminModeControl` auf `true` gesetzt, schaltet die SPS den Admin-Modus über `IN_EnableAdminMode`, und der Passwortschutz für den Admin-Modus ist deaktiviert. - **Mehr:** [Admin- und Debug-Modus](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/admin-mode.html), [Benutzeroberfläche](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/user-interface.html) ## Betrieb und SPS-Kommunikation (PROFINET) ### Was ist der Unterschied zwischen Get Best Result und Grip Best Result? {#faq-get-vs-grip-best-result} - **Antwort:** Beide berechnen aus den zuletzt berechneten Objektposen Greifpunkte für den aktiven Roboter und liefern den gültigen Griff mit der höchsten Priorität. Grip Best Result teilt dem System zusätzlich mit, dass das gewählte Ergebnis gegriffen wurde oder wird; über OPC UA liefert jeder Aufruf von `GripBestResult` den nächsten Kandidaten in der Rangfolge. Get Best Result verbraucht das Ergebnis nicht. - **Mehr:** [PROFINET-Schnittstellenreferenz](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/profinet.html), [OPC UA Client Integration Guide](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/api/opcua/opc-ua-client-integration-guide.html) ### Mein Projekt hat mehrere Kameras, Pipelines oder Roboter. Welche werden verwendet? {#faq-multiple-components} - **Antwort:** Alle Berechnungen verwenden die aktuell aktive Kamera, Pipeline und den aktiven Roboter. Wählen Sie sie vor jeder Funktion aus: über PROFINET mit `OUT_SetParameter` (`IN_ParamId` `1` = `SET_CAMERA_ID`, `2` = `SET_PIPELINE_ID`, `3` = `SET_ROBOT_ID`, ID in `IN_ParamArgString`), über OPC UA mit `SetActiveCamera`, `SetActivePipeline` und `SetActiveRobot`. Eine unbekannte ID liefert `ID_DOES_NOT_EXIST`. - **Mehr:** [SPS-Einstellungen](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/plc-settings.html) ## OPC UA ### Wie verbinde ich einen OPC-UA-Client mit LumiScan VGR? {#faq-opcua-connect} - **Antwort:** Verbinden Sie sich mit `opc.tcp://:4840`. Security Policy und Mode sind None mit anonymer Anmeldung; höchstens 2 Clients können gleichzeitig verbunden sein, das empfohlene Session-Timeout beträgt 10 s. Alle Knoten liegen unter `Objects/LumiScanVGR` (Namespace-Index 1). Da keine Authentifizierung erfolgt, sollte der Server nur innerhalb des Werksnetzes erreichbar sein. - **Mehr:** [OPC UA Client Integration Guide](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/api/opcua/opc-ua-client-integration-guide.html) ### In welcher Reihenfolge rufe ich die OPC-UA-Methoden auf? {#faq-opcua-call-sequence} - **Antwort:** Für den Standardbetrieb führt `ExecuteSimpleRecipe` (Kamera-, Pipeline- und Roboter-ID) oder `ExecuteRecipe` (vorkonfigurierte Rezept-ID) den Ablauf aus Aufnahme und Griff in einem Aufruf aus. Für eine feinere Steuerung verwenden Sie die Einzelschritte: 1. Modus mit `GetOperationMode` prüfen; ist er nicht `AUTOMATIC`, `SetOperationMode` aufrufen. 2. `SetupSystem` aufrufen und auf `SUCCESS` warten. 3. Konfiguration mit `SetActiveCamera`, `SetActivePipeline` und `SetActiveRobot` wählen. 4. `CaptureImage` und anschließend `ComputeObjects` aufrufen. 5. `GetBestResult` (verbraucht das Ergebnis nicht) und/oder `GripBestResult` (liefert bei jedem Aufruf den nächsten Kandidaten) aufrufen. - **Mehr:** [OPC UA Client Integration Guide](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/api/opcua/opc-ua-client-integration-guide.html) ## Rückgabewerte und Logdateien ### Was bedeuten die Rückgabewerte? {#faq-return-codes} - **Antwort:** Das Ergebnis jeder Aktion erscheint im Statusfenster (zum Beispiel **SUCCESS**) und bei PROFINET als Zahl in `OUT_ReturnCode`. OPC-UA-Methoden liefern den Code als String `ReturnCode`. - `0` `SUCCESS`: kein Fehler - `1` `UNKNOWN_ERROR`: unbekannter Fehler; Log prüfen - `2` `CAMERA_NOT_INITIALIZED`: aktive Kamera nicht initialisiert oder nicht vorhanden; zuerst Setup ausführen - `3` `CAMERA_NOT_CONNECTED`: keine Verbindung zur Kamera - `4` `CAMERA_ACQUISITION_ERROR`: Fehler bei der Kommunikation mit der Kamera oder beim Erfassen von Daten - `5` `PIPELINE_NOT_INITIALIZED` / `6` `ROBOT_NOT_INITIALIZED`: aktive Pipeline bzw. aktiver Roboter nicht initialisiert oder nicht vorhanden - `7` `MISSING_DATA`: erforderliche Daten fehlen, z. B. eine Aufnahme oder das Ergebnis eines vorherigen Berechnungsschritts - `8` `ID_DOES_NOT_EXIST`: die Kamera-, Pipeline- oder Roboter-ID ist nicht konfiguriert - `9` `MISSING_TRANSFORM`: Koordinatentransformation nicht verfügbar, z. B. fehlende Hand-Auge-Kalibrierungsdaten für ein Roboter-Kamera-Paar - `10` `RESULTS_EMPTY`: keine gültigen Greifpunkte für den aktiven Roboter - `12` `CAMERA_HARDWARE_TRIGGER_AGAIN`: automatische Belichtung nicht erfolgreich; Kamera erneut auslösen - `13` `CAMERA_BAD_EXPOSURETIME_SETTING`: die angeforderte Belichtungszeit ist nicht erreichbar; Einstellungen der automatischen Belichtung prüfen - Nur OPC UA: `CAMERA_RESTART_REQUIRED` (`ResetCamera` aufrufen) und `OPERATION_MODE_INVALID` (Server nicht in `AUTOMATIC`; `SetOperationMode` mit `1` aufrufen) - **Mehr:** [SPS-Einstellungen: Statusinformationen](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/plc-settings.html#status-information), [OPC UA Client Integration Guide](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/api/opcua/opc-ua-client-integration-guide.html) ### Wo werden Logdateien, Aufnahmen und Trainingsdaten gespeichert? {#faq-logs-output-data} - **Antwort:** `HDVAppData` steht für `C:\Users\\AppData\Local\HD Vision Systems GmbH`. - Logdateien: `\LumiScan VGR\logs` (rotierend, max. 10 MB pro Datei, max. fünf Dateien). Das Log-Fenster öffnen Sie mit S3 in der Benutzeroberfläche; im Debug-Modus zeigt die Konsole die detaillierte Log-Ausgabe. - Crash-Dumps: `\LumiScan VGR`. - Aufgezeichnete und berechnete Daten: der in der Einstellungsdatei festgelegte Ausgabeordner (`saveFilePath`, Standard `data`). Einige Exportoptionen lassen sich im Admin-Modus unter **Admin Settings** (A1) schalten. - Trainingsdaten: Ordner `training_data` im Projektordner **Settings**. - **Mehr:** [Generierte Daten und Dateien](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/output-data.html), [RecordingSystemSettings](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/api/settings/recording-system-settings.html#recording-system-settings-save-file-path) ## Fehlerbehebung {#troubleshooting} Probleme und Fehlermeldungen sind Schritt für Schritt unter [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/troubleshooting.html) beschrieben: - [Die Kamera wird nach dem Start nicht erkannt oder es wird kein Bild aufgenommen](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/troubleshooting.html#faq-setup-required) - [Die Bildaufnahme schlägt mit einem Kamera-Rückgabewert fehl](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/troubleshooting.html#ts-camera-error-code) - [Es erscheint eine Timeout-Meldung oder nur ein schwarzes Bild, obwohl die Kamera erkannt wird](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/troubleshooting.html#faq-black-image-timeout) - [LumiScan VGR reagiert nicht nach GripBestResult](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/troubleshooting.html#faq-no-reaction-plc-request) - [Die SPS kann nach dem manuellen Modus keine Funktionen mehr starten](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/troubleshooting.html#faq-manual-mode-plc) - [OPC-UA-Aufrufe schlagen mit `BadTimeout` oder `BadResourceUnavailable` fehl](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/troubleshooting.html#faq-opcua-timeout) - [OPC-UA-Methoden liefern `OPERATION_MODE_INVALID`](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/troubleshooting.html#ts-opcua-operation-mode-invalid) - [`CameraTemperature` ist `-273.1528`](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/troubleshooting.html#ts-opcua-camera-temperature) - [`Shutdown` hat keine Wirkung](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/troubleshooting.html#ts-opcua-shutdown-no-effect) - [`RESULTS_EMPTY` wird zurückgegeben](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/troubleshooting.html#faq-results-empty) - [Es werden keine Objekte erkannt (Objektanzahl `0`)](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/troubleshooting.html#ts-no-objects-detected) - [Es kann kein Punktwolken-Matching durchgeführt werden](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/troubleshooting.html#ts-no-point-cloud-matching) - [Eine Funktion liefert `ID_DOES_NOT_EXIST`](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/troubleshooting.html#ts-id-does-not-exist) - [Eine Funktion liefert `MISSING_TRANSFORM`](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/troubleshooting.html#ts-missing-transform) - [Pose Status zeigt „Can not be interpreted“](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/troubleshooting.html#ts-hand-eye-cannot-be-interpreted) - [Pose Status zeigt „Bad pose quality.“](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/troubleshooting.html#ts-hand-eye-bad-pose-quality) - [Nach der Aufnahme wird kein Bild hinzugefügt](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/troubleshooting.html#ts-hand-eye-no-image-added) - [Das Kalibrierergebnis ist sehr schlecht](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/troubleshooting.html#ts-hand-eye-poor-result) ## Support ### Wo erhalte ich weitere Hilfe? {#faq-support} - **Antwort:** Siehe die übergreifende [LumiScan FAQ](https://docs.hdvisionsystems.com/de/faq.html). Diagnoseinformationen lassen sich mit S4 in der Benutzeroberfläche sammeln und verschlüsselt an HD Vision Systems senden. Customer Success erreichen Sie unter [customer.success@hdvisionsystems.com](mailto:customer.success@hdvisionsystems.com) oder +49 6221 6721905; Fragen zu Lizenzen richten Sie an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com). - **Mehr:** [Benutzeroberfläche](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/1.8.4/user-interface.html)