# 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 ist eine Windows-Anwendung, die Messdaten erfasst, die Rhopoint-Instrumente — etwa das FT3-Schichtdickenmessgerät — über eine serielle (COM-)Verbindung senden, und sie in etwas Nutzbares verwandelt: strukturierte Dateien auf der Festplatte oder Werte, die direkt in ein anderes Programm getippt werden. Sobald das Instrument ein Ergebnis ausgibt, liest COM Agent es ein, erkennt das Datenformat und schreibt es im gewählten Format heraus: als rohe **TXT**-Datei, als strukturierte **CSV**-Datei oder durch **Tastatur-Emulation**, sodass die Werte direkt im aktuell fokussierten Feld erscheinen (einer Tabellenzelle, einer QA-Datenbank, einem ERP-Formular …). ![](../_images/com-agent-main-screen-de.png) ## Was du mit COM Agent tun kannst 1. [COM Agent installieren](rhopoint-com-agent-install-com-agent.md) — Anwendung herunterladen, installieren und starten. 2. [Instrument verbinden](rhopoint-com-agent-connecting-an-instrument.md) — COM-Port und Baudrate wählen und prüfen, dass Daten ankommen. 3. [Ausgabeformate](rhopoint-com-agent-output-formats.md) — jede Messung in TXT- und/oder CSV-Dateien schreiben. 4. [Tastatur-Emulation](rhopoint-com-agent-keyboard-emulation.md) — gemessene Werte direkt in ein anderes Programm tippen, mit konfigurierbaren Trennzeichen. 5. [Messungen erfassen](rhopoint-com-agent-capturing-measurements.md) — Erfassung starten und stoppen und die Live-Aktivität verfolgen. 6. [Demo-Modus](rhopoint-com-agent-demo-mode.md) — die Anwendung ohne angeschlossenes Instrument ausprobieren. 7. [Lizenzierung](rhopoint-com-agent-licensing.md) — die Live-Erfassung durch Hinzufügen einer Lizenz freischalten; der Demo-Modus funktioniert immer ohne. 8. [Einstellungen und Sprache](rhopoint-com-agent-settings-and-language.md) — deine Konfiguration wird gespeichert, und die Oberfläche ist in dreizehn Sprachen verfügbar. 9. [Start über die Befehlszeile](rhopoint-com-agent-command-line-launch.md) — vorkonfiguriert starten und automatisch erfassen (für die Automatisierung). 10. [COM Agent aktualisieren](rhopoint-com-agent-updating-com-agent.md) — die Anwendung aktuell halten. ## Unterstützte Instrumente COM Agent liest die serielle Ausgabe von Rhopoint-Instrumenten, darunter: - **FT3** Schichtdickenmessgerät > [!info] COM Agent bietet derzeit vollständiges strukturiertes (CSV-)Parsing für das FT3-Schichtdickenformat *„print all samples"*. Andere Instrumente werden als Rohtext erfasst; strukturiertes Parsing wird ergänzt, sobald Beispieldaten verfügbar sind. Tastatur- und TXT-Ausgabe funktionieren für jedes Instrument. > [!info] COM Agent läuft nur unter Windows. Es wird als eigenständige Anwendung ausgeliefert — eine separate .NET-Installation ist nicht erforderlich — und hält sich automatisch aktuell. --- # COM Agent installieren Rhopoint COM Agent ist eine schlanke Windows-Anwendung. Das Installationsprogramm richtet alles Nötige ein und hält die Anwendung automatisch aktuell. ## Download Lade die aktuelle Version von COM Agent unter [download.rhopointservice.net/com-agent](https://download.rhopointservice.net/com-agent) herunter. ## Installation 1. Lade das COM-Agent-Installationsprogramm über den Link oben herunter. 2. Doppelklicke auf das Installationsprogramm und folge den Anweisungen am Bildschirm. 3. Starte **Rhopoint COM Agent** über das Startmenü. > [!info] COM Agent ist eigenständig — es ist keine separate .NET-Laufzeitinstallation erforderlich. Das Installationsprogramm prüft außerdem im Hintergrund automatisch auf Updates und installiert sie, sodass du stets die aktuelle Version nutzt. ## Systemvoraussetzungen - **Betriebssystem:** Windows 10 (Build 19041 / 20H1) oder neuer - **CPU:** x64 oder ARM64 - **Ein freier serieller (COM-)Port** — entweder ein integrierter Port oder ein USB-zu-Seriell-Adapter — um dein Instrument anzuschließen. Manche Instrumente benötigen ein spezielles Kabel (siehe [Übersicht](rhopoint-com-agent.md)). ## Erster Start Wenn COM Agent startet, ist das Hauptfenster in zwei Bereiche geteilt: - **Links** die Konfiguration: Verbindungseinstellungen und Ausgabeoptionen. - **Rechts** die Live-Aktivität: Status, Anzahl der empfangenen Messungen, die letzte Messung und ein Aktivitätsprotokoll. Die Schaltfläche **Start / Stopp** befindet sich oben rechts, über dem Messungszähler, und ist immer sichtbar. ![](../_images/com-agent-main-screen-de.png) [Weiter: Instrument verbinden](rhopoint-com-agent-connecting-an-instrument.md) --- # Instrument verbinden Im **Live**-Modus liest COM Agent Messdaten direkt von einem Instrument über eine serielle (COM-)Verbindung. ![](../_images/com-agent-connection-de.png) ## 1. Hardware anschließen 1. Verbinde das Instrument über sein serielles Kabel oder einen USB-zu-Seriell-Adapter mit dem PC. Manche Instrumente (CBT1.2, NovoHaze TX) benötigen ein spezielles Kabel — siehe [Übersicht](rhopoint-com-agent.md). 2. Schalte das Instrument ein. ## 2. Verbindungseinstellungen wählen Im Bereich **Verbindung** links: | Einstellung | Beschreibung | | --- | --- | | **Modus** | Auf **Live** setzen, um von einem seriellen Port zu lesen. (Mit **Demo** lässt sich die App ohne Hardware ausprobieren — siehe [Demo-Modus](rhopoint-com-agent-demo-mode.md).) | | **COM-Port** | Wähle den Port, an dem dein Instrument angeschlossen ist. Klicke auf die **Aktualisieren**-Schaltfläche, um nach dem Einstecken eines Adapters erneut nach Ports zu suchen. | | **Baudrate** | Die serielle Geschwindigkeit. Der Standard für Rhopoint-Instrumente ist **19200**. | | **Teil-Markierung** | Das Zeichen, das das Instrument zur Kennzeichnung jedes Teils eines vollständigen Datensatzes ausgibt. Standard ist **^**. | | **Teil-Anzahl** | Wie viele Teil-Markierungen einen vollständigen Datensatz ergeben. Standard ist **4**. | > [!info] **Teil-Markierung** und **Teil-Anzahl** teilen COM Agent mit, wann eine Messung vollständig ist. Ein Datensatz wird erst geschrieben, wenn die erwartete Anzahl an Markierungen empfangen wurde und die Zeile endet — so werden halb empfangene Messungen nicht gespeichert. Die Standardwerte passen zu Rhopoint-Instrumenten; ändere sie nur auf Anweisung des Rhopoint-Supports. ## 3. Wählen, was mit den Daten geschehen soll Lege fest, wie jede Messung gespeichert oder weitergegeben werden soll: - Dateien schreiben — siehe [Ausgabeformate](rhopoint-com-agent-output-formats.md). - Werte in ein anderes Programm tippen — siehe [Tastatur-Emulation](rhopoint-com-agent-keyboard-emulation.md). Du kannst diese kombinieren (zum Beispiel eine CSV-Datei schreiben *und* den Mittelwert in eine Tabelle tippen). ## 4. Erfassung starten Drücke **Start** (oben rechts) und führe eine Messung am Instrument durch. Das Aktivitätsprotokoll rechts bestätigt, dass Daten ankommen. Siehe [Messungen erfassen](rhopoint-com-agent-capturing-measurements.md) für Details. > [!warning] Lässt sich der gewählte COM-Port nicht öffnen (zum Beispiel, weil ihn bereits ein anderes Programm verwendet), zeigt COM Agent einen Fehler. Schließe das andere Programm oder wähle einen anderen Port und versuche es erneut. [Weiter: Ausgabeformat wählen](rhopoint-com-agent-output-formats.md) --- # Ausgabeformate COM Agent kann jede abgeschlossene Messung in eine Datei schreiben. Wähle einen **Ausgabeordner** und aktiviere ein oder mehrere **Ausgabeformate**. Die Formate lassen sich beliebig kombinieren. ![](../_images/com-agent-output-formats-de.png) ## Ausgabeordner Klicke neben *Ausgabeordner* auf **Durchsuchen…** und wähle, wohin die Dateien geschrieben werden sollen. Jede Messung erzeugt eine neue Datei mit einem eindeutigen, mit Zeitstempel versehenen Namen, sodass nie etwas überschrieben wird: ``` 2025-10-11T11-03-56Z-00007-3f9c1a2b-….csv ``` Der Name enthält den UTC-Zeitstempel, einen laufenden Zähler und eine eindeutige Kennung. ## Formate | Format | Was es erzeugt | | --- | --- | | **Textdatei (.txt)** | Die Rohdaten genau wie vom Instrument empfangen, ohne Verarbeitung. Funktioniert für jedes Instrument. | | **CSV-Datei (.csv)** | Eine strukturierte Tabellendatei mit benannten Spalten und metrischen Einheiten. Erfordert ein erkanntes Datenformat (derzeit das FT3-Schichtdickenformat *„print all samples"*). | | **Tastatur-Emulation** | Tippt die Werte in ein anderes Programm, statt eine Datei zu schreiben — siehe [Tastatur-Emulation](rhopoint-com-agent-keyboard-emulation.md). | > [!info] Du kannst mehrere Formate gleichzeitig nutzen. Aktiviere zum Beispiel **Text** und **CSV**, um ein Roharchiv neben einer strukturierten Datei zu behalten, oder **CSV** und **Tastatur**, um die Daten abzulegen *und* einen Wert in dein QA-System zu tippen. ## CSV-Exportoptionen ![](../_images/com-agent-csv-options-de.png) Wenn **CSV** aktiviert ist, erscheint ein Bereich **CSV-Optionen** mit vier Einstellungen, die steuern, wie die Datei geschrieben wird. COM Agent wählt sinnvolle Standardwerte anhand deiner Sprache und Region, sodass du sie in den meisten Fällen unverändert lassen kannst. | Option | Auswahl | Wirkung | | --- | --- | --- | | **Trennzeichen** | Komma "," · Semikolon ";" · Tabulator "→" | Das Zeichen zwischen den Spalten. | | **Zeitformat** | ISO 8601, UTC · ISO 8601, lokal | Format der Spalte *Timestamp*: UTC (z. B. `2025-10-11T11:03:56Z`) oder lokale Zeit mit Offset (z. B. `2025-10-11T13:03:56+02:00`). | | **Dezimaltrennzeichen** | Punkt "." · Komma "," | Das Dezimalzeichen für numerische Werte. Datumsangaben und Kennungen werden nie verändert. | | **Dateikodierung** | UTF-8 · UTF-8 mit BOM | Ob am Dateianfang eine Byte-Order-Mark geschrieben wird. Eine BOM hilft einigen Tabellenprogrammen (zum Beispiel Excel), UTF-8 zu erkennen und die µm-Überschriften korrekt anzuzeigen. | > [!tip] **Trennzeichen** und **Dezimaltrennzeichen** richten sich standardmäßig nach der Konvention deiner Region: Regionen, die Listenwerte mit einem Semikolon trennen (der Großteil Europas), starten mit **Semikolon + Komma-Dezimal**, andere (zum Beispiel Englisch) mit **Komma + Punkt-Dezimal**. So lässt sich die Datei per Doppelklick sauber in deinem lokalen Tabellenprogramm öffnen. Sobald du eine Einstellung änderst, wird deine Auswahl gemerkt. ## CSV-Struktur Für das FT3-Schichtdickenformat erzeugt COM Agent eine Zeile pro Einzelmessung, zusammen mit den zusammenfassenden Statistiken und den Instrument-Metadaten. Einheiten werden in Mikrometer (µm) angegeben. | Spalte | Beispiel | Bedeutung | | --- | --- | --- | | Index | 1 | Probennummer innerhalb des Satzes | | Measurement (µm) | 1090.9 | Der einzelne Messwert | | Min (µm) | 1088.4 | Minimum des Satzes | | Max (µm) | 1090.9 | Maximum des Satzes | | Mean (µm) | 1089.4 | Mittelwert des Satzes | | StdDev (µm) | 0.990 | Standardabweichung des Satzes | | Template | 10 | Das Datenformat des Instruments | | Device_ID | FTG38041012H | Seriennummer / ID des Instruments | | Test_Date | 2025-10-07 | Prüfdatum (ISO 8601) | | Calibration_Date | 2025-10-11 | Datum der letzten Kalibrierung | | Test_Time | 11:03:56 | Prüfzeitpunkt | | Sample_Count | 5 | Anzahl der Proben im Satz | | Timestamp | 2025-10-11T11:03:56Z | Wann COM Agent den Satz empfangen hat, im gewählten *Zeitformat* | > [!info] Die geräteeigenen Werte *Test_Date* / *Test_Time* stammen von der Geräteuhr und haben keine Zeitzone. Die Spalte **Timestamp** ist der Zeitpunkt, zu dem dein PC den Satz empfangen hat, und folgt daher der Option *Zeitformat* (UTC oder lokal). > [!info] Empfängt COM Agent Daten, die nicht als strukturiertes Format erkannt werden, wird die CSV-Datei für diese Messung übersprungen und ein Hinweis erscheint im Aktivitätsprotokoll. Die rohe **TXT**-Ausgabe (sofern aktiviert) wird unabhängig vom Format immer geschrieben. [Weiter: Werte in ein anderes Programm tippen](rhopoint-com-agent-keyboard-emulation.md) --- # Tastatur-Emulation Die Tastatur-Emulation lässt COM Agent **gemessene Werte direkt in ein anderes Programm tippen** — genau so, als hättest du sie auf der Tastatur eingegeben. Das ist ideal, um Messwerte in eine Tabelle, eine QA-Datenbank, eine ERP-Maske oder eine beliebige andere Anwendung einzugeben, ohne zu kopieren und einzufügen. Wenn eine Messung abgeschlossen ist, tippt COM Agent die gewählten Werte in **das Fenster und Feld, das gerade den Tastaturfokus hat**. ![](../_images/com-agent-keyboard-options-de.png) ## Aktivieren Aktiviere unter [Ausgabeformate](rhopoint-com-agent-output-formats.md) **Tastatur-Emulation**. Darunter erscheinen die **Tastatur-Optionen**. ## Werte Aktiviere einen oder mehrere zu tippende Werte. **Mittelwert** ist standardmäßig ausgewählt. | Wert | Tippt | | --- | --- | | **Mittelwert** | Den Mittelwert des Messsatzes | | **Minimum** | Den kleinsten Messwert | | **Maximum** | Den größten Messwert | | **Std.-Abw.** | Die Standardabweichung | | **Messwerte** | Jeden einzelnen Messwert | | **Rohdaten** | Die vollständigen Rohdaten wie vom Instrument empfangen | Sind mehrere Werte ausgewählt, werden sie in der angezeigten Reihenfolge getippt, jeweils getrennt durch das gewählte **Trennzeichen**. ## Trennzeichen und Suffix | Option | Zweck | | --- | --- | | **Trennzeichen** | Die Taste, die *zwischen* den Werten (und zwischen einzelnen Messwerten) gedrückt wird. Wähle **Tabulator**, **Eingabe** oder **Keine**. | | **Suffix** | Die Taste, die *nach dem letzten* Wert gedrückt wird. Wähle **Tabulator**, **Eingabe** oder **Keine**. | > [!info] Verwende **Tabulator**, um zur nächsten Zelle oder zum nächsten Feld zu springen, oder **Eingabe**, um eine Eingabe zu bestätigen / in die nächste Zeile zu wechseln. Beispiel: *Trennzeichen = Tabulator* und *Suffix = Eingabe* füllt eine Zellenzeile und springt dann in die nächste Zeile — perfekt für Tabellen. ## Dezimaltrennzeichen Stelle das **Dezimaltrennzeichen** passend zum Zielprogramm ein — typischerweise ein Punkt (`.`) für englische Gebietsschemata oder ein Komma (`,`) für deutsche/französische Gebietsschemata. ## Tastatur-Verzögerung Die **Tastatur-Verzögerung** legt eine kurze Pause nach jedem emulierten Tastenanschlag fest. > [!warning] Kommen getippte Werte **fehlerhaft oder mit wiederholten Zeichen** an, erhöhe die Tastatur-Verzögerung. Manche Anwendungen und PCs nehmen injizierte Tastenanschläge langsamer an als andere. Beginne mit dem Standardwert und erhöhe ihn (zum Beispiel auf 100 ms), bis die Werte korrekt erscheinen. Die Einstellung wird pro PC gespeichert. ## Beispiel Mit ausgewähltem **Mittelwert** und **Minimum**, *Trennzeichen = Tabulator*, *Suffix = Eingabe*, ergibt sich beim Tippen in eine Tabelle: ``` 1089.4 ⇥ 1088.4 ⏎ ``` Der Mittelwert landet in der ersten Zelle, das Minimum in der nächsten, und der Cursor springt in die folgende Zeile — bereit für die nächste Messung. > [!info] Die Tastatur-Emulation schreibt keine Datei. Um eine Aufzeichnung zu behalten *und* Werte zu tippen, aktiviere zusätzlich **Text** oder **CSV** unter [Ausgabeformate](rhopoint-com-agent-output-formats.md). [Weiter: Messungen erfassen](rhopoint-com-agent-capturing-measurements.md) --- # Messungen erfassen Sobald du die [Verbindung](rhopoint-com-agent-connecting-an-instrument.md) konfiguriert und deine [Ausgabe](rhopoint-com-agent-output-formats.md) gewählt hast, kannst du mit der Erfassung beginnen. ## Starten und Stoppen Drücke **Start** (oben rechts). COM Agent öffnet den seriellen Port und wartet auf eingehende Daten. Die Schaltfläche wird zu **Stopp**; drücke sie, um die Sitzung zu beenden und den Port freizugeben. Während die Erfassung läuft, ist die Konfiguration links **gesperrt**, sodass sie nicht mitten in der Sitzung geändert werden kann. ![](../_images/com-agent-running-de.png) ## Das Live-Panel Die rechte Seite zeigt in Echtzeit, was passiert: | Element | Bedeutung | | --- | --- | | **Status-Badge** | **Bereit** vor dem Start, **Empfangsbereit** während der Erfassung, **Fehler** bei einem Verbindungsproblem. | | **Empfangene Sätze** | Ein laufender Zähler der in dieser Sitzung erfassten vollständigen Messungen. | | **Letzte Messung** | Mittelwert, Minimum, Maximum und Std.-Abw. der jüngsten Messung (für erkannte Formate). | | **Aktivitätsprotokoll** | Eine scrollende Liste von Ereignissen: empfangene Daten, geschriebene Dateien (mit vollständigem Pfad), Tastatur-Ausgabe und etwaige Warnungen. Mit **Leeren** wird sie geleert. | ## Eine Messung durchführen 1. Drücke in COM Agent auf **Start**. 2. Löse wie gewohnt eine Messung am Instrument aus. 3. Das Aktivitätsprotokoll zeigt *„Receiving data…"* an, gefolgt vom Pfad jeder geschriebenen Datei, oder einen *„[Keyboard]"*-Eintrag, wenn die Tastatur-Emulation aktiviert ist. 4. Der Zähler **Empfangene Sätze** erhöht sich und **Letzte Messung** wird aktualisiert. > [!info] Jede abgeschlossene Messung wird unabhängig behandelt — du kannst in einer Sitzung beliebig viele durchführen. Es ist nicht nötig, zwischen den Messungen zu stoppen und neu zu starten. > [!warning] Wechselt der Status auf **Fehler** (zum Beispiel, weil das Kabel abgezogen oder das Instrument ausgeschaltet wurde), stoppe die Sitzung, prüfe die Verbindung und starte erneut. [Weiter: ohne Instrument ausprobieren](rhopoint-com-agent-demo-mode.md) --- # Demo-Modus Im Demo-Modus kannst du COM Agent **ohne angeschlossenes Instrument** ausprobieren. Statt von einem seriellen Port zu lesen, erzeugt COM Agent auf Knopfdruck eine realistische Demo-Messung — nützlich, um die Anwendung kennenzulernen, deinen Ausgabeordner oder deine Tastatur-Einrichtung zu testen oder eine Vorführung zu geben. ![](../_images/com-agent-demo-mode-de.png) ## Demo-Modus verwenden 1. Setze **Modus** im Bereich Verbindung auf **Demo**. Die COM-Port- und Baudraten-Einstellungen verschwinden — sie werden nicht benötigt. 2. Wähle deine [Ausgabeformate](rhopoint-com-agent-output-formats.md) und bei Bedarf die [Tastatur-Optionen](rhopoint-com-agent-keyboard-emulation.md), genau wie im Live-Modus. 3. Drücke **Start**. 4. Drücke irgendwo die **rechte Alt-Taste** — auch in einem anderen Programm —, um eine Demo-Messung einzufügen. Jeder Druck auf die rechte Alt-Taste erzeugt eine vollständige Demo-Messung, die dann gemäß deinen Ausgabeeinstellungen geschrieben und/oder getippt wird, genau wie ein echter Messwert. > [!info] Der Demo-Modus ist der schnellste Weg, deine **Tastatur-Emulation** zu überprüfen: Modus auf Demo setzen, Tastatur-Ausgabe aktivieren, in eine Tabelle klicken, Start drücken und die rechte Alt-Taste tippen — die Werte erscheinen in den Zellen. > [!info] Die Demo-Daten verwenden das FT3-Schichtdickenformat, funktionieren also mit CSV-Ausgabe und allen Tastatur-Werten (Mittelwert, Min, Max, Std.-Abw., Messwerte). [Weiter: Lizenzierung](rhopoint-com-agent-licensing.md) --- # Lizenzierung COM Agent benötigt eine gültige Lizenz, um **Live-Messungen** von einem Instrument zu erfassen. Der [Demo-Modus](rhopoint-com-agent-demo-mode.md) funktioniert immer ohne Lizenz, sodass du die Anwendung jederzeit erkunden und deine Ausgabe- und Tastatur-Einrichtung testen kannst. Dein Lizenzstatus ist oben rechts im Fenster stets sichtbar: - Ein grünes **Aktive Lizenzen: N** zeigt an, dass die Live-Erfassung freigeschaltet ist. - Ein rotes **Keine aktiven Lizenzen** bedeutet, dass nur der Demo-Modus verfügbar ist. ![](../_images/com-agent-licence-manager-de.png) ## So funktionieren Lizenzen Eine COM-Agent-Lizenz kann auf zwei Arten gebunden sein: - **An diesen Computer (Host-ID)** — schaltet die Live-Erfassung auf diesem PC frei, für jedes angeschlossene Instrument. - **An eine Geräte-Seriennummer** — schaltet nur die Messungen dieses bestimmten Instruments frei, auf jedem PC. Verwende dies, wenn eine Lizenz einem Instrument statt einem Computer folgen soll. ## Eine Lizenz anfordern 1. Klicke oben rechts auf die Lizenz-Anzeige (oder auf **Lizenz hinzufügen**), um den **Lizenzmanager** zu öffnen. 2. Kopiere deine **Host-ID** mit der Kopier-Schaltfläche daneben. Für eine gerätegebundene Lizenz notiere stattdessen die Seriennummer deines Instruments. 3. Sende die Host-ID (oder Seriennummer) an Rhopoint Instruments, um deine Lizenzdatei zu erhalten. > [!info] Die Host-ID identifiziert diesen bestimmten Computer. Eine host-gebundene Lizenz schaltet die Live-Erfassung nur auf dem Rechner frei, für dessen Host-ID sie ausgestellt wurde. ## Eine Lizenz importieren 1. Öffne den **Lizenzmanager** und klicke auf **Lizenz importieren…**. 2. Wähle die erhaltene Lizenzdatei (`.lic`, `.txt` oder `.json`). Du kannst mehrere Dateien gleichzeitig auswählen. 3. Die Lizenz erscheint in der Liste und die Anzeige wird grün — die Live-Erfassung ist jetzt freigeschaltet. ## Lizenzen verwalten Der Lizenzmanager listet jede installierte Lizenz auf, mit: - **Woran sie gebunden ist** — *Dieser Rechner*, *Geräte-Seriennummer: …* oder *Beliebiger Rechner*. - **Status und Ablauf** — zum Beispiel *Gültig · Läuft ab 2027-01-31*. Mit dem **Papierkorb**-Symbol neben einer Lizenz entfernst du sie. > [!info] Eine an eine Geräte-Seriennummer gebundene Lizenz verarbeitet nur Messungen, deren Geräte-ID dazu passt. Andere am selben PC angeschlossene Instrumente werden ignoriert, sofern sie nicht ebenfalls lizenziert sind. > [!warning] Wenn du **Start** für die Live-Erfassung drückst, ohne eine gültige Lizenz zu haben, zeigt COM Agent eine Meldung an und startet nicht. Importiere entweder eine Lizenz oder schalte den **Modus** auf **Demo**. [Weiter: Einstellungen und Sprache](rhopoint-com-agent-settings-and-language.md) --- # Einstellungen und Sprache ## Deine Einstellungen werden gespeichert COM Agent speichert deine Konfiguration automatisch — Modus, COM-Port, Baudrate, Teil-Markierung und -Anzahl, Ausgabeordner, Ausgabeformate und alle Tastatur-Optionen. Beim nächsten Start der Anwendung ist alles genau so, wie du es verlassen hast, sodass du einfach **Start** drücken kannst. Die Einstellungen werden pro Windows-Benutzer gespeichert. ## Sprache COM Agent ist in dreizehn Sprachen verfügbar: **Englisch**, **Tschechisch**, **Deutsch**, **Spanisch**, **Französisch**, **Italienisch**, **Niederländisch**, **Polnisch**, **Portugiesisch**, **Türkisch**, **Koreanisch**, **Japanisch** und **Chinesisch**. Wähle deine Sprache über das Dropdown oben links im Fenster, neben dem Logo. Die Oberfläche wechselt sofort, und deine Wahl wird für das nächste Mal gespeichert. ![](../_images/com-agent-language-de.png) [Weiter: Start über die Befehlszeile](rhopoint-com-agent-command-line-launch.md) --- # Start über die Befehlszeile COM Agent kann über die Befehlszeile vorkonfiguriert gestartet werden und beginnt sofort mit der Erfassung. Das ist praktisch für die Automatisierung — etwa der Start aus einem anderen Programm, über eine Verknüpfung oder ein Startskript mit fester Konfiguration. Das Anwendungsfenster öffnet sich weiterhin normal; die Parameter füllen lediglich die Einstellungen für dich aus, und die Erfassung startet automatisch. ``` RhopointComAgent.exe --mode live --port COM3 --output "C:\Data" --file-extension csv+txt ``` ## Optionen Die Optionsnamen entsprechen den Einstellungen im Fenster. Jede weggelassene Option behält ihren gespeicherten Wert. | Option | Werte / Beispiel | Bedeutung | | --- | --- | --- | | `--mode` | `live` oder `demo` | Erfassungsmodus. `demo` benötigt keinen COM-Port. | | `--port` | `COM3` | Serieller Port (für die Live-Erfassung erforderlich). | | `--baud` | `19200` | Baudrate. | | `--part-marker` | `^` | Markierung, die einen vollständigen Messsatz abgrenzt. | | `--part-count` | `4` | Anzahl der Teile, die einen vollständigen Satz bilden. | | `--output` | `"C:\Data"` | Ausgabeordner für TXT-/CSV-Dateien. | | `--file-extension` | `txt`, `csv`, `csv+txt`, `keyboard` | Ausgabeformat(e); mehrere mit `+` kombinieren. | | `--csv-delimiter` | `comma`, `semicolon`, `tab` | CSV-Spaltentrennzeichen. | | `--csv-decimal` | `dot`, `comma` | Dezimaltrennzeichen für CSV-Zahlen. | | `--csv-time-format` | `utc`, `local` | Format der CSV-Spalte *Timestamp*. | | `--csv-encoding` | `utf8`, `utf8-bom` | CSV-Dateikodierung (mit oder ohne Byte-Order-Mark). | | `--keyboard-value` | `mean`, `min`, `max`, `stddev`, `measurements`, `raw` | Zu tippende(r) Wert(e); mehrere mit `+` kombinieren. | | `--keyboard-separator` | `tab`, `enter`, `none` | Taste zwischen den getippten Werten. | | `--keyboard-suffix` | `tab`, `enter`, `none` | Taste nach dem letzten Wert. | | `--keyboard-decimal` | `.` oder `,` | Dezimaltrennzeichen für getippte Werte. | | `--keyboard-delay` | `40` | Pause in Millisekunden nach jedem Tastenanschlag. | | `--start` | *(ohne Wert)* | Mit den gespeicherten Einstellungen starten, wenn keine weiteren Parameter angegeben sind. | Die Erfassung startet automatisch, sobald ein Parameter angegeben wird (oder `--start` allein). ## Beispiele Von COM3 in CSV- und TXT-Dateien erfassen: ``` RhopointComAgent.exe --port COM3 --output "C:\QA\Thickness" --file-extension csv+txt ``` Mittelwert und Minimum tab-getrennt in die fokussierte Anwendung tippen: ``` RhopointComAgent.exe --port COM3 --file-extension keyboard --keyboard-value mean+min --keyboard-separator tab ``` Im Demo-Modus starten (kein Instrument nötig): ``` RhopointComAgent.exe --mode demo --output "C:\Data" --file-extension txt ``` > [!info] Das Fenster öffnet sich wie gewohnt, sodass du die Live-Aktivität verfolgen und die Erfassung jederzeit stoppen kannst. Setze Pfade mit Leerzeichen in Anführungszeichen. > [!warning] Die Live-Erfassung benötigt weiterhin eine gültige [Lizenz](rhopoint-com-agent-licensing.md). Ist die Start-Konfiguration unvollständig oder ungültig (zum Beispiel ein nicht vorhandener Ausgabeordner), zeigt COM Agent dieselbe Meldung wie bei einem manuellen Start. [Weiter: COM Agent aktuell halten](rhopoint-com-agent-updating-com-agent.md) --- # COM Agent aktualisieren COM Agent hält sich automatisch aktuell. ## Automatische Updates Beim Start prüft COM Agent im Hintergrund auf eine neue Version. Ist eine verfügbar, erscheint oben rechts im Fenster eine kleine Benachrichtigung. ![](../_images/com-agent-update-notification-de.png) - Klicke auf **Jetzt aktualisieren**, um das Update herunterzuladen und zu installieren. COM Agent lädt die neue Version herunter, zeigt einen Fortschrittsbalken und startet sich dann mit der neuen Version neu. - Klicke auf das **✕**, um die Benachrichtigung auszublenden und mit der aktuellen Version weiterzuarbeiten. Beim nächsten Start wirst du erneut erinnert. > [!info] Updates sind optional und werden nur angewendet, wenn du dich dafür entscheidest. COM Agent unterbricht niemals eine laufende Erfassung für ein Update. ## Deine Version prüfen Die aktuelle Version wird in der Titelleiste des Fensters angezeigt (zum Beispiel *Rhopoint COM Agent 1.2.3*).