此页面由 AI 自动翻译。查看英文原版
最后更新

本页目录

  • 使用预配置的 RPi 操作系统镜像
  • 刷写 uSD 卡
  • 通过 RPi 为 OAK 供电
  • SSH 连接到 RPi
  • 已知镜像限制
  • 将镜像刷写到 eMMC
  • Raspberry Pi Zero
  • 将 OAK 摄像头连接到 RPI Zero
  • RPi 故障排除
  • RPi 死机 / OAK 在 RPi 上崩溃
  • 不带 X11 转发的 SSH 连接
Claude CodeCodexCursor
Luxonis 智能体工具包为你常用的编程智能体加载 Luxonis 上下文与技能,更快地基于 OAK 开发应用。
安装工具包

使用 Raspberry Pi 进行部署

最后更新
我们的设备也可以连接到像 Raspberry Pi (RPi) 这样的小型 SBC。要在 RPi 上安装 DepthAI,您应该安装依赖项,然后使用 pip 安装 DepthAI 库。
DepthAI 库在 PyPi 上为 RPi 提供了预构建的 wheel 包。

使用预配置的 RPi 操作系统镜像

我们提供预装了 DepthAI 及其所有依赖项的 Raspberry Pi 操作系统镜像。预配置的 RPi 镜像可在此处获取。
  • OAK_CM4_POE - 使用 RPi OS(默认),预装了 DepthAI。所需硬件:8 GB 或更大的 uSD 卡。此镜像刷写到随 OAK-D CM4 和 OAK-D CM4 PoE 发送的 uSD 卡上。要启用第二张 uSD 卡,请参阅 此处 的变通方法。我们建议用户将此镜像用于所有 OAK 摄像头。
  • KS_Rpi_OS_Full - 使用 RPi Full OS,预装了 DepthAI 和 CEP。所需硬件:32 GB 或更大的 uSD 卡,带 4 GB RAM 的 RPi 4。此镜像刷写到发送给 KickStarter 支持者的 uSD 卡上。仅当您需要 CEP 平台时才使用此镜像!
创建这些镜像的步骤和更新日志可在此处找到:here。

刷写 uSD 卡

  1. 从 Google Drive(上面的链接)下载 RPi 镜像。下载 Balena Etcher 程序。您也可以使用 RPi Imager,但我们注意到有时会出现问题。
  2. 打开 Balena Etcher。如果您下载了 .AppImage,您可能需要右键单击它并单击 Run 来启动程序。
  3. 单击 Flash from file 并选择您之前下载的 .zip 镜像。
  4. 选择目标 uSD 卡。
  5. 单击 Flash! 并等待其完成。
  6. 刷写完成后,安全移除 uSD 卡,将其插入 RPi,然后为 RPi 供电。

通过 RPi 为 OAK 供电

在 RPi 文档中,它指出 Raspberry Pi 2 或更高版本可以通过 USB 端口提供高达 1.2A 的电流。对于简单的管道,OAK 摄像头消耗的电流小于 1A,这意味着您可以通过 USB-C 线直接从 RPi 为 OAK 摄像头供电,除非:
  • 您的管道很复杂 - 尤其是视频编码和 AI 推理会产生可能导致掉电的功率峰值。
  • 您有额外的 USB 设备连接到 RPi USB 端口,这些设备消耗的电流过大。RPi 总共可以提供 1.2A 的电流,因此如果所有 USB 设备消耗的电流超过 1.2A,就会发生掉电。
  • 您拥有 OAK 摄像头的 Pro 版本,它具有红外激光点投影仪和红外照明 LED,这些设备额外消耗高达 0.25A 的电流。
我们仍然建议通过外部电源为您的 OAK 摄像头供电,无论是通过桶形插孔(在旧设备上),还是通过 Y 型适配器。原因是 OAK 存在电流尖峰(尤其是在使用视频编码器和运行 AI 推理时),这可能导致掉电。

SSH 连接到 RPi

如果您使用的是预配置的 RPi 操作系统镜像,SSH 服务器已启用,否则您需要在 boot 卷中创建 ssh 文件,以便 SSH 服务器在启动时启用(教程在此)。
如果您的 RPi 具有 WiFi 连接,您可以通过在 boot 卷中创建(和编辑)wpa_supplicant.conf 来设置 WiFi SSID/密码(教程在此)。通过以太网/WiFi 将 RPi 连接到与您的计算机相同的局域网后,您可以使用以下命令 SSH 连接到 RPi。如果 RPi 和计算机不在同一个局域网中,您将不得不指定 RPi 的 IP 地址而不是 luxonis.local - 这是预配置 RPi 镜像上 RPi 的默认名称。
Command Line
1ssh pi@luxonis.local -X
-X 参数在 Linux 上启用 X11 转发 - 因此 OpenCV 的 imshow 图像将通过 SSH 转发到您的计算机。在 MacOS 上,X11 默认未安装,因此您需要下载它,更多信息在此。当您第一次 SSH 连接到 RPi 时,它会警告您有关真实性的问题,如下面的日志所示。
Command Line
1The authenticity of host 'raspberrypi.local (192.168.1.222)' can't be established.
2ECDSA key fingerprint is SHA256:stb5mbRQeX6veOq8Wzg81rz9IHonxJR2++Q8bDYryTo.
3Are you sure you want to continue connecting (yes/no/[fingerprint])?
输入 yes 继续。此命令后,您需要提供密码。默认的 RPi 操作系统密码是 raspberry。您应该更改它。SSH 成功后,让我们尝试运行一个示例应用程序:
Command Line
1python depthai-python/examples/MobileNet/rgb_mobilenet.py

