此页面由 AI 自动翻译。查看英文原版
最后更新
Claude CodeCodexCursor
Luxonis 智能体工具包为你常用的编程智能体加载 Luxonis 上下文与技能,更快地基于 OAK 开发应用。
安装工具包

OAK PoE 部署指南

最后更新
以太网供电 (PoE) 允许以太网电缆用于为设备供电并提供连接,具有 1 Gbps 全双工带宽,最远可达 100 米(328 英尺)。
您需要一个 PoE 交换机或注入器来为 PoE 设备供电(请参阅为 PoE 设备供电)。设备通电后,交换机/注入器上的电源 LED 应亮起,如下图所示。
RJ45 PoE 连接器
M12 PoE 连接器
请务必正确拧紧连接器——RJ45 PoE 摄像头的以太网密封套或M12 连接器——以确保良好密封。这可确保设备 符合其 IP 等级。
DepthAI 库将查找同一 LAN 内所有可用的设备。如果摄像头 不在同一 LAN 上,您可以手动指定设备的 IP 地址。如果 DHCP 服务器不可用,摄像头将回退到静态 IP 169.254.1.222。测试设备的最佳方法是运行 OAK Viewer。它是一个 GUI 应用程序,可让您轻松评估摄像头,通过 实时可视化其输出。如果它找到设备并开始流式传输帧,则连接正常。

调试

如果您收到类似 RuntimeError: No available devices 的错误,这意味着 DepthAI 无法在同一子网中找到任何 PoE 设备。请确保摄像头已通电并连接到 与您的计算机相同的网络。请参阅下面的选项卡以了解调试步骤。我们建议在进行任何故障排除之前使用最新版本的 depthai。

Different Subnet

DepthAI 库只在同一子网内搜索可用的 OAK PoE 摄像头。您仍然可以 ping 摄像头,但自动发现功能将找不到该设备。 如果摄像头不在同一子网中,您可以手动指定设备 IP,如下面的代码所示。

Python

Py
1import depthai as dai
2pipeline = dai.Pipeline()
3# ... Populate pipeline ...
4
5# Define IP address of the device
6device_info = dai.DeviceInfo("169.254.1.222")
7
8with dai.Device(device_info) as device:
9    # Define queues, get messages...

C++

C++
1#include "depthai/depthai.hpp"
2
3int main(int argc, char** argv) {
4    dai::Pipeline pipeline;
5    // ... Populate pipeline ...
6
7    // Define IP address of the device
8    auto deviceInfo = dai::DeviceInfo("169.254.1.222");
9
10    dai::Device device(deviceInfo);
11
12    // Define queues, get messages...
13    return 0;
14}

Multiple interfaces

当使用 PoE 设备连接到同时连接了 WiFi 和以太网的 PC 时,需要调整网络路由以避免连接问题。 一个常见问题是系统两次检测到同一个 PoE 设备,导致初始化错误 (RuntimeError: Failed to find device after booting, error message: X_LINK_DEVICE_NOT_FOUND)。快速修复:断开 WiFi 连接以防止重复设备发现。您还可以手动配置网络路由,以确保 DepthAI 设备通过 PoE 进行通信,同时通过 WiFi 保持互联网访问:

Windows

  1. 打开命令提示符:按 Win + R,输入 cmd,然后按 Enter 键打开命令提示符。
  2. 识别网络适配器:输入 ipconfig 并按 Enter 键。记下您的网络适配器名称(例如,以太网、Wi-Fi)及其 IP 地址。
  3. 添加路由:
    • 使用 route 命令为 DepthAI 设备添加持久路由。通用格式为:route -p ADD [DepthAI-IP] MASK [子网掩码] [适配器网关IP]。
    • 将 [DepthAI-IP] 替换为您的 DepthAI 设备的 IP 地址,将 [子网掩码] 替换为适当的子网掩码,并将 [适配器网关IP] 替换为您希望用于 DepthAI 通信的适配器的网关 IP。
  4. 验证路由:添加路由后,您可以输入 route print 并按 Enter 键进行验证。

