# Rhopoint COM Agent

> Section of the Rhopoint Instruments Manual.

This file bundles all 11 pages of this section as Markdown.

# Rhopoint COM Agent

Rhopoint COM Agent è un'applicazione Windows che acquisisce i dati di misura inviati tramite una connessione seriale (COM) dagli strumenti Rhopoint — come il misuratore di spessore del film FT3 — e li trasforma in qualcosa di utile: file strutturati su disco, oppure valori digitati direttamente in un altro programma.

Ogni volta che lo strumento stampa un risultato, COM Agent lo legge, ne riconosce il formato dei dati e lo scrive nel formato scelto: un file **TXT** grezzo, un file **CSV** strutturato, oppure **emulando la pressione dei tasti** in modo che i valori compaiano direttamente nel campo che ha attualmente il focus (una cella di un foglio di calcolo, un database di controllo qualità, un modulo ERP, …).

![](../_images/com-agent-main-screen-it.png)

## Cosa puoi fare con COM Agent

1. [Installare COM Agent](rhopoint-com-agent-install-com-agent.md) — scaricare, installare e avviare l'applicazione.
2. [Collegare uno strumento](rhopoint-com-agent-connecting-an-instrument.md) — scegliere la porta COM e la velocità in baud e confermare l'arrivo dei dati.
3. [Formati di uscita](rhopoint-com-agent-output-formats.md) — scrivere ogni misurazione in file TXT e/o CSV.
4. [Emulazione tastiera](rhopoint-com-agent-keyboard-emulation.md) — digitare i valori misurati direttamente in un'altra applicazione, con separatori configurabili.
5. [Acquisire le misurazioni](rhopoint-com-agent-capturing-measurements.md) — avviare e arrestare l'acquisizione e seguire l'attività in tempo reale.
6. [Modalità Demo](rhopoint-com-agent-demo-mode.md) — provare l'applicazione senza uno strumento collegato.
7. [Licenze](rhopoint-com-agent-licensing.md) — sbloccare l'acquisizione live aggiungendo una licenza; la modalità demo funziona sempre senza licenza.
8. [Impostazioni e lingua](rhopoint-com-agent-settings-and-language.md) — la configurazione viene memorizzata e l'interfaccia è disponibile in tredici lingue.
9. [Avvio da riga di comando](rhopoint-com-agent-command-line-launch.md) — avviare con configurazione preimpostata e acquisire automaticamente (per l'automazione).
10. [Aggiornare COM Agent](rhopoint-com-agent-updating-com-agent.md) — mantenere l'applicazione aggiornata.

## Strumenti supportati

COM Agent legge l'uscita seriale degli strumenti Rhopoint, tra cui:

- **FT3** misuratore di spessore del film

> [!info] COM Agent attualmente offre l'analisi strutturata completa (CSV) per il formato di spessore FT3 *"print all samples"*. Gli altri strumenti vengono acquisiti come testo grezzo; l'analisi strutturata viene aggiunta non appena i dati di esempio sono disponibili. L'uscita tastiera e TXT funziona per ogni strumento.

> [!info] COM Agent funziona solo su Windows. Viene distribuito come applicazione autonoma — non è richiesta alcuna installazione separata di .NET — e si mantiene aggiornato automaticamente.


---

# Install COM Agent

Rhopoint COM Agent è un'applicazione Windows leggera. Il programma di installazione configura tutto il necessario e mantiene l'applicazione aggiornata automaticamente.

## Download

Scarica la versione più recente di COM Agent da [download.rhopointservice.net/com-agent](https://download.rhopointservice.net/com-agent).

## Installazione

1. Scarica il programma di installazione di COM Agent dal link sopra.
2. Fai doppio clic sul programma di installazione e segui le istruzioni a schermo.
3. Avvia **Rhopoint COM Agent** dal menu Start.

> [!info] COM Agent è autonomo — non richiede un'installazione separata del runtime .NET. Il programma di installazione verifica inoltre la presenza di aggiornamenti e li installa automaticamente in background, in modo da eseguire sempre la versione più recente.

## Requisiti di sistema

- **Sistema operativo:** Windows 10 (build 19041 / 20H1) o versione successiva
- **CPU:** x64 o ARM64
- **Una porta seriale (COM) libera** — integrata o tramite un adattatore USB-seriale — per collegare lo strumento. Alcuni strumenti richiedono un cavo speciale (vedi [la panoramica](rhopoint-com-agent.md)).

## Primo avvio

All'avvio di COM Agent, la finestra principale è suddivisa in due aree:

- A **sinistra**, la configurazione: impostazioni di connessione e opzioni di uscita.
- A **destra**, l'attività in tempo reale: stato, numero di misurazioni ricevute, ultima misurazione e un registro attività.

Il pulsante **Avvia / Arresta** si trova in alto a destra, sopra il contatore delle misurazioni, ed è sempre visibile.

![](../_images/com-agent-main-screen-it.png)

[Avanti: collega lo strumento](rhopoint-com-agent-connecting-an-instrument.md)


---

# Connecting an Instrument

In modalità **Live**, COM Agent legge i dati di misura direttamente da uno strumento tramite una connessione seriale (COM).

![](../_images/com-agent-connection-it.png)

## 1. Collega l'hardware

1. Collega lo strumento al PC utilizzando il cavo seriale o l'adattatore USB-seriale. Alcuni strumenti (CBT1.2, NovoHaze TX) richiedono un cavo speciale — vedi la [panoramica](rhopoint-com-agent.md).
2. Accendi lo strumento.

## 2. Scegli le impostazioni di connessione

Nella sezione **Connessione** a sinistra:

| Impostazione | Descrizione |
| --- | --- |
| **Modalità** | Imposta su **Live** per leggere da una porta seriale. (Usa **Demo** per provare l'app senza hardware — vedi [Modalità Demo](rhopoint-com-agent-demo-mode.md).) |
| **Porta COM** | Seleziona la porta a cui è collegato lo strumento. Fai clic sul pulsante **aggiorna** per eseguire una nuova scansione delle porte dopo aver collegato un adattatore. |
| **Velocità in baud** | La velocità seriale. Il valore predefinito per gli strumenti Rhopoint è **19200**. |
| **Marcatore parte** | Il carattere che lo strumento stampa per contrassegnare ciascuna parte di un set di dati completo. Il valore predefinito è **^**. |
| **Numero di parti** | Quanti marcatori di parte compongono un set di dati completo. Il valore predefinito è **4**. |

> [!info] **Marcatore parte** e **Numero di parti** indicano a COM Agent quando una misurazione è completa. Un set di dati viene scritto solo dopo aver ricevuto il numero previsto di marcatori e dopo la fine della riga — questo impedisce il salvataggio di misurazioni ricevute solo in parte. I valori predefiniti corrispondono agli strumenti Rhopoint; modificali solo se consigliato dal supporto Rhopoint.

## 3. Scegli cosa fare con i dati

Decidi come salvare o inoltrare ciascuna misurazione:

- Scrivere file — vedi [Formati di uscita](rhopoint-com-agent-output-formats.md).
- Digitare i valori in un'altra applicazione — vedi [Emulazione tastiera](rhopoint-com-agent-keyboard-emulation.md).

Puoi combinare queste opzioni (ad esempio, scrivere un file CSV *e* digitare la media in un foglio di calcolo).

## 4. Avvia l'acquisizione

Premi **Avvia** (in alto a destra) ed esegui una misurazione sullo strumento. Il registro attività a destra conferma l'arrivo dei dati. Vedi [Acquisire le misurazioni](rhopoint-com-agent-capturing-measurements.md) per i dettagli.

> [!warning] Se la porta COM selezionata non può essere aperta (ad esempio perché un altro programma la sta già utilizzando), COM Agent mostra un errore. Chiudi l'altro programma o scegli una porta diversa, quindi riprova.

[Avanti: scegli il formato di uscita](rhopoint-com-agent-output-formats.md)


---

# Output Formats

COM Agent può scrivere ogni misurazione completata in un file. Scegli una **Cartella di uscita** e seleziona uno o più **Formati di uscita**. I formati possono essere combinati liberamente.

![](../_images/com-agent-output-formats-it.png)

## Cartella di uscita

Fai clic su **Sfoglia…** accanto a *Cartella di uscita* e scegli dove scrivere i file. Ogni misurazione crea un nuovo file con un nome univoco e con marca temporale, in modo che nulla venga mai sovrascritto:

```
2025-10-11T11-03-56Z-00007-3f9c1a2b-….csv
```

Il nome contiene la marca temporale UTC, un contatore progressivo e un identificatore univoco.

## Formati

| Formato | Cosa produce |
| --- | --- |
| **File di testo (.txt)** | I dati grezzi esattamente come ricevuti dallo strumento, senza alcuna elaborazione. Funziona per ogni strumento. |
| **File CSV (.csv)** | Un file strutturato per fogli di calcolo con colonne denominate e unità metriche. Richiede un formato di dati riconosciuto (attualmente il formato di spessore FT3 *"print all samples"*). |
| **Emulazione tastiera** | Digita i valori in un'altra applicazione invece di scrivere un file — vedi [Emulazione tastiera](rhopoint-com-agent-keyboard-emulation.md). |

> [!info] Puoi abilitare più formati contemporaneamente. Ad esempio, seleziona **Testo** e **CSV** per conservare un archivio grezzo insieme a un file strutturato, oppure seleziona **CSV** e **Tastiera** per archiviare i dati *e* digitare un valore nel tuo sistema di controllo qualità.

## Opzioni di esportazione CSV

![](../_images/com-agent-csv-options-it.png)

Quando **CSV** è abilitato, compare un pannello **Opzioni CSV** con quattro impostazioni che controllano come viene scritto il file. COM Agent sceglie valori predefiniti sensati in base alla tua lingua e regione, quindi nella maggior parte dei casi puoi lasciarli invariati.

| Opzione | Scelte | Effetto |
| --- | --- | --- |
| **Delimitatore** | Virgola "," · Punto e virgola ";" · Tabulazione "→" | Il carattere posto tra le colonne. |
| **Formato ora** | ISO 8601, UTC · ISO 8601, locale | Formato della colonna *Timestamp*: UTC (ad es. `2025-10-11T11:03:56Z`) oppure ora locale con offset (ad es. `2025-10-11T13:03:56+02:00`). |
| **Separatore decimale** | Punto "." · Virgola "," | Il segno decimale usato per i valori numerici. Le date e gli identificatori non vengono mai modificati. |
| **Codifica del file** | UTF-8 · UTF-8 con BOM | Se all'inizio del file viene scritto un byte-order mark. Un BOM aiuta alcuni programmi di fogli di calcolo (ad esempio Excel) a rilevare l'UTF-8 e a mostrare correttamente le intestazioni in µm. |

> [!tip] **Delimitatore** e **Separatore decimale** adottano per impostazione predefinita la convenzione della tua regione: le regioni che separano i valori di un elenco con un punto e virgola (la maggior parte dell'Europa) partono con **punto e virgola + virgola decimale**, le altre (ad esempio l'inglese) con **virgola + punto decimale**. In questo modo il file si apre correttamente con un doppio clic nel tuo programma di fogli di calcolo locale. Una volta che modifichi un'impostazione, la tua scelta viene memorizzata.

## Struttura CSV

Per il formato di spessore FT3, COM Agent produce una riga per ogni singolo campione, insieme alle statistiche riepilogative e ai metadati dello strumento. Le unità sono espresse in micrometri (µm).

| Column | Esempio | Significato |
| --- | --- | --- |
| Index | 1 | Numero del campione all'interno del set |
| Measurement (µm) | 1090.9 | La lettura del singolo campione |
| Min (µm) | 1088.4 | Minimo del set |
| Max (µm) | 1090.9 | Massimo del set |
| Mean (µm) | 1089.4 | Media del set |
| StdDev (µm) | 0.990 | Deviazione standard del set |
| Template | 10 | Il formato dei dati dello strumento |
| Device_ID | FTG38041012H | Numero di serie / ID dello strumento |
| Test_Date | 2025-10-07 | Data del test (ISO 8601) |
| Calibration_Date | 2025-10-11 | Data dell'ultima calibrazione |
| Test_Time | 11:03:56 | Ora del test |
| Sample_Count | 5 | Numero di campioni nel set |
| Timestamp | 2025-10-11T11:03:56Z | Quando COM Agent ha ricevuto il set, nel *Formato ora* scelto |

> [!info] I valori propri dello strumento *Test_Date* / *Test_Time* provengono dall'orologio del dispositivo e non hanno fuso orario. La colonna **Timestamp** è il momento in cui il tuo PC ha ricevuto il set, quindi riflette l'opzione *Formato ora* (UTC o locale).

> [!info] Se COM Agent riceve dati che non riconosce come formato strutturato, il file CSV viene saltato per quella misurazione e nel registro attività compare una nota. L'uscita **TXT** grezza (se abilitata) viene sempre scritta indipendentemente dal formato.

[Avanti: digita i valori in un'altra applicazione](rhopoint-com-agent-keyboard-emulation.md)


---

# Keyboard Emulation

L'emulazione tastiera consente a COM Agent di **digitare i valori misurati direttamente in un altro programma** — esattamente come se li avessi digitati sulla tastiera. È ideale per inserire le letture in un foglio di calcolo, in un database di controllo qualità, in una schermata ERP o in qualsiasi altra applicazione, senza copiare e incollare.

Quando una misurazione viene completata, COM Agent digita il valore o i valori selezionati nella **finestra e nel campo che hanno attualmente il focus della tastiera**.

![](../_images/com-agent-keyboard-options-it.png)

## Abilitarla

Seleziona **Emulazione tastiera** in [Formati di uscita](rhopoint-com-agent-output-formats.md). Le **Opzioni tastiera** compaiono sotto.

## Valori

Seleziona uno o più valori da digitare. **Media** è selezionata per impostazione predefinita.

| Valore | Digita |
| --- | --- |
| **Media** | La media del set di misurazioni |
| **Minimo** | La lettura più piccola |
| **Massimo** | La lettura più grande |
| **Dev. std.** | La deviazione standard |
| **Misurazioni** | Ogni singola lettura dei campioni |
| **Grezzo** | I dati grezzi completi come ricevuti dallo strumento |

Quando vengono selezionati più valori, questi vengono digitati nell'ordine mostrato sopra, ciascuno separato dal **Separatore** scelto.

## Separatore e suffisso

| Opzione | Scopo |
| --- | --- |
| **Separatore** | Il tasto premuto *tra* i valori (e tra le singole misurazioni). Scegli **Tab**, **Enter** o **Nessuno**. |
| **Suffisso** | Il tasto premuto *dopo l'ultimo* valore. Scegli **Tab**, **Enter** o **Nessuno**. |

> [!info] Usa **Tab** per passare alla cella o al campo successivo, oppure **Enter** per confermare una voce / passare alla riga successiva. Ad esempio, *Separatore = Tab* e *Suffisso = Enter* riempie una riga di celle e poi passa alla riga successiva — perfetto per i fogli di calcolo.

## Separatore decimale

Imposta il **Separatore decimale** in base all'applicazione di destinazione — generalmente un punto (`.`) per le impostazioni locali inglesi o una virgola (`,`) per quelle tedesche/francesi.

## Ritardo tastiera

Il **Ritardo tastiera** imposta una breve pausa dopo ciascuna pressione di tasto emulata.

> [!warning] Se i valori digitati arrivano **corrotti o con caratteri ripetuti**, aumenta il Ritardo tastiera. Alcune applicazioni e alcuni PC accettano le pressioni di tasto iniettate più lentamente di altri. Parti dal valore predefinito e aumentalo (ad esempio a 100 ms) finché i valori non compaiono correttamente. L'impostazione viene salvata per ciascun PC.

## Esempio

Con **Media** e **Minimo** selezionati, *Separatore = Tab*, *Suffisso = Enter*, digitando in un foglio di calcolo si produce:

```
1089.4 ⇥ 1088.4 ⏎
```

La media finisce nella prima cella, il minimo in quella successiva e il cursore si sposta alla riga seguente — pronto per la misurazione successiva.

> [!info] L'emulazione tastiera non scrive un file. Per conservare un registro *e* digitare i valori, seleziona anche **Testo** o **CSV** in [Formati di uscita](rhopoint-com-agent-output-formats.md).

[Avanti: acquisisci le misurazioni](rhopoint-com-agent-capturing-measurements.md)


---

# Capturing Measurements

Una volta configurata la [connessione](rhopoint-com-agent-connecting-an-instrument.md) e scelta l'[uscita](rhopoint-com-agent-output-formats.md), sei pronto per l'acquisizione.

## Avvio e arresto

Premi **Avvia** (in alto a destra). COM Agent apre la porta seriale e inizia ad ascoltare. Il pulsante si trasforma in **Arresta**; premilo per terminare la sessione e rilasciare la porta.

Mentre l'acquisizione è in corso, la configurazione a sinistra è **bloccata** in modo da non poter essere modificata durante la sessione.

![](../_images/com-agent-running-it.png)

## Il pannello in tempo reale

Il lato destro mostra ciò che accade in tempo reale:

| Elemento | Significato |
| --- | --- |
| **Badge di stato** | **Inattivo** prima di avviare, **In ascolto** durante l'acquisizione, **Errore** se la connessione fallisce. |
| **Set ricevuti** | Un conteggio progressivo delle misurazioni complete acquisite in questa sessione. |
| **Ultima misurazione** | La Media, il Minimo, il Massimo e la Dev. std. della misurazione più recente (per i formati riconosciuti). |
| **Registro attività** | Un elenco scorrevole di eventi: dati ricevuti, file scritti (con il loro percorso completo), uscita tastiera ed eventuali avvisi. Usa **Cancella** per svuotarlo. |

## Eseguire una misurazione

1. Premi **Avvia** in COM Agent.
2. Avvia una misurazione sullo strumento come faresti normalmente.
3. Il registro attività mostra *"Receiving data…"* seguito dal percorso di ciascun file scritto, oppure una voce *"[Keyboard]"* se l'emulazione tastiera è abilitata.
4. Il contatore **Set ricevuti** aumenta e **Ultima misurazione** si aggiorna.

> [!info] Ogni misurazione completata viene gestita in modo indipendente — puoi eseguirne quante ne vuoi in un'unica sessione. Non è necessario arrestare e riavviare tra una misurazione e l'altra.

> [!warning] Se lo stato passa a **Errore** (ad esempio, il cavo è scollegato o lo strumento è spento), arresta la sessione, controlla la connessione e riavvia.

[Avanti: provalo senza uno strumento](rhopoint-com-agent-demo-mode.md)


---

# Demo Mode

La modalità demo ti consente di provare COM Agent **senza uno strumento collegato**. Invece di leggere da una porta seriale, COM Agent genera su richiesta una misurazione demo realistica — utile per imparare a usare l'applicazione, testare la cartella di uscita o la configurazione della tastiera, oppure per fare una dimostrazione.

![](../_images/com-agent-demo-mode-it.png)

## Usare la modalità demo

1. Imposta **Modalità** su **Demo** nella sezione Connessione. Le impostazioni della porta COM e dei baud scompaiono — non sono necessarie.
2. Scegli i tuoi [formati di uscita](rhopoint-com-agent-output-formats.md) e, se lo desideri, le [opzioni tastiera](rhopoint-com-agent-keyboard-emulation.md), esattamente come in modalità live.
3. Premi **Avvia**.
4. Premi il tasto **Alt destro** in qualsiasi punto — anche in un'altra applicazione — per inserire una misurazione demo.

Ogni pressione di Alt destro produce una misurazione demo completa, che viene poi scritta e/o digitata in base alle impostazioni di uscita, proprio come una lettura reale.

> [!info] La modalità demo è il modo più rapido per verificare la configurazione dell'**emulazione tastiera**: imposta la Modalità su Demo, abilita l'uscita tastiera, fai clic in un foglio di calcolo, premi Avvia e tocca Alt destro — i valori compaiono nelle celle.

> [!info] I dati demo utilizzano il formato di spessore FT3, quindi funzionano con l'uscita CSV e tutti i valori della tastiera (Media, Min, Max, Dev. std., Misurazioni).

[Avanti: licenze](rhopoint-com-agent-licensing.md)


---

# Licensing

COM Agent necessita di una licenza valida per **acquisire misurazioni live** da uno strumento. La [modalità demo](rhopoint-com-agent-demo-mode.md) funziona sempre senza licenza, quindi puoi esplorare l'applicazione e testare la configurazione dell'uscita e della tastiera in qualsiasi momento.

Lo stato della licenza è sempre visibile in alto a destra nella finestra:

- Un badge verde **Licenze attive: N** indica che l'acquisizione live è sbloccata.
- Un badge rosso **Nessuna licenza attiva** indica che è disponibile solo la modalità demo.

![](../_images/com-agent-licence-manager-it.png)

## Come funzionano le licenze

Una licenza COM Agent può essere associata in due modi:

- **A questo computer (Host ID)** — sblocca l'acquisizione live su questo PC, per qualsiasi strumento collegato.
- **A un numero di serie del dispositivo** — sblocca solo le misurazioni provenienti da quello specifico strumento, su qualsiasi PC. Usa questa opzione quando una licenza deve seguire uno strumento anziché un computer.

## Richiedere una licenza

1. Fai clic sul badge della licenza (o su **Aggiungi licenza**) in alto a destra per aprire la **Gestione licenze**.
2. Copia il tuo **Host ID** con il pulsante di copia accanto ad esso. Per una licenza associata al dispositivo, prendi nota invece del numero di serie dello strumento.
3. Invia l'Host ID (o il numero di serie) a Rhopoint Instruments per ottenere il file di licenza.

> [!info] L'Host ID identifica questo specifico computer. Una licenza associata all'host sblocca l'acquisizione live solo sulla macchina per il cui Host ID è stata emessa.

## Importare una licenza

1. Apri la **Gestione licenze** e fai clic su **Importa licenza…**.
2. Seleziona il file di licenza che hai ricevuto (`.lic`, `.txt` o `.json`). Puoi selezionare più file contemporaneamente.
3. La licenza compare nell'elenco e il badge diventa verde — l'acquisizione live è ora sbloccata.

## Gestire le licenze

La Gestione licenze elenca ogni licenza installata con:

- **A cosa è associata** — *Questa macchina*, *Numero di serie dispositivo: …*, oppure *Qualsiasi macchina*.
- **Il suo stato e la scadenza** — ad esempio *Valida · Scade il 2027-01-31*.

Usa l'icona del **cestino** accanto a una licenza per rimuoverla.

> [!info] Una licenza associata a un numero di serie del dispositivo elabora solo le misurazioni il cui Device ID corrisponde. Gli altri strumenti collegati allo stesso PC vengono ignorati, a meno che non siano anch'essi dotati di licenza.

> [!warning] Se premi **Avvia** per l'acquisizione live senza una licenza valida, COM Agent mostra un messaggio e non si avvia. Importa una licenza oppure imposta la **Modalità** su **Demo**.

[Avanti: impostazioni e lingua](rhopoint-com-agent-settings-and-language.md)


---

# Settings and Language

## Le impostazioni vengono memorizzate

COM Agent salva automaticamente la configurazione — modalità, porta COM, velocità in baud, marcatore e numero di parti, cartella di uscita, formati di uscita e tutte le opzioni della tastiera. Al successivo avvio dell'applicazione, tutto sarà esattamente come l'hai lasciato, così potrai semplicemente premere **Avvia**.

Le impostazioni vengono memorizzate per ciascun utente Windows.

## Lingua

COM Agent è disponibile in tredici lingue: **Inglese**, **Ceco**, **Tedesco**, **Spagnolo**, **Francese**, **Italiano**, **Olandese**, **Polacco**, **Portoghese**, **Turco**, **Coreano**, **Giapponese** e **Cinese**. Scegli la tua lingua dal menu a discesa in alto a sinistra nella finestra, accanto al logo. L'interfaccia cambia immediatamente e la tua scelta viene memorizzata per la volta successiva.

![](../_images/com-agent-language-it.png)

[Avanti: avvio da riga di comando](rhopoint-com-agent-command-line-launch.md)


---

# Command-Line Launch

COM Agent può essere avviato con configurazione preimpostata dalla riga di comando e iniziare immediatamente l'acquisizione. Questo è
utile per l'automazione — avviandolo da un altro programma, da un collegamento sul desktop o da uno script di avvio
con una configurazione fissa.

La finestra dell'applicazione si apre comunque normalmente; i parametri si limitano a compilare le impostazioni per te e
l'acquisizione si avvia automaticamente.

```
RhopointComAgent.exe --mode live --port COM3 --output "C:\Data" --file-extension csv+txt
```

## Opzioni

I nomi delle opzioni corrispondono alle impostazioni della finestra. Qualsiasi opzione omessa mantiene il valore salvato.

| Opzione | Valori / esempio | Significato |
| --- | --- | --- |
| `--mode` | `live` o `demo` | Modalità di acquisizione. `demo` non richiede una porta COM. |
| `--port` | `COM3` | Porta seriale (richiesta per l'acquisizione live). |
| `--baud` | `19200` | Velocità in baud. |
| `--part-marker` | `^` | Marcatore che delimita un set di misurazioni completo. |
| `--part-count` | `4` | Numero di parti che compongono un set completo. |
| `--output` | `"C:\Data"` | Cartella di uscita per i file TXT/CSV. |
| `--file-extension` | `txt`, `csv`, `csv+txt`, `keyboard` | Formato/i di uscita; combinane più di uno con `+`. |
| `--csv-delimiter` | `comma`, `semicolon`, `tab` | Delimitatore di colonne CSV. |
| `--csv-decimal` | `dot`, `comma` | Separatore decimale per i numeri CSV. |
| `--csv-time-format` | `utc`, `local` | Formato della colonna *Timestamp* del CSV. |
| `--csv-encoding` | `utf8`, `utf8-bom` | Codifica del file CSV (con o senza byte-order mark). |
| `--keyboard-value` | `mean`, `min`, `max`, `stddev`, `measurements`, `raw` | Valore/i da digitare; combinane più di uno con `+`. |
| `--keyboard-separator` | `tab`, `enter`, `none` | Tasto premuto tra i valori digitati. |
| `--keyboard-suffix` | `tab`, `enter`, `none` | Tasto premuto dopo l'ultimo valore. |
| `--keyboard-decimal` | `.` o `,` | Separatore decimale per i valori digitati. |
| `--keyboard-delay` | `40` | Pausa in millisecondi dopo ogni pressione di tasto. |
| `--start` | *(nessun valore)* | Avvia con le impostazioni salvate quando non vengono forniti altri parametri. |

L'acquisizione si avvia automaticamente ogni volta che viene fornito un parametro qualsiasi (o `--start` da solo).

## Esempi

Acquisire da COM3 in file CSV e TXT:

```
RhopointComAgent.exe --port COM3 --output "C:\QA\Thickness" --file-extension csv+txt
```

Digitare la media e il minimo nell'applicazione con il focus, separati da tabulazione:

```
RhopointComAgent.exe --port COM3 --file-extension keyboard --keyboard-value mean+min --keyboard-separator tab
```

Avviare in modalità demo (nessuno strumento necessario):

```
RhopointComAgent.exe --mode demo --output "C:\Data" --file-extension txt
```

> [!info] La finestra si apre come al solito, così puoi comunque seguire l'attività in tempo reale e arrestare l'acquisizione in qualsiasi momento. Racchiudi tra virgolette i percorsi che contengono spazi.

> [!warning] L'acquisizione live richiede comunque una [licenza](rhopoint-com-agent-licensing.md) valida. Se la configurazione di avvio è incompleta o non valida (ad esempio, la cartella di uscita non esiste), COM Agent mostra lo stesso messaggio che mostrerebbe per un avvio manuale.

[Avanti: mantenere COM Agent aggiornato](rhopoint-com-agent-updating-com-agent.md)


---

# Updating COM Agent

COM Agent si mantiene aggiornato automaticamente.

## Aggiornamenti automatici

All'avvio, COM Agent verifica in background la presenza di una nuova versione. Se ne è disponibile una, una piccola notifica compare nell'angolo in alto a destra della finestra.

![](../_images/com-agent-update-notification-it.png)

- Fai clic su **Aggiorna ora** per scaricare e installare l'aggiornamento. COM Agent scarica la nuova versione, mostra una barra di avanzamento, quindi si riavvia con la nuova versione.
- Fai clic sulla **✕** per ignorare la notifica e continuare a lavorare con la versione corrente. Riceverai un nuovo promemoria al successivo avvio dell'applicazione.

> [!info] Gli aggiornamenti sono facoltativi e vengono applicati solo se lo scegli. COM Agent non interrompe mai una sessione di acquisizione per aggiornarsi.

## Verificare la versione

La versione corrente è mostrata nella barra del titolo della finestra (ad esempio *Rhopoint COM Agent 1.2.3*).