已知镜像限制

  1. 在 OAK_CM4_PoE 上,自镜像 V8 起,第二个 uSD 卡支持已禁用。这是因为如果启用 uSD 卡支持(用于存储目的),WiFi 连接将被禁用。要启用第二个 uSD 卡支持(并禁用 WiFi 连接),您可以编辑 /boot/config.txt 并取消注释文件末尾的 dtoverlay=sdhost,poll_once=off 行,然后重新启动系统。

将镜像刷写到 eMMC

OAK-D CM4 和 OAK-D CM4 PoE 板载 Raspberry Pi Compute module 4 (CM4)。大多数 OAK-D-CM4 批次都带有带 eMMC 内存的 CM4,而大多数 OAK-D CM4 PoE 板都带有 CM4 Lite,它没有 eMMC 内存,而是从 uSD 卡启动。将镜像刷写到 uSD 卡很简单,这里我们将介绍将镜像刷写到 CM4 上的 eMMC 的过程。这是一个 OAK-D-CM4,它带有 CM4,红色箭头指示 eMMC 内存。CM4 Lite 版本在该位置没有此芯片。
要将镜像刷写到 CM4 eMMC(官方 RPi 指南),首先需要使用排针启用 USB_BOOT。默认情况下,连接器位于指示为 DIS(禁用)的 2 个排针上,因此我们必须将连接器移动到 EN 排针(启用)。
将排针连接器切换到 EN 后,我们可以将 micro-USB 线从计算机连接到上面红色矩形指示的 micro-USB 连接器。连接 micro-USB 后,您应该通过 5V 桶形插孔供电。连接 micro-USB 和电源后,我们需要启用 RPi USB 启动。我们遵循了此处的教程。构建并运行程序后,您应该会看到类似以下内容:
Command Line
1/Documents/usbboot$ sudo ./rpiboot
2RPIBOOT: build-date Apr 21 2022 version 20220315~121405 445356e1
3Waiting for BCM2835/6/7/2711...
4Loading embedded: bootcode4.bin
5Sending bootcode.bin
6Successful read 4 bytes
7Waiting for BCM2835/6/7/2711...
8Loading embedded: bootcode4.bin
9Second stage boot server
10Loading embedded: start4.elf
11File read: start4.elf
12Second stage boot server done
启动完成后,您应该会在 Raspberry Pi Imager 或 Balena Etcher(我们使用的,下面的截图)中看到 eMMC 内存,这样您就可以轻松地将所需的镜像刷写到 eMMC。刷写完成后,请务必禁用 USB 启动(通过再次切换连接器)并重新启动设备。它应该会从新刷写的镜像启动!

Raspberry Pi Zero

Raspberry Pi Zero 是一款 性价比极高的单板计算机 (SBC)。您只需大约 5 美元即可购买一个。它拥有 512MB RAM、1GHz 单核 CPU,以及可选的板载蓝牙和 WiFi 连接(RPI Zero W,售价约 10 美元)。它的功耗约为 0.5W。RPi Zero 足以用于流式传输元数据(NN 结果)、低分辨率编码视频或轻量级计算。如果您打算流式传输高分辨率视频、执行繁重计算(例如使用 OpenCV)或进行后处理,RPi Zero 将不是主机计算机的最佳选择。

将 OAK 摄像头连接到 RPI Zero

RPI Zero 有一个用于外设的 micro USB 连接器。您可以使用标准的 USB-C(转 USB-A)线缆,但您需要 OTG 连接器/线缆才能将 OAK 摄像头连接到 RPI Zero。
以上所有选项都有效。我们与这些公司没有关联/隶属关系,但这里是我们获得左侧连接器(Aliexpress)和右侧连接器(Aliexpress)的地方。
根据我们的测试,RPi Zero 能够在没有外部电源(无论是电源插孔还是 Y 型适配器)的情况下为 OAK-D 提供足够的电力。

RPi 故障排除

RPi 死机 / OAK 在 RPi 上崩溃

Raspberry Pi 的所有 USB 端口的最大电流限制为 1.2A,而 OAK 摄像头最多可消耗 1A(最大功率,通常接近 500mA)。因此,如果您看到死机,可能是因为您连接的 USB 设备总功耗超过了 1.2A 的限制。使用带电源的集线器可以防止这种情况,或者通过 USB 从 Pi 供电的设备更少。这还可能表现为 OAK 在 Pi 上随机崩溃。如果 OAK 配置为同时执行多项任务,这种情况会变得特别频繁。随着我们使 DepthAI 能够同时执行越来越多的任务,从而增加 OAK 可以拉取的最大功率,这种情况变得越来越可能。似乎 OAK 的峰值功率(电流)尖峰可能超过 Pi 的处理能力,导致 OAK 掉电并返回错误。因此,如果您在 Raspberry 上遇到 DepthAI 稳定性问题,请尝试通过电源和/或带电源的 USB 集线器为 OAK 摄像头供电,看看错误是否消失。

不带 X11 转发的 SSH 连接

如果您在没有 -x 参数的情况下 SSH 连接到 RPi 并尝试显示帧(例如 cv2.imshow()),您很可能会收到以下错误:
  • (-2:Unspecified error) Can't initialize GTK backend in function 'cvInitSystem'
  • qt.qpa.xcb: could not connect to display. qt.qpa.plugin: Could not load the Qt platform plugin "xcb".
  • This application failed to start because no Qt platform plugin could be initialized.
解决方案是在 SSH 连接到 RPi 时使用 X11 转发,请参阅 SSH 连接到 RPi。