Linux

  1. 打开终端:您可以在应用程序菜单中找到终端应用程序,或使用快捷键 Ctrl + Alt + T。
  2. 识别网络接口:输入 ip addr 并按 Enter 键。记下您的网络接口名称(例如,以太网的 eth0,Wi-Fi 的 wlan0)。
  3. 添加路由:
    • 使用 ip route 命令为 DepthAI 设备添加路由:sudo ip route add [DepthAI-IP]/24 via [适配器网关IP] dev [网络接口]。
    • 将 [DepthAI-IP] 替换为您的 DepthAI 设备的 IP 地址(确保掩码 - 24 - 正确),将 [适配器网关IP] 替换为您希望用于 DepthAI 通信的适配器的网关 IP,并将 [网络接口] 替换为网络接口的名称。
  4. 验证路由:您可以通过输入 ip route show 并按 Enter 键来检查路由。
请确保将方括号中的值替换为适合您系统的相应值。DepthAI 设备(断开 DHCP 服务器连接时)的默认设置在上面的 无 DHCP 面板中指定。有关路由/使路由持久化的更多信息,请参见此处:Windows、macOS、Ubuntu。

macOS

  1. 打开终端:您可以在“应用程序”下的“实用工具”中找到终端,或使用 Spotlight 搜索它。
  2. 识别网络接口:输入 ifconfig 并按 Enter 键。记下您的网络接口名称(例如,以太网的 en0,Wi-Fi 的 en1)。
  3. 添加路由:
    • 在网络设置 -> 设置服务顺序下,将用于 DepthAI 的接口拖到列表底部。
    • 将相关流量导向 DepthAI 适配器:sudo route add -net 169.254 -interface [dongle-interface]。
    • 将 [dongle-interface] 替换为 DepthAI 网络接口。

No DHCP

默认情况下,PoE 设备会尝试从 DHCP 服务器获取动态 IP 地址。但是,如果网络上没有 DHCP 服务器,设备将回退到其静态 IP 169.254.1.222。在这种情况下,您可以选择:
  1. 将交换机连接到路由器,以从 DHCP 服务器获取动态 IP 地址。
  2. 将计算机的静态 IP(例如 169.254.1.10,子网掩码:255.255.0.0)设置为与 PoE 设备在同一子网中,然后连接到您的设备。
  3. 连接到设备时手动指定设备 IP 地址,您可以使用 IP 地址或 MxId:

Python

Py
1import depthai as dai
2pipeline = dai.Pipeline()
3# ... 填充管道 ...
4device_info = dai.DeviceInfo("169.254.1.222")
5# device_info = depthai.DeviceInfo("14442C108144F1D000") # MXID
6# device_info = depthai.DeviceInfo("3.3.3") # USB 端口名称
7
8with dai.Device(device_info) as device:
9    # 定义队列,获取消息...

C++

C++
1#include "depthai/depthai.hpp"
2int main(int argc, char** argv) {
3    dai::Pipeline pipeline;
4    // ... 填充管道 ...
5    auto deviceInfo = dai::DeviceInfo("169.254.1.222");
6    // auto deviceInfo = dai::DeviceInfo("14442C108144F1D000");
7    // auto deviceInfo = dai::DeviceInfo("3.3.3");
8    dai::Device device(deviceInfo);
9    // 定义队列,获取消息...
10    return 0;
11}

Firewall

UDP 设备发现通过端口 11491 处理,TCP XLink 连接通过端口 11490 处理。在 Ubuntu 上,防火墙默认是禁用的,所以您应该不会遇到任何问题。您可以通过执行以下命令来检查:
Command Line
1> sudo ufw status
2Status: inactive
如果您的防火墙已启用,您可能需要允许这两个端口:
Command Line
1sudo ufw allow 11490/tcp
2sudo ufw allow 11491/udp
我们注意到上述规则并非总是按预期工作,有时需要运行以下命令。对于生产环境,您可能希望在 OAK PoE 摄像头上设置静态 IP,否则它可能会 更改,您将需要重新设置防火墙规则。
Command Line
1ufw allow from [OAK_POE_IP]

