Python+PyQt6实现跨平台串口设备热插拔检测

pip install PyQt6 pyserial

import sys
from PyQt6.QtCore import QObject, QTimer, pyqtSignal
from PyQt6.QtWidgets import QApplication, QMainWindow, QComboBox, QVBoxLayout, QWidget
import serial.tools.list_ports

class SerialPortMonitor(QObject):
    """
    串口设备热插拔检测器。
    使用定时器轮询方式，跨平台兼容。
    """
    # 定义一个信号，当可用串口列表发生变化时发出，参数为新的端口名列表
    ports_changed = pyqtSignal(list)

    def __init__(self, poll_interval=2000):
        """
        初始化检测器。
        :param poll_interval: 轮询间隔，单位毫秒，默认2秒
        """
        super().__init__()
        self.poll_interval = poll_interval
        self._current_ports = []  # 保存当前检测到的端口列表
        self._timer = QTimer()
        self._timer.timeout.connect(self._check_ports)
        self._init_ports_list()

    def _init_ports_list(self):
        """初始化当前端口列表"""
        self._current_ports = [port.device for port in serial.tools.list_ports.comports()]

    def _check_ports(self):
        """定时器触发的检查函数"""
        # 获取当前所有可用串口
        available_ports = [port.device for port in serial.tools.list_ports.comports()]

        # 比较列表是否发生变化（考虑顺序无关）
        if set(available_ports) != set(self._current_ports):
            print(f"串口列表已变更。旧列表: {self._current_ports}, 新列表: {available_ports}")
            self._current_ports = available_ports
            # 发出信号，传递新的端口列表
            self.ports_changed.emit(available_ports)

    def start(self):
        """启动监控"""
        self._init_ports_list()  # 启动时先获取一次
        self._timer.start(self.poll_interval)
        print("串口热插拔监控已启动。")

    def stop(self):
        """停止监控"""
        self._timer.stop()
        print("串口热插拔监控已停止。")

    def get_current_ports(self):
        """获取当前检测到的端口列表"""
        return self._current_ports.copy()

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("PyQt6 串口热插拔检测示例")
        self.setGeometry(100, 100, 400, 200)

        # 创建中央部件和布局
        central_widget = QWidget()
        self.setCentralWidget(central_widget)
        layout = QVBoxLayout(central_widget)

        # 创建下拉框用于显示串口
        self.combo_ports = QComboBox()
        layout.addWidget(self.combo_ports)

        # 初始化串口监控器
        self.monitor = SerialPortMonitor(poll_interval=1500)  # 每1.5秒检查一次
        # 连接监控器的信号到更新界面的槽函数
        self.monitor.ports_changed.connect(self.update_com_port_list)
        # 启动监控
        self.monitor.start()

        # 初始更新一次列表
        self.update_com_port_list(self.monitor.get_current_ports())

    def update_com_port_list(self, port_list):
        """
        更新下拉框中的串口列表。
        :param port_list: 新的可用串口设备名列表
        """
        current_selection = self.combo_ports.currentText()
        self.combo_ports.clear()
        self.combo_ports.addItems(port_list)

        # 尝试恢复之前的选择（如果该端口仍然存在）
        if current_selection in port_list:
            index = self.combo_ports.findText(current_selection)
            if index >= 0:
                self.combo_ports.setCurrentIndex(index)
        elif port_list:  # 如果列表不为空，默认选择第一个
            self.combo_ports.setCurrentIndex(0)

        print(f"界面已更新，可用串口: {port_list}")

    def closeEvent(self, event):
        """重写关闭事件，确保停止监控器"""
        self.monitor.stop()
        event.accept()

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec())

# 简要示例：在MainWindow中增加事件过滤（仅Windows有效）
from PyQt6.QtCore import QEvent
import ctypes
import win32con  # 需要 pip install pywin32

class MainWindow(QMainWindow):
    # ... 之前的初始化代码 ...

    def nativeEvent(self, eventType, message):
        """Windows 原生事件处理"""
        try:
            msg = ctypes.wintypes.MSG.from_address(message.__int__())
            if msg.message == win32con.WM_DEVICECHANGE:
                # 收到设备变更消息，通知监控器立即检查（或直接在这里处理）
                print("收到设备变更系统消息")
                # 可以在这里直接调用 self.monitor._check_ports() 或发一个信号
                self.monitor._check_ports()
        except:
            pass
        return super().nativeEvent(eventType, message)

from PyQt6.QtCore import QFileSystemWatcher

class SerialPortMonitor(QObject):
    def __init__(self):
        super().__init__()
        self.watcher = QFileSystemWatcher()
        # 注意：可能需要监控 /dev 目录，但权限和事件粒度需要处理
        # self.watcher.addPath('/dev')
        # self.watcher.directoryChanged.connect(self._check_ports)
        # 更简单的做法是监控一个特定的符号链接目录或结合轮询
        # 此处作为思路展示，不展开实现

import sys
from PyQt6.QtWidgets import QApplication, QMainWindow, QComboBox, QVBoxLayout, QWidget, QLabel
from PyQt6.QtCore import QTimer, Qt
from PyQt6.QtSerialPort import QSerialPortInfo

class SerialHotPlugWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("串口热插拔检测 - 轮询方案")
        self.resize(400, 200)

        # UI
        central = QWidget()
        self.setCentralWidget(central)
        layout = QVBoxLayout(central)
        self.cbx_port = QComboBox()
        self.label_tip = QLabel("插拔USB串口会自动刷新下拉框")
        layout.addWidget(self.label_tip)
        layout.addWidget(self.cbx_port)

        # 保存上一次串口列表
        self.last_port_names = set()

        # 定时刷新 500ms一次
        self.timer = QTimer(self)
        self.timer.setInterval(500)
        self.timer.timeout.connect(self.scan_serial_ports)
        self.timer.start()

    def scan_serial_ports(self):
        # 获取当前所有串口名称
        current_ports = {info.portName() for info in QSerialPortInfo.availablePorts()}
        # 新增
        new_ports = current_ports - self.last_port_names
        # 移除
        lost_ports = self.last_port_names - current_ports

        if new_ports:
            print(f"【插入串口】{new_ports}")
        if lost_ports:
            print(f"【拔出串口】{lost_ports}")


        # 更新下拉框
        self.cbx_port.clear()
        self.cbx_port.addItems(sorted(current_ports))

        # 更新历史列表
        self.last_port_names = current_ports

if __name__ == "__main__":
    app = QApplication(sys.argv)
    win = SerialHotPlugWindow()
    win.show()
    sys.exit(app.exec())