# utils

Python API: `modelconverter.platforms.rvc4.utils`

用于寻址 RVC4 设备的辅助函数。

DepthAI 和 ADB 对同一设备的命名方式不同，因此基准测试和分析必须在 DepthAI 设备 ID 和 ADB 序列号之间进行转换，并为用户通过其中任何一种方式命名的设备找出地址。

## 函数

### adb_id_to_device_id

```python
def adb_id_to_device_id(adb_id: str) -> str:
```

将 ADB 序列号转换回 DepthAI 设备 ID。

> **示例**
> ```pycon
>>> adb_id_to_device_id("1c244d")
'1844301'
```

参数

 * `adb_id` (`str`): ADB 识别设备的序列号。

返回

 * `str`: 如果序列号可读作十六进制数，则返回其十进制形式；否则返回其字节拼写的 ASCII 文本。

### device_id_to_adb_id

```python
def device_id_to_adb_id(device_id: str) -> str:
```

将 DepthAI 设备 ID 转换为 ADB 序列号。

> **示例**
> ```pycon
>>> device_id_to_adb_id("1844301")
'1c244d'
```

参数

 * `device_id` (`str`): DepthAI 报告的设备 ID。

返回

 * `str`: 如果 ID 是数字，则返回其十六进制形式；否则返回其 ASCII 字节的十六进制编码。

### get_device_info

```python
def get_device_info(device_ip: str | None, device_id: str | None) -> tuple[str | None, str | None]:
```

找出如何连接用户请求的设备。

在已连接的设备中查找设备 ID，如果找到的地址与传入的地址不匹配，则仅发出警告。如果查找未找到地址，则直接连接到该地址，以从设备读取 ID。

参数

 * `device_ip` (`str | None`): 设备的地址（如果已提供）。
 * `device_id` (`str | None`): 设备的设备 ID 或 ADB 序列号（如果已提供）。

返回

 * `tuple[str | None, str | None]`: 设备的地址和 ADB 序列号。当两个参数都未提供，或者仅提供了设备 ID 且没有已连接的设备匹配时，两者都为 `None`。