Network equipment

我们注意到,对于某些网络设备,我们默认的 15 秒 连接 POE 设备的超时时间 不足,需要增加。您可以通过使用环境变量(值以毫秒为单位)来增加超时时间。

Windows Powershell

Command Line
1$env:DEPTHAI_WATCHDOG_INITIAL_DELAY=60000
2$env:DEPTHAI_BOOTUP_TIMEOUT=60000
3python3 script.py

Linux/macOS

Command Line
1DEPTHAI_WATCHDOG_INITIAL_DELAY=60000 DEPTHAI_BOOTUP_TIMEOUT=60000 python3 script.py

Windows CMD

Command Line
1set DEPTHAI_WATCHDOG_INITIAL_DELAY=60000
2set DEPTHAI_BOOTUP_TIMEOUT=60000
3python3 script.py

VPN

VPN 连接也可能中断与 PoE 设备的连接(因为您的计算机可能只在远程 网络中搜索设备,因此无法在本地网络中发现它),因此我们建议在使用 PoE 设备时关闭 VPN ,或者确保您的本地路由设置正确,以便在 VPN 连接处于活动状态时可以使用/发现本地设备。
成功连接到设备并上传管道后,连接应该稳定,延迟应该最小(低于 1 秒),带宽应该为 700 Mbps。

调试

Connection drop

如果连接在一段时间后断开,可能有几个潜在问题导致此情况。

Network issue

由于网络和网络设备的原因,OAK PoE 摄像头在正常运行数小时或数天后可能会断开连接。对于此问题,有 2 种潜在的解决方案/变通方法:
  1. 降低网络负载,这样连接就不会断开。这可以通过降低摄像头的 FPS 或降低摄像头的分辨率来实现。
  2. 如果摄像头断开连接,则自动重新连接。我们这里有一个演示可以实现这一点。缺点是重新连接可能需要大约 30 秒。首先,看门狗必须启动并重置摄像头(约 5 秒)。然后,引导加载程序必须在摄像头上重新启动,以便再次访问(约 5 秒)。最后,主机必须初始化新连接并传输固件、管道和所有资产(神经网络)到摄像头,以便它可以启动管道(应用程序)。我们这里有自动重新连接示例。

Device crash

设备可能由于固件或用户应用程序中的错误而崩溃。如果存在固件错误或(用户定义的)管道问题,将生成一份 崩溃报告,您应该将其发送给我们 (support@luxonis.com)。如果在运行上述脚本时未找到崩溃报告,则意味着存在电源问题或连接断开(或者,不太可能,硬件问题)。或者,在 depthai 2.28.0 中,默认启用自动崩溃报告生成。这将把崩溃报告发送到 Luxonis 服务器,并将包括:
  • 崩溃转储本身
  • 管道配置
  • depthai 版本
  • 主机操作系统版本 (MacOS/Linux/Windows)
它不包括任何用户数据、图像或神经网络模型。但是,它确实包括 Script 节点代码。如果您希望禁用自动崩溃报告生成,可以通过将环境变量 DEPTHAI_DISABLE_CRASHDUMP_COLLECTION 设置为 1 来实现。

Power issue

如果您的 PoE 设备无法工作,或者在某些罕见情况下,它工作一段时间后突然停止工作, 您的 PoE 交换机/注入器可能存在问题。例如,当每个端口的功率预算似乎足够时,但 由于其他端口设备的需求,交换机的总功率预算被超出。 值得检查您的 PoE 交换机/注入器关于其总功率预算的规格。

High CPU usage

