Python PySerial 串口通信库入门与实战

PySerial 是 Python 中用于串口（UART）通信的跨平台第三方库，支持 Windows、Linux、macOS 等多种操作系统，提供了简洁、一致的 API 用于串口设备的读写和控制。

1. 安装 PySerial

在开始使用前，需要通过 pip 安装该库。

pip install pyserial

安装完成后，可以在 Python 脚本中验证是否成功：

import serial
print("pyserial version:", serial.__version__)

2. 基本使用流程

使用 PySerial 进行串口通信通常遵循以下步骤：导入库 -> 配置并打开串口 -> 读写数据 -> 关闭串口。

2.1 导入库并打开串口

首先导入 serial 模块，然后创建 Serial 对象来初始化并打开串口。

import serial
# 初始化串口连接，参数可在此处设置
ser = serial.Serial(
    port='COM3',          # Windows 端口名，如 COM1；Linux/macOS 为 /dev/ttyUSB0 等
    baudrate=9600,        # 波特率，常见值有 9600, 115200 等
    bytesize=serial.EIGHTBITS,  # 数据位，8 位
    parity=serial.PARITY_NONE,  # 校验位，无校验
    stopbits=serial.STOPBITS_ONE, # 停止位，1 位
    timeout=1             # 读超时时间（秒），None 为无限等待，0 为非阻塞
)

创建 Serial 对象时，若指定了 port，串口通常会立即打开。你也可以先创建对象，后续再配置参数并手动打开：

ser = serial.Serial()
ser.port = 'COM3'
ser.baudrate = 115200
ser.open()

2.2 检查串口状态

可以使用 is_open 属性检查串口是否成功打开。

if ser.is_open:
    print(f"串口 {ser.port} 已打开")
else:
    print("串口打开失败")

2.3 读写数据

• read(size=1)：读取指定大小的字节数。