---
title: "Die Kamera initialisieren"
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/lumiscan-camdriver/initializing-the-camera.html"
---

# Die Kamera initialisieren – LumiScan Cam Driver

## Data Layer {#data-layer}

LumiScan Cam Driver bietet seine Funktionen auf dem Data Layer unter `hdvisionsystems/lumiscan-cam-driver` an.

Auf ctrlX OS (ctrlX CORE oder ctrlX IPC) nutzt LumiScan Cam Driver den [ctrlX Data Layer](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/ctrlx-data-layer.html).

Auf einem PC mit Windows 11 oder Ubuntu 24.04 nutzt LumiScan Cam Driver [LumiScan Keryx](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/keryx.html).

Knotenadressen, Typen und Aufrufmuster sind auf beiden gleich. LumiScan Cam Driver bietet:

- [ready/request-Handshakes](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/handshake.html)
- [Execute-Methoden](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/execute.html)
- einen [Stream](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/streams.html), der seine Ergebnisse veröffentlicht (experimentell)

Wie Adressen aufgebaut sind, wie Funktionen aufgerufen werden, die Statuscodes und die Werkzeuge sind in [LumiScan Keryx](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/index.html) beschrieben.

## Adressen {#addresses}

Jede Operation bietet einen Knoten `ready` und einen Knoten `request` für den Handshake. Die meisten Operationen bieten außerdem einen Knoten `execute`, der die Operation mit einem einzelnen Schreibvorgang ausführt. Siehe [Eine Methode ausführen](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/execute-a-method.html).

**Tabelle 1. Tabelle 2: Adressen der Funktionalitäten**

| Funktionalität | Zugriff | Adresse |
| --- | --- | --- |
| Capture | Schreibgeschützt | `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/capture/ready` |
| Capture | Beschreibbar | `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/capture/request` |
| Capture | Nur schreiben (Methode) | `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/capture/execute` |
| Save | Schreibgeschützt | `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/save/ready` |
| Save | Beschreibbar | `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/save/request` |
| Save | Nur schreiben (Methode) | `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/save/execute` |
| Load | Schreibgeschützt | `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/load/ready` |
| Load | Beschreibbar | `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/load/request` |
| Load | Nur schreiben (Methode) | `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/load/execute` |
| Remove | Schreibgeschützt | `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/remove/ready` |
| Remove | Beschreibbar | `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/remove/request` |
| Remove | Nur schreiben (Methode) | `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/remove/execute` |
| List Images | Schreibgeschützt | `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/list-images/ready` |
| List Images | Beschreibbar | `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/list-images/request` |
| List Images | Nur schreiben (Methode) | `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/list-images/execute` |
| Connect Camera | Schreibgeschützt | `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/connect-camera/ready` |
| Connect Camera | Beschreibbar | `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/connect-camera/request` |
| Disconnect Camera | Schreibgeschützt | `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/disconnect-camera/ready` |
| Disconnect Camera | Beschreibbar | `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/disconnect-camera/request` |
| Reset | Schreibgeschützt | `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/reset/ready` |
| Reset | Beschreibbar | `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/reset/request` |
| Status | Schreibgeschützt | `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/status/code` |
| Status | Schreibgeschützt | `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/status/text` |
| Set Camera IP | Schreibgeschützt | `hdvisionsystems/lumiscan-cam-driver/system/force-ip/ready` |
| Set Camera IP | Beschreibbar | `hdvisionsystems/lumiscan-cam-driver/system/force-ip/request` |

> [!NOTE]
> Connect Camera, Disconnect Camera und Reset haben keinen Knoten `execute`. Sie können mehrere Sekunden dauern, sodass ein wartender Methodenaufruf meist aufgeben würde, bevor die Kamera den Erfolg meldet. Verwenden Sie für diese drei bitte den ready/request-Handshake.

