# Arranque por linha de comandos

O COM Agent pode ser iniciado pré-configurado a partir da linha de comandos e começar a capturar imediatamente. Isto é prático para automação — iniciá-lo a partir de outro programa, de um atalho no ambiente de trabalho ou de um script de arranque com uma configuração fixa.

A janela da aplicação continua a abrir-se normalmente; os parâmetros limitam-se a preencher as definições por si e a captura inicia automaticamente.

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

## Opções

Os nomes das opções correspondem às definições na janela. Qualquer opção que omitir mantém o seu valor guardado.

| Opção | Valores / exemplo | Significado |
| --- | --- | --- |
| `--mode` | `live` ou `demo` | Modo de captura. `demo` não necessita de porta COM. |
| `--port` | `COM3` | Porta série (obrigatória para a captura ao vivo). |
| `--baud` | `19200` | Taxa de transmissão. |
| `--part-marker` | `^` | Marcador que delimita um conjunto de medições completo. |
| `--part-count` | `4` | Número de partes que compõem um conjunto completo. |
| `--output` | `"C:\Data"` | Pasta de saída para os ficheiros TXT/CSV. |
| `--file-extension` | `txt`, `csv`, `csv+txt`, `keyboard` | Formato(s) de saída; combine vários com `+`. |
| `--csv-delimiter` | `comma`, `semicolon`, `tab` | Delimitador de colunas CSV. |
| `--csv-decimal` | `dot`, `comma` | Separador decimal para os números CSV. |
| `--csv-time-format` | `utc`, `local` | Formato da coluna *Timestamp* do CSV. |
| `--csv-encoding` | `utf8`, `utf8-bom` | Codificação do ficheiro CSV (com ou sem marca de ordem de bytes). |
| `--keyboard-value` | `mean`, `min`, `max`, `stddev`, `measurements`, `raw` | Valor(es) a escrever; combine vários com `+`. |
| `--keyboard-separator` | `tab`, `enter`, `none` | Tecla premida entre os valores escritos. |
| `--keyboard-suffix` | `tab`, `enter`, `none` | Tecla premida após o último valor. |
| `--keyboard-decimal` | `.` ou `,` | Separador decimal para os valores escritos. |
| `--keyboard-delay` | `40` | Pausa em milissegundos após cada tecla. |
| `--start` | *(sem valor)* | Inicia com as definições guardadas quando não são indicados outros parâmetros. |

A captura inicia automaticamente sempre que for indicado algum parâmetro (ou `--start` isoladamente).

## Exemplos

Capturar da COM3 para ficheiros CSV e TXT:

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

Escrever a média e o mínimo na aplicação com foco, separados por tabulação:

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

Iniciar em modo de demonstração (não é necessário nenhum instrumento):

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

> [!info] A janela abre-se normalmente, pelo que pode continuar a acompanhar a atividade ao vivo e parar a captura a qualquer momento. Coloque aspas em torno dos caminhos que contenham espaços.

> [!warning] A captura ao vivo continua a exigir uma [licença](rhopoint-com-agent-licensing.md) válida. Se a configuração de arranque estiver incompleta ou inválida (por exemplo, a pasta de saída não existe), o COM Agent mostra a mesma mensagem que mostraria num arranque manual.

[Seguinte: manter o COM Agent atualizado](rhopoint-com-agent-updating-com-agent.md)