如果 PoE 设备的 CPU 持续保持在 100% 左右(在 LeonOS 核心上),则设备很有可能会迟早断开连接并抛出类似 ping was missed, closing the device connection 的错误。 您可以在此文档中阅读有关设备 CPU 使用情况(以及如何调试)的更多信息。

Low speed / High latency

如果您发现帧率低或消息延迟高,应检查以下内容:
  1. PoE 链路测试 - 您应该获得 1000 Mbps 的速度。如果只有 100 Mbps,则很可能是您正在使用慢速网络设备(见下文)。
  2. OAK 带宽测试 - 应该在 800/200 Mbps 左右。
  3. OAK 延迟测试 - 应该低于 10 毫秒,但这取决于您的网络。
如果您的带宽/延迟低于预期,您应该检查下面的调试步骤。我们还有与 PoE 无关的低延迟文档。

慢速网络设备

如果您的 PoE 链路速度低于 1000 Mbps,您的设置中可能存在瓶颈:
  • 以太网线缆:使用 Cat5e 或更高规格的线缆。Cat5e 支持 1 Gbps,而 Cat5 仅限于 100 Mbps。也可能是您的线缆损坏,只有 2 对线工作(最高 100Mbps)。
  • PoE 交换机:确保它支持 1 Gbps 速度。此类交换机通常标有 10/100/1000 Mbps。
  • 路由器:如果适用,确保它能处理 1 Gbps。某些路由器可能只有有限的端口具备此功能。
  • PoE 注入器:确保它支持 1 Gbps。某些型号仅限于 100 Mbps。
  • 线缆长度:将以太网线缆保持在 100 米(328 英尺)以下。对于更长的距离,请使用 PoE 延长器。
  • 主机网卡:确保它支持 1 Gbps。较旧的网卡可能上限为 100 Mbps。如有必要,请升级您的网卡。
请勿使用 WiFi 连接到 PoE 设备。WiFi 不适用于高带宽应用,很可能会导致瓶颈。 如果必须使用,请使用支持至少 1 Gbps 的 WiFi 标准,例如 802.11ac (WiFi 5)、802.11ax (WiFi 6) 或 802.11ay (WiFi 6E)。请注意,带宽会随着路由器和主机之间的距离和障碍物而减小。

网卡设置

Linux 上的一些默认网卡 (NIC) 设置可能不适合与 OAK POE 摄像头通信,这可能导致 帧率低、延迟高和/或 OAK CPU 使用率高。您可以使用 ethtool 配置这些设置。
ethtool 设置为我们提供了更好的性能在一个案例中,配置 sudo ethtool -C NAME rx-usecs 1022(其中 NAME 是 enp59s0f1)将帧率从 12 提高到 20。

Advance network settings

对于更高级的用户,我们公开了一些网络设置,允许您微调系统以获得更好的性能。 您可以使用设备配置对象来配置它们。对于 RVC2 sysctl 配置,请参阅此处可用的设置 (请注意,某些设置是只读的,有些可能会导致系统崩溃)。 有关 sysctl 设置的更多信息,请参阅 FreeBSD 的文档 (12.0)。
Py
1config = dai.Device.Config()
2config.board.network.mtu = 9000 # Jumbo frames. Default 1500
3config.board.network.xlinkTcpNoDelay = False # Default True
4config.board.sysctl.append("net.inet.tcp.delayed_ack=1") # configure sysctl settings. 0 by default.
5
6with dai.Device(config) as device:
7    # Your code here

PoE 扩展器

我们已经测试了电源/通信 使用此 PoE 扩展器。它是一个 1Gbps 扩展器,接受 PoE+ (30W) 并 具有 2 个 PoE (15W) 端口输出,因此您可以连接两个 OAK PoE 摄像头。
我们能够同时从两台设备流式传输视频。

WiFi 网桥

