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

本页目录

  • 内存使用
  • 减少 RAM 消耗
Claude CodeCodexCursor
Luxonis 智能体工具包为你常用的编程智能体加载 Luxonis 上下文与技能,更快地基于 OAK 开发应用。
安装工具包

管道调试

最后更新
您可以通过更改调试级别来启用日志记录。默认设置为 warning,但可以设置更详细的级别以帮助调试问题。以下级别可用:
调试级别信息
critical仅表示停止/崩溃程序的严重错误。
error错误不会停止程序,但不会完成操作。示例:当 ImageManip 裁剪 ROI 超出范围时,将打印错误且不进行裁剪。当 NeuralNetwork 接收到的帧的形状(宽度/高度/通道)与 .blob 不符时。
warn在用户操作可以改善某些行为/修复它的情况下打印警告。示例:当 API 更改时,旧的 API 样式将被弃用并向用户显示警告。
info将打印有关 CPU/RAM 消耗、温度、CMX 切片和 SHAVE 核心分配的信息。
debug特别适用于启动和停止管道。调试将打印:设备初始化信息,例如管道 JSON、固件/引导加载程序/OpenVINO 版本。设备/XLink 如何关闭/处置。
trace每次从设备接收到消息时,Trace 都会打印一条消息。
调试可以通过代码(通过 API)或通过环境变量启用。

使用 API 调试

Python
1with dai.Device() as device: # 初始化设备
2    # 设置调试级别
3    device.setLogLevel(dai.LogLevel.DEBUG)
4    device.setLogOutputLevel(dai.LogLevel.DEBUG)
其中 setLogLevel 设置详细程度,用于过滤从设备发送到主机的消息,setLogOutputLevel 设置详细程度,用于过滤在主机(stdout)上打印的消息。这种差异允许我们在内部捕获日志消息,而不将其打印到 stdout,并使用这些消息例如在其他地方显示或分析它们。

使用环境变量 DEPTHAI_LEVEL 调试

使用环境变量设置调试级别,而不是直接在代码中配置,可以提供额外的详细信息。 这包括诸如 CMX 和 SHAVE 使用情况以及管道中每个节点处理单个帧所需时间等指标。RGB 预览 在 INFO 模式下的日志消息示例:
Command Line
1[184430102189660F00] [2.1] [0.675] [system] [info] DepthCamera allocated resources: shaves: [0-12] no cmx slices.
2[184430102189660F00] [2.1] [0.675] [system] [info] SIPP (Signal Image Processing Pipeline) internal buffer size '18432'B, DMA buffer size: '16384'B
3[184430102189660F00] [2.1] [0.711] [system] [info] ImageManip internal buffer size '285440'B, shave buffer size '34816'B
4[184430102189660F00] [2.1] [0.711] [system] [info] ColorCamera allocated resources: no shaves; cmx slices: [13-15]
5ImageManip allocated resources: shaves: [15-15] no cmx slices.
深度预览 在 TRACE 模式下的日志消息示例:
Command Line
1[19443010513F4D1300] [0.1.2] [2.014] [MonoCamera(0)] [trace] Mono ISP took '0.866377' ms.
2[19443010513F4D1300] [0.1.2] [2.016] [MonoCamera(1)] [trace] Mono ISP took '1.272838' ms.
3[19443010513F4D1300] [0.1.2] [2.019] [StereoDepth(2)] [trace] Stereo rectification took '2.661958' ms.
4[19443010513F4D1300] [0.1.2] [2.027] [StereoDepth(2)] [trace] Stereo took '7.144515' ms.
5[19443010513F4D1300] [0.1.2] [2.028] [StereoDepth(2)] [trace] 'Median' pipeline took '0.772257' ms.
6[19443010513F4D1300] [0.1.2] [2.028] [StereoDepth(2)] [trace] Stereo post processing (total) took '0.810216' ms.
7[2024-05-16 14:27:51.294] [depthai] [trace] Received message from device (disparity) - parsing time: 11µs, data size: 256000

Linux/MacOS

Command Line
1DEPTHAI_LEVEL=debug python3 script.py

Windows PowerShell

Command Line
1$env:DEPTHAI_LEVEL='debug'
2python3 script.py
3
4# 之后关闭调试
5Remove-Item Env:DEPTHAI_LEVEL

Windows CMD

Command Line
1set DEPTHAI_LEVEL=debug
2python3 script.py
3
4# 之后关闭调试
5set DEPTHAI_LEVEL=

