> 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/integratore-it/amministrazione/usb-seriale-vpn.md).

# USB seriale via VPN

Con **«Esponi un dispositivo USB locale via VPN»** il controller mette a disposizione un adattatore seriale USB collegato come porta TCP. In questo modo puoi programmare a distanza sistemi bus il cui software di configurazione richiede un accesso seriale diretto — come se l'adattatore fosse collegato direttamente al tuo computer.

{% hint style="info" %}
La condivisione è raggiungibile tramite la [Direct-VPN](/nomos-system/integratore-it/amministrazione/vpn.md), la [VPN di supporto](/nomos-system/integratore-it/amministrazione/support-vpn.md) e sulla rete locale.
{% endhint %}

## Attivare la condivisione

1. Apri la pagina VPN e fai clic su **«Esponi un dispositivo USB locale via VPN»**.
2. Seleziona la **porta seriale** (l'adattatore USB), il **baud rate** (deve corrispondere all'hardware collegato) e la **porta TCP** (predefinita: 3001).
3. Dopo il salvataggio, la panoramica mostra lo stato della condivisione: **In esecuzione**, **Connesso** o **Adattatore non collegato**.

## Configurare il client su Windows

Su Windows crei una **porta COM virtuale** che punta alla porta TCP del controller — ad esempio con il software gratuito **HW VSP3** (edizione a porta singola, [hw-group.com](https://www.hw-group.com/software/hw-vsp3-virtual-serial-port)):

1. Scarica e installa HW VSP3 (edizione «Standalone»).
2. Nella scheda **«Virtual Serial Port»** scegli una **porta COM** libera (ad es. COM5), inserisci l'indirizzo IP VPN del controller come **IP Address** e la porta TCP configurata (predefinita: 3001) come **Port**.
3. Nella scheda **«Settings»** **disattiva «NVT enabled»** — la connessione utilizza TCP raw.
4. Fai clic su **«Create COM»** per creare la porta COM virtuale.

Seleziona quindi la nuova porta COM nel software di programmazione e imposta lo stesso **baud rate** della condivisione (formato dati 8N1).

## Configurare il client su macOS / Linux

Su macOS e Linux questa funzione è svolta da `socat` (macOS: installazione con `brew install socat`):

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

Finché il comando è in esecuzione, `/tmp/ttyNOMOS` è disponibile come porta seriale e può essere selezionata nel software di programmazione.

## Note

{% hint style="warning" %}

* È possibile **una sola connessione alla volta** — disconnetti il client prima che se ne colleghi un altro.
* Il **baud rate** della condivisione deve corrispondere all'hardware collegato (formato dati 8N1).
* L'adattatore USB deve essere **collegato** al controller — l'indicatore di stato nella panoramica mostra lo stato attuale.
  {% 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/integratore-it/amministrazione/usb-seriale-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.