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。