# 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)