FAQ

Kurze Antworten auf häufige Fragen und Fehlermeldungen zu LumiScan VGR. Jeder Eintrag verweist auf die Seite mit den Details.

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?

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

Was muss vor der Installation von LumiScan VGR installiert und geprüft werden?

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

Wie wird LumiScan VGR lizenziert?

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, FAQ zur Lizenzierung

Start und Konfiguration

Wie starte ich LumiScan VGR?

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 <filepath> an; -v zeigt die Version, -h die Kommandozeilen-Hilfe.

Mehr

LumiScan VGR starten

Kann ich LumiScan VGR ohne Kamera oder SPS testen?

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, RecordingSystemSettings

Was enthält die JSON-Einstellungsdatei, und wie stelle ich eine alte Datei um?

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, Meta-Einstellungen

Wie öffne ich den Admin- oder Debug-Modus, und warum sind die Admin-Steuerelemente inaktiv?

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, Benutzeroberfläche

Betrieb und SPS-Kommunikation (PROFINET)

Was ist der Unterschied zwischen Get Best Result und 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, OPC UA Client Integration Guide

Mein Projekt hat mehrere Kameras, Pipelines oder Roboter. Welche werden verwendet?

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

OPC UA

Wie verbinde ich einen OPC-UA-Client mit LumiScan VGR?

Antwort

Verbinden Sie sich mit opc.tcp://<host>: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

In welcher Reihenfolge rufe ich die OPC-UA-Methoden auf?

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

Rückgabewerte und Logdateien

Was bedeuten die Rückgabewerte?

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, OPC UA Client Integration Guide

Wo werden Logdateien, Aufnahmen und Trainingsdaten gespeichert?

Antwort

HDVAppData steht für C:\Users\<UserName>\AppData\Local\HD Vision Systems GmbH.

  • Logdateien: <HDVAppData>\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: <HDVAppData>\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, RecordingSystemSettings

Support

Wo erhalte ich weitere Hilfe?

Antwort

Siehe die übergreifende LumiScan FAQ. 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 oder +49 6221 6721905; Fragen zu Lizenzen richten Sie an licenses@hdvisionsystems.com.

Mehr

Benutzeroberfläche