SDKPython SDK

设备发现与连接

发现候选串口，配置自动发现或固定端口，并用逻辑名称选择多台 Exo。

当前版本 · 1.0.0

设备发现与连接

发现设备

from qnbot_sdk.exo import discover_exos

for candidate in discover_exos():
    if candidate.error:
        print(candidate.port, candidate.error.code, candidate.error.message)
    else:
        print(candidate.port, candidate.device_info.product)

每条 DiscoveredExo 要么包含 device_info，要么包含 error。错误码为 PORT_OPEN、PROTOCOL_ERROR 或 INCOMPATIBLE。

自动发现与固定串口

from qnbot_sdk import Sdk, SerialConnection
from qnbot_sdk.exo import ExoConfig

# 唯一设备自动发现
automatic = ExoConfig()

# 固定串口
fixed = ExoConfig(
    name="primary-exo",
    connection=SerialConnection(port="/dev/ttyUSB0"),
)
sdk = Sdk(devices=(fixed,))
device = sdk.exo().device("primary-exo")

Windows 端口形如 COM3。Exo 不支持用 SerialConnection.serial_number 定位；序列号只用于展示设备信息。多设备必须为每台设备提供不同的逻辑 name 和明确端口。