概览硬件软件云平台
平台

本页目录

  • 开始之前
  • 为相机供电
  • 安装并打开 OAK Viewer
  • 可选：连接到 Luxonis Hub
  • 恢复出厂设置
  • 故障排除
  • 红灯（供电不足）
  • 蓝灯行为异常
  • 无 DHCP
  • 设备在 oakctl 中可见，但在 OAK Viewer 中不可见
  • 橙灯（设备问题）
  • 重置按钮故障
  • 下一步

OAK4 入门指南

按照本指南为您的 OAK4 相机供电、在 OAK Viewer 中打开它、可选地连接到 Luxonis Hub，并解决最常见的设置问题。

开始之前

为了快速上手，我们制作了一个关于通过 PoE+ 连接相机入门的视频：
视频中的流程在下方有更详细的描述。

为相机供电

OAK4 相机最高消耗 25W 功率（峰值），需要使用 PoE+（802.3at，30W）供电设备/交换机（例如 TL-SG1008P）。 通电并启动后，状态灯应变为稳定的蓝色，表示设备已就绪。

安装并打开 OAK Viewer

OAK Viewer 是一款桌面 GUI 应用，可让您可视化相机的流并与设备交互。它适用于 Windows、macOS 和 Linux。
下载并安装 OAK Viewer：

Linux

OAK Viewer 3.0.2 适用于 Ubuntu 24.04 / 22.04 (x86)

macOS

OAK Viewer 3.0.2 适用于 macOS 12+ (ARM) | macOS 12+ (x86)

Windows

OAK Viewer 3.0.2 适用于 Windows 10/11 (x86)
更多详情请参见 OAK Viewer 文档页面。

可选：连接到 Luxonis Hub

如果您想将相机连接到 Luxonis Hub 并探索生态系统，请在 OAK Viewer 中点击“Adopt to Hub”按钮，确认恢复出厂设置并选择新密码。设置完成后，OAK Viewer 中的设备上将显示一个 Hub 标签。
分步说明：

点击 Adopt to Hub

如果您想将相机连接到 Luxonis Hub 并探索生态系统，请在 OAK Viewer 中点击“Adopt to Hub”按钮。

确认数据删除

您将收到一个警告，提示继续 Hub 设置将删除设备上的数据。这将删除所有用户数据——包括 /data/ 和用户覆盖层。此步骤后，您将被重定向到网页浏览器。

输入新密码

输入密码，必要时可设置高级选项。

确认成功完成

返回 OAK Viewer，您现在应该在设备旁边看到一个 Hub 标签，表示相机已成功连接到 Luxonis Hub。

恢复出厂设置

如果您需要将 OAK4 设备恢复出厂设置，可以在设备通电时按下硬件重置按钮：
  1. 按住重置按钮 10 秒钟。
  2. 大约 5 秒后，前置 LED 呈橙色闪烁。
  3. 继续按住；大约 10 秒时，LED 呈红色闪烁，然后熄灭，表示恢复出厂设置已开始。
  4. LED 熄灭后松开按钮，等待设备重启（可能需要几秒钟）。

故障排除

跳转到对应症状：

红灯（供电不足）

启动前，OAK4 摄像头会检测 PoE+（30W）信号。若未检测到，红灯会闪烁，但只要有足够电力，设备仍会尝试启动。 OAK4 按照 IEEE 802.3at 标准协商 Type 2（30W PoE+）。若协商失败或使用被动式 PSE，则默认回退到 Class 0（15W），可能导致供电不足，红灯亮起作为警告。某些 PoE 注入器（如 Ubiquiti 的 PoE+ 注入器）能提供足够电力，但未发出合规信号。此时 OAK4 会在启动前红灯闪烁，启动后变为蓝灯。

蓝灯行为异常

您的设备可能运行较旧的 OS 版本，导致行为不同——启动后闪烁或完全不亮。这种情况下，建议将 OS 更新至最新版本。使用 oakctl 更新 OS：
  • 下载并安装 oakctl

Linux/MacOS

在 64 位系统上，运行：
Command Line
1bash -c "$(curl -fsSL https://oakctl-releases.luxonis.com/oakctl-installer.sh)"

Windows

下载并使用 Windows 安装程序 进行安装。
  • 运行以下命令更新 OAK4 设备上的 OS：
Command Line
1oakctl device update
按照提示选择设备并输入设备密码。该工具会自动下载最新 OS 版本并刷写到设备上。更新完成后，设备将重新启动。如果使用 oakctl 更新失败，可能需要执行 完全 Luxonis OS 刷写。

无 DHCP

默认情况下，OAK4 会尝试从 DHCP 服务器获取动态 IP 地址。如果网络上没有 DHCP 服务器（例如，通过 PoE 注入器将 OAK-4 直接连接到计算机时），摄像头会回退到 链路本地 地址。 要在这种设置下与设备通信，请将计算机配置为 169.254.0.0/16 子网内的静态 IP——例如：
  • 地址：169.254.10.112
  • 子网掩码：255.255.0.0
配置完成后，在主机计算机的命令行中运行 oakctl list，您应该能看到摄像头被检测到。

设备在 oakctl 中可见，但在 OAK Viewer 中不可见

如果摄像头出现在 oakctl list 中，但 OAK Viewer 显示没有可访问的设备，则可能是网络上的发现方法不同。快速检查：
  1. 更新工具和设备软件：
    • oakctl self-update
    • oakctl device update
  2. 确认主机和摄像头处于同一子网。
  3. 在主机防火墙上允许 11491/udp（发现）和 11490/tcp（XLink）。
  4. 临时禁用 VPN。
  5. 如果主机使用多个接口（Wi-Fi + 以太网），确保到摄像头子网的路由使用正确的接口。
有关完整故障排除详情，请参阅 OAK Viewer 文档。

橙灯（设备问题）

如果灯呈橙色，请联系 support@luxonis.com，因为可能存在设备问题。

重置按钮故障

如果按下重置按钮 5-10 秒无法进入设置模式（蓝灯闪烁）或恢复出厂设置（蓝灯常亮），则按钮可能故障。您仍可通过 oakctl adb shell agentconfd start-setup 切换到设置模式，或通过 oakctl adb shell agentconfd factory-reset 执行恢复出厂设置。要了解如何使用 adb，请参阅“高级”部分。

下一步

探索软件选项

继续了解 OAK4 开发的软件栈、示例和 API。

打开高级指南

通过 SSH 或 ADB 连接、设置静态 IP，或遵循本地设置路径。

请前往 高级 了解如何：

需要帮助？

请前往 OAKChina 官网 获取技术支持或解答您的任何疑问。