将 PoE 设备连接到网络的一种选择是使用 WiFi 网桥。当您没有 PoE 交换机或注入器,但有 WiFi 网络可用时,这很有用。 网桥将连接到 WiFi 网络并为您的 OAK PoE 设备提供以太网端口(连接)。我们已经测试了 Vonets WiFi 网桥 ,它按预期工作。您首先需要连接到 WiFi 网桥(例如,通过您的手机)并将其配置为连接到您的 WiFi 网络。然后,您可以将 OAK PoE 设备(通过 PoE 注入器)连接到网桥。
此 WiFi 网桥接受 5V 供电,您可以使用 USB-A 连接器(我们将其连接到移动电源)或标准桶形连接器。

使用 OAK 进行视频流

由于 OAK PoE 摄像头连接到网络,它可以直接将视频流传输到计算机。以下是一些 使用 OAK PoE 摄像头上的 Script 节点进行的视频流演示:
  • TCP 流 使用 Script 节点 - TCP 服务器或客户端
  • MJPEG 流与 HTTP 服务器 使用 Script 节点
  • MQTT 发布 使用 Script 节点(pub/sub 都应该工作)
以下是一些演示,它们通过 XLink 将视频流从 OAK 摄像头传输到主机计算机,然后从 主机计算机传输到另一台计算机/服务器,这也适用于任何其他 OAK 摄像头(甚至是 USB OAK 设备):

恢复出厂设置

如果您可以 ping 通设备但无法以任何方式连接到它(搜索设备,指定 IP),您应该进行恢复出厂设置,因为设备可能已软砖。这通常发生在较旧的引导加载程序版本中。请注意,只有 OAK-D-PoE 和 OAK-1-PoE 具有 USB-C 连接器,而 OAK-D Pro PoE 通过 M8 连接器具有 USB 连接。

Series 1 PoE devices

以下步骤适用于 OAK-D PoE 和 OAK-1 PoE 设备。
  1. 打开 OAK PoE 摄像头的外壳。
  2. 找到 USB-C 连接器和启动 DIP 开关。
  3. 将 DIP 开关更改为 0x16(开关 2、4、5 向上,其他向下,如下图所示)以进行 USB 通信。
  4. 通过 USB-C 电缆将 OAK PoE 摄像头连接到计算机。
  5. 使用 设备管理器 运行恢复出厂设置。
  6. 将 DIP 开关改回 0x3(开关 5、6 向上,其他向下)以进行 PoE 通信。
  7. 重新盖上外壳,确保垫圈在正确的位置(用于防水)。

Series 2 PoE devices (M8 connector)

由于 S2 OAK PoE 设备外壳上没有任何物理按钮 (由于其 IP 等级),编程板用于重新刷新 PoE 设备上的固件。 当设备的静态 IP 设置为不同的子网且无法 访问时,这尤其有用。您将需要 OAK 编程板 来重新刷新固件并 将设备恢复到其默认设置。
步骤:
  1. 将编程板连接到 OAK POE 设备的 M8 连接器。确保 方向正确(如下图所示),以避免损坏 M8 连接器。 编程板连接器不会拧紧或锁定在 POE 连接器上,因此必须注意 连接器在刷新时不会从插座中脱落。
  2. 按住编程板上的恢复按钮,同时 将其连接到主机设备(您将从中刷新固件的设备)上的 USB 端口。编程板上的 LED 应 在连接正确时亮起。当编程板连接到 主机计算机时,您可以松开恢复按钮。
  3. 连接后,您应该能够在主机 计算机上发现您的 PoE 设备。
  4. 您现在可以继续刷新固件,方法与使用 设备管理器 工具刷新其他 OAK 设备相同,该工具为多个操作系统提供 GUI。该工具包括一个“恢复出厂设置”选项,允许您 将 Series 2 OAK PoE 设备重置为其默认设置。

开始使用 DepthAI 进行构建

推荐的下一步
使用 DepthAI 构建您的第一个 OAK4 应用程序,或使用 代理工具寻求编码代理的帮助。
探索 DepthAI
其他有用的下一步包括: