### Python 使用 PySerial 读取串口数据 示例代码 以下是使用 `PySerial` 库实现通过 Python 读取串口数据的一个完整示例： #### 安装依赖库 在运行代码前，需确保已安装 `pyserial` 模块。可以通过以下命令完成安装： ```bash pip install pyserial ``` #### 示例代码 下面是一个完整的代码示例，用于打开指定的串口并持续读取接收到的数据。 ```python import serial import time # 配置串口参数 port = '/dev/ttyUSB0' # Linux 下的串口号，Windows 可能为 COM1 或其他 baud_rate = 9600 # 波特率设置 timeout = 1 # 超时时间（秒） try: # 初始化串口对象 ser = serial.Serial(port, baud_rate, timeout=timeout) if not ser.is_open: raise Exception(f"Failed to open the specified port: {port}") print(f"Successfully opened serial port: {port}") # 循环读取串口数据 while True: if ser.in_waiting > 0: # 判断是否有待处理的数据 data = ser.readline().decode('utf-8').strip() # 读取一行数据并解码 timestamp = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()) # 获取当前时间戳 print(f"[{timestamp}] Received Data: {data}") # 输出带时间戳的日志信息 except serial.serialutil.SerialException as se: print(f"Serial Port Error: {se}[^3]") except KeyboardInterrupt: print("\nProgram terminated by user.") finally: if 'ser' in locals() and ser.is_open: ser.close() print("Serial port closed successfully.") ``` #### 功能说明 1. **初始化串口**：通过 `serial.Serial()` 方法创建一个串口实例，并配置波特率、超时等必要参数。 2. **判断数据可用性**：利用 `ser.in_waiting` 属性检测缓冲区中是否存在可读数据。 3. **读取与解析数据**：调用 `ser.readline()` 函数逐行读取数据，并将其从字节流转换为 UTF-8 编码的字符串形式。 4. **异常处理**：捕获可能出现的错误，例如无法打开串口的情况或用户手动终止程序的操作。 5. **日志记录**：每条接收的消息都附加了时间戳以便于调试和分析[^4]。 --- ### 注意事项 - 如果遇到权限不足的问题（如 Windows 上提示 “拒绝访问”），可能是由于目标串口被占用或其他原因引起的。可以尝试关闭所有正在使用的串口工具后再重新启动脚本[^3]。 - 对于不同的操作系统，串口号命名方式有所不同。例如，在 Linux 中通常为 `/dev/ttyUSB*` 或 `/dev/ttyACM*`；而在 Windows 平台上则表现为 `COM*` 形式的编号序列。 ---