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

本页目录

  • 通过 SSH 或 ADB 连接到相机
  • 设置静态 IP
  • 配置 DNS
  • 本地设置
  • 恢复出厂设置
  • 常见问题
Claude CodeCodexCursor
Luxonis 智能体工具包为你常用的编程智能体加载 Luxonis 上下文与技能,更快地基于 OAK 开发应用。
安装工具包

OAK4 高级设置

最后更新

通过 SSH 或 ADB 连接到相机

SSH

通过 PoE+ 或 USB 连接

您可以通过 PoE+ 或 USB 为相机供电。如果您通过 USB 供电并希望进行 SSH 访问,则必须通过以下方式启用 PC 网络连接共享到相机:
Command Line
1oakctl usbd enable  # 在主机 PC 上运行

在相机上启用 SSH

默认情况下,在运行 OS 版本 1.18 及更高版本的设备上,通过密码进行 SSH 访问是禁用的。有两种方法可以启用它:
  • 使用 Luxonis Hub 或 本地 设置相机,可以使用给定密码启用 SSH 访问,
  • 在主机计算机上执行 oakctl device unlock,同时设备连接在同一网络上(下载并安装 oakctl)。

用法

要通过 SSH 访问设备,您需要知道其 IP 地址。您可以通过运行 oakctl list 来查找本地网络中的 OAK 设备。或者,您也可以检查路由器上的 DHCP 租约,或使用 nmap 等网络扫描工具或某些 IP 扫描应用程序。
Command Line
1$ oakctl list  # 查找本地网络中 OAK 设备的 IP
2$ ssh root@IP_ADDRESS  # SSH 连接到设备
要将文件传输到设备,您可以使用 scp:
Command Line
1$ scp folder/file.txt root@IP_ADDRESS:/data/
2# 或者一个文件夹
3$ scp -r folder/ root@IP_ADDRESS:/data/

ADB

通过 USB-C 连接

ADB 仅通过 USB 可用。将相机直接连接到可提供至少 15 W 功率的 USB 3.0 端口;否则,相机可能无法开机。请参阅其他供电选项。

通信:

通过 USB-C 连接到计算机时,OAK4 将被检测为 USB 设备,并通过 ADB(Android 调试桥)进行访问。这对于调试和开发目的很有用,但不允许运行 depthAI 和 oakctl 脚本。

准备

在主机计算机上安装 oakctl 工具,因为它捆绑了您需要的 adb 命令。

用法

要通过 ADB 访问设备,您需要在主机计算机上运行以下命令:
Command Line
1$ oakctl adb devices
如果设备已列出,您可以继续使用以下命令在设备上打开 shell:
Command Line
1$ oakctl adb shell
要将文件传输到设备,您可以使用 oakctl adb push:
Command Line
1$ oakctl adb root
2$ oakctl adb push folder/file.txt /data/
3# 或者一个文件夹
4$ oakctl adb push folder/ /data/

设置静态 IP

当相机必须保持一个恒定、可预测的地址,以便其他系统可以可靠地引用时,静态 IP 会很有帮助。此配置假定您已与相机建立活动连接。您可以通过以下方式手动设置静态 IP:
  • 使用 Luxonis Hub 或 本地 设置相机时的高级设置。
  • 通过连接到相机(ADB/SSH)并使用 agentconfd configure 工具:
Command Line
1agentconfd configure --help
2用法:agentconfd configure [选项] [NETWORK_CONFIG]
3
4参数:
5  [NETWORK_CONFIG]  “dhcp”或“ipv4,ipv4_mask,ipv4_gateway”
因此,您可以设置静态 IP 地址或恢复为 DHCP:
Command Line
1# 首先通过 ADB/SSH 连接到设备,然后在设备上设置静态 IP:
2agentconfd configure 192.168.10.15,255.255.255.0,192.168.10.1
3# 恢复为 DHCP:
4agentconfd configure dhcp

配置 DNS

使用 DHCP 时,您仍然可以覆盖设备使用的 DNS 服务器。这在封闭网络中、DHCP 服务器不提供 DNS 或您需要将设备指向特定解析器时很有用。首先连接到相机(通过 SSH 或 ADB),然后运行:
Command Line
1# 首先通过 ADB/SSH 连接到设备,然后在设备上运行:
2agentconfd configure dhcp --dns 10.12.102.2
如果名称解析仍然失败,请尝试已知的公共解析器(仅当您的网络策略允许时):
Command Line
1agentconfd configure dhcp --dns 8.8.8.8
示例会话:
Command Line
1~ # agentconfd configure dhcp --dns 10.12.102.2
2[2026-02-06T13:49:15Z INFO  agentconfd] 成功!
3~ # ping google.com
4ping: bad address 'google.com'
5~ # agentconfd configure dhcp --dns 8.8.8.8
6[2026-02-06T13:49:30Z INFO  agentconfd] 成功!
7~ # ping google.com
8PING google.com (142.250.203.142): 56 数据字节
9来自 142.250.203.142 的 64 字节:seq=0 ttl=251 time=11.978 ms
10来自 142.250.203.142 的 64 字节:seq=1 ttl=251 time=14.046 ms
如果通过主机名 ping 失败但通过 IP ping 成功,则 DNS 配置错误。调整 DNS 服务器或验证您的网络是否允许出站 DNS。

本地设置

本节介绍使用 oakctl 设置 OAK 设备的高级路径,包括无法访问互联网的情况。当您需要完全本地控制设置过程时,可以使用此方法——例如:
  • 在不连接到 Luxonis Hub 的情况下设置相机。
  • 启用 SSH 访问以进行开发或调试。
  • 本地重置设备密码。
  • 配置高级网络设置,例如在 DHCP 不可用时分配静态 IP。
在这些场景或任何网络限制或工作流要求阻止使用标准基于云的设置的环境中,请使用本地设置。

为设备供电

连接 PoE/ETH 电缆为设备供电。

验证 oakctl 版本

通过执行 oakctl version 确保您已安装 0.16.2 或更高版本的 oakctl。如有必要,请使用 oakctl self-update 进行更新。

将设备置于设置模式

通过将设备置于设置模式,确保设备已准备好进行设置(相机上的状态灯闪烁蓝色):
Command Line
1oakctl start-setup

设置您的设备

使用 setup.luxonis.com

如果您想要一个简单、有指导的本地设置体验,请使用此选项。基于 Web 的向导会自动为您的部署生成配置值。转到 setup.luxonis.com 并选择 Setup Locally,然后按照屏幕上的说明配置您的相机。

使用命令行

如果您没有互联网访问权限和/或希望使用命令行设置相机,此选项很有用。设置密码和启用 ssh 的最小命令:
Command Line
1oakctl setup -p <在此处插入密码> --dont-check-internet
并确保将命令中的 <在此处插入密码> 替换为您首选的密码。要查看其他选项,请执行 oakctl setup --help。

恢复出厂设置

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

按住重置按钮

按住重置按钮10 秒。大约 5 秒后,前置 LED 闪烁橙色。继续按住;大约 10 秒后,LED 闪烁红色,然后熄灭,表示已开始恢复出厂设置。

松开重置按钮

LED 熄灭后松开按钮,等待设备重新启动(这可能需要几秒钟)。

常见问题

USB 和 PoE 可以同时使用吗?是的,如果您的目标是:
  • 通过 USB 供电并使用非 PoE 电缆进行通信。
  • 通过 PoE 供电并使用 USB 进行 ADB 通信

需要帮助?

请访问讨论论坛以获取技术支持或您可能有的任何其他问题。