# 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 to aplikacja dla systemu Windows, która przechwytuje dane pomiarowe wysyłane przez połączenie szeregowe (COM) przez przyrządy Rhopoint — takie jak miernik grubości powłok FT3 — i zamienia je w coś użytecznego: uporządkowane pliki na dysku lub wartości wpisywane bezpośrednio do innego programu.

Za każdym razem, gdy przyrząd wydrukuje wynik, COM Agent odczytuje go, rozpoznaje format danych i zapisuje w wybranym przez Ciebie formacie: jako surowy plik **TXT**, uporządkowany plik **CSV** lub poprzez **emulację naciśnięć klawiszy**, dzięki czemu wartości pojawiają się bezpośrednio w polu, które aktualnie ma fokus (komórka arkusza kalkulacyjnego, baza danych kontroli jakości, formularz ERP, …).

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

## Co można zrobić za pomocą COM Agent

1. [Instalacja COM Agent](rhopoint-com-agent-install-com-agent.md) — pobierz, zainstaluj i uruchom aplikację.
2. [Podłączanie przyrządu](rhopoint-com-agent-connecting-an-instrument.md) — wybierz port COM oraz szybkość transmisji i potwierdź, że dane napływają.
3. [Formaty wyjściowe](rhopoint-com-agent-output-formats.md) — zapisuj każdy pomiar do plików TXT i/lub CSV.
4. [Emulacja klawiatury](rhopoint-com-agent-keyboard-emulation.md) — wpisuj zmierzone wartości bezpośrednio do innej aplikacji, z konfigurowalnymi separatorami.
5. [Przechwytywanie pomiarów](rhopoint-com-agent-capturing-measurements.md) — rozpoczynaj i zatrzymuj przechwytywanie oraz śledź aktywność na żywo.
6. [Tryb demonstracyjny](rhopoint-com-agent-demo-mode.md) — wypróbuj aplikację bez podłączonego przyrządu.
7. [Licencjonowanie](rhopoint-com-agent-licensing.md) — odblokuj przechwytywanie na żywo, dodając licencję; tryb demonstracyjny zawsze działa bez niej.
8. [Ustawienia i język](rhopoint-com-agent-settings-and-language.md) — Twoja konfiguracja jest zapamiętywana, a interfejs jest dostępny w trzynastu językach.
9. [Uruchamianie z wiersza poleceń](rhopoint-com-agent-command-line-launch.md) — uruchamiaj aplikację wstępnie skonfigurowaną i przechwytuj automatycznie (do automatyzacji).
10. [Aktualizacja COM Agent](rhopoint-com-agent-updating-com-agent.md) — utrzymuj aplikację w aktualnym stanie.

## Obsługiwane przyrządy

COM Agent odczytuje dane wyjściowe z portu szeregowego przyrządów Rhopoint, w tym:

- **FT3** Miernik grubości powłok

> [!info] COM Agent zapewnia obecnie pełne, uporządkowane przetwarzanie (CSV) dla formatu grubości FT3 *„print all samples”*. Inne przyrządy są przechwytywane jako surowy tekst; uporządkowane przetwarzanie jest dodawane w miarę udostępniania danych przykładowych. Wyjście klawiatury i TXT działa dla każdego przyrządu.

> [!info] COM Agent działa wyłącznie w systemie Windows. Jest dystrybuowany jako aplikacja samodzielna — nie jest wymagana osobna instalacja platformy .NET — i sam dba o swoją aktualność.


---

# Instalacja COM Agent

Rhopoint COM Agent to lekka aplikacja dla systemu Windows. Instalator konfiguruje wszystko, czego potrzebuje, i automatycznie utrzymuje aplikację w aktualnym stanie.

## Pobieranie

