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

本页目录

  • 更新操作系统
  • 从主机更新(保留数据)
  • 从设备更新(保留数据)
  • 完整 OS 刷写(擦除数据)
  • 使用恢复模式更新 OS(最后手段)
  • 启用 SSH
  • pip
  • 更新日志
  • 1.41.0
  • 1.40.0
  • 1.37.0
  • 1.35.0
  • 1.33.0
  • 1.32.1
  • 1.31.2
  • 1.30.1
  • 1.29.2
  • 1.27.1
  • 1.25.3
  • 1.24.0
  • 1.23.1
  • 1.23.0
  • 1.21.1
  • 1.20.5
  • 1.18.3
  • 1.15.0
  • 1.14.1
  • 1.13.1
  • 1.11.0
  • 1.8.0
  • 1.6
  • 1.5
  • 1.4.1
  • 1.4
  • 1.3
  • 1.2
  • 1.1
  • 1.0
  • 0.26
  • 0.25
  • 0.24
  • 0.23
  • 0.22
  • 0.21
  • 0.20
Claude CodeCodexCursor
Luxonis 智能体工具包为你常用的编程智能体加载 Luxonis 上下文与技能,更快地基于 OAK 开发应用。
安装工具包
最后更新
Luxonis OS 是一个基于 Yocto 的定制 Linux 发行版。它是为围绕 RVC4 芯片构建的相机定制设计的,因为该芯片具有 6 核 ARM CPU。该操作系统预装在所有 OAK4 相机上,并且可以更新以获取最新功能。我们假设您已经知道如何通过 SSH 或 ADB 连接到您的设备,因为这是传输文件和发送一些更新命令所必需的。首先,通过 SSH 或 ADB 连接到设备,然后在设备上运行以下命令来检查您的操作系统版本:
Command Line
1cat /etc/os-release

更新操作系统

您的设备提供多种更新方法,因此您可以从系统的不同部分更新它,保持跨 OS 版本的兼容性,并在一种方法失败时提供可靠的备用方案。我们建议在执行命令之前阅读所有步骤和警告。跳转到方法:

从主机更新(保留数据)

您可以使用 oakctl 主机命令行工具从主机(例如您的 PC)更新您的设备。这允许您:
  • 更新并保留数据 - 不删除设备上的用户数据
  • 直接从主机更新 - 您无需使用 SSH 或 ADB 连接到设备

步骤

  1. 下载并安装 oakctl 工具。
  2. 确保您已安装最新版本的 oakctl。
Command Line
1oakctl self-update
然后运行以下命令更新设备操作系统:
Command Line
1oakctl device update
等待更新完成。设备将在更新后自动重启。

示例输出

Command Line
1$ oakctl device update
2> Do you want to update to the latest firmware? Yes
3✔ Starting firmware update...          
4✔ Update processed                                                                                                                                                                
5✔ Device is offline, should be back online soon.
6✔ Device is back online.
7✔ Device updated successfully!
8Device Info:
9  OS:   Luxonis OS RVC4 1.44.0
10  Architecture:  linux/arm64
11  Model:  Luxonis, Inc. KalamaP OAK4-D R2
12	Platform:  rvc4

从设备更新(保留数据)

您可以通过 SSH 或 ADB 登录设备,然后使用 agentconfd 命令行工具更新设备。这使您能够:
  • 更新并保留数据 - 不删除设备上的用户数据
  • 无需在主机上安装任何东西即可更新
  • 使用 URL 更新(简单,单命令更新,但相机需要有互联网访问权限)
  • 使用本地下载的 OTA 文件更新(多命令更新,但相机不需要互联网访问权限)

选项 1:使用 URL 更新

Command Line
1# 首先通过 ADB/SSH 进入设备,然后在设备上运行:
2agentconfd update https://luxonisos-rvc4.fra1.digitaloceanspaces.com/OTA/full_update_luxonis_ext4-1.44.0.zip
3reboot  # 更新后重启设备

选项 2:使用下载的 OTA 更新文件更新

  1. 下载最新 1.44.0 版本的 OTA 更新文件(其他版本可在 更新日志 中找到)。
  2. 将下载的 full_update_luxonis_ext4-1.44.0.zip 镜像(通过 scp 或 adb push)复制到设备 - 请参阅 直接访问设备。
  3. 通过 SSH 或 ADB 连接到相机,并在设备上运行以下命令:
Command Line
1# 首先通过 ADB/SSH 进入设备,然后在设备上运行:
2agentconfd update /data/full_update_luxonis_ext4-1.44.0.zip
3reboot  # 更新后重启设备

完整 OS 刷写(擦除数据)

您可以使用 oakctl 命令行工具从主机向设备刷写新 OS。这使您能够:
  • 更新 OS,在此过程中完全擦除所有用户数据
  • 更新运行任何 OS 版本的设备(甚至是 OS 1.x 及更早版本)
  • 通过 USB3 刷写设备

准备

  1. 下载并安装 oakctl 工具。
  2. 将相机与 PoE M12 电缆(用于供电)和 USB3 电缆连接到 PC(用于刷写)。
  3. 然后遵循以下两个选项之一:

