【pySerial3.4官方文档】1、pySerial

pySerial 

 

概述

该模块封装了串行端口的访问权限。它为在Windows，OSX，Linux，BSD（可能是任何POSIX兼容系统）和IronPython上运行的Python提供后端。名为“serial”的模块会自动选择适当的后端。

它是在免费软件许可下发布的，有关详细信息，请参阅LICENSE。

版权所有（C）2001-2016 Chris Liechti <cliechti（at）gmx.net>

其他页面（在线）

• GitHub上的项目页面
• 下载包含发布的页面（PyPi）
• 在线查看此页面时，请访问https://pyserial.readthedocs.io/en/latest/或http://pythonhosted.org/pyserial/。

 

功能

• 所有支持的平台上基于相同类的接口。
• 通过Python属性访问端口设置。
• 通过RTS / CTS和/或Xon / Xoff支持不同的字节大小，停止位，奇偶校验和流控制。
• 使用或不使用接收超时。
• 文件类似API，带有“read”和“write”（“readline”等也支持）。
• 这个包中的文件是100％纯Python。
• 端口设置为二进制传输。没有NULL字节剥离，CR-LF转换等（这是POSIX的多次启用。）这使得该模块普遍有用。
• 与io库兼容
• RFC 2217客户端（实验性），示例中提供的服务器。

 

要求

• Python 2.7或Python 3.4及更高版本
• 如果在Windows上运行：Windows 7或更高版本
• 如果在Jython上运行：“Java Communications”（JavaComm）或Java的兼容扩展

对于较旧的安装（较旧的Python版本或较旧的操作系统），请参阅 下面的旧版本。

 

安装

这将安装一个可以从Python（）中使用的包。import serial

要为系统上的所有用户安装，可能需要管理员权限（root）。

 

来自PyPI 

pySerial可以从PyPI安装：

python -m pip install pyserial

使用所需版本的python / python3可执行文件（2.7 / 3.x）。

开发人员也可能对获取源存档感兴趣，因为它包含示例，测试和本文档。

 

来自Conda

pySerial可以从Conda安装：

conda install pyserial or conda install -c conda-forge pyserial

目前，默认的conda通道将提供版本3.4，而conda-forge通道提供当前的3.x版本。

Conda：https：//www.continuum.io/downloads

 

来自源（zip / tar.gz或checkout）

从http://pypi.python.org/pypi/pyserial或 https://github.com/pyserial/pyserial/releases下载档案。解压缩存档，输入pyserial-x.y目录并运行：

python setup.py install

使用所需版本的python / python3可执行文件（2.7 / 3.x）。

 

包

还有一些Linux发行版的打包版本：

• Debian / Ubuntu：“python-serial”，“python3-serial”
• Fedora / RHEL / CentOS / EPEL：“pyserial”
• Arch Linux：“python-pyserial”
• Gentoo：“dev-python / pyserial”

请注意，某些发行版可能会打包较旧版本的pySerial。这些包由处理这些发行版的开发人员创建和维护。

 

参考资料

• Python：http：//www.python.org/
• Jython：http：//www.jython.org/
• IronPython：http：//www.codeplex.com/IronPython

 

旧版本

较旧版本仍可在当前下载页面或旧下载页面上找到。pySerial的2.x系列的最后一个版本是2.7，与Python 2.3和更新版本兼容，并且部分与早期的Python 3.x版本兼容。

pySerial 1.21与Windows，Linux和几个非* x类系统，MacOSX和Jython上的Python 2.0兼容。

在Windows上，早于2.5的版本将依赖于pywin32（以前称为win32all）。WinXP最高支持3.0.1。