> For the complete documentation index, see [llms.txt](https://documentation.nomos-system.com/nomos-system/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.nomos-system.com/nomos-system/integrator-de/administration/usb-seriell-vpn.md).

# USB-Seriell über VPN

Über **„Ein lokales USB-Gerät über VPN freigeben"** stellt der Controller einen angesteckten USB-Seriell-Adapter als TCP-Port bereit. Damit programmieren Sie Bussysteme aus der Ferne, deren Konfigurationssoftware einen direkten seriellen Zugriff benötigt — ganz so, als wäre der Adapter lokal an Ihrem Rechner angeschlossen.

{% hint style="info" %}
Die Freigabe ist über das [Direkt-VPN](/nomos-system/integrator-de/administration/vpn.md), das [Support-VPN](/nomos-system/integrator-de/administration/support-vpn.md) und im lokalen Netzwerk erreichbar.
{% endhint %}

## Freigabe aktivieren

1. Öffnen Sie die VPN-Seite und klicken Sie auf **„Ein lokales USB-Gerät über VPN freigeben"**.
2. Wählen Sie die **serielle Schnittstelle** (den USB-Adapter), die **Baudrate** (muss zur angeschlossenen Hardware passen) und den **TCP-Port** (Standard: 3001).
3. Nach dem Speichern zeigt die Übersicht den Status der Freigabe: **Läuft**, **Verbunden** oder **Adapter nicht angesteckt**.

## Client unter Windows einrichten

Unter Windows richten Sie einen **virtuellen COM-Port** ein, der auf den TCP-Port des Controllers zeigt — zum Beispiel mit dem kostenlosen **HW VSP3** (Einzelport-Version, [hw-group.com](https://www.hw-group.com/software/hw-vsp3-virtual-serial-port)):

1. HW VSP3 herunterladen und installieren (Variante „Standalone").
2. Im Reiter **„Virtual Serial Port"** einen freien **COM-Port** wählen (z. B. COM5), als **IP Address** die VPN-IP-Adresse des Controllers eintragen und als **Port** den konfigurierten TCP-Port (Standard: 3001).
3. Im Reiter **„Settings"** die Option **„NVT enabled" deaktivieren** — die Verbindung läuft über rohes TCP.
4. Mit **„Create COM"** den virtuellen COM-Port anlegen.

Anschließend wählen Sie den neuen COM-Port in Ihrer Programmiersoftware aus. Stellen Sie dort dieselbe **Baudrate** ein wie in der Freigabe (Datenformat 8N1).

## Client unter macOS / Linux einrichten

Auf macOS und Linux übernimmt `socat` diese Aufgabe (macOS: Installation mit `brew install socat`):

```
socat pty,link=/tmp/ttyNOMOS,raw,echo=0 tcp:<VPN-IP>:3001
```

Solange der Befehl läuft, steht `/tmp/ttyNOMOS` als serielle Schnittstelle bereit und kann in der Programmiersoftware ausgewählt werden.

## Hinweise

{% hint style="warning" %}

* Es ist **eine Verbindung gleichzeitig** möglich — trennen Sie den Client, bevor sich ein anderer verbindet.
* Die **Baudrate** der Freigabe muss mit der angeschlossenen Hardware übereinstimmen (Datenformat 8N1).
* Der USB-Adapter muss am Controller **angesteckt** sein — den aktuellen Zustand zeigt die Statusanzeige in der Übersicht.
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://documentation.nomos-system.com/nomos-system/integrator-de/administration/usb-seriell-vpn.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.