选项 1:使用 URL 刷写

Command Line
1oakctl device reflash https://luxonisos-rvc4.fra1.digitaloceanspaces.com/PRODUCTION/luxonis_os_rvc4-1.44.0.tar.xz

选项 2:使用下载的文件刷写

  1. 首先,下载 完整刷写 .tar.xz 镜像(最新 1.44.0,其他版本可在 更新日志 中找到)并解压它(例如,使用 7-Zip/WinRAR/tar)。
  2. 使用 oakctl 和下载文件的路径执行完整 OS 刷写。
Command Line
1oakctl device reflash <path-to-downloaded-image>

如果在执行完整 OS 刷写时遇到错误

这可能是因为 USB 在 EDL 模式下有时不可靠。请确保:
  • USB 电缆和端口支持 USB3
  • 您使用高质量的 USB3 电缆
  • 您尝试所有可能的 USB-C 电缆方向(每次尝试之间断电)
  • 尝试 PC 上的不同 USB 端口

使用恢复模式更新 OS(最后手段)

  1. 下载最新版本的 OTA 更新文件(其他版本可在 更新日志 中找到)。
  2. 将下载的 full_update_luxonis_ext4-1.44.0.zip 镜像(通过 scp 或 adb push)复制到设备 - 请参阅 直接访问设备。
  3. 通过 SSH 或 ADB 连接到相机,并在设备上运行以下命令:
Command Line
1# 首先通过 ADB/SSH 进入设备,然后在设备上运行:
2recovery --wipe_cache --update_package=/data/full_update_luxonis_ext4-1.44.0.zip
3reboot

启用 SSH

在某些较新的 OS 版本中,SSH 默认禁用(OS 版本 1.18 及更高版本)。要启用它,您首先需要通过 ADB 连接到设备并启用 SSH。
  • 下载 sshd_config 文件 - 右键单击并另存为 sshd_config。
  • 打开终端并通过运行以下命令将下载的文件推送到设备:
Command Line
1oakctl adb root && oakctl adb push sshd_config /etc/ssh/sshd_config
  • 重启设备
  • [可选] 现在您可以通过 SSH 连接到设备(默认密码 oelinux123)。如果您希望禁用密码,请在连接到设备(通过 ADB 或 SSH)时运行 passwd -d root。

pip

默认情况下,OS 上未安装 pip,因此用户必须手动安装:
Command Line
1python3 -m ensurepip

更新日志

(2026 年 9 月 28 日) - OTA 更新,完整 OS 刷写
  • 添加 IFE 共享功能
  • 为 OG05B1B 传感器添加窄视场和宽视场单色调优配置文件
  • 添加 safe-halt 命令以在不触发看门狗重启的情况下关机
  • 修复 EDK2 引导加载程序中的 PoE+ 功率检测
  • 通过以宽容模式启动 SELinux 来修复启动时跳过 CPU 功率配置文件限制的问题
  • 通过在 CDSP 固件初始化完成后启动 agentconfd 来修复启动时 CDSP 功率配置文件竞争问题
  • 通过在 init-luxonis-system.service 完成后启动 NetworkManager 来修复以太网 MAC 初始化竞争问题
  • 修复在 OTA 更新关键点断电时设备无法启动的问题
  • 在启动时更早地应用设备树覆盖,以便硬件为启动服务/消费者做好准备
  • 修复 Qualcomm 串口上的 UART 奇偶校验处理
  • 停止 STM32 FSYNC 信号并在控制器 (/dev/fsync-stm) 关闭时恢复其配置

1.41.0

(2026 年 9 月 15 日) - OTA 更新,完整 OS 刷写
  • 抑制 UART 控制台上的 systemd 消息
  • USB 稳定性改进
  • 将 STM32 固件升级到 54568:
    • 修复由于错误的 fsync 导致的 DepthAi 崩溃
    • 支持高频频闪引脚配置
  • 修复 OAK4-FFC 设备的 IMU 轴向
  • 将 oak-agent 升级到 v0.27.1,将 oakctl 升级到 v0.30.1:
    • 修复在 oakapp.toml 中更改 base_image 后 oakctl app run . 出现 static-fe: no such file or directory 错误
    • 修复 oakctl app install --update 后 app config 被删除的问题
    • 保留通过 --env 标志传递的应用程序配置值中的 =
    • oakctl app restart 现在将应用程序状态更改为 restarting,而不是先 stopping 后 starting
  • 修复流式传输期间计算性能受限的问题

1.40.0

