# 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 est une application Windows qui capture les données de mesure envoyées via une connexion série (COM) par les instruments Rhopoint — comme la jauge d'épaisseur de film FT3 — et les transforme en quelque chose d'utile : des fichiers structurés sur le disque, ou des valeurs saisies directement dans un autre programme.

Chaque fois que l'instrument imprime un résultat, COM Agent le lit, reconnaît le format des données et l'écrit dans le format de votre choix : un fichier **TXT** brut, un fichier **CSV** structuré, ou par **émulation clavier** afin que les valeurs apparaissent directement dans le champ qui a le focus (une cellule de tableur, une base de données qualité, un formulaire ERP, …).

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

## Ce que vous pouvez faire avec COM Agent

1. [Installer COM Agent](rhopoint-com-agent-install-com-agent.md) — télécharger, installer et démarrer l'application.
2. [Connecter un instrument](rhopoint-com-agent-connecting-an-instrument.md) — choisir le port COM et le débit en bauds et vérifier que les données arrivent.
3. [Formats de sortie](rhopoint-com-agent-output-formats.md) — écrire chaque mesure dans des fichiers TXT et/ou CSV.
4. [Émulation clavier](rhopoint-com-agent-keyboard-emulation.md) — saisir les valeurs mesurées directement dans un autre programme, avec des séparateurs configurables.
5. [Capturer des mesures](rhopoint-com-agent-capturing-measurements.md) — démarrer et arrêter la capture et suivre l'activité en direct.
6. [Mode démo](rhopoint-com-agent-demo-mode.md) — essayer l'application sans instrument connecté.
7. [Licences](rhopoint-com-agent-licensing.md) — déverrouillez la capture en direct en ajoutant une licence ; le mode démo fonctionne toujours sans.
8. [Paramètres et langue](rhopoint-com-agent-settings-and-language.md) — votre configuration est mémorisée, et l'interface est disponible en treize langues.
9. [Lancement en ligne de commande](rhopoint-com-agent-command-line-launch.md) — démarrer préconfiguré et capturer automatiquement (pour l'automatisation).
10. [Mettre à jour COM Agent](rhopoint-com-agent-updating-com-agent.md) — garder l'application à jour.

## Instruments pris en charge

COM Agent lit la sortie série des instruments Rhopoint, notamment :

- **FT3** Jauge d'épaisseur de film

> [!info] COM Agent fournit actuellement une analyse structurée complète (CSV) pour le format d'épaisseur FT3 *« print all samples »*. Les autres instruments sont capturés en texte brut ; l'analyse structurée est ajoutée au fur et à mesure que des données d'exemple sont disponibles. La sortie clavier et TXT fonctionne pour chaque instrument.

> [!info] COM Agent fonctionne uniquement sous Windows. Il est distribué en tant qu'application autonome — aucune installation .NET distincte n'est requise — et se maintient à jour automatiquement.


---

# Installer COM Agent

Rhopoint COM Agent est une application Windows légère. Le programme d'installation met en place tout le nécessaire et garde l'application à jour automatiquement.

## Téléchargement

Téléchargez la dernière version de COM Agent sur [download.rhopointservice.net/com-agent](https://download.rhopointservice.net/com-agent).

## Installation

1. Téléchargez le programme d'installation de COM Agent via le lien ci-dessus.
2. Double-cliquez sur le programme d'installation et suivez les instructions à l'écran.
3. Lancez **Rhopoint COM Agent** depuis le menu Démarrer.

> [!info] COM Agent est autonome — aucune installation distincte du runtime .NET n'est nécessaire. Le programme d'installation vérifie également les mises à jour et les installe automatiquement en arrière-plan, afin que vous utilisiez toujours la dernière version.

## Configuration requise

- **Système d'exploitation :** Windows 10 (build 19041 / 20H1) ou plus récent
- **Processeur :** x64 ou ARM64
- **Un port série (COM) libre** — intégré ou via un adaptateur USB-série — pour connecter votre instrument. Certains instruments nécessitent un câble spécial (voir l'[aperçu](rhopoint-com-agent.md)).

## Premier démarrage

Au démarrage de COM Agent, la fenêtre principale est divisée en deux zones :

- À **gauche**, la configuration : paramètres de connexion et options de sortie.
- À **droite**, l'activité en direct : statut, nombre de mesures reçues, dernière mesure et journal d'activité.

Le bouton **Démarrer / Arrêter** se trouve en haut à droite, au-dessus du compteur de mesures, et reste toujours visible.

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

[Suite : connecter votre instrument](rhopoint-com-agent-connecting-an-instrument.md)


---

# Connecter un instrument

En mode **Live** (en direct), COM Agent lit les données de mesure directement depuis un instrument via une connexion série (COM).

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

## 1. Brancher le matériel

1. Connectez l'instrument au PC à l'aide de son câble série ou d'un adaptateur USB-série. Certains instruments (CBT1.2, NovoHaze TX) nécessitent un câble spécial — voir l'[aperçu](rhopoint-com-agent.md).
2. Mettez l'instrument sous tension.

## 2. Choisir les paramètres de connexion

Dans la section **Connexion** à gauche :

| Paramètre | Description |
| --- | --- |
| **Mode** | Réglez sur **Live** pour lire depuis un port série. (Utilisez **Démo** pour essayer l'application sans matériel — voir [Mode démo](rhopoint-com-agent-demo-mode.md).) |
| **Port COM** | Sélectionnez le port auquel votre instrument est connecté. Cliquez sur le bouton **Actualiser** pour rechercher à nouveau les ports après avoir branché un adaptateur. |
| **Débit en bauds** | La vitesse série. La valeur par défaut pour les instruments Rhopoint est **19200**. |
| **Marqueur de partie** | Le caractère que l'instrument imprime pour marquer chaque partie d'un ensemble de données complet. Par défaut **^**. |
| **Nombre de parties** | Combien de marqueurs de partie composent un ensemble de données complet. Par défaut **4**. |

> [!info] Le **Marqueur de partie** et le **Nombre de parties** indiquent à COM Agent quand une mesure est complète. Un ensemble de données n'est écrit qu'une fois le nombre attendu de marqueurs reçu et la ligne terminée — cela évite d'enregistrer des mesures partiellement reçues. Les valeurs par défaut correspondent aux instruments Rhopoint ; ne les modifiez que sur conseil du support Rhopoint.

## 3. Choisir ce qu'il advient des données

Décidez comment chaque mesure doit être enregistrée ou transmise :

- Écrire des fichiers — voir [Formats de sortie](rhopoint-com-agent-output-formats.md).
- Saisir des valeurs dans un autre programme — voir [Émulation clavier](rhopoint-com-agent-keyboard-emulation.md).

Vous pouvez les combiner (par exemple écrire un fichier CSV *et* saisir la moyenne dans un tableur).

## 4. Démarrer la capture

Appuyez sur **Démarrer** (en haut à droite) et effectuez une mesure sur l'instrument. Le journal d'activité à droite confirme que les données arrivent. Voir [Capturer des mesures](rhopoint-com-agent-capturing-measurements.md) pour les détails.

> [!warning] Si le port COM sélectionné ne peut pas être ouvert (par exemple parce qu'un autre programme l'utilise déjà), COM Agent affiche une erreur. Fermez l'autre programme ou choisissez un autre port, puis réessayez.

[Suite : choisir votre format de sortie](rhopoint-com-agent-output-formats.md)


---

# Formats de sortie

COM Agent peut écrire chaque mesure terminée dans un fichier. Choisissez un **Dossier de sortie** et cochez un ou plusieurs **Formats de sortie**. Les formats peuvent être combinés librement.

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

## Dossier de sortie

Cliquez sur **Parcourir…** à côté de *Dossier de sortie* et choisissez où les fichiers doivent être écrits. Chaque mesure crée un nouveau fichier avec un nom unique horodaté, de sorte que rien n'est jamais écrasé :

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

Le nom contient l'horodatage UTC, un compteur et un identifiant unique.

## Formats

| Format | Ce qu'il produit |
| --- | --- |
| **Fichier texte (.txt)** | Les données brutes exactement telles que reçues de l'instrument, sans traitement. Fonctionne pour chaque instrument. |
| **Fichier CSV (.csv)** | Un fichier tableur structuré avec des colonnes nommées et des unités métriques. Nécessite un format de données reconnu (actuellement le format d'épaisseur FT3 *« print all samples »*). |
| **Émulation clavier** | Saisit les valeurs dans un autre programme au lieu d'écrire un fichier — voir [Émulation clavier](rhopoint-com-agent-keyboard-emulation.md). |

> [!info] Vous pouvez activer plusieurs formats à la fois. Par exemple, cochez **Texte** et **CSV** pour conserver une archive brute à côté d'un fichier structuré, ou **CSV** et **Clavier** pour archiver les données *et* saisir une valeur dans votre système qualité.

## Options d'export CSV

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

Lorsque **CSV** est activé, un panneau **Options CSV** apparaît avec quatre réglages qui contrôlent la manière dont le fichier est écrit. COM Agent choisit des valeurs par défaut judicieuses en fonction de votre langue et de votre région, de sorte que vous pouvez les laisser telles quelles dans la plupart des cas.

| Option | Choix | Effet |
| --- | --- | --- |
| **Délimiteur** | Virgule "," · Point-virgule ";" · Tabulation "→" | Le caractère placé entre les colonnes. |
| **Format d'heure** | ISO 8601, UTC · ISO 8601, local | Format de la colonne *Timestamp* : UTC (p. ex. `2025-10-11T11:03:56Z`) ou heure locale avec décalage (p. ex. `2025-10-11T13:03:56+02:00`). |
| **Séparateur décimal** | Point "." · Virgule "," | Le signe décimal utilisé pour les valeurs numériques. Les dates et les identifiants ne sont jamais modifiés. |
| **Encodage du fichier** | UTF-8 · UTF-8 avec BOM | Si une marque d'ordre des octets est écrite au début du fichier. Une BOM aide certains tableurs (par exemple Excel) à détecter l'UTF-8 et à afficher correctement les en-têtes en µm. |

> [!tip] **Délimiteur** et **Séparateur décimal** adoptent par défaut la convention de votre région : les régions qui séparent les valeurs d'une liste par un point-virgule (la majeure partie de l'Europe) commencent par **point-virgule + virgule décimale**, les autres (par exemple l'anglais) par **virgule + point décimal**. Cela permet d'ouvrir proprement le fichier d'un double-clic dans votre tableur local. Une fois que vous modifiez un réglage, votre choix est mémorisé.

## Structure CSV

Pour le format d'épaisseur FT3, COM Agent produit une ligne par échantillon individuel, accompagnée des statistiques récapitulatives et des métadonnées de l'instrument. Les unités sont indiquées en micromètres (µm).

| Colonne | Exemple | Signification |
| --- | --- | --- |
| Index | 1 | Numéro de l'échantillon dans l'ensemble |
| Measurement (µm) | 1090.9 | La valeur de l'échantillon individuel |
| Min (µm) | 1088.4 | Minimum de l'ensemble |
| Max (µm) | 1090.9 | Maximum de l'ensemble |
| Mean (µm) | 1089.4 | Moyenne de l'ensemble |
| StdDev (µm) | 0.990 | Écart-type de l'ensemble |
| Template | 10 | Le format de données de l'instrument |
| Device_ID | FTG38041012H | Numéro de série / ID de l'instrument |
| Test_Date | 2025-10-07 | Date du test (ISO 8601) |
| Calibration_Date | 2025-10-11 | Date du dernier étalonnage |
| Test_Time | 11:03:56 | Heure du test |
| Sample_Count | 5 | Nombre d'échantillons dans l'ensemble |
| Timestamp | 2025-10-11T11:03:56Z | Quand COM Agent a reçu l'ensemble, dans le *Format d'heure* choisi |

> [!info] Les valeurs propres à l'instrument *Test_Date* / *Test_Time* proviennent de l'horloge de l'appareil et n'ont pas de fuseau horaire. La colonne **Timestamp** correspond au moment où votre PC a reçu l'ensemble, elle reflète donc l'option *Format d'heure* (UTC ou local).

> [!info] Si COM Agent reçoit des données qu'il ne reconnaît pas comme un format structuré, le fichier CSV est ignoré pour cette mesure et une note apparaît dans le journal d'activité. La sortie **TXT** brute (si activée) est toujours écrite, quel que soit le format.

[Suite : saisir des valeurs dans un autre programme](rhopoint-com-agent-keyboard-emulation.md)


---

# Émulation clavier

L'émulation clavier permet à COM Agent de **saisir les valeurs mesurées directement dans un autre programme** — exactement comme si vous les aviez tapées au clavier. C'est idéal pour saisir des relevés dans un tableur, une base de données qualité, un écran ERP ou toute autre application, sans copier-coller.

Lorsqu'une mesure se termine, COM Agent saisit la ou les valeurs sélectionnées dans **la fenêtre et le champ qui ont actuellement le focus clavier**.

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

## Activer

Cochez **Émulation clavier** sous [Formats de sortie](rhopoint-com-agent-output-formats.md). Les **Options clavier** apparaissent en dessous.

## Valeurs

Cochez une ou plusieurs valeurs à saisir. **Moyenne** est sélectionnée par défaut.

| Valeur | Saisit |
| --- | --- |
| **Moyenne** | La moyenne de l'ensemble de mesures |
| **Minimum** | Le plus petit relevé |
| **Maximum** | Le plus grand relevé |
| **Écart-type** | L'écart-type |
| **Mesures** | Chaque relevé individuel |
| **Données brutes** | Les données brutes complètes telles que reçues de l'instrument |

Lorsque plusieurs valeurs sont sélectionnées, elles sont saisies dans l'ordre affiché, chacune séparée par le **Séparateur** choisi.

## Séparateur et suffixe

| Option | Rôle |
| --- | --- |
| **Séparateur** | La touche pressée *entre* les valeurs (et entre les mesures individuelles). Choisissez **Tabulation**, **Entrée** ou **Aucun**. |
| **Suffixe** | La touche pressée *après la dernière* valeur. Choisissez **Tabulation**, **Entrée** ou **Aucun**. |

> [!info] Utilisez **Tabulation** pour passer à la cellule ou au champ suivant, ou **Entrée** pour valider une saisie / passer à la ligne suivante. Par exemple, *Séparateur = Tabulation* et *Suffixe = Entrée* remplit une ligne de cellules puis passe à la ligne suivante — parfait pour les tableurs.

## Séparateur décimal

Réglez le **Séparateur décimal** pour qu'il corresponde à l'application cible — généralement un point (`.`) pour les paramètres régionaux anglais ou une virgule (`,`) pour les paramètres régionaux allemands/français.

## Délai clavier

Le **Délai clavier** définit une courte pause après chaque frappe émulée.

> [!warning] Si les valeurs saisies arrivent **déformées ou avec des caractères répétés**, augmentez le délai clavier. Certaines applications et certains PC acceptent les frappes injectées plus lentement que d'autres. Commencez par la valeur par défaut et augmentez-la (par exemple à 100 ms) jusqu'à ce que les valeurs s'affichent correctement. Le paramètre est enregistré par PC.

## Exemple

Avec **Moyenne** et **Minimum** sélectionnés, *Séparateur = Tabulation*, *Suffixe = Entrée*, la saisie dans un tableur produit :

```
1089.4 ⇥ 1088.4 ⏎
```

La moyenne arrive dans la première cellule, le minimum dans la suivante, et le curseur passe à la ligne suivante — prêt pour la prochaine mesure.

> [!info] L'émulation clavier n'écrit pas de fichier. Pour conserver un enregistrement *et* saisir des valeurs, cochez aussi **Texte** ou **CSV** sous [Formats de sortie](rhopoint-com-agent-output-formats.md).

[Suite : capturer des mesures](rhopoint-com-agent-capturing-measurements.md)


---

# Capturer des mesures

Une fois la [connexion](rhopoint-com-agent-connecting-an-instrument.md) configurée et votre [sortie](rhopoint-com-agent-output-formats.md) choisie, vous êtes prêt à capturer.

## Démarrer et arrêter

Appuyez sur **Démarrer** (en haut à droite). COM Agent ouvre le port série et commence à écouter. Le bouton devient **Arrêter** ; appuyez dessus pour mettre fin à la session et libérer le port.

Pendant la capture, la configuration à gauche est **verrouillée** afin de ne pas pouvoir être modifiée en cours de session.

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

## Le panneau en direct

La partie droite montre ce qui se passe en temps réel :

| Élément | Signification |
| --- | --- |
| **Badge de statut** | **Inactif** avant le démarrage, **À l'écoute** pendant la capture, **Erreur** en cas d'échec de connexion. |
| **Ensembles reçus** | Un compteur cumulé des mesures complètes capturées dans cette session. |
| **Dernière mesure** | La moyenne, le minimum, le maximum et l'écart-type de la mesure la plus récente (pour les formats reconnus). |
| **Journal d'activité** | Une liste défilante d'événements : données reçues, fichiers écrits (avec leur chemin complet), sortie clavier et avertissements éventuels. Utilisez **Effacer** pour le vider. |

## Effectuer une mesure

1. Appuyez sur **Démarrer** dans COM Agent.
2. Déclenchez une mesure sur l'instrument comme vous le feriez normalement.
3. Le journal d'activité affiche *« Receiving data… »* suivi du chemin de chaque fichier écrit, ou une entrée *« [Keyboard] »* si l'émulation clavier est activée.
4. Le compteur **Ensembles reçus** augmente et **Dernière mesure** se met à jour.

> [!info] Chaque mesure terminée est traitée indépendamment — vous pouvez en effectuer autant que vous le souhaitez en une seule session. Inutile d'arrêter et de redémarrer entre les mesures.

> [!warning] Si le statut passe à **Erreur** (par exemple, le câble est débranché ou l'instrument est éteint), arrêtez la session, vérifiez la connexion et redémarrez.

[Suite : essayer sans instrument](rhopoint-com-agent-demo-mode.md)


---

# Mode démo

Le mode démo vous permet d'essayer COM Agent **sans instrument connecté**. Au lieu de lire depuis un port série, COM Agent génère à la demande une mesure de démonstration réaliste — utile pour apprendre l'application, tester votre dossier de sortie ou votre configuration clavier, ou faire une démonstration.

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

## Utiliser le mode démo

1. Réglez **Mode** sur **Démo** dans la section Connexion. Les paramètres de port COM et de débit en bauds disparaissent — ils ne sont pas nécessaires.
2. Choisissez vos [formats de sortie](rhopoint-com-agent-output-formats.md) et, si vous le souhaitez, les [options clavier](rhopoint-com-agent-keyboard-emulation.md), exactement comme en mode Live.
3. Appuyez sur **Démarrer**.
4. Appuyez n'importe où sur la touche **Alt droite** — même dans une autre application — pour injecter une mesure de démonstration.

Chaque appui sur Alt droite produit une mesure de démonstration complète, qui est ensuite écrite et/ou saisie selon vos paramètres de sortie, comme un relevé réel.

> [!info] Le mode démo est le moyen le plus rapide de vérifier votre configuration d'**émulation clavier** : réglez Mode sur Démo, activez la sortie clavier, cliquez dans un tableur, appuyez sur Démarrer et tapez Alt droite — les valeurs apparaissent dans les cellules.

> [!info] Les données de démonstration utilisent le format d'épaisseur FT3 ; elles fonctionnent donc avec la sortie CSV et toutes les valeurs clavier (Moyenne, Min, Max, Écart-type, Mesures).

[Suite : licences](rhopoint-com-agent-licensing.md)


---

# Licences

COM Agent a besoin d'une licence valide pour **capturer des mesures en direct** depuis un instrument. Le [mode démo](rhopoint-com-agent-demo-mode.md) fonctionne toujours sans licence, vous pouvez donc explorer l'application et tester votre configuration de sortie et de clavier à tout moment.

L'état de votre licence est toujours visible en haut à droite de la fenêtre :

- Un badge vert **Licences actives : N** indique que la capture en direct est déverrouillée.
- Un badge rouge **Aucune licence active** signifie que seul le mode démo est disponible.

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

## Comment fonctionnent les licences

Une licence COM Agent peut être liée de deux manières :

- **À cet ordinateur (ID hôte)** — déverrouille la capture en direct sur ce PC, pour tout instrument connecté.
- **À un numéro de série d'appareil** — déverrouille uniquement les mesures provenant de cet instrument précis, sur n'importe quel PC. Utilisez ceci lorsqu'une licence doit suivre un instrument plutôt qu'un ordinateur.

## Demander une licence

1. Cliquez sur le badge de licence (ou sur **Ajouter une licence**) en haut à droite pour ouvrir le **Gestionnaire de licences**.
2. Copiez votre **ID hôte** avec le bouton de copie situé à côté. Pour une licence liée à un appareil, notez plutôt le numéro de série de votre instrument.
3. Envoyez l'ID hôte (ou le numéro de série) à Rhopoint Instruments pour obtenir votre fichier de licence.

> [!info] L'ID hôte identifie cet ordinateur précis. Une licence liée à l'hôte ne déverrouille la capture en direct que sur la machine pour laquelle son ID hôte a été émis.

## Importer une licence

1. Ouvrez le **Gestionnaire de licences** et cliquez sur **Importer une licence…**.
2. Sélectionnez le fichier de licence que vous avez reçu (`.lic`, `.txt` ou `.json`). Vous pouvez sélectionner plusieurs fichiers à la fois.
3. La licence apparaît dans la liste et le badge devient vert — la capture en direct est désormais déverrouillée.

## Gérer les licences

Le Gestionnaire de licences répertorie chaque licence installée avec :

- **Ce à quoi elle est liée** — *Cette machine*, *Numéro de série : …* ou *Toute machine*.
- **Son état et son expiration** — par exemple *Valide · Expire le 2027-01-31*.

Utilisez l'icône **corbeille** à côté d'une licence pour la supprimer.

> [!info] Une licence liée à un numéro de série d'appareil ne traite que les mesures dont l'ID d'appareil correspond. Les autres instruments connectés au même PC sont ignorés sauf s'ils sont également sous licence.

> [!warning] Si vous appuyez sur **Démarrer** pour la capture en direct sans licence valide, COM Agent affiche un message et ne démarre pas. Importez une licence, ou réglez le **Mode** sur **Démo**.

[Suite : paramètres et langue](rhopoint-com-agent-settings-and-language.md)


---

# Paramètres et langue

## Vos paramètres sont mémorisés

COM Agent enregistre automatiquement votre configuration — mode, port COM, débit en bauds, marqueur et nombre de parties, dossier de sortie, formats de sortie et toutes les options clavier. Au prochain démarrage de l'application, tout est exactement comme vous l'avez laissé, de sorte que vous pouvez simplement appuyer sur **Démarrer**.

Les paramètres sont enregistrés par utilisateur Windows.

## Langue

COM Agent est disponible en treize langues : **anglais**, **tchèque**, **allemand**, **espagnol**, **français**, **italien**, **néerlandais**, **polonais**, **portugais**, **turc**, **coréen**, **japonais** et **chinois**. Choisissez votre langue dans la liste déroulante en haut à gauche de la fenêtre, à côté du logo. L'interface change immédiatement, et votre choix est mémorisé pour la prochaine fois.

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

[Suite : lancement en ligne de commande](rhopoint-com-agent-command-line-launch.md)


---

# Lancement en ligne de commande

COM Agent peut être démarré préconfiguré depuis la ligne de commande et commencer immédiatement la
capture. C'est pratique pour l'automatisation — le lancer depuis un autre programme, un raccourci ou
un script de démarrage avec une configuration fixe.

La fenêtre de l'application s'ouvre toujours normalement ; les paramètres remplissent simplement les
réglages à votre place, et la capture démarre automatiquement.

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

## Options

Les noms d'options correspondent aux réglages de la fenêtre. Toute option omise conserve sa valeur
enregistrée.

| Option | Valeurs / exemple | Signification |
| --- | --- | --- |
| `--mode` | `live` ou `demo` | Mode de capture. `demo` ne nécessite pas de port COM. |
| `--port` | `COM3` | Port série (requis pour la capture en direct). |
| `--baud` | `19200` | Débit en bauds. |
| `--part-marker` | `^` | Marqueur délimitant un ensemble de mesures complet. |
| `--part-count` | `4` | Nombre de parties composant un ensemble complet. |
| `--output` | `"C:\Data"` | Dossier de sortie pour les fichiers TXT/CSV. |
| `--file-extension` | `txt`, `csv`, `csv+txt`, `keyboard` | Format(s) de sortie ; combinez-en plusieurs avec `+`. |
| `--csv-delimiter` | `comma`, `semicolon`, `tab` | Délimiteur de colonnes CSV. |
| `--csv-decimal` | `dot`, `comma` | Séparateur décimal des nombres CSV. |
| `--csv-time-format` | `utc`, `local` | Format de la colonne *Timestamp* du CSV. |
| `--csv-encoding` | `utf8`, `utf8-bom` | Encodage du fichier CSV (avec ou sans marque d'ordre des octets). |
| `--keyboard-value` | `mean`, `min`, `max`, `stddev`, `measurements`, `raw` | Valeur(s) à saisir ; combinez-en plusieurs avec `+`. |
| `--keyboard-separator` | `tab`, `enter`, `none` | Touche entre les valeurs saisies. |
| `--keyboard-suffix` | `tab`, `enter`, `none` | Touche après la dernière valeur. |
| `--keyboard-decimal` | `.` ou `,` | Séparateur décimal des valeurs saisies. |
| `--keyboard-delay` | `40` | Pause en millisecondes après chaque frappe. |
| `--start` | *(sans valeur)* | Démarrer avec les réglages enregistrés lorsqu'aucun autre paramètre n'est fourni. |

La capture démarre automatiquement dès qu'un paramètre est fourni (ou `--start` seul).

## Exemples

Capturer depuis COM3 vers des fichiers CSV et TXT :

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

Saisir la moyenne et le minimum dans l'application active, séparés par des tabulations :

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

Démarrer en mode démo (aucun instrument nécessaire) :

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

> [!info] La fenêtre s'ouvre comme d'habitude ; vous pouvez donc suivre l'activité en direct et arrêter la capture à tout moment. Mettez entre guillemets les chemins contenant des espaces.

> [!warning] La capture en direct nécessite toujours une [licence](rhopoint-com-agent-licensing.md) valide. Si la configuration de lancement est incomplète ou invalide (par exemple un dossier de sortie inexistant), COM Agent affiche le même message que pour un démarrage manuel.

[Suite : garder COM Agent à jour](rhopoint-com-agent-updating-com-agent.md)


---

# Mettre à jour COM Agent

COM Agent se maintient à jour automatiquement.

## Mises à jour automatiques

Au démarrage, COM Agent vérifie en arrière-plan s'il existe une nouvelle version. Si c'est le cas, une petite notification apparaît dans le coin supérieur droit de la fenêtre.

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

- Cliquez sur **Mettre à jour** pour télécharger et installer la mise à jour. COM Agent télécharge la nouvelle version, affiche une barre de progression, puis se redémarre sur la nouvelle version.
- Cliquez sur le **✕** pour masquer la notification et continuer à travailler sur la version actuelle. Vous serez averti à nouveau au prochain démarrage.

> [!info] Les mises à jour sont facultatives et ne sont appliquées que si vous le décidez. COM Agent n'interrompt jamais une session de capture pour effectuer une mise à jour.

## Vérifier votre version

La version actuelle est indiquée dans la barre de titre de la fenêtre (par exemple *Rhopoint COM Agent 1.2.3*).