# 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 je aplikace pro Windows, která zachytává naměřená data odesílaná přes sériové (COM) připojení přístroji Rhopoint — například tloušťkoměrem FT3 — a mění je v něco užitečného: strukturované soubory na disku nebo hodnoty zadávané přímo do jiného programu.

Kdykoli přístroj vypíše výsledek, COM Agent jej načte, rozpozná formát dat a zapíše je ve formátu, který si zvolíte: jako nezpracovaný soubor **TXT**, jako strukturovaný soubor **CSV** nebo pomocí **emulace stisků kláves**, takže se hodnoty objeví přímo v poli, které má právě fokus (buňce tabulky, databázi kontroly kvality, formuláři ERP …).

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

## Co můžete s COM Agentem dělat

1. [Instalace COM Agenta](rhopoint-com-agent-install-com-agent.md) — stáhněte, nainstalujte a spusťte aplikaci.
2. [Připojení přístroje](rhopoint-com-agent-connecting-an-instrument.md) — zvolte COM port a přenosovou rychlost a ověřte, že přicházejí data.
3. [Výstupní formáty](rhopoint-com-agent-output-formats.md) — zapisujte každé měření do souborů TXT a/nebo CSV.
4. [Emulace klávesnice](rhopoint-com-agent-keyboard-emulation.md) — zadávejte naměřené hodnoty přímo do jiné aplikace pomocí nastavitelných oddělovačů.
5. [Záznam měření](rhopoint-com-agent-capturing-measurements.md) — spusťte a zastavte záznam a sledujte živou aktivitu.
6. [Režim Demo](rhopoint-com-agent-demo-mode.md) — vyzkoušejte aplikaci bez připojeného přístroje.
7. [Licencování](rhopoint-com-agent-licensing.md) — odemkněte živý záznam přidáním licence; režim Demo funguje vždy i bez ní.
8. [Nastavení a jazyk](rhopoint-com-agent-settings-and-language.md) — vaše konfigurace se zapamatuje a rozhraní je k dispozici ve třinácti jazycích.
9. [Spuštění z příkazového řádku](rhopoint-com-agent-command-line-launch.md) — spusťte předkonfigurovaně a zaznamenávejte automaticky (pro automatizaci).
10. [Aktualizace COM Agenta](rhopoint-com-agent-updating-com-agent.md) — udržujte aplikaci aktuální.

## Podporované přístroje

COM Agent čte sériový výstup přístrojů Rhopoint, mezi něž patří:

- tloušťkoměr **FT3**

> [!info] COM Agent v současnosti poskytuje plné strukturované (CSV) zpracování pro formát tloušťky FT3 *„print all samples"*. Ostatní přístroje jsou zaznamenávány jako nezpracovaný text; strukturované zpracování se přidává, jakmile jsou k dispozici ukázková data. Výstup přes klávesnici a TXT funguje pro každý přístroj.

> [!info] COM Agent běží pouze ve Windows. Dodává se jako samostatná aplikace — není potřeba zvlášť instalovat .NET — a udržuje se automaticky aktuální.


---

# Instalace COM Agenta

Rhopoint COM Agent je nenáročná aplikace pro Windows. Instalační program nastaví vše, co potřebuje, a udržuje aplikaci automaticky aktuální.

## Stažení