(2026 年 8 月 24 日) - OTA 更新,完整 OS 刷写
  • 将 oak-agent 升级到 v0.26.0,oakctl 升级到 v0.27.3,agentconfd_daemon 升级到 v1.15.0
  • 从 CCM EEPROM 自动检测 ToF 传感器类型(宽/窄)并选择合适的 VCSEL 电压
  • 添加树外 LM3466 LED 内核驱动程序
  • 添加树外 LM75 内核驱动程序(也支持 TMP112)
  • 支持 PM8010 PMIC I2C 地址重新配置
  • 将较旧的 CDSP 设备别名从 /dev/adsprpc-smd 重命名为 /dev/fastrpc-cdsp
  • 添加 NPU 运行时包
  • 支持相机内核中的 CCI I2C 总线子节点
  • 通过 hwmon 和 thermal_zone 框架公开 STM32 FSYNC 控制器 NTC 温度
  • 改进 DEV-KIT 上的 TPS25750 芯片中断处理
  • 修复点投影仪和泛光 LED 的低亮度问题:
    • 为 IR DOT 和 FLOOD 使能引脚添加新模式,以防止开关 LED 驱动器进入睡眠模式
  • 修复 8 核设备意外的无限性能上限:为 15W 功率配置文件添加缺失的策略
  • 修复 xbl 引导加载程序中 OAK4-FFC 上的 USB 功率检测
  • 修复 OAK4-D 上的 USB 首次插入问题:添加 USB 合规模式恢复
  • 如果 TPS2570x 合同不可用,则默认使用性能功率配置文件启动
  • 仅在检测到过时固件时才刷写 STM32
  • 修复 ToF 传感器的激光安全触发器导致所有其他流崩溃的问题
  • 改进相机传感器恢复和重启行为:
    • 继续恢复尝试,超出以前的固定重试限制,而不是中止
    • 在完全恢复期间正确关闭和重新打开传感器
    • 允许 depthai-device 根据每个套接字传感器错误 GPIO 否决 SIGABRT
  • 禁用 perf-hal 服务:
    • 修复 ToF 传感器流的性能问题
    • 防止 CamX 干扰 Luxonis 设置的功率/频率配置文件

1.37.0

(2026 年 7 月 31 日) - OTA 更新,完整 OS 刷写
  • 添加禁用调试 UART 和 Qualcomm Sahara 的支持
  • 将 oak-agent 升级到 v0.25.0,oakctl 升级到 v0.26.0:
    • 支持禁用调试 UART 和 Qualcomm Sahara
  • 提高 USB 以太网的可靠性:
    • 当 usb0 在 USB 角色切换后重新创建或移动时,恢复链路本地配置
    • 通过强化 USB 小工具重新绑定和暂停/恢复处理来修复设备崩溃
  • 修复在高吞吐量网络和高内存压力下设备崩溃的问题:
    • Realtek PCIe 以太网驱动程序现在从 Qualcomm SMMU 请求原子 DMA 上下文
  • 改进引导加载程序板配置处理,用于硬件检测、按钮和电源功能
  • 修复 CamX 中 OAK4-Lite 设备的设备模型解析:
    • 1.36.0 中引入的回归
  • 将 depthai-gate 升级到 v0.0.29:
    • 修复 RVC4 USB 崩溃转储检索
  • 将 agentconfd 守护程序升级到 v1.13.2,CLI 升级到 v1.8.1,消息升级到 v1.7.1,设置应用程序升级到 v1.2.1:
    • 修复 OAK4-S 上的 M8 WiFi 加密狗设置
    • 实现正确的 WiFi 设置映射
    • 通过在无载波网络链路上不失败来修复离线设置
    • 通过应用性能 CPU 频率调节器来提高性能一致性
    • 为 Luxonis 用户空间组件添加已安装的许可证通知

1.35.0

(2026 年 7 月 8 日) - OTA 更新,完整 OS 刷写
  • 添加对新设备类型:OAK4-FFC R0 的支持
  • 将 agentconfd 升级到 v1.13.0 以支持 OAK4-FFC R0
  • 将 oak-agent 升级到 v0.23.0 以修复容器存储修剪问题
  • 使用 PTP 改进相机传感器帧时间同步:
    • 同步不同相机传感器类型和不同原生分辨率的帧
    • 更好、更快的同步锁定功能
    • 在 IMX586、OV9282 和 OG05B10 上测试并支持

1.33.0

(2026 年 6 月 5 日) - OTA 更新,完整 OS 刷写
  • 如果输入功率有限(小于 25W),则以省电模式启动
  • 在 STM32 固件中添加点投影仪温度测量功能
  • 在内核中启用/添加自定义 UVC 扩展 (XUs)
  • 实现自动曝光的最大 ISO
  • 将 agentconfd 升级到 v1.12.0:
    • 支持有限功率模式的功率配置文件
  • 将 oak-agent 升级到 v0.22.1:
    • 修复容器占用磁盘空间的问题
  • 移除/修复曝光达到最大值时 PTP 的帧持续时间覆盖
  • 修复未插入 USB-C 电缆时启动时间过长的问题:
    • 1.32.0 中引入的 USB ETH 功能导致的回归
    • 修复 OV9782 传感器的颜色渲染

1.32.1

