+49 6221 672 19-00 info@hdvisionsystems.com

How-to: GenICam-Ethernet-Kamera mit einem ctrlX OS-Gerät über den LumiScan CamDriver verbinden und betreiben

von | 20. Mai 2026 | How-to, Softwareentwicklung

Einführung

Diese How-to-Anleitung beschreibt, wie eine Ethernet-basierte, GenICam-konforme Kamera mithilfe der Anwendung LumiScan CamDriver mit einem ctrlX OS-Gerät, beispielsweise ctrlX CORE, verbunden und betrieben werden kann.

Nach Abschluss dieser Anleitung lernen Sie, wie Sie:

  • die physische Verbindung zwischen Kamera und ctrlX OS-Gerät herstellen
  • den LumiScan CamDriver konfigurieren
  • auf die Kamera über die ctrlX Data Layer zugreifen
  • die Bildaufnahme auslösen
  • aufgenommene Bilder abrufen
  • Bilder optional speichern

Der LumiScan CamDriver wird vollständig über die ctrlX Data Layer gesteuert und unterstützt alle Ethernet-Kameras, die dem GenICam-Standard entsprechen.

Voraussetzungen

Hardware

  • ctrlX OS-Gerät (z. B. ctrlX CORE X3)
  • Ethernet-basierte, GenICam-konforme Kamera
  • Ethernet-Switch (optional)
  • Engineering-PC
  • Geschirmte Ethernet-Kabel

Software

  • LumiScan CamDriver
  • ctrlX OS 3.6
  • Zugriff auf die ctrlX Data Layer (z. B. über Browser oder Tools)
  • Konfigurationssoftware des Kameraherstellers

Anforderungen

