DepthAI v2 has been superseded by DepthAI v3. You are viewing legacy documentation.
此页面由 AI 自动翻译。查看英文原版
最后更新

本页目录

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

引导加载程序

最后更新
DepthAI 引导加载程序是一个小程序,它处理启动过程,通过初始化 OAK PoE 摄像头,使 DepthAI API 能够连接到它。OAK PoE 摄像头出厂时已预装了工厂引导加载程序。引导加载程序与 depthai 库捆绑在一起,因此要更新到最新的引导加载程序,您应该使用最新的 depthai 库。

设备管理器

device_manager.py 是一个 Python 脚本,用于与设备引导加载程序和引导加载程序配置进行交互。 它可以在 depthai-python/utilities 中找到。

关于设备

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

配置设置

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

危险区域

这是一个关于如何更新引导加载程序的视频教程:
为了防止软砖,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 是一个用于与引导加载程序通信、刷写已创建的 管道 或更新引导加载程序本身的类。与 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 配置中。