PySerial 使用技巧与常见问题解答

PySerial 使用技巧与常见问题解答

pyserial Python serial port access library 项目地址: https://gitcode.com/gh_mirrors/py/pyserial

如何使用 RFC2217 协议

在基于 PySerial 的程序中启用 RFC2217 协议（以及其他 URL 处理程序）非常简单。开发者需要修改代码中 serial.Serial 实例化的部分：

# 原始代码
s = serial.Serial(...)

# 修改为
s = serial.serial_for_url(...)

为了保持对旧版 PySerial 的兼容性，可以这样处理：

try:
    s = serial.serial_for_url(...)
except AttributeError:
    s = serial.Serial(...)

这种修改方式假设应用程序已经将端口名称存储为字符串。用户只需将应用程序的端口设置更改为 rfc2217:// 格式的 URL（例如通过编辑配置文件或 GUI 对话框）。

安全提示：这种方式会启用 PySerial 支持的所有 URL 类型，涉及网络的连接是未加密的，存在被窃听的风险。

测试串口连接

当设备工作异常时，建议先测试串口连接是否正常。PySerial 自带的 miniterm 工具可以用于打开串口并进行基本测试。

简单测试方法：

1. 将 RX 和 TX 短接（形成回环）
2. 在 miniterm 中输入字符
3. 如果屏幕上显示输入的字符，说明至少 RX 和 TX 工作正常（但可能线序接反）

PySerial 还提供了 spy:// URL 处理程序，可以将所有串口调用（读/写、控制线）记录到文件或标准错误输出，便于调试。

常见问题解答

示例在 miniterm 中工作但在脚本中失败

当串口打开时，RTS 和 DTR 线路会切换状态，可能导致连接的设备进行某些处理或重置。在这种情况下，立即调用 write 方法可能无法被设备接收。

解决方案：在打开端口后，首次写入前添加延迟，例如：

import time
time.sleep(1)  # 延迟1秒

应用程序在 .py 文件运行时正常，但打包后失败

使用 py2exe 等打包工具时，PySerial 可能引发两个问题：

1. 打包了不必要的模块实现。在 Windows 上，可以安全地排除 'serialposix'、'serialjava' 和 'serialcli' 模块。

2. serial.serial_for_url 在运行时动态查找协议处理程序。如果使用此函数，需要手动包含所需的处理程序（如 'serial.urlhandler.protocol_socket'、'serial.urlhandler.protocol_rfc2217' 等）。可以通过 setup.py 中的 "includes" 选项或在打包模块中添加虚拟导入来实现。

用户自定义 URL 处理程序

从 PySerial 2.6 开始，可以通过扩展 serial.protocol_handler_packages 中的模块搜索路径来添加自定义 URL 处理程序。

权限被拒绝错误

在基于 POSIX 的系统上，用户通常需要加入特定组才能访问串口设备。

在基于 Debian 的系统上，串口通常属于 dialout 组，运行以下命令并重新登录即可启用访问：

sudo adduser $USER dialout

Raspberry Pi 上的奇偶校验问题

Raspberry Pi 有一个完整 UART 和一个受限 UART。在带有内置无线（WIFI/BT）的设备上，GPIO 引脚上使用的是受限 UART。如果需要增强功能，可以交换 UART。

Python 2.6 或更早版本的支持

PySerial 3.x 不再支持早于 Python 2.7 的版本。如果需要使用 Python 2.6 或更早版本，建议使用 PySerial 2.7（或任何 2.x 版本）。

相关软件推荐

com0com：为 Windows 提供虚拟串口功能，便于开发和测试。

许可证信息

PySerial 采用 BSD 许可证，允许在满足以下条件的情况下自由使用和分发软件：

1. 保留原始版权声明和许可条件
2. 在二进制分发中包含相同的版权声明和许可条件
3. 未经明确书面许可，不得使用版权持有者或贡献者的名称来认可或推广衍生品

该软件按"原样"提供，不提供任何明示或暗示的担保，包括但不限于适销性和特定用途适用性的担保。

pyserial Python serial port access library 项目地址: https://gitcode.com/gh_mirrors/py/pyserial