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

本页目录

  • 使用 OAK Viewer 更新
  • 设备管理器
  • 关于设备
  • 配置设置
  • 应用程序设置
  • 危险区域
  • 引导开关
  • API
  • MAC 地址
Claude CodeCodexCursor
Luxonis 智能体工具包为你常用的编程智能体加载 Luxonis 上下文与技能,更快地基于 OAK 开发应用。
安装工具包

引导加载程序 - 仅限 RVC2

最后更新
DepthAI 引导加载程序是一个小程序,它通过初始化 OAK PoE 摄像头来处理引导过程,以便 DepthAI API 可以连接到它。OAK PoE 摄像头出厂时已预装了工厂引导加载程序。引导加载程序与 depthai 库捆绑在一起,因此要例如刷写最新的引导加载程序,您应该使用最新的 depthai 库。有两种方法可以在 RVC2 设备上更新引导加载程序。首选方法是 OAK Viewer,它提供了以下引导流程。第二种选择是设备管理器,稍后将在本页介绍。

使用 OAK Viewer 更新

您可以从 OAK Viewer 更新引导加载程序。在开始之前,请确保 OAK Viewer 已更新到最新版本。

选择检测到的设备

单击 OAK Viewer 中检测到的设备。如果引导加载程序已过时,Viewer 会自动检测到它并提示您更新。您的主机需要可靠的网络连接才能开始此步骤。
OAK Viewer 在选择检测到的设备后提示更新引导加载程序

等待引导加载程序下载并刷写

引导加载程序已下载并刷写到设备上。在此过程中,请勿干扰主机或设备连接。
OAK Viewer 下载并刷写引导加载程序更新

让设备重新连接

引导加载程序更新完成后,设备会自动重新连接。
引导加载程序更新完成且设备重新连接后的 OAK Viewer

设备管理器

更新引导加载程序的第二种可能性是使用 device_manager.py。它是一个 Python 脚本,用于与设备引导加载程序和引导加载程序配置进行接口。 它可以在 depthai-core/utilities 中找到。

关于设备

允许您选择要连接的设备,并查看连接设备的元数据。
  • 首先,我们必须选择要连接(引导)的设备,您可以使用以下方式选择:
    • 下拉菜单,其中包含找到的设备 MX ID。下拉菜单仅在启动应用程序时更新。
    • 如果您的 OAK PoE 摄像头不在同一局域网中,请使用指定 IP 按钮。
    • 搜索功能 - 将显示一个新窗口,其中包含一个表格,其中包含所有可用的摄像头(通过 USB 端口或局域网 - OAK PoE)、它们的 MxId、名称和状态。单击表格行将选择该设备并引导到它。

配置设置

选择已刷写引导加载程序的设备后,您还可以配置引导加载程序配置。
  • 如果设备已刷写网络引导加载程序,您将能够设置其静态/动态 IP/掩码/网关、DNS、MAC 等。
  • 如果设备已刷写 USB 引导加载程序,您将能够设置其 USB 最大速度和 USB 超时。
设置一些值后,您必须单击 Flash configuration 按钮。您还可以 Clear configuration 或 View configuration(其 JSON)。
刷写静态 IP 时,请务必同时设置网关/掩码

应用程序设置

  • 刷写应用程序(旧版):选择要刷写到设备的 DepthAI 应用程序包 (.dap)。
  • 删除应用程序:从设备中删除/清除已刷写的应用程序
  • 打开设备流应用程序:开始从设备上所有连接的摄像头流式传输帧。

危险区域

