PySerial Documentation - Read the Docs
pySerial Documentation
Release 3.4 Chris Liechti
Dec 05, 2021
Contents
1 pySerial
3
1.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.2 Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.3 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.4 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.5 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.6 Older Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2 Short introduction
7
2.1 Opening serial ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.2 Configuring ports later . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.3 Readline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.4 Testing ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3 pySerial API
11
3.1 Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
3.2 Exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
3.3 Constants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
3.4 Module functions and attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
3.5 Threading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
3.6 asyncio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
4 Tools
31
4.1 serial.tools.list_ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
4.2 serial.tools.miniterm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
5 URL Handlers
37
5.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
5.2 rfc2217:// . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
5.3 socket:// . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
5.4 loop:// . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
5.5 hwgrep:// . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
5.6 spy:// . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
5.7 alt:// . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
5.8 cp2110:// . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
5.9 Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
i
6 Examples
43
6.1 Miniterm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
6.2 TCP/IP - serial bridge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
6.3 Single-port TCP/IP - serial bridge (RFC 2217) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
6.4 Multi-port TCP/IP - serial bridge (RFC 2217) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
6.5 wxPython examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
6.6 Unit tests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
7 Appendix
49
7.1 How To . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
7.2 FAQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
7.3 Related software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
7.4 License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
8 Indices and tables
53
Python Module Index
55
Index
57
ii
pySerial Documentation, Release 3.4
This module encapsulates the access for the serial port. It provides backends for Python running on Windows, OSX, Linux, BSD (possibly any POSIX compliant system) and IronPython. The module named "serial" automatically selects the appropriate backend. Other pages (online)
? project page on GitHub ? Download Page with releases ? This page, when viewed online is at or
. Contents:
Contents
1
pySerial Documentation, Release 3.4
2
Contents
1 CHAPTER
pySerial
1.1 Overview
This module encapsulates the access for the serial port. It provides backends for Python running on Windows, OSX, Linux, BSD (possibly any POSIX compliant system) and IronPython. The module named "serial" automatically selects the appropriate backend. It is released under a free software license, see LICENSE for more details. Copyright (C) 2001-2020 Chris Liechti Other pages (online)
? project page on GitHub ? Download Page with releases (PyPi) ? This page, when viewed online is at or
.
1.2 Features
? Same class based interface on all supported platforms. ? Access to the port settings through Python properties. ? Support for different byte sizes, stop bits, parity and flow control with RTS/CTS and/or Xon/Xoff. ? Working with or without receive timeout. ? File like API with "read" and "write" ("readline" etc. also supported). ? The files in this package are 100% pure Python. ? The port is set up for binary transmission. No NULL byte stripping, CR-LF translation etc. (which are many
times enabled for POSIX.) This makes this module universally useful.
3
pySerial Documentation, Release 3.4
? Compatible with io library ? RFC 2217 client (experimental), server provided in the examples.
1.3 Requirements
? Python 2.7 or Python 3.4 and newer ? If running on Windows: Windows 7 or newer ? If running on Jython: "Java Communications" (JavaComm) or compatible extension for Java For older installations (older Python versions or older operating systems), see older versions below.
1.4 Installation
This installs a package that can be used from Python (import serial). To install for all users on the system, administrator rights (root) may be required.
1.4.1 From PyPI
pySerial can be installed from PyPI: python -m pip install pyserial Using the python/python3 executable of the desired version (2.7/3.x). Developers also may be interested to get the source archive, because it contains examples, tests and the this documentation.
1.4.2 From Conda
pySerial can be installed from Conda: conda install pyserial or conda install -c conda-forge pyserial Currently the default conda channel will provide version 3.4 whereas the conda-forge channel provides the current 3.x version. Conda:
1.4.3 From source (zip/tar.gz or checkout)
Download the archive from or . Unpack the archive, enter the pyserial-x.y directory and run: python setup.py install
4
Chapter 1. pySerial
................
................
In order to avoid copyright disputes, this page is only a partial summary.
To fulfill the demand for quickly locating and searching documents.
It is intelligent file search solution for home and business.
Related download
- serial communication in java with example program
- serial ports and com ports selecting a port
- utilizing gps information from the globalsat bu
- modbus documentation read the docs
- xbees python pyserial arduino dc motor
- pico python sdk
- pyfirmata documentation read the docs
- pyserial documentation read the docs
- raspberry pi setting home
- table of contents