# device_monitors

Python API: `modelconverter.utils.device_monitors`

在基准测试期间对设备硬件计数器进行采样。

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

## 类

### DeviceMonitor

设备硬件计数器的后台采样器。

以固定间隔从守护线程通过设备的 shell 读取功耗、RAM、CPU、DSP 和温度计数器，保留每个样本，以便之后进行聚合。设备未公开的硬件监视器会提前检测一次，之后其功耗计数器将被跳过；其他计数器会在每次采样时尝试，如果失败则不产生任何结果。

兼作上下文管理器：进入 `with` 块会启动采样线程，离开它会停止线程。

#### 方法

##### init

```python
def __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
def get_idle_measurements(t: float = 5) -> dict[str, float | None]:
```

在设备空闲时对计数器进行采样。

提供负载下测量的基线。

参数

 * `t` (`float`): 采样时长，单位为秒。

返回

 * `dict[str, float | None]`: 聚合计数器，每个键都以 `idle_` 为前缀。

##### get_stats

```python
def get_stats(self) -> dict[str, float | None]:
```

聚合到目前为止收集的样本。

DSP 频率驻留和 DSP 功耗折叠计数器被求和，其他所有计数器都被平均。

返回

 * `dict[str, float | None]`: 计数器名称到其聚合值的映射，对于没有样本的计数器为 `None`。

##### start

```python
def start(self):
```

启动后台采样线程。

如果监视器已在运行，则此操作无效。

##### stop

```python
def stop(self`):
```

停止后台采样线程并等待其完成。
