# Rhopoint COM Agent

> Section of the Rhopoint Instruments Manual.

This file bundles all 11 pages of this section as Markdown.

# Rhopoint COM Agent

O Rhopoint COM Agent é uma aplicação Windows que captura os dados de medição enviados através de uma ligação série (COM) pelos instrumentos Rhopoint — como o medidor de espessura de película FT3 — e os transforma em algo útil: ficheiros estruturados no disco, ou valores escritos diretamente noutro programa.

Sempre que o instrumento imprime um resultado, o COM Agent lê-o, reconhece o formato dos dados e escreve-o no formato que escolher: um ficheiro **TXT** em bruto, um ficheiro **CSV** estruturado, ou **emulando teclas** para que os valores apareçam diretamente no campo que tem o foco no momento (uma célula de folha de cálculo, uma base de dados de qualidade, um formulário ERP, …).

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

## O que pode fazer com o COM Agent

1. [Instalar o COM Agent](rhopoint-com-agent-install-com-agent.md) — transfira, instale e inicie a aplicação.
2. [Ligar um instrumento](rhopoint-com-agent-connecting-an-instrument.md) — escolha a porta COM e a taxa de transmissão e confirme que os dados estão a chegar.
3. [Formatos de saída](rhopoint-com-agent-output-formats.md) — escreva cada medição em ficheiros TXT e/ou CSV.
4. [Emulação de teclado](rhopoint-com-agent-keyboard-emulation.md) — escreva os valores medidos diretamente noutra aplicação, com separadores configuráveis.
5. [Capturar medições](rhopoint-com-agent-capturing-measurements.md) — inicie e pare a captura e acompanhe a atividade ao vivo.
6. [Modo de demonstração](rhopoint-com-agent-demo-mode.md) — experimente a aplicação sem nenhum instrumento ligado.
7. [Licenciamento](rhopoint-com-agent-licensing.md) — desbloqueie a captura ao vivo adicionando uma licença; o modo de demonstração funciona sempre sem ela.
8. [Definições e idioma](rhopoint-com-agent-settings-and-language.md) — a sua configuração é memorizada e a interface está disponível em treze idiomas.
9. [Arranque por linha de comandos](rhopoint-com-agent-command-line-launch.md) — inicie pré-configurado e capture automaticamente (para automação).
10. [Atualizar o COM Agent](rhopoint-com-agent-updating-com-agent.md) — mantenha a aplicação atualizada.

## Instrumentos suportados

O COM Agent lê a saída série dos instrumentos Rhopoint, incluindo:

- **FT3** Medidor de Espessura de Película

> [!info] O COM Agent fornece atualmente a análise estruturada (CSV) completa para o formato de espessura *"print all samples"* do FT3. Outros instrumentos são capturados como texto em bruto; a análise estruturada é adicionada à medida que os dados de amostra ficam disponíveis. A saída por teclado e TXT funciona para todos os instrumentos.

> [!info] O COM Agent funciona apenas em Windows. É distribuído como uma aplicação autónoma — não é necessária uma instalação separada do .NET — e mantém-se atualizado automaticamente.


---

# Instalar o COM Agent

O Rhopoint COM Agent é uma aplicação Windows leve. O instalador configura tudo o que ela necessita e mantém a aplicação atualizada automaticamente.

## Transferir