(2026 年 5 月 19 日) - OTA 更新,完整 OS 刷写
  • 添加对 OAK4-Lite 的 iToF VD55H1 的基本支持
  • 添加 UVC 静态图像捕获支持
  • 添加 USB 以太网 (NCM) 支持
  • 电源配置文件:
    • 为 OAK4-Lite PoE 版本引入 +50 °C、+25 °C 和 -25 °C 的电源配置文件
    • 在重启期间保留上次用户选择的电源配置文件
    • 引导加载程序中的板载特定 USB 功率限制(如果输入功率不足,则红色 LED 闪烁,但为每个板单独设置最低所需功率)
  • 将 oakctl 版本升级到 v0.20.0,oak-agent 升级到 v0.20.0,agentconfd 升级到 v1.11.0
  • 对于开发人员:
    • 将 CCI I2C 作为普通 I2C 设备公开(便于开发)
  • 停止将 logcat 文件记录到持久存储,因为它会过快地填满磁盘空间
    • 1.28.0 中引入的回归
  • 将 OAK4-Lite 设备拆分/重构为两个变体:USB 和 PoE
  • 修复 OAK4-D 上的 OV9782 传感器驱动程序

1.31.2

(2026 年 5 月 7 日) - OTA 更新,完整 OS 刷写
  • 更新 agentconfd 守护程序到 v1.10.1
    • 为 OAK4-LITE 添加了 M8 检测支持
    • 添加了基本电源配置文件,将 OAK4-LITE 的峰值功耗限制在 15 W
  • 更新 oak-agent 到 v0.19.1,oakctl 到 v0.20.0
    • 为 oakctl device update 添加了新标志 (--url、--path、--local)
  • 修复 IMX586 传感器在 HFR 模式下的裁剪问题
  • 修复 IMU 方向并统一所有设备的方向
  • 修复持久日志无限期地填满磁盘空间的问题
    • 1.28.0 中引入的回归
  • 在引导加载程序中添加 USB PD 功率查询和协商支持
    • 当电源无法提供至少 25 W 时,红色 LED 现在会闪烁

1.30.1

(2026 年 4 月 10 日) - OTA 更新,完整 OS 刷写
  • 添加了对新板类型:OAK4-LITE 的基本支持
  • 添加了 IMX586 4K@60 FPS 支持
  • 将 NN 模型更新到 1.2.2410
  • 添加了 M8 WiFi 加密狗支持 (Ezurio)
  • 将 agentconfd 更新到 v1.9.1:
    • 添加了 WiFi 支持
  • 修复了某些 OV9282 CCM 上的泛光问题
  • 将 DNS 所有权转移到 systemd-resolved,从而将 DNS 更新传播到正在运行的容器,而无需重启
  • 对于开发人员:
    • 将传感器模式 HDR、HFR、FOV 暴露给 DepthAI
    • 针对非全 FOV 传感器模式的 DepthAI 图像转换正常工作
    • 针对非全 FOV 模式的传感器图像对齐正常工作

1.29.2

(2026 年 4 月 8 日) - OTA 更新,完整 OS 刷写
  • 启用所需的 Linux 内核功能(cgroups、命名空间、netfilter、IPVS)以改进对 Docker 和 K3s 的容器支持
  • 通过 sysfs 公开协商的 USB PD(电力传输)电压和电流
  • 实现带压缩和旋转的持久日志记录(内核、logcat、systemd journal)
  • 将 agentconfd 守护程序更新到 v1.8.1,cli 更新到 v1.6.0,消息更新到 v1.6.0
  • 将 oak-agent 更新到 v0.18.6,oakctl 更新到 v0.18.6
  • 在设备树中添加 INA700 measurement_target 参数,以便更轻松地与 agentconfd 配合使用
  • 修复 busybox wget 以正确使用 CA 证书
  • 标准化内核版本控制(不带自定义后缀的干净版本字符串)

1.27.1

(2026 年 3 月 3 日) - OTA 更新,完整 OS 刷写
  • 添加对 OAK4-D 上 2 MIPI 通道 OG05B1B 传感器的支持
    • 2592x1944 @ 45 FPS
    • 1920x1080 @ 90 FPS
  • 通过 PulseAudio 配置启用立体声麦克风支持:
    • regular0 - PAL_STREAM_DEEP_BUFFER(启用回声消除的后处理)
    • regular1 - PAL_STREAM_RAW
    • regular2 - PAL_STREAM_LOW_LATENCY
  • 更新 OG05B10 调优配置文件
  • 更新 depthai-gate 以支持 DAI USB
  • 修复连接到 USB-PD 时的 USB 枚举问题。正确枚举为 USB3 而不是 USB2
    • 配置 TPS 以中断方式工作
    • 通过更好的中断处理改进 TPS 驱动逻辑
    • 改进连接到 USB-PD 时的 TPS 启动序列
  • 修复不工作的 WinUSB 描述符。
  • 改进 OG05B10 驱动程序以匹配 STM 信号发生器的 FSYNC 值

1.25.3

