# PTP 同步

PTP 同步通过以太网分发时间，因此支持的设备可以共享一个公共时钟，而无需专用的触发线。当直接 FSYNC 接线不切实际，但部署仍需要时钟对齐的捕获调度时，它非常有用。

### 原理与理论

PTP 通过以太网同步设备时钟，而不是分发专用的电触发器。在支持的 RVC4 平台上，该共享时钟用于驱动跨设备的公共帧调度，而不仅仅是在捕获后对帧进行时间戳。

实际上，这种同步看起来是根据所选的 FPS 将纪元时间线划分为槽。因此，在伪代码中

```text
frame_period = 1 / target_fps
slot_index = ptp_time_since_epoch / frame_period
```

每个参与设备从相同的 PTP 同步时钟计算相同的 `slot_index`，因此它们都瞄准相同的第 N 个捕获槽。

相机堆栈中的 PID 调节器然后将传感器速率稍微调整到高于或低于请求的 FPS，直到传感器锁定到该槽调度。例如，30 FPS 流可能会暂时运行得更快或更慢以消除相位误差，然后继续跟踪共享节奏。之后，[Sync
节点](/software-v3/depthai/depthai-components/nodes/sync.md)仍然将最近的帧配对在一起，但它处理的帧的捕获时间已经由相同的网络同步时间线驱动。

### 何时使用

在以下情况下使用 PTP 同步：

 * 设备通过以太网通信，无法共享方便的 FSYNC 线
 * 电缆布线或基于交换机的拓扑使直接菊花链连接不切实际
 * 部署需要跨多个设备进行时钟对齐的捕获调度

### 支持和限制

PTP 比直接 FSYNC 接线扩展性更好，但它不如共享硬件触发器精确，因为时间是通过网络路径分发的。它还依赖于正确处理 PTP 流量的网络设备。

#### RVC2

### RVC2 实现

RVC2 不使用基于以太网的 PTP 进行此同步工作流。当 RVC2 部署需要对齐曝光开始时，请使用 [硬件同步
(FSYNC)](/hardware/platform/deploy/data-sync/hardware-sync.md)；当软件分组足够时，请使用
[基于时间的同步](/hardware/platform/deploy/data-sync/time-based-sync.md)。

#### RVC4

### RVC4 实现

RVC4 支持在支持的以太网部署上进行基于 PTP 的设备时间同步。将一个设备配置为 PTP 主设备，将其他设备保留为从设备，然后在应用程序中启用 `TIME_PTP`
帧同步，以便传感器使用共享时钟作为其计时源并收敛到相同的帧槽。默认情况下，这会使曝光结束对齐；如果您的工作流需要曝光开始对齐，则可以更改该同步点。

> **Luxonis OS 要求**
> 对于 PTP 同步，请将 RVC4 设备更新到 Luxonis OS `1.35.0` 或更高版本。如果您的设备运行的是旧版操作系统，请首先按照 [Luxonis OS 更新指南](/software-v3/sw-stack/luxonis-os.md) 进行操作。

> **当前传感器支持**
> PTP 帧已在最新批次的 `OG05`、`IMX586`、`OV9282` 传感器上进行测试。如果 PTP 在您的设置中不起作用，请联系 Luxonis 支持。

### PTP 网络设备

PTP 同步仅在网络交换机支持 PTP 流量时才有效。我们已经测试了以下交换机并确认它们与 OAK4 PTP 同步兼容：

 * MikroTik CRS312-4C+8XG（推荐，用于我们的测试，为 PoE 设备供电时需要 PoE+ 注入器）
 * TP-Link TL-SG1005P
 * Ubiquiti Flex 2.5G PoE（4 端口版本）
 * TP-Link TL-SG1008P

在我们的测试中，8 端口 Ubiquiti 版本不起作用，因为它阻止了 PTP 流量。如果其他交换机明确支持 PTP 数据包处理，它们也可能起作用。为了获得更好的同步性能，请使用支持 PTP 的交换机，该交换机可以优先处理 PTP
数据包并通过更新计时校正来重新标记 PTP 数据包，以解决数据包在交换机内的驻留时间。MikroTik CRS312-4C+8XG 是我们推荐的选项，因为我们已经验证了这种设置。

#### 交换机优先级详细信息

当交换机支持流量分类规则时，将其配置为通过匹配以太网协议（EtherType / MAC 协议）值 `0x88F7` 来优先处理所有 IEEE 1588 以太网帧。

然后将该流量映射到流量类别 `7`，并对该类别使用严格优先级。实际上，这意味着该规则应适用于每个 IEEE 1588 帧，无论其 PTP 消息类型如何，而不仅仅适用于选定的 Sync、Follow_Up、Delay_Req 或 Delay_Resp 数据包。

每个交换机配置这些功能的方式不同，因此确切的菜单名称、规则字段和队列设置因供应商和型号而异。对于我们在测试中使用的并推荐用于 PTP 部署的 MikroTik CRS312-4C+8XG，请按照以下步骤操作：

我们验证了 MikroTik CRS312-4C+8XG 上的 PTP 数据包优先级和边界时钟操作。使用 WinBox 如下配置它：

 1. 在您将用于管理交换机的计算机上安装 WinBox。
 2. 使用 WinBox 连接到交换机。
 3. 打开 New Terminal。
 4. 逐行运行以下命令。