这是一个关于如何更新引导加载程序的视频教程:
为了防止软砖,OAK 设备(自 2023 年起)具有工厂引导加载程序和用户引导加载程序。如果用户刷写了损坏的用户引导加载程序,它将回退到使用工厂引导加载程序。更新引导加载程序时, 设备管理器将首先尝试刷写用户引导加载程序,如果已刷写(工厂)引导加载程序支持它。如果不可能,它将刷写工厂引导加载程序。
  • 更新引导加载程序按钮将刷写最新的引导加载程序到设备。您可以选择 AUTO、USB 或 NETWORK 引导加载程序。
    • AUTO 将选择摄像头当前连接的引导加载程序的连接类型。如果您通过 USB(进行出厂重置)连接到 OAK PoE 摄像头,则不应选择 AUTO,因为它会刷写 USB 引导加载程序。
    • USB 引导加载程序将尝试引导存储在闪存中的应用程序。如果找不到已刷写的应用程序,它将像普通 USB OAK 一样运行 - 因此它将等待主机计算机初始化应用程序。
    • NETWORK 引导加载程序由 OAK PoE 摄像头使用,并在工厂刷写。它处理网络初始化,以便 OAK PoE 摄像头可以通过局域网引导。
  • 刷写工厂引导加载程序:如果您想刷写工厂引导加载程序,可以使用此按钮。它将刷写工厂引导加载程序,即使已刷写用户引导加载程序。
  • 出厂重置将擦除所有闪存内容,并仅使用 USB 或 NETWORK 引导加载程序重新刷写。已刷写的应用程序(管道、资产)和引导加载程序配置将丢失。
  • 引导进入 USB 恢复模式将强制例如 OAK PoE 摄像头通过 USB 连接器可用,即使其引导引脚设置为 PoE 引导。它主要由我们的固件开发人员使用。

工厂和用户引导加载程序

有两种类型的引导加载程序:
  • 工厂引导加载程序:在工厂刷写的引导加载程序。我们不建议重新刷写此引导加载程序,因为它不应由最终用户编辑。
  • 用户引导加载程序:用户可以刷写的引导加载程序。如果引导不成功(例如,刷写时损坏),它将回退到工厂引导加载程序。
USB 设备不支持用户引导加载程序。如果设备具有用户引导加载程序,则默认使用它。如果未刷写用户引导加载程序,它将回退到工厂引导加载程序。

引导开关

  • 从闪存引导 - DIP 开关:0x03(开关 5,6 ON) - 当安装引导加载程序时,由 OAK PoE 和 USB 摄像头使用。
  • USB 恢复模式 - DIP 开关:0x16(开关 2,4,5 ON) - 直接引导进入 USB 模式,以便摄像头等待主机通过 USB 连接到它。
OAK-D-PoE,开关 2,4,5 ON,用于通过 USB 连接到设备。
在 OAK 设备的新版本中,我们有 0 欧姆电阻(见下图)而不是 DIP 开关,这意味着 OAK 将默认从闪存引导。这些新设备 已刷写引导加载程序,它处理引导过程。底板上还有一个额外的按钮,按下时可将引导切换到恢复模式, 如果尚未刷写引导加载程序(例如早期访问设备),这会很有用。您需要在设备通电时(引导发生时)按下此按钮。

API

DeviceBootloader 是一个用于与引导加载程序通信、刷写已创建的 Pipeline 或更新引导加载程序本身的类。DAP 相关 API 仅作为旧版参考保留文档;RVC2 独立部署不受支持。
C++
1std::tuple<bool, std::string> flash(std::function<void(float)> progressCb, Pipeline& pipeline);
2
3std::tuple<bool, std::string> flashDepthaiApplicationPackage(std::function<void(float)> progressCb, std::vector<uint8_t> package);
4
5std::tuple<bool, std::string> flashBootloader(std::function<void(float)> progressCb, std::string path = "");
progressCb 参数接受一个回调函数,该函数将在每次发生进度更新时调用(速率限制为 1 秒)。这主要 用于通知用户当前的刷写进度。

DepthAI 应用程序包 (.dap)

DepthAI 应用程序包是一种旧版二进制文件格式,用于存储数据段。此格式的目的是能够提取 单个段并进行 OTA 更新,而无需更新所有数据。示例:在用户应用程序的更新 1 和 2 之间, DepthAI 固件、资产存储(50MiB 神经网络)和资产结构保持不变,但管道中添加了一些额外的处理节点。 无需传输整个包,只需发送和更新管道描述即可。DepthAI 应用程序包 (.dap) 包括:
  • SBR(描述数据段的 512B 头部)
  • DepthAI 设备固件(段“__firmware”)
  • 管道描述(段“pipeline”)
  • 资产结构(段“assets”)
  • 资产存储(段“asset_storage”)

MAC 地址

所有 OAK PoE 摄像头都有一个唯一的 MAC 地址,用于在网络上识别设备。它根据 设备的 MxID 计算,请参阅 此处逻辑。 MAC 地址存储在 DeviceBootloader 配置中。