(2026 年 2 月 19 日) - OTA 更新,完整 OS 刷写
  • 添加相机 PTP 功能以同步相机帧
    • 将以太网驱动程序更新为支持 PTP 的自定义 rtl8125
  • 启用 12 MHz 相机时钟
  • 使用 OpenSSL 在 wget 中添加 TLS 支持
  • 将 SNPE 库更新到 v2.41
  • 在 Luxons USB 描述符接口上添加 USB 突发模式
  • 将 oak-agent 更新到 v0.18.3
  • 将 oak-ctl 更新到 v0.18.2
  • 将 agentconfd 更新到 v1.7.1:
    • 在 SetupParameters 中添加可配置的 oak-agent 路径(conf_dir、conf_file 和 apps conf dir)
  • 修复偶尔出现的双流相机崩溃问题
  • 通过删除冗余用例来简化 CAMX 相机管道

1.24.0

(2026 年 2 月 2 日) - OTA 更新,完整 OS 刷写
  • 为 OAK4-D 设备上使用的 PZ029 CCM 添加 OG05B10 传感器调优
  • 将 depthai-gate 更新到 0.0.26
  • 使用 FSYNC over STM 改进相机同步逻辑
    • 允许加载自定义固件用于调试
    • 改进错误处理
    • 移除 GPIO 控制
    • 移除启动时的内核加载和卸载
    • 仅在不可恢复的故障时卸载内核
    • 动态检测 STM 总线和地址
    • 添加命令以显示动态检测到的 I2C 总线和地址
    • 在引导加载程序模式下检测设备
    • 添加缺失的 STM FSYNC 引脚
    • 添加外部 I/O FSYNC 引脚数据
    • 重命名 STM LED 限制字段
    • 添加关机钩子
    • 添加最近频率查询
    • 添加 ioctl:使用定点小数 FPS 设置相机数据
    • 重命名 LED 限制变量
    • 更新 STM 固件
    • 修复:自动降级以匹配 STM 固件与内核驱动程序
    • 修复:如果 STM 卡在引导加载程序模式,则重试刷写
    • 修复:如果 STM 固件损坏,则强制重新刷写
  • 将 agentconfd 守护程序从 v1.6.2 更新到 v1.6.5,并进行以下更改:
    • 在开发套件上添加了 M8 检测线
    • 修复 3 分钟后静态 IP 回滚
    • 修复 /etc/agentconfd/.update_status.json 文件可能暂时为空的潜在错误
    • 修复 agentconfd update --status
    • 修复 OTA 更新状态在 OTA 更新期间突然断电后进入错误状态
  • 修复:使 OTA 在 OTA 更新期间对电源循环具有鲁棒性,这在 1.19.0 版本中未正确应用

1.23.1

(2026 年 1 月 8 日) – OTA 更新,完整 OS 刷写
  • OG05B10 调优应用修复

1.23.0

(2025 年 12 月 25 日) – OTA 更新,完整 OS 刷写
  • OG05B10 传感器:
    • 迁移到 4 通道 DPHY MIPI
      • 2592x1944@60
      • 1920x1080@90 中心裁剪
    • 添加调优的 chromatix 配置文件
    • 为 OAK4-D 设备启用传感器
  • 添加 luxonis .dlc 模型:SMv4_3XL_input_780x1248_output_780x1248_v9_snpe_2320
  • 引入 DEV-KIT R6 版本
  • 默认情况下,将 USB2 线路由到 USBC 连接器,用于 OAK4-S R9 硬件版本。这修复了 OAK4-S R9 的 USB2 问题。
  • 重新添加 CONFIG_RTNICPG,由 RTL MAC 地址编程使用。

1.21.1

(2025 年 12 月 1 日) – OTA 更新,完整 OS 刷写
  • 更新帧时间戳处理以移除 qtime_to_boottime 计算,修复 DAI 的帧时间戳生成
  • 添加 Luxonis USB 接口
    • 接口 3:Luxonis DepthAI Gate
    • 接口 4:Luxonis DepthAI Device
  • 集成 UVC 驱动程序更新,使 OAK UVC 应用程序能够在主线 OS 上运行
  • 在文件系统上启用数据日志记录,以防止断电期间数据损坏

1.20.5

