用python 进行雷电接口检测

雷电接口检测工具说明文档

功能概述

这个Python脚本用于检测系统的雷电(Thunderbolt)接口支持情况，包括：

• 检测系统是否有雷电控制器
• 检测Type-C/雷电端口
• 识别雷电接口版本（Thunderbolt 1-5）
• 显示理论传输速度
• 列出已连接的雷电设备

代码结构

1. 基础支持检测函数

def check_thunderbolt_support() -> Dict[str, bool]

这个函数通过Windows Management Instrumentation (WMI)命令检查系统的雷电支持情况，返回一个包含以下信息的字典：

• has_controller: 是否存在雷电控制器
• has_port: 是否有Type-C/雷电端口
• is_active: 雷电接口是否处于激活状态

2. 版本检测函数

def get_thunderbolt_version() -> Dict[str, str]

识别系统支持的雷电版本，返回版本号和对应的理论速度：

• Thunderbolt 5: 80 Gbps (双向), 最高120 Gbps (单向)
• Thunderbolt 4: 40 Gbps
• Thunderbolt 3: 40 Gbps
• Thunderbolt 2: 20 Gbps
• Thunderbolt 1: 10 Gbps

3. 详细信息获取函数

def get_detailed_thunderbolt_info() -> List[Dict[str, str]]

获取所有已连接雷电设备的详细信息，包括：

• 设备名称
• 制造商信息
• 设备状态

4. 状态报告函数

def print_thunderbolt_status()

生成完整的雷电接口支持状态报告，包括：

• 主机雷电支持情况
• 主机雷电版本信息
• 已连接设备列表
• 使用注意事项

使用方法

1. 直接运行脚本：

python thunderbolt_check.py

2. 作为模块导入：

from thunderbolt_check import check_thunderbolt_support, get_thunderbolt_version

# 检查基本支持
support_info = check_thunderbolt_support()

# 获取版本信息
version_info = get_thunderbolt_version()

注意事项

1. 实际传输速度取决于：

   • 主机支持的雷电版本
   • 连接设备支持的雷电版本
   • 实际会以两者中较低的速度运行

2. 如果检测结果显示有雷电端口但未激活：

   • 检查BIOS设置中的雷电支持选项
   • 确保已安装最新的雷电驱动程序

3. 版本速度对照表：

   版本	理论速度	备注
   Thunderbolt 5	80/120 Gbps	预计2024年底推出
   Thunderbolt 4	40 Gbps	要求更严格的认证
   Thunderbolt 3	40 Gbps	最广泛使用的版本
   Thunderbolt 2	20 Gbps	较老的版本
   Thunderbolt 1	10 Gbps	最早的版本

技术实现细节

1. 使用subprocess模块执行WMI命令
2. 通过正则表达式解析设备信息
3. 支持中英文设备描述识别
4. 异常处理确保程序稳定运行

可能的错误和解决方案

1. “获取雷电版本信息时出错”

   • 确保以管理员权限运行
   • 检查WMI服务是否正常运行

2. “未检测到已连接的雷电设备”

   • 确认设备是否正确连接
   • 检查设备驱动是否正确安装

代码：

import subprocess
import re
from typing import Dict, List, Tuple

def check_thunderbolt_support() -> Dict[str, bool]:
    """
    检查系统是否支持雷电接口
    
    Returns:
        Dict[str, bool]: 包含雷电接口支持信息的字典
        {
            'has_controller': bool,  # 是否有雷电控制器
            'has_port': bool,        # 是否有雷电端口
            'is_active': bool        # 雷电接口是否激活
        }
    """
    result = {
   
   
        'has_controller': False,
        'has_port': False,
        'is_active': False
    }
    
    try:
        # 检查 USB 控制器中的 Type-C 和雷电支持
        usb_controllers = subprocess.check_output(
            ["wmic", "path", "Win32_USBController", "get",