```text
/interface ethernet switch set switch1 qos-hw-offloading=yes

/interface ethernet switch qos profile
add name=PTP traffic-class=7

/interface ethernet switch rule
add switch=switch1 mac-protocol=0x88F7 new-qos-profile=PTP comment="Prioritize Layer 2 PTP"

/interface ethernet switch qos tx-manager queue
set [find where traffic-class=7] schedule=strict-priority

/system ptp
add name=ptp1 profile=default domain=0 transport=l2-forwardable delay-mode=e2e priority1=255 priority2=255 comment="PTP boundary clock"

/system ptp port
add ptp=ptp1 interface=combo1
add ptp=ptp1 interface=combo2
add ptp=ptp1 interface=combo3
add ptp=ptp1 interface=combo4
add ptp=ptp1 interface=ether1
add ptp=ptp1 interface=ether2
add ptp=ptp1 interface=ether3
add ptp=ptp1 interface=ether4
add ptp=ptp1 interface=ether5
add ptp=ptp1 interface=ether6
add ptp=ptp1 interface=ether7
add ptp=ptp1 interface=ether8
```

这些命令切换 QoS 设置，启用 QoS 硬件卸载，通过将 EtherType `0x88F7` 映射到流量类别 `7` 来优先处理 IEEE 1588 流量，对该类别应用严格优先级，并将交换机配置为在列出的 `combo` 和 `ether` 端口上作为
PTP 边界时钟。

如果您只想在特定端口上使用 PTP，请在应用配置之前删除相应的 `/system ptp port add ...` 行。

### 设置和运行

SSH 到主设备并启用主模式：

```bash
ssh root@IP_ADDRESS  # SSH 到主设备
luxonis-ptp-config enable
luxonis-ptp-config mode master
```

SSH 到从设备并启用从模式：

```bash
ssh root@IP_ADDRESS  # SSH 到从设备
luxonis-ptp-config enable
luxonis-ptp-config mode slave
```

如果相机配置已从默认值覆盖，请在每个参与设备上运行此命令：

```bash
luxonis-ptp-config sync_frames true
```

在应用程序代码中，启用：

```python
cam.initialControl.setFrameSyncMode(dai.CameraControl.FrameSyncMode.TIME_PTP)
```

这会告诉相机使用 PTP 同步的设备时钟作为帧计时的来源。然后，相机堆栈会不断调整实际传感器节奏，使其围绕请求的 FPS 运行，以便每个设备都锁定在共享时间线上的同一槽位。然后，[Sync
节点](/software-v3/depthai/depthai-components/nodes/sync.md)可以从那些已经对齐的捕获中分组最近匹配的帧。

PTP 同步和外部 FSYNC 使用相同的 `depthai-core` 示例（按照 [README](https://github.com/luxonis/depthai-core/blob/main/examples/README.md)
中的说明准备您的运行环境）。对于 PTP，使用 `--ptp-sync` 标志运行它们：

```bash
# 首先按照 README 准备您的环境，然后
python3 examples/python/Misc/MultiDevice/multi_device_frame_sync.py --ptp-sync  # 适用于 Python
```

 * [Python
   多设备帧同步示例](https://github.com/luxonis/depthai-core/blob/main/examples/python/Misc/MultiDevice/multi_device_frame_sync.py)
 * [C++ 多设备帧同步示例](https://github.com/luxonis/depthai-core/blob/main/examples/cpp/Misc/MultiDevice/multi_device_frame_sync.cpp)

### 观察到的同步精度

在我们的两个 OAK4-CS（带 OG05B10 传感器）测试设置中，我们观察到以下同步增量：

| 设置 | 平均同步增量 | p99 同步增量 |
| --- | --- | --- |
| 2x OAK4-CS | 64.12 us | 237.00 us |

在更高负载的测试设置中，八个 OAK4-D 设备（带 IMX586 传感器）通过配置为 PTP 流量优先级和硬件重新时间戳的 MikroTik CRS312-4C+8XG
交换机连接。设备使用不同的视频编码模式来改变以太网负载。正如预期的那样，更高的网络拥塞增加了延迟变化并降低了 PTP 同步精度。请注意，对于多设备 PTP 部署，建议使用视频编码而不是流式传输原始帧，因为较低的网络负载有助于保持 PTP 性能。

| 编码 | 分辨率 | 平均增量 | p99 增量 |
| --- | --- | --- | --- |
| MJPEG | 640x480 | 113.80 us | 198.47 us |
| MJPEG | 1280x720 | 394.79 us | 829.00 us |
| H.264 | 640x480 | 58.96 us | 92.04 us |
| H.264 | 1280x720 | 63.25 us | 100.67 us |
| H.264 | 1920x1080 | 74.38 us | 115.11 us |
| H.265 | 640x480 | 73.89 us | 122.69 us |
| H.265 | 1280x720 | 62.69 us | 95.82 us |
| H.265 | 1920x1080 | 80.77 us | 120.62 us |
| H.265 | 4000x3000 | 83.97 us | 142.39 us |

这些数字是指示性的，而不是保证的。实际同步精度取决于交换机行为、拓扑和网络负载。

CAM_A 4000x3000 H.265 随时间变化的同步增量：

所有 CAM 随时间变化的同步增量，CAM_A=1080p，CAM_B/CAM_C=1280×800 H.265：