(2025 年 10 月 27 日) – OTA 更新,完整 OS 刷写
  • 引入限制最大曝光时间的功能
  • 公开 HDR 控制参数:曝光比和色调权重
  • 添加 IMX586 传感器原生分辨率:2K@119、1080p@240 和 720p@480
  • 为 2 通道 dphy 提供 OG05B10 生产配置
    • 2592x1944@45。从 53 降低以提高稳定性
    • 1920x1080@90。中心裁剪而不是末端裁剪
    • 调整图像方向以匹配 OAK4S-CS 设备上安装的传感器
  • 将 depthai_gate 更新到 0.0.25。迁移到直接 HAL 相机控制,放弃 qmmf 和 gstreamer 依赖项
  • 为简化起见,将以太网接口重命名为 eth0
  • 添加对 IPv4LL 的支持
  • 添加对动态调优配置文件更改的支持
  • 为 OV9282 宽视场和 NFOV 添加 Luxonis 调优配置文件
  • 将 agentconfd 更新到 v1.6.2,oak-agent 更新到 0.17.0
    • agetnconfd:发布说明:
    • 出厂重置按钮监视器:修复了在 10 秒出厂重置按钮按住期间 start-setup 可能错误执行的竞争条件
    • 修复:agentconfd 设置或配置后 /etc/resolv.conf 有时为空
    • 修复:无互联网故障和长时间超时设置
    • 修复:agentconfd 更新 OTA 包在不稳定网络上下载失败
    • 修复:agentconfd 更新在恢复阶段 CTRL+C 时不会被正确终止。CLI 会挂起,但实际更新会被终止
    • 功能:为 UpdateParameters 添加了可选的 --checksum 功能:实现了对下载的 OTA 包的校验和检查
  • 将默认应用程序(查看器)更新到 v1.4.51
  • 降低 IR 点和泛光电流限制。确保系统保持在 25 W 功率预算内。
    • 扩展 STM 工具以支持 LED 电流控制
    • 修复 IPv4LL 以避免在超时后未找到 DHCP 时清除本地地址
  • 将 USB 速度限制为 SuperSpeed (5 Gbps),以避免在某些设备上观察到的问题
  • 改进 Camx 退出期间 LuxonisSideChannel 关机处理
  • 对焦改进:
    • 通过适当的执行器步长和范围改进自动对焦算法。
    • 优化初始启动代码以与选定的调优配置文件对齐。
    • 在 DEVKIT R2 和 R3 版本上启用执行器支持。
  • 修复 IO 设置以匹配预期的标称电气值
  • 使 OTA 在 OTA 更新期间对电源循环具有鲁棒性
  • 限制 BOB 功率轨以防止电压尖峰超过 3.6V

1.18.3

(2025 年 9 月 4 日) – OTA 更新,完整 OS 刷写
  • 修复 devkit R3 上缺失的以太网 phy
  • 在 OAK4-S 上禁用通过出厂重置按钮进行快速启动
  • 使用 sysMonApp 版本 10.0.29
  • 修复 oak4-s R9 fsync stm 复位引脚。 该引脚被配置为低电平有效,尽管它是高电平有效。这导致 stm 在新设计上无法工作
  • 添加对 OAK4-S R9 版本的支持
  • 添加对 OAK4-D R9 版本的支持
  • 添加对 DEV-KIT R3 版本的支持
  • 添加对 INA 功率测量设备的支持
  • 相机优化: 如果不需要,请勿选择 8k 分辨率,因为它占用 2 个 IFE
  • IMX586 改进:
    • 通过引入 HDR3 改进 HDR
  • 添加对 2 通道 DPHY 的 OG05B1B 支持:
    • 2592x1944@53
    • 1920x1080@90
    • AEC 控制
  • 改进 OG051B0
    • 调优配置以获得更稳定、更少噪声的输出
    • 改进动态分辨率/帧率检测
    • 引入 2 通道 DPHY 作为默认设置
  • 添加 OG01A1B:默认不启用
    • 1280x1024@120
    • AEC 控制
  • 将 default-app 更新到 1.4.7
    • 修复 Hub 设置与打开默认应用程序的问题
    • 修复 Yolo World 模型缓存和配置表单
    • 修复点云面板上的操作按钮。
    • 支持深度流上的鼠标测量
  • 将 oak-agent 更新到 v0.14.0:
    • 更大的队列用于处理 mqtt 事件,从而减少消息丢失的可能性
    • 增加 WebRTC 连接重试次数
    • 通过不将 mqtt 事件转发到库(如果没有活动的代理连接)来改进 mqtt 事件的处理
    • 修复 mqtt 处理程序中的死锁
    • 热修复了在失去互联网连接后可能出现的 mqtt 恢复问题,这会导致设备在集线器上处于离线模式
    • 通过 mqtt 公开网络配置
    • 监视 ssl 证书的有效期,并在接近过期时续订它们。
    • mqtt 连接指数退避
    • 交互式应用程序执行(docker run -it 等效。)
  • 将 agentconfd 更新到 v1.5.2
    • factory-reset-button:修复了如果按钮在 LED 仍在闪烁时释放,则不会执行出厂重置的错误
    • misc:升级 rust 工具链和版本以使用一些最新功能 - 具体来说:if let &&
      • meta-rust-bin:更新到最新主版本
    • 移除 cargo 和 rust:1.81.0
    • 添加 cargo 和 rust:1.89.0,原因是 agentconfd 现在需要 1.89.0
    • 新的默认设备状态是设置完成
    • 按住出厂重置按钮 5 秒后,将执行特殊的出厂重置,这将导致在下次启动时启动设置应用程序
    • ssh 默认配置为禁止密码。可以通过设置重新配置以允许 ssh 密码登录
    • 修复网络配置在多次重新配置时的持久性问题
    • 修复层构建:使第一个层以上所有哈希不同的层中的所有文件失效并移除
    • 将 devkit 上的出厂重置引脚从 GPIO34 更改为 GPIO43。(以前 devkit 上的 GPIO 出厂重置不起作用)
    • 添加了 R9 硬件版本

