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

本页目录

  • 为相机供电
  • 操作系统更新
  • 网络设置
  • 应用程序更新/安装
  • 适用于多个设备的生产工作流程
Claude CodeCodexCursor
Luxonis 智能体工具包为你常用的编程智能体加载 Luxonis 上下文与技能,更快地基于 OAK 开发应用。
安装工具包

OAK4 离线和生产设置

最后更新
当 OAK4 没有直接互联网访问 且您需要可重复的离线或生产线工作流程时,请使用本指南。开始之前:
  • 在主机 PC 上安装 oakctl。
  • 确保您的设备已安装 Luxonis OS 版本 1.37.0 或更高版本。如果您的设备是旧版本,请按照 本指南 进行更新。

为相机供电

供电方式连接
USB 同时用于供电和数据。相机启动至少需要 15W,建议使用 30W 以获得全功率。请使用 PD 额定 USB-C 连接;USB-A 在此设置中不起作用。
PoE+ 用于供电,USB 仅用于数据。在此设置中,USB-C 和 USB-A 都适用。
更多信息,请参阅 为相机供电。

操作系统更新

首先从 Luxonis OS 下载 OTA 文件到主机。如果主机上已存在固定的目标版本,则可以使用该文件进行操作系统更新。将 OTA 文件复制到设备上,然后在设备上运行更新:
Command Line
1oakctl adb root
2oakctl adb push ./full_update_luxonis_ext4-<version>.zip /data/
3oakctl adb shell
4agentconfd update /data/full_update_luxonis_ext4-<version>.zip
5# 然后通过重新连接电源重启相机
有关更多兼容性说明,请参阅 Luxonis OS。

网络设置

选择您希望如何准备设置命令,该命令将设置密码、SSH 状态和 IP 配置。

Build the command manually

如果您想自己组装设置命令,而不是在浏览器中生成它,请使用此路径。按照 本地设置 中的说明将设备置于设置模式。
Command Line
1oakctl start-setup
然后在主机 PC 上运行 oakctl device setup apply 并带上您需要的标志。启用 SSH 并保持 DHCP:
Command Line
1oakctl device setup apply -p <password> --dont-check-internet
启用 SSH 并设置静态 IP:
Command Line
1oakctl device setup apply -p <password> \
2  --static-ip 192.168.10.101,255.255.255.0,192.168.10.1 \
3  --dont-check-internet
禁用 SSH 并设置静态 IP:
Command Line
1oakctl device setup apply -p <password> \
2  --no-ssh \
3  --static-ip 192.168.10.101,255.255.255.0,192.168.10.1 \
4  --dont-check-internet
如果您需要覆盖 DNS,请添加 --dns 10.12.102.2。如果有多个设备可用,请添加 -d <serial-or-ip> 以定位正确的单元。如果每个设备需要唯一的静态 IP,则只需在运行之间调整 --static-ip 值。

Generate command in web GUI

如果您希望生成一个包含新密码、启用或禁用 SSH 以及 IP 设置的命令,请使用此路径:
  1. 使用 oakctl start-setup 将设备置于设置模式。
  2. 打开 setup.luxonis.com。
  3. 打开 Advanced setup using CLI。
  4. 填写您想要的值:
    • 新密码
    • 启用或禁用 SSH
    • DHCP 或静态 IP 设置
  5. 复制生成的终端命令。
  6. 在设备仍处于设置模式时,在主机 PC 上运行生成的终端命令。
这是在多个设备之间保持设置值一致的最简单方法。如果每个设备需要唯一的静态 IP,请为每个单元重新生成命令,或仅在运行之间调整与 IP 相关的值。
有关完整的本地设置演练、其他命令行选项、后续更改网络以及 SSH 或 ADB 访问详细信息,请参阅 OAK4 高级设置。

应用程序更新/安装

提前准备好构建的 *.oakapp 包(如果需要构建您的应用程序,请遵循 oakctl 应用程序构建指南)。然后将包复制到配置 PC 并本地安装:
Command Line
1oakctl app install ./dist/my-app.oakapp
如果已安装具有相同标识符的应用程序,oakctl app install 默认会更新它。 默认情况下,新安装的应用程序是启用并运行的,因此当相机启动时它会自动启动。如果您不希望这种行为,请使用 --enable=false。

适用于多个设备的生产工作流程

为了在多个设备上进行可重复的部署,请准备一套经过批准的工件,并在每个单元上线之前对其应用相同的流程:
  • 一个目标 OS OTA 文件,例如 full_update_luxonis_ext4-<version>.zip
  • 一个经过批准的应用程序包,例如 my-app.oakapp
  • 您希望在每个设备上使用的密码或本地设置值
  • 网络计划:DHCP 或每个设备唯一的静态 IP
当同时连接多个设备时,通过 ADB 在 USB 连接的单元上执行 OS 更新,然后对后续的 oakctl 命令(例如应用程序安装)使用 -d:
Command Line
1oakctl app install -d <serial-or-ip> ./dist/my-app.oakapp
一个实用的每设备流程是:
  • 为设备供电并使用 oakctl list 发现它
  • 如果需要,使用 setup.luxonis.com 生成本地设置命令,以一致地设置密码、SSH 模式和 IP 设置
  • 通过 ADB 将设备更新到批准的 OS 版本
  • 安装预构建的 *.oakapp 包
  • 应用预期的网络配置
  • 在部署前验证预期的 OS 版本、应用程序和 IP 地址

需要帮助?

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