# 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 是一款 Windows 应用程序，可捕获 Rhopoint 仪器通过串行（COM）连接发送的测量数据（例如 FT3 膜厚仪），并将其转换为实用的形式：保存到磁盘上的结构化文件，或直接键入到另一个程序中的数值。

每当仪器输出一个结果时，COM Agent 都会读取该结果、识别其数据格式，并按您选择的格式将其写出：原始 **TXT** 文件、结构化 **CSV** 文件，或通过**模拟按键**让数值直接出现在当前获得焦点的字段中（电子表格单元格、QA 数据库、ERP 表单……）。

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

## 您可以用 COM Agent 做什么

1. [安装 COM Agent](rhopoint-com-agent-install-com-agent.md) — 下载、安装并启动应用程序。
2. [连接仪器](rhopoint-com-agent-connecting-an-instrument.md) — 选择 COM 端口和波特率，并确认数据正在到达。
3. [输出格式](rhopoint-com-agent-output-formats.md) — 将每次测量写入 TXT 和/或 CSV 文件。
4. [键盘模拟](rhopoint-com-agent-keyboard-emulation.md) — 将测量值直接键入另一个应用程序，并可配置分隔符。
5. [采集测量](rhopoint-com-agent-capturing-measurements.md) — 开始和停止采集，并实时跟踪活动。
6. [演示模式](rhopoint-com-agent-demo-mode.md) — 在未连接仪器的情况下试用应用程序。
7. [许可](rhopoint-com-agent-licensing.md) — 通过添加许可证解锁实时采集；演示模式无需许可证即可始终使用。
8. [设置与语言](rhopoint-com-agent-settings-and-language.md) — 您的配置会被记住，界面提供十三种语言。
9. [命令行启动](rhopoint-com-agent-command-line-launch.md) — 以预配置方式启动并自动采集（用于自动化）。
10. [更新 COM Agent](rhopoint-com-agent-updating-com-agent.md) — 保持应用程序为最新版本。

## 支持的仪器

COM Agent 可读取 Rhopoint 仪器的串行输出，包括：

- **FT3** 膜厚仪

> [!info] COM Agent 目前为 FT3 *“打印所有样本”* 厚度格式提供完整的结构化（CSV）解析。其他仪器以原始文本形式捕获；随着样本数据的可用，将逐步添加结构化解析。键盘和 TXT 输出适用于所有仪器。

> [!info] COM Agent 仅在 Windows 上运行。它以自包含应用程序的形式分发——无需单独安装 .NET——并会自动保持自身为最新版本。


---

# 安装 COM Agent

Rhopoint COM Agent 是一款轻量级的 Windows 应用程序。安装程序会配置好它所需的一切，并自动保持应用程序为最新版本。

## 下载

