> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs-staging.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 测试执行 — RTC Testbench

## **测试执行**

> [!NOTE]
>
> 请先完成[构建与设置](https://dragonwingdocs-staging.qualcomm.com/zh/Suites/Industrial-Edge-Suite/rtc-testbench-setup.md)，并等待 5 分钟让 PTP 收敛，然后再继续。

***

### 配置对端 MAC 地址

每台设备的 YAML 配置必须将 `GenericL2Destination` 指向**对端设备**的 `end0` MAC 地址，而不是其自身的地址。

获取每台设备的 MAC：

```bash theme={null}
cat /sys/class/net/end0/address
```

然后在每台设备上更新配置：

| 设备 | 配置文件 | 将 `GenericL2Destination` 设置为 |
| - | - | - |
| Reference | `/usr/share/rtc-testbench/tests/opcua_qcom_emac/reference.yaml` | Mirror 设备的 `end0` MAC |
| Mirror | `/usr/share/rtc-testbench/tests/opcua_qcom_emac/mirror.yaml` | Reference 设备的 `end0` MAC |

***

### 运行测试

**先启动 mirror**，再启动 reference：

**在 mirror 设备上**：

```bash theme={null}
/usr/share/rtc-testbench/tests/opcua_qcom_emac/mirror.sh
```

**在 reference 设备上**（`mirror.sh` 启动之后）：

```bash theme={null}
/usr/share/rtc-testbench/tests/opcua_qcom_emac/ref.sh
```

每个脚本都会运行 `flow.sh end0`，该命令会应用 taprio/XDP 设置并将 NAPI/IRQ 线程绑定到 CPU 6，然后休眠 30 秒，再在后台启动 `mirror` 或 `reference` 二进制文件。

***

### 检查结果

**日志文件**：

| 日志 | 内容 |
| - | - |
| `/usr/share/rtc-testbench/tests/opcua_qcom_emac/ref.log` | `reference` 二进制文件的 stdout |
| `/usr/share/rtc-testbench/tests/opcua_qcom_emac/mirror.log` | `mirror` 二进制文件的 stdout |
| `/var/log/reference_opcua_vid200.log` | 应用统计信息（reference YAML 中的 `LogFile`） |
| `/var/log/mirror_opcua_vid200.log` | 应用统计信息（mirror YAML 中的 `LogFile`） |
| `/var/log/ptp4l_run.log` | PTP 守护进程日志（时间戳为进程运行秒数，而非绝对时间） |
| `/var/log/phc2sys_run.log` | PHC 到系统时钟的同步日志 |

***

### 成功标准

初始预热阶段结束后，必须**不再出现新的异常值**：

* `OpcUaRttOutliers` — 预热后不得增加
* `OpcUaOnewayOutliers` — 预热后不得增加

> [!NOTE]
>
> 测试开始时的前 **64 个 RTT 异常值**是已知的、结构性的 XDP TX 环预热伪影，**不**属于失败。在这一初始突发之后出现的任何异常值都表明存在问题。

***

### 已知问题 — Exclusivity Flag 错误

如果在运行 `mirror.sh` 或 `ref.sh` 时看到以下错误：

```
Error: Exclusivity flag on, cannot modify.
```

**解决方法**：重启设备。在两次运行之间未重启就再次运行脚本时会出现此问题。重新运行测试前请务必重启。

***

> [card] [构建与设置](https://dragonwingdocs-staging.qualcomm.com/zh/Suites/Industrial-Edge-Suite/rtc-testbench-setup.md)
>
> 构建、启动验证、postboot、PTP 设置

> [card] [参考文件](https://dragonwingdocs-staging.qualcomm.com/zh/Suites/Industrial-Edge-Suite/rtc-testbench-reference.md)
>
> postboot.sh、ptp.sh 和 gPTP 配置的完整源码

> [card] [RTC 基准测试 IQ9](https://dragonwingdocs-staging.qualcomm.com/zh/Suites/Industrial-Edge-Suite/rtc-benchmarks-iq9.md)
>
> 平台基准测试结果

> [card] [RTC Testbench](https://dragonwingdocs-staging.qualcomm.com/zh/Suites/Industrial-Edge-Suite/rtc-testbench.md)
>
> 返回概览