Stáhněte si nejnovější verzi COM Agenta z [download.rhopointservice.net/com-agent](https://download.rhopointservice.net/com-agent).

## Instalace

1. Stáhněte instalační program COM Agenta z výše uvedeného odkazu.
2. Poklepejte na instalační program a postupujte podle pokynů na obrazovce.
3. Spusťte **Rhopoint COM Agent** z nabídky Start.

> [!info] COM Agent je samostatný — nevyžaduje zvláštní instalaci běhového prostředí .NET. Instalační program také kontroluje aktualizace a automaticky je instaluje na pozadí, takže vždy používáte nejnovější verzi.

## Systémové požadavky

- **OS:** Windows 10 (build 19041 / 20H1) nebo novější
- **CPU:** x64 nebo ARM64
- **Volný sériový (COM) port** — buď vestavěný port, nebo převodník USB na sériový port — pro připojení přístroje. Některé přístroje vyžadují speciální kabel (viz [přehled](rhopoint-com-agent.md)).

## První spuštění

Při spuštění COM Agenta je hlavní okno rozděleno na dvě části:

- **Vlevo** konfigurace: nastavení připojení a možnosti výstupu.
- **Vpravo** živá aktivita: stav, počet přijatých měření, poslední měření a protokol aktivity.

Tlačítko **Spustit / Zastavit** je vpravo nahoře, nad počitadlem měření, a je vždy viditelné.

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

[Dále: připojení přístroje](rhopoint-com-agent-connecting-an-instrument.md)


---

# Připojení přístroje

V režimu **Živě** čte COM Agent naměřená data přímo z přístroje přes sériové (COM) připojení.

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

## 1. Připojte hardware

1. Připojte přístroj k počítači jeho sériovým kabelem nebo převodníkem USB na sériový port. Některé přístroje (CBT1.2, NovoHaze TX) vyžadují speciální kabel — viz [přehled](rhopoint-com-agent.md).
2. Zapněte přístroj.

## 2. Zvolte nastavení připojení

V sekci **Připojení** vlevo:

| Nastavení | Popis |
| --- | --- |
| **Režim** | Nastavte na **Živě** pro čtení ze sériového portu. (Pomocí **Demo** vyzkoušíte aplikaci bez hardwaru — viz [Režim Demo](rhopoint-com-agent-demo-mode.md).) |
| **COM port** | Vyberte port, ke kterému je přístroj připojen. Po zapojení převodníku klikněte na tlačítko **obnovit** pro opětovné prohledání portů. |
| **Přenosová rychlost** | Rychlost sériového přenosu. Výchozí hodnota pro přístroje Rhopoint je **19200**. |
| **Značka dílu** | Znak, který přístroj vypisuje pro označení každého dílu kompletní datové sady. Výchozí hodnota je **^**. |
| **Počet dílů** | Kolik značek dílů tvoří jednu kompletní datovou sadu. Výchozí hodnota je **4**. |

> [!info] **Značka dílu** a **Počet dílů** říkají COM Agentu, kdy je měření kompletní. Datová sada se zapíše až poté, co je přijat očekávaný počet značek a řádek skončí — tím se zabrání ukládání nedokončených měření. Výchozí hodnoty odpovídají přístrojům Rhopoint; měňte je jen na doporučení podpory Rhopoint.

## 3. Zvolte, co s daty dělat

Rozhodněte, jak se má každé měření uložit nebo předat dál:

- Zapisovat soubory — viz [Výstupní formáty](rhopoint-com-agent-output-formats.md).
- Zadávat hodnoty do jiné aplikace — viz [Emulace klávesnice](rhopoint-com-agent-keyboard-emulation.md).

Tyto možnosti lze kombinovat (například zapsat soubor CSV *a zároveň* zadat průměr do tabulky).

## 4. Spusťte záznam

Stiskněte **Spustit** (vpravo nahoře) a proveďte měření na přístroji. Protokol aktivity vpravo potvrdí, že přicházejí data. Podrobnosti viz [Záznam měření](rhopoint-com-agent-capturing-measurements.md).

> [!warning] Pokud vybraný COM port nelze otevřít (například proto, že jej už používá jiný program), COM Agent zobrazí chybu. Zavřete druhý program nebo zvolte jiný port a zkuste to znovu.

[Dále: zvolte výstupní formát](rhopoint-com-agent-output-formats.md)


---

# Výstupní formáty

COM Agent může zapsat každé dokončené měření do souboru. Zvolte **Výstupní složku** a zaškrtněte jeden nebo více **Výstupních formátů**. Formáty lze libovolně kombinovat.

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

## Výstupní složka

Klikněte na **Procházet…** vedle položky *Výstupní složka* a zvolte, kam se mají soubory zapisovat. Každé měření vytvoří nový soubor s jedinečným názvem s časovým razítkem, takže se nikdy nic nepřepíše:

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

Název obsahuje časové razítko UTC, průběžné počitadlo a jedinečný identifikátor.

## Formáty

| Formát | Co vytváří |
| --- | --- |
| **Textový soubor (.txt)** | Nezpracovaná data přesně tak, jak byla přijata z přístroje, bez jakéhokoli zpracování. Funguje pro každý přístroj. |
| **Soubor CSV (.csv)** | Strukturovaný tabulkový soubor s pojmenovanými sloupci a metrickými jednotkami. Vyžaduje rozpoznaný formát dat (v současnosti formát tloušťky FT3 *„print all samples"*). |
| **Emulace klávesnice** | Místo zápisu souboru zadává hodnoty do jiné aplikace — viz [Emulace klávesnice](rhopoint-com-agent-keyboard-emulation.md). |

> [!info] Najednou můžete povolit více formátů. Například zaškrtněte **Text** a **CSV**, abyste si vedle strukturovaného souboru ponechali nezpracovaný archiv, nebo zaškrtněte **CSV** a **Klávesnice**, abyste data uložili *a zároveň* zadali hodnotu do svého systému kontroly kvality.

## Možnosti exportu CSV

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

Když je povolen formát **CSV**, zobrazí se panel **Možnosti CSV** se čtyřmi nastaveními, která určují, jak se soubor zapisuje. COM Agent volí rozumné výchozí hodnoty podle vašeho jazyka a regionu, takže je ve většině případů můžete ponechat beze změny.

| Možnost | Volby | Účinek |
| --- | --- | --- |
| **Oddělovač** | Čárka "," · Středník ";" · Tabulátor "→" | Znak umístěný mezi sloupci. |
| **Formát času** | ISO 8601, UTC · ISO 8601, místní | Formát sloupce *Timestamp*: UTC (např. `2025-10-11T11:03:56Z`) nebo místní čas s posunem (např. `2025-10-11T13:03:56+02:00`). |
| **Oddělovač desetin** | Tečka "." · Čárka "," | Desetinné znaménko použité pro číselné hodnoty. Data a identifikátory se nikdy nemění. |
| **Kódování souboru** | UTF-8 · UTF-8 s BOM | Zda se na začátek souboru zapíše značka pořadí bajtů (BOM). BOM pomáhá některým tabulkovým programům (například Excelu) rozpoznat UTF-8 a správně zobrazit záhlaví s µm. |

> [!tip] **Oddělovač** a **Oddělovač desetin** se ve výchozím nastavení řídí konvencí vašeho regionu: regiony, které oddělují hodnoty v seznamu středníkem (většina Evropy), začínají se **středníkem + desetinnou čárkou**, ostatní (například angličtina) s **čárkou + desetinnou tečkou**. Díky tomu se soubor otevře čistě dvojklikem ve vašem místním tabulkovém programu. Jakmile nastavení změníte, vaše volba se zapamatuje.

## Struktura CSV

U formátu tloušťky FT3 vytváří COM Agent jeden řádek pro každý jednotlivý vzorek spolu se souhrnnými statistikami a metadaty přístroje. Jednotky jsou uvedeny v mikrometrech (µm).

| Column | Příklad | Význam |
| --- | --- | --- |
| Index | 1 | Číslo vzorku v rámci sady |
| Measurement (µm) | 1090.9 | Hodnota jednotlivého vzorku |
| Min (µm) | 1088.4 | Minimum sady |
| Max (µm) | 1090.9 | Maximum sady |
| Mean (µm) | 1089.4 | Průměr sady |
| StdDev (µm) | 0.990 | Směrodatná odchylka sady |
| Template | 10 | Formát dat přístroje |
| Device_ID | FTG38041012H | Sériové číslo / ID přístroje |
| Test_Date | 2025-10-07 | Datum testu (ISO 8601) |
| Calibration_Date | 2025-10-11 | Datum poslední kalibrace |
| Test_Time | 11:03:56 | Čas testu |
| Sample_Count | 5 | Počet vzorků v sadě |
| Timestamp | 2025-10-11T11:03:56Z | Kdy COM Agent přijal sadu, ve zvoleném *Formátu času* |

> [!info] Vlastní hodnoty přístroje *Test_Date* / *Test_Time* pocházejí z hodin zařízení a nemají žádné časové pásmo. Sloupec **Timestamp** je okamžik, kdy váš počítač přijal sadu, takže odráží volbu *Formát času* (UTC nebo místní).

> [!info] Pokud COM Agent přijme data, která nerozpozná jako strukturovaný formát, soubor CSV se pro dané měření vynechá a v protokolu aktivity se objeví poznámka. Nezpracovaný výstup **TXT** (je-li povolen) se zapíše vždy bez ohledu na formát.

[Dále: zadávání hodnot do jiné aplikace](rhopoint-com-agent-keyboard-emulation.md)


---

# Emulace klávesnice

Emulace klávesnice umožňuje COM Agentu **zadávat naměřené hodnoty přímo do jiného programu** — přesně tak, jako byste je napsali na klávesnici. To je ideální pro zadávání hodnot do tabulky, databáze kontroly kvality, obrazovky ERP nebo jakékoli jiné aplikace bez kopírování a vkládání.

Po dokončení měření zadá COM Agent vybranou hodnotu (hodnoty) do **toho okna a pole, které má právě fokus klávesnice**.

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

## Zapnutí

Zaškrtněte **Emulace klávesnice** pod [Výstupními formáty](rhopoint-com-agent-output-formats.md). Níže se objeví **Možnosti klávesnice**.

## Hodnoty

Zaškrtněte jednu nebo více hodnot k zadání. Ve výchozím nastavení je vybrán **Průměr**.

| Hodnota | Zadává |
| --- | --- |
| **Průměr** | Průměr měřicí sady |
| **Minimum** | Nejnižší hodnotu |
| **Maximum** | Nejvyšší hodnotu |
| **Sm. odch.** | Směrodatnou odchylku |
| **Měření** | Každou jednotlivou hodnotu vzorku |
| **Nezpracovaná data** | Kompletní nezpracovaná data tak, jak byla přijata z přístroje |

Je-li vybráno více hodnot, zadávají se v pořadí uvedeném výše, oddělené zvoleným **Oddělovačem**.

## Oddělovač a přípona

| Možnost | Účel |
| --- | --- |
| **Oddělovač** | Klávesa stisknutá *mezi* hodnotami (a mezi jednotlivými měřeními). Zvolte **Tab**, **Enter** nebo **Žádný**. |
| **Přípona** | Klávesa stisknutá *po poslední* hodnotě. Zvolte **Tab**, **Enter** nebo **Žádný**. |

> [!info] Použijte **Tab** pro přesun do další buňky nebo pole, nebo **Enter** pro potvrzení záznamu / přesun na další řádek. Například *Oddělovač = Tab* a *Přípona = Enter* vyplní řádek buněk a poté se přesune na další řádek — ideální pro tabulky.

## Desetinný oddělovač

Nastavte **Desetinný oddělovač** tak, aby odpovídal cílové aplikaci — obvykle tečka (`.`) pro anglické lokalizace nebo čárka (`,`) pro německé / francouzské lokalizace.

## Prodleva klávesnice

**Prodleva klávesnice** nastavuje krátkou pauzu po každém emulovaném stisku klávesy.

> [!warning] Pokud zadávané hodnoty přicházejí **poškozené nebo s opakovanými znaky**, zvyšte Prodlevu klávesnice. Některé aplikace a počítače přijímají vkládané stisky kláves pomaleji než jiné. Začněte na výchozí hodnotě a zvyšujte ji (například na 100 ms), dokud se hodnoty nebudou zobrazovat správně. Toto nastavení se ukládá pro každý počítač zvlášť.

## Příklad

S vybraným **Průměrem** a **Minimem**, *Oddělovač = Tab*, *Přípona = Enter*, zadávání do tabulky vytvoří:

```
1089.4 ⇥ 1088.4 ⏎
```

Průměr se objeví v první buňce, minimum v další a kurzor se přesune na následující řádek — připraven na další měření.

> [!info] Emulace klávesnice nezapisuje soubor. Chcete-li si vést záznam *a zároveň* zadávat hodnoty, zaškrtněte také **Text** nebo **CSV** pod [Výstupními formáty](rhopoint-com-agent-output-formats.md).

[Dále: záznam měření](rhopoint-com-agent-capturing-measurements.md)


---

# Záznam měření

Jakmile máte nakonfigurováno [připojení](rhopoint-com-agent-connecting-an-instrument.md) a zvolen [výstup](rhopoint-com-agent-output-formats.md), jste připraveni k záznamu.

## Spuštění a zastavení

Stiskněte **Spustit** (vpravo nahoře). COM Agent otevře sériový port a začne naslouchat. Tlačítko se změní na **Zastavit**; jeho stisknutím relaci ukončíte a uvolníte port.

Během záznamu je konfigurace vlevo **uzamčena**, takže ji nelze měnit uprostřed relace.

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

## Živý panel

Pravá strana zobrazuje v reálném čase, co se děje:

| Prvek | Význam |
| --- | --- |
| **Stavový odznak** | **Nečinné** před spuštěním, **Naslouchání** během záznamu, **Chyba** při selhání připojení. |
| **Přijaté sady** | Průběžné počitadlo kompletních měření zaznamenaných v této relaci. |
| **Poslední měření** | Průměr, Minimum, Maximum a Sm. odch. nejnovějšího měření (u rozpoznaných formátů). |
| **Protokol aktivity** | Posouvající se seznam událostí: přijatá data, zapsané soubory (s jejich úplnou cestou), výstup přes klávesnici a případná varování. Pomocí **Vymazat** jej vyprázdníte. |

## Provedení měření

1. Stiskněte **Spustit** v COM Agentu.
2. Spusťte měření na přístroji jako obvykle.
3. V protokolu aktivity se zobrazí *„Receiving data…"* následované cestou každého zapsaného souboru, nebo položka *„[Keyboard]"*, je-li povolena emulace klávesnice.
4. Počitadlo **Přijaté sady** se zvýší a **Poslední měření** se aktualizuje.

> [!info] Každé dokončené měření je zpracováno samostatně — v jedné relaci jich můžete provést, kolik chcete. Mezi měřeními není nutné záznam zastavovat a znovu spouštět.

> [!warning] Pokud se stav změní na **Chyba** (například je odpojen kabel nebo je vypnut přístroj), zastavte relaci, zkontrolujte připojení a spusťte ji znovu.

[Dále: vyzkoušejte to bez přístroje](rhopoint-com-agent-demo-mode.md)


---

# Režim Demo

Režim Demo umožňuje vyzkoušet COM Agent **bez připojeného přístroje**. Místo čtení ze sériového portu generuje COM Agent na vyžádání realistické demo měření — užitečné pro seznámení s aplikací, otestování výstupní složky nebo nastavení klávesnice nebo pro předvádění.

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

## Použití režimu Demo

1. Nastavte **Režim** na **Demo** v sekci Připojení. Nastavení COM portu a přenosové rychlosti zmizí — nejsou potřeba.
2. Zvolte své [výstupní formáty](rhopoint-com-agent-output-formats.md) a případně [možnosti klávesnice](rhopoint-com-agent-keyboard-emulation.md), přesně jako v živém režimu.
3. Stiskněte **Spustit**.
4. Stiskněte kdekoli klávesu **pravý Alt** — i v jiné aplikaci — pro vložení demo měření.

Každé stisknutí pravého Altu vytvoří jedno kompletní demo měření, které se poté zapíše a/nebo zadá podle vašeho nastavení výstupu, stejně jako skutečná hodnota.

> [!info] Režim Demo je nejrychlejší způsob, jak ověřit nastavení **emulace klávesnice**: nastavte Režim na Demo, povolte výstup přes klávesnici, klikněte do tabulky, stiskněte Spustit a klepněte na pravý Alt — hodnoty se objeví v buňkách.

> [!info] Demo data používají formát tloušťky FT3, takže funguje s výstupem CSV a všemi hodnotami klávesnice (Průměr, Min, Max, Sm. odch., Měření).

[Dále: licencování](rhopoint-com-agent-licensing.md)


---

# Licencování

COM Agent potřebuje platnou licenci k **záznamu živých měření** z přístroje. [Režim Demo](rhopoint-com-agent-demo-mode.md) funguje vždy i bez licence, takže můžete aplikaci prozkoumat a otestovat nastavení výstupu a klávesnice kdykoli.

Stav vaší licence je vždy viditelný vpravo nahoře v okně:

- Zelený odznak **Aktivní licence: N** znamená, že je živý záznam odemčen.
- Červený odznak **Žádné aktivní licence** znamená, že je k dispozici pouze režim Demo.

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

## Jak licence fungují

Licenci COM Agent lze navázat jedním ze dvou způsobů:

- **Na tento počítač (ID hostitele)** — odemkne živý záznam na tomto počítači pro jakýkoli připojený přístroj.
- **Na sériové číslo zařízení** — odemkne pouze měření pocházející z daného konkrétního přístroje, na jakémkoli počítači. Použijte to, když má licence následovat přístroj, nikoli počítač.

## Žádost o licenci

1. Klikněte na odznak licence (nebo na **Přidat licenci**) vpravo nahoře, čímž otevřete **Správce licencí**.
2. Zkopírujte své **ID hostitele** pomocí tlačítka kopírovat vedle něj. Pro licenci vázanou na zařízení si místo toho poznamenejte sériové číslo přístroje.
3. Odešlete ID hostitele (nebo sériové číslo) společnosti Rhopoint Instruments, abyste získali soubor licence.

> [!info] ID hostitele identifikuje tento konkrétní počítač. Licence vázaná na hostitele odemkne živý záznam pouze na počítači, pro jehož ID hostitele byla vydána.

## Import licence

1. Otevřete **Správce licencí** a klikněte na **Importovat licenci…**.
2. Vyberte soubor licence, který jste obdrželi (`.lic`, `.txt` nebo `.json`). Můžete vybrat několik souborů najednou.
3. Licence se objeví v seznamu a odznak zezelená — živý záznam je nyní odemčen.

## Správa licencí

Správce licencí uvádí každou nainstalovanou licenci s:

- **Na co je vázána** — *Tento počítač*, *Sériové číslo zařízení: …* nebo *Jakýkoli počítač*.
- **Jejím stavem a platností** — například *Platná · Vyprší 2027-01-31*.

Pomocí ikony **koše** vedle licence ji odeberete.

> [!info] Licence vázaná na sériové číslo zařízení zpracovává pouze měření, jejichž ID zařízení mu odpovídá. Ostatní přístroje připojené ke stejnému počítači jsou ignorovány, pokud nemají vlastní licenci.

> [!warning] Pokud stisknete **Spustit** pro živý záznam bez platné licence, COM Agent zobrazí zprávu a nespustí se. Buď importujte licenci, nebo přepněte **Režim** na **Demo**.

[Dále: nastavení a jazyk](rhopoint-com-agent-settings-and-language.md)


---

# Nastavení a jazyk

## Vaše nastavení se zapamatuje

COM Agent ukládá vaši konfiguraci automaticky — režim, COM port, přenosovou rychlost, značku a počet dílů, výstupní složku, výstupní formáty a všechny možnosti klávesnice. Při příštím spuštění aplikace je vše přesně tak, jak jste to nechali, takže můžete jednoduše stisknout **Spustit**.

Nastavení se ukládá pro každého uživatele Windows zvlášť.

## Jazyk

COM Agent je k dispozici ve třinácti jazycích: **angličtina**, **čeština**, **němčina**, **španělština**, **francouzština**, **italština**, **nizozemština**, **polština**, **portugalština**, **turečtina**, **korejština**, **japonština** a **čínština**. Zvolte si jazyk z rozevíracího seznamu vlevo nahoře v okně, vedle loga. Rozhraní se okamžitě přepne a vaše volba se zapamatuje pro příště.

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

[Dále: spuštění z příkazového řádku](rhopoint-com-agent-command-line-launch.md)


---

# Spuštění z příkazového řádku

COM Agent lze spustit předkonfigurovaně z příkazového řádku a okamžitě začít zaznamenávat. To se hodí
pro automatizaci — spuštění z jiného programu, ze zástupce na ploše nebo ze spouštěcího skriptu
s pevnou konfigurací.

Okno aplikace se stále otevírá jako obvykle; parametry za vás jen vyplní nastavení a
záznam se spustí automaticky.

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

## Možnosti

Názvy možností odpovídají nastavení v okně. Každá vynechaná možnost si ponechá svou uloženou hodnotu.

| Možnost | Hodnoty / příklad | Význam |
| --- | --- | --- |
| `--mode` | `live` nebo `demo` | Režim záznamu. `demo` nepotřebuje COM port. |
| `--port` | `COM3` | Sériový port (vyžadován pro živý záznam). |
| `--baud` | `19200` | Přenosová rychlost. |
| `--part-marker` | `^` | Značka oddělující kompletní měřicí sadu. |
| `--part-count` | `4` | Počet dílů tvořících kompletní sadu. |
| `--output` | `"C:\Data"` | Výstupní složka pro soubory TXT/CSV. |
| `--file-extension` | `txt`, `csv`, `csv+txt`, `keyboard` | Výstupní formát(y); více jich zkombinujete pomocí `+`. |
| `--csv-delimiter` | `comma`, `semicolon`, `tab` | Oddělovač sloupců CSV. |
| `--csv-decimal` | `dot`, `comma` | Desetinný oddělovač pro čísla v CSV. |
| `--csv-time-format` | `utc`, `local` | Formát sloupce *Timestamp* v CSV. |
| `--csv-encoding` | `utf8`, `utf8-bom` | Kódování souboru CSV (se značkou pořadí bajtů nebo bez ní). |
| `--keyboard-value` | `mean`, `min`, `max`, `stddev`, `measurements`, `raw` | Hodnota(y) k zadání; více jich zkombinujete pomocí `+`. |
| `--keyboard-separator` | `tab`, `enter`, `none` | Klávesa stisknutá mezi zadávanými hodnotami. |
| `--keyboard-suffix` | `tab`, `enter`, `none` | Klávesa stisknutá po poslední hodnotě. |
| `--keyboard-decimal` | `.` nebo `,` | Desetinný oddělovač pro zadávané hodnoty. |
| `--keyboard-delay` | `40` | Pauza v milisekundách po každém stisku klávesy. |
| `--start` | *(bez hodnoty)* | Spustí s uloženým nastavením, nejsou-li zadány žádné jiné parametry. |

Záznam se spustí automaticky, kdykoli je zadán jakýkoli parametr (nebo samotné `--start`).

## Příklady

Záznam z COM3 do souborů CSV a TXT:

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

Zadání průměru a minima do aktivní aplikace, oddělené tabulátorem:

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

Spuštění v režimu Demo (není potřeba přístroj):

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

> [!info] Okno se otevře jako obvykle, takže můžete stále sledovat živou aktivitu a kdykoli záznam zastavit. Cesty obsahující mezery uzavřete do uvozovek.

> [!warning] Živý záznam stále vyžaduje platnou [licenci](rhopoint-com-agent-licensing.md). Pokud je spouštěcí konfigurace neúplná nebo neplatná (například výstupní složka neexistuje), COM Agent zobrazí stejnou zprávu jako při ručním spuštění.

[Dále: udržování COM Agenta aktuálního](rhopoint-com-agent-updating-com-agent.md)


---

# Aktualizace COM Agenta

COM Agent se udržuje automaticky aktuální.

## Automatické aktualizace

Při spuštění COM Agent na pozadí zkontroluje, zda není k dispozici nová verze. Pokud nějaká existuje, vpravo nahoře v okně se objeví malé upozornění.

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

- Kliknutím na **Aktualizovat nyní** stáhnete a nainstalujete aktualizaci. COM Agent stáhne novou verzi, zobrazí indikátor průběhu a poté se restartuje do nové verze.
- Kliknutím na **✕** upozornění zavřete a budete dál pracovat ve stávající verzi. Při příštím spuštění aplikace budete znovu upozorněni.

> [!info] Aktualizace jsou volitelné a použijí se, jen když si to zvolíte. COM Agent nikdy nepřeruší relaci záznamu kvůli aktualizaci.

## Kontrola vaší verze

Aktuální verze je zobrazena v záhlaví okna (například *Rhopoint COM Agent 1.2.3*).