Die Adressen des experimentellen Bild-Streams, alle unter `<camera name>/control/publish/`, sind in [Bilder streamen](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/streaming-images.html#addresses) aufgeführt.

## Verbindungsschritte {#connection-steps}

1. Start, mit der Kamera verbinden:

   a. Voraussetzung: Die Kamera ist physisch angeschlossen, aber in der Software noch nicht verbunden (XXX/connect-camera/ready = False)

   b. Prüfen Sie XXX/connect-camera/ready = True
      > [!NOTE]
      > Wurde noch kein Bild aufgenommen (package-id ist null), ist **save/ready** **false**.
      - Wird zwischen zwei Aufrufen der Funktion Save kein neues Bild aufgenommen, sendet das Programm trotzdem dieselbe Datei mit demselben Dateinamen.\*

      - Ist die Einstellung korrekt und wurde bereits ein Bild aufgenommen, sendet das Programm das Bild an den konfigurierten Server.

        \\\*Derzeit wird das Bild so benannt:\
        **\<camera_serial>\_\<time stamp in seconds>.<6-digit in seconds>.png**.
        > [!NOTE]
        > Um nicht jedes Mal die gesamte Adresse zu wiederholen, wird in diesem Abschnitt der **unveränderliche Teil** mit der übergeordneten Adresse durch **XXX** ersetzt.\
        > Die Adresse **`hdvisionsystems/lumiscan-cam-driver/<camera name>/control/connect-camera/ready`** wird also als **XXX/connect-camera/ready** geschrieben.

        Entsprechend wird die Adresse **`hdvisionsystems/lumiscan-cam-driver/<camera name>/control/connect-camera/request`** als **XXX/connect-camera/request** geschrieben.
        > [!NOTE]
        > Ist der Wert false, ist die Voraussetzung nicht erfüllt, oder **es wurde keine Kamera gefunden.\
        > Prüfen Sie, ob die Kamera-IP im selben lokalen Netzwerk liegt wie die ctrlX CORE oder der PC.**
        > [!NOTE]
        > Wenn XXX/capture/ready = False:

      - Die Kamera könnte sich in einem Fehlerzustand befinden, nicht gestartet sein oder noch ein Bild aufnehmen.

      - Prüfen Sie den Statuscode für weitere Informationen.
        > [!NOTE]
        > Wenn XXX/capture/ready = True:

        i. Stellen Sie sicher, dass immer nur ein Prozess auf XXX/connect-camera/request zugreift.

        ii. Prüfen Sie, ob Sie dieselbe Data-Layer-Version wie die Kameraanwendung verwenden.

        iii. Kontaktieren Sie HD Vision Systems.

   c. Setzen Sie XXX/connect-camera/request = True

   d. Prüfen Sie XXX/connect-camera/ready = False
      > [!NOTE]
      > Wenn die Anwendung CamDriver nicht erkannt hat, dass sich die Variable geändert hat:

      i. Stellen Sie sicher, dass immer nur ein Prozess auf XXX/connect-camera/request zugreift.

      ii. Prüfen Sie, ob Sie dieselbe Data-Layer-Version wie die Kameraanwendung verwenden.

      iii. Kontaktieren Sie HD Vision Systems.

   e. Setzen Sie XXX/connect-camera/request = False

   f. Prüfen Sie `<camera name>/device-info/is-connected` = True ----→ Die Kamera ist initialisiert und bereit, ein Bild aufzunehmen
      > [!NOTE]
      > Verlassen Sie sich hier nicht auf XXX/status/code. Eine fehlgeschlagene Verbindung zeigt `-10000` nur etwa 100 ms lang; dann ist der Status wieder `0` (ready), obwohl die Kamera weiterhin nicht verbunden ist.

2. Bild aufnehmen

   a. Voraussetzung: Die Kamera ist gestartet (XXX/connect-camera/ready = False)

   b. Prüfen Sie XXX/capture/ready = True

   c. Setzen Sie XXX/capture/request = True

   d. Prüfen Sie XXX/capture/ready = False. Das Capture läuft bereits.

      \\\* Die Bedeutung aller Statuscode-Werte ist in der Tabelle [Werte des Statuscodes](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/initializing-the-camera.html#status-code-values) erklärt.

   e. Setzen Sie XXX/capture/request = False

   f. Prüfen Sie XXX/status/code (Kamera) = 0 ---→ Die Bildaufnahme war erfolgreich
      > [!NOTE]
      > Ein fehlgeschlagenes Capture lässt XXX/status/code auf `3` (waitingForClient), nicht auf seinem Fehlercode, und XXX/capture/ready bleibt False, bis ein Reset erfolgreich ist. Um den Fehlercode des Capture zu lesen, nehmen Sie stattdessen mit `control/capture/execute` auf. Siehe [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).

   g. Das Bild ist aufgenommen; Sie können es unter der Adresse `hdvisionsystems/lumiscan-cam-driver/<camera name>/output/image` abrufen

3. Kamera trennen

   a. Voraussetzung: Die Kamera ist gestartet und nimmt nicht auf (XXX/disconnect-camera/ready = True (intern wird XXX/connect-camera/ready = False, XXX/capture/ready = True geprüft))

   b. Prüfen Sie XXX/disconnect-camera/ready = True

   c. Setzen Sie XXX/disconnect-camera/request = True

   d. Prüfen Sie XXX/disconnect-camera/ready = False

   e. Setzen Sie XXX/disconnect-camera/request = False

   f. Prüfen Sie `<camera name>/device-info/is-connected` = False ---→ Die Kamera ist getrennt

   g. Die Kamera ist freigegeben. Um sie erneut zu verwenden, führen Sie Connect Camera aus.

## Bilddateien speichern {#saving-image-files}

Für das Speichern von Bildern, die mit dem CamDriver aufgenommen wurden, stehen folgende Optionen zur Verfügung:

- Intern auf dem Systemspeicher
- USB-Speichergerät oder SD-Karte am Gerät (nur die Dateisysteme FAT32 oder EXT4 werden unterstützt) (ab LumiScan CamDriver 1.2.0) (ctrlX OS)
- über einen Samba-Server (freigegebener Windows-Ordner) (ab LumiScan CamDriver 1.0.1)

> [!NOTE]
> Beachten Sie, dass keine Bilder gespeichert werden, wenn die Einstellung nicht oder falsch konfiguriert wurde.

**So konfigurieren Sie ein USB-Speichergerät oder eine SD-Karte (ctrlX OS):**

1. **Schließen Sie das Speichergerät an oder stecken Sie die SD-Karte ein**
2. **Melden Sie sich an der ctrlX-OS-Weboberfläche an**
3. **Wählen Sie Settings**
4. **Wählen Sie Storage Devices**
5. **Wählen Sie in der Liste das Speichergerät, das Sie angeschlossen haben und verwenden möchten.**
6. **Klicken Sie auf die Option mount**

> [!NOTE]
> Verwendet das Speichergerät kein FAT32- oder EXT4-Dateisystem, können Sie es nicht einbinden. Stattdessen wird Ihnen angeboten, das Laufwerk mit einem dieser Dateisysteme zu formatieren. Beachten Sie, dass dabei alle vorhandenen Daten auf dem Speichergerät gelöscht werden.

![mount](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/_images/mount.png)

7. **Wählen Sie im Dialogfeld** **`For data exchange`** **und bestätigen Sie mit einem Klick auf mount**
8. **Der Pfad Ihres Speichergeräts wird in der rechten Spalte angezeigt (z. B.** **`/media/sdb1`****). Notieren Sie sich diesen Pfad.**

![path](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/_images/path.png)

![mountDataExchange](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/_images/mountDataExchange.png)

9. **Sie können die CamDriver-App so konfigurieren, dass sie diesen Pfad verwendet, wie im Abschnitt** [Beispielinhalt der Anwendungs-Einstellungsdatei](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/application-settings-content-example.html) **beschrieben**

So konfigurieren Sie einen externen **Samba**-Speicherordner:

1. Wählen Sie den Ordner, den Sie freigeben möchten.

2. Klicken Sie mit der rechten Maustaste darauf.

3. Wählen Sie **Properties.**

4. Wählen Sie die Registerkarte **Sharing**.

5. Gehen Sie zu **Advanced Sharing.**

   ![ex storage 3](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/_images/ex_storage_3.png)

   ![ex storage 1](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/_images/ex_storage_1.png)

6. Legen Sie ein Windows- oder Samba-Benutzerkonto mit Passwort an.
   > [!NOTE]
   > Für den Zugriff auf den freigegebenen Ordner benötigen Sie ein Windows- oder Samba-Benutzerkonto mit Passwort. **Verwenden Sie aus Sicherheitsgründen bitte nicht Ihr reguläres Benutzerprofil**.\
   > Die Anwendung unterstützt derzeit nur das Speichern des Passworts im Klartext.

7. Klicken Sie auf **Apply**.

8. Klicken Sie auf **OK.**

9. Schließen Sie das Fenster **Advanced Sharing**.

10. Prüfen Sie, ob Sie mit dem konfigurierten Benutzerkonto auf den Ordner zugreifen können.

    So legen Sie ein Konto an:

    a. Klicken Sie auf **Permissions**

    b. Fügen Sie einen Benutzer hinzu

    c. Konfigurieren Sie die Berechtigungen für diesen Benutzer.

       ![ex storage 4](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/_images/ex_storage_4.png)

       ![ex storage 5](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/_images/ex_storage_5.png)
       > [!NOTE]
       > Nach dem Anlegen eines externen freigegebenen Speichers müssen Sie die entsprechenden Änderungen in den Einstellungen in **lumiscan-cam-driver.json** vornehmen. Siehe Abschnitt [Speichereinstellungen](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/application-settings-content-example.html#storage-settings) für weitere Informationen dazu.
       > [!NOTE]
       > Prüfen Sie nach dem Neustart des Programms, ob ein Bild im freigegebenen Ordner liegt. Ist keines vorhanden, prüfen Sie das Protokoll auf Hinweise zu fehlerhaften Einstellungen.

11. Starten Sie das Programm neu.

12. Rufen Sie **Connect Camera** auf.

13. Rufen Sie **Capture** auf.

14. Rufen Sie **Save** auf.

## Bilder laden {#loading-images}

Um Bilddateien zu laden, gehen Sie wie folgt vor:

1. **Speicher einrichten: Führen Sie die Schritte 1–10 im Abschnitt** [Bilddateien speichern](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/initializing-the-camera.html#saving-image-files) **aus, um den Speicherort für das Laden von Bildern zu konfigurieren.**
2. **Führen Sie Connect Camera aus.**
3. **Verwenden Sie den Befehl List Images, um die gespeicherten Bilder anzuzeigen.**
4. **Setzen Sie** **`input/image-index`**, **um das gewünschte Bild anzugeben.**
5. **Führen Sie Load aus, um das Bild in den Data Layer zu übertragen.**
   - **Simulationsmodus: Ist er aktiviert, lädt ein Aufruf von Capture ein Bild aus dem konfigurierten Speicherordner und springt für den nächsten Capture-Befehl automatisch zum nächsten Bild.**

> [!NOTE]
> Weitere Informationen zum Simulationsmodus finden Sie in [Beispielinhalt einer Kameradatei](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/camera-example-file-content-example.html), wo das Feld **id** erklärt wird.

## Werte des Statuscodes {#status-code-values}

Der aktuelle Status eines Kameramoduls wird auf `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/status/code` als Zahl und auf `hdvisionsystems/lumiscan-cam-driver/<camera name>/control/status/text` als zugehöriger Name veröffentlicht. Er meldet den Ausgang der letzten Operation, egal ob diese Operation mit dem Handshake oder mit einer `execute`-Methode gestartet wurde.

**Tabelle 2. Tabelle 3: Beschreibung der Statuscode-Werte**

| Statuscode-Nummer | String | Bedeutung |
| --- | --- | --- |
| 0 | "ready" | Die letzte Funktionalität wurde erfolgreich ausgeführt, die Anwendung ist bereit, die nächste Funktionalität auszuführen. |
| 1 | "settingUp" | Das Modul oder die Funktion wird noch eingerichtet. |
| 2 | "running" | Die Funktion läuft gerade. |
| 3 | "waitingForClient" | Es wird auf den Client gewartet (in der Regel darauf, dass XXX/request zurückfällt). Auch das Ende eines über den Handshake angeforderten Capture, das fehlgeschlagen ist: siehe [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). |
| -1 | "undefinedError" | Etwas ist schiefgegangen, und es gibt dafür keinen eigenen Fehlercode. |
| -2 | "invalidSetting" | Die angegebene Einstellungsdatei konnte nicht geladen werden. |
| -3 | "invalidInput" | Eines der Eingabefelder war ungültig, oder ein Capture wurde angefordert, während der Bild-Stream läuft. Der zweite Fall speichert keinen Fehler: Stoppen Sie den Stream und nehmen Sie erneut auf. Siehe [Capture, während der Stream läuft](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/streaming-images.html#capture-while-streaming). |
| -4 | "missingLicense" | Stellen Sie sicher, dass die richtige Lizenz installiert ist. Siehe [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/requirements.html). |
| -5 | "restartRequired" | Die Einstellungsdateien wurden auf dem Data Layer geändert: Starten Sie die Anwendung neu. Siehe [Einstellungen auf dem Data Layer](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/settings-on-the-data-layer.html#restart-required). |
| -10000 | "failedToConnectToCamera" | Beim Verbinden mit der Kamera ist ein Problem aufgetreten; stellen Sie sicher, dass die Kamera angeschlossen ist. |
| -10001 | "pixelFormatNotSupported" | Ungültiges Pixelformat: Tippfehler im Pixeltyp, oder die Kamera unterstützt dieses Pixelformat nicht. |
| -10002 | "couldNotSetPixelType" | Das Pixelformat konnte nicht gesetzt werden. Die Kamera läuft noch; stoppen Sie sie und setzen Sie es erneut. |
| -10003 | "couldNotSetExposureTime" | Die Belichtungszeit liegt außerhalb des zulässigen Bereichs. Erfragen Sie den zulässigen Wertebereich beim Kamerahersteller. |
| -10004 | "couldNotCaptureImage" | Dieses Problem kann mehrere Ursachen haben: \* Die Kamera ist möglicherweise getrennt; verbinden Sie sie erneut. Tritt das häufig auf, kann es sich um einen Kommunikationsfehler durch schlechte Verbindungsqualität handeln. \* Verwenden Sie unbedingt ein „Foil Shielded Twisted Pair"-Kabel. \* ctrlX OS: Prüfen Sie die MTU-Größe in den Einstellungen der ctrlX-Weboberfläche. Sie sollte auf 8000 oder 9000 gesetzt sein.\\\*<br> Können Sie die MTU-Größe nicht ändern, wechseln Sie zu einem Ethernet-Port, der eine große MTU-Größe unterstützt. (Hinweis: Seit 1.16 bzw. 1.18 unterstützt ctrlX das Ändern der MTU.) \* PC: Prüfen Sie die Einstellung der MTU-Größe (Jumbo Frames) des Netzwerkadapters, an dem die Kamera angeschlossen ist. Sie sollte auf 8000 oder 9000 gesetzt sein. |
| -10005 | "noImageTaken" | Es gibt noch kein Bild, mit dem gearbeitet werden kann. Nehmen Sie ein Bild auf, bevor Sie es speichern. |
| -10006 | "saveImageFailed" | Prüfen Sie, ob: \* **ip**, **username**, **password** in der Einstellung korrekt konfiguriert sind, \* die IP von der ctrlX CORE oder dem PC aus erreichbar ist, \* Ihre Samba-Freigabe (freigegebener Ordner) genügend freien Speicherplatz hat. |
| -10007 | "loadImageFailed" | Die ausgewählte Bilddatei konnte nicht geladen werden. Prüfen Sie, ob die Datei noch im Speicherordner vorhanden und lesbar ist. |
| -10008 | "noImageToLoad" | Im Speicherordner liegt kein Bild zum Laden. Verwenden Sie List Images, um zu prüfen, was gespeichert ist. |
| -10009 | "imageIndexOutOfRange" | Der Wert von **index-of-image-to-load** verweist auf kein vorhandenes Bild. Verwenden Sie List Images, um zu prüfen, wie viele Bilder gespeichert sind. |
| -10010 | "removeImageFailed" | Die ausgewählte Bilddatei konnte nicht entfernt werden. Prüfen Sie, ob der Speicherordner beschreibbar ist. |
| -10011 | "producerInitFailed" | Der GenTL-Producer konnte nicht gestartet werden. Prüfen Sie, ob der für diese Kamera konfigurierte Producer installiert ist und sein Pfad korrekt ist. |
| -10012 | "softwareTriggerFailed" | `control/trigger/execute` hat die Kamera im Software-Trigger-Modus vorgefunden, aber die Kamera hat weder `TriggerSoftware` noch `SoftwareTrigger` (noch den Namen aus ihrem Feature-Mapping) oder hat den Befehl abgelehnt. Siehe [Software-Trigger](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/execute-a-method.html#software-trigger). |

## MTU-Größe ändern (ctrlX OS) {#mtu-size-change}

Dieser Abschnitt gilt für ctrlX OS. Auf einem PC stellen Sie die MTU-Größe (Jumbo Frames) in den Einstellungen des Netzwerkadapters ein, an dem die Kamera angeschlossen ist.

\\\* Wie Sie die MTU-Größe ändern, steht im nächsten Abschnitt [MTU-Größe ändern](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/initializing-the-camera.html#mtu-size-change).

So ändern Sie die MTU-Größe für die Kamera:

1. Melden Sie sich an der ctrlX-OS-Weboberfläche an.

2. Gehen Sie zu **Home.**

3. Wählen Sie **Settings.**

4. Wählen Sie **Network Interfaces.**

   ![s1](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/_images/s1.png)

   ![s11](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/_images/s11.png)

   ![s3ninterf](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/_images/s3ninterf.png)
   > [!NOTE]
   > Die Nummer des aktuell verwendeten Ethernet-Ports finden Sie neben dem Port-Eintrag auf dem ctrlX-Gerät. In diesem Beispiel ist es XF12.

   ![xf12](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/_images/xf12.png)

5. Wählen Sie den aktuell verwendeten Ethernet-Port Ihres ctrlX-Geräts.

7. Klappen Sie **Advanced Settings** auf.

   ![s4nix12](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/_images/s4nix12.png)

   ![s5](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/_images/s5.png)

8. Geben Sie im Feld MTU den gewünschten Wert ein (siehe Statuscode **-10004** in [Werte des Statuscodes](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/initializing-the-camera.html#status-code-values)).

9. Klicken Sie zur Bestätigung auf **Save**.

10. Eine Meldung bestätigt die Änderung auf dem Bildschirm.

11. Sobald die Änderungen gespeichert sind, können Sie das Programm schließen.

## GenICam-Features {#genicam-features}

So bearbeiten Sie GenICam-Features:

a. Stellen Sie sicher, dass die Kamera, die Sie konfigurieren möchten, wie in [Verbindungsschritte](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/initializing-the-camera.html#connection-steps) beschrieben verbunden ist.

b. Unter `hdvisionsystems/lumiscan-cam-driver/<cameraname>/features` finden Sie eine Reihe von Unterknoten, die Knoten enthalten. Sie entsprechen den GenICam-Feature-Kategorien und den einzelnen darin enthaltenen Features. Namen, Werte, Schreibrechte und Beschreibungen dieser Knoten werden direkt von der jeweiligen Kamera übernommen. Sie können sich also an den Beschreibungen in der Benutzeroberfläche orientieren.

Weitere Informationen zu diesen Features finden Sie in der Dokumentation Ihres Kameraherstellers.

## IP-Konfiguration der Kamera erzwingen {#force-ip-configuration-of-camera}

![s6](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/_images/s6.png)

![s7](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/_images/s7.png)

Die IP-Konfiguration einer Kamera kann auf bestimmte Werte gesetzt werden. Das ist besonders nützlich, wenn die aktuelle Konfiguration fehlerhaft ist. Die hier beschriebene Methode funktioniert auch, wenn die Kamera normalerweise nicht verbunden oder erkannt wird, solange sie über dieselbe Netzwerkverbindung erreichbar bleibt.

Eine solche Situation kann auftreten, wenn die konfigurierte Subnetz-ID der Kamera nicht mit der Subnetz-ID der ctrlX CORE oder des PCs übereinstimmt. (Die Subnetz-ID ist ein Teil der konfigurierten IP-Adresse. Die Subnetzmaske legt fest, welcher Teil der IP-Adresse die Subnetz-ID darstellt.)

Die für das Erzwingen der IP-Konfiguration einer Kamera relevanten Data-Layer-Adressen finden Sie unter: `hdvisionsystems/lumiscan-cam-driver/system/force-ip/`

Die einzelnen Knoten sind in Tabelle 4 aufgeführt.

So erzwingen Sie die IP-Konfiguration einer Kamera:

1. Setzen Sie die gewünschte IP-Adresse, das Gateway und die Subnetzmaske sowie die MAC-Adresse der Kamera.
2. Setzen Sie das Request-Signal auf **true** und dann wieder auf **false**.

Dieser Ablauf entspricht dem [Grundkonzept des Handshakes](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/general-concept-of-handshake.html).

> [!NOTE]
> Beim Bearbeiten dieser Werte werden sie direkt in die Kamera geschrieben. Seien Sie vorsichtig beim Bearbeiten von Werten, die die Netzwerkverbindung der Kamera betreffen, da dies zu einem Verbindungsverlust führen kann. Beachten Sie, dass das Ändern dieser Werte die Bildaufnahme beeinflussen kann.

> [!NOTE]
> Wenn die CamDriver-App eine Verbindung zu einer Kamera herstellt, versetzt sie die Kamera auch in den Aufnahmemodus. Das beeinflusst, welche Knoten beschrieben werden können.

**Tabelle 3. Tabelle 4: IP-Konfiguration der Kamera erzwingen**

| Name | Beschreibung |
| --- | --- |
| gateway | Das Standard-Gateway, auf das die Kamera gesetzt wird |
| ip | Die statische IP-Adresse, auf die die Kamera gesetzt wird |
| mac address | Die MAC-Adresse der Kamera. Über diese Adresse wird die richtige Kamera identifiziert. |
| subnet | Die Subnetzmaske, auf die die Kamera gesetzt wird |
| request | Das Request-Signal; um das Erzwingen der IP zu starten, setzen Sie es auf true und dann wieder auf false |
| ready | Das Ready-Signal; es zeigt an, dass ein Request gestellt werden kann oder dass einer in Bearbeitung ist. |

## Szenario 1: Kamera, Computer und ctrlX X3 über einen Switch verbinden {#scenario-1-connect-camera-computer-ctrlx-x3-via-switch}

Dieses Szenario gilt für ctrlX OS (ctrlX CORE X3). Siehe auch [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).

1. Öffnen Sie auf der ctrlX X3 `settings/NetworkInterfaces/XF10`

   a. Setzen Sie **General/MTU** auf 8000

   b. Deaktivieren Sie **IPv4/DHCP**

   c. **IPv4/Address**: Stellen Sie sicher, dass 192.168.1.1 eingetragen ist (sollte standardmäßig bereits vorhanden sein)

   d. Klicken Sie auf **save**