Pobierz najnowszą wersję COM Agent ze strony [download.rhopointservice.net/com-agent](https://download.rhopointservice.net/com-agent).

## Instalacja

1. Pobierz instalator COM Agent z powyższego łącza.
2. Kliknij dwukrotnie instalator i postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.
3. Uruchom **Rhopoint COM Agent** z menu Start.

> [!info] COM Agent jest samodzielny — nie wymaga osobnej instalacji środowiska uruchomieniowego .NET. Instalator sprawdza także dostępność aktualizacji i instaluje je automatycznie w tle, dzięki czemu zawsze korzystasz z najnowszej wersji.

## Wymagania systemowe

- **System operacyjny:** Windows 10 (kompilacja 19041 / 20H1) lub nowszy
- **Procesor:** x64 lub ARM64
- **Wolny port szeregowy (COM)** — wbudowany port lub adapter USB-szeregowy — do podłączenia przyrządu. Niektóre przyrządy wymagają specjalnego kabla (zobacz [przegląd](rhopoint-com-agent.md)).

## Pierwsze uruchomienie

Po uruchomieniu COM Agent okno główne jest podzielone na dwa obszary:

- Po **lewej** stronie konfiguracja: ustawienia połączenia i opcje wyjścia.
- Po **prawej** stronie aktywność na żywo: status, liczba odebranych pomiarów, ostatni pomiar oraz dziennik aktywności.

Przycisk **Start / Stop** znajduje się w prawym górnym rogu, nad licznikiem pomiarów, i jest zawsze widoczny.

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

[Dalej: podłącz przyrząd](rhopoint-com-agent-connecting-an-instrument.md)


---

# Podłączanie przyrządu

W trybie **Na żywo** COM Agent odczytuje dane pomiarowe bezpośrednio z przyrządu przez połączenie szeregowe (COM).

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

## 1. Podłącz sprzęt

1. Podłącz przyrząd do komputera za pomocą jego kabla szeregowego lub adaptera USB-szeregowego. Niektóre przyrządy (CBT1.2, NovoHaze TX) wymagają specjalnego kabla — zobacz [przegląd](rhopoint-com-agent.md).
2. Włącz przyrząd.

## 2. Wybierz ustawienia połączenia

W sekcji **Połączenie** po lewej stronie:

| Ustawienie | Opis |
| --- | --- |
| **Tryb** | Ustaw na **Na żywo**, aby odczytywać z portu szeregowego. (Użyj trybu **Demo**, aby wypróbować aplikację bez sprzętu — zobacz [Tryb demonstracyjny](rhopoint-com-agent-demo-mode.md).) |
| **Port COM** | Wybierz port, do którego podłączony jest przyrząd. Kliknij przycisk **odśwież**, aby ponownie przeskanować porty po podłączeniu adaptera. |
| **Szybkość transmisji** | Prędkość transmisji szeregowej. Wartość domyślna dla przyrządów Rhopoint to **19200**. |
| **Znacznik części** | Znak, który przyrząd drukuje, aby oznaczyć każdą część kompletnego zestawu danych. Wartość domyślna to **^**. |
| **Liczba części** | Ile znaczników części składa się na jeden kompletny zestaw danych. Wartość domyślna to **4**. |

> [!info] **Znacznik części** i **Liczba części** informują COM Agent, kiedy pomiar jest kompletny. Zestaw danych jest zapisywany dopiero po odebraniu oczekiwanej liczby znaczników i zakończeniu wiersza — zapobiega to zapisywaniu częściowo odebranych pomiarów. Wartości domyślne odpowiadają przyrządom Rhopoint; zmieniaj je tylko za radą działu wsparcia Rhopoint.

## 3. Wybierz, co zrobić z danymi

Zdecyduj, jak każdy pomiar ma zostać zapisany lub przekazany:

- Zapisywanie plików — zobacz [Formaty wyjściowe](rhopoint-com-agent-output-formats.md).
- Wpisywanie wartości do innej aplikacji — zobacz [Emulacja klawiatury](rhopoint-com-agent-keyboard-emulation.md).

Możesz łączyć te metody (na przykład zapisać plik CSV *oraz* wpisać średnią do arkusza kalkulacyjnego).

## 4. Rozpocznij przechwytywanie

Naciśnij **Start** (w prawym górnym rogu) i wykonaj pomiar na przyrządzie. Dziennik aktywności po prawej stronie potwierdza, że dane napływają. Szczegóły znajdziesz w [Przechwytywanie pomiarów](rhopoint-com-agent-capturing-measurements.md).

> [!warning] Jeśli wybranego portu COM nie można otworzyć (na przykład dlatego, że inny program już go używa), COM Agent wyświetli błąd. Zamknij drugi program lub wybierz inny port, a następnie spróbuj ponownie.

[Dalej: wybierz format wyjściowy](rhopoint-com-agent-output-formats.md)


---

# Formaty wyjściowe

COM Agent może zapisać każdy ukończony pomiar do pliku. Wybierz **Folder wyjściowy** i zaznacz jeden lub więcej **Formatów wyjściowych**. Formaty można dowolnie łączyć.

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

## Folder wyjściowy

Kliknij **Przeglądaj…** obok *Folderu wyjściowego* i wybierz, gdzie mają być zapisywane pliki. Każdy pomiar tworzy nowy plik o unikalnej nazwie ze znacznikiem czasu, dzięki czemu nic nigdy nie zostaje nadpisane:

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

Nazwa zawiera znacznik czasu UTC, bieżący licznik oraz unikalny identyfikator.

## Formaty

| Format | Co tworzy |
| --- | --- |
| **Plik tekstowy (.txt)** | Surowe dane dokładnie w postaci odebranej z przyrządu, bez żadnego przetwarzania. Działa dla każdego przyrządu. |
| **Plik CSV (.csv)** | Uporządkowany plik arkusza kalkulacyjnego z nazwanymi kolumnami i jednostkami metrycznymi. Wymaga rozpoznanego formatu danych (obecnie formatu grubości FT3 *„print all samples”*). |
| **Emulacja klawiatury** | Wpisuje wartości do innej aplikacji zamiast zapisywać plik — zobacz [Emulacja klawiatury](rhopoint-com-agent-keyboard-emulation.md). |

> [!info] Możesz włączyć kilka formatów jednocześnie. Na przykład zaznacz **Text** i **CSV**, aby zachować surowe archiwum obok uporządkowanego pliku, lub zaznacz **CSV** i **Keyboard**, aby zarchiwizować dane *oraz* wpisać wartość do systemu kontroli jakości.

## Opcje eksportu CSV

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

Gdy format **CSV** jest włączony, pojawia się panel **Opcje CSV** z czterema ustawieniami, które określają sposób zapisu pliku. COM Agent dobiera rozsądne wartości domyślne na podstawie Twojego języka i regionu, dzięki czemu w większości przypadków można je pozostawić bez zmian.

| Opcja | Możliwości | Działanie |
| --- | --- | --- |
| **Separator** | Przecinek "," · Średnik ";" · Tabulator "→" | Znak umieszczany między kolumnami. |
| **Format czasu** | ISO 8601, UTC · ISO 8601, lokalny | Format kolumny *Timestamp*: UTC (np. `2025-10-11T11:03:56Z`) lub czas lokalny z przesunięciem (np. `2025-10-11T13:03:56+02:00`). |
| **Separator dziesiętny** | Kropka "." · Przecinek "," | Znak dziesiętny używany dla wartości liczbowych. Daty i identyfikatory nigdy nie są zmieniane. |
| **Kodowanie pliku** | UTF-8 · UTF-8 z BOM | Czy na początku pliku zapisywany jest znacznik kolejności bajtów (BOM). BOM pomaga niektórym arkuszom kalkulacyjnym (na przykład Excelowi) rozpoznać UTF-8 i poprawnie wyświetlić nagłówki z µm. |

> [!tip] **Separator** i **Separator dziesiętny** domyślnie przyjmują konwencję Twojego regionu: regiony, które oddzielają wartości listy średnikiem (większość Europy), zaczynają od **średnika + przecinka dziesiętnego**, pozostałe (na przykład angielski) od **przecinka + kropki dziesiętnej**. Dzięki temu plik otwiera się poprawnie po dwukrotnym kliknięciu w lokalnym arkuszu kalkulacyjnym. Po zmianie ustawienia Twój wybór zostaje zapamiętany.

## Struktura CSV

Dla formatu grubości FT3 COM Agent tworzy jeden wiersz na każdą pojedynczą próbkę, wraz ze statystykami zbiorczymi i metadanymi przyrządu. Jednostki podawane są w mikrometrach (µm).

| Column | Przykład | Znaczenie |
| --- | --- | --- |
| Index | 1 | Numer próbki w zestawie |
| Measurement (µm) | 1090.9 | Odczyt pojedynczej próbki |
| Min (µm) | 1088.4 | Minimum zestawu |
| Max (µm) | 1090.9 | Maksimum zestawu |
| Mean (µm) | 1089.4 | Średnia zestawu |
| StdDev (µm) | 0.990 | Odchylenie standardowe zestawu |
| Template | 10 | Format danych przyrządu |
| Device_ID | FTG38041012H | Numer seryjny / ID przyrządu |
| Test_Date | 2025-10-07 | Data badania (ISO 8601) |
| Calibration_Date | 2025-10-11 | Data ostatniej kalibracji |
| Test_Time | 11:03:56 | Czas badania |
| Sample_Count | 5 | Liczba próbek w zestawie |
| Timestamp | 2025-10-11T11:03:56Z | Kiedy COM Agent odebrał zestaw, w wybranym *Formacie czasu* |

> [!info] Własne wartości przyrządu *Test_Date* / *Test_Time* pochodzą z zegara urządzenia i nie mają strefy czasowej. Kolumna **Timestamp** to moment, w którym Twój komputer odebrał zestaw, więc odzwierciedla opcję *Format czasu* (UTC lub lokalny).

> [!info] Jeśli COM Agent odbierze dane, których nie rozpozna jako format uporządkowany, plik CSV zostanie pominięty dla tego pomiaru, a w dzienniku aktywności pojawi się stosowna informacja. Surowe wyjście **TXT** (jeśli jest włączone) jest zawsze zapisywane niezależnie od formatu.

[Dalej: wpisuj wartości do innej aplikacji](rhopoint-com-agent-keyboard-emulation.md)


---

# Emulacja klawiatury

Emulacja klawiatury pozwala COM Agent **wpisywać zmierzone wartości bezpośrednio do innego programu** — dokładnie tak, jakbyś wpisał je na klawiaturze. Jest to idealne rozwiązanie do wprowadzania odczytów do arkusza kalkulacyjnego, bazy danych kontroli jakości, ekranu ERP lub dowolnej innej aplikacji, bez kopiowania i wklejania.

Po ukończeniu pomiaru COM Agent wpisuje wybrane wartości do **tego okna i pola, które aktualnie ma fokus klawiatury**.

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

## Włączanie

Zaznacz **Emulacja klawiatury** w sekcji [Formaty wyjściowe](rhopoint-com-agent-output-formats.md). Poniżej pojawią się **Opcje klawiatury**.

## Wartości

Zaznacz jedną lub więcej wartości do wpisania. **Średnia** jest zaznaczona domyślnie.

| Wartość | Wpisuje |
| --- | --- |
| **Średnia** | Średnią zestawu pomiarowego |
| **Minimum** | Najmniejszy odczyt |
| **Maksimum** | Największy odczyt |
| **Odch. std.** | Odchylenie standardowe |
| **Pomiary** | Każdy pojedynczy odczyt próbki |
| **Surowe dane** | Kompletne surowe dane w postaci odebranej z przyrządu |

Gdy wybranych jest kilka wartości, są one wpisywane w kolejności pokazanej powyżej, każda oddzielona wybranym **Separatorem**.

## Separator i przyrostek

| Opcja | Przeznaczenie |
| --- | --- |
| **Separator** | Klawisz naciskany *między* wartościami (oraz między poszczególnymi pomiarami). Wybierz **Tab**, **Enter** lub **Brak**. |
| **Przyrostek** | Klawisz naciskany *po ostatniej* wartości. Wybierz **Tab**, **Enter** lub **Brak**. |

> [!info] Użyj **Tab**, aby przejść do następnej komórki lub pola, albo **Enter**, aby zatwierdzić wpis / przejść do następnego wiersza. Na przykład *Separator = Tab* i *Przyrostek = Enter* wypełnia wiersz komórek, a następnie przechodzi do kolejnego wiersza — idealne dla arkuszy kalkulacyjnych.

## Separator dziesiętny

Ustaw **Separator dziesiętny** tak, aby pasował do aplikacji docelowej — zazwyczaj kropka (`.`) dla ustawień regionalnych angielskich lub przecinek (`,`) dla ustawień niemieckich/francuskich.

## Opóźnienie klawiatury

**Opóźnienie klawiatury** ustawia krótką pauzę po każdym emulowanym naciśnięciu klawisza.

> [!warning] Jeśli wpisywane wartości docierają **zniekształcone lub z powtórzonymi znakami**, zwiększ Opóźnienie klawiatury. Niektóre aplikacje i komputery przyjmują wstrzykiwane naciśnięcia klawiszy wolniej niż inne. Zacznij od wartości domyślnej i zwiększaj ją (na przykład do 100 ms), aż wartości będą wyświetlane poprawnie. Ustawienie jest zapisywane dla każdego komputera osobno.

## Przykład

Z zaznaczonymi **Średnia** i **Minimum**, *Separator = Tab*, *Przyrostek = Enter*, wpisywanie do arkusza kalkulacyjnego daje:

```
1089.4 ⇥ 1088.4 ⏎
```

Średnia trafia do pierwszej komórki, minimum do następnej, a kursor przechodzi do kolejnego wiersza — gotowy do następnego pomiaru.

> [!info] Emulacja klawiatury nie zapisuje pliku. Aby zachować zapis *oraz* wpisywać wartości, zaznacz dodatkowo **Text** lub **CSV** w sekcji [Formaty wyjściowe](rhopoint-com-agent-output-formats.md).

[Dalej: przechwytuj pomiary](rhopoint-com-agent-capturing-measurements.md)


---

# Przechwytywanie pomiarów

Po skonfigurowaniu [połączenia](rhopoint-com-agent-connecting-an-instrument.md) i wybraniu [wyjścia](rhopoint-com-agent-output-formats.md) możesz rozpocząć przechwytywanie.

## Start i stop

Naciśnij **Start** (w prawym górnym rogu). COM Agent otwiera port szeregowy i rozpoczyna nasłuchiwanie. Przycisk zmienia się w **Stop**; naciśnij go, aby zakończyć sesję i zwolnić port.

Podczas trwania przechwytywania konfiguracja po lewej stronie jest **zablokowana**, aby nie można było jej zmienić w trakcie sesji.

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

## Panel na żywo

Prawa strona pokazuje, co dzieje się w czasie rzeczywistym:

| Element | Znaczenie |
| --- | --- |
| **Plakietka statusu** | **Bezczynny** przed rozpoczęciem, **Nasłuchiwanie** podczas przechwytywania, **Błąd** w razie niepowodzenia połączenia. |
| **Odebrane zestawy** | Bieżąca liczba kompletnych pomiarów przechwyconych w tej sesji. |
| **Ostatni pomiar** | Średnia, Minimum, Maksimum i Odch. std. najnowszego pomiaru (dla rozpoznanych formatów). |
| **Dziennik aktywności** | Przewijana lista zdarzeń: odebrane dane, zapisane pliki (z pełną ścieżką), wyjście klawiatury oraz wszelkie ostrzeżenia. Użyj przycisku **Wyczyść**, aby ją opróżnić. |

## Wykonywanie pomiaru

1. Naciśnij **Start** w COM Agent.
2. Wyzwól pomiar na przyrządzie w zwykły sposób.
3. W dzienniku aktywności pojawia się *„Receiving data…”*, a następnie ścieżka każdego zapisanego pliku lub wpis *„[Keyboard]”*, jeśli włączona jest emulacja klawiatury.
4. Licznik **Odebrane zestawy** zwiększa się, a **Ostatni pomiar** aktualizuje się.

> [!info] Każdy ukończony pomiar jest obsługiwany niezależnie — w jednej sesji możesz wykonać ich dowolną liczbę. Nie ma potrzeby zatrzymywania i ponownego uruchamiania między pomiarami.

> [!warning] Jeśli status zmieni się na **Błąd** (na przykład gdy kabel zostanie odłączony lub przyrząd wyłączony), zatrzymaj sesję, sprawdź połączenie i uruchom ponownie.

[Dalej: wypróbuj bez przyrządu](rhopoint-com-agent-demo-mode.md)


---

# Tryb demonstracyjny

Tryb demonstracyjny pozwala wypróbować COM Agent **bez podłączonego przyrządu**. Zamiast odczytywać dane z portu szeregowego, COM Agent na żądanie generuje realistyczny pomiar demonstracyjny — przydatny do nauki obsługi aplikacji, testowania folderu wyjściowego lub konfiguracji klawiatury albo do przeprowadzenia prezentacji.

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

## Korzystanie z trybu demonstracyjnego

1. Ustaw **Tryb** na **Demo** w sekcji Połączenie. Ustawienia portu COM i szybkości transmisji znikają — nie są potrzebne.
2. Wybierz [formaty wyjściowe](rhopoint-com-agent-output-formats.md) oraz, w razie potrzeby, [opcje klawiatury](rhopoint-com-agent-keyboard-emulation.md), dokładnie tak jak w trybie na żywo.
3. Naciśnij **Start**.
4. Naciśnij klawisz **prawy Alt** w dowolnym miejscu — nawet w innej aplikacji — aby wstawić pomiar demonstracyjny.

Każde naciśnięcie prawego Alt tworzy jeden kompletny pomiar demonstracyjny, który jest następnie zapisywany i/lub wpisywany zgodnie z ustawieniami wyjścia, dokładnie tak jak rzeczywisty odczyt.

> [!info] Tryb demonstracyjny to najszybszy sposób na sprawdzenie konfiguracji **emulacji klawiatury**: ustaw Tryb na Demo, włącz wyjście klawiatury, kliknij w arkusz kalkulacyjny, naciśnij Start i stuknij prawy Alt — wartości pojawią się w komórkach.

> [!info] Dane demonstracyjne używają formatu grubości FT3, więc działają z wyjściem CSV oraz wszystkimi wartościami klawiatury (Średnia, Min, Maks, Odch. std., Pomiary).

[Dalej: licencjonowanie](rhopoint-com-agent-licensing.md)


---

# Licencjonowanie

COM Agent potrzebuje ważnej licencji, aby **przechwytywać pomiary na żywo** z przyrządu. [Tryb demonstracyjny](rhopoint-com-agent-demo-mode.md) zawsze działa bez licencji, dzięki czemu możesz w dowolnym momencie poznać aplikację oraz przetestować konfigurację wyjścia i klawiatury.

Status licencji jest zawsze widoczny w prawym górnym rogu okna:

- Zielona plakietka **Aktywne licencje: N** oznacza, że przechwytywanie na żywo jest odblokowane.
- Czerwona plakietka **Brak aktywnych licencji** oznacza, że dostępny jest tylko tryb demonstracyjny.

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

## Jak działają licencje

Licencję COM Agent można powiązać na jeden z dwóch sposobów:

- **Z tym komputerem (identyfikator hosta)** — odblokowuje przechwytywanie na żywo na tym komputerze, dla dowolnego podłączonego przyrządu.
- **Z numerem seryjnym urządzenia** — odblokowuje tylko pomiary pochodzące z tego konkretnego przyrządu, na dowolnym komputerze. Użyj tej opcji, gdy licencja ma podążać za przyrządem, a nie za komputerem.

## Wnioskowanie o licencję

1. Kliknij plakietkę licencji (lub **Dodaj licencję**) w prawym górnym rogu, aby otworzyć **Menedżer licencji**.
2. Skopiuj swój **identyfikator hosta** za pomocą przycisku kopiowania obok niego. W przypadku licencji powiązanej z urządzeniem zanotuj zamiast tego numer seryjny przyrządu.
3. Wyślij identyfikator hosta (lub numer seryjny) do Rhopoint Instruments, aby uzyskać plik licencji.

> [!info] Identyfikator hosta identyfikuje ten konkretny komputer. Licencja powiązana z hostem odblokowuje przechwytywanie na żywo tylko na komputerze, dla którego identyfikatora hosta została wydana.

## Importowanie licencji

1. Otwórz **Menedżer licencji** i kliknij **Importuj licencję…**.
2. Wybierz otrzymany plik licencji (`.lic`, `.txt` lub `.json`). Możesz wybrać kilka plików jednocześnie.
3. Licencja pojawia się na liście, a plakietka zmienia kolor na zielony — przechwytywanie na żywo jest teraz odblokowane.

## Zarządzanie licencjami

Menedżer licencji wyświetla każdą zainstalowaną licencję wraz z:

- **Tym, z czym jest powiązana** — *Ten komputer*, *Numer seryjny urządzenia: …* lub *Dowolny komputer*.
- **Statusem i datą wygaśnięcia** — na przykład *Ważna · Wygasa 2027-01-31*.

Użyj ikony **kosza** obok licencji, aby ją usunąć.

> [!info] Licencja powiązana z numerem seryjnym urządzenia przetwarza tylko pomiary, których identyfikator urządzenia jest z nią zgodny. Inne przyrządy podłączone do tego samego komputera są ignorowane, chyba że również są licencjonowane.

> [!warning] Jeśli naciśniesz **Start**, aby rozpocząć przechwytywanie na żywo bez ważnej licencji, COM Agent wyświetli komunikat i nie uruchomi się. Zaimportuj licencję lub przełącz **Tryb** na **Demo**.

[Dalej: ustawienia i język](rhopoint-com-agent-settings-and-language.md)


---

# Ustawienia i język

## Twoje ustawienia są zapamiętywane

COM Agent zapisuje Twoją konfigurację automatycznie — tryb, port COM, szybkość transmisji, znacznik i liczbę części, folder wyjściowy, formaty wyjściowe oraz wszystkie opcje klawiatury. Przy następnym uruchomieniu aplikacji wszystko jest dokładnie tak, jak je pozostawiłeś, więc możesz po prostu nacisnąć **Start**.

Ustawienia są przechowywane osobno dla każdego użytkownika systemu Windows.

## Język

COM Agent jest dostępny w trzynastu językach: **angielski**, **czeski**, **niemiecki**, **hiszpański**, **francuski**, **włoski**, **niderlandzki**, **polski**, **portugalski**, **turecki**, **koreański**, **japoński** i **chiński**. Wybierz swój język z listy rozwijanej w lewym górnym rogu okna, obok logo. Interfejs przełącza się natychmiast, a Twój wybór jest zapamiętywany na następny raz.

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

[Dalej: uruchamianie z wiersza poleceń](rhopoint-com-agent-command-line-launch.md)


---

# Uruchamianie z wiersza poleceń

COM Agent można uruchomić wstępnie skonfigurowany z wiersza poleceń i natychmiast rozpocząć przechwytywanie. Jest to wygodne przy automatyzacji — uruchamianiu z innego programu, ze skrótu na pulpicie lub ze skryptu startowego z ustaloną konfiguracją.

Okno aplikacji nadal otwiera się normalnie; parametry po prostu wypełniają za Ciebie ustawienia, a przechwytywanie rozpoczyna się automatycznie.

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

## Opcje

Nazwy opcji odpowiadają ustawieniom w oknie. Każda pominięta opcja zachowuje swoją zapisaną wartość.

| Opcja | Wartości / przykład | Znaczenie |
| --- | --- | --- |
| `--mode` | `live` lub `demo` | Tryb przechwytywania. `demo` nie wymaga portu COM. |
| `--port` | `COM3` | Port szeregowy (wymagany do przechwytywania na żywo). |
| `--baud` | `19200` | Szybkość transmisji. |
| `--part-marker` | `^` | Znacznik rozgraniczający kompletny zestaw pomiarowy. |
| `--part-count` | `4` | Liczba części składających się na kompletny zestaw. |
| `--output` | `"C:\Data"` | Folder wyjściowy dla plików TXT/CSV. |
| `--file-extension` | `txt`, `csv`, `csv+txt`, `keyboard` | Format(y) wyjściowe; połącz kilka znakiem `+`. |
| `--csv-delimiter` | `comma`, `semicolon`, `tab` | Separator kolumn CSV. |
| `--csv-decimal` | `dot`, `comma` | Separator dziesiętny dla liczb w CSV. |
| `--csv-time-format` | `utc`, `local` | Format kolumny *Timestamp* w CSV. |
| `--csv-encoding` | `utf8`, `utf8-bom` | Kodowanie pliku CSV (ze znacznikiem kolejności bajtów lub bez niego). |
| `--keyboard-value` | `mean`, `min`, `max`, `stddev`, `measurements`, `raw` | Wartość(ci) do wpisania; połącz kilka znakiem `+`. |
| `--keyboard-separator` | `tab`, `enter`, `none` | Klawisz naciskany między wpisywanymi wartościami. |
| `--keyboard-suffix` | `tab`, `enter`, `none` | Klawisz naciskany po ostatniej wartości. |
| `--keyboard-decimal` | `.` lub `,` | Separator dziesiętny dla wpisywanych wartości. |
| `--keyboard-delay` | `40` | Pauza w milisekundach po każdym naciśnięciu klawisza. |
| `--start` | *(bez wartości)* | Uruchom z zapisanymi ustawieniami, gdy nie podano żadnych innych parametrów. |

Przechwytywanie rozpoczyna się automatycznie, gdy podany jest dowolny parametr (lub samo `--start`).

## Przykłady

Przechwytywanie z portu COM3 do plików CSV i TXT:

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

Wpisywanie średniej i minimum do aplikacji z fokusem, oddzielonych tabulatorem:

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

Uruchomienie w trybie demonstracyjnym (przyrząd nie jest potrzebny):

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

> [!info] Okno otwiera się jak zwykle, więc nadal możesz obserwować aktywność na żywo i zatrzymać przechwytywanie w dowolnym momencie. Ścieżki zawierające spacje ujmij w cudzysłów.

> [!warning] Przechwytywanie na żywo nadal wymaga ważnej [licencji](rhopoint-com-agent-licensing.md). Jeśli konfiguracja uruchomienia jest niekompletna lub nieprawidłowa (na przykład folder wyjściowy nie istnieje), COM Agent wyświetli ten sam komunikat, co przy ręcznym uruchomieniu.

[Dalej: utrzymywanie COM Agent w aktualnym stanie](rhopoint-com-agent-updating-com-agent.md)


---

# Aktualizacja COM Agent

COM Agent sam dba o swoją aktualność.

## Aktualizacje automatyczne

Po uruchomieniu COM Agent sprawdza w tle dostępność nowej wersji. Jeśli jest dostępna, w prawym górnym rogu okna pojawia się małe powiadomienie.

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

- Kliknij **Aktualizuj teraz**, aby pobrać i zainstalować aktualizację. COM Agent pobiera nową wersję, wyświetla pasek postępu, a następnie ponownie uruchamia się w nowej wersji.
- Kliknij **✕**, aby zamknąć powiadomienie i kontynuować pracę w bieżącej wersji. Przypomnienie pojawi się ponownie przy następnym uruchomieniu aplikacji.

> [!info] Aktualizacje są opcjonalne i są stosowane tylko wtedy, gdy się na nie zdecydujesz. COM Agent nigdy nie przerywa sesji przechwytywania w celu aktualizacji.

## Sprawdzanie wersji

Bieżąca wersja jest wyświetlana na pasku tytułu okna (na przykład *Rhopoint COM Agent 1.2.3*).