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

本页目录

  • 类
  • DeviceMonitor
Claude CodeCodexCursor
Luxonis 智能体工具包为你常用的编程智能体加载 Luxonis 上下文与技能,更快地基于 OAK 开发应用。
安装工具包

device_monitors

最后更新
Python API: modelconverter.utils.device_monitors在基准测试期间对设备硬件计数器进行采样。在真实硬件上对转换后的模型进行基准测试可以说明其运行速度,但不能说明其成本。这里的监视器填补了这一空白:在基准测试运行时,它会轮询设备通过其 shell 公开的功耗、RAM、CPU、DSP 和热量计数器,并在之后报告它们的聚合数据。它由 RVC4 基准测试使用,该基准测试还会获取空闲基线进行比较。

类

DeviceMonitor

设备硬件计数器的后台采样器。以固定间隔从守护线程通过设备的 shell 读取功耗、RAM、CPU、DSP 和温度计数器,保留每个样本,以便之后进行聚合。设备未公开的硬件监视器会提前检测一次,之后其功耗计数器将被跳过;其他计数器会在每次采样时尝试,如果失败则不产生任何结果。兼作上下文管理器:进入 with 块会启动采样线程,离开它会停止线程。

方法

init
Python
1def __init__(device_handler: DeviceHandler, interval: float = 0.5, model: Literal['4d', '4s', '4lite'] = '4lite'):
初始化监视器并探测可用计数器。探测立即发生:通过设备 shell 查找硬件监视器和 DSP 实用程序。缺少的硬件监视器将从采样中排除,而 DSP 探测的结果仅被记录。参数
  • device_handler (DeviceHandler): 用于在设备上运行 shell 命令的处理程序。
  • interval (float): 两次采样之间的延迟,单位为秒。
  • model (Literal['4d', '4s', '4lite']): 正在监视的设备型号。仅记录。
get_idle_measurements
Python
1def get_idle_measurements(t: float = 5) -> dict[str, float | None]:
在设备空闲时对计数器进行采样。提供负载下测量的基线。参数
  • t (float): 采样时长,单位为秒。
返回
  • dict[str, float | None]: 聚合计数器,每个键都以 idle_ 为前缀。
get_stats
Python
1def get_stats(self) -> dict[str, float | None]:
聚合到目前为止收集的样本。DSP 频率驻留和 DSP 功耗折叠计数器被求和,其他所有计数器都被平均。返回
  • dict[str, float | None]: 计数器名称到其聚合值的映射,对于没有样本的计数器为 None。
start
Python
1def start(self):
启动后台采样线程。如果监视器已在运行,则此操作无效。
stop
Python
1def stop(self`):
停止后台采样线程并等待其完成。