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

OAK USB 部署指南

最后更新
OAK USB 摄像头使用 USB-C 线缆供电和传输数据。它们支持 USB2 或 USB3(高达 10 Gbps),并连接到主机电脑。
按照以下说明安装依赖项:

macOS & Windows

无需安装脚本。

Linux

执行以下命令在 Linux 系统上设置 udev 规则:
Command Line
1echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="03e7", MODE="0666"' | sudo tee /etc/udev/rules.d/80-movidius.rules
2sudo udevadm control --reload-rules && sudo udevadm trigger
如果出现任何问题,请参阅安装文档。
使用 USB3 USB-C 线缆以获得最大带宽。主机可以为设备供电,但建议使用外部电源。请参阅 为 OAK 设备供电 此处。USB3 线缆的 USB-A 连接器内部通常是蓝色的。如果不是蓝色,则可能是 USB2 充电线缆。
DepthAI 扫描 USB 设备,上传固件/管道/资产,并启动管道。最快的测试是 OAK Viewer。如果它找到设备并流式传输帧,则连接正常。

调试

如果您看到 RuntimeError: No available devices,DepthAI 未找到设备。确认电源和 USB3 连接,然后使用下面的选项卡。在进行任何故障排除之前,我们建议使用最新版本的 depthai。

lsusb

执行 lsusb | grep 03e7 时,您应该会看到类似以下内容:
Command Line
1$ lsusb | grep 03e7
2Bus 001 Device 120: ID 03e7:2485 Intel Movidius MyriadX
3# 或者,如果设备已启动,您应该会看到:
4# Bus 001 Device 001: ID 03e7:f63b Intel Myriad VPU [Movidius Neural Compute Stick]
如果您使用 lsusb -v,当设备等待连接时,它会显示 USB 速度为 480 Mb/s。连接到设备后,depthai 将上传固件,速度将变为 5 Gb/s(如果 USB3 可用)。如果引导加载程序已刷写,设备可以首先枚举为引导加载程序:
Command Line
1Bus 003 Device 038: ID 03e7:f63c Intel Luxonis Bootloader
FFC 风格的设备(OAK-FFC 4P/3P/…)可以刷写引导加载程序,但这不是必需的。在未刷写引导加载程序的普通设备上,您应该只在应用程序启动后看到设备(没有引导加载程序条目)。当应用程序启动时,它会重新枚举为:
Command Line
1Bus 002 Device 032: ID 03e7:f63b Intel Myriad VPU [Movidius Neural Compute Stick]
只有已启动的设备才能枚举为 USB3。如果应用程序启动后仍保持 USB2 速度,最常见的原因是主机侧的 USB 端口或电缆。尝试不同的 USB3 端口、更短的电缆或有源 USB3 集线器。运行 dmesg -w 并将 OAK 摄像头连接到主机时。您应该在终端中看到类似的输出:
Command Line
1/~$ dmesg -w
2
3[223940.862544] usb 1-3.2: new high-speed USB device number 120 using xhci_hcd
4[223940.963357] usb 1-3.2: New USB device found, idVendor=03e7, idProduct=2485, bcdDevice= 0.01
5[223940.963364] usb 1-3.2: New USB device strings: Mfr=1, Product=2, SerialNumber=3
6[223940.963368] usb 1-3.2: Product: Movidius MyriadX
7[223940.963371] usb 1-3.2: Manufacturer: Movidius Ltd.
8[223940.963373] usb 1-3.2: SerialNumber: 03e72485

Powering OAK cameras

USB3 可提供高达 900mA 的电流,而 USB2 可提供高达 500mA 的电流。OAK 摄像头根据型号和当前工作负载,耗电量在 500mA 到 900mA 之间。 Pro 版设备在峰值时功耗可达 15W,具体取决于红外投影仪和红外照明 LED 的使用情况。 这也取决于主机。有些计算机没有强大的 USB 控制器(例如 RaspberryPi 等 SBC,其 eFuse 为 1.2A)。 主机的 USB 控制器还会影响您可以使用多长的 USB 电缆,因为较长的电缆电阻更高,电压降也会更大。 在以下情况下,您应该为 OAK 摄像头外接电源:
  • 您有额外的 USB 设备连接到 RPi USB 端口,这些设备 消耗的电流过大。RPi 总共可以提供 1.2A 的电流,因此如果所有 USB 设备消耗的电流超过 1.2A,就会发生欠压。
  • 您拥有带有红外激光点 投影仪和红外照明 LED 的 OAK 摄像头的 Pro 版本。
我们始终建议为您的 OAK 摄像头外接电源,方式如下:
  • 圆筒插孔 - 在带有圆筒插孔的设备上(OAK-D、OAK-FFC 4P、OAK-FFC 3P)
  • 有源 USB3 集线器
  • 使用 Y 型适配器
  • 对于 Pro 设备,需要使用 15W 电源适配器和 Y 型适配器 以提供足够的电源。
原因是 OAK 会出现高达 2W 的电流尖峰(尤其是在使用视频编码器和运行 AI 推理时),这可能导致欠压。

Linux udev rules

Linux 需要一个 udev 规则来允许非 root 用户访问 USB 设备。如果未设置权限, DepthAI 将抛出类似以下内容的错误:
Command Line
1[warning] Insufficient permissions to communicate with X_LINK_BOOTED device having name "2.8". Make sure udev rules are set
必须设置以下规则才能访问 USB 设备:
Command Line
1echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="03e7", MODE="0666"' | sudo tee /etc/udev/rules.d/80-movidius.rules
2sudo udevadm control --reload-rules && sudo udevadm trigger

Using USB2

如果您使用的是 USB2 数据线/USB2 端口,或者 USB3 数据线有问题,或者使用的是更长的数据线(例如,超过 2.5 米), 您可能会收到 X_LINK_COMMUNICATION_NOT_OPEN 或 X_LINK_ERROR 等错误。在这种情况下,一个变通方法 是强制使用 USB2 通信。这将把 USB2 版本的固件上传到设备,并将通信速度限制为 USB2。要强制使用 USB2 模式,您可以在创建 dai.Device 对象时设置 maxUsbSpeed=dai.UsbSpeed.HIGH
Python
1import depthai as dai
2pipeline = dai.Pipeline()
3# Populate you pipeline with nodes
4# Force USB2 communication
5with dai.Device(maxUsbSpeed=dai.UsbSpeed.HIGH) as device:
6    # ...
连接并上传管道后,连接应该稳定,延迟应该很低(低于 0.5 秒),USB3 下行链路应该约为 2.5 Gbps。

调试

如果应用程序停止工作或通信缓慢,请参阅下面的调试选项卡。

Connection drop

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

Device crash

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

Power issue

这是一个相当常见的问题,通常是由于 USB 控制器无法为设备提供足够的电源。它可能会工作一段时间,然后由于随机的电源尖峰而崩溃。请阅读上面关于如何正确为设备供电的部分(“初始连接 > 为 OAK 摄像头供电”)。

Communication issue

如果设备正在移动(例如在移动机器人上),并且 USB 电缆未正确固定,这也是一个常见问题。USB 线可能会中断(断开)一瞬间,设备就会断开连接。如果是这种情况,我们建议使用 USB3 螺丝锁定电缆(亚马逊链接)。

Low speed / High latency

如果您发现帧率低和/或消息延迟高,您应该检查以下内容:
  1. OAK 带宽测试 - 使用 USB3 时应约为 2.5/1.0 Gbps
  2. OAK 延迟测试 - 应低于 5 毫秒
如果您的带宽/延迟低于预期,您应该查看低延迟文档。

开始使用 DepthAI 进行构建

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