Stellen Sie vor Beginn sicher, dass:

  • die LumiScan CamDriver App installiert ist
  • eine gültige Lizenz vorhanden ist
  • die Kamera GenICam über Ethernet unterstützt

    Systemübersicht

    Der LumiScan CamDriver wird vollständig über die ctrlX-Datenschicht konfiguriert und gesteuert.

    Das System verwendet eine zweistufige Konfigurationsstruktur :

    • Eine Anwendungskonfiguration ( lumiscan-cam-driver.json)
    • Eine Konfigurationsdatei pro Kamera

    Alle Konfigurationsdateien befinden sich in:

    Manage App Data → active → lumiscan-cam-driver

    Kontrollmechanismus (Handschlag)

    Alle Operationen (Verbinden, Erfassen, Speichern, Trennen) werden mithilfe eines standardisierten Handshake-Mechanismus ausgeführt:

    1. Warten Sie, bis ready = true
    2. Satz request = true
    3. Warten Sie, bis ready = false
    4. Zurücksetzen request = false
    5. Warte, bis ready = true es wieder so weit ist

    Dieser Mechanismus dient folgenden Zwecken:

    • Kameraanschluss
    • Bildaufnahme
    • Bildspeicherung
    Abb. 1: Handshake-Sequenz, die die Interaktion zwischen bereit und Anfrage zeigt.

    Schritt 1: Hardware-Einrichtung

    1. Schließen Sie die Kamera an den Engineering-PC an.
    2. Konfigurieren Sie das Kameranetzwerk mithilfe des Tools des Herstellers:
      • Weisen Sie eine statische IP-Adresse zu.
      • DHCP deaktivieren
      • Automatische IP-Adresse/Link-Local-Verbindung deaktivieren
      • Permanente IP aktivieren (falls unterstützt)

    Beispiel:

    • Kamera-IP: 192.168.1.21
    • Subnetzmaske: 255.255.255.0
    1. Trennen Sie die Kamera vom PC.
    2. Schließen Sie die folgenden Geräte an den Switch an:
      • Kamera
      • ctrlX CORE
      • Engineering PC
    3. PC-Netzwerk konfigurieren:
      • IP: 192.168.1.X
      • Teilnetz: 255.255.255.0
        (X ≠ 1)
    4. Öffnen Sie die ctrlX CORE Web-Benutzeroberfläche →
      Einstellungen → Netzwerkschnittstellen
    5. Konfigurieren Sie die Schnittstelle (z. B. XF10):
      • IP: 192.168.1.1
      • MTU: 8000
    6. Einstellungen speichern

    Hinweis: Jumbo-Frame-fähige Switches werden empfohlen.

    Abb. 2: Konfiguration der ctrlX CORE-Netzwerkschnittstelle (XF10, MTU, statische IP)

    Schritt 2: LumiScan CamDriver konfigurieren

    Navigieren Sie zu:

    Manage App Data → active → lumiscan-cam-driver

    Abb. 3: Ansicht des Anwendungsverzeichnisses

    2.1 Anwendungseinstellungen konfigurieren

    Offen:

    lumiscan-cam-driver.json

    Beispiel:

    {

      "configurations": [
    "camera_example.json"
  ],
  "system": {
    "debug": true,
    "logLevel": "INFO"
  }
}

    Stellen Sie sicher, dass:

    • Alle referenzierten Konfigurationsdateien sind vorhanden.
    • Die Konfigurationsnamen sind korrekt.
    • Es werden keine doppelten Kameraseriennummern verwendet.
    Abb. 4: Anwendungskonfigurationsdatei

    2.2 Kameraeinstellungen konfigurieren

    Offen:

    camera_example.json

    Beispiel:

    {

      "id": "camera1",
  "serial": "LX123456",
  "exposureTimeUS": 4321,
  "pixelFormat": "RGB8"
}

    Parameter:

    • id: Kamerakennung
    • serial: Seriennummer der Kamera
    • exposureTimeUS: Expositionszeit
    • pixelFormat: Bildformat

    Unterstützte Formate:

    • RGB8
    • Mono8

    Nach der Änderung:

    • Datei speichern
    • Starten Sie den LumiScan CamDriver neu.
    Abb. 5: Kamerakonfigurationsdatei

    Schritt 3: Kameraerkennung überprüfen

    Erkannte Kameras werden angezeigt in:

    /hdvisionsystems/lumiscan-cam-driver/system

    Relevante Knoten:

    • found-camera-ip-addresses
    • found-camera-mac-addresses
    • found-camera-modules
    • found-camera-serials

    Verwenden Sie diese Angaben zur Überprüfung:

    • Kameraerkennung
    • IP-Konfiguration
    • Zuordnung der Seriennummern

       

      Abb. 6: Systemknoten der Datenschicht mit erkannten Kameras

    Schritt 4: Verbindung zur Kamera herstellen

    Weg:

    /hdvisionsystems/lumiscan-cam-driver/<module>/control/connect-camera

    Verfahren:

    1. Überprüfen: ready = true
    2. Satz: request = true
    3. Warten Sie, bis: ready = false
    4. Zurücksetzen: request = false
    5. Warten Sie, bis: ready = true

    Verifizieren:

    /control/status/code = 0
     
    Abb. 7: Connect-Kamera-Steuerknoten und Statuscode

    Schritt 5: Bildaufnahme auslösen

    Weg:

    /hdvisionsystems/lumiscan-cam-driver/<module>/control/capture

    Verfahren:

    • Führe die Handshake-Sequenz aus (wie oben)

    Verifizieren:

    /control/status/code = 0

    Das aufgenommene Bild ist verfügbar unter:

    /hdvisionsystems/lumiscan-cam-driver/<module>/output/image
    Abb. 8: Steuerknoten für die Bildaufnahme und Bildausgabe

    Schritt 6: Aufgenommene Bilder speichern (optional)

    Unterstützte Speicher:

    • Interner Speicher
    • USB
    • SD-Karte
    • Samba-Netzwerkfreigabe

    Beispielkonfiguration:

    "storage": {
  "type": "Internal",
  "parameters": {
    "remotePath": "images"
  }
}

    Nach den Änderungen:

    • Konfiguration speichern
    • Anwendung neu starten

    Trigger-Speicherung über:

    /control/save
    Abb. 9: Beispiel für eine Speicherkonfiguration

       

      Ergebnis

      Nach Abschluss dieser Anleitung:

      • Die Kamera ist erfolgreich mit ctrlX CORE verbunden.
      • Der LumiScan CamDriver ist korrekt konfiguriert.
      • Die Kamera ist über die ctrlX-Datenschicht zugänglich.
      • Die Bildaufnahme kann programmatisch ausgelöst werden.
      • Aufgenommene Bilder können lokal oder auf externen Systemen gespeichert werden.

      Das Unternehmen

      HD Vision Systems ist ein führender Anbieter von industriellen Bildverarbeitungs- und KI-basierten Automatisierungslösungen. Unsere hardwareunabhängige Plattform ermöglicht die nahtlose Integration verschiedenster Kameras, Sensoren, Roboter und industrieller Systeme und bietet Kunden maximale Flexibilität und zukunftssichere Skalierbarkeit. Durch die Kombination fortschrittlicher Bildverarbeitungssoftware mit starken Partnerschaften im gesamten Automatisierungs-Ökosystem liefern wir maßgeschneiderte, leistungsstarke Lösungen für Qualitätsprüfung, Prozessoptimierung und intelligente Fertigung. Gemeinsam mit unseren Technologiepartnern unterstützen wir Unternehmen bei der Beschleunigung ihrer digitalen Transformation und der Erschließung des vollen Potenzials von Industrie 4.0.

      Share This