使用 Raspberry Pi 进行部署
最后更新
pip 安装 DepthAI 库。
使用预配置的 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 平台时才使用此镜像!
刷写 uSD 卡
- 从 Google Drive(上面的链接)下载 RPi 镜像。下载 Balena Etcher 程序。您也可以使用 RPi Imager,但我们注意到有时会出现问题。
- 打开 Balena Etcher。如果您下载了 .AppImage,您可能需要右键单击它并单击 Run 来启动程序。
- 单击 Flash from file 并选择您之前下载的 .zip 镜像。
- 选择目标 uSD 卡。
- 单击 Flash! 并等待其完成。
- 刷写完成后,安全移除 uSD 卡,将其插入 RPi,然后为 RPi 供电。
通过 RPi 为 OAK 供电
- 您的管道很复杂 - 尤其是视频编码和 AI 推理会产生可能导致掉电的功率峰值。
- 您有额外的 USB 设备连接到 RPi USB 端口,这些设备消耗的电流过大。RPi 总共可以提供 1.2A 的电流,因此如果所有 USB 设备消耗的电流超过 1.2A,就会发生掉电。绕过电流限制请查看 此指南 了解如何绕过电流限制。请注意,这会使您的保修失效。
- 您拥有 OAK 摄像头的 Pro 版本,它具有红外激光点投影仪和红外照明 LED,这些设备额外消耗高达 0.25A 的电流。
SSH 连接到 RPi
ssh 文件,以便 SSH 服务器在启动时启用(教程在此)。
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
已知镜像限制
- 在 OAK_CM4_PoE 上,自镜像 V8 起,第二个 uSD 卡支持已禁用。这是因为如果启用 uSD 卡支持(用于存储目的),WiFi 连接将被禁用。要启用第二个 uSD 卡支持(并禁用 WiFi 连接),您可以编辑
/boot/config.txt并取消注释文件末尾的dtoverlay=sdhost,poll_once=off行,然后重新启动系统。
将镜像刷写到 eMMC

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 Zero
将 OAK 摄像头连接到 RPI Zero


RPi 故障排除
RPi 死机 / OAK 在 RPi 上崩溃
不带 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.