python串口库
来源:互联网 发布:耶族部落永久域名地址 编辑:程序博客网 时间:2024/05/21 02:52
pySerial
Overview
This module encapsulates the access for the serial port. It provides backends for Python running on Windows, Linux, BSD (possibly any POSIX compliant system), Jython and IronPython (.NET and Mono). The module named "serial" automatically selects the appropriate backend.It is released under a free software license, see LICENSE.txt for more details.
(C) 2001-2008 Chris Liechti cliechti@gmx.net
The project page on SourceForge and here is the SVN repository and the Download Page.
The homepage is on http://pyserial.sf.net/
Features
- same class based interface on all supported platforms
- access to the port settings through Python 2.2+ properties
- port numbering starts at zero, no need to know the port name in the user program
- port string (device name) can be specified if access through numbering is inappropriate
- support for different bytesizes, stopbits, 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. They depend on non standard but common packages on Windows (pywin32) and Jython (JavaComm). POSIX (Linux, BSD) uses only modules from the standard Python distribution)
- 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.
Requirements
- Python 2.2 or newer
- pywin32 extensions on Windows
- "Java Communications" (JavaComm) or compatible extension for Java/Jython
Installation
from source
Extract files from the archive, open a shell/console in that directory and let Distutils do the rest:python setup.py install
The files get installed in the "Lib/site-packages" directory.
easy_install
An EGG is available from the Python Package Index: http://pypi.python.org/pypi/pyserialeasy_install pyserial
windows installer
There is also a Windows installer for end users. It is located in the Download PageDevelopers may be interested to get the source archive, because it contains examples and the readme.
Short introduction
Open port 0 at "9600,8,N,1", no timeout>>> import serial>>> ser = serial.Serial(0) # open first serial port>>> print ser.portstr # check which port was really used>>> ser.write("hello") # write a string>>> ser.close() # close portOpen named port at "19200,8,N,1", 1s timeout
>>> ser = serial.Serial('/dev/ttyS1', 19200, timeout=1)>>> x = ser.read() # read one byte>>> s = ser.read(10) # read up to ten bytes (timeout)>>> line = ser.readline() # read a '\n' terminated line>>> ser.close()Open second port at "38400,8,E,1", non blocking HW handshaking
>>> ser = serial.Serial(1, 38400, timeout=0,... parity=serial.PARITY_EVEN, rtscts=1)>>> s = ser.read(100) # read up to one hundred bytes... # or as much is in the bufferGet a Serial instance and configure/open it later
>>> ser = serial.Serial()>>> ser.baudrate = 19200>>> ser.port = 0>>> serSerial<id=0xa81c10, open=False>(port='COM1', baudrate=19200, bytesize=8, parity='N', stopbits=1, timeout=None, xonxoff=0, rtscts=0)>>> ser.open()>>> ser.isOpen()True>>> ser.close()>>> ser.isOpen()FalseBe carefully when using "readline". Do specify a timeout when opening the serial port otherwise it could block forever if no newline character is received. Also note that "readlines" only works with a timeout. "readlines" depends on having a timeout and interprets that as EOF (end of file). It raises an exception if the port is not opened correctly.
Do also have a look at the example files in the examples directory in the source distribution or online.
Examples
Please look in the SVN Repository. There is an example directory where you can find a simple terminal and more.http://pyserial.svn.sourceforge.net/viewvc/pyserial/trunk/pyserial/examples/
Parameters for the Serial class
ser = serial.Serial(port=None, # number of device, numbering starts at# zero. if everything fails, the user# can specify a device string, note# that this isn't portable anymore# if no port is specified an unconfigured# an closed serial port object is createdbaudrate=9600, # baud ratebytesize=EIGHTBITS, # number of databitsparity=PARITY_NONE, # enable parity checkingstopbits=STOPBITS_ONE, # number of stopbitstimeout=None, # set a timeout value, None for waiting foreverxonxoff=0, # enable software flow controlrtscts=0, # enable RTS/CTS flow controlinterCharTimeout=None # Inter-character timeout, None to disable)The port is immediately opened on object creation, if a port is given. It is not opened if port is None.
Options for read timeout:
timeout=None # wait forevertimeout=0 # non-blocking mode (return immediately on read)timeout=x # set timeout to x seconds (float allowed)
Methods of Serial instances
open() # open portclose() # close port immediatelysetBaudrate(baudrate) # change baud rate on an open portinWaiting() # return the number of chars in the receive bufferread(size=1) # read "size" characterswrite(s) # write the string s to the portflushInput() # flush input buffer, discarding all it's contentsflushOutput() # flush output buffer, abort outputsendBreak() # send break conditionsetRTS(level=1) # set RTS line to specified logic levelsetDTR(level=1) # set DTR line to specified logic levelgetCTS() # return the state of the CTS linegetDSR() # return the state of the DSR linegetRI() # return the state of the RI linegetCD() # return the state of the CD line
Attributes of Serial instances
Read Only:portstr # device nameBAUDRATES # list of valid baudratesBYTESIZES # list of valid byte sizesPARITIES # list of valid paritiesSTOPBITS # list of valid stop bit widthsNew values can be assigned to the following attributes, the port will be reconfigured, even if it's opened at that time:
port # port name/number as set by the userbaudrate # current baud rate settingbytesize # byte size in bitsparity # parity settingstopbits # stop bit with (1,2)timeout # timeout settingxonxoff # if Xon/Xoff flow control is enabledrtscts # if hardware flow control is enabled
Exceptions
serial.SerialException
Constants
parity:serial.PARITY_NONEserial.PARITY_EVENserial.PARITY_ODDstopbits:
serial.STOPBITS_ONEserial.STOPBITS_TWObytesize:
serial.FIVEBITSserial.SIXBITSserial.SEVENBITSserial.EIGHTBITS
- python串口库
- python串口
- 使用python操作串口
- python 串口读写
- python 串口通信
- 使用python操作串口
- python pyserial 串口
- Python 串口设备应用
- Python串口编程(转载)
- python 串口测试
- Python串口编程(转载)
- python serial读串口
- Python 串口编程
- Python操作串口
- Python串口通信--pyseral
- Python串口编程(转载)
- Python串口功能实现
- python串口通信
- tomcat An error has occurred. See error log for more details. 80
- vs mfc设置
- Android问题1: Unable to start activity ComponentInfo{com.example.demo/com.example.demo
- C#泛型编程
- java面向对象下:异常处理
- python串口库
- android 反弹效果(ListView与Scroll)
- PHP高效率写法(详解原因)
- HDU 1754
- java学习网址
- Qt 处理鼠标点击事件
- IP的网络字节序
- 支付宝无线商户签约指南
- firefox下,jquery控制checkbox选中