1.15.0

(2025 年 7 月 8 日) – OTA 更新,完整 OS 刷写
  • 引入 OAK4-LR 设备,支持 R1 版本
  • 修复 stm-fsync 驱动程序,使其不再产生 lib/list_debug.c:24 崩溃
  • 更新:agentconfd、oakctl 和 oak-agent 到 0.12
    • agentconfd
    • OTA:恢复失败时重置状态 LED。
    • 网络:默认使用自动 DNS,而不是设置 DNS=GW。

1.14.1

(2025 年 6 月 24 日) – OTA 更新,完整 OS 刷写
  • og05b10 传感器:为 OAK4S 自定义设置优化驱动程序
    • 传感器由自定义 CBA 板供电和计时
    • 不打开 VIO/VANA/VDIO 电源
    • 不设置 MCLK
    • 由于复位线通过电平转换器 1v8 -> 3v3,因此在复位线上添加更长的延迟
    • 优化时序
  • 更新 STM 固件以支持 M8 外部帧同步
  • 修复 -25C spine-net-run 测试 将 VDD_CX 电压从 NOMINAL_L1 提升到 TURBO_L1,用于 3.2GHz 和 3.6GHz
  • 恢复:“修复断电时的覆盖损坏”,这会在出厂重置时产生损坏的文件系统

1.13.1

(2025 年 6 月 20 日)
  • 修复导致设备进入 Sahara 模式的偶发性重启问题
  • 引入 og05b10 彩色全局快门传感器
    • 2592 × 1944 @ 50 FPS
    • 1920 × 1080 @ 90 FPS(末端裁剪)
    • 自由运行和从属配置
    • AEC 控制
  • 使 IMX586 在流启动时更健壮(第二次迭代)
  • 为 OAK4S 和 OAK4D 应用正确的加速度计和陀螺仪方向
  • 修复断电时的覆盖损坏
  • 移除未使用的包:用于调制解调器和 TFTP 服务器的 Qualcomm 数据包
  • 在 DTS 中添加 fsync-stm-output 注释
  • 将默认 oak-app 更新到 1.1.5
  • 将 oak-agent 和 oakctl 更新到 0.11.0
  • 使用 M8 支持更新 agentconfd
  • 暴露基板 EEPROM,并修复大于页面大小的读取问题
  • 为基于 SOM 的设备、OAK4S 和 OAK4SR 启用 STM
  • 简化相机发现时的执行器探测
  • 通过移除冗余固件更新来改进 STM 启动序列
  • 使 IMX586 在启动流时更健壮(第一次迭代)
  • 将 agentconfd 更新到 1.4.2
    • OTA:添加了状态 LED 行为
    • OTA:利用 /data 目录以避免 RAM 中完整的 OS
    • 提供 DEVKIT 默认配置

1.11.0

(5 月 22 日) - OTA 更新,完整 OS 刷写
  • 新功能:
    • 将 eeprom 暴露给设备无关路径,用于校准和基板 eeprom,分别位于 /sys/bus/nvmem/devices/calibration-eeprom/nvmem 和 /sys/bus/nvmem/devices/baseboard-eeprom/nvmem
    • 添加动态执行器功能,支持执行器检测
      • 如果执行器设备不工作,则标记为执行器不存在
      • 边缘情况:执行器 IC 存在,但 OS 未检测到镜头机械装置(DAI 应读取 eeprom)
    • 添加在运行时加载自定义覆盖 DTB 和驱动程序模块的机制
    • 更新 setup-app 以适用于 OAK4S R5 和 OAK4D R7
    • 添加对 MIRA220 传感器的支持(1600x1400@30fps):
      • 主从(fsync)模式
      • 添加 1280x1120 MIRA220 4/5 比例 ISP 输出
      • 修复真实增益到“人工”数字增益转换,以避免 ISPDigital 增益产生的噪声
    • 添加 r8125 Realtek 自定义驱动程序和针对 r8125 驱动程序的 linuxptp 4.4(目前禁用)
    • 添加网络开发工具:iperf3 和 ethtool
    • 启用直接 devmem 访问以进行 IO 运行时配置
    • 引入用于第三方开发的公共 SDK
    • 将 SNPE 更新到 2.32 版本
    • 将 DepthAI Gate 更新到 v0.23
    • 更新 oak 应用程序:
      • oakctl v0.9.0
      • oak-agent v0.9.0
      • default-app v0.11.17
  • 修复和改进:
    • 改进运行时存储处理,清理 tmp 目录
    • ICM IMU 性能下降的热修复:恢复更改并使用 LSM IMU 而不是 ICM
    • 改进相机发现:当指定的传感器驱动程序之一不存在时,不失败
    • OAK4S 修复:仅对 R2 版本执行 USB_SEL 更改

1.8.0

(4 月 9 日)
  • 引入 OAK4D R7 版本以匹配生产中的硬件版本(无功能更改)。
  • 引入 OAK4S R5 版本以匹配生产中的硬件版本(无功能更改)。
  • 扩展 UEFI 引导加载程序以使用 FORCE_USB_BOOT 进行出厂重置,采用高电平有效逻辑。
  • 添加了 OS 功率配置文件。

