# OAK4 入门指南

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

## 开始之前

为了快速上手，我们制作了一个关于通过 PoE+ 连接相机入门的视频：

视频中的流程在下方有更详细的描述。

## 为相机供电

OAK4 相机最高消耗 25W 功率（峰值），需要使用 PoE+（802.3at，30W）供电设备/交换机（例如
[TL-SG1008P](https://www.tp-link.com/en/business-networking/unmanaged-switch/tl-sg1008p/)）。 通电并启动后，状态灯应变为稳定的蓝色，表示设备已就绪。

> **PoE+ 与互联网**
> **普通 PoE（802.3af，15W）**
> 供电设备/交换机
> **无法提供足够的功率**
> 。建议将交换机
> **连接到互联网**
> 以获得最佳体验。

## 安装并打开 OAK Viewer

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

下载并安装 OAK Viewer：

#### Linux

> Debian 软件包适用于 Ubuntu 24.04 / 22.04，支持 x86_64 (AMD64) 架构。

OAK Viewer 3.0.2 适用于 [Ubuntu 24.04 / 22.04 (x86)](https://oak-viewer-releases.luxonis.com/data/3.0.2/debian_x86_64/viewer.deb)

#### macOS

> Viewer 适用于 macOS 12 及更高版本，支持 ARM（Apple Silicon）和 x86_64（Intel）架构。

OAK Viewer 3.0.2 适用于 [macOS 12+ (ARM)](https://oak-viewer-releases.luxonis.com/data/3.0.2/macos_arm_64/Viewer.zip) | [macOS 12+
(x86)](https://oak-viewer-releases.luxonis.com/data/3.0.2/macos_x86_64/Viewer.zip)

#### Windows

> 请注意，您可能会收到 Microsoft Defender 的警告。Viewer 适用于 Windows 10/11，支持 x86_64（AMD64）架构。

OAK Viewer 3.0.2 适用于 [Windows 10/11 (x86)](https://oak-viewer-releases.luxonis.com/data/3.0.2/windows_x86_64/Viewer.msi)

更多详情请参见 [OAK Viewer 文档页面](https://docs.luxonis.com/software-v3/depthai/tools/oak-viewer.md)。

## 可选：连接到 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。

> **连接到 Hub 会启用 SSH**
> 运行 OS 1.18 或更高版本的设备出厂时禁用基于密码的 SSH；完成 Luxonis Hub 设置会重新启用 SSH，并应用您在该流程中配置的密码。

## 恢复出厂设置

> **恢复出厂设置警告**
> 这会将设备重置为出厂设置，删除所有配置和数据。请务必
> **在继续之前备份任何重要数据**
> 。

如果您需要将 OAK4 设备恢复出厂设置，可以在设备通电时按下硬件重置按钮：

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

## 故障排除

跳转到对应症状：

 * [红灯（功率不足）](#Red%20light%20(insufficient%20power))
 * [蓝灯行为异常](#Blue%20light%20does%20not%20behave%20as%20expected)
 * [设备在 oakctl 中可见但在 OAK Viewer 中不可见](#Device%20visible%20in%20oakctl%20but%20not%20OAK%20Viewer)
 * [无 DHCP](#No%20DHCP)
 * [橙灯（设备问题）](#Orange%20light%20(device%20issue))
 * [重置按钮故障](#Reset%20Button%20malfunction)

### 红灯（供电不足）

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

某些 PoE 注入器（如 [Ubiquiti 的 PoE+
注入器](https://store.ui.com/us/en/category/accessories-poe-power/collections/pro-store-poe-and-power-adapters/products/u-poe-plus?variant=u-poeplus)）能提供足够电力，但未发出合规信号。此时
OAK4 会在启动前红灯闪烁，启动后变为蓝灯。

### 蓝灯行为异常

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

使用 oakctl 更新 OS：

 * 下载并安装 oakctl

#### Linux/MacOS

在 64 位系统上，运行：

```bash
bash -c "$(curl -fsSL https://oakctl-releases.luxonis.com/oakctl-installer.sh)"
```

#### Windows

下载并使用 [Windows 安装程序](https://oakctl-releases.luxonis.com/data/latest/windows_x86_64/oakctl.msi) 进行安装。

 * 运行以下命令更新 OAK4 设备上的 OS：

```bash
oakctl device update
```

按照提示选择设备并输入设备密码。该工具会自动下载最新 OS 版本并刷写到设备上。

更新完成后，设备将重新启动。如果使用 oakctl 更新失败，可能需要执行 [完全 Luxonis OS 刷写](https://docs.luxonis.com/software-v3/sw-stack/luxonis-os.md)。

### 无 DHCP

默认情况下，OAK4 会尝试从 DHCP 服务器获取动态 IP 地址。如果网络上没有 DHCP 服务器（例如，通过 PoE 注入器将 OAK-4 直接连接到计算机时），摄像头会回退到
[链路本地](https://en.wikipedia.org/wiki/Link-local_address) 地址。 要在这种设置下与设备通信，请将计算机配置为 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](https://docs.luxonis.com/software-v3/depthai/tools/oak-viewer.md) 文档。

### 橙灯（设备问题）

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

### 重置按钮故障

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

## 下一步

### 探索软件选项

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

[探索软件选项](https://docs.luxonis.com/software-v3.md)

### 打开高级指南

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

[打开高级指南](https://docs.luxonis.com/hardware/platform/deploy/oak4-deployment-guide/oak4-advanced.md)

请前往 [高级](https://docs.luxonis.com/hardware/platform/deploy/oak4-deployment-guide/oak4-advanced.md) 了解如何：

 * [通过 SSH/ADB 连接](https://docs.luxonis.com/hardware/platform/deploy/oak4-deployment-guide/oak4-advanced.md)
 * [设置静态 IP](https://docs.luxonis.com/hardware/platform/deploy/oak4-deployment-guide/oak4-advanced.md)
 * [本地设置](https://docs.luxonis.com/hardware/platform/deploy/oak4-deployment-guide/oak4-advanced.md)

### 需要帮助？

请前往 [OAKChina 官网](https://www.oakchina.cn/) 获取技术支持或解答您的任何疑问。