跳到主要内容

get_device_by_sn()

实例方法 | VTSDeviceFinder 类

📖 方法说明​

根据设备序列号（Serial Number）获取指定设备的配置对象。此方法允许您精确定位和访问特定设备。

📝 语法​

device = finder.get_device_by_sn(sn)

🔧 参数​

参数名类型必填说明
snstr✅设备的序列号

📤 返回类型​

Optional[VTSDeviceConfig] - 设备配置对象，如果未找到则返回 None

💡 示例代码​

from pyvitaisdk import VTSDeviceFinder, GF225

# 创建 VTSDeviceFinder 实例
finder = VTSDeviceFinder()

# 方式1: 使用已知的序列号
device = finder.get_device_by_sn("SN123456")
if device:
    print(f"找到设备: {device}")
else:
    print("未找到指定序列号的设备")

# 方式2: 从序列号列表中选择
serial_numbers = finder.get_sns()
if serial_numbers:
    # 获取第一个设备
    device = finder.get_device_by_sn(serial_numbers[0])
    print(f"使用设备: {serial_numbers[0]}")

⚠️ 注意事项​

返回值检查
  • 如果指定的序列号不存在，方法返回 None
  • 使用返回值前请务必检查是否为 None
序列号获取方式

可通过以下方式获取设备序列号：

  1. 使用 get_sns() 方法查询所有设备序列号
  2. 从设备产品标签上读取
  3. 从之前保存的配置文件中获取
使用场景
  • 多设备环境中定位特定设备
  • 根据设备序列号加载专属配置
  • 实现设备的固定绑定

🔗 相关方法​

  • get_sns - 获取所有设备序列号列表
  • get_devices - 获取所有设备配置
  • GF225 - 使用设备配置创建传感器实例