1.6

(2025 年 3 月 12 日) – OTA 更新,完整 OS 刷写
  • 在 OAK4 相机上添加了对 48 MP 分辨率 (IMX586) 的支持(最大 18 FPS)。
  • 更新了点投影仪设置以提高安全性。

1.5

(2025 年 2 月 27 日) – OTA 更新,完整 OS 刷写
  • 更新了 oakctl、oak-agent 和 depthai-gate 版本。
  • 添加了用于 RTL8811CU Wi-Fi 芯片的 RTW88 驱动程序。
  • 迁移到 ICM4x IMU 传感器作为默认加速度计和陀螺仪。
  • 修复了出厂重置过程。
  • 修正了 OAK4D R2 上的泛光灯引脚。
以下版本包含单个 .tar.xz 中的 OTA 和完整刷写更新。要获取 OTA (.zip) 文件,请解压存档。

1.4.1

(2025 年 2 月 14 日) – 下载
  • 修复了在未连接 USB 的情况下 IMU/麦克风不工作的问题。
  • 降低了功耗。
  • 修复了 I2C 总线和 FSYNC 问题。

1.4

(2025 年 2 月 11 日) – 下载

1.3

(2025 年 1 月 29 日) – 下载
  • 启用了性能优化 → 更快的启动和改进的 CPU 性能。
  • 改进了以太网驱动程序的稳定性。
  • 添加了对 IMX586 QBC HDR 模式的支持。

1.2

(2025 年 1 月 10 日) – 下载
  • /home 现在是读/写,并且在 OTA 更新后仍然存在。
  • 修复了 CDAF 自动对焦。
  • 添加了手动对焦执行器控制。
  • 更新了 oak-agent 并捆绑了默认应用程序。
  • 使用 DepthAI v3 – 3.0.0a11 进行了测试。

1.1

(2024 年 12 月 17 日) – 与 DepthAI v3 兼容性问题
  • 改进了不覆盖 /etc 的工厂模式。
  • 修复了 1.0 版本中的相机传感器枚举。
  • 修复了 NIC 未编程时 Luxonis OUI MAC 分配问题。

1.0

(2024 年 12 月 9 日) – 与 DepthAI v3 兼容性问题
  • 将系统 (rootfs) 和用户数据存储分别增加到 5 GB 和 76 GB。
  • 保持系统 rootfs 只读。
  • 基于 SoC ID 统一 EDL 和 ADB 的 ID。
  • 添加了 POE 上的低功耗检测(注意:当由足够的 USB-PD 供电时,设备可能仍会报告低功耗,直到启动完成)。
  • 扩展 OTA 更新以包含 UEFI 引导加载程序二进制文件。

0.26

(2024 年 12 月 4 日) – 下载
  • 修复了启动时自动 USB 角色检测。
  • 将 SNPE 升级到 v2.23。
  • 将 depthai-gate 更新到 v0.21。
  • 默认禁用工厂模式。
  • 添加了对 OAK4-S R2 和 OAK4-D R2 的支持。

0.25

(2024 年 11 月 19 日) – 下载
  • 需要 DepthAI 3.0.0a8。
  • 添加了多个 SNPE 版本。
  • 添加了对 联发科 MT7601U Wi-Fi 芯片的 USB 支持。
  • 修复了与 Windows 主机的通信(USB 外设模式)。
  • 修复了状态 LED 行为。
  • 如果尚未刷写,则在以太网上分配 MAC。
  • 修复了 R8169 驱动程序 (Realtek NIC)。

0.24

(2024 年 10 月 20 日) – 下载
  • 将 oak-agent 集成到操作系统中。
  • 引入了工厂模式。

0.23

(2024 年 10 月 4 日) – 下载
  • 改进了 OAK4-D 上 FSYNC STM 的 IR-LED 驱动逻辑。
  • 增强了 OV9282 传感器上的图像质量(驱动程序改进)。

0.22

(2024 年 9 月 23 日) – 下载
  • 添加了对 AK0991x 磁力计的支持。
  • 实现了 rotv 和 game_rv 算法的传感器融合。
  • 添加了使用 STM 协处理器进行 FSYNC 支持。
  • 添加了 EEPROM 驱动程序以启用校准 EEPROM。

0.21

(2024 年 9 月 8 日) – 下载
  • 修复了 OAK4-D 上的彩色传感器。
  • 修复了 OAK4-S 上的 USB2 通信。
  • 添加了 OAK4-S 和 OAK4-D 上的出厂重置按钮 (USB_BOOT) 支持。
  • 添加了 OAK4 相机上的 IMU 支持。
  • 修复了 IMX582 传感器支持。

0.20

(2024 年 8 月 2 日) – 下载
  • 添加了板识别支持。
  • 添加了硬件在环测试。
  • 将 depthai-gate 更新到 v0.0.20。
  • 更新了系统库。