Transfira a versão mais recente do COM Agent a partir de [download.rhopointservice.net/com-agent](https://download.rhopointservice.net/com-agent).

## Instalação

1. Transfira o instalador do COM Agent a partir da ligação acima.
2. Faça duplo clique no instalador e siga as instruções no ecrã.
3. Inicie o **Rhopoint COM Agent** a partir do menu Iniciar.

> [!info] O COM Agent é autónomo — não requer uma instalação separada do tempo de execução do .NET. O instalador também verifica a existência de atualizações e instala-as automaticamente em segundo plano, para que execute sempre a versão mais recente.

## Requisitos do sistema

- **SO:** Windows 10 (compilação 19041 / 20H1) ou mais recente
- **CPU:** x64 ou ARM64
- **Uma porta série (COM) livre** — quer uma porta integrada quer um adaptador USB para série — para ligar o seu instrumento. Alguns instrumentos requerem um cabo especial (consulte [a visão geral](rhopoint-com-agent.md)).

## Primeiro arranque

Quando o COM Agent arranca, a janela principal está dividida em duas áreas:

- À **esquerda**, a configuração: definições de ligação e opções de saída.
- À **direita**, a atividade ao vivo: o estado, o número de medições recebidas, a última medição e um registo de atividade.

O botão **Iniciar / Parar** situa-se no canto superior direito, acima do contador de medições, e está sempre visível.

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

[Seguinte: ligar o seu instrumento](rhopoint-com-agent-connecting-an-instrument.md)


---

# Ligar um instrumento

No modo **Ao vivo**, o COM Agent lê os dados de medição diretamente de um instrumento através de uma ligação série (COM).

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

## 1. Ligar o equipamento

1. Ligue o instrumento ao PC utilizando o seu cabo série ou adaptador USB para série. Alguns instrumentos (CBT1.2, NovoHaze TX) requerem um cabo especial — consulte a [visão geral](rhopoint-com-agent.md).
2. Ligue o instrumento.

## 2. Escolher as definições de ligação

Na secção **Ligação** à esquerda:

| Definição | Descrição |
| --- | --- |
| **Modo** | Defina como **Ao vivo** para ler de uma porta série. (Utilize **Demonstração** para experimentar a aplicação sem equipamento — consulte [Modo de demonstração](rhopoint-com-agent-demo-mode.md).) |
| **Porta COM** | Selecione a porta à qual o seu instrumento está ligado. Clique no botão **atualizar** para reanalisar as portas depois de ligar um adaptador. |
| **Taxa de transmissão** | A velocidade série. O valor predefinido para os instrumentos Rhopoint é **19200**. |
| **Marcador de parte** | O carácter que o instrumento imprime para marcar cada parte de um conjunto de dados completo. O valor predefinido é **^**. |
| **Número de partes** | Quantos marcadores de parte compõem um conjunto de dados completo. O valor predefinido é **4**. |

> [!info] O **Marcador de parte** e o **Número de partes** indicam ao COM Agent quando uma medição está completa. Um conjunto de dados só é escrito depois de o número esperado de marcadores ter sido recebido e a linha terminar — isto evita que medições recebidas parcialmente sejam guardadas. Os valores predefinidos correspondem aos instrumentos Rhopoint; só os deve alterar se for aconselhado pelo Suporte Rhopoint.

## 3. Escolher o que fazer com os dados

Decida como cada medição deve ser guardada ou reencaminhada:

- Escrever ficheiros — consulte [Formatos de saída](rhopoint-com-agent-output-formats.md).
- Escrever valores noutra aplicação — consulte [Emulação de teclado](rhopoint-com-agent-keyboard-emulation.md).

Pode combinar estas opções (por exemplo, escrever um ficheiro CSV *e* escrever a média numa folha de cálculo).

## 4. Iniciar a captura

Prima **Iniciar** (canto superior direito) e faça uma medição no instrumento. O registo de atividade à direita confirma que os dados estão a chegar. Consulte [Capturar medições](rhopoint-com-agent-capturing-measurements.md) para mais detalhes.

> [!warning] Se a porta COM selecionada não puder ser aberta (por exemplo, porque outro programa já a está a utilizar), o COM Agent mostra um erro. Feche o outro programa ou escolha uma porta diferente e tente novamente.

[Seguinte: escolher o seu formato de saída](rhopoint-com-agent-output-formats.md)


---

# Formatos de saída

O COM Agent pode escrever cada medição concluída num ficheiro. Escolha uma **Pasta de saída** e assinale um ou mais **Formatos de saída**. Os formatos podem ser combinados livremente.

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

## Pasta de saída

Clique em **Procurar…** junto a *Pasta de saída* e escolha onde os ficheiros devem ser escritos. Cada medição cria um novo ficheiro com um nome único e com data/hora, pelo que nada é alguma vez substituído:

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

O nome contém a data/hora UTC, um contador sequencial e um identificador único.

## Formatos

| Formato | O que produz |
| --- | --- |
| **Ficheiro de texto (.txt)** | Os dados em bruto exatamente como recebidos do instrumento, sem qualquer processamento. Funciona para todos os instrumentos. |
| **Ficheiro CSV (.csv)** | Um ficheiro de folha de cálculo estruturado com colunas nomeadas e unidades métricas. Requer um formato de dados reconhecido (atualmente o formato de espessura *"print all samples"* do FT3). |
| **Emulação de teclado** | Escreve os valores noutra aplicação em vez de criar um ficheiro — consulte [Emulação de teclado](rhopoint-com-agent-keyboard-emulation.md). |

> [!info] Pode ativar vários formatos ao mesmo tempo. Por exemplo, assinale **Texto** e **CSV** para manter um arquivo em bruto juntamente com um ficheiro estruturado, ou assinale **CSV** e **Teclado** para arquivar os dados *e* escrever um valor no seu sistema de qualidade.

## Opções de exportação CSV

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

Quando o **CSV** está ativado, surge um painel **Opções de CSV** com quatro definições que controlam a forma como o ficheiro é escrito. O COM Agent escolhe valores predefinidos sensatos com base no seu idioma e região, pelo que, na maioria dos casos, pode deixá-los como estão.

| Opção | Escolhas | Efeito |
| --- | --- | --- |
| **Delimitador** | Vírgula "," · Ponto e vírgula ";" · Tabulação "→" | O carácter colocado entre as colunas. |
| **Formato de hora** | ISO 8601, UTC · ISO 8601, local | Formato da coluna *Timestamp*: UTC (p. ex. `2025-10-11T11:03:56Z`) ou hora local com desvio (p. ex. `2025-10-11T13:03:56+02:00`). |
| **Separador decimal** | Ponto "." · Vírgula "," | O sinal decimal utilizado nos valores numéricos. As datas e os identificadores nunca são alterados. |
| **Codificação do ficheiro** | UTF-8 · UTF-8 com BOM | Se é escrita uma marca de ordem de bytes no início do ficheiro. Uma BOM ajuda alguns programas de folha de cálculo (por exemplo o Excel) a detetar o UTF-8 e a mostrar corretamente os cabeçalhos em µm. |

> [!tip] O **Delimitador** e o **Separador decimal** assumem por predefinição a convenção da sua região: as regiões que separam os valores de uma lista com um ponto e vírgula (a maior parte da Europa) começam com **ponto e vírgula + vírgula decimal**, as restantes (por exemplo o inglês) com **vírgula + ponto decimal**. Isto permite que o ficheiro abra corretamente com um duplo clique no seu programa de folha de cálculo local. Depois de alterar uma definição, a sua escolha é memorizada.

## Estrutura do CSV

Para o formato de espessura do FT3, o COM Agent produz uma linha por cada amostra individual, juntamente com as estatísticas de resumo e os metadados do instrumento. As unidades são indicadas em micrómetros (µm).

| Coluna | Exemplo | Significado |
| --- | --- | --- |
| Index | 1 | Número da amostra dentro do conjunto |
| Measurement (µm) | 1090.9 | A leitura da amostra individual |
| Min (µm) | 1088.4 | Mínimo do conjunto |
| Max (µm) | 1090.9 | Máximo do conjunto |
| Mean (µm) | 1089.4 | Média do conjunto |
| StdDev (µm) | 0.990 | Desvio padrão do conjunto |
| Template | 10 | O formato de dados do instrumento |
| Device_ID | FTG38041012H | Número de série / ID do instrumento |
| Test_Date | 2025-10-07 | Data do ensaio (ISO 8601) |
| Calibration_Date | 2025-10-11 | Data da última calibração |
| Test_Time | 11:03:56 | Hora do ensaio |
| Sample_Count | 5 | Número de amostras no conjunto |
| Timestamp | 2025-10-11T11:03:56Z | Quando o COM Agent recebeu o conjunto, no *Formato de hora* escolhido |

> [!info] Os valores próprios do instrumento *Test_Date* / *Test_Time* provêm do relógio do dispositivo e não têm fuso horário. A coluna **Timestamp** é o momento em que o seu PC recebeu o conjunto, pelo que reflete a opção *Formato de hora* (UTC ou local).

> [!info] Se o COM Agent receber dados que não reconheça como um formato estruturado, o ficheiro CSV é ignorado para essa medição e surge uma nota no registo de atividade. A saída **TXT** em bruto (se ativada) é sempre escrita, independentemente do formato.

[Seguinte: escrever valores noutra aplicação](rhopoint-com-agent-keyboard-emulation.md)


---

# Emulação de teclado

A emulação de teclado permite ao COM Agent **escrever os valores medidos diretamente noutro programa** — exatamente como se os tivesse escrito no teclado. Isto é ideal para introduzir leituras numa folha de cálculo, numa base de dados de qualidade, num ecrã ERP ou em qualquer outra aplicação, sem copiar e colar.

Quando uma medição é concluída, o COM Agent escreve o(s) valor(es) selecionado(s) na **janela e no campo que tiverem o foco do teclado no momento**.

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

## Ativá-la

Assinale **Emulação de teclado** em [Formatos de saída](rhopoint-com-agent-output-formats.md). As **Opções de teclado** aparecem por baixo.

## Valores

Assinale um ou mais valores a escrever. A **Média** está selecionada por predefinição.

| Valor | Escreve |
| --- | --- |
| **Média** | A média do conjunto de medições |
| **Mínimo** | A menor leitura |
| **Máximo** | A maior leitura |
| **Desvio padrão** | O desvio padrão |
| **Medições** | Cada leitura de amostra individual |
| **Em bruto** | Os dados completos em bruto, tal como recebidos do instrumento |

Quando estão selecionados vários valores, estes são escritos pela ordem apresentada acima, cada um separado pelo **Separador** escolhido.

## Separador e sufixo

| Opção | Finalidade |
| --- | --- |
| **Separador** | A tecla premida *entre* valores (e entre medições individuais). Escolha **Tab**, **Enter** ou **Nenhum**. |
| **Sufixo** | A tecla premida *após o último* valor. Escolha **Tab**, **Enter** ou **Nenhum**. |

> [!info] Utilize **Tab** para passar para a célula ou campo seguinte, ou **Enter** para confirmar uma entrada / passar para a linha seguinte. Por exemplo, *Separador = Tab* e *Sufixo = Enter* preenche uma linha de células e passa depois para a linha seguinte — perfeito para folhas de cálculo.

## Separador decimal

Defina o **Separador decimal** para corresponder à aplicação de destino — normalmente um ponto final (`.`) para localizações inglesas ou uma vírgula (`,`) para localizações alemãs/francesas.

## Atraso do teclado

O **Atraso do teclado** define uma breve pausa após cada tecla emulada.

> [!warning] Se os valores escritos chegarem **corrompidos ou com caracteres repetidos**, aumente o Atraso do teclado. Algumas aplicações e PCs aceitam as teclas injetadas mais lentamente do que outras. Comece com o valor predefinido e aumente-o (por exemplo, para 100 ms) até os valores aparecerem corretamente. A definição é guardada por PC.

## Exemplo

Com **Média** e **Mínimo** selecionados, *Separador = Tab*, *Sufixo = Enter*, escrever numa folha de cálculo produz:

```
1089.4 ⇥ 1088.4 ⏎
```

A média fica na primeira célula, o mínimo na seguinte, e o cursor passa para a linha seguinte — pronto para a próxima medição.

> [!info] A emulação de teclado não cria um ficheiro. Para manter um registo *e* escrever valores, assinale também **Texto** ou **CSV** em [Formatos de saída](rhopoint-com-agent-output-formats.md).

[Seguinte: capturar medições](rhopoint-com-agent-capturing-measurements.md)


---

# Capturar medições

Depois de configurar a [ligação](rhopoint-com-agent-connecting-an-instrument.md) e de escolher a sua [saída](rhopoint-com-agent-output-formats.md), está pronto para capturar.

## Iniciar e parar

Prima **Iniciar** (canto superior direito). O COM Agent abre a porta série e começa a escutar. O botão transforma-se em **Parar**; prima-o para terminar a sessão e libertar a porta.

Enquanto a captura está em curso, a configuração à esquerda fica **bloqueada** para que não possa ser alterada a meio da sessão.

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

## O painel ao vivo

O lado direito mostra o que está a acontecer em tempo real:

| Elemento | Significado |
| --- | --- |
| **Distintivo de estado** | **Inativo** antes de iniciar, **A escutar** durante a captura, **Erro** se a ligação falhar. |
| **Conjuntos recebidos** | Uma contagem corrente das medições completas capturadas nesta sessão. |
| **Última medição** | A Média, o Mínimo, o Máximo e o Desvio padrão da medição mais recente (para formatos reconhecidos). |
| **Registo de atividade** | Uma lista deslizante de eventos: dados recebidos, ficheiros escritos (com o seu caminho completo), saída por teclado e quaisquer avisos. Utilize **Limpar** para o esvaziar. |

## Fazer uma medição

1. Prima **Iniciar** no COM Agent.
2. Acione uma medição no instrumento como faria normalmente.
3. O registo de atividade mostra *"A receber dados…"* seguido do caminho de cada ficheiro escrito, ou uma entrada *"[Teclado]"* se a emulação de teclado estiver ativada.
4. O contador **Conjuntos recebidos** aumenta e a **Última medição** é atualizada.

> [!info] Cada medição concluída é tratada de forma independente — pode fazer tantas quantas quiser numa sessão. Não é necessário parar e iniciar entre medições.

> [!warning] Se o estado mudar para **Erro** (por exemplo, o cabo é desligado ou o instrumento está desligado), pare a sessão, verifique a ligação e inicie novamente.

[Seguinte: experimentar sem um instrumento](rhopoint-com-agent-demo-mode.md)


---

# Modo de demonstração

O modo de demonstração permite-lhe experimentar o COM Agent **sem nenhum instrumento ligado**. Em vez de ler de uma porta série, o COM Agent gera uma medição de demonstração realista a pedido — útil para aprender a aplicação, testar a sua pasta de saída ou a configuração de teclado, ou fazer uma demonstração.

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

## Utilizar o modo de demonstração

1. Defina o **Modo** como **Demonstração** na secção Ligação. As definições de porta COM e de taxa de transmissão desaparecem — não são necessárias.
2. Escolha os seus [formatos de saída](rhopoint-com-agent-output-formats.md) e, se desejar, as [opções de teclado](rhopoint-com-agent-keyboard-emulation.md), exatamente como no modo ao vivo.
3. Prima **Iniciar**.
4. Prima a tecla **Alt Direito** em qualquer lugar — mesmo noutra aplicação — para injetar uma medição de demonstração.

Cada pressão de Alt Direito produz uma medição de demonstração completa, que é depois escrita e/ou digitada de acordo com as suas definições de saída, tal como uma leitura real.

> [!info] O modo de demonstração é a forma mais rápida de verificar a configuração da sua **emulação de teclado**: defina o Modo como Demonstração, ative a saída por teclado, clique numa folha de cálculo, prima Iniciar e toque em Alt Direito — os valores aparecem nas células.

> [!info] Os dados de demonstração utilizam o formato de espessura do FT3, pelo que funcionam com a saída CSV e com todos os valores de teclado (Média, Mín, Máx, Desvio padrão, Medições).

[Seguinte: licenciamento](rhopoint-com-agent-licensing.md)


---

# Licenciamento

O COM Agent precisa de uma licença válida para **capturar medições ao vivo** de um instrumento. O [Modo de demonstração](rhopoint-com-agent-demo-mode.md) funciona sempre sem uma licença, pelo que pode explorar a aplicação e testar a sua configuração de saída e de teclado a qualquer momento.

O estado da sua licença está sempre visível no canto superior direito da janela:

- Um distintivo verde **Licenças ativas: N** significa que a captura ao vivo está desbloqueada.
- Um distintivo vermelho **Nenhuma licença ativa** significa que apenas o modo de demonstração está disponível.

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

## Como funcionam as licenças

Uma licença do COM Agent pode estar vinculada de uma de duas formas:

- **A este computador (ID do anfitrião)** — desbloqueia a captura ao vivo neste PC, para qualquer instrumento ligado.
- **A um número de série de dispositivo** — desbloqueia apenas as medições provenientes desse instrumento específico, em qualquer PC. Utilize esta opção quando uma licença deve acompanhar um instrumento em vez de um computador.

## Solicitar uma licença

1. Clique no distintivo de licença (ou em **Adicionar licença**) no canto superior direito para abrir o **Gestor de licenças**.
2. Copie o seu **ID do anfitrião** com o botão de cópia ao lado. Para uma licença vinculada a um dispositivo, anote antes o número de série do seu instrumento.
3. Envie o ID do anfitrião (ou o número de série) à Rhopoint Instruments para obter o seu ficheiro de licença.

> [!info] O ID do anfitrião identifica este computador específico. Uma licença vinculada ao anfitrião apenas desbloqueia a captura ao vivo na máquina cujo ID do anfitrião foi emitido.

## Importar uma licença

1. Abra o **Gestor de licenças** e clique em **Importar licença…**.
2. Selecione o ficheiro de licença que recebeu (`.lic`, `.txt` ou `.json`). Pode selecionar vários ficheiros ao mesmo tempo.
3. A licença aparece na lista e o distintivo fica verde — a captura ao vivo está agora desbloqueada.

## Gerir licenças

O Gestor de licenças apresenta todas as licenças instaladas com:

- **A que está vinculada** — *Esta máquina*, *Número de série do dispositivo: …*, ou *Qualquer máquina*.
- **O seu estado e validade** — por exemplo *Válida · Expira a 2027-01-31*.

Utilize o ícone do **caixote do lixo** ao lado de uma licença para a remover.

> [!info] Uma licença vinculada a um número de série de dispositivo apenas processa as medições cujo ID do dispositivo lhe corresponda. Outros instrumentos ligados ao mesmo PC são ignorados, a menos que também estejam licenciados.

> [!warning] Se premir **Iniciar** para a captura ao vivo sem uma licença válida, o COM Agent mostra uma mensagem e não inicia. Importe uma licença ou mude o **Modo** para **Demonstração**.

[Seguinte: definições e idioma](rhopoint-com-agent-settings-and-language.md)


---

# Definições e idioma

## As suas definições são memorizadas

O COM Agent guarda a sua configuração automaticamente — modo, porta COM, taxa de transmissão, marcador e número de partes, pasta de saída, formatos de saída e todas as opções de teclado. Da próxima vez que iniciar a aplicação, está tudo exatamente como o deixou, pelo que pode simplesmente premir **Iniciar**.

As definições são guardadas por utilizador do Windows.

## Idioma

O COM Agent está disponível em treze idiomas: **Inglês**, **Checo**, **Alemão**, **Espanhol**, **Francês**, **Italiano**, **Neerlandês**, **Polaco**, **Português**, **Turco**, **Coreano**, **Japonês** e **Chinês**. Escolha o seu idioma a partir da lista pendente no canto superior esquerdo da janela, junto ao logótipo. A interface muda imediatamente e a sua escolha é memorizada para a próxima vez.

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

[Seguinte: arranque por linha de comandos](rhopoint-com-agent-command-line-launch.md)


---

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


---

# Atualizar o COM Agent

O COM Agent mantém-se atualizado automaticamente.

## Atualizações automáticas

Quando o COM Agent arranca, verifica a existência de uma nova versão em segundo plano. Se houver uma disponível, surge uma pequena notificação no canto superior direito da janela.

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

- Clique em **Atualizar agora** para transferir e instalar a atualização. O COM Agent transfere a nova versão, mostra uma barra de progresso e reinicia-se na nova versão.
- Clique no **✕** para ignorar a notificação e continuar a trabalhar na versão atual. Será relembrado novamente da próxima vez que iniciar a aplicação.

> [!info] As atualizações são opcionais e só são aplicadas quando o decidir. O COM Agent nunca interrompe uma sessão de captura para atualizar.

## Verificar a sua versão

A versão atual é mostrada na barra de título da janela (por exemplo *Rhopoint COM Agent 1.2.3*).