请从 [download.rhopointservice.net/com-agent](https://download.rhopointservice.net/com-agent) 下载最新版本的 COM Agent。

## 安装

1. 从上方链接下载 COM Agent 安装程序。
2. 双击安装程序并按照屏幕上的说明操作。
3. 从开始菜单启动 **Rhopoint COM Agent**。

> [!info] COM Agent 是自包含的——无需单独安装 .NET 运行时。安装程序还会检查更新并在后台自动安装，因此您始终运行最新版本。

## 系统要求

- **操作系统：** Windows 10（内部版本 19041 / 20H1）或更高版本
- **CPU：** x64 或 ARM64
- **一个空闲的串行（COM）端口** — 内置端口或 USB 转串口适配器均可 — 用于连接仪器。某些仪器需要专用线缆（请参阅[概述](rhopoint-com-agent.md)）。

## 首次启动

COM Agent 启动时，主窗口分为两个区域：

- **左侧**为配置：连接设置和输出选项。
- **右侧**为实时活动：状态、已接收测量的数量、最近一次测量以及活动日志。

**开始 / 停止**按钮位于右上角、测量计数器上方，并始终可见。

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

[下一步：连接您的仪器](rhopoint-com-agent-connecting-an-instrument.md)


---

# 连接仪器

在**实时**模式下，COM Agent 通过串行（COM）连接直接从仪器读取测量数据。

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

## 1. 连接硬件

1. 使用串行线缆或 USB 转串口适配器将仪器连接到 PC。某些仪器（CBT1.2、NovoHaze TX）需要专用线缆——请参阅[概述](rhopoint-com-agent.md)。
2. 打开仪器电源。

## 2. 选择连接设置

在左侧的**连接**部分：

| 设置 | 说明 |
| --- | --- |
| **模式** | 设置为**实时**以从串行端口读取。（使用**演示**可在无硬件的情况下试用应用程序——参见 [演示模式](rhopoint-com-agent-demo-mode.md)。） |
| **COM 端口** | 选择仪器所连接的端口。插入适配器后，单击**刷新**按钮可重新扫描端口。 |
| **波特率** | 串行速率。Rhopoint 仪器的默认值为 **19200**。 |
| **分段标记** | 仪器用来标记完整数据组中每一段的字符。默认值为 **^**。 |
| **分段数量** | 构成一个完整数据组的分段标记数量。默认值为 **4**。 |

> [!info] **分段标记**和**分段数量**告知 COM Agent 何时一次测量已完成。只有在接收到预期数量的标记且该行结束后，数据组才会被写出——这可防止保存仅接收一半的测量。默认值与 Rhopoint 仪器匹配；仅在 Rhopoint 技术支持建议时才进行更改。

## 3. 选择如何处理数据

决定每次测量应如何保存或转发：

- 写入文件——参见 [输出格式](rhopoint-com-agent-output-formats.md)。
- 将数值键入另一个应用程序——参见 [键盘模拟](rhopoint-com-agent-keyboard-emulation.md)。

您可以组合使用这些方式（例如，写入 CSV 文件*并*将平均值键入电子表格）。

## 4. 开始采集

按**开始**（右上角）并在仪器上进行一次测量。右侧的活动日志会确认数据正在到达。详情参见 [采集测量](rhopoint-com-agent-capturing-measurements.md)。

> [!warning] 如果所选 COM 端口无法打开（例如，因为另一个程序正在使用它），COM Agent 会显示错误。请关闭该程序或选择其他端口，然后重试。

[下一步：选择您的输出格式](rhopoint-com-agent-output-formats.md)


---

# 输出格式

COM Agent 可将每次完成的测量写入文件。请选择一个**输出文件夹**并勾选一种或多种**输出格式**。这些格式可以自由组合。

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

## 输出文件夹

单击*输出文件夹*旁边的**浏览…**，选择文件的写入位置。每次测量都会创建一个具有唯一时间戳名称的新文件，因此不会覆盖任何内容：

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

该名称包含 UTC 时间戳、一个递增计数器和一个唯一标识符。

## 格式

| 格式 | 产生的内容 |
| --- | --- |
| **文本文件 (.txt)** | 完全按照从仪器接收到的原始数据，不做任何处理。适用于所有仪器。 |
| **CSV 文件 (.csv)** | 带有命名列和公制单位的结构化电子表格文件。需要可识别的数据格式（目前为 FT3 *“打印所有样本”* 厚度格式）。 |
| **键盘模拟** | 将数值键入另一个应用程序，而不是写入文件——参见 [键盘模拟](rhopoint-com-agent-keyboard-emulation.md)。 |

> [!info] 您可以同时启用多种格式。例如，勾选**文本**和 **CSV**，在保留原始存档的同时保存结构化文件；或勾选 **CSV** 和**键盘**，将数据归档*并*将某个值键入您的 QA 系统。

## CSV 导出选项

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

启用 **CSV** 后，会出现一个 **CSV 选项** 面板，其中有四项设置用于控制文件的写入方式。COM Agent 会根据您的语言和地区选择合理的默认值，因此在大多数情况下您可以保持不变。

| 选项 | 可选项 | 效果 |
| --- | --- | --- |
| **分隔符** | 逗号 "," · 分号 ";" · 制表符 "→" | 放置在列之间的字符。 |
| **时间格式** | ISO 8601, UTC · ISO 8601, 本地 | *Timestamp* 列的格式：UTC（例如 `2025-10-11T11:03:56Z`）或带偏移量的本地时间（例如 `2025-10-11T13:03:56+02:00`）。 |
| **小数分隔符** | 句点 "." · 逗号 "," | 用于数值的小数记号。日期和标识符永远不会更改。 |
| **文件编码** | UTF-8 · UTF-8（带 BOM） | 是否在文件开头写入字节顺序标记。BOM 可帮助某些电子表格程序（例如 Excel）检测 UTF-8 并正确显示 µm 表头。 |

> [!tip] **分隔符** 和 **小数分隔符** 默认采用您所在地区的惯例：以分号分隔列表值的地区（欧洲大部分地区）以 **分号 + 逗号小数** 开始，其他地区（例如英语）以 **逗号 + 句点小数** 开始。这样，文件便可在您本地的电子表格程序中双击顺利打开。更改设置后，系统会记住您的选择。

## CSV 结构

对于 FT3 厚度格式，COM Agent 为每个单独样本生成一行，并附带汇总统计数据和仪器元数据。单位以微米（µm）表示。

| 列 | 示例 | 含义 |
| --- | --- | --- |
| Index | 1 | 数据组中的样本编号 |
| Measurement (µm) | 1090.9 | 单个样本读数 |
| Min (µm) | 1088.4 | 数据组的最小值 |
| Max (µm) | 1090.9 | 数据组的最大值 |
| Mean (µm) | 1089.4 | 数据组的平均值 |
| StdDev (µm) | 0.990 | 数据组的标准差 |
| Template | 10 | 仪器数据格式 |
| Device_ID | FTG38041012H | 仪器序列号 / ID |
| Test_Date | 2025-10-07 | 测试日期（ISO 8601） |
| Calibration_Date | 2025-10-11 | 上次校准日期 |
| Test_Time | 11:03:56 | 测试时间 |
| Sample_Count | 5 | 数据组中的样本数量 |
| Timestamp | 2025-10-11T11:03:56Z | COM Agent 接收该数据组的时刻，以所选的*时间格式*表示 |

> [!info] 仪器自身的 *Test_Date* / *Test_Time* 来自设备时钟，没有时区。**Timestamp** 列是您的 PC 接收该数据组的时刻，因此会反映*时间格式*选项（UTC 或本地）。

> [!info] 如果 COM Agent 接收到无法识别为结构化格式的数据，则该次测量会跳过 CSV 文件，并在活动日志中出现提示。无论格式如何，原始 **TXT** 输出（如已启用）始终会被写入。

[下一步：将数值键入另一个应用程序](rhopoint-com-agent-keyboard-emulation.md)


---

# 键盘模拟

键盘模拟可让 COM Agent **将测量值直接键入另一个程序**——就像您亲自在键盘上输入一样。这非常适合将读数录入电子表格、QA 数据库、ERP 界面或任何其他应用程序，而无需复制和粘贴。

当一次测量完成时，COM Agent 会将所选的值键入到**当前获得键盘焦点的窗口和字段中**。

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

## 启用它

在 [输出格式](rhopoint-com-agent-output-formats.md) 下勾选**键盘模拟**。下方将出现**键盘选项**。

## 值

勾选一个或多个要键入的值。默认选中**平均值**。

| 值 | 键入内容 |
| --- | --- |
| **平均值** | 测量数据组的平均值 |
| **最小值** | 最小的读数 |
| **最大值** | 最大的读数 |
| **标准差** | 标准差 |
| **测量值** | 每个单独的样本读数 |
| **原始数据** | 从仪器接收到的完整原始数据 |

当选择多个值时，将按上方所示顺序键入，每个值之间以所选的**分隔符**分隔。

## 分隔符和后缀

| 选项 | 用途 |
| --- | --- |
| **分隔符** | 在各值*之间*（以及各单独测量之间）按下的键。可选择 **Tab**、**Enter** 或**无**。 |
| **后缀** | 在*最后一个*值*之后*按下的键。可选择 **Tab**、**Enter** 或**无**。 |

> [!info] 使用 **Tab** 移动到下一个单元格或字段，或使用 **Enter** 确认条目 / 移动到下一行。例如，*分隔符 = Tab* 且*后缀 = Enter* 会填满一行单元格，然后移动到下一行——非常适合电子表格。

## 小数点分隔符

将**小数点分隔符**设置为与目标应用程序匹配——英语区域设置通常使用句点（`.`），德语/法语区域设置通常使用逗号（`,`）。

## 键盘延迟

**键盘延迟**设置每次模拟按键后的短暂停顿。

> [!warning] 如果键入的值出现**乱码或重复字符**，请增大键盘延迟。某些应用程序和 PC 接受注入按键的速度比其他的慢。请从默认值开始，逐步提高（例如提高到 100 毫秒），直到值正确显示。该设置按 PC 保存。

## 示例

在选中**平均值**和**最小值**、*分隔符 = Tab*、*后缀 = Enter* 的情况下，键入电子表格会产生：

```
1089.4 ⇥ 1088.4 ⏎
```

平均值落在第一个单元格，最小值落在下一个单元格，光标随后移动到下一行——为下一次测量做好准备。

> [!info] 键盘模拟不会写入文件。若要既保留记录*又*键入数值，请同时在 [输出格式](rhopoint-com-agent-output-formats.md) 下勾选**文本**或 **CSV**。

[下一步：采集测量](rhopoint-com-agent-capturing-measurements.md)


---

# 采集测量

在配置好[连接](rhopoint-com-agent-connecting-an-instrument.md)并选择好[输出](rhopoint-com-agent-output-formats.md)之后，您就可以开始采集了。

## 开始和停止

按**开始**（右上角）。COM Agent 会打开串行端口并开始监听。该按钮会变为**停止**；按下它可结束会话并释放端口。

采集运行期间，左侧的配置会被**锁定**，因此无法在会话进行中更改。

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

## 实时面板

右侧实时显示正在发生的情况：

| 元素 | 含义 |
| --- | --- |
| **状态标记** | 开始前为**空闲**，采集期间为**正在监听**，连接失败时为**错误**。 |
| **已接收数据组** | 本次会话中已采集的完整测量的实时计数。 |
| **最近一次测量** | 最近一次测量的平均值、最小值、最大值和标准差（适用于可识别的格式）。 |
| **活动日志** | 滚动显示的事件列表：接收到的数据、写入的文件（含其完整路径）、键盘输出以及任何警告。使用**清除**可清空它。 |

## 进行一次测量

1. 在 COM Agent 中按**开始**。
2. 像平常一样在仪器上触发一次测量。
3. 活动日志会显示*“正在接收数据…”*，随后是写入的每个文件的路径；如果启用了键盘模拟，则显示一个 *“[Keyboard]”* 条目。
4. **已接收数据组**计数器增加，**最近一次测量**更新。

> [!info] 每次完成的测量都独立处理——您可以在一次会话中进行任意多次测量。无需在各次测量之间停止和重新开始。

> [!warning] 如果状态变为**错误**（例如，线缆被拔出或仪器被关闭），请停止会话、检查连接，然后重新开始。

[下一步：在无仪器的情况下试用](rhopoint-com-agent-demo-mode.md)


---

# 演示模式

演示模式可让您在**未连接仪器**的情况下试用 COM Agent。COM Agent 不从串行端口读取数据，而是按需生成一次逼真的演示测量——这对于学习应用程序、测试您的输出文件夹或键盘设置，或进行演示都很有用。

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

## 使用演示模式

1. 在“连接”部分将**模式**设置为**演示**。COM 端口和波特率设置会消失——它们已不再需要。
2. 像在实时模式中一样，选择您的[输出格式](rhopoint-com-agent-output-formats.md)，并根据需要选择[键盘选项](rhopoint-com-agent-keyboard-emulation.md)。
3. 按**开始**。
4. 在任意位置（甚至在另一个应用程序中）按 **Right Alt** 键即可注入一次演示测量。

每次按下 Right Alt 都会产生一次完整的演示测量，随后会按照您的输出设置写出和/或键入，就像真实读数一样。

> [!info] 演示模式是验证您的**键盘模拟**设置的最快方式：将模式设置为演示、启用键盘输出、单击进入电子表格、按开始，然后轻按 Right Alt——数值便会出现在单元格中。

> [!info] 演示数据使用 FT3 厚度格式，因此适用于 CSV 输出和所有键盘值（平均值、最小值、最大值、标准差、测量值）。

[下一步：许可](rhopoint-com-agent-licensing.md)


---

# 许可

COM Agent 需要有效的许可证才能从仪器**采集实时测量**。[演示模式](rhopoint-com-agent-demo-mode.md)无需许可证即可始终使用，因此您可以随时探索应用程序并测试您的输出和键盘设置。

您的许可证状态始终显示在窗口右上角：

- 绿色的**有效许可证：N** 标记表示实时采集已解锁。
- 红色的**无有效许可证**标记表示仅可使用演示模式。

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

## 许可证的工作方式

COM Agent 许可证可以通过以下两种方式之一进行绑定：

- **绑定到本计算机（主机 ID）** — 在本 PC 上为任何已连接的仪器解锁实时采集。
- **绑定到设备序列号** — 仅为来自该特定仪器的测量解锁，在任意 PC 上均可使用。当许可证应随仪器而非计算机移动时，请使用此方式。

## 申请许可证

1. 单击右上角的许可证标记（或**添加许可证**）以打开**许可证管理器**。
2. 使用其旁边的复制按钮复制您的**主机 ID**。对于绑定设备的许可证，请改为记下仪器的序列号。
3. 将主机 ID（或序列号）发送给 Rhopoint Instruments 以获取您的许可证文件。

> [!info] 主机 ID 标识本特定计算机。绑定主机的许可证仅在其主机 ID 所对应的计算机上解锁实时采集。

## 导入许可证

1. 打开**许可证管理器**并单击**导入许可证…**。
2. 选择您收到的许可证文件（`.lic`、`.txt` 或 `.json`）。您可以一次选择多个文件。
3. 许可证会出现在列表中，标记变为绿色——实时采集现已解锁。

## 管理许可证

许可证管理器列出每个已安装的许可证，并显示：

- **它绑定到什么** — *本机*、*设备序列号：…* 或*任意计算机*。
- **其状态和到期日** — 例如*有效 · 到期日 2027-01-31*。

使用许可证旁边的**垃圾桶**图标可将其移除。

> [!info] 绑定到设备序列号的许可证仅处理其设备 ID 与之匹配的测量。连接到同一 PC 的其他仪器将被忽略，除非它们也已获得许可。

> [!warning] 如果您在没有有效许可证的情况下按**开始**进行实时采集，COM Agent 会显示一条消息且不会启动。请导入许可证，或将**模式**切换为**演示**。

[下一步：设置与语言](rhopoint-com-agent-settings-and-language.md)


---

# 设置与语言

## 您的设置会被记住

COM Agent 会自动保存您的配置——模式、COM 端口、波特率、分段标记和数量、输出文件夹、输出格式以及所有键盘选项。下次启动应用程序时，一切都与您上次离开时完全相同，因此您只需按**开始**即可。

设置按 Windows 用户分别存储。

## 语言

COM Agent 提供十三种语言：**英语**、**捷克语**、**德语**、**西班牙语**、**法语**、**意大利语**、**荷兰语**、**波兰语**、**葡萄牙语**、**土耳其语**、**韩语**、**日语**和**中文**。请从窗口左上角徽标旁边的下拉菜单中选择您的语言。界面会立即切换，您的选择会被记住以备下次使用。

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

[下一步：命令行启动](rhopoint-com-agent-command-line-launch.md)


---

# 命令行启动

COM Agent 可以从命令行以预配置方式启动并立即开始采集。这对于自动化非常方便——可从另一个程序、桌面快捷方式或启动脚本以固定配置启动它。

应用程序窗口仍会照常打开；参数只是为您填入设置，随后采集自动开始。

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

## 选项

选项名称与窗口中的设置相对应。您省略的任何选项都会保留其已保存的值。

| 选项 | 值 / 示例 | 含义 |
| --- | --- | --- |
| `--mode` | `live` 或 `demo` | 采集模式。`demo` 无需 COM 端口。 |
| `--port` | `COM3` | 串行端口（实时采集时必需）。 |
| `--baud` | `19200` | 波特率。 |
| `--part-marker` | `^` | 界定一个完整测量数据组的标记。 |
| `--part-count` | `4` | 构成一个完整数据组的分段数量。 |
| `--output` | `"C:\Data"` | TXT/CSV 文件的输出文件夹。 |
| `--file-extension` | `txt`、`csv`、`csv+txt`、`keyboard` | 输出格式；用 `+` 组合多种。 |
| `--csv-delimiter` | `comma`、`semicolon`、`tab` | CSV 列分隔符。 |
| `--csv-decimal` | `dot`、`comma` | CSV 数字的小数点分隔符。 |
| `--csv-time-format` | `utc`、`local` | CSV *Timestamp* 列的格式。 |
| `--csv-encoding` | `utf8`、`utf8-bom` | CSV 文件编码（带或不带字节顺序标记）。 |
| `--keyboard-value` | `mean`、`min`、`max`、`stddev`、`measurements`、`raw` | 要键入的值；用 `+` 组合多种。 |
| `--keyboard-separator` | `tab`、`enter`、`none` | 在键入的值之间按下的键。 |
| `--keyboard-suffix` | `tab`、`enter`、`none` | 在最后一个值之后按下的键。 |
| `--keyboard-decimal` | `.` 或 `,` | 键入值的小数点分隔符。 |
| `--keyboard-delay` | `40` | 每次按键后的停顿（毫秒）。 |
| `--start` | *（无值）* | 在未提供其他参数时，以已保存的设置开始。 |

只要提供了任何参数（或单独使用 `--start`），采集就会自动开始。

## 示例

从 COM3 采集到 CSV 和 TXT 文件：

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

将平均值和最小值以 Tab 分隔的方式键入获得焦点的应用程序：

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

以演示模式启动（无需仪器）：

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

> [!info] 窗口照常打开，因此您仍可观察实时活动并随时停止采集。请为包含空格的路径加上引号。

> [!warning] 实时采集仍需要有效的[许可证](rhopoint-com-agent-licensing.md)。如果启动配置不完整或无效（例如，输出文件夹不存在），COM Agent 会显示与手动启动时相同的消息。

[下一步：保持 COM Agent 为最新版本](rhopoint-com-agent-updating-com-agent.md)


---

# 更新 COM Agent

COM Agent 会自动保持自身为最新版本。

## 自动更新

COM Agent 启动时，会在后台检查是否有新版本。如果有可用版本，窗口右上角会出现一个小通知。

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

- 单击**立即更新**以下载并安装更新。COM Agent 会下载新版本、显示进度条，然后在新版本上重新启动自身。
- 单击 **✕** 可忽略通知并继续使用当前版本。下次启动应用程序时会再次提醒您。

> [!info] 更新是可选的，仅在您选择时才会应用。COM Agent 绝不会为了更新而中断采集会话。

## 查看您的版本

当前版本显示在窗口标题栏中（例如 *Rhopoint COM Agent 1.2.3*）。