CPU 使用率

当将调试级别设置为 debug(或更低)时,DepthAI 还会打印 LeonOS 和 LeonRT 的 CPU 使用率。CPU 使用率达到 100%(或接近 100%)可能会导致许多不良影响,例如更高的帧延迟、更低的 FPS,在某些情况下甚至会导致固件崩溃。与 OAK USB 摄像头相比,OAK PoE 摄像头会增加 CPU 消耗,因为网络堆栈在 LeonOS 核心上运行。 降低 CPU 消耗最简单的方法是降低管道复杂性,或者降低摄像头的 FPS,因为它们是 CPU 的主要消耗者(运行 3A 算法)。没有 100% 的 CPU 使用率也大大降低了帧延迟,在下面的脚本示例中,它从约 710 毫秒降至约 110 毫秒:

内存使用

所有基于 RVC2 的 OAK 设备都具有 512 MiB (4 Gbit) 板载 RAM,用于 固件(约 15MB)、资产(几 KB 到 100MB,例如 NN 模型)以及 其他资源,例如存储消息的消息池。如果启用 info(请参阅 管道调试 部分),您将看到 RAM 的使用情况:
Command Line
1[info] Memory Usage - DDR: 41.23 / 358.82 MiB, CMX: 2.17 / 2.50 MiB,
2LeonOS Heap: 20.70 / 78.63 MiB, LeonRT Heap: 3.51 / 23.84 MiB
如您所见,RAM 分为两个 LEON (CPU) 核心、CMX (用于图像处理)和 DDR(其他所有内容)。如果 DDR 使用量接近最大值(在此示例中为 358 MiB),您可能会收到 以下错误:
Command Line
1[error] Neural network executor '0' out of '2' error: OUT_OF_MEMORY
这意味着您应该减少 RAM 消耗,我们将探讨几种方法。

减少 RAM 消耗

  • 池大小 - 某些节点(包括 ColorCamera、 PointCloud、 ImageManip、 EdgeDetector、 MonoCamera、 StereoDepth、 VideoEncoder、 Warp)具有可配置的池大小(此处是池文档)。 这意味着用户可以配置池中存储的消息数量(RAM)。如果您遇到 RAM 使用限制,最简单的减少方法是 减小池大小。配置池大小的 API 是 node.setNumFramesPool(num_frames_pool)。对于 ColorCamera,用户需要指定 5 个池大小 colorCam.setNumFramesPool(raw, isp, preview, video, still)。 请注意,将池大小减小到 2 以下将导致管道问题。
  • 大帧 如果我们将 RGB 视频 示例中的分辨率从 1080P 更改为 4K, DDR 使用量将从 41 MiB 增加到 161 MiB。这是因为 4K 帧比 1080P 帧多占用 4 倍的 RAM。减少 RAM 消耗的简单方法是使用较低分辨率/较小的帧。
  • VideoEncoder VideoEncoder 节点会消耗大量 RAM,尤其是在高分辨率下。 例如,RGB 编码 示例消耗 259 MiB。如果我们将 分辨率从 4K 更改为 1080P,DDR 消耗将减少到仅 65 MiB。
  • ImageManip 每个 ImageManip 节点都将有自己的(输出)4 帧池(默认情况下),因此 操作高分辨率帧的多个 ImageManip 将消耗大量 DDR RAM。默认情况下,每个 池“点”将消耗 1 MiB,即使它是一个小的 300x300 RGB 帧(270kB)。因此,指定输出帧大小也可以减少 RAM,例如,对于 300x300 RGB 帧,您可以设置 manip.setMaxOutputFrameSize(270000)。
  • XLinkIn 就像 ImageManip 一样,每个 XLinkIn 节点也有自己的消息池。默认情况下,每个 XLinkIn 将消耗 40 MiB,因为每个池“点”保留 5 MiB, 并且池中有 8 个“点”。如果您从主机向设备发送 300x300 RGB 帧,您可以 设置 xin.setMaxDataSize(270000),并限制每个池的消息数量 xin.setNumFrames(4)。 这将使 DDR RAM 消耗从 40 MiB 减少到约 1 MiB。
如果您只是从主机发送控制/配置,您可以设置 xin.setMaxDataSize(1),因为 CameraControl 和 ImageManipConfig 只包含元数据(不包含任何数据,例如 NNData / ImgFrame/ Buffer)。